Docs
DE

Sprache wählen

eurinvoice.com
Docs
DE

Sprache wählen

Zugangsdaten verschlüsselt speichern; der Wert wird nie zurückgegeben

  • In der Sandbox

In einfachen Worten

Speichert Zugangsdaten eines Netzes verschlüsselt. Der Wert wird nie zurückgegeben.
POST
/credentials

Ein Prozess speichert Zugangsdaten nur für seine eigene Umgebung. legal_entity bindet sie an die Verkäufer-ID, für die sie gelten (USt-IdNr., NIP, SIREN oder Unternehmens-ID); ohne Angabe gelten sie für die übrigen Rechnungen des Kunden. Der Admin-Schlüssel eines Kunden speichert nur für den eigenen Kunden.

Autorisierung

apiKey
headerAuthorizationBearer <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.

Anfrage-Body

application/json
  1. body
client*string

Optional mit einem Kundenschlüssel

Muster^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$
route*string
Wert in"PL-KSEF""RO-EFACTURA""PEPPOL""FR-PA""DE-XRECHNUNG"
kind*string
issued_by*string
issued_on*string
Formatdate
expires_on?string
Formatdate
environment?string

Muss die Umgebung dieses Prozesses sein; das ist der Standard.

Wert in"sandbox""production"
legal_entity?string
Längelength <= 64
value*string

Antwort-Body

Gespeichert.

application/json
  1. response
id?string
client?string
route?string
kind?string
issued_by?string
issued_on?string
expires_on?string
environment?|

sandbox oder production; null bei Zugangsdaten, die vor dem 3. Okt. 2026 gespeichert wurden und die nur eine Sandbox nutzt.

legal_entity?string
revoked_at?string
stored?boolean
curl -X POST "https://example.com/credentials" \  -H "Authorization: Bearer <your-api-key>" \  -H "Content-Type: application/json" \  -d '{    "client": "string",    "route": "PL-KSEF",    "kind": "string",    "issued_by": "string",    "issued_on": "2019-08-24",    "value": "string"  }'
{  "id": "string",  "client": "string",  "route": "string",  "kind": "string",  "issued_by": "string",  "issued_on": "string",  "expires_on": "string",  "environment": "string",  "legal_entity": "string",  "revoked_at": "string",  "stored": true}

Ein Zugangsdatum widerrufen; der Datensatz bleibt für den Prüfpfad POST

Zurück

Eine Rechnung stoppen, die noch nicht übermittelt wurde POST

Funktioniert nur, solange die Rechnung received, validated oder queued ist. Seit 0.18.3 gilt: Wurde ein Versand versucht und ging seine Antwort verloren (ein Timeout oder ein 5xx), steht die Rechnung auf submitting, und ein Stornieren wird mit 409 send-in-progress beantwortet, weil der Übermittlungsweg sie haben kann; der Worker setzt sie dann auf submitted oder dead_letter. Hat der Übermittlungsweg sie, ist eine Stornierung ein Geschäftsdokument (eine Gutschrift, oder in Polen eine KOR), kein API-Aufruf. Seit 0.18.5 beantwortet ein Stornieren einer bereits stornierten Rechnung mit 200 und der Rechnung, damit eine Wiederholung nach einer verlorenen Antwort sicher ist. Seit 0.18.6 darf der Schlüssel des Betreibers eine dead_letter-Rechnung stornieren, wenn für sie nie ein Aufruf an den Übermittlungsweg gemacht wurde: Dort kann nichts liegen, daher kann dasselbe Dokument danach erneut gesendet werden. Wurde ein Aufruf gemacht, lautet die Antwort 409 dead-letter-reached-rail, weil ein Versand mit verlorener Antwort dort liegen kann: Prüfen Sie zuerst beim Übermittlungsweg. Ein Kundenschlüssel erhält 409 dead-letter; der Betreiber entscheidet.