Редактирование реквизитов [1.2]

Описание

Редактирование реквизитов фирмы.

Структура URL

HTTP метод: PUT, ресурс: <base_url>/v1.2/firms/requisites

Результат

Структура Реквизиты фирмы, описывающая отредактированные реквизиты.

Список параметров

Реквизиты российские для юридических лиц

НазваниеСпособ передачиОбязательныйВалидация
ati_idBody+ati_id!=0
requisite_type_idBody+requisite_type_id = 1 (юр.лица)
requisite_nameBody+от 1 до 150 символов
legal_nameBody+от 1 до 90 символов
own_ship_idBody+значение из словаря
innBody+10 цифр
ogrnBody+13 цифр
phoneBody- до 20 цифр, разрешено +()
faxBody- до 20 цифр, разрешено +()
kppBody+9 цифр
rsBody+20 цифр
ksBody+

 20 цифр

Начинается с 301, заканчивается на 3 последних цифры БИК

bikBody+9 цифр
bankBody+до 100 символов
okpoBody-8 или 10 цифр
is_read_onlyBody+true|false
is_activeBody+true|false
available_in_ati_docsBody+true|false
is_vat_payerBody+true|false
signeesBody+список параметров для подписанта см структуру Подписант
legal_addressBody+список параметров для адреса см структуру Адрес
post_addressBody-список параметров для адреса см структуру Адрес 

 

Реквизиты российские для индивидуальных предпринимателей

НазваниеСпособ передачиОбязательныйВалидация
ati_idBody+ati_id!=0
requisite_type_idBody+requisite_type_id = 6 (ИП)
requisite_nameBody+от 1 до 150 символов
legal_nameBody+от 1 до 90 символов
own_ship_idBody+значение из словаря
innBody+12 цифр
ogrnBody+15 цифр
phoneBody-до 20 цифр, разрешено +()
faxBody-до 20 цифр, разрешено +()
rsBody+20 цифр
ksBody+

 20 цифр

Начинается с 301, заканчивается на 3 последних цифры БИК

bikBody+9 цифр
bankBody+до 100 символов
okpoBody-8 или 10 цифр
is_read_onlyBody+true|false
is_activeBody+true|false
available_in_ati_docsBody+true|false
is_vat_payerBody+true|false
signeesBody+список параметров для подписанта см структуру Подписант
legal_addressBody+список параметров для адреса см структуру Адрес
post_addressBody-список параметров для адреса см структуру Адрес 

Более подробное описание параметров см на странице структуры Реквизиты фирмы

Пример запроса и ответа

Запрос

PUT http://api.ati.su/v1.2/firms/requisites

{
    "requisite_id": "143a31cd-bf88-e711-80be-0030487d29e5",
    "ati_id": "1300276",
    "requisite_type_id": 1,
    "requisite_name": "requisiteName",
    "legal_name": "legalName",
    "own_ship_id": 1,
    "fio": null,
    "inn": "5645654456",
    "ogrn": "2342243336242",
    "phone": "65())43+64-6665",
    "fax": null,
    "email": null,
    "kpp": "633544654",
    "rs": "12131212321212121212",
    "ks": "30112123211111111111",
    "bik": "122555111",
    "bank": "bank",
    "codes": null,
    "is_read_only": false,
    "okpo": null,
    "available_in_ati_docs": false,
    "is_vat_payer": false,
    "is_active": true,
    "legal_address": {
        "address_id": "123a31cd-bf88-e711-80be-0030487d29e5",
        "ati_id": "1300276",
        "country_id": null,
        "region_id": null,
        "city_id": null,
        "city_name": "CityName",
        "post_index": "121212",
        "street_type_id": 4,
        "street_name": "StreetName",
        "house_no": "д. 6",
        "part_no": null,
        "litera": null,
        "office_no": null,
        "post_contact": null,
        "add_date": "2017-08-24T11:32:18.92",
        "attributes": 0,
        "send_type_id": 0,
        "note": "",
        "formatted_text": "121212 CityName StreetName д. 6    ",
        "is_post_address": false
    },
    "post_address": {
        "address_id": "133a31cd-bf88-e711-80be-0030487d29e5",
        "ati_id": "1300276",
        "country_id": null,
        "region_id": null,
        "city_id": null,
        "city_name": "CityName",
        "post_index": "121212",
        "street_type_id": 4,
        "street_name": null,
        "house_no": null,
        "part_no": null,
        "litera": null,
        "office_no": null,
        "post_contact": null,
        "add_date": "2017-08-24T11:32:18.92",
        "attributes": 0,
        "send_type_id": 0,
        "note": null,
        "formatted_text": "121212 CityName      ",
        "is_post_address": false
    },
    "legal_address_id": "123a31cd-bf88-e711-80be-0030487d29e5",
    "post_address_id": "133a31cd-bf88-e711-80be-0030487d29e5",
    "signees": [
        {
            "signee_id": "153a31cd-bf88-e711-80be-0030487d29e5",
            "requisite_id": "143a31cd-bf88-e711-80be-0030487d29e5",
            "full_name": "fullName",
            "position": "position",
            "act_upon": "actUpon",
            "is_default": true,
            "deletion_date": null
        }
    ]
}

Ответ

{
    "requisite_id": "143a31cd-bf88-e711-80be-0030487d29e5",
    "ati_id": "1300276",
    "requisite_type_id": 1,
    "requisite_name": "requisiteName",
    "legal_name": "legalName",
    "own_ship_id": 1,
    "fio": null,
    "inn": "5645654456",
    "ogrn": "2342243336242",
    "phone": "65())43+64-6665",
    "fax": null,
    "email": null,
    "kpp": "633544654",
    "rs": "12131212321212121212",
    "ks": "30112123211111111111",
    "bik": "122555111",
    "bank": "bank",
    "codes": null,
    "is_read_only": false,
    "okpo": null,
    "available_in_ati_docs": false,
    "is_vat_payer": false,
    "is_active": true,
    "legal_address": {
        "address_id": "123a31cd-bf88-e711-80be-0030487d29e5",
        "ati_id": "1300276",
        "country_id": null,
        "region_id": null,
        "city_id": null,
        "city_name": "CityName",
        "post_index": "121212",
        "street_type_id": 4,
        "street_name": "StreetName",
        "house_no": "д. 6",
        "part_no": null,
        "litera": null,
        "office_no": null,
        "post_contact": null,
        "add_date": "2017-08-24T11:32:18.92",
        "attributes": 0,
        "send_type_id": 0,
        "note": "",
        "formatted_text": "121212 CityName StreetName д. 6    ",
        "is_post_address": false
    },
    "post_address": {
        "address_id": "133a31cd-bf88-e711-80be-0030487d29e5",
        "ati_id": "1300276",
        "country_id": null,
        "region_id": null,
        "city_id": null,
        "city_name": "CityName",
        "post_index": "121212",
        "street_type_id": 4,
        "street_name": null,
        "house_no": null,
        "part_no": null,
        "litera": null,
        "office_no": null,
        "post_contact": null,
        "add_date": "2017-08-24T11:32:18.92",
        "attributes": 0,
        "send_type_id": 0,
        "note": null,
        "formatted_text": "121212 CityName      ",
        "is_post_address": false
    },
    "legal_address_id": "123a31cd-bf88-e711-80be-0030487d29e5",
    "post_address_id": "133a31cd-bf88-e711-80be-0030487d29e5",
    "signees": [
        {
            "signee_id": "153a31cd-bf88-e711-80be-0030487d29e5",
            "requisite_id": "143a31cd-bf88-e711-80be-0030487d29e5",
            "full_name": "fullName",
            "position": "position",
            "act_upon": "actUpon",
            "is_default": true,
            "deletion_date": null
        }
    ]
}

Список ответов сервера

Код ответаОписание
200 реквизит добавлен (+ возвращаются добавленные реквизиты)
400Данные, переданные пользователем, некорректны
403Доступ запрещен
401Не авторизован