Passa al contenuto principale

Esempi d'uso

Di seguito due casi d’uso comuni per l’integrazione con RapportiniLavoro.

1. Sincronizzazione clienti da gestionale

Il gestionale esterno invia periodicamente i dati cliente a RapportiniLavoro tramite l’API di inserimento clienti.

  • L'invio può essere fatto in blocco
  • Se il cliente esiste già, viene aggiornato
  • Il riferimento del cliente lato gestionale può essere usato per riconciliare i dati, noi utilizziamo la colonna id anagrafica come chiave di aggiornamento (se passi due record diversi con questa chiave, il primo passato verrà sovrascritto dal secondo)

Vedi: POST /v2/api/clienti/clienti/bulk

2. Recupero rapportini per la fatturazione

È possibile scaricare periodicamente i rapportini chiusi da una certa data.

  • Si usano i filtri per data, stato o il flag completato
  • Il gestionale può usarli per generare le fatture
  • Gli ID importati vanno aggiornati per non scaricarli di nuovo utilizzando il servizio di aggiornamento bulk degli interventi

Vedi:

  • GET /v2/api/rapportini/export
  • POST /v2/api/rapportini/rapportini/update-bulk