---
title: "Update Company (Deprecated)"
method: PATCH
path: "/v1/accounting/company/{id}"
tags: ["API / Accounting", "Use case / Accounting"]
deprecated: true
---

# Update Company (Deprecated)

`PATCH /v1/accounting/company/{id}`

> **Deprecated.**

(deprecated, use /company/{id} instead)

## Path parameters

- `id` string, uuid, required

## Request body

- CompanyPartialInput
  - `is_customer` boolean, nullable — Indicate that this company is a customer. At least one of `is_customer` or `is_subcontractor` must be set.
  - `is_buyer_or_seller` boolean, nullable — Indicates that this company is a buyer or seller of a consignment
  - `name` string, nullable — Name of the company.
  - `code` string, nullable — External reference to this company record
  - `currency` string, nullable — Currency of the company (ISO 4217, 3 letter code)
  - `custom_fields` object, nullable — Custom fields of the company
  - `credit_policy` CreditPolicyInput
    - `limit` number, nullable — The limit for total amount that has been invoiced but not paid.
  - `default_invoice_customer_id` string, uuid, nullable — ID of the default invoice customer (bill-to) for this company. When set, charges for this customer are billed to the referenced company instead.
  - `is_subcontractor` boolean, nullable — Indicate that this company is a subcontractor (supplier). At least one of `is_customer` or `is_subcontractor` must be set.
  - `archived_customer` boolean, nullable — Set to `true` to archive the customer role of this company, or `false` to reactivate it. Has no effect if `is_customer` is `false`.
  - `archived_subcontractor` boolean, nullable — Set to `true` to archive the subcontractor role of this company, or `false` to reactivate it. Has no effect if `is_subcontractor` is `false`.
  - `legal_name` string, nullable — Legal name of the company.
  - `locale` string, nullable — Locale of the company. Format: ISO 639-1 language code, optionally followed by a dash and ISO 3166-1 alpha-2 country code.
  - `vat_number` string, nullable — VAT number of the company.
  - `reference_numbers` CompanyReferenceNumbers
    - `eori_number` string, nullable — Economic Operator Registration and Identification
    - `duns_number` string, nullable — D-U-N-S Number
    - `scac_code` string, nullable — Standard Carrier Alpha Code
    - `company_registration_number` string, nullable — Company Registration Number
    - `tss_registration_number` string, nullable — TSS registration number
  - `note` string, nullable — Additional notes about the company
  - `tax_type` 'VAT' | 'REVERSE_CHARGE' | 'TRANSIT' | 'NO_VAT' | 'CO_CONTRACTING' | 'OTHER'
  - `bank_accounts` BankAccount[], nullable — List of associated bank accounts.
    - `bic_code` string, nullable
    - `iban_code` string, nullable
  - `accounting_code` string, nullable — Code linked to the accounting system
  - `billing_location` BillingLocation
    - `code` string, nullable — Code of the location
    - `display_name` string, nullable — Human-readable label for a location in operational views.
    - `external_id` string, nullable — Identifier from an external (master data) system.
    - `address` string, nullable — First address line of the location
    - `address_second_line` string, nullable — Second address line of the location
    - `city` string, nullable — City of the location
    - `state` string, nullable — State of the location
    - `country` string, nullable — Country code (ISO 3166-1 alpha-2) of the location
    - `postal_code` string, nullable — Postal code of the location
    - `name` string, nullable — Name of the location
  - `payment_term` BasePaymentTerm
    - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
  - `contacts` CompanyContactInput[], nullable — List of contacts associated with the company
    - `id` string, uuid, nullable — Unique identifier of the contact. When creating a new contact, this field should be omitted or set to null. This field only needs to be provided when updating an existing contact of the company
    - `is_archived` boolean — Indicates whether a contact should be archived. Set to true to archive the contact.
    - `roles` ContactType[] — List of roles associated with the contact.
    - `name` string, nullable — Name of the contact person associated with the company.
    - `note` string, nullable — Additional notes about the contact person.
    - `email` string, nullable — Email address of the contact person.
    - `phone_number` string, nullable — Phone number of the contact person. Expected format is E.164 (e.g., +32485123456).
  - `sales` SalesCompanyFieldsInput
    - `payment_term` BasePaymentTerm
      - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
    - `billing_entities` CompanyBillingEntity[], nullable — List of billing entities associated with the company
      - `id` string, uuid, nullable — Unique identifier of the billing entity associated with the company.
      - `code` string, nullable — Code of the billing entity associated with the company.
      - `accounting_code` string, nullable — Accounting code linked to the billing entity for the company.
    - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
  - `purchase` PurchaseCompanyFieldsInput
    - `payment_term` BasePaymentTerm
      - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
    - `billing_entities` CompanyBillingEntity[], nullable — List of billing entities associated with the company
      - `id` string, uuid, nullable — Unique identifier of the billing entity associated with the company.
      - `code` string, nullable — Code of the billing entity associated with the company.
      - `accounting_code` string, nullable — Accounting code linked to the billing entity for the company.
    - `status` 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
  - `credit_limit_total` number, nullable — The limit for total amount that has been invoiced but not paid. **Deprecated**: use `credit_policy.limit` instead.
  - `is_blocked` boolean, nullable — Set to true to disallow new order creation for companies representing companies. **Note**: Deprecated in favor of `status` under the `sales` and `purchase` fields.an update of `status` will always prevail over `is_blocked` update.
  - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'

## Response `200`

Successful Response

- CompanyDetailOutput
  - `id` string, uuid, required — The unique identifier of the company.
  - `code` string, nullable — External reference to this company record
  - `currency` string, required — Currency of the company (ISO 4217, 3 letter code)
  - `custom_fields` object, nullable — Custom fields of the company
  - `is_customer` boolean — Indicate that this company is a customer
  - `is_subcontractor` boolean — Indicate that this company is a subcontractor (supplier)
  - `is_buyer_or_seller` boolean, nullable — Indicates that this company is a buyer or seller of a consignment
  - `name` string, required — Name of the company.
  - `legal_name` string, nullable — Legal name of the company.
  - `vat_number` string, nullable — VAT number of the company.
  - `note` string, nullable — Additional notes about the company
  - `tax_type` 'VAT' | 'REVERSE_CHARGE' | 'TRANSIT' | 'NO_VAT' | 'CO_CONTRACTING' | 'OTHER'
  - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
  - `accounting_code` string, nullable — Default customer accounting code linked to the accounting system. Please use the accounting codes on the billing entities, as these are split per billing entity and between sales/purchase sides.
  - `billing_location` LocationOutput
    - `code` string, nullable — Technical code for integrations/mapping logic; should be treated as stable once set.
    - `display_name` string, nullable — Human-readable label for a location in operational views.
    - `external_id` string, nullable — Identifier from an external (master data) system.
    - `address` string, nullable — First address line of the location
    - `address_second_line` string, nullable — Second address line of the location
    - `city` string, nullable — City of the location
    - `state` string, nullable — State of the location
    - `country` string, nullable — Country code (ISO 3166-1 alpha-2) of the location
    - `postal_code` string, nullable — Postal code of the location
    - `name` string, nullable — Name of the location
    - `id` string, uuid, nullable — Unique identifier of the location
    - `latitude` number, nullable — Latitude of the location
    - `longitude` number, nullable — Longitude of the location
  - `payment_term` BasePaymentTerm
    - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
  - `locale` string, required — Locale of the company. Format: ISO 639-1 language code, optionally followed by a dash and ISO 3166-1 alpha-2 country code.
  - `archived_customer` boolean, required — Indicate that this company is archived as a customer
  - `archived_subcontractor` boolean, required — Indicate that this company is archived as a subcontractor
  - `archived_buyer_or_seller` boolean, required — Indicates that this company is archived as buyer/seller of a consignment
  - `credit_policy` CreditPolicyOutput
    - `limit` number, nullable — The limit for total amount that has been invoiced but not paid.
  - `default_invoice_customer` ApiAccountingModelsCompanyCompanyReferenceOutput
    - `id` string, uuid, required — The unique identifier of the company.
    - `name` string, required — Name of the company.
    - `code` string, nullable — External reference to this company record
  - `reference_numbers` CompanyReferenceNumbers
    - `eori_number` string, nullable — Economic Operator Registration and Identification
    - `duns_number` string, nullable — D-U-N-S Number
    - `scac_code` string, nullable — Standard Carrier Alpha Code
    - `company_registration_number` string, nullable — Company Registration Number
    - `tss_registration_number` string, nullable — TSS registration number
  - `bank_accounts` BankAccount[] — List of associated bank accounts.
    - `bic_code` string, nullable
    - `iban_code` string, nullable
  - `contacts` CompanyContactOutput[], nullable — List of contacts associated with the company
    - `id` string, uuid, nullable — Unique identifier of the contact
    - `roles` ContactType[] — List of roles associated with the contact.
    - `name` string, nullable — Name of the contact person associated with the company.
    - `note` string, nullable — Additional notes about the contact person.
    - `email` string, nullable — Email address of the contact person.
    - `phone_number` string, nullable — Phone number of the contact person.
  - `sales` SalesCompanyFieldsOutput
    - `payment_term` BasePaymentTerm
      - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
    - `billing_entities` CompanyBillingEntity[], nullable — List of billing entities associated with the company
      - `id` string, uuid, nullable — Unique identifier of the billing entity associated with the company.
      - `code` string, nullable — Code of the billing entity associated with the company.
      - `accounting_code` string, nullable — Accounting code linked to the billing entity for the company.
    - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
  - `purchase` PurchaseCompanyFieldsOutput
    - `payment_term` BasePaymentTerm
      - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
    - `billing_entities` CompanyBillingEntity[], nullable — List of billing entities associated with the company
      - `id` string, uuid, nullable — Unique identifier of the billing entity associated with the company.
      - `code` string, nullable — Code of the billing entity associated with the company.
      - `accounting_code` string, nullable — Accounting code linked to the billing entity for the company.
    - `status` 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
  - `timestamp_updated` string, date-time, required — The date and time when the company was last updated.
  - `is_blocked` boolean — Set to true to disallow new order creation for companies representing companies. **Note**: Deprecated in favor of `status`.
  - `credit_limit_total` number, nullable — The limit for total amount that has been invoiced but not paid. **Deprecated**: use `credit_policy.limit` instead.

## Other responses

- `400` — Bad Request — invalid input or malformed request
- `401` — Unauthorized — missing or invalid authentication credentials
- `403` — Forbidden — insufficient permissions for this operation
- `422` — Validation Error
- `429` — Too Many Requests — rate limit exceeded. See the `Retry-After` header
- `500` — Internal Server Error
- `503` — Service Unavailable — temporarily unable to handle the request

---

[API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qargo/qargo-tms-api/revisions/17297902e7ce/schema)