Nič sa nenašlo

E-shop API – vratky

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.

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>
Poznámka

Ak sa požiadavka nedostane k cieľu, zopakujte ju na záložnom serveri backup1.bulkgate.com.

Podporované HTTP metódy

  • POST - application/json
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.

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.

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ď

{ "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.

Bola táto stránka užitočná?