v1

latestOpenAPI 3.1.02026-07-22155403592.5 KB

Accounting

Suppliers

Update one supplier

Update an accounting supplier

patch/consumers/{consumer_id}/accounting/suppliers/{supplier_id}

Path parameters

consumer_idstring uuid required

supplier_idstring required

Query parameters

folder_idstring nullable

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

Request body

external_referencestring nullable

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

first_namestring nullable

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

last_namestring nullable

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

namestring nullable

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

functionstring nullable

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

is_companyboolean nullable

Indicates if the supplier is an individual or a company.

company_idstring nullable

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

phonestring nullable

Phone number of the supplier.

mobilestring nullable

Mobile phone number of the supplier.

emailstring nullable

Email address of the supplier.

languagestring nullable

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

internal_notesstring nullable

Internal notes about the supplier.

websitestring nullable

Website of the supplier.

vatstring nullable

VAT number of the supplier.

company_numberstring nullable

National identification number of the company.

ibanstring nullable

IBAN account number of the supplier.

bank_accountstring nullable

Bank account number of the supplier.

currencystring nullable

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

activeboolean nullable

Indicates if the supplier is active.

Response

Successful Response

external_referencestring nullable

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

first_namestring nullable

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

last_namestring nullable

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

namestring nullable

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

functionstring nullable

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

is_companyboolean nullable

Indicates if the supplier is an individual or a company.

company_idstring nullable

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

phonestring nullable

Phone number of the supplier.

mobilestring nullable

Mobile phone number of the supplier.

emailstring nullable

Email address of the supplier.

languagestring nullable

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

internal_notesstring nullable

Internal notes about the supplier.

websitestring nullable

Website of the supplier.

vatstring nullable

VAT number of the supplier.

company_numberstring nullable

National identification number of the company.

ibanstring nullable

IBAN account number of the supplier. DEPRECATED see bank_accounts

bank_accountstring nullable

Bank account number of the supplier. DEPRECATED see bank_accounts

currencystring nullable

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

activeboolean nullable

Indicates if the supplier is active.

account_numberstring nullable

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.).

idstring nullable

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

last_updated_onstring date-time nullable

The last time the supplier has been updated.

third_party_accountstring nullable

Third party account number/code representing the client in the accounting software.