Depunere de fișiere

Un ERP care poate doar să scrie fișiere poate preda facturile printr-un singur folder. Serviciul urmărește folderul și tratează fiecare fișier ca pe o transmitere: un fișier JSON ca POST /invoices, un fișier XML ca POST /invoices/xml. Rezultatele revin ca fișiere în același folder.

ConfigurareCopiați linkul către această secțiune

Folderul se stabilește la instalarea serviciului. Serviciul îl verifică o dată pe secundă și nu urmărește nimic când nu este stabilit niciun folder. Un fișier trece prin aceeași preluare ca un apel API, așa că este refuzat din aceleași motive.

Denumirea fișieruluiCopiați linkul către această secțiune

• O referință de factură are cel mult 100 de caractere și nu conține / sau \.
• Un fișier de peste 5 MB este refuzat.
• Un nume care începe cu punct, conține .. sau nu se potrivește cu niciun model este ignorat.
• Idempotency-Key este format din primele 32 de caractere ale SHA-256-ului fișierului. Depunerea din nou a unui fișier identic este o reluare, nu o a doua factură.

Ce primiți înapoiCopiați linkul către această secțiune

drop/
  DE-4711.json            you write this
  status/
    DE-4711-1.json        one file per status event
    DE-4712-error.json    the answer to a refused file
  done/
    DE-4711.json          an accepted file moves here
  failed/
    DE-4712.json          a refused file moves here

Un fișier acceptat este mutat în done/. Evenimentele facturii sunt scrise în status/, câte un fișier pentru fiecare eveniment, cu numele INVOICE-REF-<sequence>.json. Fiecare este un element al răspunsului GET /invoices/{id}/events. Ele conțin hash-ul facturii și niciun conținut al facturii.

{
  "occurred_at": "2026-10-02T17:17:55.857Z",
  "sequence": 1,
  "environment": "sandbox",
  "invoice_ref": "CAPTURE-JSON-1790961440",
  "document_sha256": "3b41395db498666777b74f9f5b9fae82871720304bc25bbb590e25b7b75ea1d4",
  "event_id": "evt_200c0def79ed702df81d702f",
  "country_route": "DE-XRECHNUNG",
  "invoice_number": "CAPTURE-JSON-1790961440",
  "status": "validated"
}

Evenimentele care există în momentul acceptării fișierului sunt scrise imediat. Fiecare eveniment ulterior este scris pe măsură ce apare, până când factura ajunge într-o stare finală (accepted, delivered, rejected, validation_failed, dead_letter sau cancelled) sau până când trec 30 de zile.

Un fișier refuzat este mutat în failed/, iar status/INVOICE-REF-error.json conține răspunsul pe care l-ar fi dat API-ul. Pentru un fișier care nu este factură, acesta este răspunsul 422 de mai jos. Corectați datele și depuneți din nou fișierul cu același nume.

{
  "type": "https://eurinvoice.com/problems/validation-failed",
  "title": "The invoice did not pass the checks",
  "errors": [
    {
      "code": "EI-XML-TYPE",
      "fix_hint": "Send the invoice itself, in the format agreed for the route.",
      "who_fixes": "erp",
      "source": "XML-safety",
      "message": "The file is not an invoice in a format this route accepts. Please send the invoice in the agreed format."
    }
  ],
  "status": 422
}

Ce lipseșteCopiați linkul către această secțiune

• SFTP și stocarea de obiecte.
• O modalitate de a citi din folder ID-ul inv_ al unei facturi acceptate. Fișierele de stare conțin invoice_ref și invoice_number.