Empfangene Rechnungen auflisten und suchen
- In der Sandbox
Seit 0.35.0. Dieselben Parameter und dieselbe Antwort wie GET /invoices, nur für empfangene Rechnungen; state ist
received, validated oder validation_failed. Ein Kundenschlüssel sieht die Rechnungen seines eigenen Kunden; der Betreiber die aller Kunden, oder
mit client die eines Kunden.
apiKeyAuthorizationBearer <token>Senden Sie Ihren Schlüssel als Bearer-Token: Authorization: Bearer <your-api-key>. Der Systemzustand ist der einzige Aufruf, der keinen Schlüssel braucht.
q?stringlength <= 100route?array<>state?array<>client?string^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$received_from?stringdatereceived_to?stringdatesort?string"newest""newest""oldest"page?integer1 <= value1page_size?integer252550100200Eine Seite mit Treffern.
application/json- response
data*array<>total*integerpage*integerpage_size*integercounts_by_state*curl -X GET "https://example.com/received" \ -H "Authorization: Bearer <your-api-key>"{ "data": [ { "id": "string", "invoice_ref": "string", "invoice_number": "string", "route": "PEPPOL", "client": "string", "environment": "sandbox", "state": "received", "direction": "in", "rail_id": "string", "document_sha256": "string", "duplicate_of": "string", "links": { "self": "string", "events": "string" }, "errors": [ { "code": "string" } ], "documents": [ { "kind": "received-xml", "sha256": "string", "href": "string" } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "total": 0, "page": 0, "page_size": 0, "counts_by_state": { "property1": 0, "property2": 0 }}Die Statusereignisse einer empfangenen Rechnung auflisten GET
Seit 0.35.0. Dieselben Ereignisse, die der Webhook zustellt, in der Reihenfolge ihrer Sequenz, jedes mit direction in.
Eine Rechnung übergeben, die der Kunde über einen Übermittlungsweg erhalten hat POST
Seit 0.35.0 (17. Okt. 2026). Der Body ist das XML genau so, wie der Übermittlungsweg es geliefert hat (UBL, CII oder FA(3)); nichts wird geändert und nichts wird gesendet. Die Datei wird zuerst gespeichert, versiegelt unter dem Datenschlüssel des Kunden, weil sie rechtlich bereits empfangen ist; dann prüfen die eigenen Validatoren des Übermittlungswegs sie, wie bei einer Übermittlung im Durchreichen, und das Ergebnis kommt als Statusereignis (received, dann validated oder validation_failed, mit direction: in) am Webhook des Kunden und unter GET /received/{id}/events an. Eine Datei, die die Regeln nicht erfüllt, wird aufbewahrt und lautet validation_failed mit den Fehlern; sie wird nie verworfen. Eine Datei, die keine aufzubewahrende Rechnung ist, wird mit 422 abgelehnt, und nichts wird gespeichert, wie bei POST /invoices/xml: ein DOCTYPE (EI-XML-DTD, nie geparst), XML, das nicht wohlgeformt ist (EI-XML-SYNTAX), oder ein Dokument, das keine Rechnung ist, die der Übermittlungsweg kennt (EI-XML-TYPE). Eine Prüfung, die nicht laufen konnte (ein Validator ist ausgefallen), wird wiederholt, und nach der letzten Wiederholung kommt die Rechnung auf die Betreuungsliste und bleibt received. Ein Kunde übergibt höchstens 120 Dokumente pro Minute und 2.000 pro Tag, mit welchem Schlüssel auch immer (429, nicht unter dem Idempotency-Key aufbewahrt). Die Datei wird als Download zurückgegeben (Content-Disposition: attachment). Ein Dokument des Übermittlungswegs ist eine empfangene Rechnung des Kunden: nach rail_id, wenn sie angegeben ist, sonst nach dem SHA-256 der Datei. Dasselbe Dokument erneut wird mit 202 und duplicate_of beantwortet; dieselbe rail_id mit anderen Bytes wird mit 409 received-id-conflict beantwortet, und nichts wird gespeichert. Empfangene Rechnungen werden getrennt von den Rechnungen aufbewahrt, die der Kunde sendet: Sie stehen nicht in GET /invoices, in der Serie, in den Metriken oder im Monatsbericht, und sie blockieren nie das Senden derselben Datei. Eine empfangene Rechnung wird mit der Aufbewahrungsfrist des Kunden gelöscht, sobald nichts mehr an ihr offen ist (ihre Prüfung ist beendet, oder eine Person hat ihre Betreuungszeile erledigt), und sie steht im Export des Kunden unter received/. Der Scope submit; ein Kundenschlüssel handelt nur für seinen eigenen Kunden.