Passa al contenuto principale

Esempi d'uso

Di seguito alcuni casi comuni di integrazione con le API di RapportiniLavoro.

1. Sincronizzazione clienti dal gestionale​

Un gestionale esterno può mantenere allineata l'anagrafica clienti con RapportiniLavoro.

Funzionamento:

  • l'invio può essere fatto in blocco
  • se il cliente esiste già viene aggiornato
  • l'identificativo del gestionale va salvato nel campo idanagrafica

Il campo idanagrafica viene usato come chiave di aggiornamento.
Se vengono inviati due record con lo stesso idanagrafica, il secondo sovrascrive il primo.

Riferimenti endpoint:

2. Sincronizzazione articoli dal gestionale​

Anche gli articoli possono essere gestiti in modo analogo ai clienti.

Funzionamento:

  • l'invio può essere fatto in blocco
  • se l'articolo esiste già viene aggiornato
  • l'identificativo del gestionale va salvato nel campo codice_articolo_esterno

Il campo codice_articolo_esterno viene usato come chiave di aggiornamento.
Se vengono inviati due record con lo stesso codice_articolo_esterno, il secondo sovrascrive il primo.

Riferimenti endpoint:

3. Gestione rapportini per integrazione con il gestionale​

Il gestionale può recuperare e aggiornare i rapportini per supportare processi come la fatturazione.

Funzionamento:

  • i rapportini possono essere recuperati tramite i seguenti endpoint:
    • GET /v2/api/rapportini/export → endpoint con filtri più semplici
    • GET /v2/api/rapportini/rapportini/admin → endpoint con filtri più avanzati e specifici
  • è possibile filtrare per data, stato e altri parametri

Per tracciare l'avvenuta integrazione:

  • dopo l'importazione nel gestionale, è possibile impostare il campo idgestionale tramite POST /v2/api/rapportini/rapportini/update-bulk
  • una volta valorizzato, i rapportini possono essere filtrati tramite GET /v2/api/rapportini/export usando il filtro importato=true

Riferimenti endpoint: