Udalosti vratky: zákazník založil novú vratku alebo sa zmenil jej stav. Parametre požiadavky, výber notifikácie a tvar odpovede popisuje [prehľad E-shop API](https://www.bulkgate.com/sk/dokumentacia/eshop-api/eshop-api-prehlad/).

## API URL

| ENDPOINT                                                           | UDALOSŤ NOTIFIKÁCIE                       |
|:-------------------------------------------------------------------|:------------------------------------------|
| `https://portal.bulkgate.com/api/1.0/eshop/return/new`             | `product_return`                          |
| `https://portal.bulkgate.com/api/1.0/eshop/return/change-status`   | `return_status_change_<return_status_id>` |

> [!NOTE]
> Ak sa požiadavka nedostane k cieľu, zopakujte ju na [záložnom serveri](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/zalozny-server/) `backup1.bulkgate.com`.

## Podporované HTTP metódy

- `POST` - `application/json`

```http
POST /api/1.0/eshop/return/new HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json
```

## Nová vratka

`eshop/return/new` spustí notifikáciu udalosti `product_return`. Údaje o vratke odovzdajte premennými zo skupiny Vratka, napr. `return_id`, `return_reason` alebo `return_products1`.

```http-json
POST /api/1.0/eshop/return/new HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "language": "sk",
  "variables": {
    "return_id": "77",
    "order_id": "10045",
    "return_reason": "Nevyhovujúca veľkosť",
    "customer_mobile": "777777777",
    "customer_country_id": "cz"
  }
}
```

## Zmena stavu vratky

`eshop/return/change-status` hľadá notifikáciu pre konkrétny stav. Názov udalosti skladá z `return_status_change_` a hodnoty premennej `return_status_id`, takže `return_status_id` posielajte vždy — bez nej portál notifikáciu k žiadnemu stavu nepriradí. Stavy, pre ktoré sa dá notifikácia nastaviť, nahrá váš e-shop cez [nastavenia](https://www.bulkgate.com/sk/dokumentacia/eshop-api/eshop-api-nastavenia/).

```http-json
POST /api/1.0/eshop/return/change-status HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
  "application_id": 451,
  "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj",
  "language": "sk",
  "variables": {
    "return_id": "77",
    "return_status_id": "3",
    "return_status": "Vratka prijatá",
    "customer_mobile": "777777777",
    "customer_country_id": "cz"
  }
}
```

Požiadavka vyššie použije notifikáciu nastavenú pre udalosť `return_status_change_3`.

## Odpoveď

```json
{
    "data": {
        "customer": [
            {
                "status": "accepted",
                "message_id": "tmpde1bcd4b1d1",
                "part_id": ["tmpde1bcd4b1d1"],
                "number": "420777777777",
                "channel": "sms"
            }
        ]
    }
}
```

Význam kľúčov `customer` a `admin`, chyby pri odoslaní a typy chýb nájdete v [prehľade E-shop API](https://www.bulkgate.com/sk/dokumentacia/eshop-api/eshop-api-prehlad/).
