Docs

La liste de suivi : factures rejetées ou en échec définitif, avec le code du catalogue et qui agit

  • Dans le bac à sable

En termes simples

Liste les factures rejetées ou en échec définitif, avec le code du catalogue et qui agit.
GET
/care

Depuis la 0.15.0, une clé de client avec le droit read lit les lignes de son propre client, de sorte qu’une entreprise peut voir ses propres factures rejetées. Une clé de client reçoit au plus ses 200 lignes les plus récentes dans le status demandé, avec truncated: true quand il y en a davantage ; depuis la 0.18.2, le statut est appliqué en premier, de sorte qu’une ancienne ligne ouverte n’est jamais cachée derrière des lignes plus récentes déjà traitées. Elle peut lister 30 fois par minute (429 au-delà). La clé de l’opérateur voit les lignes de tous les clients, ou celles d’un seul avec client.

Autorisation

apiKey
headerAuthorizationBearer <token>

Envoyez votre clé sous forme de jeton bearer : Authorization: Bearer <your-api-key>. L’état du service est le seul appel qui ne nécessite pas de clé.

Paramètres de requête

status?string

open (pas encore traitées), handled ou all. La valeur par défaut est all, comme avant la 0.8.0.

Par défaut"all"
Valeur parmi"open""handled""all"
client?string

Filtre de l’opérateur sur un client. Une clé de client ne peut nommer que son propre client ; tout autre répond 404. Une autre forme répond 400.

Motif^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

Corps de la réponse

data : une ligne par facture et par code.

application/json
  1. response
data*array<>
truncated?boolean

Présent et vrai quand la liste d’une clé de client a été ramenée à ses 200 lignes les plus récentes, avant le filtre de statut.

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}