Sign in

v1

latestOpenAPI 3.0.12026-07-141671231.8 MB
Suppliers

Create a Supplier

This endpoint returns the created supplier.

ℹ️ This endpoint requires the following scope: suppliers:all

post/api/external/v2/suppliers

Request body

namestring required
establishment_nostring nullable

Supplier identification number (SIRET).

  • 14-digit number combining SIREN (9 digits) and NIC (5 digits)
  • Only applicable for French companies
reg_nostring

Supplier registration number (SIREN).

  • 9-digit number
  • Only applicable for French companies
vat_numberstring
emailsstring[]
ibanstring
supplier_payment_method'automatic_transfer' | 'manual_transfer' | 'automatic_debiting' | 'bill_of_exchange' | 'check' | 'cash' | 'card' | 'other' nullable
supplier_due_date_delayinteger
supplier_due_date_rule'days' | 'days_or_end_of_month' nullable
external_referencestring

A unique external reference you can provide to track this supplier. If not provided, Pennylane will generate an identifier for you.

Example request

{
  "name": "Pennylane",
  "establishment_no": "82762938500014",
  "reg_no": "827629385",
  "postal_address": {
    "address": "8 rue de la paix",
    "postal_code": "75002",
    "city": "Paris",
    "country_alpha2": "FR"
  },
  "vat_number": "FR32123456789",
  "ledger_account": {
    "number": "411100344"
  },
  "emails": [
    "hello@example.org"
  ],
  "iban": "FR3330002005500000157841Z25",
  "supplier_due_date_delay": 30,
  "external_reference": "FR123"
}

Response

Returns the created supplier

idinteger required
namestring required
establishment_nostring nullable required

Supplier identification number (SIRET).

  • 14-digit number combining SIREN (9 digits) and NIC (5 digits)
  • Only applicable for French companies
reg_nostring nullable required

Supplier registration number (SIREN).

  • 9-digit number
  • Only applicable for French companies
vat_numberstring required
emailsstring[] required
ibanstring required

The IBAN of the supplier

supplier_payment_method'automatic_transfer' | 'manual_transfer' | 'automatic_debiting' | 'bill_of_exchange' | 'check' | 'cash' | 'card' | 'other' nullable required
supplier_due_date_delayinteger nullable required
supplier_due_date_rule'days' | 'days_or_end_of_month' nullable required
external_referencestring required

The unique external reference that was assigned during creation either by you or Pennylane

created_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": 42,
  "name": "Pennylane",
  "establishment_no": "82762938500014",
  "reg_no": "827629385",
  "vat_number": "FR32123456789",
  "emails": [
    "hello@example.org"
  ],
  "iban": "FRXXXXXXXXXXXXXXXXXXXXXXXXX",
  "supplier_due_date_delay": 30,
  "external_reference": "FR123",
  "created_at": "2023-08-30T10:08:08.146343Z",
  "updated_at": "2023-08-30T10:08:08.146343Z"
}