Core contacts

Получить карточку контрагента

Возвращает реквизиты одного контрагента в пределах кабинета и прав вызывающего.

get/api/v1/core/contacts/{id}

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/core/contacts/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key
    • OAuth 2 (authorization code, authorization URL https://erp.akeda.ru/oauth2/authorize, token URL https://erp.akeda.ru/oauth2/token, scopes: akeda:delegate)
    • HTTP bearer

Response

Контрагент

idstring uuid required
namestring required
kind'client' | 'supplier' | 'both' required

Legacy combined role; new clients read and patch is_customer/is_supplier independently.

is_customerboolean required
is_supplierboolean required
folder_idstring uuid required
entity_type'legal' | 'individual' | 'sole_prop' required
legal_namestring required
phonestring required
emailstring required
positionstring required
messengersobject required

Мессенджеры объектом «сеть → адрес», например {"telegram": "@ivan"} (ERP-2517). По адресам ищет параметр q списка контрагентов

sourcestring required
innstring required
kppstring required
ogrnstring required
addressstring required
bank_namestring required
bank_bicstring required
bank_accountstring required
external_idstring required
customobject required
is_activeboolean required
created_atstring date-time required
updated_atstring date-time required
countrystring

Нерезидент: страна регистрации кодом ISO 3166 (две буквы). Пусто — Россия.

tax_numberstring

Нерезидент: налоговый номер страны регистрации вместо ИНН.

system_keystring

Код системного контрагента (fns, sfr, bank:<БИК>). Только чтение.

requisites_issue'' | 'inn_missing' | 'inn_invalid' | 'kpp_invalid' | 'foreign_tax_missing' | 'country_invalid'

Что подсветить в реквизитах по правилу ИНН. Пусто — всё в порядке.

Changes

No recorded changes to this operation across all 1 revision of this API.