API V1.0 – 5.1. СТВОРЕННЯ ОДЕРЖУВАЧА
URL-Адреса запиту:
https://api.sat.ua/study/hs/api/v1.0/catalogs/Counterparty/{format}/save?apiKey={apiKey}[&language]Параметри запиту:
format
string
Формат даних для отримання відповіді (xml, json)
apiKey (додатковий)
string
Ключ користувача ТК САТ. Для отримання ключа потрібно пройти реєстрацію. Ключ може бути переданий як через параметр URL, так і в заголовку HTTP запиту У режимі тестування без реєстрації використовуйте ключ: devApiKey
language (додатковий)
string
Код мови для отримання відповіді (ru, en, uk)
Текст запиту (доступні поля):
-
Доступні поля:
-
description:
найменування одержувача
-
phone:
телефон одержувача (380XXXXXXXXXXX)
-
address:
адреса одержувача
- town:
-
okpo:
Код ЄДРПОУ для юр. осіб одержувачів (description необов'язково, прийде у відповіді)
приклад запиту
text/xml
| application/json
<request>
<item>
<description>Кравцов Олег Игоревич</description>
<phone>380632525252</phone>
<town>255f0170-9320-11da-9860-00024407fbce</town>
</item>
/</request>
<request>
<item>
<phone>+380632525252</phone>
<town>255f0170-9320-11da-9860-00024407fbce</town>
<okpo>1234567890</okpo>
</item>
/</request>
Відповідь 200
Список доданих одержувачів
-
ref:
ідентифікатор одержувача
-
description:
найменування одержувача
-
phone:
телефон одержувача
-
address:
адреса одержувача
-
town:
дентифікатор міста одержувача
-
counterpartyType:
тип отримувача
-
1:
не має договору для безготівкових розрахунків
-
0:
має договір для безготівкових розрахунків
приклад відповіді
text/xml
| application/json
<response>
<success>true</success>
<data>
<item>
<ref>8f1eeac0-5893-11e5-9ad6-005056b13e62</ref>
<description>Кравцов Олег Игоревич</description>
<phone>+380632525252</phone>
<address/>
<town>255f0170-9320-11da-9860-00024407fbce</town>
<counterpartyType>1</counterpartyType>
</item>
</data>
</response>
інтерфейси API