API Контрагенты

Работа с данными Контрагента

Создать Контрагента с типом третьего лица

Метод «save», работает в модели «Counterparty», этот метод используется при создании контрагента с типом третьего лица.
Функция доступна для клиентов, заключивших договор с компанией «Новая Почта».
Рекомендуется проводить обновление справочников раз в месяц.

URL для входа https://api.novaposhta.ua/v2.0/{format}/ [json or xml]
Формат, обязательно, должен указываться нижним регистром (маленькими буквами), например https://api.novaposhta.ua/v2.0/json/


Доступность: Требует использования API-ключа.

Try it

URL-адрес запроса

Параметры запроса

string

Форматы JSON, XML

Заголовки запросов

(дополнительный)
string
Тип формата текста, отправляемого в API.

Текст запроса

Параметр Тип данных Описание
apiKey* string[36] Ваш ключ API 2.0
modelName* string Имя модели
calledMethod* string Имя вызываемого метода
methodProperties string Свойства метода
CityRef * string[36] Идентификатор города
FirstName* string[36] Название организации
MiddleName string[36] Отчество
LastName string[36] Фамилия Контактного лица
Phone string[36] Телефон Контактного лица
Email string[36] Имейл
CounterpartyType * string[36] Тип контрагента
CounterpartyProperty* string[36] Свойства контрагента
* Обозначение обязательного параметра

{
"apiKey": "[ВАШ КЛЮЧ]",
"modelName": "Counterparty",
"calledMethod": "save",
"methodProperties": {
"CityRef": "8d5a980d-391c-11dd-90d9-001a92567626",
"FirstName": "",
"MiddleName": "",
"LastName": "",
"Phone": "",
"Email": "",
"CounterpartyType": "Organization",
"CounterpartyProperty": "ThirdPerson",
"EDRPOU": "99999999",
"OwnershipForm": ""
}
}
<?xml version="1.0" encoding="UTF-8"?>
<file>
<apiKey>[ВАШ КЛЮЧ]</apiKey>
<calledMethod>save</calledMethod>
<methodProperties>
<CityRef>8d5a980d-391c-11dd-90d9-001a92567626</CityRef>
<CounterpartyProperty>ThirdPerson</CounterpartyProperty>
<CounterpartyType>Organization</CounterpartyType>
<EDRPOU>99999999</EDRPOU>
<Email />
<FirstName />
<LastName />
<MiddleName />
<OwnershipForm />
<Phone />
</methodProperties>
<modelName>Counterparty</modelName>
</file>

Ответ 200

Всегда возвращает код 200 даже при логических ошибках.


Тело ответа на запрос

Параметр Тип данных Описание
Ref string[36] Идентификатор
Description string[36] Описание
OwnershipForm string[36] Идентификатор формы собственности
OwnershipFormDescription string[36] Описание формы собственности
EDRPOU string[36] Код ЕДРПОУ
CounterpartyType string[36] Тип контрагента (организация)

{
"success": true,
"data": [
{
"Ref": "5c67c2b2-cbf2-11e4-bdb5-005056801329",
"Description": "Баклажан ТОВ (Тестовий ЛК)",
"FirstName": "",
"MiddleName": "",
"LastName": "",
"Counterparty": "",
"OwnershipForm": "7f0f351d-2519-11df-be9a-000c291af1b3",
"OwnershipFormDescription": "ТОВ",
"EDRPOU": "99999999",
"CounterpartyType": "Organization",
"ContactPerson": []
}
],
"errors": [],
"warnings": [],
"info": []
}
<?xml version="1.0" encoding="UTF-8"?>
<root>
<success>true</success>
<data>
<item>
<Ref>89c1fc68-d83d-11e4-bdb5-005056801329</Ref>
<Description>Баклажан ТОВ (Тестовий ЛК)</Description>
<FirstName></FirstName>
<MiddleName></MiddleName>
<LastName></LastName>
<Counterparty></Counterparty>
<OwnershipForm>7f0f351d-2519-11df-be9a-000c291af1b3</OwnershipForm>
<OwnershipFormDescription>ТОВ</OwnershipFormDescription>
<EDRPOU>99999999</EDRPOU>
<CounterpartyType>Organization</CounterpartyType>
<ContactPerson></ContactPerson>
</item>
</data>
<errors></errors>
<warnings></warnings>
<info></info>
</root>