FAQ
Qual è il base URL delle API?
Tutte le richieste devono essere inviate a questo indirizzo:
https://api.rapportinilavoro.it
A questo URL va aggiunto il percorso del servizio che vuoi utilizzare.
Esempio:
https://api.rapportinilavoro.it/v2/api/status/utils
Come si accede alle API?
L’accesso avviene tramite un token API creato nella sezione
Impostazioni → Integrazioni Esterne del gestionale.
Il token deve essere inviato nell’header Authorization di ogni richiesta.
Quanto dura un token API?
I token restano validi finché non vengono revocati manualmente.
Si possono usare più token?
Sì. Puoi creare più token, ad esempio uno per ogni software integrato.
Come gestisco i clienti già presenti in RapportiniLavoro?
Invia lo stesso identificativo del gestionale per aggiornare il cliente già esistente.
I rapportini già importati vengono restituiti di nuovo?
No, se hai aggiornato il loro stato con il servizio update-bulk
e stai filtrando l’elenco interventi usando il campo corrispondente.
Cosa succede se mando due volte lo stesso articolo?
Se l’articolo esiste già viene aggiornato, altrimenti viene creato.
Come faccio a sapere gli ID dei tecnici?
Usa il servizio:
GET /v2/api/status/utils
Questo endpoint restituisce anche altre informazioni utili per l’integrazione.
Come vedo se un cliente non ha ancora un riferimento al gestionale?
Usa il filtro:
idanagrafica = null
sull’endpoint dei clienti.
Posso lavorare un intervento già creato?
Sì. Recupera i dati dell’intervento e poi chiama il servizio di lavorazione.