Skip to content

Seqino PDP API (1.0.0)

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

Download OpenAPI description
Languages
Servers
Dev server for Beta Testers

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

Operations

📘 Directory

Directory operations

Operations

📝 Drafts

Create and validate invoice drafts

Operations

🧾 Invoicing

Send and receive electronic invoices

Operations

🔄 Lifecycle

Polls or subscribes to lifecycle events

Operations

Request

Get lifecycle events with optional filtering.

  • Without parameters: Returns all lifecycle events for the PDP client
  • With object_type only: Returns all events for that object type
  • With both parameters: Returns events for a specific object

Use invoice for both structured and exempt invoices.

Security
APIKeyHeader
Query
object_typestring(ObjectType)

Filter by object type

Enum"invoice""mandate""directory_entry""regulatory_data""flow""transaction_data""lifecycle_status"
object_idstring(Object Id)

Filter by object ID

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

ID of the PDP Client for which the operation is performed

Examples:
sandbox-client-seqino
curl -i -X GET \
  'https://pdp.seqino.dev/api/lifecycle-events?object_type=invoice&object_id=string' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Responses

Successful Response

Bodyapplication/jsonArray [
status_codestring(LifecycleStatusCode)required
Enum"InvoiceLifecycleStatus.DEPOSITED""InvoiceLifecycleStatus.TRANSMITTED_BY_PLATFORM""InvoiceLifecycleStatus.RECEIVED_BY_PLATFORM""InvoiceLifecycleStatus.MADE_AVAILABLE""InvoiceLifecycleStatus.ACKNOWLEDGED""InvoiceLifecycleStatus.APPROVED""InvoiceLifecycleStatus.PARTIALLY_APPROVED""InvoiceLifecycleStatus.IN_DISPUTE""InvoiceLifecycleStatus.SUSPENDED""InvoiceLifecycleStatus.COMPLETED"
timestampstring(date-time)(Timestamp)required
emitterstring(Emitter)required

Platform or system that emitted the status (PDPE, PDPR, PPF, etc.)

Example: "PDPE"
reasonReason (string) or Reason (null)(Reason)
Any of:

Optional free-text reason or comment

string(Reason)
rejection_reasonRejection Reason (string) or Rejection Reason (null)(Rejection Reason)
Any of:

Structured rejection reason code when status indicates rejection

string(Rejection Reason)
is_mandatoryboolean(Is Mandatory)

Whether this status must be reported to PPF within 24 hours

Default false
]
Response
application/json
[ { "status_code": "InvoiceLifecycleStatus.DEPOSITED", "timestamp": "2019-08-24T14:15:22Z", "emitter": "PDPE", "reason": "string", "rejection_reason": "string", "is_mandatory": false } ]

📋 Mandates

Manage legal entities and PPF directory entries

Operations

🚀 Company Onboarding

Manage onboarding

📊 Reporting

Send e-reporting information

Operations

⚙️ Settings

Configure client preferences

Operations

📊 Usage

Gather API usage per client and invoice

Operations

Request

Health check endpoint.

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

Responses

Successful Response

Bodyapplication/json
any
Response
application/json
null