Seqino PDP API (1.0.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Seqino PDP API - Modern interface to France's e-Invoicing services

Download OpenAPI description

openapi.json

openapi.yaml

Overview

URL

https://pdp.seqino.dev/

Servers

Dev server

https://pdp.seqino.dev/api/

Local development server

http://localhost:8052/

👥 Clients
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

📋 Mandates
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

📝 Drafts
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

📘 Directory
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

🧾 Invoicing
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

📄 Get complete invoice data by ID

Request

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.

Path

invoice_idstring(Invoice Id)required

Headers

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

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client sandbox-client-seqino

curl -i -X GET \
  'https://pdp.seqino.dev/api/invoicing/invoice_data/{invoice_id}' \
  -H 'X-PDP-Client-Id: string'

Responses

Successful Response

Bodyapplication/json

specification_identifierstring(Specification Identifier)

Specification identifier (BT-24)

Default "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"

issue_datestring(date)(Issue Date)required

Invoice issue date (BT-2)

due_dateDue Date (string) or Due Date (null)(Due Date)

Any of:

Payment due date (BT-9)

string(date)(Due Date)

type_codestring(InvoiceTypeCode)required

Enum"380""381""383""384"

currency_codestring(Currency Code)required

Invoice currency code (BT-5) - ISO 4217

tax_point_dateTax Point Date (string) or Tax Point Date (null)(Tax Point Date)

Any of:

Tax point date (BT-7)

string(date)(Tax Point Date)

value_added_tax_point_dateValue Added Tax Point Date (string) or Value Added Tax Point Date (null)(Value Added Tax Point Date)

Any of:

Value added tax point date (BT-8)

string(date)(Value Added Tax Point Date)

business_process_typeBusiness Process Type (string) or Business Process Type (null)(Business Process Type)

Any of:

Business process type (BT-23)

string(Business Process Type)

purchase_order_referencePurchase Order Reference (string) or Purchase Order Reference (null)(Purchase Order Reference)

Any of:

Purchase order reference (BT-13)

string(Purchase Order Reference)

sales_order_referenceSales Order Reference (string) or Sales Order Reference (null)(Sales Order Reference)

Any of:

Sales order reference (BT-14)

string(Sales Order Reference)

receiving_advice_referenceReceiving Advice Reference (string) or Receiving Advice Reference (null)(Receiving Advice Reference)

Any of:

Receiving advice reference (BT-15)

string(Receiving Advice Reference)

despatch_advice_referenceDespatch Advice Reference (string) or Despatch Advice Reference (null)(Despatch Advice Reference)

Any of:

Despatch advice reference (BT-16)

string(Despatch Advice Reference)

tender_or_lot_referenceTender Or Lot Reference (string) or Tender Or Lot Reference (null)(Tender Or Lot Reference)

Any of:

Tender or lot reference (BT-17)

string(Tender Or Lot Reference)

invoice_object_identifierInvoice Object Identifier (string) or Invoice Object Identifier (null)(Invoice Object Identifier)

Any of:

Invoiced object identifier (BT-18)

string(Invoice Object Identifier)

buyer_accounting_referenceBuyer Accounting Reference (string) or Buyer Accounting Reference (null)(Buyer Accounting Reference)

Any of:

Buyer accounting reference (BT-19)

string(Buyer Accounting Reference)

project_referenceProject Reference (string) or Project Reference (null)(Project Reference)

Any of:

Project reference (BT-11)

string(Project Reference)

contract_referenceContract Reference (string) or Contract Reference (null)(Contract Reference)

Any of:

Contract reference (BT-12)

string(Contract Reference)

sellerobject(Seller)required

seller.namestring(Name)required

Party name

seller.postal_addressobject(models__invoicing__Address)required

seller.postal_address.street_nameStreet Name (string) or Street Name (null)(Street Name)

Any of:

string(Street Name)

seller.postal_address.additional_street_nameAdditional Street Name (string) or Additional Street Name (null)(Additional Street Name)

Any of:

string(Additional Street Name)

seller.postal_address.city_namestring(City Name)required

seller.postal_address.postal_zonePostal Zone (string) or Postal Zone (null)(Postal Zone)

Any of:

string(Postal Zone)

seller.postal_address.country_subdivisionCountry Subdivision (string) or Country Subdivision (null)(Country Subdivision)

Any of:

string(Country Subdivision)

seller.postal_address.country_codestring(Country Code)required

ISO 3166-1 alpha-2 country code

seller.electronic_addressElectronicAddress (object) or null

Any of:

seller.tax_registrationsArray of Tax Registrations (objects) or Tax Registrations (null)(Tax Registrations)

Any of:

seller.legal_registration_nameLegal Registration Name (string) or Legal Registration Name (null)(Legal Registration Name)

Any of:

string(Legal Registration Name)

seller.trading_nameTrading Name (string) or Trading Name (null)(Trading Name)

Any of:

string(Trading Name)

seller.party_identifierParty Identifier (string) or Party Identifier (null)(Party Identifier)

Any of:

Party identifier

string(Party Identifier)

seller.party_identifier_schemeParty Identifier Scheme (string) or Party Identifier Scheme (null)(Party Identifier Scheme)

Any of:

Party identifier scheme

string(Party Identifier Scheme)

seller.seller_identifierSeller Identifier (string) or Seller Identifier (null)(Seller Identifier)

Any of:

Seller identifier (BT-29)

string(Seller Identifier)

seller.seller_identifier_schemeSeller Identifier Scheme (string) or Seller Identifier Scheme (null)(Seller Identifier Scheme)

Any of:

Seller identifier scheme (BT-30)

string(Seller Identifier Scheme)

seller.seller_vat_identifierSeller Vat Identifier (string) or Seller Vat Identifier (null)(Seller Vat Identifier)

Any of:

Seller VAT identifier (BT-31)

string(Seller Vat Identifier)

seller.seller_tax_registration_identifierSeller Tax Registration Identifier (string) or Seller Tax Registration Identifier (null)(Seller Tax Registration Identifier)

Any of:

Seller tax registration identifier (BT-32)

string(Seller Tax Registration Identifier)

seller.seller_additional_legal_informationSeller Additional Legal Information (string) or Seller Additional Legal Information (null)(Seller Additional Legal Information)

Any of:

Seller additional legal information (BT-33)

string(Seller Additional Legal Information)

buyerobject(Buyer)required

buyer.namestring(Name)required

Party name

buyer.postal_addressobject(models__invoicing__Address)required

buyer.postal_address.street_nameStreet Name (string) or Street Name (null)(Street Name)

Any of:

string(Street Name)

buyer.postal_address.additional_street_nameAdditional Street Name (string) or Additional Street Name (null)(Additional Street Name)

Any of:

string(Additional Street Name)

buyer.postal_address.city_namestring(City Name)required

buyer.postal_address.postal_zonePostal Zone (string) or Postal Zone (null)(Postal Zone)

Any of:

string(Postal Zone)

buyer.postal_address.country_subdivisionCountry Subdivision (string) or Country Subdivision (null)(Country Subdivision)

Any of:

string(Country Subdivision)

buyer.postal_address.country_codestring(Country Code)required

ISO 3166-1 alpha-2 country code

buyer.electronic_addressElectronicAddress (object) or null

Any of:

buyer.tax_registrationsArray of Tax Registrations (objects) or Tax Registrations (null)(Tax Registrations)

Any of:

buyer.legal_registration_nameLegal Registration Name (string) or Legal Registration Name (null)(Legal Registration Name)

Any of:

string(Legal Registration Name)

buyer.trading_nameTrading Name (string) or Trading Name (null)(Trading Name)

Any of:

string(Trading Name)

buyer.party_identifierParty Identifier (string) or Party Identifier (null)(Party Identifier)

Any of:

Party identifier

string(Party Identifier)

buyer.party_identifier_schemeParty Identifier Scheme (string) or Party Identifier Scheme (null)(Party Identifier Scheme)

Any of:

Party identifier scheme

string(Party Identifier Scheme)

buyer.buyer_identifierBuyer Identifier (string) or Buyer Identifier (null)(Buyer Identifier)

Any of:

Buyer identifier (BT-46)

string(Buyer Identifier)

buyer.buyer_identifier_schemeBuyer Identifier Scheme (string) or Buyer Identifier Scheme (null)(Buyer Identifier Scheme)

Any of:

Buyer identifier scheme (BT-47)

string(Buyer Identifier Scheme)

buyer.buyer_legal_registration_identifierBuyer Legal Registration Identifier (string) or Buyer Legal Registration Identifier (null)(Buyer Legal Registration Identifier)

Any of:

Buyer legal registration identifier (BT-47)

string(Buyer Legal Registration Identifier)

buyer.buyer_vat_identifierBuyer Vat Identifier (string) or Buyer Vat Identifier (null)(Buyer Vat Identifier)

Any of:

Buyer VAT identifier (BT-48)

string(Buyer Vat Identifier)

invoice_linesArray of objects(Invoice Lines)non-emptyrequired

Invoice lines (BG-25)

invoice_lines[].line_idstring(Line Id)required

Invoice line identifier

invoice_lines[].invoiced_quantitystring(Invoiced Quantity)required

Invoiced quantity

invoice_lines[].unit_of_measurestring(Unit Of Measure)required

Unit of measure code

invoice_lines[].line_net_amountstring(Line Net Amount)required

Invoice line net amount

invoice_lines[].item_namestring(Item Name)required

Item name

invoice_lines[].item_descriptionItem Description (string) or Item Description (null)(Item Description)

Any of:

string(Item Description)

invoice_lines[].item_pricestring(Item Price)required

Item net price

invoice_lines[].vat_category_codestring(VATCategoryCode)required

Enum"S""Z""E""AE""K""O"

invoice_lines[].vat_rateVat Rate (string) or Vat Rate (null)(Vat Rate)

Any of:

VAT rate as percentage

string(Vat Rate)

vat_breakdownsArray of objects(Vat Breakdowns)required

VAT breakdown (BG-23)

vat_breakdowns[].category_codestring(VATCategoryCode)required

Enum"S""Z""E""AE""K""O"

vat_breakdowns[].rateRate (string) or Rate (null)(Rate)

Any of:

VAT rate as percentage

string(Rate)

vat_breakdowns[].taxable_amountstring(Taxable Amount)required

VAT taxable amount

vat_breakdowns[].tax_amountstring(Tax Amount)required

VAT amount

vat_breakdowns[].exemption_reasonExemption Reason (string) or Exemption Reason (null)(Exemption Reason)

Any of:

string(Exemption Reason)

document_totalsobject(DocumentTotals-Output)required

document_totals.sum_of_line_net_amountsstring(Sum Of Line Net Amounts)required

Sum of Invoice line net amount (BT-106)

document_totals.sum_of_allowancesSum Of Allowances (string) or Sum Of Allowances (null)(Sum Of Allowances)

Any of:

Sum of allowances on document level

string(Sum Of Allowances)

document_totals.sum_of_chargesSum Of Charges (string) or Sum Of Charges (null)(Sum Of Charges)

Any of:

Sum of charges on document level

string(Sum Of Charges)

document_totals.invoice_total_without_vatstring(Invoice Total Without Vat)required

Invoice total amount without VAT (BT-109)

document_totals.invoice_total_vat_amountstring(Invoice Total Vat Amount)required

Invoice total VAT amount (BT-110)

document_totals.invoice_total_with_vatstring(Invoice Total With Vat)required

Invoice total amount with VAT (BT-112)

document_totals.paid_amountPaid Amount (string) or Paid Amount (null)(Paid Amount)

Any of:

Paid amount

string(Paid Amount)

document_totals.rounding_amountRounding Amount (string) or Rounding Amount (null)(Rounding Amount)

Any of:

Rounding amount

string(Rounding Amount)

document_totals.amount_due_for_paymentstring(Amount Due For Payment)required

Amount due for payment (BT-115)

payment_termsPaymentTerms (object) or null

Any of:

Payment instructions (BG-16)

order_referenceOrder Reference (string) or Order Reference (null)(Order Reference)

Any of:

Deprecated: use purchase_order_reference instead

string(Order Reference)

invoice_noteInvoice Note (string) or Invoice Note (null)(Invoice Note)

Any of:

Invoice note (BT-22)

string(Invoice Note)

preceding_invoice_referencePreceding Invoice Reference (string) or Preceding Invoice Reference (null)(Preceding Invoice Reference)

Any of:

For credit notes - reference to original invoice (BT-25)

string(Preceding Invoice Reference)

invoice_numberstring(Invoice Number)required

Invoice number (BT-1)

processing_timestampProcessing Timestamp (string) or Processing Timestamp (null)(Processing Timestamp)

Any of:

When the invoice was processed by the system

string(date-time)(Processing Timestamp)

invoice_period_start_dateInvoice Period Start Date (string) or Invoice Period Start Date (null)(Invoice Period Start Date)

Any of:

Invoice period start date (BT-73)

string(date)(Invoice Period Start Date)

invoice_period_end_dateInvoice Period End Date (string) or Invoice Period End Date (null)(Invoice Period End Date)

Any of:

Invoice period end date (BT-74)

string(date)(Invoice Period End Date)

delivery_location_identifierDelivery Location Identifier (string) or Delivery Location Identifier (null)(Delivery Location Identifier)

Any of:

Deliver to location identifier (BT-71)

string(Delivery Location Identifier)

actual_delivery_dateActual Delivery Date (string) or Actual Delivery Date (null)(Actual Delivery Date)

Any of:

Actual delivery date (BT-72)

string(date)(Actual Delivery Date)

payment_means_type_codePayment Means Type Code (string) or Payment Means Type Code (null)(Payment Means Type Code)

Any of:

Payment means type code (BT-81)

string(Payment Means Type Code)

payment_means_textPayment Means Text (string) or Payment Means Text (null)(Payment Means Text)

Any of:

Payment means text (BT-82)

string(Payment Means Text)

remittance_informationRemittance Information (string) or Remittance Information (null)(Remittance Information)

Any of:

Remittance information (BT-83)

string(Remittance Information)

payment_account_identifierPayment Account Identifier (string) or Payment Account Identifier (null)(Payment Account Identifier)

Any of:

Payment account identifier (BT-84)

string(Payment Account Identifier)

payment_account_namePayment Account Name (string) or Payment Account Name (null)(Payment Account Name)

Any of:

Payment account name (BT-85)

string(Payment Account Name)

payment_service_provider_identifierPayment Service Provider Identifier (string) or Payment Service Provider Identifier (null)(Payment Service Provider Identifier)

Any of:

Payment service provider identifier (BT-86)

string(Payment Service Provider Identifier)

document_level_allowance_amountDocument Level Allowance Amount (string) or Document Level Allowance Amount (null)(Document Level Allowance Amount)

Any of:

Sum of allowances on document level (BT-107)

string(Document Level Allowance Amount)

document_level_charge_amountDocument Level Charge Amount (string) or Document Level Charge Amount (null)(Document Level Charge Amount)

Any of:

Sum of charges on document level (BT-108)

string(Document Level Charge Amount)

en16931_validation_statusEn16931 Validation Status (string) or En16931 Validation Status (null)(En16931 Validation Status)

Any of:

EN16931 validation status (system field)

string(En16931 Validation Status)

validation_errorsArray of Validation Errors (strings) or Validation Errors (null)(Validation Errors)

Any of:

List of validation errors if any (system field)

Response

application/json

{
  "specification_identifier": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
  "issue_date": "2019-08-24",
  "due_date": "2019-08-24",
  "type_code": "380",
  "currency_code": "string",
  "tax_point_date": "2019-08-24",
  "value_added_tax_point_date": "2019-08-24",
  "business_process_type": "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": {
    "name": "string",
    "postal_address": { … },
    "electronic_address": { … },
    "tax_registrations": [ … ],
    "legal_registration_name": "string",
    "trading_name": "string",
    "party_identifier": "string",
    "party_identifier_scheme": "string",
    "seller_identifier": "string",
    "seller_identifier_scheme": "string",
    "seller_vat_identifier": "string",
    "seller_tax_registration_identifier": "string",
    "seller_additional_legal_information": "string"
  },
  "buyer": {
    "name": "string",
    "postal_address": { … },
    "electronic_address": { … },
    "tax_registrations": [ … ],
    "legal_registration_name": "string",
    "trading_name": "string",
    "party_identifier": "string",
    "party_identifier_scheme": "string",
    "buyer_identifier": "string",
    "buyer_identifier_scheme": "string",
    "buyer_legal_registration_identifier": "string",
    "buyer_vat_identifier": "string"
  },
  "invoice_lines": [
    { … }
  ],
  "vat_breakdowns": [
    { … }
  ],
  "document_totals": {
    "sum_of_line_net_amounts": "string",
    "sum_of_allowances": "string",
    "sum_of_charges": "string",
    "invoice_total_without_vat": "string",
    "invoice_total_vat_amount": "string",
    "invoice_total_with_vat": "string",
    "paid_amount": "string",
    "rounding_amount": "string",
    "amount_due_for_payment": "string"
  },
  "payment_terms": {
    "description": "string",
    "due_date": "2019-08-24"
  },
  "order_reference": "string",
  "invoice_note": "string",
  "preceding_invoice_reference": "string",
  "invoice_number": "string",
  "processing_timestamp": "2019-08-24T14:15:22Z",
  "invoice_period_start_date": "2019-08-24",
  "invoice_period_end_date": "2019-08-24",
  "delivery_location_identifier": "string",
  "actual_delivery_date": "2019-08-24",
  "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",
  "document_level_allowance_amount": "string",
  "document_level_charge_amount": "string",
  "en16931_validation_status": "string",
  "validation_errors": [
    "string"
  ]
}

📄 Get invoice file download links

Request

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

Path

invoice_idstring(Invoice Id)required

Query

formatEInvoicingFormat (string) or Format (null)(Format)

Any of:

Supported e-invoicing formats for file downloads.

string(EInvoicingFormat)

Enum"facturx""ubl""cii"

Headers

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

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client sandbox-client-seqino

curl -i -X GET \
  'https://pdp.seqino.dev/api/invoicing/invoices/{invoice_id}?format=facturx' \
  -H 'X-PDP-Client-Id: string'

Responses

Successful Response

Bodyapplication/json

invoice_idstring(Invoice Id)required

Invoice ID

available_formatsArray of objects(Available Formats)required

List of available download formats

available_formats[].formatstring(EInvoicingFormat)required

Enum"facturx""ubl""cii"

available_formats[].download_urlstring(Download Url)required

Signed S3 download URL

available_formats[].expires_atstring(date-time)(Expires At)required

When the download link expires

available_formats[].file_namestring(File Name)required

Suggested filename for download

available_formats[].file_sizeFile Size (integer) or File Size (null)(File Size)

Any of:

File size in bytes

integer(File Size)

available_formats[].content_typestring(Content Type)required

MIME content type

generated_atstring(date-time)(Generated At)required

When the download links were generated

Response

application/json

{
  "invoice_id": "string",
  "available_formats": [
    { … }
  ],
  "generated_at": "2019-08-24T14:15:22Z"
}

🔍 List invoices with filtering

Request

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

Query

updated_afterUpdated After (string) or Updated After (null)(Updated After)

Any of:

string(Updated After)

updated_beforeUpdated Before (string) or Updated Before (null)(Updated Before)

Any of:

string(Updated Before)

created_afterCreated After (string) or Created After (null)(Created After)

Any of:

string(Created After)

created_beforeCreated Before (string) or Created Before (null)(Created Before)

Any of:

string(Created Before)

limitinteger(Limit)

Default 50

offsetinteger(Offset)

Default 0

Headers

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

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client sandbox-client-seqino

curl -i -X GET \
  'https://pdp.seqino.dev/api/invoicing/invoices?updated_after=string&updated_before=string&created_after=string&created_before=string&limit=50&offset=0' \
  -H 'X-PDP-Client-Id: string'

Responses

List of invoices matching filters

Bodyapplication/json

property name*anyadditional property

Response

application/json

{}

📄 Submit invoice file (FacturX, UBL, CII)

Request

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.

Headers

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

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client sandbox-client-seqino

Bodymultipart/form-datarequired

filestring(binary)(File)required

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

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

Responses

Successful Response

Bodyapplication/json

invoice_idstring(Invoice Id)required

Generated invoice ID

statusstring(InvoiceStatus)required

Enum"draft""submitted""validated""rejected""processed"

file_namestring(File Name)required

Original file name

file_sizeinteger(File Size)required

File size in bytes

extracted_dataExtracted Data (object) or Extracted Data (null)(Extracted Data)

Any of:

Extracted invoice data from invoice file

en16931_invoiceEN16931InvoiceModel (object) or null

Any of:

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

Response

application/json

{
  "invoice_id": "string",
  "status": "draft",
  "file_name": "string",
  "file_size": 0,
  "extracted_data": {},
  "en16931_invoice": {
    "specification_identifier": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
    "issue_date": "2019-08-24",
    "due_date": "2019-08-24",
    "type_code": "380",
    "currency_code": "string",
    "tax_point_date": "2019-08-24",
    "value_added_tax_point_date": "2019-08-24",
    "business_process_type": "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": { … },
    "invoice_lines": [ … ],
    "vat_breakdowns": [ … ],
    "document_totals": { … },
    "payment_terms": { … },
    "order_reference": "string",
    "invoice_note": "string",
    "preceding_invoice_reference": "string",
    "invoice_number": "string",
    "processing_timestamp": "2019-08-24T14:15:22Z",
    "invoice_period_start_date": "2019-08-24",
    "invoice_period_end_date": "2019-08-24",
    "delivery_location_identifier": "string",
    "actual_delivery_date": "2019-08-24",
    "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",
    "document_level_allowance_amount": "string",
    "document_level_charge_amount": "string",
    "en16931_validation_status": "string",
    "validation_errors": [ … ]
  }
}

✅ Validate invoice file (FacturX, UBL, CII)

Request

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.

Headers

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

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client sandbox-client-seqino

Bodymultipart/form-datarequired

filestring(binary)(File)required

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

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

Responses

Successful Response

Bodyapplication/json

is_validboolean(Is Valid)required

Whether the invoice file is valid

file_namestring(File Name)required

Original file name

file_sizeinteger(File Size)required

File size in bytes

detected_formatDetected Format (string) or Detected Format (null)(Detected Format)

Any of:

Detected file format (FacturX, UBL, CII)

string(Detected Format)

format_versionFormat Version (string) or Format Version (null)(Format Version)

Any of:

Detected format version

string(Format Version)

pdf_validboolean(Pdf Valid)required

Whether the PDF component is valid

xml_validboolean(Xml Valid)required

Whether the XML component is valid

issuesArray of objects(Issues)required

List of validation issues found

issues[].field_pathstring(Field Path)required

JSON path to the problematic field (e.g., 'seller.postal_address.country_code')

issues[].error_codestring(Error Code)required

Machine-readable error code (e.g., 'INVALID_COUNTRY_CODE')

issues[].error_messagestring(Error Message)required

Human-readable error message

issues[].severitystring(Severity)required

Issue severity: 'error', 'warning', or 'info'

issues[].suggested_valueSuggested Value (string) or Suggested Value (null)(Suggested Value)

Any of:

Suggested correct value if applicable

string(Suggested Value)

total_errorsinteger(Total Errors)required

Total number of errors

total_warningsinteger(Total Warnings)required

Total number of warnings

extracted_dataExtracted Data (object) or Extracted Data (null)(Extracted Data)

Any of:

Extracted invoice data if validation succeeds

en16931_invoiceEN16931InvoiceModel (object) or null

Any of:

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

summarystring(Summary)required

Human-readable validation summary

Response

application/json

{
  "is_valid": true,
  "file_name": "string",
  "file_size": 0,
  "detected_format": "string",
  "format_version": "string",
  "pdf_valid": true,
  "xml_valid": true,
  "issues": [
    { … }
  ],
  "total_errors": 0,
  "total_warnings": 0,
  "extracted_data": {},
  "en16931_invoice": {
    "specification_identifier": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
    "issue_date": "2019-08-24",
    "due_date": "2019-08-24",
    "type_code": "380",
    "currency_code": "string",
    "tax_point_date": "2019-08-24",
    "value_added_tax_point_date": "2019-08-24",
    "business_process_type": "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": { … },
    "invoice_lines": [ … ],
    "vat_breakdowns": [ … ],
    "document_totals": { … },
    "payment_terms": { … },
    "order_reference": "string",
    "invoice_note": "string",
    "preceding_invoice_reference": "string",
    "invoice_number": "string",
    "processing_timestamp": "2019-08-24T14:15:22Z",
    "invoice_period_start_date": "2019-08-24",
    "invoice_period_end_date": "2019-08-24",
    "delivery_location_identifier": "string",
    "actual_delivery_date": "2019-08-24",
    "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",
    "document_level_allowance_amount": "string",
    "document_level_charge_amount": "string",
    "en16931_validation_status": "string",
    "validation_errors": [ … ]
  },
  "summary": "string"
}

🔄 Lifecycle
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

📊 Reporting
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

📊 Usage
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

⚙️ Settings
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Operations

Seqino PDP API (1.0.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

👥 Clients
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📋 Mandates
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📝 Drafts
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📘 Directory
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

🧾 Invoicing
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📄 Get complete invoice data by ID

Request

Responses

Was this helpful?

📄 Get invoice file download links

Request

Responses

Was this helpful?

🔍 List invoices with filtering

Request

Responses

Was this helpful?

📄 Submit invoice file (FacturX, UBL, CII)

Request

Responses

Was this helpful?

✅ Validate invoice file (FacturX, UBL, CII)

Request

Responses

Was this helpful?

🔄 Lifecycle
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📊 Reporting
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📊 Usage
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

⚙️ Settings
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Seqino PDP API (1.0.0)CopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

👥 ClientsCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

📋 MandatesCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

📝 DraftsCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

📘 DirectoryCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

🧾 InvoicingCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

📄 Get complete invoice data by ID

Request

Responses

Was this helpful?

📄 Get invoice file download links

RequestExpand all

Responses

Was this helpful?

🔍 List invoices with filtering

RequestExpand all

Responses

Was this helpful?

📄 Submit invoice file (FacturX, UBL, CII)

Request

Responses

Was this helpful?

✅ Validate invoice file (FacturX, UBL, CII)

Request

Responses

Was this helpful?

🔄 LifecycleCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

📊 ReportingCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

📊 UsageCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

⚙️ SettingsCopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from Claude

Seqino PDP API (1.0.0)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

👥 Clients
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📋 Mandates
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📝 Drafts
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📘 Directory
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

🧾 Invoicing
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

Request

Request

🔄 Lifecycle
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📊 Reporting
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

📊 Usage
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude

⚙️ Settings
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude