Update one supplier

curl --request PATCH \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/suppliers/{supplier_id} \
  --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>"
    }
  ]
}'

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

PATCH

consumers

{consumer_id}

accounting

suppliers

{supplier_id}

Update one supplier

curl --request PATCH \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/suppliers/{supplier_id} \
  --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>"
    }
  ]
}'

{
  "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

supplier_id

string

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.

Body

application/json

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 that will be 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.

addresses

AddressItemOut · object[] | null

List of addresses associated with the supplier.

Show child attributes

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

Get suppliers Create sale/purchase entry

API Reference Overview

Access & Connections

Accounting

Invoicing

POS

eCommerce

PMS

Payment

Banking

Other

Update one supplier

Authorizations

Path Parameters

Query Parameters

Body

Response