Changelog pro One Marketplace API
- Přidáváme nové volání POST payout-report, pro výpis objednávek ve výplatě prostředků z prodeje
- Není povinně vyžadována implementace všech API volání. V administraci Heureky lze zadat pouze specifické API URL.
- Číslo objednávky “heureka_id” v metodě POST order/send je nově typu big integer
- Metody GET payment/status směrem do Heureky se nadále nevyužívá
- Metoda PUT payment/status směrem do Heureky se nadále nevyužívá
- Metoda POST order/note směrem do Heureky se nadále nevyužívá
- Metoda POST order/invoice směrem do Heureky se nadále nevyužívá
- Typ dopravy 6 - Česká pošta - Balík na poštu se nadále nevyužívá. Využijte typ 9 - Dopravci poskytovaní přes DepotAPI -> store: { type: 3; id: 5 }
- Pro komunikaci přes API je vyžadováno povolení nových IP adres uvedených níže.
- V případě nedostupného ID online platby v GET payment/delivery se již nesnažíme id nahradit ID pro bankovní převod
- Změna stavů objednávek má dané pořadí (viz Číselník níže)
POST payout-report
Vrátí seznam objednávek v konkrétní výplatě.
Url
https://ssl.heureka.cz/api/cart/:APIkľúč:/1/payout-report
Vstupní parametry
| day string | Datum výplaty ve formátu YYYY-MM-DD |
|---|
Struktura odpovědí
V odpovědi naleznete text/csv. Data jsou oddělené středníkem (;). Soubor obsahuje následující sloupce:
- Číslo objednávky
- Datum objednávky
- Typ
- Referenční číslo
- Hrubá cena produktů
- Poplatek za dopravu
- Hrubá provize
- Celková cena objednávky
- Celková cena snížená o provizi
- Variabilní symbol
- Interní ID
HTTP požadavek
curl -X 'POST' 'https://ssl.heureka.cz/api/cart/:APIkľúč:/1/payout-report' -H 'accept: text/csv' -H 'Content-Type: application/json' -d '{"day": "2023-08-28"}'
Odpověď
"Číslo objednávky";"Dátum objednávky";Typ;"Referenčné číslo";"Hrubá cena produktov";"Poplatok za dopravu";"Hrubá provízia";"Celková suma nákupu";"Celková suma znížená o províziu";"Variabilný symbol";"Internal ID"
8311418522;"2023-07-17 16:10:18";Pripisovanie;;24;0;3,19;24;20,81;2023000007;2023000007
Jaké je datum pro výplaty?
Výplaty jsou zpracovány vždy v pondělí, pokud je na virtuálním účtu dostupná kladná částka na vyplacení.
Nové IP adresy
Kompletní seznam všech používaných IP adres je k dispozici zde: https://ip.heureka.group/v4
Kontrola polohy IP adres:
V březnu 2024 přejde Heureka na cloudové řešení a změní se nejen rozsah IP adres, ale i jejich lokace. Je tak nutné zkontrolovat nejen povolený seznam IP adres, ale i povolení přístupu z Německa, kde se naše cloudové řešení fyzicky nachází. (Je-li povolena pouze sada IP adres, dojde k odfiltrování všech požadavků z cizích zemí ještě před kontrolou adres a není možné navázat API spojení).
Posloupnost změny stavů
Změna stavů je omezena na následující možnosti:
| Výchozí stav | Povolená změna |
| 8 - Nový | 1 - Nový |
| 1 - Nový |
3 - Nový,
0, 10, 11 - Probíhá,
9 - Dokončeno,
4, 5, 6 - Zrušeno,
|
| 3 - Nový |
0, 10, 11 - Probíhá,
9 - Dokončeno,
4, 5, 6 - Zrušeno,
|
| 0, 10, 11 - Probíhá |
9 - Dokončeno,
4, 5, 6 - Zrušeno,
|
| 9 - Dokončeno |
7 - Vráceno
|
Ideální schéma úspěšného objednávkového procesu:
Stavy lze přeskakovat, musí však zachovat postup, viz výše.
