Edit
[POST] .../v1/firm/edit
Edits enterprise. Use this method to update company reference data and requisites while preserving existing document history. It requires a positive id and updates only fields supplied in the request; if no editable field is supplied, the API returns a business error. The caller must have firm edit permission; missing body, invalid id, invalid string lengths, denied access, missing records and storage errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| address | String | Optional | Firm address. Maximum length is 150 characters. |
| bank_name | String | Optional | Bank name. Maximum length is 100 characters. |
| boss_name | String | Optional | Firm manager name. Maximum length is 150 characters. |
| description | String | Optional | Firm description or note. Maximum length is 500 characters. |
| fullname | String | Optional | Full legal firm name. Maximum length is 250 characters. |
| group_id | Int64 | Optional | Firm group ID in the system. |
| id | Int64 | Required | Firm ID. |
| inn | String | Optional | Firm TIN. Maximum length is 50 characters. |
| mfo | String | Optional | Bank MFO code. Maximum length is 50 characters. |
| name | String | Optional | Firm name. Maximum length is 150 characters. |
| oked | String | Optional | OKED code. Maximum length is 50 characters. |
| phones | String | Optional | Firm phone numbers. Maximum length is 150 characters. |
| rs | String | Optional | Bank account number. Maximum length is 50 characters. |
| vat_index | String | Optional | VAT payer registration code. Maximum length is 25 characters. |
Request Example
{
"id": 2,
"group_id": 1,
"name": "REGOS Retail Main",
"address": "Tashkent, Buyuk Ipak Yuli 12",
"phones": "\u002B998901234568"
}
Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1
}
}