Elencare le fatture inviate
La chiamata che dovrai fare per elencare le fatture inviate:
- GET https://endpoint/api/v1/invoices/sentlist
Questa richiesta permette di caricare la lista degli invoiceId delle fatture inviate in un certo intervallo di tempo ordinate cronologicamente.
Parametri della richiesta:
- apiKey: API KEY associate alla partita iva del mittente della fattura che si vuole inviare;
- page: (default = 1) pagina da caricare;
- withinAfter: il formato deve essere YYYY-MM-DD HH:MM:SS. Nella lista saranno presenti solo le fatture caricate nel sistema ad un orario successivo o uguale a quello specificato;
- withinBefore: (opzionale) il formato deve essere YYYY-MM-DD HH:MM:SS. Nella lista saranno presenti solo le fatture caricate nel sistema ad un orario successivo o uguale a withinAfter e precedente o uguale a withinBefore.
Formato risposta valida:
{
"data": [
{
"invoiceId": "124abc",
"timestamp": "2018-10-10T12:29:17.000000Z",
},
{
"invoiceId": "123abc",
"timestamp": "2018-10-10T12:35:26.000000Z",
}
// Altri dati fino ad un massimo di 1000
],
"meta": {
"current_page": 1,
"last_page": 3,
"per_page": 15,
"from": 1,
"to": 10,
"total": 35
}
}
Il campo invoiceId identifica univocamente la fattura sul sistema ed è utilizzabile, successivamente, per richiedere dettagli sulla fattura inviata.
Il campo timestamp identifica quando la fattura è stata aggiunta al sistema. Si noti che questo timestamp può differire dall’ora di invio o ricezione fattura disponibile nei dettagli della fattura.
Si noti che la risposta conterrà fino ad un massimo di 1000 elementi con timestamp crescente.
Possibili errori:
Codice | Messaggio |
000 | Errore generico. |
001 | Api key mancante. |
002 | Api key non valida. |
003 | Api key non ancora attiva |
004 | Api key scaduta. |
005 | Parametro richiesta mancante. |
006 | Parametro richiesta errato. |