Passer au contenu
/
📋 Create multiple mandat...

Seqino PDP API (1.0.0)

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

Télécharger la description d'OpenAPI
openapi.json
openapi.yaml
Aperçu
URL

https://pdp.seqino.dev/

Langues
Serveurs
Dev server for Beta Testers

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

👥 Clients

Manage clients

Opérations

📘 Directory

Directory operations

Opérations

📝 Drafts

Create and validate invoice drafts

Opérations

🧾 Invoicing

Send and receive electronic invoices

Opérations

🔄 Lifecycle

Polls or subscribes to lifecycle events

Opérations

📋 Mandates

Manage legal entities and PPF directory entries

Opérations

📋 Get client mandates

Requête

Get all mandates for a client with their directory information.

Returns a list of mandates with their associated directory entries, including routing information and establishment details.

Sécurité
APIKeyHeader
Requête
status_filterMandateStatus (string) or Status Filter (null)(Status Filter)
Any of:

Status of the mandate.

string(MandateStatus)
Enum"created""pending_kyc""active""expired"
En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Exemples:
sandbox-client-seqino
curl -i -X GET \
  'https://pdp.seqino.dev/api/mandates?status_filter=created' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Réponses

List of client mandates

Corpsapplication/jsonArray [
idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
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

end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
statusstring(MandateStatus)obligatoire
Enum"created""pending_kyc""active""expired"
directory_entryobject(DirectoryEntry)obligatoire
directory_entry.​sirenstring(Siren)non-emptyobligatoire

Company identification number (SIREN)

directory_entry.​namestring(Name)non-emptyobligatoire

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
created_atstring(date-time)(Created At)obligatoire

When the mandate was created

updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
]
Réponse
application/json
[
  {
    "id": "string",
    "client_id": "string",
    "start_date": "2019-08-24T14:15:22Z",
    "end_date": "2019-08-24T14:15:22Z",
    "file_attachment": "string",
    "status": "created",
    "directory_entry": { … },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
]

📋 Create mandate with directory entry

Requête

Create a new mandate with its associated directory entry.

This endpoint creates both:

  1. A directory entry for routing invoices to the company
  2. 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).

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

Exemples:
sandbox-client-seqino
Corpsapplication/jsonobligatoire
start_datestring(date-time)(Start Date)obligatoire

When the mandate should become active

Exemple: "2024-01-15T00:00:00Z"
end_dateEnd Date (string) or End Date (null)(End Date)
Exemple: "2024-12-31T23:59:59Z"
Any of:

When the mandate should expire (optional)

string(date-time)(End Date)
directory_entryobject(DirectoryEntry)obligatoire
directory_entry.​sirenstring(Siren)non-emptyobligatoire

Company identification number (SIREN)

directory_entry.​namestring(Name)non-emptyobligatoire

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
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: string' \
  -d '{
    "start_date": "2024-01-15T00:00:00Z",
    "end_date": "2024-12-31T23:59:59Z",
    "directory_entry": {
      "siren": "string",
      "name": "string",
      "suffix": "string",
      "siret": "string",
      "routing_identifier": "string",
      "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"
      },
      "created_at": "2019-08-24",
      "updated_at": "2019-08-24"
    },
    "file_attachment": "string"
  }'

Réponses

Mandate created successfully

Corpsapplication/json
mandateobject(Mandate)obligatoire
mandate.​idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
mandate.​client_idstring(Client Id)obligatoire

Reference to the client who owns this mandate

mandate.​start_datestring(date-time)(Start Date)obligatoire

When the mandate becomes active

mandate.​end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
mandate.​file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
mandate.​statusstring(MandateStatus)obligatoire
Enum"created""pending_kyc""active""expired"
mandate.​directory_entryobject(DirectoryEntry)obligatoire
mandate.​directory_entry.​sirenstring(Siren)non-emptyobligatoire

Company identification number (SIREN)

mandate.​directory_entry.​namestring(Name)non-emptyobligatoire

Company name

mandate.​directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
mandate.​directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
mandate.​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
mandate.​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
mandate.​directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
mandate.​directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
mandate.​directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
mandate.​directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
mandate.​directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
mandate.​directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

mandate.​directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
mandate.​directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
mandate.​created_atstring(date-time)(Created At)obligatoire

When the mandate was created

mandate.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
messagestring(Message)obligatoire

Response message

Exemple: "Mandate created successfully"
Réponse
application/json
{
  "mandate": {
    "id": "string",
    "client_id": "string",
    "start_date": "2019-08-24T14:15:22Z",
    "end_date": "2019-08-24T14:15:22Z",
    "file_attachment": "string",
    "status": "created",
    "directory_entry": { … },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  },
  "message": "Mandate created successfully"
}

📋 Get mandate details

Requête

Get detailed information about a specific mandate.

Sécurité
APIKeyHeader
Chemin
mandate_idstring(Mandate Id)obligatoire

Mandate ID

En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)

ID of the PDP Client for which the operation is performed

Exemples:
sandbox-client-seqino
curl -i -X GET \
  'https://pdp.seqino.dev/api/mandates/{mandate_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Réponses

Mandate details

Corpsapplication/json
idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
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

end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
statusstring(MandateStatus)obligatoire
Enum"created""pending_kyc""active""expired"
directory_entryobject(DirectoryEntry)obligatoire
directory_entry.​sirenstring(Siren)non-emptyobligatoire

Company identification number (SIREN)

directory_entry.​namestring(Name)non-emptyobligatoire

Company name

directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
created_atstring(date-time)(Created At)obligatoire

When the mandate was created

updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
Réponse
application/json
{
  "id": "string",
  "client_id": "string",
  "start_date": "2019-08-24T14:15:22Z",
  "end_date": "2019-08-24T14:15:22Z",
  "file_attachment": "string",
  "status": "created",
  "directory_entry": {
    "siren": "string",
    "name": "string",
    "suffix": "string",
    "siret": "string",
    "routing_identifier": "string",
    "routing_identifier_type": "0224",
    "routing_code_label": "string",
    "establishment_nature": "Private",
    "legal_commitment_management": true,
    "administrative_status": "A",
    "addressable": true,
    "address": { … },
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  },
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

📋 Revoke mandate

Requête

Revoke a mandate.

This action permanently deletes the mandate, revoking the sponsor's permission to manage invoices for this entity. The associated directory entry remains active but the sponsor can no longer perform operations on behalf of this entity.

Sécurité
APIKeyHeader
Chemin
mandate_idstring(Mandate Id)obligatoire

Mandate ID

En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)obligatoire

ID of the PDP Client for which the operation is performed

Exemples:
sandbox-client-seqino
curl -i -X DELETE \
  'https://pdp.seqino.dev/api/mandates/{mandate_id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Réponses

Mandate revoked successfully

Réponse
Aucun contenu

📋 Create multiple mandates

Requête

Create multiple mandates in a single batch operation.

This endpoint allows creating multiple mandates for a client at once, which is useful when onboarding clients with multiple entities or when importing existing mandate data.

All mandates in the batch will use the same client_id from the header. If any mandate fails to create, the entire batch will be rolled back.

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

Exemples:
sandbox-client-seqino
Corpsapplication/jsonobligatoire
mandatesArray of objects(Mandates)[ 1 .. 50 ] itemsobligatoire

List of mandates to create

mandates[].​start_datestring(date-time)(Start Date)obligatoire

When the mandate should become active

Exemple: "2024-01-15T00:00:00Z"
mandates[].​end_dateEnd Date (string) or End Date (null)(End Date)
Exemple: "2024-12-31T23:59:59Z"
Any of:

When the mandate should expire (optional)

string(date-time)(End Date)
mandates[].​directory_entryobject(DirectoryEntry)obligatoire
mandates[].​directory_entry.​sirenstring(Siren)non-emptyobligatoire

Company identification number (SIREN)

mandates[].​directory_entry.​namestring(Name)non-emptyobligatoire

Company name

mandates[].​directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
mandates[].​directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
mandates[].​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
mandates[].​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
mandates[].​directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
mandates[].​directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
mandates[].​directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
mandates[].​directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
mandates[].​directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
mandates[].​directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

mandates[].​directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
mandates[].​directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
mandates[].​file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
curl -i -X POST \
  https://pdp.seqino.dev/api/mandates/batch \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -H 'X-PDP-Client-Id: string' \
  -d '{
    "mandates": [
      {
        "start_date": "2024-01-15T00:00:00Z",
        "end_date": "2024-12-31T23:59:59Z",
        "directory_entry": {
          "siren": "string",
          "name": "string",
          "suffix": "string",
          "siret": "string",
          "routing_identifier": "string",
          "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"
          },
          "created_at": "2019-08-24",
          "updated_at": "2019-08-24"
        },
        "file_attachment": "string"
      }
    ]
  }'

Réponses

Mandates created successfully

Corpsapplication/json
mandatesArray of objects(Mandates)obligatoire

Created mandates

mandates[].​idId (string) or Id (null)(Id)
Any of:

Unique mandate identifier

string(Id)
mandates[].​client_idstring(Client Id)obligatoire

Reference to the client who owns this mandate

mandates[].​start_datestring(date-time)(Start Date)obligatoire

When the mandate becomes active

mandates[].​end_dateEnd Date (string) or End Date (null)(End Date)
Any of:

When the mandate expires (optional)

string(date-time)(End Date)
mandates[].​file_attachmentFile Attachment (string) or File Attachment (null)(File Attachment)
Any of:

Optional file attachment for the mandate

string(File Attachment)
mandates[].​statusstring(MandateStatus)obligatoire
Enum"created""pending_kyc""active""expired"
mandates[].​directory_entryobject(DirectoryEntry)obligatoire
mandates[].​directory_entry.​sirenstring(Siren)non-emptyobligatoire

Company identification number (SIREN)

mandates[].​directory_entry.​namestring(Name)non-emptyobligatoire

Company name

mandates[].​directory_entry.​suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
mandates[].​directory_entry.​siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
mandates[].​directory_entry.​routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
mandates[].​directory_entry.​routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
mandates[].​directory_entry.​routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
mandates[].​directory_entry.​establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
mandates[].​directory_entry.​legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
mandates[].​directory_entry.​administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
mandates[].​directory_entry.​addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
mandates[].​directory_entry.​addressAddress (object) or null
Any of:

Address information for the establishment.

mandates[].​directory_entry.​created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
mandates[].​directory_entry.​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
mandates[].​created_atstring(date-time)(Created At)obligatoire

When the mandate was created

mandates[].​updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the mandate was last updated

string(date-time)(Updated At)
messagestring(Message)obligatoire

Success message

created_countinteger(Created Count)obligatoire

Number of mandates created

Réponse
application/json
{
  "mandates": [
    { … }
  ],
  "message": "string",
  "created_count": 0
}

📘 Get directory entries for SIREN

Requête

Get all directory/routing entries from the directory database for a given SIREN.

This endpoint retrieves routing information for a company identified by its SIREN. The data includes establishment details and routing configurations for electronic invoicing.

Sécurité
APIKeyHeader
Chemin
sirenstring(Siren)obligatoire

Company SIREN number

Exemple: 123456789
En-têtes
X-PDP-Client-Idstring(X-Pdp-Client-Id)

ID of the PDP Client for which the operation is performed

Exemples:
sandbox-client-seqino
curl -i -X GET \
  https://pdp.seqino.dev/api/mandates/directory/123456789 \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'X-PDP-Client-Id: string'

Réponses

Directory entries found

Corpsapplication/jsonArray [
sirenstring(Siren)non-emptyobligatoire

Company identification number (SIREN)

namestring(Name)non-emptyobligatoire

Company name

suffixSuffix (string) or Suffix (null)(Suffix)
Any of:

Service suffix - when using simple SIREN+suffix nomenclature

string(Suffix)
siretSiret (string) or Siret (null)(Siret)
Any of:

Establishment identification number (SIRET)

string(Siret)
routing_identifierRouting Identifier (string) or Routing Identifier (null)(Routing Identifier)
Any of:

Routing identifier

string(Routing Identifier)
routing_identifier_typeRoutingIdentifierType (string) or null
Any of:

Type of routing identifier.

string(RoutingIdentifierType)
Enum"0224""0088""0060""Internal"
routing_code_labelRouting Code Label (string) or Routing Code Label (null)(Routing Code Label)
Any of:

Label for the routing code

string(Routing Code Label)
establishment_natureEstablishmentNature (string) or null
Any of:

Nature of the establishment.

string(EstablishmentNature)
Enum"Private""Public"
legal_commitment_managementLegal Commitment Management (boolean) or Legal Commitment Management (null)(Legal Commitment Management)
Any of:

Legal commitment management status

boolean(Legal Commitment Management)
administrative_statusAdministrativeStatus (string) or null
Any of:

Administrative status of the establishment.

string(AdministrativeStatus)
Enum"A""F"
addressableAddressable (boolean) or Addressable (null)(Addressable)
Any of:

Whether the company is addressable

boolean(Addressable)
addressAddress (object) or null
Any of:

Address information for the establishment.

created_atCreated At (string) or Created At (null)(Created At)
Any of:

When the entry was created

string(date)(Created At)
updated_atUpdated At (string) or Updated At (null)(Updated At)
Any of:

When the entry was last updated

string(date)(Updated At)
]
Réponse
application/json
[
  {
    "siren": "string",
    "name": "string",
    "suffix": "string",
    "siret": "string",
    "routing_identifier": "string",
    "routing_identifier_type": "0224",
    "routing_code_label": "string",
    "establishment_nature": "Private",
    "legal_commitment_management": true,
    "administrative_status": "A",
    "addressable": true,
    "address": { … },
    "created_at": "2019-08-24",
    "updated_at": "2019-08-24"
  }
]

📊 Reporting

Send e-reporting information

Opérations

⚙️ Settings

Configure client preferences

Opérations

📊 Usage

Gather API usage per client and invoice

Opérations

Health Check

Requête

Health check endpoint.

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

Réponses

Successful Response

Corpsapplication/json
any
Réponse
application/json
null