Create supplier

curl --request POST \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/suppliers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_reference": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "name": "<string>",
  "function": "<string>",
  "is_company": true,
  "company_id": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "language": "<string>",
  "internal_notes": "<string>",
  "website": "<string>",
  "vat": "<string>",
  "iban": "<string>",
  "bank_account": "<string>",
  "currency": "<string>",
  "active": true,
  "addresses": [
    {
      "address_type": "main",
      "name": "<string>",
      "number": "<string>",
      "box": "<string>",
      "phone": "<string>",
      "mobile": "<string>",
      "email": "<string>",
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    }
  ],
  "account_number": "<string>"
}'

{
  "external_reference": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "name": "<string>",
  "function": "<string>",
  "is_company": true,
  "company_id": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "language": "<string>",
  "internal_notes": "<string>",
  "website": "<string>",
  "vat": "<string>",
  "iban": "<string>",
  "bank_account": "<string>",
  "currency": "<string>",
  "active": true,
  "account_number": "<string>",
  "company_number": "<string>",
  "id": "<string>",
  "last_updated_on": "2023-11-07T05:31:56Z",
  "addresses": [
    {
      "address_type": "main",
      "name": "<string>",
      "number": "<string>",
      "box": "<string>",
      "phone": "<string>",
      "mobile": "<string>",
      "email": "<string>",
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    }
  ]
}

POST

consumers

{consumer_id}

accounting

suppliers

Create supplier

curl --request POST \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/suppliers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_reference": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "name": "<string>",
  "function": "<string>",
  "is_company": true,
  "company_id": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "language": "<string>",
  "internal_notes": "<string>",
  "website": "<string>",
  "vat": "<string>",
  "iban": "<string>",
  "bank_account": "<string>",
  "currency": "<string>",
  "active": true,
  "addresses": [
    {
      "address_type": "main",
      "name": "<string>",
      "number": "<string>",
      "box": "<string>",
      "phone": "<string>",
      "mobile": "<string>",
      "email": "<string>",
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    }
  ],
  "account_number": "<string>"
}'

{
  "external_reference": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "name": "<string>",
  "function": "<string>",
  "is_company": true,
  "company_id": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "language": "<string>",
  "internal_notes": "<string>",
  "website": "<string>",
  "vat": "<string>",
  "iban": "<string>",
  "bank_account": "<string>",
  "currency": "<string>",
  "active": true,
  "account_number": "<string>",
  "company_number": "<string>",
  "id": "<string>",
  "last_updated_on": "2023-11-07T05:31:56Z",
  "addresses": [
    {
      "address_type": "main",
      "name": "<string>",
      "number": "<string>",
      "box": "<string>",
      "phone": "<string>",
      "mobile": "<string>",
      "email": "<string>",
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

This access token needs to be included in each of your request to the Chift API.

Path Parameters

consumer_id

string<uuid>

required

Query Parameters

folder_id

string | null

Id of the accounting folder instance. A folder represents a legal entity within the system. Required when the multiple folders feature is enabled.

force_merge

string | null

Indicate the ID of the corresponding client/customer in the accounting system. Accounting systems using 1 entity to handle clients/customers and suppliers will merge the existing client/customer with the new supplier (if the parameter is filled in with the ID of an existing client/customer).

Body

application/json

name

string

required

Full name or legal name of the supplier (individual or company). This is the name that will be displayed in the accounting software.

Minimum length: 1

addresses

AddressItemIn · object[]

required

List of addresses associated with the supplier.

Show child attributes

external_reference

string | null

External identifier used to link the supplier in the accounting system with the corresponding supplier reference in your own system.

first_name

string | null

Only used when the supplier is an individual (is_company=false). Indicates the first name of the supplier.

last_name

string | null

Only used when the supplier is an individual (is_company=false). Indicates the last name of the supplier.

function

string | null

Only used when the supplier is an individual (is_company=false). Indicates the function of the supplier.

is_company

boolean | null

default:true

Indicates if the supplier is an individual or a company.

company_id

string | null

Only used when the supplier is an individual (is_company=false). Indicates the id of the company linked to the supplier.

phone

string | null

Phone number of the supplier.

mobile

string | null

Mobile phone number of the supplier.

string | null

Email address of the supplier.

language

string | null

Language of the supplier. Format: ISO 639-1 codes.

internal_notes

string | null

Internal notes about the supplier.

website

string | null

Website of the supplier.

vat

string | null

VAT number of the supplier.

iban

string | null

IBAN account number of the supplier.

bank_account

string | null

Bank account number of the supplier.

currency

string | null

Indicates the currency of the supplier (e.g., EUR).

active

boolean | null

default:true

Indicates if the supplier is active.

account_number

string | null

Number of ledger account assigned to the supplier in the accounting system as it will appear in the official accounting export file (FEC, SIE, iXBRL, etc.). This is typically the ledger account used for posting payables. In some systems, each supplier has a dedicated account; in others, a shared control account is used and supplier balances are tracked in a subledger.

Response

Successful Response

external_reference

string | null

External identifier used to link the supplier in the accounting system with the corresponding supplier reference in your own system.

first_name

string | null

Only used when the supplier is an individual (is_company=false). Indicates the first name of the supplier.

last_name

string | null

Only used when the supplier is an individual (is_company=false). Indicates the last name of the supplier.

name

string | null

Full name or legal name of the supplier (individual or company). This is the name displayed in the accounting software.

function

string | null

Only used when the supplier is an individual (is_company=false). Indicates the function of the supplier.

is_company

boolean | null

default:true

Indicates if the supplier is an individual or a company.

company_id

string | null

Only used when the supplier is an individual (is_company=false). Indicates the id of the company linked to the supplier.

phone

string | null

Phone number of the supplier.

mobile

string | null

Mobile phone number of the supplier.

string | null

Email address of the supplier.

language

string | null

Language of the supplier. Format: ISO 639-1 codes.

internal_notes

string | null

Internal notes about the supplier.

website

string | null

Website of the supplier.

vat

string | null

VAT number of the supplier.

iban

string | null

IBAN account number of the supplier.

bank_account

string | null

Bank account number of the supplier.

currency

string | null

Indicates the currency of the supplier (e.g., EUR).

active

boolean | null

default:true

Indicates if the supplier is active.

account_number

string | null

Ledger account number assigned to the supplier in the accounting system as it will appear in the official accounting export file (FEC, SIE, iXBRL, etc.).

company_number

string | null

Id of the associated company, used when the record is a contact person linked to a company.

string | null

Id of the supplier in the accounting software. This is the unique identifier used to reference the supplier in the system.

last_updated_on

string<date-time> | null

The last time the supplier has been updated.

addresses

AddressItemOut · object[] | null

List of addresses associated with the supplier.

Show child attributes

Update client Get one supplier

⌘I

API Reference Overview

Access & Connections

Accounting

Invoicing

POS

eCommerce

PMS

Payment

Banking

Other

Create supplier

Authorizations

Path Parameters

Query Parameters

Body

Response