Skip to main content

Визначення переліку товарних позицій, доступних для повернення, та формування документа “Надсилання Повернення” (ініціатор - Покупець/Дистриб’ютор) POST /api/distribex/doc/retann

REQUEST

URL

https://edo-v2.edin.ua

Метод запиту

POST

URL запиту

/api/distribex/doc/retann

URL параметри

gln (обов’язково) String - GLN Покупця (Дистрибʼютора)

producer (обов’язково) String - GLN Продавця (Виробника);

period (обов’язково) int - кількість днів, за які з документів робиться вибірка позицій, доступних до повернення (починаючи від поточного дня) - period=1 - за сьогодні, period=2 - за сьогодні та вчора і т.д.; максимум 90 днів, однак обмеження може змінюватись відповідно до наявності Лімітів зазначених Продавцем;

search_positions (опціонально) boolean:

  • якщо true, то у відповідь метода повертається список доступних до повернення позицій для зазначеного Покупця в межах періоду;

  • якщо false або параметр search_positions відсутній, то очікується тіло документа «Повідомлення про повернення» (RETANN) в json форматі уже разом із позиціями; при цьому документ одразу відправляється контрагенту (без створення чернетки).

Headers

  

Authorization

SID - токен, отриманий при авторизації

Content-Type

application/json

REQUEST

  

JSON Body

Тіло запиту передається лише при search_positions=false або відсутності даного параметра: «Повідомлення про повернення» (RETANN) в json форматі уже разом із позиціями; при цьому документ одразу відправляється контрагенту (без створення чернетки).
RESPONSE

В тілі відповіді залежно від параметра search_positions:

  • якщо true, то у відповідь метода повертається список доступних до Повернення позицій (масив об’єктів POSITION «Повідомлення про повернення» (RETANN)) для зазначеного Покупця в межах періоду;

  • якщо false або параметр search_positions відсутній, то повертається doc_uuid - унікальний ідентифікатор успішно відправленого «Повідомлення про повернення» (RETANN).

Приклад відповіді (успішний запит)

  • search_positions=true
[
    {
        "POSITIONNUMBER": 1,
        "PRODUCT": "4820022867421",
        "PRICE": 96.06,
        "PRODUCTIDSUPPLIER": "7127",
        "RETURNQUANTITYUNIT": "PCE",
        "DELIVEREDQUANTITYUNIT": "PCE",
        "DESCRIPTION": "\"Традиционный\"  400х12 зерновой кофе Жокей Укр",
        "AMOUNT": "3169.98",
        "RETURNQUANTITY": "33"
    }
]
  • search_positions=false
{
  doc_uuid:"e3dbf6e8-029e-4c3b-804b-9b2741d9f37d"
  }

Back to top