Dokumentace API - Objednávky
Základní informace
Základní informace k API, autentizaci, stavovým kódům, HTTP metodám, datovým typům a další najdete na API v2 základní informace
Vytvoření objednávky
Systém během importu objednávek přes API porovnává zákaznické údaje v e-shopu s těmi v objednávce. Když se najde shodný zákazník s emailem, pak je přiřazen k dané objednávce.
Požadavek
- URI: /api/v2/orders
- HTTP metoda: POST
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
-
tělo:
send_emails_yn
(bool) - poslání emailu který je navázán na stav objednávky, výchozí hodnota jetrue
send_sms_yn
(bool) - poslání SMS která je navázána na stav objednávky, výchozí hodnota jetrue
(SMS služba není standardně aktivní, více najdete v Nastavení SMS)orders
(array) - pole objektů s objednávkamiexternal_order_number
(string) - číslo objednávky z externího systémulanguage_id
(language) - jazyk objednávky, jazyk musí být vytvořen v administraci eshopuprices_with_vat_yn
(bool) - příznak jestli jsou ceny s DPH, pokud není zadáno bere se podle nastavení z administracestatus
(string) - název stavu objednávky z administrace (výchozí stav u nové objednávky je Přijatá), seznam stavů se dá zjistit pomocí metody GET, více v sekci Stavy objednávkypaid_date
(date) - datum zaplacení objednávkytracking_code
(string) - trackovací kód pro dopravuresolved_yn
(bool) - příznak pro vyřešenou objednávkuinternal_note
(string) - interní poznámkavariable_symbol
(string) - variabilní symbol (maximální délka 10 znaků, jen číslice). Pokud není uvedeno, generuje se systémem z čísla obchodního případu. Možné hodnoty jsou:case
- doplní se automaticky variabilní symbol z čísla obchodního případuorder
- doplní se automaticky variabilní symbol z čísla objednávky- variabilní symbol (maximální délka 10 znaků, jen číslice) - doplní se vlastní hodnota
creation_time
(date) - čas vytvoření objednávkycustomer
(object) - zákazníkemail
(email) - email zákazníkaphone
(string) - telefonfirstname_invoice
(string) - fakturační jménosurname_invoice
(string) - fakturační příjmenístreet_invoice
(string) - fakturační ulice a číslocity_invoice
(string) - fakturační městostate_invoice
(string) - fakturační okreszip_invoice
(string) - fakturační PSČcountry_id_invoice
(country) - fakturační zeměpostal_yn
(bool) - příznak doručovací adresy, pokud posíláte doručovací adresu musí mít hodnotutrue
firstname_postal
(string) - doručovací jménosurname_postal
(string) - doručovací přijmenístreet_postal
(string) - doručovací ulice a číslocity_postal
(string) - doručovací městostate_postal
(string) - doručovací okreszip_postal
(string) - doručovací PSČcountry_id_postal
(country) - doručovací zeměcompany_postal
(string) - doručovací název firmycompany_yn
(bool) - příznak jestli je zákazník firmacompany
(string) - název firmy, povinné pokud je firmaico
(string) - IČOdic
(string) - DIČvat_payer_yn
(bool) - příznak jestli je firma plátce DPHpricelist_name
(string) - název ceníkupricelist_percent
(int) - procenta slevy ceníku (pouze informativní, s procenty se nikde nepočítá)customer_note
(string) - poznámka zákazníka
products
(array) - pole objektů s produktycode
(string) - kód produktucode_supplier
(string) - kód dodavateleean
(string) - EAN produktutitle
(string) - název produktuquantity
(float) - počet kusůunit
(string) - jednotkaprice_per_unit
(float) - cena za jednu jednotku produktuvat
(float) - hodnota DPH v %buy_price
(float) - nákupní cenarecycling_fee
(float) - recyklační poplatekweight
(int) - váha jedné jednotky produktu v gramechinvoice_info
(string) - poznámka k produktu která se propisuje do fakturyparameters
(array) - pole objektů s parametry produktuname
(string) - název parametruvalue
(string) - hodnota parametru
shipment
(object) - dopravacode
(string) - kód dopravy, páruje se s kódem dopravy (ve vlastních polích) v administraciname
(string) - název dopravyprice
(float) - cena dopravyvat
(float) - hodnota DPH v %affiliate_id
(string) - ID pobočky dopravy
payment
(object) - platbacode
(string) - kód platby, páruje se s kódem platby (ve vlastních polích) v administraciname
(string) - název platbyprice
(float) - cena platbyvat
(float) - hodnota DPH v %eet_yn
(bool) - příznak jestli je se má poslat objednávka do EET
metas
(array) - pole objektů s vlastními polikey
(string) - klíč vlastního polevalue
(string) - hodnota vlastního pole
invoice
(object) - faktura, možnost vygenerování fakturygenerate_yn
(bool) - příznak o vygenerování faktury, pokud budeFALSE
, nevygeneruje se vůbec, ani v případě že je zapnuté automatické generování fakturyexpiration_date
(date) - datum splatnosti, pokud není vyplněno, bere se aktuální datum + nastavená hodnota z administracedate_of_issuance
(date) - datum vystavenídate_of_vat_revenue_recognition
(date) - datum zdanitelného plnění
-
příklad požadavku
POST /api/v2/orders HTTP/1.1 Content-Type: application/json Authorization: Basic dGVzdDp0ZXN0 { "send_emails_yn": true, "send_sms_yn": true, "orders": [ { "external_order_number": "", "language_id": "", "prices_with_vat_yn": "", "status": "", "paid_date": "", "tracking_code": "", "resolved_yn": "", "internal_note": "", "variable_symbol": "", "customer": { "email": "", "phone": "", "firstname_invoice": "", "surname_invoice": "", "street_invoice": "", "city_invoice": "", "state_invoice": "", "zip_invoice": "", "country_id_invoice": "", "postal_yn": "", "firstname_postal": "", "surname_postal": "", "street_postal": "", "city_postal": "", "state_postal": "", "zip_postal": "", "company_postal": "", "country_id_postal": "", "company_yn": "", "company": "", "ico": "", "dic": "", "vat_payer_yn": "", "customer_note": "" }, "products": [ { "code": "", "code_supplier": "", "ean": "", "title": "", "quantity": "", "unit": "", "price_per_unit": "", "vat": "", "buy_price": "", "recycling_fee": "", "weight": "", "invoice_info": "", "parameters": [ { "name": "", "value": "" } ] } ], "shipment": { "code": "", "name": "", "price": "", "vat": "", "affiliate_id": "" }, "payment": { "code": "", "name": "", "price": "", "vat": "", "eet_yn": "" }, "metas": [ { "key": "", "value": "" } ], "invoice": { "generate_yn": "", "expiration_date": "", "date_of_issuance": "", "date_of_vat_revenue_recognition": "" } } ] }
Odpověd
- tělo:
orders
(array) - pole objektů s objednávkyexternal_order_number
(string) - externí číslo objednávkyorder_number
(string) - číslo objednávky, pokud se objednávka nevytvoří, vracínull
order_url
(string) - URL adresa kde se nachází objednávkacreated_yn
(bool) - příznak jestli se objednávka vytvořilamessages
(array) - pole objektů chybových zpráv a upozornění při zpracování objednávkyobject
(string) - název objektu (část JSONu) kterého se zpráva týkáproperty
(string) - hodnota které se zpráva týkámessage
(string) - text zprávy
-
příklad odpovědi (HTTP 200 OK)
HTTP/1.1 200 OK Content-Type: application/json { "orders": [ { "order_number": "", "order_url": "", "created": "", "messages": [ { "object": "", "property": "", "message": "" } ] } ] }
Aktualizace objednávek
Požadavek
- URI: /api/v2/orders
- HTTP metoda: PUT
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
-
tělo:
- objednávky se párují podle čísla
order_number
. Při změně stavu se posílají emaily (pokud je nějaký email u stavu objednávky nastaven). V odpovědi jsou všechny objednávky které byly v požadavku. send_emails_yn
(bool) - poslání emailu při změně stavu (pokud je nějaký email nastaven), výchozí hodnota jetrue
orders
(array) - pole objektů s objednávkamiorder_number
(string) - číslo objednávkystatus
(string) - název stavu objednávky, stav musí být vytvořen v administraci, seznam stavů se dá zjistit pomocí metody GET/api/v2/orders/states
status_id
(int) - ID stavu objednávky, stav musí být vytvořen v administraci, seznam stavů se dá zjistit pomocí metody GET/api/v2/orders/states
paid_date
(date) - datum zaplacení objednávkytracking_code
(string) - trackovací kód pro dopravuresolved_yn
(bool) - příznak pro vyřešenou objednávkuinternal_note
(string) - interní poznámkametas
(array) - pole objektů s vlastními polikey
(string) - klíč vlastního polevalue
(string) - hodnota vlastního pole
invoice
(object) - faktura, možnost vygenerování fakturygenerate_yn
(bool) - příznak o vygenerování faktury, pokud budeFALSE
, nevygeneruje se vůbec, ani v případě že je zapnuté automatické generování fakturyexpiration_date
(date) - datum splatnosti, pokud není vyplněno, bere se aktuální datum + nastavená hodnota z administracedate_of_issuance
(date) - datum vystavenídate_of_vat_revenue_recognition
(date) - datum zdanitelného plnění
- objednávky se párují podle čísla
-
příklad požadavku
PUT /api/v2/orders HTTP/1.1 Content-Type: application/json Authorization: Basic dGVzdDp0ZXN0 { "send_emails_yn": "", "orders": [ { "order_number": "", "status": "", "status_id": "", "paid_date": "", "tracking_code": "", "resolved_yn": "", "internal_note": "", "metas": [ { "key": "", "value": "" } ], "invoice": { "generate_yn": "", "expiration_date": "", "date_of_issuance": "", "date_of_vat_revenue_recognition": "" } } ] }
Odpověď
- tělo:
orders
(array) - pole objektů s objednávkyorder_number
(string) - číslo objednávkyorder_url
(string) - URL adresa kde se nachází objednávkaupdated_yn
(bool) - příznak jestli se objednávka aktualizovalamessages
(array) - pole objektů chybových zpráv a upozornění při zpracování objednávkyobject
(string) - název objektu (část JSONu) kterého se zpráva týkáproperty
(string) - hodnota které se zpráva týkámessage
(string) - text zprávy
-
příklad odpovědi (HTTP 200 OK)
HTTP/1.1 200 OK Content-Type: application/json { "orders": [ { "order_number": "", "order_url": "", "updated_yn": "", "messages": [ { "object": "", "property": "", "message": "" } ] } ] }
Smazání objednávek
- URI: /api/v2/orders/?order_number=
{order_number}
&order_numbers={order_numbers}
- HTTP metoda: DELETE
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
- parametry (musí být definovám alespoň jeden parametr):
order_number
(string) - číslo objednávkyorder_numbers
(string) - čísla objednávek oddělená středníkem;
Odpověď
- tělo:
orders
(array) - pole objektů s objednávkyorder_number
(string) - číslo objednávkydeleted_yn
(bool) - příznak jestli je objednávka smazanámessages
(array) - pole objektů chybových zpráv a upozornění při zpracování objednávkyobject
(string) - název objektu (část JSONu) kterého se zpráva týkáproperty
(string) - hodnota které se zpráva týkámessage
(string) - text zprávy
-
příklad odpovědi (HTTP 200 OK)
HTTP/1.1 200 OK Content-Type: application/json { "orders": [ { "order_number": "", "deleted": "", "messages": [ { "object": "", "property": "", "message": "" } ] } ] }
Seznam objednávek
- URI: /api/v2/orders/
{order_number}
?order_numbers={order_numbers}
&creation_time_from={creation_time_from}
&creation_time_to={creation_time_to}
&last_update_time_from={last_update_time_from}
&page={page}
&status={status}
&paid_yn={paid_yn}
- HTTP metoda: GET
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
- parametry - slouží pro filtrování výstupu:
order_number
(string) - číslo objednávkyorder_numbers
(string) - čísla objednávek oddělená středníkem;
creation_time_from
(date) - vrátí objednávky vytvořené od tohoto datacreation_time_to
(date) - vrátí objednávky vytvořené do tohoto data včetnělast_update_time_from
(date) - vrátí objednávky změněné od tohoto datapaid_yn
(bool) - pokud je 1, vrátí zaplacené objednávkystatus
(string) - stav objednávky, pokud bude prázdný, vrátí objednávky kde není žádný stavstatus_id
(int) - ID stavu objednávkylanguage
(language) - jazyková mutace na které objednávka vzniklaemail
(string) - email zákazníka objednávkypayment_type
(string) - typ platby, možné hodnoty jsou: cash - hotově cashOnDelivery - dobírka command - převodem moneybookers - skrill paypal - PayPal payu - PayU homecredit - Homecredit tatrapay - TatraPay tatracardpay - CardPay comgate - ComGate cetelem - Hello bank gopay - GoPay fio - Fio gpwebpay - GP webpay cofidis - Cofidis essox - Essox twisto - Twisto cashOnCashRegister - Hotově na pokladně cardOnCashRegister - Kartou na pokladně thepay - ThePay custom - Vlastníshipment_type
(string) - typ dopravy, možné hodnoty jsou:- ceskaPosta - Česká pošta
- slovenskaPosta - Slovenská pošta
- ulozenka - Uloženka
- zasilkovna - Zásilkovna
- dpd - DPD
- ppl - PPL
- gls - GLS
- custom - Vlastní doprava
page
(int) - stránka, pokud není definováno, vrací vždy stranu 1order_by
(string) - řazení, možné hodnoty jsou:- creation_time - seřadí podle času vytvoření
- last_update_time - seřadí podle času změny
order_dir
(string) - směr řazení, možné hodnoty jsou:- asc - vzestupně
- desc - sestupně
Odpověď
Seznam objednávek je dostupný po jednotlivých stranách, výstup je omezen na 100 položek na stránku.
-
tělo:
current_page
(int) - aktuální stranacurrent_page_items
(int) - počet položek na aktuální straněnumber_of_pages
(int) - celkový počet strannumber_of_items
(int) - celkový počet položekorders
(array) - pole objektů s objednávkamiorder_number
(string) - číslo objednávkycase_number
(string) - číslo obchodního případuexternal_order_number
(string) - číslo objednávky z externího systémulanguage_id
(language) - jazyk objednávkycurrency_id
(currency) - měna objednávkydefault_currency_rate
(currency) - kurz pro výchozí měnu. Přepočet ceny do výchozí měny provedete jako: cena * (1 /default_currency_rate
)prices_with_vat_yn
(bool) - příznak jestli jsou ceny s DPHstatus_id
(int) - ID stavu objednávkystatus
(string) - název stavu objednávkypaid_date
(date) - datum zaplacení objednávkytracking_code
(string) - trackovací kód pro dopravuresolved_yn
(bool) - příznak pro vyřešenou objednávkuoss_yn
(bool) - příznak jestli byla objednávka vytvořena v režimu OSSinternal_note
(string) - interní poznámkalast_update_time
(date) - datum aktualizacecreation_time
(date) - datum vytvořenívariable_symbol
(string) - variabilní symboltotal_weight
(int) - celková váha objednávkyorder_total
(float) - celková cena s DPHorder_total_before_round
(float) - celková cena s DPH před zaokrouhlenímorder_total_rest
(float) - hodnota zaokrouhlení celkové ceny s DPHinvoice_number
(string) - číslo fakturyorigin
(string) - původ vytvoření objednávky, možné hodnota jsou:- admin - vytvoření ručně v administraci
- frontend - vytvoření zákazníkem na eshopu
- api - vytvoření posláním dat přes API
- cash-register - vytvoření přes pokladnu
admin_url
(string) - URL do detailu objednávky v administracicustomer
(object) - zákazníkemail
(email) - email zákazníkaphone
(string) - telefoncode
(string) - zákaznické číslofirstname_invoice
(string) - fakturační jménosurname_invoice
(string) - fakturační příjmenístreet_invoice
(string) - fakturační ulice a číslocity_invoice
(string) - fakturační městostate_invoice
(string) - fakturační okreszip_invoice
(string) - fakturační PSČcountry_id_invoice
(country) - fakturační zeměpostal_yn
(bool) - příznak doručovací adresyfirstname_postal
(string) - doručovací jménosurname_postal
(string) - doručovací přijmenístreet_postal
(string) - doručovací ulice a číslocity_postal
(string) - doručovací městostate_postal
(string) - doručovací okreszip_postal
(string) - doručovací PSČcountry_id_postal
(country) - doručovací zeměcompany_postal
(string) - doručovací název firmycompany_yn
(bool) - příznak jestli je zákazník firmacompany
(string) - název firmyico
(string) - IČOdic
(string) - DIČvat_payer_yn
(bool) - příznak jestli je firma plátce DPHcustomer_note
(string) - poznámka zákazníkaagreements
(array) - pole objektů se souhlasyname
(string) - název souhlasuvalid_to
(date) - čas do kdy je souhlas platnýstatus
(bool) - stav souhlasu
products
(array) - pole objektů s produktyproduct_id
(int) - ID produktu z databáze (pouze orientačně, pro párování produktů sloužícode
)option_set_id
(int) - ID varianty z databáze (pouze orientačně, pro párování produktů sloužícode
). Bude vyplněno pouze tehdy, pokud je položka varianta produktu.code
(string) - kód produktu nebo varianty produktucode_supplier
(string) - kód dodavatele produktu nebo varianty produktuean
(string) - EAN produktu nebo varianty produktutitle
(string) - název produktuquantity
(float) - počet jednotekunit
(string) - jednotkalength
(string) - množstvílength_unit
(string) - jednotka množstvíprice_per_unit
(float) - cena za jednu jednotku produktu (cena je s nebo bez DPH podle přiznakuprices_with_vat_yn
)price
(float) - celková cena za produkt (cena je s nebo bez DPH podle přiznakuprices_with_vat_yn
)price_with_vat
(float) - celková cena za produkt s DPHprice_without_vat
(float) - celková cena za produkt bez DPHvat
(float) - hodnota DPH v %buy_price
(float) - nákupní cena za jednu jednotku produktuweight
(int) - váha jedné jednotky produktu v gramechavailability
(string) - dostupnost produktu ve chvíli kdy byl objednáninvoice_info
(string) - poznámka k produktu která se propisuje do fakturyparameters
(array) - pole objektů s parametry produktuname
(string) - název konfiguracevalue
(string) - hodnota parametru
configurations
(array) - pole objektů s konfiguracemi produktuname
(string) - název parametruvalues
(array) - pole hodnotvalue
(string) - hodnotaoperation
(string) - operace (+, -)cena
(float) - cena konfigurace (je již připočtena k ceně produktu)
discount_voucher
(object) - slevový kupóncode
(string) - kód slevového kuponutype
(string) - typ slevy, možné hodnoty jsoupercent
neboprice
amount
(float) - výše slevy, pokud je typ slevypercent
jsou to procenta, pokudprice
je to cenadiscounts
(array) - pole objektů se slevami rozpočínanými pro jednotliv hladiny DPHprice
(float) - hodnota slevyvat
(float) - DPH v %
quantity_discount
(object) - množstevní slevatype
(string) - typ slevy, možné hodnoty jsoupercent
neboprice
amount
(float) - výše slevy, pokud je typ slevypercent
jsou to procenta, pokudprice
je to cenadiscounts
(array) - pole objektů se slevami rozpočínanými pro jednotliv hladiny DPHprice
(float) - hodnota slevyvat
(float) - DPH v %
loyalty_points
(object) - věrnostní bodyone_point_for
(float) - hodnota (cena) jednoho boduamount
(float) - výše slevydiscounts
(array) - pole objektů se slevami rozpočínanými pro jednotliv hladiny DPHprice
(float) - hodnota slevyvat
(float) - DPH v %
shipment
(object) - dopravacode
(string) - kód dopravy, páruje se s kódem dopravy (ve vlastních polích) v administraciname
(string) - název dopravyprice
(float) - cena dopravyvat
(float) - hodnota DPH v %affiliate_id
(string) - ID pobočky dopravy
payment
(object) - platbacode
(string) - kód platby, páruje se s kódem platby (ve vlastních polích) v administraciname
(string) - název platbyprice
(float) - cena platbyvat
(float) - hodnota DPH v %eet_yn
(bool) - příznak jestli je se má poslat objednávka do EET
metas
(array) - pole objektů s vlastními polikey
(string) - klíč vlastního poletype
(string) - typ vlastního pole (hodnoty mohou být: radio, checkbox, input, date, email, number, select, multiselect, textarea, formatted)value
(string) - hodnota vlastního pole, v případě kdy je hodnota vlastního pole společná pro všechny jazykyvalues
(array) - pole objektů s hodnotami, v případě kdy není hodnota vlastního pole společná pro všechny jazykylanguage
(language) - specifikace jazykové mutacevalue
(string) - hodnota
-
příklad odpovědi (HTTP 200 OK)
HTTP/1.1 200 OK Content-Type: application/json { "current_page": "", "current_page_items": "", "number_of_pages": "", "number_of_items": "", "orders": [ { "order_number": "", "external_order_number": "", "language_id": "", "prices_with_vat_yn": "", "status_id": "", "status": "", "paid_date": "", "tracking_code": "", "resolved_yn": "", "internal_note": "", "last_update_time": "", "creation_time": "", "variable_symbol": "", "total_weight": "", "order_total": "", "order_total_before_round": "", "order_total_rest": "", "invoice_number": "", "origin": "", "customer": { "email": "", "phone": "", "code": "", "firstname_invoice": "", "surname_invoice": "", "street_invoice": "", "city_invoice": "", "state_invoice": "", "zip_invoice": "", "country_id_invoice": "", "postal_yn": "", "firstname_postal": "", "surname_postal": "", "street_postal": "", "city_postal": "", "state_postal": "", "zip_postal": "", "country_id_postal": "", "company_postal": "", "company_yn": "", "company": "", "ico": "", "dic": "", "vat_payer_yn": "", "customer_note": "", "agreements": [ { "name": "", "valid_to": "", "status": "" } ], }, "products": [ { "product_id": "", "option_set_id": "", "code": "", "code_supplier": "", "ean": "", "title": "", "unit": "", "length": "", "length_unit": "", "quantity": "", "price_per_unit": "", "price": "", "price_with_vat": "", "price_without_vat": "", "vat": "", "buy_price": "", "weight": "", "invoice_info": "", "parameters": [ { "name": "", "value": "" } ], "configurations": [ { "name": "", "values": [ { "value": "", "operation": "", "price": "" } ] } ] } ], "discount_voucher": { "code": "", "type": "", "amount": "", "discounts": [ { "vat": "", "price": "" } ] }, "quantity_discount": { "type": "", "amount": "", "discounts": [ { "vat": "", "price": "" } ] }, "loyalty_points": { "one_point_for": "", "amount": "", "discounts": [ { "vat": "", "price": "" } ] }, "shipment": { "name": "", "price": "", "vat": "", "affiliate_id": "" }, "payment": { "name": "", "price": "", "vat": "", "eet_yn": "" }. "metas": [ { "key": "", "type": "", "value": "", "values": { "cs": { "language": "cs", "value": "" } } } ] } ] }
PDF objednávka
Vrací dokument objednávky ve formátu PDF
- URI: /api/v2/orders/
{order_number}
/pdf - HTTP metoda: GET
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
-
parametry:
order_number
(string) - číslo objednávky
-
hlavičky odpovědi (HTTP 200 OK)
HTTP/1.1 200 OK Content-Type: application/pdf
Přidání záznamu do historie objednávky
Přidá záznam do historie objednávky. Jeden pořadavek znamená přidání jednoho záznamu do historie. Slouží hlavně pro systémy třetích stran, které chtějí informovat administrátora eshopu o tom, že proběhla nějaká událost. Čas události nelze upravovat, pokud chcete můžete si poslat čas v datech události.
- URI: /api/v2/orders/
{order_number}
/history - HTTP metoda: POST
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
-
parametry:
order_number
(string) - číslo objednávky
-
tělo:
data
(array) - pole objektů daty historiename
(string) - název, ořízne se na délku max. 50 znaků a odstraní se HTML značkyvalue
(string) - hodnota, ořízne se na délku max. 500 znaků a odstraní se HTML značky
-
příklad požadavku
PUT /api/v2/orders HTTP/1.1 Content-Type: application/json Authorization: Basic dGVzdDp0ZXN0 { "data": [ { "name": "", "value": "" } ] }
Historie objednávky
Vrací seznam událostí z historie objednávky. Data historie mohou obsahovat HTML značky.
- URI: /api/v2/orders/
{order_number}
/history - HTTP metoda: GET
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
- parametry:
order_number
(string) - číslo objednávky
Odpověd
- tělo:
number_of_items
(int) - počet položek historiehistory
(array) - pole objektů s událostmi historieevent
(string) - název událostiuser_name
(string) - jméno uživatele který událost provedlchanges
(object) - pole objektů se změnaminame
(string) - název zněnybefore
(string) - hodnota před změnouafter
(string) - hodnota po změně
admin_yn
(bool) - příznak jestli událost pochází z eshopu, nebo z administrace. Pokud pochází událost z API, budetrue
data
(array) - pole objektů s datyname
(string) - názevvalue
(string) - hodnota
creation_time
(datetime) - čas události
Stavy objednávky
Vrací seznam stavů objednávek. V požadavku pro aktualizaci nebo vytvoření objednávky se dá použít název stavu v jakémkoliv jazyce.
- URI: /api/v2/orders/states
- HTTP metoda: GET
- hlavičky:
Authorization: Basic dGVzdDp0ZXN0
Content-Type: application/json
- tělo:
states
(array) - pole objektů se stavyid
(int) - ID stavutype
(string) - typ stavu, pokud je hodnotanull
, tak se jedná o vlastní stav, jinak to jsou systémové stavy:- Received - Přijatá
- Canceled - Storno
- PaymentSuccessful - Platba úspěšná
- PaymentFailed - Platba selhala
- PaymentCanceled - Platba zrušena
- PaymentInProcess - Platba probíhá
- Unresolved - Nedořešená
color
(string) - barva pro odlišení stavu v HTML HEX formátunames
(object) - názvy stavu objednávky v jednotlivých jazycích, klíč v objektu je kód jazyka podle ISO 8601 a hodnota je název stavu např.{ "cz": "Přijatá" }
-
příklad odpovědi (HTTP 200 OK)
HTTP/1.1 200 OK Content-Type: application/json { "states": [ { "id": "", "type": "", "color": "", "names": { } } ] }