> ## Documentation Index
> Fetch the complete documentation index at: https://api.basetools.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Stahování vratek

> getOrderReturns — jak fungují vratky v Base a čím se liší od objednávek

Vratky (order returns) fungují v Base analogicky k objednávkám a mají v API samostatný, ale zrcadlový blok metod.

## Základní metoda

[`getOrderReturns`](https://api.baselinker.com/index.php?method=getOrderReturns) stahuje vratky z Base od zadaného data, max. 100 na jedno volání — stejný princip stránkování jako u [`getOrders`](/cs/objednavky/stahovani-objednavek).

| Parametr                                                      | Typ        | Popis                                                                                                                                          |
| ------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`                                                    | int        | ID původní objednávky, ze které vratka vznikla.                                                                                                |
| `return_id`                                                   | int        | Stáhne jen jednu konkrétní vratku.                                                                                                             |
| `date_from`                                                   | int (unix) | Datum vzniku vratky, od kterého se mají stahovat.                                                                                              |
| `id_from`                                                     | int        | ID vratky, od kterého se stahují další.                                                                                                        |
| `status_id`                                                   | int        | Omezí výběr na konkrétní stav vratky.                                                                                                          |
| `filter_order_return_source`, `filter_order_return_source_id` | —          | Filtrování podle zdroje vratky (marketplace kód).                                                                                              |
| `include_custom_extra_fields`                                 | bool       | Přidá hodnoty vlastních polí — viz [Extra pole](/cs/objednavky/extra-pole), princip je stejný jako u objednávek (`getOrderReturnExtraFields`). |

<Note>
  Na rozdíl od objednávek zde **neexistuje koncept potvrzené/nepotvrzené vratky** (`date_confirmed`) — stránkujte tedy podle `date_from` (a hodnoty posledního zpracovaného záznamu +1s), případně `id_from`.
</Note>

## Klíčová pole v odpovědi

| Pole                                                                       | Popis                                                                                                                                                                                             |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `return_id` / `order_id`                                                   | ID vratky a ID původní objednávky.                                                                                                                                                                |
| `status_id`                                                                | Stav vratky — seznam přes [`getOrderReturnStatusList`](https://api.baselinker.com/index.php?method=getOrderReturnStatusList), koncept stejný jako u [Statusů](/cs/objednavky/statusy) objednávek. |
| `fulfillment_status`                                                       | Číselný stav zpracování: `0` aktivní, `5` přijatá, `1` vyřízená, `2` zrušená.                                                                                                                     |
| `refunded`                                                                 | Informace, zda už byla vratka refundována.                                                                                                                                                        |
| `order_return_account_number` / `order_return_iban` / `order_return_swift` | Bankovní údaje pro vrácení peněz zákazníkovi.                                                                                                                                                     |
| `products`                                                                 | Vrácené položky (stejná struktura jako u objednávky, navíc `return_reason_id`).                                                                                                                   |

## Práce se stavy a refundací

* Stavy vratek se čtou a zapisují analogicky k objednávkám: [`getOrderReturnStatusList`](https://api.baselinker.com/index.php?method=getOrderReturnStatusList), [`setOrderReturnStatus`](https://api.baselinker.com/index.php?method=setOrderReturnStatus) / [`setOrderReturnStatuses`](https://api.baselinker.com/index.php?method=setOrderReturnStatuses).
* Důvody vratky (proč zákazník vrací zboží) vrací [`getOrderReturnReasonsList`](https://api.baselinker.com/index.php?method=getOrderReturnReasonsList).
* [`setOrderReturnRefund`](https://api.baselinker.com/index.php?method=setOrderReturnRefund) označí vratku jako refundovanou — **nespouští žádnou skutečnou platbu**, jen zapisuje informaci do Base.

## Zachytávání změn v čase

Stejně jako u objednávek existuje i pro vratky žurnál: [`getOrderReturnJournalList`](https://api.baselinker.com/index.php?method=getOrderReturnJournalList) — princip i nutnost aktivace v **Profil → API** je stejná jako u [`getJournalList`](/cs/objednavky/automatizace-a-webhooky#tři-způsoby-jak-zachytit-změnu-na-objednávce).

## Vratky z marketplace kanálů

U vybraných marketplace kanálů umí Base automaticky stahovat žádosti o vrácení zboží přímo od zákazníka a zakládat z nich vratky — nastavuje se to v detailu konkrétního prodejního kanálu. Po zapnutí pak stačí sledovat nové vratky výše popsaným způsobem.

<Tip>
  Pokud řešíte i vratkové přepravní štítky, princip je stejný jako u standardních zásilek — viz [Přepravní štítky](/cs/objednavky/prepravni-stitky), jen s parametrem `return_shipment: true`.
</Tip>