Migrazione da Api V1/SOAP a V2
Lettura Fatture
Step 1 - ItemOverview
Il primo step è quello di effettuare la la chiamata di ItemOverview che fornisce una panoramica sulla situazione delle fatture dell’azienda.
Per i dettagli del funzionamento ed un corretto utilizzo consultare la documentazione a questo link
Step 2 - Lettura Fatture
Una volta effettuato lo step 1 possiamo procedere alla lettura delle fatture.
Per i dettagli del funzionamento ed un corretto utilizzo consultare la documentazione a questo link
Differenze con le attuali V1
Le API v2 di lettura differiscono dalle v1 relativamente alla paginazione. Nella nuova versione infatti non è più presente il conteggio degli elementi totali e del numero di pagine ma un booleano che indica se è presente una pagina successiva.
V1 (deprecate)
"page": {
"size": 20,
"totalElements": 111,
"totalPages": 6,
"number": 0
}V2
"page": {
"size": 20,
"hasNext": true,
"continuationToken": "abc...xyz"
}Per ottenere la pagina successiva è sufficiente richiamare la url fornita nella risposta nell'oggetto _links:
"_links": {
"first": {
"href": "https://b2bread-api-test.agyo.io/api/v2/invoices?ownerId=ABCDEFGHI&size=20&sort=lastTimestamp,desc"
},
"self": {
"href": "https://b2bread-api-test.agyo.io/api/v2/invoices?ownerId=ABCDEFGHI&size=20&sort=lastTimestamp,desc"
},
"next": {
"href": "https://b2bread-api-test.agyo.io/api/v2/invoices?ownerId=ABCDEFGHI&continuationToken=5WvMRcmA_8WJtFSiemEregGggF3etSD4QqPv1aSDXnwfjLKGZKOwq13sye5fl9NQ8799jMkJveAlTaOmC9H4Pn3Wtt2cA5iTyce_5YgEik8cNNEvvUwfz43t22M3tjjc&size=20&sort=lastTimestamp,desc"
}
}Come è possibile osservare esaminando questi link, nella chiamata viene aggiunto il parametro relativo al continuationToken. Questo parametro consentirà al servizio di lettura di riprendere la lettura nel punto in cui si è arrivati nella lettura precedente
Un’ulteriore differenza consiste nell’obbligatorietà del campo OwnerId
Questo campo identifica il proprietario della fattura. Confrontandolo con le V1 rappresenta il sender per la ricerca delle fatture attive e il recipient per la ricerca delle passive.
Questo campo è quindi un riferimento all’azienda con la quale si sta operando. Ed è anch’esso un AgyoItemId.