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