📋 Create mandate with directory entry

Requête

Create a new mandate with its associated directory entry.

This endpoint creates both:

A directory entry for routing invoices to the company
A mandate granting permission to manage invoices for this entity

The mandate defines the scope of operations the sponsor can perform for this legal entity (SIREN, SIRET, or routing code level).

If end_date is omitted, the mandate never expires and stays active indefinitely (in the PPF directory this maps to an effective end date of 9999-12-31). An expiry can be set or removed later via PATCH /mandates/{id}.

Sécurité

APIKeyHeader

En-têtes

X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Examples:

Sandbox client

client_abc123

Corpsapplication/jsonobligatoire

start_datestring, (date-time)(Start Date)obligatoire

When the mandate becomes active. Note: if the requested start date is today or in the past, it will be updated with the real start date returned by the PPF once the status of the mandate becomes CREATED.

end_datestring or null(End Date)

Any of:

When the mandate should expire. Optional: when omitted (null) the mandate never expires and stays active indefinitely (in the PPF directory this maps to an effective end date of 9999-12-31). An expiry can be set or removed later via PATCH /mandates/{id}.

string (date-time)

directory_entryobject(DirectoryEntry)obligatoire

Directory entry information for the mandated entity

file_attachmentstring or null(File Attachment)

Any of:

Deprecated: no longer required. The file attachment is now handled by the KYB process; this field will be removed in a future version.

string

emit_onlyboolean or null(Emit Only)

Any of:

Whether the mandate is only for emitting invoices

boolean

vat_regimestring(VATRegime)

VAT regime of the mandated company. Determines data transmission periodicity. Can be changed later via PUT /settings/periodicity/{mandate_id}.

Par défaut:"real_normal_monthly"

Enum:"real_normal_monthly""real_normal_quarterly""simplified""franchise"

curl -i -X POST \
  https://pdp.seqino.dev/api/mandates \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'X-PDP-Client-Id: client_abc123' \
  -d '{
    "start_date": "2024-01-15T00:00:00Z",
    "end_date": "2024-12-31T23:59:59Z",
    "directory_entry": {
      "siren": "123456789",
      "name": "string",
      "suffix": "Administration",
      "siret": "12345678901234",
      "routing_identifier": "GLN_987654321",
      "routing_identifier_type": "0224",
      "routing_code_label": "string",
      "establishment_nature": "Private",
      "legal_commitment_management": true,
      "administrative_status": "A",
      "addressable": true,
      "address": {
        "address_line_1": "16 BIS RUE HENRI BARBUSSE",
        "address_line_2": "CEDEX 1",
        "address_line_3": "Bâtiment le Callipso",
        "postal_code": "38100",
        "subdivision": "Bretagne",
        "city": "Grenoble",
        "country_code": "FR"
      }
    },
    "file_attachment": "string",
    "emit_only": true,
    "vat_regime": "real_normal_monthly"
  }'

Réponses

Mandate created successfully

Corpsapplication/json

client_idstring(Client Id)obligatoire

Reference to the client who owns this mandate

start_datestring, (date-time)(Start Date)obligatoire

When the mandate becomes active. Note: if the requested start date is today or in the past, it will be updated with the real start date returned by the PPF once the status of the mandate becomes CREATED.

end_datestring or null(End Date)

Any of:

When the mandate expires. Optional: when omitted (null) the mandate never expires and stays active indefinitely. In the PPF directory an open-ended mandate maps to an effective end date of 9999-12-31. An expiry can be set or removed later via PATCH /mandates/{id}.

string (date-time)

file_attachmentstring or null(File Attachment)

Any of:

Optional file attachment for the mandate

string

statusstring(MandateStatus)obligatoire

Current status of the mandate

Enum:"processing""created""pending_kyb""active""expired""error""portability"

directory_entryobjectobligatoire

Directory entry information for the mandated entity

emit_onlyboolean(Emit Only)

Whether the mandate is only for emitting invoices

Par défaut:false

vat_regimestring(VATRegime)

VAT regime of the mandated company. Determines data transmission periodicity.

Par défaut:"real_normal_monthly"

Enum:"real_normal_monthly""real_normal_quarterly""simplified""franchise"

created_atstring, (date-time)(Created At)obligatoire

When the mandate was created

updated_atstring or null(Updated At)

Any of:

When the mandate was last updated

string (date-time)

error_causestring or null(Error Cause)

Any of:

Cause details in case of error.

string

idstring(Id)obligatoire

Unique mandate identifier

Response

{
  "client_id": "string",
  "start_date": "2019-08-24T14:15:22Z",
  "end_date": "2019-08-24T14:15:22Z",
  "file_attachment": "string",
  "status": "processing",
  "directory_entry": {},
  "emit_only": false,
  "vat_regime": "real_normal_monthly",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "error_cause": "string",
  "id": "string"
}