Skip to content

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/

Languages
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

🔄 Lifecycle

Operations

📊 Get lifecycle events

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.

Query
object_typestring(Object Type)

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-api-v250704-iron.seqino.dev/api/lifecycle-events/?object_type=invoice&object_id=string' \
  -H 'X-PDP-Client-Id: string'

Responses

Successful Response

Bodyapplication/jsonArray [
status_codestring(LifecycleStatusCode)required

Unified lifecycle status codes for all object types.

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)

Optional free-text reason or comment

Any of:

Optional free-text reason or comment

string(Reason)

Optional free-text reason or comment

rejection_reasonRejection Reason (string) or Rejection Reason (null)(Rejection Reason)

Structured rejection reason code when status indicates rejection

Any of:

Structured rejection reason code when status indicates rejection

string(Rejection Reason)

Structured rejection reason code when status indicates rejection

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

📊 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