Docs

Der Datensatz des Kunden

  • In der Sandbox
GET
/clients/{client}/profile

Seit 0.24.0 (C14). Der Schlüssel des Betreibers oder der schreibgeschützte Betreiberschlüssel, und seit 0.25.0 ein Partnerschlüssel für einen Kunden, dessen Datensatz seinen Partner nennt (403 für jeden anderen). 404, wenn kein Datensatz gesetzt ist.

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.

Pfadparameter

client*string
Muster^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

Antwort-Body

Der Datensatz.

application/json
  1. response
client*string
name*string
partner?string|null
stage*string
Wert in"pilot""production""paused"
contact_email?string|null
legal_entities*array<string>
countries*array<string>
updated_at*string
Formatdate-time
curl -X GET "https://example.com/clients/string/profile" \  -H "Authorization: Bearer <your-api-key>"
{  "client": "string",  "name": "string",  "partner": "string",  "stage": "pilot",  "contact_email": "string",  "legal_entities": [    "string"  ],  "countries": [    "string"  ],  "updated_at": "2019-08-24T14:15:22Z"}

Ein fertiges UBL- oder CII-Dokument übermitteln (Durchreichen) POST

Für ERPs, die bereits UBL oder CII schreiben, oder FA(3) für den Übermittlungsweg KSeF. Es findet kein Mapping statt: Der Service führt die offiziellen Validatoren des Übermittlungswegs aus (für FA(3): das XSD plus die Datei- und Datumsregeln von KSeF) und sendet die Datei unverändert. Ein Factur-X- oder ZUGFeRD-PDF läuft über denselben Endpunkt als application/pdf. Das XML wird mit ausgeschalteten Entities, DTDs und Netzwerkzugriff geparst; eine Datei mit einem DOCTYPE wird abgelehnt (EI-XML-DTD), bevor ein Validator sie liest, ebenso eine Datei, die nicht wohlgeformt ist (EI-XML-SYNTAX) oder keine Rechnung ist, die der Übermittlungsweg kennt (EI-XML-TYPE). Seit 0.18.4 ist dieselbe Datei, die für den Kunden und den Übermittlungsweg erneut gesendet wird, die bereits vorhandene Rechnung (duplicate_of), wie bei POST /invoices; es wird nichts Neues gesendet.

Die Kundendatensätze, nach Partner GET

Seit 0.24.0 (C14). Der Schlüssel des Betreibers oder der schreibgeschützte Betreiberschlüssel; seit 0.25.0 ein Partnerschlüssel, der die Liste des eigenen Partners erhält (ein anderer partner wird mit 403 beantwortet). Die mit PUT /clients/{client}/profile gesetzten Datensätze, nach Kunden-ID in Byte-Reihenfolge, je 500. Ist truncated wahr, ist next die letzte ID der Seite, und after= mit dieser ID liest die nächste Seite. partner beschränkt die Liste auf die Kunden eines Partners. Ein Kunde mit Schlüsseln, aber ohne Datensatz wird nicht aufgeführt.