> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/api-docs-ua/zagalna-informaciya/kontragenti.md).

# Контрагенти

:link:[Початок роботи з API](https://api-portal.novapost.com/api-docs-ua)

### Створити контрагента

## Створити контрагента (JSON)

> Метод \*\*save\*\* моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*)\
> використовується для створення контрагента-отримувача. \
> \
> Особливості:\
> \- Дозволяє створювати контрагентів-отримувачів із типом «Приватна особа» (PrivatePerson).\
> \- Дані щодо отримувача вносяться лише українською мовою.\
> \- Рекомендовано проводити оновлення довідника один раз на місяць.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"saveCounterpartyJson","summary":"Створити контрагента (JSON)","description":"Метод **save** моделі **CounterpartyGeneral** (або **Counterparty**)\nвикористовується для створення контрагента-отримувача. \n\nОсобливості:\n- Дозволяє створювати контрагентів-отримувачів із типом «Приватна особа» (PrivatePerson).\n- Дані щодо отримувача вносяться лише українською мовою.\n- Рекомендовано проводити оновлення довідника один раз на місяць.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCounterpartyJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCounterpartyResponse"}}}}}}}},"components":{"schemas":{"SaveCounterpartyJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveCounterpartyMethodProperties"}}},"SaveCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["FirstName","MiddleName","LastName","Phone","CounterpartyType","CounterpartyProperty"],"properties":{"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"},"Email":{"type":"string","maxLength":36,"description":"Електронна скринька контактної особи"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента (наприклад, PrivatePerson)"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента (наприклад, Recipient)"}}},"SaveCounterpartyResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив даних створеного контрагента","items":{"$ref":"#/components/schemas/SaveCounterpartyItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"SaveCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис контрагента українською мовою"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"Counterparty":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор контрагента"},"OwnershipForm":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"ContactPerson":{"type":"array","description":"Вкладений об'єкт/масив контактної особи","items":{"$ref":"#/components/schemas/EmbeddedContactPersonResult"}}}},"EmbeddedContactPersonResult":{"type":"object","additionalProperties":false,"properties":{"success":{"type":"boolean","description":"Прапор успішності створення контактної особи"},"data":{"type":"array","description":"Дані створеної контактної особи","items":{"$ref":"#/components/schemas/EmbeddedContactPersonData"}},"errors":{"type":"array","items":{"type":"string"}},"translatedErrors":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"info":{"type":"array","items":{"type":"string"}},"messageCodes":{"type":"array","items":{"type":"string"}},"errorCodes":{"type":"array","items":{"type":"string"}},"warningCodes":{"type":"array","items":{"type":"string"}},"infoCodes":{"type":"array","items":{"type":"string"}}}},"EmbeddedContactPersonData":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","description":"Ідентифікатор контактної особи"},"Description":{"type":"string","description":"ПІБ контактної особи"},"LastName":{"type":"string","description":"Прізвище"},"FirstName":{"type":"string","description":"Ім'я"},"MiddleName":{"type":"string","description":"По батькові"}}}}}}
```

## Створити контрагента (XML)

> Метод \*\*save\*\* моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*)\
> дозволяє створити контрагента-отримувача у форматі XML.\
> \
> Особливості:\
> \- Дозволяє створювати контрагентів-отримувачів із типом «Приватна особа» (PrivatePerson).\
> \- Дані щодо отримувача вносяться лише українською мовою.\
> \- Рекомендовано проводити оновлення довідника один раз на місяць.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"saveCounterpartyXml","summary":"Створити контрагента (XML)","description":"Метод **save** моделі **CounterpartyGeneral** (або **Counterparty**)\nдозволяє створити контрагента-отримувача у форматі XML.\n\nОсобливості:\n- Дозволяє створювати контрагентів-отримувачів із типом «Приватна особа» (PrivatePerson).\n- Дані щодо отримувача вносяться лише українською мовою.\n- Рекомендовано проводити оновлення довідника один раз на місяць.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveCounterpartyXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveCounterpartyXmlResponse"}}}}}}}},"components":{"schemas":{"SaveCounterpartyXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveCounterpartyXmlMethodProperties"}}},"SaveCounterpartyXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/SaveCounterpartyMethodProperties"}],"xml":{"name":"methodProperties"}},"SaveCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["FirstName","MiddleName","LastName","Phone","CounterpartyType","CounterpartyProperty"],"properties":{"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"},"Email":{"type":"string","maxLength":36,"description":"Електронна скринька контактної особи"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента (наприклад, PrivatePerson)"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента (наприклад, Recipient)"}}},"SaveCounterpartyXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив даних створеного контрагента","xml":{"name":"data","wrapped":true},"items":{"$ref":"#/components/schemas/SaveCounterpartyXmlItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}}}},"SaveCounterpartyXmlItem":{"allOf":[{"$ref":"#/components/schemas/SaveCounterpartyItem"}],"xml":{"name":"item"}},"SaveCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис контрагента українською мовою"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"Counterparty":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор контрагента"},"OwnershipForm":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"ContactPerson":{"type":"array","description":"Вкладений об'єкт/масив контактної особи","items":{"$ref":"#/components/schemas/EmbeddedContactPersonResult"}}}},"EmbeddedContactPersonResult":{"type":"object","additionalProperties":false,"properties":{"success":{"type":"boolean","description":"Прапор успішності створення контактної особи"},"data":{"type":"array","description":"Дані створеної контактної особи","items":{"$ref":"#/components/schemas/EmbeddedContactPersonData"}},"errors":{"type":"array","items":{"type":"string"}},"translatedErrors":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{"type":"string"}},"info":{"type":"array","items":{"type":"string"}},"messageCodes":{"type":"array","items":{"type":"string"}},"errorCodes":{"type":"array","items":{"type":"string"}},"warningCodes":{"type":"array","items":{"type":"string"}},"infoCodes":{"type":"array","items":{"type":"string"}}}},"EmbeddedContactPersonData":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","description":"Ідентифікатор контактної особи"},"Description":{"type":"string","description":"ПІБ контактної особи"},"LastName":{"type":"string","description":"Прізвище"},"FirstName":{"type":"string","description":"Ім'я"},"MiddleName":{"type":"string","description":"По батькові"}}}}}}
```

## Створити контрагента «Третя особа» (JSON)

> Метод \*\*save\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для створення контрагента-отримувача.\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> Метод дозволяє створювати контрагентів-отримувачів із типом «Третя особа». Контрагента-отримувача з типом «Приватна особа» можуть створювати клієнти, які підписали угоду з компанією «Нова пошта».\
> \
> \- Дані щодо отримувача вносяться лише українською мовою.\
> \- Рекомендовано проводити оновлення довідника один раз на місяць.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"saveThirdPersonCounterpartyJson","summary":"Створити контрагента «Третя особа» (JSON)","description":"Метод **save** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для створення контрагента-отримувача.\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\nМетод дозволяє створювати контрагентів-отримувачів із типом «Третя особа». Контрагента-отримувача з типом «Приватна особа» можуть створювати клієнти, які підписали угоду з компанією «Нова пошта».\n\n- Дані щодо отримувача вносяться лише українською мовою.\n- Рекомендовано проводити оновлення довідника один раз на місяць.\n</details>\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveThirdPersonCounterpartyJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveThirdPersonCounterpartyJsonResponse"}}}}}}}},"components":{"schemas":{"SaveThirdPersonCounterpartyJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveThirdPersonCounterpartyMethodProperties"}}},"SaveThirdPersonCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyType","EDRPOU","CounterpartyProperty"],"properties":{"FirstName":{"type":"string","maxLength":36,"description":"Це поле має залишатися пустим, інакше повернеться помилка"},"MiddleName":{"type":"string","maxLength":36,"description":"Це поле має залишатися пустим, інакше повернеться помилка"},"LastName":{"type":"string","maxLength":36,"description":"Це поле має залишатися пустим, інакше повернеться помилка"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи (поле може бути порожнім для організацій)"},"Email":{"type":"string","maxLength":36,"description":"Електронна скринька контактної особи (поле може бути порожнім для організацій)"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ організації"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"},"CityRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) міста (може бути порожнім)"}}},"SaveThirdPersonCounterpartyJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив створених контрагентів","items":{"$ref":"#/components/schemas/ThirdPersonCounterpartyItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"ThirdPersonCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"FirstName":{"type":"string","maxLength":36,"description":"Поле повертається пустим"},"Ref":{"type":"string","maxLength":36,"description":"Унікальний ідентифікатор контрагента"},"Description":{"type":"string","maxLength":50,"description":"Назва організації, отримана за кодом ЄДРПОУ"},"OwnershipForm":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"LastName":{"type":"string","maxLength":36,"description":"Поле повертається пустим"},"MiddleName":{"type":"string","maxLength":36,"description":"Поле повертається пустим"}}}}}}
```

## Створити контрагента «Третя особа» (XML)

> Метод \*\*save\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для створення контрагента-отримувача.\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> Метод дозволяє створювати контрагентів-отримувачів із типом «Третя особа». Контрагента-отримувача з типом «Приватна особа» можуть створювати клієнти, які підписали угоду з компанією «Нова пошта».\
> \
> \- Дані щодо отримувача вносяться лише українською мовою.\
> \- Рекомендовано проводити оновлення довідника один раз на місяць.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"saveThirdPersonCounterpartyXml","summary":"Створити контрагента «Третя особа» (XML)","description":"Метод **save** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для створення контрагента-отримувача.\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\nМетод дозволяє створювати контрагентів-отримувачів із типом «Третя особа». Контрагента-отримувача з типом «Приватна особа» можуть створювати клієнти, які підписали угоду з компанією «Нова пошта».\n\n- Дані щодо отримувача вносяться лише українською мовою.\n- Рекомендовано проводити оновлення довідника один раз на місяць.\n</details>\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveThirdPersonCounterpartyXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveThirdPersonCounterpartyXmlResponse"}}}}}}}},"components":{"schemas":{"SaveThirdPersonCounterpartyXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveThirdPersonCounterpartyXmlMethodProperties"}}},"SaveThirdPersonCounterpartyXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/SaveThirdPersonCounterpartyMethodProperties"}],"xml":{"name":"methodProperties"}},"SaveThirdPersonCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyType","EDRPOU","CounterpartyProperty"],"properties":{"FirstName":{"type":"string","maxLength":36,"description":"Це поле має залишатися пустим, інакше повернеться помилка"},"MiddleName":{"type":"string","maxLength":36,"description":"Це поле має залишатися пустим, інакше повернеться помилка"},"LastName":{"type":"string","maxLength":36,"description":"Це поле має залишатися пустим, інакше повернеться помилка"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи (поле може бути порожнім для організацій)"},"Email":{"type":"string","maxLength":36,"description":"Електронна скринька контактної особи (поле може бути порожнім для організацій)"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ організації"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"},"CityRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) міста (може бути порожнім)"}}},"SaveThirdPersonCounterpartyXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/ThirdPersonCounterpartyItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"ThirdPersonCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"FirstName":{"type":"string","maxLength":36,"description":"Поле повертається пустим"},"Ref":{"type":"string","maxLength":36,"description":"Унікальний ідентифікатор контрагента"},"Description":{"type":"string","maxLength":50,"description":"Назва організації, отримана за кодом ЄДРПОУ"},"OwnershipForm":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"LastName":{"type":"string","maxLength":36,"description":"Поле повертається пустим"},"MiddleName":{"type":"string","maxLength":36,"description":"Поле повертається пустим"}}}}}}
```

## Створити контрагента «Організація» (JSON)

> Метод \*\*save\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для створення контрагента-отримувача.\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> Метод дозволяє створювати контрагентів-отримувачів із типом «Організація».\
> \
> \- Дані щодо отримувача вносяться лише українською мовою.\
> \- Рекомендовано проводити оновлення довідника один раз на місяць.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"saveOrganizationCounterpartyJson","summary":"Створити контрагента «Організація» (JSON)","description":"Метод **save** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для створення контрагента-отримувача.\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\nМетод дозволяє створювати контрагентів-отримувачів із типом «Організація».\n\n- Дані щодо отримувача вносяться лише українською мовою.\n- Рекомендовано проводити оновлення довідника один раз на місяць.\n</details>\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveOrganizationCounterpartyJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveOrganizationCounterpartyJsonResponse"}}}}}}}},"components":{"schemas":{"SaveOrganizationCounterpartyJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveOrganizationCounterpartyMethodProperties"}}},"SaveOrganizationCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyType","EDRPOU"],"properties":{"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"}}},"SaveOrganizationCounterpartyJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив створених контрагентів","items":{"$ref":"#/components/schemas/OrganizationCounterpartyItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"OrganizationCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис контрагента українською мовою"},"FirstName":{"type":"string","maxLength":36,"description":"Назва організації"},"OwnershipForm":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"}}}}}}
```

## Створити контрагента «Організація» (XML)

> Метод \*\*save\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для створення контрагента-отримувача.\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> Метод дозволяє створювати контрагентів-отримувачів із типом «Організація».\
> \
> \- Дані щодо отримувача вносяться лише українською мовою.\
> \- Рекомендовано проводити оновлення довідника один раз на місяць.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"saveOrganizationCounterpartyXml","summary":"Створити контрагента «Організація» (XML)","description":"Метод **save** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для створення контрагента-отримувача.\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\nМетод дозволяє створювати контрагентів-отримувачів із типом «Організація».\n\n- Дані щодо отримувача вносяться лише українською мовою.\n- Рекомендовано проводити оновлення довідника один раз на місяць.\n</details>\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveOrganizationCounterpartyXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveOrganizationCounterpartyXmlResponse"}}}}}}}},"components":{"schemas":{"SaveOrganizationCounterpartyXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveOrganizationCounterpartyXmlMethodProperties"}}},"SaveOrganizationCounterpartyXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/SaveOrganizationCounterpartyMethodProperties"}],"xml":{"name":"methodProperties"}},"SaveOrganizationCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyType","EDRPOU"],"properties":{"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"}}},"SaveOrganizationCounterpartyXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/OrganizationCounterpartyItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"OrganizationCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис контрагента українською мовою"},"FirstName":{"type":"string","maxLength":36,"description":"Назва організації"},"OwnershipForm":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"}}}}}}
```

### Робота з даними контрагента

## Оновити дані контрагента (JSON)

> Метод \*\*update\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для оновлення/внесення змін у дані контрагента-отримувача.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"updateCounterpartyJson","summary":"Оновити дані контрагента (JSON)","description":"Метод **update** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для оновлення/внесення змін у дані контрагента-отримувача.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCounterpartyJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCounterpartyJsonResponse"}}}}}}}},"components":{"schemas":{"UpdateCounterpartyJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["update"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/UpdateCounterpartyMethodProperties"}}},"UpdateCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref","CityRef","FirstName","MiddleName","LastName","CounterpartyType","CounterpartyProperty"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи контрагента"},"CityRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) міста контрагента"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"},"Email":{"type":"string","maxLength":36,"description":"Електронна скринька"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"}}},"UpdateCounterpartyJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив оновлених даних контрагента","items":{"$ref":"#/components/schemas/UpdatedCounterpartyItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"UpdatedCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор"},"Description":{"type":"string","maxLength":36,"description":"Опис українською мовою"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"Counterparty":{"type":"string","maxLength":36,"description":"Контрагент"},"OwnershipForm":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"ContactPerson":{"type":"string","maxLength":36,"description":"Контакт контрагента"}}}}}}
```

## Оновити дані контрагента (XML)

> Метод \*\*update\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для оновлення/внесення змін у дані контрагента-отримувача.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"updateCounterpartyXml","summary":"Оновити дані контрагента (XML)","description":"Метод **update** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для оновлення/внесення змін у дані контрагента-отримувача.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/UpdateCounterpartyXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/UpdateCounterpartyXmlResponse"}}}}}}}},"components":{"schemas":{"UpdateCounterpartyXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["update"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/UpdateCounterpartyXmlMethodProperties"}}},"UpdateCounterpartyXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/UpdateCounterpartyMethodProperties"}],"xml":{"name":"methodProperties"}},"UpdateCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref","CityRef","FirstName","MiddleName","LastName","CounterpartyType","CounterpartyProperty"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи контрагента"},"CityRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) міста контрагента"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"},"Email":{"type":"string","maxLength":36,"description":"Електронна скринька"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"}}},"UpdateCounterpartyXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/UpdatedCounterpartyItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"UpdatedCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор"},"Description":{"type":"string","maxLength":36,"description":"Опис українською мовою"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"Counterparty":{"type":"string","maxLength":36,"description":"Контрагент"},"OwnershipForm":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"},"ContactPerson":{"type":"string","maxLength":36,"description":"Контакт контрагента"}}}}}}
```

## Видалити контрагента-одержувача (JSON)

> Метод \*\*delete\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для видалення контрагента-отримувача. Для видалення контрагента-відправника необхідно звертатися до вашого менеджера.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"deleteCounterpartyJson","summary":"Видалити контрагента-одержувача (JSON)","description":"Метод **delete** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для видалення контрагента-отримувача. Для видалення контрагента-відправника необхідно звертатися до вашого менеджера.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCounterpartyJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCounterpartyJsonResponse"}}}}}}}},"components":{"schemas":{"DeleteCounterpartyJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["delete"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/DeleteCounterpartyMethodProperties"}}},"DeleteCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"}}},"DeleteCounterpartyJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив з ідентифікатором видаленого контрагента","items":{"$ref":"#/components/schemas/DeletedCounterpartyItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"DeletedCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) видаленого контрагента"}}}}}}
```

## Видалити контрагента-одержувача (XML)

> Метод \*\*delete\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і використовується для видалення контрагента-отримувача. Для видалення контрагента-відправника необхідно звертатися до вашого менеджера.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"deleteCounterpartyXml","summary":"Видалити контрагента-одержувача (XML)","description":"Метод **delete** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і використовується для видалення контрагента-отримувача. Для видалення контрагента-відправника необхідно звертатися до вашого менеджера.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/DeleteCounterpartyXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/DeleteCounterpartyXmlResponse"}}}}}}}},"components":{"schemas":{"DeleteCounterpartyXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["delete"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/DeleteCounterpartyXmlMethodProperties"}}},"DeleteCounterpartyXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/DeleteCounterpartyMethodProperties"}],"xml":{"name":"methodProperties"}},"DeleteCounterpartyMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"}}},"DeleteCounterpartyXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/DeletedCounterpartyItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"DeletedCounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) видаленого контрагента"}}}}}}
```

## Завантажити список адрес контрагентів (JSON)

> Метод \*\*getCounterpartyAddresses\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і завантажує список контрагентів (відправників/отримувачів).\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> \- Необхідно зберігати копію довідника на стороні клієнта та підтримувати його в актуальному стані.\
> \- Рекомендовано проводити оновлення довідників раз на місяць.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartyAddressesJson","summary":"Завантажити список адрес контрагентів (JSON)","description":"Метод **getCounterpartyAddresses** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і завантажує список контрагентів (відправників/отримувачів).\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\n- Необхідно зберігати копію довідника на стороні клієнта та підтримувати його в актуальному стані.\n- Рекомендовано проводити оновлення довідників раз на місяць.\n</details>\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartyAddressesJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartyAddressesJsonResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartyAddressesJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterpartyAddresses"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartyAddressesMethodProperties"}}},"GetCounterpartyAddressesMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref","CounterpartyProperty"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"}}},"GetCounterpartyAddressesJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив адрес контрагента","items":{"$ref":"#/components/schemas/CounterpartyAddressItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"CounterpartyAddressItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"Description":{"type":"string","maxLength":50,"description":"Опис адреси українською мовою"}}}}}}
```

## Завантажити список адрес контрагентів (XML)

> Метод \*\*getCounterpartyAddresses\*\* працює в моделі \*\*CounterpartyGeneral\*\* (або \*\*Counterparty\*\*) і завантажує список контрагентів (відправників/отримувачів).\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> \- Необхідно зберігати копію довідника на стороні клієнта та підтримувати його в актуальному стані.\
> \- Рекомендовано проводити оновлення довідників раз на місяць.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartyAddressesXml","summary":"Завантажити список адрес контрагентів (XML)","description":"Метод **getCounterpartyAddresses** працює в моделі **CounterpartyGeneral** (або **Counterparty**) і завантажує список контрагентів (відправників/отримувачів).\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\n- Необхідно зберігати копію довідника на стороні клієнта та підтримувати його в актуальному стані.\n- Рекомендовано проводити оновлення довідників раз на місяць.\n</details>\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartyAddressesXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartyAddressesXmlResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartyAddressesXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterpartyAddresses"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartyAddressesXmlMethodProperties"}}},"GetCounterpartyAddressesXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/GetCounterpartyAddressesMethodProperties"}],"xml":{"name":"methodProperties"}},"GetCounterpartyAddressesMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref","CounterpartyProperty"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"CounterpartyProperty":{"type":"string","maxLength":36,"description":"Властивості контрагента"}}},"GetCounterpartyAddressesXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/CounterpartyAddressItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"CounterpartyAddressItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"Description":{"type":"string","maxLength":50,"description":"Опис адреси українською мовою"}}}}}}
```

## Завантажити параметри контрагента (JSON)

> Метод \*\*getCounterpartyOptions\*\* працює в моделі \*\*Counterparty\*\* (або \*\*CounterpartyGeneral\*\*) і використовується для отримання параметрів контрагента-відправника для замовлення додаткових послуг (див.  «Формування запиту на створення експрес-накладної із додатковими послугами», метод \*\*save\*\* моделі \*\*InternetDocument\*\*). Замовити послуги можна через особистого менеджера.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartyOptionsJson","summary":"Завантажити параметри контрагента (JSON)","description":"Метод **getCounterpartyOptions** працює в моделі **Counterparty** (або **CounterpartyGeneral**) і використовується для отримання параметрів контрагента-відправника для замовлення додаткових послуг (див.  «Формування запиту на створення експрес-накладної із додатковими послугами», метод **save** моделі **InternetDocument**). Замовити послуги можна через особистого менеджера.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartyOptionsJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartyOptionsJsonResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartyOptionsJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterpartyOptions"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartyOptionsMethodProperties"}}},"GetCounterpartyOptionsMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"}}},"GetCounterpartyOptionsJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив з параметрами контрагента","items":{"$ref":"#/components/schemas/CounterpartyOptionsItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"CounterpartyOptionsItem":{"type":"object","additionalProperties":false,"properties":{"AddressDocumentDelivery":{"type":"boolean","description":"Адресна доставка документів"},"AfterpaymentType":{"type":"boolean","description":"Тип для послуги «Контроль оплати»"},"BackwardDeliverySubtypesDocuments":{"type":"boolean","description":"Зворотна доставка документів"},"BlockInternationalSenderLKK":{"type":"boolean","description":"Міжнародна доставка"},"CalculationByFactualWeight":{"type":"boolean","description":"Розрахунок за фактичною вагою"},"CanAfterpaymentOnGoodsCost":{"type":"boolean","description":"Сплата коштів за товар (Контроль оплати)"},"CanCreditDocuments":{"type":"boolean","description":"Оформлення кредиту"},"CanEWTransporter":{"type":"boolean","description":"Наявність перевізника"},"CanForwardingService":{"type":"boolean","description":"Експедирування (Контроль поштучної передачі)"},"CanNonCashPayment":{"type":"boolean","description":"Безготівковий розрахунок"},"CanPayTheThirdPerson":{"type":"boolean","description":"Оплата третьою особою"},"CanSameDayDelivery":{"type":"boolean","description":"Доставка день в день"},"CanSameDayDeliveryStandart":{"type":"boolean","description":"Доставка день в день (локал-стандарт)"},"CanSentFromPostomat":{"type":"boolean","description":"Відправка з поштомата"},"CanSignedDocuments":{"type":"boolean","description":"Доступна послуга «Підписання документів»"},"CarCall":{"type":"boolean","description":"Послуга «Виклик авто»"},"CreditDocuments":{"type":"boolean","description":"Зворотна доставка кредитних документів"},"CustomerReturn":{"type":"boolean","description":"Послуга «Автоповернення відправлень»"},"DayCustomerReturn":{"type":"boolean","description":"День автоповернення"},"DebtorParams":{"type":"array","description":"Дані заборгованості","xml":{"name":"DebtorParams","wrapped":false},"items":{"$ref":"#/components/schemas/DebtorParamItem","xml":{"name":"item"}}},"DeliveryByHand":{"type":"boolean","description":"Доставка в руки"},"DescentFromFloor":{"type":"boolean","description":"Спуск з поверху"},"FillingWarranty":{"type":"boolean","description":"Заповнення гарантійного талону"},"HaveMoneyWallets":{"type":"boolean","description":"Електронний гаманець"},"HideDeliveryCost":{"type":"boolean","description":"Приховати вартість доставки"},"InternationalDelivery":{"type":"boolean","description":"Міжнародна доставка"},"InternationalDeliveryServiceType":{"type":"boolean","description":"Тип міжнародної доставки"},"LoyaltyProgram":{"type":"boolean","description":"Програма лояльності"},"MainCounterparty":{"type":"boolean","description":"Головний контрагент"},"PickupService":{"type":"boolean","description":"Можливість замовлення послуги Pick Up"},"PrintMarkingAllowedTypes":{"type":"object","description":"Тип доступного маркування","additionalProperties":true},"SecurePayment":{"type":"boolean","description":"Надійна покупка"},"Services":{"type":"boolean","description":"Послуги"},"ShowDeliveryByHand":{"type":"boolean","description":"Доставка особисто в руки"},"SignedDocuments":{"type":"boolean","description":"Зворотна доставка підписаних документів"},"TransferPricingConditions":{"type":"boolean","description":"Умови трансфертного ціноутворення"}}},"DebtorParamItem":{"type":"object","additionalProperties":false,"properties":{"AgreementId":{"type":"string","description":"Номер договору"},"PaymTermId":{"type":"string","description":"Термін оплати"},"PastDueDebts":{"type":"string","description":"Прострочена заборгованість"},"BlockedStatus":{"type":"string","description":"Статус блокування"}}}}}}
```

## Завантажити параметри контрагента (XML)

> Метод \*\*getCounterpartyOptions\*\* працює в моделі \*\*Counterparty\*\* (або \*\*СounterpartyGeneral\*\*) і використовується для отримання параметрів контрагента-відправника для замовлення додаткових послуг (див.  «Формування запиту на створення експрес-накладної із додатковими послугами», метод \*\*save\*\* моделі \*\*InternetDocument\*\*). Замовити послуги можна через особистого менеджера.<br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartyOptionsXml","summary":"Завантажити параметри контрагента (XML)","description":"Метод **getCounterpartyOptions** працює в моделі **Counterparty** (або **СounterpartyGeneral**) і використовується для отримання параметрів контрагента-відправника для замовлення додаткових послуг (див.  «Формування запиту на створення експрес-накладної із додатковими послугами», метод **save** моделі **InternetDocument**). Замовити послуги можна через особистого менеджера.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartyOptionsXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartyOptionsXmlResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartyOptionsXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterpartyOptions"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartyOptionsXmlMethodProperties"}}},"GetCounterpartyOptionsXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/GetCounterpartyOptionsMethodProperties"}],"xml":{"name":"methodProperties"}},"GetCounterpartyOptionsMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"}}},"GetCounterpartyOptionsXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/CounterpartyOptionsItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"CounterpartyOptionsItem":{"type":"object","additionalProperties":false,"properties":{"AddressDocumentDelivery":{"type":"boolean","description":"Адресна доставка документів"},"AfterpaymentType":{"type":"boolean","description":"Тип для послуги «Контроль оплати»"},"BackwardDeliverySubtypesDocuments":{"type":"boolean","description":"Зворотна доставка документів"},"BlockInternationalSenderLKK":{"type":"boolean","description":"Міжнародна доставка"},"CalculationByFactualWeight":{"type":"boolean","description":"Розрахунок за фактичною вагою"},"CanAfterpaymentOnGoodsCost":{"type":"boolean","description":"Сплата коштів за товар (Контроль оплати)"},"CanCreditDocuments":{"type":"boolean","description":"Оформлення кредиту"},"CanEWTransporter":{"type":"boolean","description":"Наявність перевізника"},"CanForwardingService":{"type":"boolean","description":"Експедирування (Контроль поштучної передачі)"},"CanNonCashPayment":{"type":"boolean","description":"Безготівковий розрахунок"},"CanPayTheThirdPerson":{"type":"boolean","description":"Оплата третьою особою"},"CanSameDayDelivery":{"type":"boolean","description":"Доставка день в день"},"CanSameDayDeliveryStandart":{"type":"boolean","description":"Доставка день в день (локал-стандарт)"},"CanSentFromPostomat":{"type":"boolean","description":"Відправка з поштомата"},"CanSignedDocuments":{"type":"boolean","description":"Доступна послуга «Підписання документів»"},"CarCall":{"type":"boolean","description":"Послуга «Виклик авто»"},"CreditDocuments":{"type":"boolean","description":"Зворотна доставка кредитних документів"},"CustomerReturn":{"type":"boolean","description":"Послуга «Автоповернення відправлень»"},"DayCustomerReturn":{"type":"boolean","description":"День автоповернення"},"DebtorParams":{"type":"array","description":"Дані заборгованості","xml":{"name":"DebtorParams","wrapped":false},"items":{"$ref":"#/components/schemas/DebtorParamItem","xml":{"name":"item"}}},"DeliveryByHand":{"type":"boolean","description":"Доставка в руки"},"DescentFromFloor":{"type":"boolean","description":"Спуск з поверху"},"FillingWarranty":{"type":"boolean","description":"Заповнення гарантійного талону"},"HaveMoneyWallets":{"type":"boolean","description":"Електронний гаманець"},"HideDeliveryCost":{"type":"boolean","description":"Приховати вартість доставки"},"InternationalDelivery":{"type":"boolean","description":"Міжнародна доставка"},"InternationalDeliveryServiceType":{"type":"boolean","description":"Тип міжнародної доставки"},"LoyaltyProgram":{"type":"boolean","description":"Програма лояльності"},"MainCounterparty":{"type":"boolean","description":"Головний контрагент"},"PickupService":{"type":"boolean","description":"Можливість замовлення послуги Pick Up"},"PrintMarkingAllowedTypes":{"type":"object","description":"Тип доступного маркування","additionalProperties":true},"SecurePayment":{"type":"boolean","description":"Надійна покупка"},"Services":{"type":"boolean","description":"Послуги"},"ShowDeliveryByHand":{"type":"boolean","description":"Доставка особисто в руки"},"SignedDocuments":{"type":"boolean","description":"Зворотна доставка підписаних документів"},"TransferPricingConditions":{"type":"boolean","description":"Умови трансфертного ціноутворення"}}},"DebtorParamItem":{"type":"object","additionalProperties":false,"properties":{"AgreementId":{"type":"string","description":"Номер договору"},"PaymTermId":{"type":"string","description":"Термін оплати"},"PastDueDebts":{"type":"string","description":"Прострочена заборгованість"},"BlockedStatus":{"type":"string","description":"Статус блокування"}}}}}}
```

## Завантажити список контактних осіб контрагента (JSON)

> Метод \*\*getCounterpartyContactPersons\*\* працює в моделі \*\*Counterparty\*\* (або \*\*СounterpartyGeneral\*\*) і завантажує список контактних осіб контрагентів.\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> \- Якщо кількість контактних осіб перевищує 100, необхідно використовувати параметр \`Page\`.\
> \- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\
> \- Рекомендовано проводити оновлення довідників один раз на день.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartyContactPersonsJson","summary":"Завантажити список контактних осіб контрагента (JSON)","description":"Метод **getCounterpartyContactPersons** працює в моделі **Counterparty** (або **СounterpartyGeneral**) і завантажує список контактних осіб контрагентів.\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\n- Якщо кількість контактних осіб перевищує 100, необхідно використовувати параметр `Page`.\n- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\n- Рекомендовано проводити оновлення довідників один раз на день.\n</details>\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartyContactPersonsJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartyContactPersonsJsonResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartyContactPersonsJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterpartyContactPersons"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartyContactPersonsMethodProperties"}}},"GetCounterpartyContactPersonsMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"Page":{"type":"string","maxLength":36,"description":"Сторінка з інформацією для відображення (не більше 100 записів на одній сторінці)"}}},"GetCounterpartyContactPersonsJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив контактних осіб контрагента","items":{"$ref":"#/components/schemas/CounterpartyContactPersonItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"CounterpartyContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Description":{"type":"string","maxLength":50,"description":"Контактна особа"},"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Phones":{"type":"string","maxLength":36,"description":"Телефон контактної особи"},"Email":{"type":"string","maxLength":36,"description":"Електронна адреса"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"}}}}}}
```

## Завантажити список контактних осіб контрагента (XML)

> Метод \*\*getCounterpartyContactPersons\*\* працює в моделі \*\*Counterparty\*\* (або \*\*CounterpartyGeneral\*\*) і завантажує список контактних осіб контрагентів.\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> \- Якщо кількість контактних осіб перевищує 100, необхідно використовувати параметр \`Page\`.\
> \- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\
> \- Рекомендовано проводити оновлення довідників один раз на день.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartyContactPersonsXml","summary":"Завантажити список контактних осіб контрагента (XML)","description":"Метод **getCounterpartyContactPersons** працює в моделі **Counterparty** (або **CounterpartyGeneral**) і завантажує список контактних осіб контрагентів.\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\n- Якщо кількість контактних осіб перевищує 100, необхідно використовувати параметр `Page`.\n- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\n- Рекомендовано проводити оновлення довідників один раз на день.\n</details>\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartyContactPersonsXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartyContactPersonsXmlResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartyContactPersonsXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterpartyContactPersons"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartyContactPersonsXmlMethodProperties"}}},"GetCounterpartyContactPersonsXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/GetCounterpartyContactPersonsMethodProperties"}],"xml":{"name":"methodProperties"}},"GetCounterpartyContactPersonsMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"Page":{"type":"string","maxLength":36,"description":"Сторінка з інформацією для відображення (не більше 100 записів на одній сторінці)"}}},"GetCounterpartyContactPersonsXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/CounterpartyContactPersonItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"CounterpartyContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Description":{"type":"string","maxLength":50,"description":"Контактна особа"},"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Phones":{"type":"string","maxLength":36,"description":"Телефон контактної особи"},"Email":{"type":"string","maxLength":36,"description":"Електронна адреса"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"}}}}}}
```

## Завантажити список контрагентів (JSON)

> Метод \*\*getCounterparties\*\* працює в моделі \*\*Counterparty\*\* (або \*\*CounterpartyGeneral\*\*) і завантажує список контрагентів (відправників, отримувачів та третіх осіб).\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> \- Якщо кількість контрагентів перевищує 100, необхідно використовувати параметр \`Page\`.\
> \- Якщо до запиту додати параметр \`FindByString\` (пошук за рядком) і в його значенні вказати назву контрагента, якого потрібно знайти (наприклад, «Талісман»), буде виконано пошук у довіднику та повернено відповідного контрагента.\
> \- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\
> \- Рекомендовано проводити оновлення довідників раз на день.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartiesJson","summary":"Завантажити список контрагентів (JSON)","description":"Метод **getCounterparties** працює в моделі **Counterparty** (або **CounterpartyGeneral**) і завантажує список контрагентів (відправників, отримувачів та третіх осіб).\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\n- Якщо кількість контрагентів перевищує 100, необхідно використовувати параметр `Page`.\n- Якщо до запиту додати параметр `FindByString` (пошук за рядком) і в його значенні вказати назву контрагента, якого потрібно знайти (наприклад, «Талісман»), буде виконано пошук у довіднику та повернено відповідного контрагента.\n- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\n- Рекомендовано проводити оновлення довідників раз на день.\n</details>\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartiesJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCounterpartiesJsonResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartiesJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterparties"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartiesMethodProperties"}}},"GetCounterpartiesMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyProperty"],"properties":{"CounterpartyProperty":{"type":"string","maxLength":36,"enum":["Sender","Recipient","ThirdPerson"],"description":"Вид контрагента (Sender/Recipient/ThirdPerson)"},"Page":{"type":"string","maxLength":36,"description":"Сторінка з інформацією для відображення (не більше 100 записів на одній сторінці)"},"FindByString":{"type":"string","description":"Пошук контрагента за назвою"}}},"GetCounterpartiesJsonResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив контрагентів","items":{"$ref":"#/components/schemas/CounterpartyItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"CounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Description":{"type":"string","maxLength":50,"description":"Опис українською мовою"},"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор"},"City":{"type":"string","maxLength":36,"description":"Місто контрагента"},"Counterparty":{"type":"string","maxLength":36,"description":"Контрагент"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"OwnershipFormRef":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"}}}}}}
```

## Завантажити список контрагентів (XML)

> Метод \*\*getCounterparties\*\* працює в моделі \*\*Counterparty\*\* (або \*\*CounterpartyGeneral\*\*) і завантажує список контрагентів (відправників, отримувачів та третіх осіб).\
> \
> \<details>\
> \<summary>Додаткові особливості та правила\</summary>\
> \
> \- Якщо кількість контрагентів перевищує 100, необхідно використовувати параметр \`Page\`.\
> \- Якщо до запиту додати параметр \`FindByString\` (пошук за рядком) і в його значенні вказати назву контрагента, якого потрібно знайти (наприклад, «Талісман»), буде виконано пошук у довіднику та повернено відповідного контрагента.\
> \- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\
> \- Рекомендовано проводити оновлення довідників раз на день.\
> \</details><br>

```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Counterparty","version":"2.0.0"},"tags":[{"name":"Counterparty","description":"Операції, пов'язані з контрагентами"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Counterparty"],"operationId":"getCounterpartiesXml","summary":"Завантажити список контрагентів (XML)","description":"Метод **getCounterparties** працює в моделі **Counterparty** (або **CounterpartyGeneral**) і завантажує список контрагентів (відправників, отримувачів та третіх осіб).\n\n<details>\n<summary>Додаткові особливості та правила</summary>\n\n- Якщо кількість контрагентів перевищує 100, необхідно використовувати параметр `Page`.\n- Якщо до запиту додати параметр `FindByString` (пошук за рядком) і в його значенні вказати назву контрагента, якого потрібно знайти (наприклад, «Талісман»), буде виконано пошук у довіднику та повернено відповідного контрагента.\n- Копію довідника необхідно зберігати на стороні клієнта та підтримувати його в актуальному стані.\n- Рекомендовано проводити оновлення довідників раз на день.\n</details>\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartiesXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetCounterpartiesXmlResponse"}}}}}}}},"components":{"schemas":{"GetCounterpartiesXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["CounterpartyGeneral","Counterparty"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["getCounterparties"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetCounterpartiesXmlMethodProperties"}}},"GetCounterpartiesXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/GetCounterpartiesMethodProperties"}],"xml":{"name":"methodProperties"}},"GetCounterpartiesMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyProperty"],"properties":{"CounterpartyProperty":{"type":"string","maxLength":36,"enum":["Sender","Recipient","ThirdPerson"],"description":"Вид контрагента (Sender/Recipient/ThirdPerson)"},"Page":{"type":"string","maxLength":36,"description":"Сторінка з інформацією для відображення (не більше 100 записів на одній сторінці)"},"FindByString":{"type":"string","description":"Пошук контрагента за назвою"}}},"GetCounterpartiesXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"$ref":"#/components/schemas/CounterpartyItem","xml":{"name":"data"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors"},"items":{"type":"string","xml":{"name":"errors"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings"},"items":{"type":"string","xml":{"name":"warnings"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info"},"items":{"type":"string","xml":{"name":"info"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes"},"items":{"type":"string","xml":{"name":"messageCodes"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes"},"items":{"type":"string","xml":{"name":"errorCodes"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes"},"items":{"type":"string","xml":{"name":"warningCodes"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes"},"items":{"type":"string","xml":{"name":"infoCodes"}}}}},"CounterpartyItem":{"type":"object","additionalProperties":false,"properties":{"Description":{"type":"string","maxLength":50,"description":"Опис українською мовою"},"Ref":{"type":"string","maxLength":36,"description":"Ідентифікатор"},"City":{"type":"string","maxLength":36,"description":"Місто контрагента"},"Counterparty":{"type":"string","maxLength":36,"description":"Контрагент"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"OwnershipFormRef":{"type":"string","maxLength":36,"description":"Ідентифікатор форми власності"},"OwnershipFormDescription":{"type":"string","maxLength":36,"description":"Опис форми власності"},"EDRPOU":{"type":"string","maxLength":36,"description":"Код ЄДРПОУ"},"CounterpartyType":{"type":"string","maxLength":36,"description":"Тип контрагента"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://api-portal.novapost.com/api-docs-ua/zagalna-informaciya/kontragenti.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.