Seqino PDP API (1.0.0)

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

Download OpenAPI description

openapi.json

openapi.yaml

Overview

URL

https://pdp.seqino.com/

Servers

Current server

https://pdp-api-v250704-iron.seqino.dev/

Local development server

http://localhost:8052/

Production server

https://pdp.seqino.com/api/

👥 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.

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-api-v250704-iron.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)

Payment due date (BT-9)

Any of:

Payment due date (BT-9)

string(date)(Due Date)

Payment due date (BT-9)

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)

Tax point date (BT-7)

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)

Value added tax point date (BT-8)

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)

Business process type (BT-23)

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)

Purchase order reference (BT-13)

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)

Sales order reference (BT-14)

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)

Receiving advice reference (BT-15)

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)

Despatch advice reference (BT-16)

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)

Tender or lot reference (BT-17)

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)

Invoiced object identifier (BT-18)

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)

Buyer accounting reference (BT-19)

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

Project reference (BT-11)

Any of:

Project reference (BT-11)

string(Project Reference)

Project reference (BT-11)

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

Contract reference (BT-12)

Any of:

Contract reference (BT-12)

string(Contract Reference)

Contract reference (BT-12)

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)

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)

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 identifier (BT-29)

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 identifier scheme (BT-30)

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 VAT identifier (BT-31)

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 tax registration identifier (BT-32)

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)

Seller additional legal information (BT-33)

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)

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)

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 identifier (BT-46)

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 identifier scheme (BT-47)

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 legal registration identifier (BT-47)

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)

Buyer VAT identifier (BT-48)

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)

VAT rate as percentage

Any of:

VAT rate as percentage

string(Vat Rate)

VAT rate as percentage

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)

VAT rate as percentage

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

Document level totals (BG-22)

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)

Sum of allowances on document level

Any of:

Sum of allowances on document level

string(Sum Of Allowances)

Sum of allowances on document level

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)

Sum of charges on document level

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)

Paid amount

Any of:

Paid amount

string(Paid Amount)

Paid amount

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

Rounding amount

Any of:

Rounding amount

string(Rounding Amount)

Rounding amount

document_totals.amount_due_for_paymentstring(Amount Due For Payment)required

Amount due for payment (BT-115)

payment_termsPaymentTerms (object) or null

Payment instructions (BG-16)

Any of:

Payment instructions (BG-16)

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)

Deprecated: use purchase_order_reference instead

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

Invoice note (BT-22)

Any of:

Invoice note (BT-22)

string(Invoice Note)

Invoice note (BT-22)

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)

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

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)

When the invoice was processed by the system

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 start date (BT-73)

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)

Invoice period end date (BT-74)

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)

Deliver to location identifier (BT-71)

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)

Actual delivery date (BT-72)

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 type code (BT-81)

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)

Payment means text (BT-82)

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

Remittance information (BT-83)

Any of:

Remittance information (BT-83)

string(Remittance Information)

Remittance information (BT-83)

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 identifier (BT-84)

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 account name (BT-85)

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)

Payment service provider identifier (BT-86)

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)

Sum of allowances on document level (BT-107)

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)

Sum of charges on document level (BT-108)

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)

EN16931 validation status (system field)

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

Supported e-invoicing formats for file downloads.

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-api-v250704-iron.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

Supported e-invoicing formats for file downloads.

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)

File size in bytes

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-api-v250704-iron.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

object(Response List Invoices Api Invoicing Invoices Get)

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-api-v250704-iron.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

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

object(Extracted Data)

Extracted invoice data from invoice file

en16931_invoiceEN16931InvoiceModel (object) or null

Complete EN16931-compliant invoice if processing succeeded

Any of:

Complete EN16931-compliant invoice if processing succeeded

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-api-v250704-iron.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)

Detected file format (FacturX, UBL, CII)

Any of:

Detected file format (FacturX, UBL, CII)

string(Detected Format)

Detected file format (FacturX, UBL, CII)

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

Detected format version

Any of:

Detected format version

string(Format Version)

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

Suggested correct value if applicable

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

object(Extracted Data)

Extracted invoice data if validation succeeds

en16931_invoiceEN16931InvoiceModel (object) or null

Complete EN16931-compliant invoice if validation succeeds

Any of:

Complete EN16931-compliant invoice if validation succeeds

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

Operations

📊 Reporting

Operations

📊 Usage

Operations

⚙️ Settings

Operations

Health Check

Request

Health check endpoint.

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

Responses

Successful Response

Bodyapplication/json

any

Response

application/json

null

Seqino PDP API (1.0.0)

👥 Clients

📋 Mandates

📝 Drafts

📘 Directory

🧾 Invoicing

📄 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

📊 Reporting

📊 Usage

⚙️ Settings

Health Check

Request

Responses

Was this helpful?

Seqino PDP API (1.0.0)

👥 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?

🔍 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

Health Check

Request

Responses

Was this helpful?

Request

Request