Добавление реквизитов [1.2]

Описание

Добавление реквизитов фирме.

Структура URL

HTTP метод: POST, ресурс: <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-список параметров для адреса см структуру Адрес 

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

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

Запрос

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

{
  "ati_id": 113626,
  "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,
  "is_active": true,
  "legal_address": {
        "ati_id": "113626",
        "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,
        "Attributes": 0,
        "send_type_id": 0,
        "Note": ""
      },
        "post_address": {
        "ati_id": "113626",
        "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,
        "Attributes": 0,
        "send_type_id": 0,
        "Note": null,
        "is_post_address": true
        },
  "okpo": null,
  "available_in_ati_docs": false,
  "is_vat_payer": false,
  "signees": [
    {
      "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Не авторизован