Seqino PDP API - Modern interface to France's e-Invoicing services
- 📊 Submit B2C transaction data (daily aggregate)
Seqino PDP API (1.0.0)
https://pdp.seqino.dev/api/
Request
Submit an exempt invoice for international B2B/B2C transactions.
This endpoint is used for e-reporting individual international invoices that are exempt from mandatory electronic invoice exchange but still require reporting to the government system via F10 flow.
The returned invoice_id can be used with /lifecycle-events to track lifecycle updates.
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/reporting/exempt-invoices
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://pdp.seqino.dev/api/reporting/exempt-invoices \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"direction": "outgoing",
"country_code": "DE",
"model": {
"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"
}
}'{ "invoice_id": "string", "status": "draft" }
Request
Submit aggregated B2C transaction data for a specific date.
This endpoint collects daily B2C transaction summaries that will be processed into F10 format for government e-reporting. Data should be aggregated by category (goods vs services) and VAT rate.
Required for domestic B2C operations under French e-invoicing regulation. Data is reported as daily totals rather than individual transactions.
Args: transaction_date: Date of the transactions (YYYY-MM-DD) currency: Transaction currency (typically EUR) store_location: Optional store/location identifier goods_sales: Aggregated data for goods sales (TLB1 category) services: Aggregated data for services (TPS1 category)
Returns: Confirmation of submission with reference ID for tracking
- Dev server for Beta Testers
https://pdp.seqino.dev/api/reporting/b2c-transactions
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://pdp.seqino.dev/api/reporting/b2c-transactions \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"transaction_date": "2024-01-15",
"currency": "EUR",
"store_location": "Paris - Champs Elysées",
"goods_sales": {
"tax_exclusive_amount": 5000,
"tax_amount": 1000,
"tax_rate": 20,
"transaction_count": 150,
"payment_data": {
"cash_amount": 1500,
"card_amount": 4500,
"payment_date": "2024-01-15"
}
},
"services": {
"tax_exclusive_amount": 2000,
"tax_amount": 400,
"tax_rate": 20,
"transaction_count": 75,
"payment_data": {
"cash_amount": 500,
"card_amount": 1900,
"payment_date": "2024-01-15"
}
}
}'{}
- Dev server for Beta Testers
https://pdp.seqino.dev/api/reporting/payments
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://pdp.seqino.dev/api/reporting/payments \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"client_siren": "string",
"payment_date": "2019-08-24",
"amount": 0,
"currency": "EUR",
"invoice_number": "string"
}'{ "payment_id": "string", "client_siren": "string", "payment_date": "2019-08-24", "amount": "string", "currency": "EUR", "invoice_number": "string", "created_at": "2019-08-24T14:15:22Z", "period": "string" }
- Dev server for Beta Testers
https://pdp.seqino.dev/api/reporting/payments
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://pdp.seqino.dev/api/reporting/payments?client_siren=string&period=string' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'X-PDP-Client-Id: string'[ { "payment_id": "string", "client_siren": "string", "payment_date": "2019-08-24", "amount": "string", "currency": "EUR", "invoice_number": "string", "created_at": "2019-08-24T14:15:22Z", "period": "string" } ]
- Dev server for Beta Testers
https://pdp.seqino.dev/api/reporting/payments/{payment_id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
'https://pdp.seqino.dev/api/reporting/payments/{payment_id}' \
-H 'Authorization: YOUR_API_KEY_HERE' \
-H 'Content-Type: application/json' \
-H 'X-PDP-Client-Id: string' \
-d '{
"client_siren": "string",
"payment_date": "2019-08-24",
"amount": 0,
"currency": "EUR",
"invoice_number": "string"
}'{ "payment_id": "string", "client_siren": "string", "payment_date": "2019-08-24", "amount": "string", "currency": "EUR", "invoice_number": "string", "created_at": "2019-08-24T14:15:22Z", "period": "string" }