Come ottenere le voci di tempo di un'attività per tipo di fatturazione in Zoho Desk

Recuperare le voci di tempo di un'attività filtrate per tipo di fatturazione in Zoho Desk richiede una singola richiesta GET autenticata all'endpoint specifico per le voci di tempo dell'attività, passando l'ID dell'attività come parametro di percorso.

Perché è importante

Nella gestione delle operazioni di supporto, è spesso necessario distinguere tra il tempo fatturabile e quello non fatturabile registrato per le attività — ai fini della fatturazione, della reportistica o della trasparenza verso il cliente. L'API di Zoho Desk espone un endpoint dedicato con filtro per tipo di fatturazione per le attività, rendendo semplice estrarre solo le voci di tempo pertinenti a una specifica categoria di fatturazione, senza dover elaborare in seguito un elenco completo di voci.

Procedura passo dopo passo

Passaggio 1. Identifica il taskId dell'attività di cui vuoi recuperare le voci di tempo. Si tratta dell'identificatore univoco che Zoho Desk assegna al record dell'attività — puoi ottenerlo da una precedente chiamata API all'elenco delle attività o direttamente dall'URL dell'interfaccia di Zoho Desk quando visualizzi l'attività. ^[1]

Passaggio 2. Costruisci la tua richiesta GET all'endpoint per il tipo di fatturazione. Il percorso segue questo schema: ^[1]

GET /api/v1/tasks/{taskId}/timeEntries/billingType

Sostituisci {taskId} con la stringa identificativa effettiva dell'attività.

Passaggio 3. Includi eventuali parametri di query opzionali passandoli come dizionario (indicato come p nell'SDK). Questi parametri ti consentono di paginare o filtrare i risultati restituiti dall'endpoint. ^[1]

Passaggio 4. Invia la richiesta autenticata. Utilizzando il wrapper Python SDK, la chiamata si presenta così: ^[1]

result = client.get_task_time_entries_by(taskId="your_task_id_here", p={"billingType": "Billable"})

Il metodo invia una richiesta GET a /api/v1/tasks/{taskId}/timeEntries/billingType, trasmettendo i parametri di query, e restituisce le voci di tempo corrispondenti raggruppate o filtrate per tipo di fatturazione. ^[1]

Passaggio 5. Analizza la risposta. Il payload restituito conterrà le voci di tempo associate a quell'attività, suddivise per classificazione di fatturazione, che potrai quindi integrare nella tua pipeline di reportistica o nel flusso di lavoro di fatturazione. ^[1]

---

> Nota da Beam Help: Siamo un supporto esperto indipendente per Zoho — non il supporto ufficiale di Zoho. I passaggi sopra riportati riflettono la nostra analisi della superficie API di Zoho Desk.

---

Endpoint correlati da conoscere

Il filtro per tipo di fatturazione è disponibile per diversi tipi di entità in Zoho Desk, non solo per le attività. A seconda delle tue esigenze di reportistica, potresti voler interrogare anche: ^[2][3][4][6]

• Voci di tempo a livello di account per tipo di fatturazione: GET /api/v1/accounts/{accountId}/timeEntries/billingType ^[2]
• Voci di tempo a livello di contatto per tipo di fatturazione: GET /api/v1/contacts/{contactId}/timeEntries/billingType ^[3]
• Voci di tempo a livello di ticket per tipo di fatturazione: GET /api/v1/tickets/{ticketId}/timeEntries/billingType ^[4]
• Voci di tempo a livello di agente per tipo di fatturazione: GET /api/v1/agents/{agentId}/timeEntries/billingType ^[6]

Ognuno segue lo stesso schema — sostituisci il nome dell'entità e il relativo ID nel percorso.

Errori comuni

• Endpoint dell'entità errato: Se chiami accidentalmente l'endpoint dei ticket (/tickets/{ticketId}/timeEntries/billingType) quando intendi interrogare un'attività, riceverai dati a livello di ticket anziché a livello di attività. Verifica sempre se il tuo record è un'*attività* o un *ticket* prima di scegliere l'endpoint. ^[1][4]
• taskId mancante o non valido: Passare un ID attività errato o inesistente produrrà una risposta di errore. Controlla attentamente l'ID rispetto ai tuoi record di attività prima di effettuare la chiamata. ^[1]
• Parametro p non valorizzato: Il dizionario p è opzionale, ma se la tua integrazione si aspetta risultati filtrati o paginati, ometterlo restituirà il set di risultati predefinito. Passa le chiavi di filtro esplicitamente all'interno del dizionario. ^[1]

Cosa verificare

• ID attività corretto: Verifica che il taskId nel percorso della richiesta corrisponda a un'attività esistente nella tua organizzazione Zoho Desk, e non a un ID di ticket o contatto. ^[1]
• Autenticazione e contesto dell'organizzazione: Conferma che le tue credenziali API siano valide e che l'ID corretto dell'organizzazione Desk sia impostato nella configurazione del client prima di effettuare la chiamata. ^[7]
• Struttura della risposta: Esamina il payload restituito per assicurarti che le voci di tempo siano presenti e che la segmentazione per tipo di fatturazione corrisponda alle tue aspettative — un risultato vuoto potrebbe indicare che non esistono voci di quel tipo di fatturazione per l'attività, piuttosto che un errore. ^[1]