Створення чернетки документа¶
Для роботи з цим методом користувач повинен бути авторизованим .
За допомогою POST методу api/eds/doc можливо швидко створити чернетку документа конкретного зазначеного типу для конкретного одержувача.
Метод запиту |
HTTP POST |
---|---|
Content-Type |
application/json (тіло HTTP запиту / відповіді в json форматі) |
URL запиту |
https://edo-v2.edi-n.com/api/v2/eds/doc?gln=9864065702429&doc_type=orders |
Параметри, що передаються в URL (разом з адресою методу) |
У рядку заголовка (Header) «Cookie» обов’язково передається SID - токен отриманий при авторизації Обов’язкові url-параметри: gln - рядок (13); номер GLN організації, яка пов’язана з авторизованим користувачем платформи EDIN 2.0 на рівні акаунта doc_type - рядок; конкретний тип документа |
Підказка
Також можливо виконати запит у вигляді curl-рядка:
curl -X POST „https://edo-v2.edi-n.com/api/v2/eds/doc?gln=9864065702429&doc_type=orders“ -d {json - тело документа} -b „SID=458a0d38-5b56-4b8e-8998-009a1edd31eb“
Специфікація для розшифровки ключів curl запиту: https://curl.haxx.se/docs/manpage.html
JSON-параметри в тілі HTTP запиту/відповіді
REQUEST
У цьому методі в json-тілі запиту передаються поля документа (зі специфікацією документів ви можете ознайомитися у відповідному розділі).
RESPONSE
Таблиця 1 - Опис json-параметрів, що можуть передаватися у відповідь (об’єкт створеного документа-чернетки) на метод API.
Параметр |
Формат |
Опис |
---|---|---|
Об’єкт XDoc |
||
body |
об’єкт; тіла документів |
|
attachments |
List<XDocAttachment_> |
масив об’єктів; вкладення (може не використовуватися) |
comments |
об’єкт (в якому масив об’єктів); список коментарів |
|
doc_id |
long |
id документа |
doc_uuid |
UUID |
унікальний ідентифікатор документа/квитанції |
uuidSender |
String |
унікальний ідентифікатор відправника |
uuidReceiver |
String |
унікальний ідентифікатор одержувача |
docNumber |
String |
номер документа |
dateCreated |
long |
дата створення документа (unix timestamp) |
dateChanged |
long |
дата останньої зміни документа (unix timestamp) |
dateRead |
long |
дата прочитання документа (unix timestamp) |
docDate |
long |
дата документа, зазначена в документі |
chain_id |
long |
id ланцюжка документів |
chain_uuid |
UUID |
унікальний ідентифікатор ланцюжка документів |
family |
int |
сімейство (EDI / UZD) |
hash |
String |
хеш-значення, отримане в результаті обробки |
type |
XDocType |
об’єкт; тип документа |
status |
об’єкт; статус пари документів у відправника і одержувача |
|
exchange_status |
String |
сабстатус документа |
is_archive |
boolean |
відмітка; Архівний документ чи ні |
signInfo |
об’єкт; дані про підписи |
|
chain |
XChain |
объект; дані пов’язаних ланцюжків |
extraFields |
Map<String, String> |
масив об’єктів; набір індексів (аналог індексних таблиць) |
tags |
List<XTag_> |
масив об’єктів; прикріплені теги |
statuses |
List<XStatus_> |
масив об’єктів; статуси обробки відправлених документів |
multiExtraFields |
Map<String, List<String>> |
масив об’єктів; мультиіндекс. Приклад: {„key1“: [„val1“, „val2“], „key2“: [„val1“, „val2“]}. Використовується, наприклад для обробки передаваємого рядка => розбивка рядка за умовою => індексування кожного шматка |
Приклади
Приклад тіла запиту (json):
{
"NUMBER": "6422722fb78c4509b06eac43758e1545",
"DATE": "2019-02-15",
"TIME": "00:00",
"ORDERNUMBER": "6422722fb78c4509b06eac43758e1545",
"ORDERDATE": "2019-02-15",
"DELIVERYDATE": "2019-02-30",
"DELIVERYTIME": "10:00",
"CAMPAIGNNUMBER": "334455",
"CURRENCY": "UAH",
"LIMES": [],
"HEAD": [
{
"BUYER": "4820128010004",
"SUPPLIER": "9864065702429",
"DELIVERYPLACE": "4820128019007",
"INVOICEPARTNER": "4820128010004",
"SENDER": "4820128010004",
"RECIPIENT": "9864065702429",
"POSITION": [
{
"POSITIONNUMBER": "1",
"PRODUCT": "5029053540900",
"PRODUCTIDBUYER": "527209",
"DESCRIPTION": "пироженко",
"PRICE": 510,
"PRICEWITHVAT": 571.2,
"VAT": "12.00",
"AMOUNT": 0,
"AMOUNTWITHVAT": 0,
"ORDEREDQUANTITY": 64,
"ACCEPTEDQUANTITY": 64,
"PRODUCTTYPE": "1"
},
{
"POSITIONNUMBER": "2",
"PRODUCT": "5029053540924",
"PRODUCTIDBUYER": "527215",
"DESCRIPTION": "мороженко",
"PRICE": 510,
"PRICEWITHVAT": 571.2,
"VAT": "12.00",
"AMOUNT": 0,
"AMOUNTWITHVAT": 0,
"ORDEREDQUANTITY": 32,
"ACCEPTEDQUANTITY": 32,
"PRODUCTTYPE": "1"
},
...
{
"POSITIONNUMBER": "48",
"PRODUCT": "5029053543987",
"PRODUCTIDBUYER": "100307632",
"DESCRIPTION": "водочка",
"PRICE": 1751.6,
"PRICEWITHVAT": 1961.79,
"VAT": "12.00",
"AMOUNT": 0,
"AMOUNTWITHVAT": 0,
"ORDEREDQUANTITY": 12,
"ACCEPTEDQUANTITY": 12,
"PRODUCTTYPE": "1"
}
]
}
],
"ACTION": "29"
}
Приклад тіла відповіді (json):
Повертаємий текст - об’єкт створеного документа-чернетки:
{
"attachments": [],
"body": {
"forms": {
"json": {
"type": {
"id": 2,
"name": "json"
}
}
}
},
"chain_id": 0,
"comments": [],
"dateChanged": 0,
"dateCreated": 1574421527,
"dateRead": 0,
"docDate": 1565211600,
"docNumber": "2019-08-08-TEST-001",
"doc_id": 143,
"doc_uuid": "6ffc8dfa-1cd5-4137-82cf-29b5969c2e74",
"extraFields": {
"basis_doc_date": "1565211600",
"basis_doc_number": "1",
"basis_doc_subtype": "007",
"doc_date": "1565211600",
"doc_num": "2019-08-08-TEST-001",
"order_number": "1",
"recipient": "9864232319979",
"sender": "9864232319962",
"sub_doc_type_id": "006"
},
"family": 1,
"hash": "D4733FDDDEBE23B4E38DC5F257604234",
"is_archive": false,
"multiExtraFields": {},
"status": {
"status": 1,
"title": "open"
},
"statuses": [],
"tags": [],
"type": {
"description": "Коммерческий документ",
"title": "comdoc",
"type": 28
},
"uuidReceiver": "9864232319979",
"uuidSender": "9864232319962"
}