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

##### **REQUEST** 

<table class="colwidths-given docutils align-default" id="bkmrk-url-https%3A%2F%2Fedo-v2.e" style="width: 100%;"><colgroup><col style="width: 14.8994%;"></col><col style="width: 85.1006%;"></col></colgroup><tbody><tr class="row-odd"><td>**URL**

</td><td>https://edo-v2.edin.ua

</td></tr><tr class="row-even"><td>Метод запиту

</td><td>POST

</td></tr><tr class="row-odd"><td>URL запиту

</td><td>/api/distribex/doc/retann

</td></tr><tr class="row-even"><td>URL параметри

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

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

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

**search\_positions** (опціонально) boolean:

- якщо **true**, то у відповідь метода повертається список доступних до повернення позицій для зазначеного Покупця в межах періоду;
- якщо **false** або параметр **search\_positions** відсутній, то очікується тіло документа [«Повідомлення про повернення» (RETANN)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-povernennia-retann) в json форматі уже разом із позиціями; при цьому документ одразу відправляється контрагенту (без створення чернетки).

</td></tr><tr class="row-odd"><td>**Headers**

</td><td> </td></tr><tr class="row-even"><td>Authorization

</td><td>SID - токен, отриманий при [авторизації](https://wiki-v2.edin.ua/books/robota-z-api/page/metod-avtorizaciyi-na-platformi)

</td></tr><tr class="row-odd"><td>Content-Type

</td><td>application/json

</td></tr><tr class="row-even"><td>**REQUEST**

</td><td> </td></tr><tr class="row-odd"><td>JSON Body

</td><td>Тіло запиту передається лише при search\_positions=false або відсутності даного параметра: [«Повідомлення про повернення» (RETANN)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-povernennia-retann) в json форматі уже разом із позиціями; при цьому документ одразу відправляється контрагенту (без створення чернетки).

</td></tr></tbody></table>

##### **RESPONSE**

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

- якщо **true**, то у відповідь метода повертається список доступних до Повернення позицій (масив об’єктів POSITION [«Повідомлення про повернення» (RETANN)](https://wiki-v2.edin.ua/books/xml-specifikaciyi-dokumentiv/page/povidomlennia-pro-povernennia-retann)) для зазначеного Покупця в межах періоду;
- якщо **false** або параметр **search\_positions** відсутній, то повертається doc\_uuid - унікальний ідентифікатор успішно відправленого «Повідомлення про повернення» (RETANN).

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

- **search\_positions=true**

```json
[
    {
        "POSITIONNUMBER": 1,
        "PRODUCT": "4820022867421",
        "PRICE": 96.06,
        "PRODUCTIDSUPPLIER": "7127",
        "RETURNQUANTITYUNIT": "PCE",
        "DELIVEREDQUANTITYUNIT": "PCE",
        "DESCRIPTION": "\"Традиционный\"  400х12 зерновой кофе Жокей Укр",
        "AMOUNT": "3169.98",
        "RETURNQUANTITY": "33"
    }
]
```

- **search\_positions=false**

```json
{
  doc_uuid:"e3dbf6e8-029e-4c3b-804b-9b2741d9f37d"
  }
```