# 📄 Submit invoice file (FacturX, UBL, CII)

Submit an invoice file for processing.

Supports multiple e-invoicing formats:
- FacturX: Franco-German standard with embedded XML in PDF
- UBL: Universal Business Language XML
- CII: Cross Industry Invoice XML

The endpoint automatically detects the format and processes accordingly.
The returned invoice_id can be used with /lifecycle-events to track lifecycle updates.

Endpoint: POST /invoicing/files/submit
Version: 1.0.0

## Header parameters:

  - `X-PDP-Client-Id` (string, required)
    ID of the PDP Client for which the operation is performed

## Request fields (multipart/form-data):

  - `file` (string, required)
    Invoice file (FacturX PDF, UBL XML, CII XML)

## Response 201 fields (application/json):

  - `invoice_id` (string, required)
    Generated invoice ID

  - `status` (string, required)
    Current invoice status
    Enum: "draft", "submitted", "validated", "rejected", "processed"

  - `file_name` (string, required)
    Original file name

  - `file_size` (integer, required)
    File size in bytes

  - `extracted_data` (any)
    Extracted invoice data from invoice file

  - `en16931_invoice` (any)
    Complete EN16931-compliant invoice if processing succeeded

## Response 400 fields (application/json):

  - `error` (string, required)

  - `code` (integer, required)

  - `trace_id` (string, required)

## Response 401 fields (application/json):

  - `error` (string, required)

  - `code` (integer, required)

  - `trace_id` (string, required)


## Response 422 fields