> 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/kontaktni-personi.md). # Контактні персони :link:[*Початок роботи з API*](https://api-portal.novapost.com/api-docs-ua) ## Створити контактну особу контрагента (JSON) > Метод \*\*save\*\* моделі \*\*ContactPersonGeneral\*\* (або \*\*ContactPerson\*\*)\ > дозволяє створити контактну особу контрагента.\ > \ > Зверніть увагу:\ > \- Редагувати дані контактної особи можуть тільки юридичні особи.\ > \- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\ > \- Редагування даних контрагента можливе лише до моменту створення інтернет-документа (ІД) із цим контрагентом.
```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Contact Person","version":"2.0.0"},"tags":[{"name":"ContactPerson","description":"Операції, пов'язані з контактними особами контрагента"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["ContactPerson"],"operationId":"saveContactPersonJson","summary":"Створити контактну особу контрагента (JSON)","description":"Метод **save** моделі **ContactPersonGeneral** (або **ContactPerson**)\nдозволяє створити контактну особу контрагента.\n\nЗверніть увагу:\n- Редагувати дані контактної особи можуть тільки юридичні особи.\n- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\n- Редагування даних контрагента можливе лише до моменту створення інтернет-документа (ІД) із цим контрагентом.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveContactPersonJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveContactPersonResponse"}}}}}}}},"components":{"schemas":{"SaveContactPersonJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["ContactPersonGeneral","ContactPerson"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveContactPersonMethodProperties"}}},"SaveContactPersonMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyRef","FirstName","LastName","MiddleName","Phone"],"properties":{"CounterpartyRef":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"}}},"SaveContactPersonResponse":{"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/SaveContactPersonItem"}},"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"}}}},"SaveContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис українською мовою"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"Phones":{"type":"string","maxLength":36,"description":"Телефон"},"Email":{"type":"string","maxLength":36,"nullable":true,"description":"Електронна скринька"}}}}}} ``` ## Створити контактну особу контрагента (XML) > Метод \*\*save\*\* моделі \*\*ContactPersonGeneral\*\* (або \*\*ContactPerson\*\*)\ > дозволяє створити контактну особу контрагента у форматі XML.\ > \ > Зверніть увагу:\ > \- Редагувати дані контактної особи можуть тільки юридичні особи.\ > \- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\ > \- Редагування даних контрагента можливе лише до моменту створення інтернет-документа (ІД) із цим контрагентом.
```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Contact Person","version":"2.0.0"},"tags":[{"name":"ContactPerson","description":"Операції, пов'язані з контактними особами контрагента"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["ContactPerson"],"operationId":"saveContactPersonXml","summary":"Створити контактну особу контрагента (XML)","description":"Метод **save** моделі **ContactPersonGeneral** (або **ContactPerson**)\nдозволяє створити контактну особу контрагента у форматі XML.\n\nЗверніть увагу:\n- Редагувати дані контактної особи можуть тільки юридичні особи.\n- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\n- Редагування даних контрагента можливе лише до моменту створення інтернет-документа (ІД) із цим контрагентом.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveContactPersonXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/SaveContactPersonXmlResponse"}}}}}}}},"components":{"schemas":{"SaveContactPersonXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["ContactPersonGeneral","ContactPerson"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["save"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/SaveContactPersonXmlMethodProperties"}}},"SaveContactPersonXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/SaveContactPersonMethodProperties"}],"xml":{"name":"methodProperties"}},"SaveContactPersonMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyRef","FirstName","LastName","MiddleName","Phone"],"properties":{"CounterpartyRef":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"}}},"SaveContactPersonXmlResponse":{"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/SaveContactPersonXmlItem"}},"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"}}}}},"SaveContactPersonXmlItem":{"allOf":[{"$ref":"#/components/schemas/SaveContactPersonItem"}],"xml":{"name":"item"}},"SaveContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис українською мовою"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"Phones":{"type":"string","maxLength":36,"description":"Телефон"},"Email":{"type":"string","maxLength":36,"nullable":true,"description":"Електронна скринька"}}}}}} ``` ## Оновити дані контактної особи контрагента (JSON) > Метод \*\*update\*\* працює в моделі \*\*ContactPerson\*\* (або \*\*ContactPersonGeneral\*\*) і використовується для оновлення контактної особи (відправника/отримувача).\ > \ > \
\ > \Особливості редагування контактної особи\\ > \ > \- Редагувати дані контактної особи можуть тільки юридичні особи.\ > \- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\ > \- Редагування даних контактної особи можливе лише до моменту створення інтернет-документа (ІД) із цією контактною особою.\ > \ > \

```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Contact Person","version":"2.0.0"},"tags":[{"name":"ContactPerson","description":"Операції, пов'язані з контактними особами контрагента"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["ContactPerson"],"operationId":"updateContactPersonJson","summary":"Оновити дані контактної особи контрагента (JSON)","description":"Метод **update** працює в моделі **ContactPerson** (або **ContactPersonGeneral**) і використовується для оновлення контактної особи (відправника/отримувача).\n\n
\nОсобливості редагування контактної особи\n\n- Редагувати дані контактної особи можуть тільки юридичні особи.\n- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\n- Редагування даних контактної особи можливе лише до моменту створення інтернет-документа (ІД) із цією контактною особою.\n\n
\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateContactPersonJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateContactPersonJsonResponse"}}}}}}}},"components":{"schemas":{"UpdateContactPersonJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["ContactPersonGeneral","ContactPerson"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["update"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/UpdateContactPersonMethodProperties"}}},"UpdateContactPersonMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyRef","Ref","FirstName","LastName","MiddleName","Phone"],"properties":{"CounterpartyRef":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи контрагента"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"}}},"UpdateContactPersonJsonResponse":{"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/UpdateContactPersonItem"}},"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"}}}},"UpdateContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис українською мовою"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"Phones":{"type":"string","maxLength":36,"description":"Телефон"},"Email":{"type":"string","maxLength":36,"nullable":true,"description":"Електронна скринька"}}}}}} ``` ## Оновити дані контактної особи контрагента (XML) > Метод \*\*update\*\* працює в моделі \*\*ContactPerson\*\* (або \*\*ContactPersonGeneral\*\*) і використовується для оновлення контактної особи (відправника/отримувача).\ > \ > \
\ > \Особливості редагування контактної особи\\ > \ > \- Редагувати дані контактної особи можуть тільки юридичні особи.\ > \- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\ > \- Редагування даних контактної особи можливе лише до моменту створення інтернет-документа (ІД) із цією контактною особою.\ > \ > \

```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Contact Person","version":"2.0.0"},"tags":[{"name":"ContactPerson","description":"Операції, пов'язані з контактними особами контрагента"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["ContactPerson"],"operationId":"updateContactPersonXml","summary":"Оновити дані контактної особи контрагента (XML)","description":"Метод **update** працює в моделі **ContactPerson** (або **ContactPersonGeneral**) і використовується для оновлення контактної особи (відправника/отримувача).\n\n
\nОсобливості редагування контактної особи\n\n- Редагувати дані контактної особи можуть тільки юридичні особи.\n- Приватні особи можуть редагувати лише телефон контактної особи контрагента.\n- Редагування даних контактної особи можливе лише до моменту створення інтернет-документа (ІД) із цією контактною особою.\n\n
\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/UpdateContactPersonXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/UpdateContactPersonXmlResponse"}}}}}}}},"components":{"schemas":{"UpdateContactPersonXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["ContactPersonGeneral","ContactPerson"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["update"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/UpdateContactPersonXmlMethodProperties"}}},"UpdateContactPersonXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/UpdateContactPersonMethodProperties"}],"xml":{"name":"methodProperties"}},"UpdateContactPersonMethodProperties":{"type":"object","additionalProperties":false,"required":["CounterpartyRef","Ref","FirstName","LastName","MiddleName","Phone"],"properties":{"CounterpartyRef":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контрагента"},"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи контрагента"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я контактної особи"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище контактної особи"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові контактної особи"},"Phone":{"type":"string","maxLength":36,"description":"Телефон контактної особи"}}},"UpdateContactPersonXmlResponse":{"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/UpdateContactPersonXmlItem"}},"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"}}}}},"UpdateContactPersonXmlItem":{"allOf":[{"$ref":"#/components/schemas/UpdateContactPersonItem"}],"xml":{"name":"item"}},"UpdateContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"},"Description":{"type":"string","maxLength":50,"description":"Опис українською мовою"},"LastName":{"type":"string","maxLength":36,"description":"Прізвище"},"FirstName":{"type":"string","maxLength":36,"description":"Ім'я"},"MiddleName":{"type":"string","maxLength":36,"description":"По батькові"},"Phones":{"type":"string","maxLength":36,"description":"Телефон"},"Email":{"type":"string","maxLength":36,"nullable":true,"description":"Електронна скринька"}}}}}} ``` ## Видалити контактну особу контрагента (JSON) > Метод \*\*delete\*\* працює в моделі \*\*ContactPerson\*\* (або \*\*ContactPersonGeneral\*\*) і використовується для видалення контактної особи контрагента (відправника/отримувача).\ > \ > \
\ > \Особливості видалення контактної особи\\ > \ > \- Видаляти дані контактної особи контрагента можуть лише юридичні особи.\ > \ > \

```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Contact Person","version":"2.0.0"},"tags":[{"name":"ContactPerson","description":"Операції, пов'язані з контактними особами контрагента"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["ContactPerson"],"operationId":"deleteContactPersonJson","summary":"Видалити контактну особу контрагента (JSON)","description":"Метод **delete** працює в моделі **ContactPerson** (або **ContactPersonGeneral**) і використовується для видалення контактної особи контрагента (відправника/отримувача).\n\n
\nОсобливості видалення контактної особи\n\n- Видаляти дані контактної особи контрагента можуть лише юридичні особи.\n\n
\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteContactPersonJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteContactPersonJsonResponse"}}}}}}}},"components":{"schemas":{"DeleteContactPersonJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["ContactPersonGeneral","ContactPerson"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["delete"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/DeleteContactPersonMethodProperties"}}},"DeleteContactPersonMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"}}},"DeleteContactPersonJsonResponse":{"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/DeleteContactPersonItem"}},"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"}}}},"DeleteContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) видаленої контактної особи"}}}}}} ``` ## Видалити контактну особу контрагента (XML) > Метод \*\*delete\*\* працює в моделі \*\*ContactPerson\*\* (або \*\*ContactPersonGeneral\*\*) і використовується для видалення контактної особи контрагента (відправника/отримувача).\ > \ > \
\ > \Особливості видалення контактної особи\\ > \ > \- Видаляти дані контактної особи контрагента можуть лише юридичні особи.\ > \ > \

```json {"openapi":"3.0.3","info":{"title":"API Nova Post — Contact Person","version":"2.0.0"},"tags":[{"name":"ContactPerson","description":"Операції, пов'язані з контактними особами контрагента"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["ContactPerson"],"operationId":"deleteContactPersonXml","summary":"Видалити контактну особу контрагента (XML)","description":"Метод **delete** працює в моделі **ContactPerson** (або **ContactPersonGeneral**) і використовується для видалення контактної особи контрагента (відправника/отримувача).\n\n
\nОсобливості видалення контактної особи\n\n- Видаляти дані контактної особи контрагента можуть лише юридичні особи.\n\n
\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/DeleteContactPersonXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/DeleteContactPersonXmlResponse"}}}}}}}},"components":{"schemas":{"DeleteContactPersonXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["ContactPersonGeneral","ContactPerson"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["delete"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/DeleteContactPersonXmlMethodProperties"}}},"DeleteContactPersonXmlMethodProperties":{"allOf":[{"$ref":"#/components/schemas/DeleteContactPersonMethodProperties"}],"xml":{"name":"methodProperties"}},"DeleteContactPersonMethodProperties":{"type":"object","additionalProperties":false,"required":["Ref"],"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) контактної особи"}}},"DeleteContactPersonXmlResponse":{"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/DeleteContactPersonXmlItem"}},"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"}}}}},"DeleteContactPersonXmlItem":{"allOf":[{"$ref":"#/components/schemas/DeleteContactPersonItem"}],"xml":{"name":"item"}},"DeleteContactPersonItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) видаленої контактної особи"}}}}}} ``` --- # 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/kontaktni-personi.md?ask=&goal= ``` `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.