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

Operations

📋 Mandates

Operations

📝 Drafts

Operations

📘 Directory

Operations

🧾 Invoicing

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.

Security

APIKeyHeader

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 client_abc123

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

Responses

Successful Response

Bodyapplication/json

specification_identifierstring(Specification Identifier)

Specification identifier (BT-24) - Peppol BIS 3.0 or French CIUS

Default "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1"

issue_datestring(date)(Issue Date)required

Invoice issue date (BT-2)

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

Payment due date (BT-9)

Any of:

Payment due date (BT-9)

string(date)(Due Date)

type_codestring(InvoiceTypeCode)required

Invoice type code (BT-3)

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)

Tax point date (BT-7)

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)

Value added tax point date (BT-8)

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)

Business process type (BT-23)

Any of:

Business process type (BT-23)

string(Business Process Type)

buyer_referenceBuyer Reference (string) or Buyer Reference (null)(Buyer Reference)

Buyer reference (BT-10) - An identifier assigned by the buyer used for internal routing. Either buyer_reference or purchase_order_reference must be provided.

Any of:

Buyer reference (BT-10) - An identifier assigned by the buyer used for internal routing. Either buyer_reference or purchase_order_reference must be provided.

string(Buyer Reference)

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

Purchase order reference (BT-13)

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)

Sales order reference (BT-14)

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)

Receiving advice reference (BT-15)

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)

Despatch advice reference (BT-16)

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)

Tender or lot reference (BT-17)

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)

Invoiced object identifier (BT-18)

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)

Buyer accounting reference (BT-19)

Any of:

Buyer accounting reference (BT-19)

string(Buyer Accounting Reference)

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

Project reference (BT-11)

Any of:

Project reference (BT-11)

string(Project Reference)

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

Contract reference (BT-12)

Any of:

Contract reference (BT-12)

string(Contract Reference)

sellerobject(Seller)required

Seller party information (BG-4)

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)

Party identifier

Any of:

Party identifier

string(Party Identifier)

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

Party identifier scheme

Any of:

Party identifier scheme

string(Party Identifier Scheme)

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

Seller identifier (BT-29)

Any of:

Seller identifier (BT-29)

string(Seller Identifier)

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

Seller identifier scheme (BT-30)

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)

Seller VAT identifier (BT-31)

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)

Seller tax registration identifier (BT-32)

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)

Seller additional legal information (BT-33)

Any of:

Seller additional legal information (BT-33)

string(Seller Additional Legal Information)

buyerobject(Buyer)required

Buyer party information (BG-7)

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)

Party identifier

Any of:

Party identifier

string(Party Identifier)

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

Party identifier scheme

Any of:

Party identifier scheme

string(Party Identifier Scheme)

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

Buyer identifier (BT-46)

Any of:

Buyer identifier (BT-46)

string(Buyer Identifier)

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

Buyer identifier scheme (BT-47)

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)

Buyer legal registration identifier (BT-47)

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)

Buyer VAT identifier (BT-48)

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)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$required

Invoiced quantity

invoice_lines[].unit_of_measurestring(Unit Of Measure)required

Unit of measure code (BT-130) - Must be valid UN/ECE Recommendation 20 code (BR-CL-23). Common codes: C62 (unit/piece), HUR (hour), DAY (day), MON (month), MTR (meter), KGM (kilogram), LTR (liter)

invoice_lines[].line_net_amountstring(Line Net Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$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)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$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)

VAT rate as percentage

Any of:

VAT rate as percentage

string(Vat Rate)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

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)

VAT rate as percentage

Any of:

VAT rate as percentage

string(Rate)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

vat_breakdowns[].taxable_amountstring(Taxable Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$required

VAT taxable amount

vat_breakdowns[].tax_amountstring(Tax Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$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 level totals (BG-22)

document_totals.sum_of_line_net_amountsstring(Sum Of Line Net Amounts)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$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)

Sum of allowances on document level

Any of:

Sum of allowances on document level

string(Sum Of Allowances)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

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

Sum of charges on document level

Any of:

Sum of charges on document level

string(Sum Of Charges)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

document_totals.invoice_total_without_vatstring(Invoice Total Without Vat)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$required

Invoice total amount without VAT (BT-109)

document_totals.invoice_total_vat_amountstring(Invoice Total Vat Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$required

Invoice total VAT amount (BT-110)

document_totals.invoice_total_with_vatstring(Invoice Total With Vat)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$required

Invoice total amount with VAT (BT-112)

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

Paid amount

Any of:

Paid amount

string(Paid Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

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

Rounding amount

Any of:

Rounding amount

string(Rounding Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

document_totals.amount_due_for_paymentstring(Amount Due For Payment)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$required

Amount due for payment (BT-115)

payment_termsPaymentTerms (object) or null

Payment instructions (BG-16)

Any of:

Payment instructions (BG-16)

notesArray of Notes (objects) or Notes (null)(Notes)

Invoice notes with optional subject codes (BT-22)

Any of:

Invoice notes with optional subject codes (BT-22)

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

Deprecated: use purchase_order_reference instead

Any of:

Deprecated: use purchase_order_reference instead

string(Order Reference)

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

Deprecated: use notes instead. Invoice note (BT-22)

Any of:

Deprecated: use notes instead. Invoice note (BT-22)

string(Invoice Note)

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

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

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)

When the invoice was processed by the system

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)

Invoice period start date (BT-73)

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)

Invoice period end date (BT-74)

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)

Deliver to location identifier (BT-71)

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)

Actual delivery date (BT-72)

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)

Payment means type code (BT-81)

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)

Payment means text (BT-82)

Any of:

Payment means text (BT-82)

string(Payment Means Text)

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

Remittance information (BT-83)

Any of:

Remittance information (BT-83)

string(Remittance Information)

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

Payment account identifier (BT-84)

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)

Payment account name (BT-85)

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)

Payment service provider identifier (BT-86)

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)

Sum of allowances on document level (BT-107)

Any of:

Sum of allowances on document level (BT-107)

string(Document Level Allowance Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

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

Sum of charges on document level (BT-108)

Any of:

Sum of charges on document level (BT-108)

string(Document Level Charge Amount)^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,2}0*$

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

EN16931 validation status (system field)

Any of:

EN16931 validation status (system field)

string(En16931 Validation Status)

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

List of validation errors if any (system field)

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:3.0::2.1",
  "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",
  "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": {
    "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"
  },
  "notes": [
    { … }
  ],
  "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 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 (or draft_id) to get download links for format: Optional specific format to get download link for

Returns: InvoiceDownloadResponse with download URLs

Security

APIKeyHeader

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 client_abc123

curl -i -X GET \
  'https://pdp.seqino.dev/api/invoicing/invoices/{invoice_id}?format=facturx' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -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

Invoice format

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)

File size in bytes

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"
}

📦 Download invoice as UBL 2.1 XML

Request

Download an invoice as UBL 2.1 XML (Peppol BIS 3.0 compliant).

Returns the invoice as a UBL 2.1 XML document that can be used for e-invoicing via Peppol network or other UBL-compatible systems.

Args: invoice_id: The invoice ID (or draft_id) to export

Returns: UBL 2.1 XML document with application/xml content type

Security

APIKeyHeader

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 client_abc123

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

Responses

UBL XML document

Bodyapplication/xml

Response

application/xml

<root/>

📦 Download invoice as CII XML

Request

Download an invoice as CII XML (EN16931 compliant).

Returns the invoice as a Cross Industry Invoice XML document that can be used for e-invoicing in EN16931-compatible systems.

Args: invoice_id: The invoice ID (or draft_id) to export

Returns: CII XML document with application/xml content type

Security

APIKeyHeader

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 client_abc123

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

Responses

CII XML document

Bodyapplication/xml

Response

application/xml

<root/>

🔍 List invoices with filtering

Request

List invoices with status and time-based filtering options.

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

Args: status: Filter by invoice status (draft, submitted, validated, rejected, processed) 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

Security

APIKeyHeader

Query

statusInvoiceStatus (string) or Status (null)(Status)

Any of:

string(InvoiceStatus)

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

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 client_abc123

curl -i -X GET \
  'https://pdp.seqino.dev/api/invoicing/invoices?status=draft&updated_after=string&updated_before=string&created_after=string&created_before=string&limit=50&offset=0' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -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.

Security

APIKeyHeader

Headers

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

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client client_abc123

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 'Authorization: YOUR_API_KEY_HERE' \
  -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

Current invoice status

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)

Extracted invoice data from invoice file

Any of:

Extracted invoice data from invoice file

en16931_invoiceEN16931InvoiceModel (object) or null

Complete EN16931-compliant invoice if processing succeeded

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:3.0::2.1",
    "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",
    "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": { … },
    "invoice_lines": [ … ],
    "vat_breakdowns": [ … ],
    "document_totals": { … },
    "payment_terms": { … },
    "notes": [ … ],
    "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.

Security

APIKeyHeader

Headers

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

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client client_abc123

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 'Authorization: YOUR_API_KEY_HERE' \
  -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)

Detected file format (FacturX, UBL, CII)

Any of:

Detected file format (FacturX, UBL, CII)

string(Detected Format)

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

Detected 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)

Suggested correct value if applicable

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)

Extracted invoice data if validation succeeds

Any of:

Extracted invoice data if validation succeeds

en16931_invoiceEN16931InvoiceModel (object) or null

Complete EN16931-compliant invoice if validation succeeds

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:3.0::2.1",
    "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",
    "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": { … },
    "invoice_lines": [ … ],
    "vat_breakdowns": [ … ],
    "document_totals": { … },
    "payment_terms": { … },
    "notes": [ … ],
    "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

Operations

📊 Reporting

Operations

📊 Usage

Operations

⚙️ Settings

Operations

🔔 Webhooks

Operations

Health Check

Request

Health check endpoint.

curl -i -X GET \
  https://pdp.seqino.dev/health

Responses

Successful Response

Bodyapplication/json

any

Response

application/json

null

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

👥 Clients

📋 Mandates

📝 Drafts

📘 Directory

🧾 Invoicing

📄 Get complete invoice data by ID

Request

Responses

Was this helpful?

📄 Get invoice file download links

RequestExpand all

Responses

Was this helpful?

📦 Download invoice as UBL 2.1 XML

Request

Responses

Was this helpful?

📦 Download invoice as CII XML

Request

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?

🔄 Lifecycle

📊 Reporting

📊 Usage

⚙️ Settings

🔔 Webhooks

Health Check

Request

Responses

Was this helpful?

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

Request

Request