Lettura fatture
Endpoints
Link Endpoints
Api v2
Dopo aver effettuato la chiamata di company Overview ( se non lo avete fatto, leggete qui).
Possiamo procedere a chiamare le api di lettura per ogni item che ha fatture.
Api v2
Andiamo ora a vedere come interrogare gli endpoint REST delle api v2 al fine di recuperare la lista di fatture attive e passive.
Evitare di filtrare sugli stati delle fatture e lavorare invece sul delta dei documenti cambiati a partire da una certa data (aka listChangesFrom).
Nella chiamata dovrò indicare come parametro lastTimestampFrom il valore di lastTimestamp della fattura più recente ottenuta in risposta alla precedente chiamata a v2/invoices.
Se la chiamata è effettuata per la prima utilizzare un valore valido a piacere, ad esempio 1577836800000 (1 Gennaio 2020, 00:00:00 UTC).
Attenzione NON vanno utilizzati i valori di lastTimestampActive / lastTimestampPassive della company overview, ma, ad essclusione della prima volta, per tutte le chiamate dovrà essere il valore di lastTimestamp della fattura più recente ricevuta in risposta.
Nella query string di ricerca è stato introdotto il parametro obbligatorio ownerId. Se l'azienda ha più di un ufficio e si vogliono recuperare le fatture di tutti gli uffici è possibile aggiungere al valore di ownerId il suffisso -ALL.
Di seguito due chiamate di esempio:
Fatture Attive
ownerId=ABCDEF-ALL // Tutti gli uffici dell'azienda Azienda/Studio ABCDEFactive=true //Filtro le fatture attivelastTimestampFrom=1576167521000 //Timestamp dal quale partire per effettuare la ricerca (ottenuto dalla companyOverview)
Fatture Passive
ownerId=ABCDEF-ALL // Tutti gli uffici dell'azienda Azienda/Studio ABCDEFactive=false //Filtro le fatture attivelastTimestampFrom=1576167521000 //Timestamp dal quale partire per effettuare la ricerca (ottenuto dalla companyOverview)