📄 Submit invoice file (Factur-X, UBL, CII)

Requête

Submit an invoice file for outbound Peppol transmission.

Supported formats:

Factur-X: Franco-German e-invoicing standard (EN16931 compliant)
UBL: Universal Business Language XML (Peppol BIS 3.0)
CII: Cross Industry Invoice XML (EN16931)

The returned invoice_id can be used with /lifecycle-events to track lifecycle updates.

Sécurité

APIKeyHeader

En-têtes

X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client

client_abc123

Corpsmultipart/form-dataobligatoire

filestring, (binary)(File)obligatoire

Invoice file (FacturX PDF, UBL XML or CII XML)

curl -i -X POST \
  https://pdp.seqino.dev/api/invoicing/files/submit \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: multipart/form-data' \
  -H 'X-PDP-Client-Id: client_abc123' \
  -F file=string

Réponses

Successful Response

Corpsapplication/json

invoice_idstring(Invoice Id)obligatoire

Generated invoice ID

statusstring(InvoiceStatus)obligatoire

Current invoice status

Enum:"draft""submitted""received""processed""accepted""partially_accepted""refused""paid""rejected""cashed"

file_namestring(File Name)obligatoire

Original file name

file_sizeinteger(File Size)obligatoire

File size in bytes

extracted_dataInvoiceSummary (object) or null

Any of:

Summary of the submitted invoice

en16931_invoiceEN16931InvoiceModel (object) or null

Any of:

Final invoice model with system-generated invoice number and full EN16931 compliance.

Response

{
  "invoice_id": "string",
  "status": "draft",
  "file_name": "string",
  "file_size": 0,
  "extracted_data": {
    "invoice_id": "string",
    "invoice_number": "string",
    "type_code": "string",
    "status": "draft",
    "direction": "incoming",
    "original_invoice_type": "CII_EN16931_FR",
    "seller": { … },
    "buyer": { … },
    "buyer_reference": "string",
    "currency_code": "string",
    "total_amount": 0,
    "issue_date": "2019-08-24",
    "seller_identifier": "string",
    "seller_identifier_scheme": "string",
    "buyer_identifier": "string",
    "buyer_legal_registration_id": "string",
    "created_at": "string",
    "status_details": { … }
  },
  "en16931_invoice": {
    "specification_identifier": "string",
    "issue_date": "2019-08-24",
    "due_date": "2019-08-24",
    "type_code": "380",
    "currency_code": "string",
    "tax_currency_code": "string",
    "tax_point_date": "2019-08-24",
    "value_added_tax_point_date": "2019-08-24",
    "business_process_type": "B1",
    "buyer_reference": "string",
    "purchase_order_reference": "string",
    "sales_order_reference": "string",
    "receiving_advice_reference": "string",
    "despatch_advice_reference": "string",
    "tender_or_lot_reference": "string",
    "invoice_object_identifier": "string",
    "buyer_accounting_reference": "string",
    "project_reference": "string",
    "contract_reference": "string",
    "seller": { … },
    "buyer": { … },
    "payee": { … },
    "seller_tax_representative": { … },
    "invoice_lines": [ … ],
    "vat_breakdowns": [ … ],
    "document_totals": { … },
    "payment_terms": { … },
    "payment_means_type_code": "string",
    "payment_means_text": "string",
    "remittance_information": "string",
    "payment_account_identifier": "string",
    "payment_account_name": "string",
    "payment_service_provider_identifier": "string",
    "notes": [ … ],
    "order_reference": "string",
    "invoice_note": "string",
    "preceding_invoice_reference": "string",
    "preceding_invoice_issue_date": "2019-08-24",
    "delivery": { … },
    "invoice_number": "string",
    "processing_timestamp": "2019-08-24T14:15:22Z",
    "invoice_period_start_date": "2019-08-24",
    "invoice_period_end_date": "2019-08-24",
    "document_level_allowance_amount": "string",
    "document_level_charge_amount": "string",
    "document_allowances": [ … ],
    "document_charges": [ … ],
    "en16931_validation_status": "string",
    "validation_errors": [ … ],
    "status_details": { … }
  }
}