# 🧾 Invoicing

## 📄 Get complete invoice data by ID

 - [GET /invoicing/invoice_data/{invoice_id}](https://pdp-api-v250704-iron.seqino.dev/openapi/invoicing/get_invoice_data_invoicing_invoice_data__invoice_id__get.md): Get the complete EN16931-compliant invoice data by ID.

Returns the full invoice with all EN16931 business terms populated.
This endpoint provides the structured data representation of the invoice.

## 📄 Get invoice file download links

 - [GET /invoicing/invoices/{invoice_id}](https://pdp-api-v250704-iron.seqino.dev/openapi/invoicing/get_invoice_download_links_invoicing_invoices__invoice_id__get.md): Get download links for invoice files in various e-invoicing formats.

Returns signed S3 download URLs for the invoice in the requested format(s).
If no format is specified, returns links for all available formats.

Supported formats:
- facturx: FacturX PDF with embedded XML (French standard)
- ubl: Universal Business Language XML
- cii: Cross Industry Invoice XML

Args:
    invoice_id: The invoice ID to get download links for
    format: Optional specific format to get download link for

Returns:
    InvoiceDownloadResponse with signed download URLs

## 🔍 List invoices with filtering

 - [GET /invoicing/invoices](https://pdp-api-v250704-iron.seqino.dev/openapi/invoicing/list_invoices_invoicing_invoices_get.md): List invoices with time-based filtering options.

This endpoint allows you to query invoices using various time-based filters
to find invoices that match your criteria.

Args:
    updated_after: ISO timestamp to get invoices updated after this time
    updated_before: ISO timestamp to get invoices updated before this time
    created_after: ISO timestamp to get invoices created after this time
    created_before: ISO timestamp to get invoices created before this time
    limit: Maximum number of invoices to return (default: 50, max: 100)
    offset: Number of invoices to skip for pagination (default: 0)

Returns:
    List of invoices with metadata including timestamps and status

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

 - [POST /invoicing/files/submit](https://pdp-api-v250704-iron.seqino.dev/openapi/invoicing/submit_invoice_file_invoicing_files_submit_post.md): 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.

## ✅ Validate invoice file (FacturX, UBL, CII)

 - [POST /invoicing/files/validate](https://pdp-api-v250704-iron.seqino.dev/openapi/invoicing/validate_invoice_file_invoicing_files_validate_post.md): Validate an invoice file without submitting it for processing.

Supports validation of multiple e-invoicing formats:
- FacturX: Validates PDF structure and embedded XML against FacturX standards
- UBL: Validates XML against UBL schema
- CII: Validates XML against Cross Industry Invoice schema

All formats are checked for EN16931 compliance.
Returns detailed validation results with specific error messages and suggestions.