Seqino PDP API - Modern interface to France's e-Invoicing services
- 🔍 Validate invoice data without creating draft
Seqino PDP API (1.0.0)
https://pdp.seqino.dev/api/
Specification identifier (BT-24)
Payment due date (BT-9)
Tax point date (BT-7)
Value added tax point date (BT-8)
Business process type (BT-23)
Purchase order reference (BT-13)
Sales order reference (BT-14)
Receiving advice reference (BT-15)
Despatch advice reference (BT-16)
Tender or lot reference (BT-17)
Invoiced object identifier (BT-18)
Buyer accounting reference (BT-19)
Project reference (BT-11)
Contract reference (BT-12)
Party identifier
Party identifier scheme
Seller identifier (BT-29)
Seller identifier scheme (BT-30)
Seller VAT identifier (BT-31)
Party identifier
Party identifier scheme
Buyer identifier (BT-46)
Buyer identifier scheme (BT-47)
Invoice lines (BG-25)
Invoiced quantity
Invoice line net amount
Item net price
VAT breakdown (BG-23)
Sum of Invoice line net amount (BT-106)
Sum of allowances on document level
Sum of charges on document level
Invoice total amount without VAT (BT-109)
Invoice total VAT amount (BT-110)
Invoice total amount with VAT (BT-112)
Paid amount
Deprecated: use purchase_order_reference instead
Invoice note (BT-22)
- Dev server for Beta Testers
https://pdp.seqino.dev/api/drafts
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://pdp.seqino.dev/api/drafts \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"specification_identifier": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
"issue_date": "2024-01-15",
"type_code": "380",
"currency_code": "EUR",
"seller": {
"name": "Seqino",
"postal_address": {
"street_name": "123 Rue de la République",
"city_name": "Paris",
"postal_zone": "75001",
"country_code": "FR"
},
"electronic_address": {
"scheme_id": "0088",
"value": "1234567890123"
},
"tax_registrations": [
{
"scheme_id": "VAT",
"value": "FR12345678901"
}
],
"legal_registration_name": "Seqino",
"trading_name": "Seqino Corp",
"seller_identifier": "SELLER123",
"seller_identifier_scheme": "GLN",
"seller_vat_identifier": "FR12345678901",
"seller_tax_registration_identifier": "SIRET12345678901234",
"seller_additional_legal_information": "Société par actions simplifiée au capital de 100 000 EUR"
},
"buyer": {
"name": "Beispiel GmbH",
"postal_address": {
"street_name": "Musterstraße 42",
"city_name": "Berlin",
"postal_zone": "10115",
"country_code": "DE"
},
"tax_registrations": [
{
"scheme_id": "VAT",
"value": "DE123456789"
}
],
"legal_registration_name": "Beispiel GmbH",
"buyer_identifier": "BUYER456",
"buyer_identifier_scheme": "GLN",
"buyer_legal_registration_identifier": "HRB12345",
"buyer_vat_identifier": "DE123456789"
},
"invoice_lines": [
{
"line_id": "1",
"invoiced_quantity": 10,
"unit_of_measure": "PCE",
"line_net_amount": 1000,
"item_name": "Software License",
"item_description": "Enterprise software license for 12 months",
"item_price": 100,
"vat_category_code": "S",
"vat_rate": 20
},
{
"line_id": "2",
"invoiced_quantity": 5,
"unit_of_measure": "HUR",
"line_net_amount": 500,
"item_name": "Consulting Services",
"item_description": "Technical consulting and support",
"item_price": 100,
"vat_category_code": "S",
"vat_rate": 20
}
],
"vat_breakdowns": [
{
"category_code": "S",
"rate": 20,
"taxable_amount": 1500,
"tax_amount": 300
}
],
"document_totals": {
"sum_of_line_net_amounts": 1500,
"invoice_total_without_vat": 1500,
"invoice_total_vat_amount": 300,
"invoice_total_with_vat": 1800,
"amount_due_for_payment": 1800
},
"payment_terms": {
"description": "Payment due within 30 days",
"due_date": "2024-02-15"
},
"order_reference": "PO-2024-456",
"invoice_note": "Sample draft for demonstration purposes"
}'{ "draft_id": "string", "status": "draft", "created_at": "2019-08-24T14:15:22Z" }
- Dev server for Beta Testers
https://pdp.seqino.dev/api/drafts/{draft_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://pdp.seqino.dev/api/drafts/{draft_id}' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'X-PDP-Client-Id: string'Successful Response
Specification identifier (BT-24)
Payment due date (BT-9)
Tax point date (BT-7)
Value added tax point date (BT-8)
Business process type (BT-23)
Purchase order reference (BT-13)
Sales order reference (BT-14)
Receiving advice reference (BT-15)
Despatch advice reference (BT-16)
Tender or lot reference (BT-17)
Invoiced object identifier (BT-18)
Buyer accounting reference (BT-19)
Project reference (BT-11)
Contract reference (BT-12)
Party identifier
Party identifier scheme
Seller identifier (BT-29)
Seller identifier scheme (BT-30)
Seller VAT identifier (BT-31)
Party identifier
Party identifier scheme
Buyer identifier (BT-46)
Buyer identifier scheme (BT-47)
Invoice lines (BG-25)
VAT breakdown (BG-23)
Sum of Invoice line net amount (BT-106)
Sum of allowances on document level
Sum of charges on document level
Invoice total amount without VAT (BT-109)
Invoice total VAT amount (BT-110)
Invoice total amount with VAT (BT-112)
Paid amount
Rounding amount
Deprecated: use purchase_order_reference instead
Invoice note (BT-22)
{ "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" }
Specification identifier (BT-24)
Payment due date (BT-9)
Tax point date (BT-7)
Value added tax point date (BT-8)
Business process type (BT-23)
Purchase order reference (BT-13)
Sales order reference (BT-14)
Receiving advice reference (BT-15)
Despatch advice reference (BT-16)
Tender or lot reference (BT-17)
Invoiced object identifier (BT-18)
Buyer accounting reference (BT-19)
Project reference (BT-11)
Contract reference (BT-12)
Party identifier
Party identifier scheme
Seller identifier (BT-29)
Seller identifier scheme (BT-30)
Seller VAT identifier (BT-31)
Party identifier
Party identifier scheme
Buyer identifier (BT-46)
Buyer identifier scheme (BT-47)
Invoice lines (BG-25)
Invoiced quantity
Invoice line net amount
Item net price
VAT breakdown (BG-23)
Sum of Invoice line net amount (BT-106)
Sum of allowances on document level
Sum of charges on document level
Invoice total amount without VAT (BT-109)
Invoice total VAT amount (BT-110)
Invoice total amount with VAT (BT-112)
Paid amount
Deprecated: use purchase_order_reference instead
Invoice note (BT-22)
- Dev server for Beta Testers
https://pdp.seqino.dev/api/drafts/{draft_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://pdp.seqino.dev/api/drafts/{draft_id}' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"specification_identifier": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
"issue_date": "2024-01-15",
"type_code": "380",
"currency_code": "EUR",
"seller": {
"name": "Seqino",
"postal_address": {
"street_name": "123 Rue de la République",
"city_name": "Paris",
"postal_zone": "75001",
"country_code": "FR"
},
"electronic_address": {
"scheme_id": "0088",
"value": "1234567890123"
},
"tax_registrations": [
{
"scheme_id": "VAT",
"value": "FR12345678901"
}
],
"legal_registration_name": "Seqino",
"trading_name": "Seqino Corp",
"seller_identifier": "SELLER123",
"seller_identifier_scheme": "GLN",
"seller_vat_identifier": "FR12345678901",
"seller_tax_registration_identifier": "SIRET12345678901234",
"seller_additional_legal_information": "Société par actions simplifiée au capital de 100 000 EUR"
},
"buyer": {
"name": "Beispiel GmbH",
"postal_address": {
"street_name": "Musterstraße 42",
"city_name": "Berlin",
"postal_zone": "10115",
"country_code": "DE"
},
"tax_registrations": [
{
"scheme_id": "VAT",
"value": "DE123456789"
}
],
"legal_registration_name": "Beispiel GmbH",
"buyer_identifier": "BUYER456",
"buyer_identifier_scheme": "GLN",
"buyer_legal_registration_identifier": "HRB12345",
"buyer_vat_identifier": "DE123456789"
},
"invoice_lines": [
{
"line_id": "1",
"invoiced_quantity": 10,
"unit_of_measure": "PCE",
"line_net_amount": 1000,
"item_name": "Software License",
"item_description": "Enterprise software license for 12 months",
"item_price": 100,
"vat_category_code": "S",
"vat_rate": 20
},
{
"line_id": "2",
"invoiced_quantity": 5,
"unit_of_measure": "HUR",
"line_net_amount": 500,
"item_name": "Consulting Services",
"item_description": "Technical consulting and support",
"item_price": 100,
"vat_category_code": "S",
"vat_rate": 20
}
],
"vat_breakdowns": [
{
"category_code": "S",
"rate": 20,
"taxable_amount": 1500,
"tax_amount": 300
}
],
"document_totals": {
"sum_of_line_net_amounts": 1500,
"invoice_total_without_vat": 1500,
"invoice_total_vat_amount": 300,
"invoice_total_with_vat": 1800,
"amount_due_for_payment": 1800
},
"payment_terms": {
"description": "Payment due within 30 days",
"due_date": "2024-02-15"
},
"order_reference": "PO-2024-456",
"invoice_note": "Sample draft for demonstration purposes"
}'- Dev server for Beta Testers
https://pdp.seqino.dev/api/drafts/{draft_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
'https://pdp.seqino.dev/api/drafts/{draft_id}' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'X-PDP-Client-Id: string'Request
Validate a draft and convert it to a structured invoice in the specified format.
This endpoint performs comprehensive validation and converts the draft into a final invoice that will be submitted to the PPF platform. After successful validation, the draft becomes immutable.
- Dev server for Beta Testers
https://pdp.seqino.dev/api/drafts/{draft_id}/validate
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
'https://pdp.seqino.dev/api/drafts/{draft_id}/validate' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"format": "ubl"
}'{ "invoice_id": "string", "status": "draft" }
Request
Validate invoice data against EN16931 requirements without creating a draft.
Returns detailed validation results with specific error messages and suggestions. This endpoint helps identify issues before submitting invoice data.
Use this for:
- Pre-validation before creating a draft
- Checking data quality during form input
- Understanding validation requirements
Specification identifier (BT-24)
Payment due date (BT-9)
Tax point date (BT-7)
Value added tax point date (BT-8)
Business process type (BT-23)
Purchase order reference (BT-13)
Sales order reference (BT-14)
Receiving advice reference (BT-15)
Despatch advice reference (BT-16)
Tender or lot reference (BT-17)
Invoiced object identifier (BT-18)
Buyer accounting reference (BT-19)
Project reference (BT-11)
Contract reference (BT-12)
Party identifier
Party identifier scheme
Seller identifier (BT-29)
Seller identifier scheme (BT-30)
Seller VAT identifier (BT-31)
Party identifier
Party identifier scheme
Buyer identifier (BT-46)
Buyer identifier scheme (BT-47)
Invoice lines (BG-25)
Invoiced quantity
Invoice line net amount
Item net price
VAT breakdown (BG-23)
VAT rate as percentage
VAT taxable amount
Sum of Invoice line net amount (BT-106)
Sum of allowances on document level
Sum of charges on document level
Invoice total amount without VAT (BT-109)
Invoice total VAT amount (BT-110)
Invoice total amount with VAT (BT-112)
Paid amount
Deprecated: use purchase_order_reference instead
Invoice note (BT-22)
- Dev server for Beta Testers
https://pdp.seqino.dev/api/drafts/validate-data
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://pdp.seqino.dev/api/drafts/validate-data \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"invoice_data": {
"specification_identifier": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
"issue_date": "2024-01-15",
"type_code": "380",
"currency_code": "EUR",
"seller": {
"name": "Seqino",
"postal_address": {
"street_name": "123 Rue de la République",
"city_name": "Paris",
"postal_zone": "75001",
"country_code": "FR"
},
"electronic_address": {
"scheme_id": "0088",
"value": "1234567890123"
},
"tax_registrations": [
{
"scheme_id": "VAT",
"value": "FR12345678901"
}
],
"legal_registration_name": "Seqino",
"trading_name": "Seqino Corp",
"seller_identifier": "SELLER123",
"seller_identifier_scheme": "GLN",
"seller_vat_identifier": "FR12345678901",
"seller_tax_registration_identifier": "SIRET12345678901234",
"seller_additional_legal_information": "Société par actions simplifiée au capital de 100 000 EUR"
},
"buyer": {
"name": "Beispiel GmbH",
"postal_address": {
"street_name": "Musterstraße 42",
"city_name": "Berlin",
"postal_zone": "10115",
"country_code": "DE"
},
"tax_registrations": [
{
"scheme_id": "VAT",
"value": "DE123456789"
}
],
"legal_registration_name": "Beispiel GmbH",
"buyer_identifier": "BUYER456",
"buyer_identifier_scheme": "GLN",
"buyer_legal_registration_identifier": "HRB12345",
"buyer_vat_identifier": "DE123456789"
},
"invoice_lines": [
{
"line_id": "1",
"invoiced_quantity": 10,
"unit_of_measure": "PCE",
"line_net_amount": 1000,
"item_name": "Software License",
"item_description": "Enterprise software license for 12 months",
"item_price": 100,
"vat_category_code": "S",
"vat_rate": 20
},
{
"line_id": "2",
"invoiced_quantity": 5,
"unit_of_measure": "HUR",
"line_net_amount": 500,
"item_name": "Consulting Services",
"item_description": "Technical consulting and support",
"item_price": 100,
"vat_category_code": "S",
"vat_rate": 20
}
],
"vat_breakdowns": [
{
"category_code": "S",
"rate": 20,
"taxable_amount": 1500,
"tax_amount": 300
}
],
"document_totals": {
"sum_of_line_net_amounts": 1500,
"invoice_total_without_vat": 1500,
"invoice_total_vat_amount": 300,
"invoice_total_with_vat": 1800,
"amount_due_for_payment": 1800
},
"payment_terms": {
"description": "Payment due within 30 days",
"due_date": "2024-02-15"
},
"order_reference": "PO-2024-456",
"invoice_note": "Sample draft for demonstration purposes"
},
"strict_mode": true
}'{ "is_valid": true, "issues": [ { … } ], "total_errors": 0, "total_warnings": 0, "en16931_compliant": true, "summary": "string" }