L’elenco degli scarti: fatture scartate e in dead letter con il codice del catalogo e chi interviene
- Nella sandbox
In parole semplici
Dalla 0.15.0 la chiave di un cliente con l’ambito read legge le righe del proprio cliente, così un’azienda può vedere le proprie
fatture scartate. La chiave di un cliente riceve al massimo le 200 righe più recenti nello status richiesto, con truncated: true
quando ce ne sono altre; dalla 0.18.2 lo status viene applicato per primo, così una vecchia riga aperta non resta mai nascosta dietro righe
gestite più recenti. Può leggere l’elenco 30 volte al minuto (429 oltre). La chiave dell’operatore vede le righe di ogni
cliente, oppure quelle di un cliente con client.
apiKeyAuthorizationBearer <token>Inviare la chiave come token bearer: Authorization: Bearer <your-api-key>. Lo stato del servizio è l’unica chiamata che non richiede una chiave.
status?stringopen (non ancora gestite), handled, oppure all. Il valore predefinito è all, come prima della 0.8.0.
"all""open""handled""all"client?stringIl filtro dell’operatore su un cliente. La chiave di un cliente può indicare solo il proprio cliente; ogni altro risponde 404. Un’altra forma risponde 400.
^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$data: una riga per fattura e codice.
application/json- response
data*array<>truncated?booleanPresente e true quando l’elenco della chiave di un cliente è stato ridotto alle 200 righe più recenti, prima del filtro sullo status.
curl -X GET "https://example.com/care" \ -H "Authorization: Bearer <your-api-key>"{ "data": [ { "invoice_id": "string", "catalogue_code": "string", "who_acts": "us", "age_seconds": 0, "handled": true, "handled_at": "2019-08-24T14:15:22Z", "route": "PEPPOL", "client": "string", "invoice_ref": "string", "deadline_at": "2019-08-24T14:15:22Z", "field": "string", "fix_hint": "string" } ], "truncated": true}I file conservati di una fattura dell’elenco degli scarti, con il loro SHA-256 GET
Dalla 0.15.0 la chiave di un cliente con l’ambito read legge le prove delle fatture del proprio cliente, 10 volte al minuto. La fattura di un altro cliente risponde 404, esattamente come una fattura che non è nell’elenco degli scarti. I file oltre 8 MiB in tutto rispondono 413 (evidence-too-large) per ogni chiave; leggerli uno per uno con GET /invoices/{id}/documents/{kind}.
Segnare come gestite le righe dell’elenco degli scarti di una fattura POST
Solo con la chiave dell’operatore. Gestire una riga dell’elenco è lavoro della Gestione degli scarti, quindi la chiave di un cliente riceve 403.