API Dokumentace

Aktuální "TOKEN" najdete ve Vaší administraci. PHP příklad napojení: vložení objednávky, čtení objednávek.

Popis:

seznam vašich aktivních obchodů

Úplná adresa:

https://client.api.dropshipping.cz/v1/eshops

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/eshops HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "Můj obchod",
            "www": "http://www.mujobchod.cz",
            "product_xml": "https://www.dropshipping.cz/.../",
        }
    ]
}
			
Popis polí odpovědi:
Klíč Typ Komentář
id int ID obchodu
name string Název obchodu
www string WWW obchodu
product_xml string URL XML zdroje produktů vašeho obchodu
Popis:

seznam aktivních produktů vašeho obchodu

Úplná adresa:

https://client.api.dropshipping.cz/v1/products?eshop_id=1&limit=30&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/products?eshop_id=1&limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
eshop_id int ANO ID obchodu
id int NE ID produktu (pro zobrazení konretního produktu)
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 30. Maximální hodnota je neomezená.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "group_id": 1,
            "manufacturer_id": 1,
            "name": "Plavky AF (červené + černá) - L 90-100 cm",
            "product_name": "Plavky AF (červené + černá)",
            "variant_name": "L 90-100 cm",
            "description": "...",
            "description_html": "...",
            "code": "DS46689145",
            "ext_code": "DZ411",
            "ean": "1010121353001",
            "price_retail": 185.95,
            "price_retail_vat": 214,
            "price_wholesale": 121.49,
            "price_wholesale_vat": 146,
            "minimal_price_retail": 185.95,
            "minimal_price_retail_vat": 214,
            "vat": 21,
            "clearance": true,
            "warehouse_quantity": 1,
            "delivery_date": 0,
            "inhouse_quantity": 0,
            "partner_quantity": 1,
            "partner_delivery_date": 0,
            "preview_image": "http://www.eshop.cz/img/9841.jpg",
            "categories": ["1","2"],
            "images": [
                "http://www.eshop.cz/img/9841.jpg",
                "http://www.eshop.cz/img/9842.jpg",
                "http://www.eshop.cz/img/9843.jpg",
            ],
            "parameters": [
                {
                    id: 1,
                    key: "color",
                    value: "černá",
                },
                {
                    id: 2,
                    key: "size",
                    value: "XL",
                },
            ],
            "special_delivery_prices": [
                {
                    delivery_id: 13,
                    type: "atyp",
                }
            ],
            "blacklisted_delivery_ids": [10,14,24]
        }
    ]
}
		
Popis polí odpovědi:
Klíč Typ Komentář
id int ID produktu
group_id int|null Označení skupiny produktů, které vzájemně představují varianty. Pokud je hodnota null, produkt nemá žádné varianty.
manufacturer_id int|null ID výrobce produktu. Pokud je hodnota null, výrobce je neznámý.
name string Název produktu včetně názvu varianty (oddělené "-")
product_name string Název produktu bez varianty
variant_name string Název varianty
description string Popis produktu
description_html string HTML popis produktu
code string Kód produktu v systému Dropshipping.cz
ext_code string Kód produktu dodavatele
ean string|null EAN produktu. Pokud je hodnota null, EAN je neznámý.
price_retail float Maloobchodní cena bez DPH
price_retail_vat float Maloobchodní cena s DPH
minimal_price_retail float Minimální maloobchodní cena bez DPH
minimal_price_retail_vat float Minimální maloobchodní cena s DPH
price_wholesale float Velkooobchodní cena bez DPH
price_wholesale_vat float Velkooobchodní cena s DPH
vat int DPH
clearance bool Likvidace
warehouse_quantity int|null Počet kusů skladem. Pokud je hodnota neznámá, vrací null.
delivery_date int|null Dodací doba produktu ve dnech. 0 = produkt je skladem. Maximální hodnota = 60. Pokud je hodnota neznámá, vrací null.
inhouse_quantity int Počet kusů na skladech interních dropshipping.cz.
partner_quantity int|null Počet kusů skladem u dodavatele. Pokud je hodnota neznámá, vrací null.
partner_delivery_date int|null Dodací doba produktu u dodavatele ve dnech. 0 = produkt je skladem. Maximální hodnota = 60. Pokud je hodnota neznámá, vrací null.
preview_image string Celá adresa náhledového obrázku
categories array Pole ID kategorií
images array Pole URL všech obrázků
parameters array Pole parametrů produktů.
special_delivery_prices array Pole doručovacích metod, pro které má produkt nestandartní cenu ("atyp" nebo "oversized", viz sekce Doručovací metody).
blacklisted_delivery_ids array Pole ID doručovacích metod, kterými nelze produkt zákazníkovi odeslat.
Popis:

seznam aktivních kategorií produktů vašeho obchodu

Úplná adresa:

https://client.api.dropshipping.cz/v1/products/categories?eshop_id=1

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/products/categories?eshop_id=1 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
eshop_id int ANO ID obchodu
limit int NE Počet požadovaných záznamů. Defaultně se vypisují všechny kategorie.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "parent": 0,
            "name": "Pánské oblečení"
        }
    ]
}
		
Popis polí odpovědi:
Klíč Typ Komentář
id int ID kategorie
parent int ID nadřazené kategorie. Nejvyšší stupeň kategorií je zapsán jako parent = 0.
name string Název kategorie
Popis:

seznam výrobců produktů vašeho obchodu

Úplná adresa:

https://client.api.dropshipping.cz/v1/products/manufacturers?eshop_id=1

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/products/manufacturers?eshop_id=1 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
eshop_id int ANO ID obchodu
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 30.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "Nike"
        }
    ]
}
		
Popis polí odpovědi:
Klíč Typ Komentář
id int ID
name string Název
Popis:

seznam parametrů produktů vašeho obchodu

Úplná adresa:

https://client.api.dropshipping.cz/v1/products/parameters?eshop_id=1

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/products/parameters?eshop_id=1 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
eshop_id int ANO ID obchodu
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 30.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "key": "color",
            "name": "Barva"
        }
    ]
}
		
Popis polí odpovědi:
Klíč Typ Komentář
id int ID
key string Textový, unikátní identifikátor
name string Název
Popis:

seznam aktivních platebních metod vašeho obchodu

Úplná adresa:

https://client.api.dropshipping.cz/v1/payments?eshop_id=1

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/payments?eshop_id=1 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis polí požadavku:
Klíč Typ Povinné Komentář
eshop_id int ANO ID obchodu
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "Hotově",
            "price": 87.23,
            "price_vat": 89,
            "vat": 21,
            "permitted_delivery": ["1","2"]
        }
    ]
}
			
Popis polí odpovědi:
Klíč Typ Komentář
id int ID platební metody
name string Název
price float Cena bez DPH
price_vat float Cena s DPH
vat_id int DPH
permitted_delivery[] array Pole povolených ID kombinací doručovacích metod
Popis:

seznam aktivních doručovacích metod vašeho obchodu

Úplná adresa:

https://client.api.dropshipping.cz/v1/deliveries?eshop_id=1

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/deliveries?eshop_id=1 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
eshop_id int ANO ID obchodu
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "Česká pošta",
            "price": 87.23,
            "price_vat": 89,
            "price_atyp": null,
            "price_atyp_vat": null,
            "price_oversized": null,
            "price_oversized_vat": null,
            "vat": 21,
            "has_place": 1,
            "permitted_payment": ["1","2"]
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID doručovací metody
name string Název
price float Cena bez DPH
price_vat float Cena s DPH
price_atyp float|NULL Speciální cena bez DPH za produkty, označené jako "atyp"
price_atyp_vat float|NULL Speciální cena s DPH za produkty, označené jako "atyp"
price_oversized float|NULL Speciální cena bez DPH za produkty, označené jako "oversized"
price_oversized_vat float|NULL Speciální cena s DPH za produkty, označené jako "oversized"
vat_id int DPH
has_place int Údaj o tom, jestli konkrétní způsob dopravy vyžaduje zaslání odběrného místa (0 = NE; 1 = ANO). Viz také "Doručovací metody - odběrné místa"
permitted_delivery[] array Seznam povolených ID kombinací platebních metod
Popis:

seznam aktivních odběrných míst konkrétní doručovací metody

Úplná adresa:

https://client.api.dropshipping.cz/v1/delivery-places?delivery_id=1&limit=30&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/delivery-places?delivery_id=1&limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
delivery_id int ANO ID doručovací metody
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 30. Maximální hodnota je neomezená.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "ext_id": 321,
            "place": "Zásilkovna s.r.o.",
            "street": "Vltavská 277/28",
            "city": "Praha",
            "zipcode": "150 00",
            "region_name": "Hlavní město Praha",
            "lat": "50.06980",
            "lon": "14.40607",
            "url": "http://www.zasilkovna.cz/point/praha-5-andel",
            "note": "",
            "direction": "Pobočka se nachází na v Praze na Smíchově 50 m od autobusového nádraží Na Knížecí.",
            "direction_car": "před pobočkou nelze parkovat. Je možné zaparkovat v ulicích Jindřich Plachty, nebo Staropramenná, jsou však dost plné. Jistější je zaparkovat v podzemních garážích pod Albertem - vjezd z ulice Bozděchova (200m), nebo na hlídaném parkovišti vedle polikliniky - vjezd z ulice Stroupežnického (200m), nebo na hlídaném parkovišti vedle aut. nádraží - vjezd z ulice Za ženskými domovy (200m)",
            "direction_public": "Pobočka se nachází 200m od východu z metra Anděl - Výstup na Knížecí",
            "opening_hour_short_html": "<strong>Po–Pá</strong> 10:00–19:00<br /><strong>So</strong> 10:00–15:00</span>",
            "opening_hour_table_html": "<table class="packetery-hours"><tr><th>Po</th><td>10:00–19:00</td></tr><tr><th>Út</th><td>10:00–19:00</td></tr><tr><th>St</th><td>10:00–19:00</td></tr><tr><th>Čt</th><td>10:00–19:00</td></tr><tr><th>Pá</th><td>10:00–19:00</td></tr><tr><th>So</th><td>10:00–15:00</td></tr><tr><th>Ne</th><td></td></tr></table>",
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID odběrného místa (v systému dropshipping.cz)
ext_id int ID odběrného místa externí služby (ze systému provozovatele)
place string Název konkrétní pobočky
street string Ulice
city string Město
zipcode string PSČ
region_name string Kraj
lat string GPS souřadnice latitude
lon string GPS souřadnice longitude
url string URL adresa detailu pobočky na stránkách zasilkovna.cz
note string Poznámka
direction string Popis polohy pobočky
direction_car string Popis k nalezení pobočky autem
direction_public string Popis k nalezení pobočky pěšky
opening_hour_short_html string HTML tabulka otevíracích hodin, zkrácená
opening_hour_table_html string HTML tabulka otevíracích hodin
Popis:

seznam všech stavů objednávek

Úplná adresa:

https://client.api.dropshipping.cz/v1/order-statuses

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/order-statuses HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "name": "Příjatá",
            "active": true,
        }
    ]
}
			
Popis polí odpovědi:
Klíč Typ Komentář
id int ID stavu
name string Název stavu
active bool Jedná se o aktivní stav?
Popis:

vkládání objednávek

Úplná adresa:

https://client.api.dropshipping.cz/v1/orders

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/orders HTTP/1.1
Authorization: TOKEN
Accept: application/json

{
    "remote_id": "123456789",
    "auto_resend": 1,
    "eshop_id": 1,
    "email": "jan.novak@gmail.com",
    "phone": "777 777 777",
    "invoice_firstname": "Jan",
    "invoice_surname": "Novák",
    "invoice_street": "Korunní 21",
    "invoice_city": "Praha 2",
    "invoice_zipcode": "128 00",
    "invoice_company": "Jan Novak",
    "invoice_ico": "123456",
    "invoice_dic": "654321",
    "contact_like_invoice": "0",
    "contact_firstname": "Jana",
    "contact_surname": "Nováková",
    "contact_street": "Vinohradská 47",
    "contact_city": "Praha 2",
    "contact_zipcode": "128 00",
    "contact_company": "Jan Novak",
    "contact_ico": "123456",
    "contact_dic": "654321",
    "zpl_note": "Pro nejlepšího dědu",
    "note": "",
    "payment_id": "",
    "payment_price_vat": "",
    "delivery_id": "",
    "delivery_price_vat": "",
    "delivery_place_id": 1,
    "delivery_place_ext_id": NULL,
    "basket": [
        {
            "id": 1,
            "code": "DS12345678",
            "price_retail_vat": 123.00,
            "quantity": 3,
            "note": "zelená varianta",
        }
    ],
    "inserts": [
        {
            "id": 1,
            "code": "DS12345678",
            "quantity": 3,
        }
    ],
    "test": "0",
}

Popis polí požadavku:
Klíč Typ Povinné Komentář
remote_id string (36)|NULL NE Unikátní identifikátor z Vašeho systému. Např. číslo objednávky. Použitím tohoto paremetru zamezíte vzniku duplicitních objednávek.
auto_resend int|NULL NE Má se objednávka poslat dále ke zpracování nebo má čekat na Vaše potvrzení? Pokud nebude parametr uveden, objednávka bude vždy automaticky poslána ke zpracování. (0 = NE; 1 = ANO)
eshop_id int ANO ID vašeho obchodu
email string ANO E-mail zákazníka
phone string ANO Telefon zákazníka
invoice_firstname string ANO Fakturační jméno zákazníka
invoice_surname string ANO Fakturační příjmení zákazníka
invoice_street string ANO Fakturační ulice zákazníka
invoice_city string ANO Fakturační město zákazníka
invoice_zipcode string ANO Fakturační PSČ zákazníka
invoice_company string NE Fakturační společnost zákazníka
invoice_ico string NE Fakturační IČO zákazníka
invoice_dic string NE Fakturační DIČ zákazníka
contact_like_invoice int ANO Doručovací adresa stejná jako fakturační (0 = NE; 1 = ANO)
contact_firstname string NE Doručovací jméno zákazníka
contact_surname string NE Doručovací příjmení zákazníka
contact_street string NE Doručovací ulice zákazníka
contact_city string NE Doručovací město zákazníka
contact_zipcode string NE Doručovací PSČ zákazníka
contact_company string NE Doručovací společnost zákazníka
contact_ico string NE Doručovací IČO zákazníka
contact_dic string NE Doručovací DIČ zákazníka
note string NE Poznámka k objednávce
zpl_note string|NULL NE Poznámka na balík s maximálním počtem 23 znaků. Pokud bude parametr vynechán nebo NULL, bude použita defaultní poznámka nastavená u obchodu.
payment_id int ANO ID aktivní platební metody partnera
payment_price_vat float ANO Cena platební metody s DPH
delivery_id int ANO ID aktivní doručovací metody partnera
delivery_place_id1 int|NULL NE ID odběrného místa (ze systému dropshipping.cz). Viz Doručovací metody - odběrné místa
delivery_place_ext_id1 int|NULL NE ID odběrného místa (z externí služby, například zasilkovna.cz).
delivery_price_vat float ANO Cena doručovací metody s DPH
basket array ANO pole produktů v košíku
basket.id int Podm. ID aktivního produktu dodavatele. Nepovinné, pokud je uveden kód produktu
basket.code string Podm. Kód aktivního produktu dodavatele. Nepovinné, pokud je uvedeno ID produktu
basket.price_retail_vat float ANO Cena produktu s DPH
basket.quantity int ANO Počet kusů produktu
basket.note string NE Poznámka konkrétního produktu
inserts array NE pole insertů objednávky
inserts.id int Podm. ID aktivního produktu. Nepovinné, pokud je uveden kód produktu
inserts.code string Podm. Kód aktivního produktu. Nepovinné, pokud je uvedeno ID produktu
inserts.quantity int ANO Počet kusů insertu
test int NE Testovací objednávka. V případě označení objednávky jako testovací ("test": "1"), nebude objednávka předána dodavateli.

1 pro vložení odběrného místa můžete použít buď ID z naší databáze, nebo ID z databáze poskytovatele služby. Objednávka bude přijata i v případě, že žádná ID nepošlete, i když to konkrétní způsob dopravy vyžaduje. V tomto případě ale nebude objednávka předána dále dodavateli a klient bude vyzván k doplnění tohoto místa v administraci.


JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "id": 1,
    "eshop_id": 1,
    "serial_number": "1-0002",
    "variable_symbol": ""1-0002"",
    "email": "jan.novak@gmail.com",
    "phone": "777 777 777",
    "invoice_firstname": "Jan",
    "invoice_surname": "Novák",
    "invoice_street": "Korunní 21",
    "invoice_city": "Praha 2",
    "invoice_zipcode": "128 00",
    "invoice_company": "Jan Novak",
    "invoice_ico": "123456",
    "invoice_dic": "654321",
    "contact_like_invoice": "0",
    "contact_firstname": "Jana",
    "contact_surname": "Nováková",
    "contact_street": "Vinohradská 47",
    "contact_city": "Praha 2",
    "contact_zipcode": "128 00",
    "contact_company": "Jan Novak",
    "contact_ico": "123456",
    "contact_dic": "654321",
    "note": "",
    "payment": {
        "id": 1,
        "name": Dobírka,
        "price": 64.95,
        "price_vat": 79,
        "gateway_link": "https://www.platbaobjednavky.cz/zaplatit/rk7nq9xkq53ecr1moix0imc8u54hvf0gekmkjekg31oij8ju4icutmo5e8kf66rb",
        "qr_code": "https://www.dropshipping.cz/api/open/order/v4ij79tvrnyb0ms4yslz0ttfaom0ykf1xs1v5hp9jcylafah4nz60fy93lw8fhvv/qr-payment.png",
    },
    "delivery": {
        "id": 1,
        "name": Intime,
        "price": 64.95,
        "price_vat": 79,
    },
    "basket": [
        {
            "id": 1,
            "name": 3D kreslená kabelka,
            "code": 1-ZS190,
            "price_retail": 338.84,
            "price_retail_vat": 410,
            "quantity": 9,
        }
    ],
    "inserts": [
        {
            "id": 1,
            "name": 3D kreslená kabelka,
            "code": 1-ZS190,
            "quantity": 9,
        }
    ],
    "created": "2015-04-04 16:30:19",
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID objednávky
eshop_id int ID vašeho obchodu
serial_number string Číslo objednávky
variable_symbol string Variabilní symbol
email string E-mail zákazníka
phone string Telefon zákazníka
invoice_firstname string Fakturační jméno zákazníka
invoice_surname string Fakturační příjmení zákazníka
invoice_street string Fakturační ulice zákazníka
invoice_city string Fakturační město zákazníka
invoice_zipcode string Fakturační PSČ zákazníka
invoice_company string Fakturační společnost zákazníka
invoice_ico string Fakturační IČO zákazníka
invoice_dic string Fakturační DIČ zákazníka
contact_like_invoice int Doručovací adresa stejná jako fakturační (0 = NE; 1 = ANO)
contact_firstname string Doručovací jméno zákazníka
contact_surname string Doručovací příjmení zákazníka
contact_street string Doručovací ulice zákazníka
contact_city string Doručovací město zákazníka
contact_zipcode string Doručovací PSČ zákazníka
contact_company string Doručovací společnost zákazníka
contact_ico string Doručovací IČO zákazníka
contact_dic string Doručovací DIČ zákazníka
note string Poznámka k objednávce
payment array Platební metoda
delivery array Doručovací metoda
basket array Pole produktů v košíku
inserts array Pole insertů
created string Datum a čas vytvoření objednávky (Y-m-d H:i:s)
Popis:

seznam vašich objednávek

Úplná adresa:

https://client.api.dropshipping.cz/v1/orders?eshop_id=1&limit=30&offset=0&sort=-created

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/orders?eshop_id=1&limit=30&offset=0&sort=-created HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
eshop_id int NE ID obchodu (pro zobrazení objednávek konkrétního obchodu)
id int NE ID objednávky (pro zobrazení konretního objednávky)
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 30. Maximální hodnota = 100.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string NE Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=created" = "created ASC"; "sort=-created" = "created DESC"). Defaultní řazení je "id ASC".
created_from string NE Určuje datum, od kterého se mají objednávky vyhledat. Formát yyyy-mm-dd (např. 2017-01-01).
created_to string NE Určuje datum, do kterého se mají objednávky vyhledat. Formát yyyy-mm-dd (např. 2017-01-01).
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "data": [
        {
            "id": 1,
            "remote_id": "123456789",
            "eshop_id": 1,
            "status_id": 1,
            "serial_number": "1-0002",
            "variable_symbol": ""1-0002"",
            "email": "jan.novak@gmail.com",
            "phone": "777 777 777",
            "invoice_firstname": "Jan",
            "invoice_surname": "Novák",
            "invoice_street": "Korunní 21",
            "invoice_city": "Praha 2",
            "invoice_zipcode": "128 00",
            "invoice_company": "Jan Novak",
            "invoice_ico": "123456",
            "invoice_dic": "654321",
            "contact_like_invoice": "0",
            "contact_firstname": "Jana",
            "contact_surname": "Nováková",
            "contact_street": "Vinohradská 47",
            "contact_city": "Praha 2",
            "contact_zipcode": "128 00",
            "contact_company": "Jan Novak",
            "contact_ico": "123456",
            "contact_dic": "654321",
            "note": "",
            "paid": true,
            "commision_status": 1,
            "commision": 54.90,
            "balance": 14.90,
            "payment": {
                "id": 1,
                "name": Dobírka,
                "price": 64.95,
                "price_vat": 79,
                "gateway_link": "https://www.platbaobjednavky.cz/zaplatit/rk7nq9xkq53ecr1moix0imc8u54hvf0gekmkjekg31oij8ju4icutmo5e8kf66rb",
                "qr_code": "https://www.dropshipping.cz/api/open/order/v4ij79tvrnyb0ms4yslz0ttfaom0ykf1xs1v5hp9jcylafah4nz60fy93lw8fhvv/qr-payment.png",
            },
            "delivery": {
                "id": 1,
                "name": Intime,
                "price": 64.95,
                "price_vat": 79,
            },
            "tracking": {
                "number": Z1051590747,
                "link": http://www.zasilkovna.cz/vyhledavani?id=Z1051590747,
            },
            "proforma_invoice": {
                "link": https://www.dropshipping.cz/...,
            },
            "invoice": {
                "link": https://www.dropshipping.cz/...,
            },
            "basket": [
                {
                    "id": 1,
                    "name": 3D kreslená kabelka,
                    "code": 1-ZS190,
                    "price_retail": 338.84,
                    "price_retail_vat": 410,
                    "quantity": 9,
                    "reserved_quantity": 8,
                    "note": zelená varianta,
                }
            ],
            "inserts": [
                {
                    "id": 1,
                    "name": 3D kreslená kabelka,
                    "code": 1-ZS190,
                    "quantity": 9,
                }
            ],
            "created": "2015-04-04 16:30:19",
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID objednávky
remote_id string (36)|NULL Unikátní identifikátor z Vašeho systému. Např. číslo objednávky.
eshop_id int ID vašeho obchodu
status_id int ID stavu objednávky
serial_number string Číslo objednávky
variable_symbol string Variabilní symbol
email string E-mail zákazníka
phone string Telefon zákazníka
invoice_firstname string Fakturační jméno zákazníka
invoice_surname string Fakturační příjmení zákazníka
invoice_street string Fakturační ulice zákazníka
invoice_city string Fakturační město zákazníka
invoice_zipcode string Fakturační PSČ zákazníka
invoice_company string Fakturační společnost zákazníka
invoice_ico string Fakturační IČO zákazníka
invoice_dic string Fakturační DIČ zákazníka
contact_like_invoice int Doručovací adresa stejná jako fakturační (0 = NE; 1 = ANO)
contact_firstname string Doručovací jméno zákazníka
contact_surname string Doručovací příjmení zákazníka
contact_street string Doručovací ulice zákazníka
contact_city string Doručovací město zákazníka
contact_zipcode string Doručovací PSČ zákazníka
contact_company string Doručovací společnost zákazníka
contact_ico string Doručovací IČO zákazníka
contact_dic string Doručovací DIČ zákazníka
note string Poznámka k objednávce
paid bool Je objednávka zaplacená?
commision_status int|NULL Je schválena provize za objednávku? (null = provize čeká na schválení; 0 = provize byla zamítnuta; 1 = provize byla schválena)
commision float Potencionální, čistá, provize z objednávky
balance float Aktuální součet zisků a ztrát objednávky
payment array Platební metoda
delivery array Doručovací metoda
tracking array|NULL Sledovací číslo a odkaz na stav zásilky
proforma_invoice array Odkaz pro stažení zálohové faktury
invoice array|NULL Odkaz pro stažení faktury
basket array Pole produktů v košíku
inserts array Pole insertů
created string Datum a čas vytvoření objednávky (Y-m-d H:i:s)

Fulfillment

Popis:

seznam vašich objednávek

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/orders?limit=10&offset=0&sort=-created

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/orders?limit=30&offset=0&sort=-created HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string NE ID objednávky (pro zobrazení konrétní objednávky)
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 30. Maximální hodnota = 100.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string NE Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=created" = "created ASC"; "sort=-created" = "created DESC"). Defaultní řazení je "created ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 10,
    "data": [
        {
            "id": "da8bfbcb-5916-4416-b310-ce8ce6c0c63f",
            "number": "FF291015",
            "remote_number": "123456789",
            "recipient": {
                "email": "zakaznik@gmail.com",
                "phone": "777666555",
                "firstname": "Jan",
                "surname": "Novák",
                "street": "Korunní 21",
                "city": "Praha 2",
                "zipcode": "12800",
                "company": ""
            },
            "delivery": {
                "id": 25,
                "value": 999.0,
                "name": "DPD",
                "tracking_number": "xyz",
                "status": "inTransit"
            },
            "payment": {
                "cod": true,
                "variable_symbol": "1234567890",
                "price": 1001
            },
            "products": [
                {
                    "name": "Horké kameny",
                    "image": "https://dscdn.cz/images/d/e/a/b/0/8/0/c/8/9/7c65758192e4f827ecxyz.png",
                    "code": "DS12345678",
                    "ext_code": null,
                    "quantity": 3
                }
            ],
            "invoice": "JVBERi0xLjMNCiXi48/TDQoNCjE...",
            "note": "Poznámka",
            "tickets": [
                {
                    "barcode": "DR0705127648C",
                    "data": "^XA..."
                }
            ],
            "created": "2019-03-17 14:26:45"
        }
    ]
}
Popis:

vkládání objednávek

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/orders

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/orders HTTP/1.1
Authorization: TOKEN
Accept: application/json

{
    "recipient": {
        "email": "zakaznik@gmail.com",
        "phone": "777666555",
        "firstname": "Jan",
        "surname": "Novák",
        "street": "Korunní 21",
        "city": "Praha 2",
        "zipcode": "12800",
        "company": ""
    },
    "delivery": {
        "id": 25,
        "value": 999.0,
        "place_id": null,
        "place_ext_id": null
    },
    "payment": {
        "cod": true,
        "variable_symbol": "1234567890",
        "price": 1001
    },
    "products": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "quantity": 3
        }
    ],
    "remote_number": "123456789",
    "invoice": "JVBERi0xLjMNCiXi48/TDQoNCjE...",
    "note": "Poznámka",
    "tickets": [
        {
            "barcode": "DR0705127648C",
            "data": "^XA..."
        }
    ],
}

Popis polí požadavku:
Klíč Typ Povinné Komentář
recipient.email string ANO E-mail zákazníka
recipient.phone string ANO Telefon zákazníka
recipient.firstname string ANO Jméno zákazníka
recipient.surname string ANO Příjmení zákazníka
recipient.street string ANO Ulice zákazníka
recipient.city string ANO Město zákazníka
recipient.zipcode string ANO PSČ zákazníka
recipient.company string NE Společnost zákazníka
delivery.id int ANO ID doručovací metody
delivery.value float ANO Hodnota zboží v objednávce v Kč
delivery.place_id1 int|NULL NE ID odběrného místa (ze systému dropshipping.cz). Viz Doručovací metody - odběrné místa
delivery.place_ext_id1 int|NULL NE ID odběrného místa (z externí služby, například zasilkovna.cz).
payment.cod bool ANO Je objednávka na dobírku?
payment.variable_symbol string|NULL Podm. Variabilní symbol. Povinné v případě, že je objednávka na dobírku.
payment.price float ANO Částka k zaplacení. V případě, že je objednávka zaplacena předem pošlete 0.
products[].code string|NULL Podm. Kód produktu ze systému dropshipping.cz. Nepovinné, pokud je uvedeno ext_code produktu
products[].ext_code string|NULL Podm. Kód produktu dodavatele. Nepovinné, pokud je uvedeno code produktu
products[].quantity int ANO Počet kusů produktu
remote_number string ANO Číslo objednávky z Vašeho systému
invoice string|NULL NE PDF faktura jako base64 encode string.
note string NE Poznámka
tickets[] array NE Odeslání zásilky přes vlastního dopravce. Vlastní štítky (ve formátu ZPL) používejte pouze na základě předchozí dohody s technickou podporou dropshipping.cz.
tickets[].barcode string ANO Sledovací číslo balíku. Musí se shodovat s čárovým kódem na štítku.
tickets[].data string ANO ZPL kód balíku

1 pro vložení odběrného místa můžete použít buď ID z naší databáze, nebo ID z databáze poskytovatele služby. Objednávka bude přijata i v případě, že žádná ID nepošlete, i když to konkrétní způsob dopravy vyžaduje. V tomto případě ale nebude objednávka předána dále dodavateli a klient bude vyzván k doplnění tohoto místa v administraci.


JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "id": "da8bfbcb-5916-4416-b310-ce8ce6c0c63f"
}
Popis polí odpovědi:
Klíč Typ Komentář
id string UUID objednávky v systému dropshipping.cz
Popis:

odeslání objednávky k expedici

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/orders?id=da8bfbcb-5916-4416-b310-ce8ce6c0c63f

JSON požadavek:

PATCH https://client.api.dropshipping.cz/v1/fulfillment/orders?id=da8bfbcb-5916-4416-b310-ce8ce6c0c63f HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď:

HTTP/1.1 200


Popis:

seznam produktů

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products?limit=100&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/products?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string NE ID produktu (pro zobrazení pouze konkrétního produktu)
code string NE DS kód varianty
ext_code string NE Kód dodavatele varianty
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 100.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string NE Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=name" = "name ASC"; "sort=-name" = "name DESC"). Defaultní řazení je "name ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "category_id": 1,
            "name": "Horké kameny",
            "description": "Popis",
            "description_html": "<strong>Popis</strong>",
            "variants": [
                {
                    "id": 1,
                    "name": "červené",
                    "code": "DS12345678",
                    "ext_code": "xyz",
                    "ean": "...",
                    "dropshipping": "private",
                    "clearance": false,
                    "purchase_price": null,
                    "price_wholesale": 43.21,
                    "price_retail": 81.81,
                    "price_retail_vat": 99,
                    "vat": 21,
                    "preview_image": "https://dscdn.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131b.png",
                    "partner_warehouse_quantity": 3,
                    "partner_delivery_date": 0,
                    "inventory": {
                        "quantity": 3,
                        "reserved_quantity": 1,
                        "requested_quantity": 0,
                        "price_per_unit": 81.81,
                        "location": "A123"
                    }
                },
                {
                    "id": 2,
                    "name": "černé",
                    "code": "DS12345679",
                    "ext_code": "xzy",
                    "ean": "...",
                    "dropshipping": "public",
                    "clearance": false,
                    "purchase_price": null,
                    "price_wholesale": 43.21,
                    "price_retail": 81.81,
                    "price_retail_vat": 99,
                    "vat": 21,
                    "preview_image": "https://dscdn.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131c.png",
                    "partner_warehouse_quantity": null,
                    "partner_delivery_date": null,
                    "inventory": {
                        "quantity": 0,
                        "reserved_quantity": 0,
                        "requested_quantity": 2,
                        "price_per_unit": 81.81,
                        "location": "A123"
                    }
                }
            ]
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID produktu
category_id int|NULL ID kategorie (pokud je produkt do kategorie zařazen).
name string Název produktu
description string Popis produktu
description_html string HTML popis produktu
variants.id int ID varianty
variants.name string Název varianty
variants.code string DS kód varianty
variants.ext_code string Váš kód varianty
variants.ean string EAN varianty
variants.dropshipping string Bude varianta nabízena také ostatním uživatelům systému nebo je vavrianta pouze pro vás? Hodnoty "private" nebo "public"
variants.clearance bool Varianta v likvidaci. Slouží primárně pro označení produktů, u kterých se nepočíta s dalším doskladňováním
variants.purchase_price float|NULL Nákupní cena varianty bez DPH
variants.price_wholesale float|NULL Velkoobchodní cena varianty bez DPH
variants.price_retail float|NULL Doporučená maloobchodní cena varianty bez DPH
variants.price_retail_vat int|NULL Doporučená maloobchodní cena varianty s DPH
variants.vat int DPH
variants.preview_image string Obrázek varianty
variants.partner_warehouse_quantity int|NULL Počet kusů skladem u dodavatele. NULL = produkt je skladem s neznámým přesným počtem kusů
variants.partner_delivery_date int|NULL Počet dní k naskladnění u dodavatele (v případě že není produkt skladem). 0 = je skladem, 60 = produkt již nebude naskladněn
variants.inventory.quantity int Počet kusů skladem celkem (pro dostupný počet kusů nezapomeňte odečíst "reserved_quantity")
variants.inventory.reserved_quantity int Počet rezervovaných kusů pro nevyřízené objednávky
variants.inventory.requested_quantity int Počet žádostí (ks) o variantu pro nevyřízené objednávky
variants.inventory.price_per_unit float|NULL Průměrná cena za kus
variants.inventory.location string Umístění na skladě
Popis:

vytváření produktů

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/products HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "category_id": 1,
    "name": "Horké kameny",
    "variant_name": "červené",
    "ext_code": "xyz",
    "ean": "...",
    "dropshipping": "private",
    "clearance": false,
    "description": "Popis",
    "description_html": "<strong>Popis</strong>",
    "purchase_price": null,
    "price_wholesale": 43.21,
    "price_retail_vat": 99,
    "vat": 21,
    "preview_image": "JVBERi0xLjMNCiXi48/TDQoNCjE...",
    "partner_warehouse_quantity": 3,
    "partner_delivery_date": 0,
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
category_id int|NULL ANO Id kategorie
name string ANO Název produktu
variant_name string ANO Název varianty (pokud se jedná o produkt bez variant, pošlete prázdný řetězec)
ext_code string ANO Kód produktu/varianty z vašeho systému
ean string ANO EAN produktu/varianty
dropshipping string ANO Bude produkt/varianta nabízena také ostatním uživatelům systému nebo je vavrianta pouze pro vás? Hodnoty "private" nebo "public"
clearance bool ANO Produkt/varianta v likvidaci. Slouží primárně pro označení produktů, u kterých se nepočíta s dalším doskladňováním
description string ANO Popis produktu
description_html string ANO HTML popis produktu
price_purchase float|NULL ANO Nákupní cena varianty bez DPH
price_wholesale float|NULL ANO Velkoobchodní cena varianty bez DPH
price_retail_vat int|NULL ANO Doporučená maloobchodní cena varianty s DPH
vat int ANO DPH (15/21)
preview_image string ANO Obrázek produktu/varianty jako base64 encoded string.
partner_warehouse_quantity int|NULL NE Počet kusů skladem u dodavatele. NULL = produkt je skladem s neznámým přesným počtem kusů
partner_delivery_date int|NULL NE Počet dní k naskladnění u dodavatele (v případě že není produkt skladem). 0 = je skladem, 60 = produkt již nebude naskladněn
JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1,
        "variant_id": 1
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id produktu v systému dropshipping.cz
variant_id int Id varianty v systému dropshipping.cz
Popis:

editace produktu

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/products/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "category_id": 1,
    "name": "Horké kameny",
    "description": "Popis",
    "description_html": "<strong>Popis</strong>",
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
category_id int|NULL ANO Id kategorie
name string ANO Název produktu
description string ANO Popis produktu
description_html string ANO HTML popis produktu
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}

Popis:

seznam produktových kategorií

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/product-categories?limit=100&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/product-categories?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string NE ID kategorie (pro zobrazení pouze konkrétní kategorie)
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string NE Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=name" = "name ASC"; "sort=-name" = "name DESC"). Defaultní řazení je "name ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 10,
    "data": [
        {
            "id": 1,
            "parent": 0,
            "name": "Pro muže"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID kategorie
parent int ID nadřazené kategorie. Nejvyšší stupeň kategorií je zapsán jako parent = 0.
name string Název kategorie
Popis:

vytváření kategorií

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/product-categories

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/product-categories HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "Pro muže",
    "parent": 0
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string ANO Název kategorie
parent int ANO ID nadřazené kategorie. Nejvyšší stupeň kategorií je zapsán jako parent = 0.
JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id kategorie v systému dropshipping.cz
Popis:

editace kategorie

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/product-categories/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/product-categories/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "Pro muže",
    "parent": 0
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string ANO Název kategorie
parent int ANO ID nadřazené kategorie. Nejvyšší stupeň kategorií je zapsán jako parent = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}
Popis:

smazání kategorie

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/product-categories/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/product-categories/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)


JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}

Popis:

seznam variant konkrétního produktu

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/variants?limit=100&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/products<productId>/variants?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string NE ID produktu (pro zobrazení pouze konkrétní varianty)
code string NE DS kód varianty
ext_code string NE Kód dodavatele varianty
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 100.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
sort string NE Řazení záznámů. Směr řazení se určuje znakem "-" před názvem proměnné ("sort=name" = "name ASC"; "sort=-name" = "name DESC"). Defaultní řazení je "name ASC".
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 2,
    "data": [
        {
            "id": 1,
            "name": "červené",
            "code": "DS12345678",
            "ext_code": "xyz",
            "ean": "...",
            "dropshipping": "private",
            "clearance": false,
            "purchase_price": null,
            "price_wholesale": 43.21,
            "price_retail": 81.81,
            "price_retail_vat": 99,
            "vat": 21,
            "preview_image": "https://dscdn.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131b.png",
            "partner_warehouse_quantity": 3,
            "partner_delivery_date": 0,
            "inventory": {
                "quantity": 3,
                "reserved_quantity": 1,
                "requested_quantity": 0,
                "price_per_unit": 81.81,
                "location": "A123"
            }
        },
        {
            "id": 2,
            "name": "černé",
            "code": "DS12345679",
            "ext_code": "xzy",
            "ean": "...",
            "dropshipping": "public",
            "clearance": false,
            "purchase_price": null,
            "price_wholesale": 43.21,
            "price_retail": 81.81,
            "price_retail_vat": 99,
            "vat": 21,
            "preview_image": "https://dscdn.cz/images/3/3/c/3/3/9/2/3/c/2/ad49b23bd4e7ef694a131c.png",
            "partner_warehouse_quantity": null,
            "partner_delivery_date": null,
            "inventory": {
                "quantity": 0,
                "reserved_quantity": 0,
                "requested_quantity": 2,
                "price_per_unit": 81.81,
                "location": "A123"
            }
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID varianty
name string Název varianty
code string DS kód varianty
ext_code string Váš kód varianty
ean string EAN varianty
dropshipping string Bude varianta nabízena také ostatním uživatelům systému nebo je vavrianta pouze pro vás? Hodnoty "private" nebo "public"
clearance bool Varianta v likvidaci. Slouží primárně pro označení produktů, u kterých se nepočíta s dalším doskladňováním
purchase_price float|NULL Nákupní cena varianty bez DPH
price_wholesale float|NULL Velkoobchodní cena varianty bez DPH
price_retail float|NULL Doporučená maloobchodní cena varianty bez DPH
price_retail_vat int|NULL Doporučená maloobchodní cena varianty s DPH
vat int DPH
preview_image string Obrázek varianty
partner_warehouse_quantity int|NULL Počet kusů skladem u dodavatele. NULL = produkt je skladem s neznámým přesným počtem kusů
partner_delivery_date int|NULL Počet dní k naskladnění u dodavatele (v případě že není produkt skladem). 0 = je skladem, 60 = produkt již nebude naskladněn
inventory.quantity int Počet kusů skladem celkem (pro dostupný počet kusů nezapomeňte odečíst "reserved_quantity")
inventory.reserved_quantity int Počet rezervovaných kusů pro nevyřízené objednávky
inventory.requested_quantity int Počet žádostí (ks) o variantu pro nevyřízené objednávky
inventory.price_per_unit float|NULL Průměrná cena za kus
inventory.location string Umístění na skladě
Popis:

vytváření variant konkrétního produktu

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/variants

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/variants HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "černé",
    "ext_code": "yzx",
    "ean": "...",
    "dropshipping": "public",
    "clearance": true,
    "purchase_price": null,
    "price_wholesale": 43.21,
    "price_retail_vat": 99,
    "vat": 21,
    "preview_image": "JVBERi0xLjMNCiXi48/TDQoNCjE...",
    "partner_warehouse_quantity": 3,
    "partner_delivery_date": 0,
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string ANO Název varianty
ext_code string ANO Kód produktu/varianty z vašeho systému
ean string ANO EAN produktu/varianty
dropshipping string ANO Bude produkt/varianta nabízena také ostatním uživatelům systému nebo je vavrianta pouze pro vás? Hodnoty "private" nebo "public"
clearance bool ANO Produkt/varianta v likvidaci. Slouží primárně pro označení produktů, u kterých se nepočíta s dalším doskladňováním
price_purchase float|NULL ANO Nákupní cena varianty bez DPH
price_wholesale float|NULL ANO Velkoobchodní cena varianty bez DPH
price_retail_vat int|NULL ANO Doporučená maloobchodní cena varianty s DPH
vat int ANO DPH (15/21)
preview_image string ANO Obrázek produktu/varianty jako base64 encoded string.
partner_warehouse_quantity int|NULL NE Počet kusů skladem u dodavatele. NULL = produkt je skladem s neznámým přesným počtem kusů
partner_delivery_date int|NULL NE Počet dní k naskladnění u dodavatele (v případě že není produkt skladem). 0 = je skladem, 60 = produkt již nebude naskladněn
JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id varianty v systému dropshipping.cz
Popis:

editace varianty

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/variants/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/variants/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "name": "černé",
    "ext_code": "yzx",
    "ean": "...",
    "dropshipping": "public",
    "clearance": true,
    "purchase_price": null,
    "price_wholesale": 43.21,
    "price_retail_vat": 99,
    "vat": 21,
    "partner_warehouse_quantity": 3,
    "partner_delivery_date": 0,
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
name string ANO Název varianty
ext_code string ANO Kód produktu/varianty z vašeho systému
ean string ANO EAN produktu/varianty
dropshipping string ANO Bude produkt/varianta nabízena také ostatním uživatelům systému nebo je vavrianta pouze pro vás? Hodnoty "private" nebo "public"
clearance bool ANO Produkt/varianta v likvidaci. Slouží primárně pro označení produktů, u kterých se nepočíta s dalším doskladňováním
price_purchase float|NULL ANO Nákupní cena varianty bez DPH
price_wholesale float|NULL ANO Velkoobchodní cena varianty bez DPH
price_retail_vat int|NULL ANO Doporučená maloobchodní cena varianty s DPH
vat int ANO DPH (15/21)
preview_image string NE Pokud chcete ponechat aktální obrázek varianty, vynechte tuto proměnnou.
partner_warehouse_quantity int|NULL NE Počet kusů skladem u dodavatele. NULL = produkt je skladem s neznámým přesným počtem kusů
partner_delivery_date int|NULL NE Počet dní k naskladnění u dodavatele (v případě že není produkt skladem). 0 = je skladem, 60 = produkt již nebude naskladněn
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}

Popis:

galerie konkrétního produktu

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/images?limit=100&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/images?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 10,
    "data": [
        {
            "id": 1,
            "product_id": 1,
            "variant_id": 1,
            "url": "https://dscdn.cz/images/5/8/2/8/9/b/9/d/a/7/3ab95e3eb9e21986c724af.jpg"
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID obrázku
product_id int ID produktu
variant_id int|NULL ID varianty, pokud se obrázek vztahuje ke konkrétní variante produktu.
url string ANO URL obrázku
Popis:

vytváření nového obrázku galerie konkrétního produktu

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/images

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/images HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "variant_id": 1,
    "image": "JVBERi0xLjMNCiXi48/TDQoNCjE..."
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
variant_id int|NULL ANO ID varianty, pokud je na obrázku pouze konkrétní varianta produktu
image string ANO Obrázek jako base64 encoded string.
JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1
        "url": "https://dscdn.cz/images/5/8/2/8/9/b/9/d/a/7/3ab95e3eb9e21986c724af.jpg"
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id string ID vloženého obrázku
url string URL vloženého obrázku
Popis:

smazání obrázku produktu

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/images/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/products/<productId>/images/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)


JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}

Popis:

seznam předskladnění

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads?limit=100&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string NE ID kategorie (pro zobrazení pouze konkrétní kategorie)
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "extra_cost": 0,
            "note": "poznámka",
            "receiving_note": "poznámka k naskladnění",
            "date_of_delivery": "2020-12-31",
            "items": [
                {
                    "variant_id": 1,
                    "code": "DS12345678",
                    "ext_code": null,
                    "price_per_unit": 99.99,
                    "quantity": 3,
                    "received_quantity": 2,
                    "damaged_quantity": 1,
                    "photos": ["https://dscdn.cz/images/9/3/4/f/a/a/e/a/1/0/b31ea2df5b933d6cf9b661.png"]
                }
            ],
            "packages": [
                {
                    "barcode": "123456789"
                }
            ]
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID předskladnění
extra_cost float Náklady naskladnění bez DPH
note string Poznámka
receiving_note string Poznámka k naskladnění
date_of_delivery string Předpokládaný datum dodání
items[].variantId int Id produktu ze systému dropshipping.cz
items[].code string Kód produktu ze systému dropshipping.cz
items[].ext_code string Kód produktu dodavatele
items[].price_per_unit float Cena za kus bez DPH
items[].quantity int Počet kusů
items[].received_quantity int|NULL Počet kusů, které byly reálně naskladněny. Pokud je hodnota NULL, k naskladnění zatím nedošlo
items[].damaged_quantity int|NULL Počet kusů, které jsou poškozeny. Pokud je hodnota NULL, zatím nedošlo k naskladnění
items[].photos array Foto dokumentace, z pravidla v případě přijetí poškozených kusů
packages[].barcode string Sledovací číslo balíků
Popis:

vytváření předskladnění

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "extra_cost": 0,
    "note": "poznámka",
    "date_of_delivery": "2020-12-31",
    "items": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "price_per_unit": 99.99,
            "quantity": 3
        }
    ],
    "packages": [
        {
            "barcode": "123456789"
        }
    ]
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
extra_cost float ANO Náklady naskladnění bez DPH
note string NE Poznámka
date_of_delivery string ANO Předpokládaný datum dodání
items[].code string Podm. Kód produktu ze systému dropshipping.cz. Nepovinné, pokud je uvedeno ext_code produktu
items[].ext_code string Podm. Kód produktu dodavatele. Nepovinné, pokud je uvedeno code produktu
items[].price_per_unit float ANO Cena za kus bez DPH
items[].quantity int ANO Počet kusů
packages[].barcode string NE Sledovací číslo balíků
JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "code": 201,
    "message": "",
    "data": {
        "id": 1
    }
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id předskladnění v systému dropshipping.cz
Popis:

editace předskladnění

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "extra_cost": 0,
    "note": "poznámka",
    "date_of_delivery": "2020-12-31",
    "items": [
        {
            "code": "DS12345678",
            "ext_code": null,
            "price_per_unit": 99.99,
            "quantity": 3
        }
    ],
    "packages": [
        {
            "barcode": "123456789"
        }
    ]
}
Popis polí požadavku:
Klíč Typ Povinné Komentář
extra_cost float ANO Náklady naskladnění bez DPH
note string NE Poznámka
date_of_delivery string ANO Předpokládaný datum dodání
items[].code string Podm. Kód produktu ze systému dropshipping.cz. Nepovinné, pokud je uvedeno ext_code produktu
items[].ext_code string Podm. Kód produktu dodavatele. Nepovinné, pokud je uvedeno code produktu
items[].price_per_unit float ANO Cena za kus bez DPH
items[].quantity int ANO Počet kusů
packages[].barcode string NE Sledovací číslo balíků
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}
Popis:

smazání předskladnění

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/warehouse-preloads/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)


JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}

Popis:

seznam žádostí

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/warehouse-requests?limit=100&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/warehouse-requests?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string NE ID kategorie (pro zobrazení pouze konkrétní kategorie)
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "variant_id": 1,
            "variant_code": "DS12471440",
            "variant_ext_code": "xyz",
            "quantity": 3,
            "date_of_delivery": "2020-12-31",
            "created": "2020-12-31 12:12:12",
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID žádosti
variant_id int Id produktu ze systému dropshipping.cz
variant_code string Kód produktu ze systému dropshipping.cz
variant_ext_code string Kód produktu dodavatele
quantity int Počet kusů
date_of_delivery string|NULL Předpokládaný datum dodání. Pokud je hodnota rovna "NULL", žádost čeká na vaše vyjádření. Pokud je hodnota rovna "", předpokládaný datum dodání je nastaveno jako neznámé
created string Datum a čas vytvoření žádosti
Popis:

editace předpokládaného datumu dodání

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/warehouse-requests/<id>

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/fulfillment/warehouse-requests/<id> HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)

{
    "date_of_delivery": "2020-12-31",
}
Popis polí požadavku:
date_of_delivery string ANO Předpokládaný datum dodání. Pokud je datum dodání neznámé, pošlete prázdný řetězec ("").
JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": ""
}

Popis:

seznam pohybů

Úplná adresa:

https://client.api.dropshipping.cz/v1/fulfillment/warehouse-movements?limit=100&offset=0

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/fulfillment/warehouse-movements?limit=30&offset=0 HTTP/1.1
Authorization: TOKEN
Accept: application/json

Popis parametrů požadavku:
Klíč Typ Povinné Komentář
id string NE ID kategorie (pro zobrazení pouze konkrétní kategorie)
limit int NE Počet požadovaných záznamů. Defaultní hodnota = 100. Maximální hodnota = 1000.
offset int NE Určuje, od kterého místa bude výsledek zobrazen. Defaultní hodnota = 0.
dateFrom string NE Datum od ve formátu Y-m-d (např. 2020-01-31).
dateTo string NE Datum do ve formátu Y-m-d (např. 2020-01-31).

Záznamy jsou vždy řazeny od nejnovějšího po nejstarší.

JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 1,
    "data": [
        {
            "id": 1,
            "variant_id": 1,
            "movement": "in",
            "order_id": null,
            "order_number": null,
            "fulfillment_order_id": null,
            "price_per_unit": 99.99,
            "extra_cost_per_unit": 0.0,
            "quantity": 3,
            "created": "2020-12-31 12:12:12",
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int Id pohybu
variant_id int Id varianty ze systému dropshipping.cz
movement string Směr pohybu ("in"|"out")
order_id int|NULL Id dropshippingové objednávky
order_number string|NULL Číslo dropshippingové objednávky
fulfillment_order_id string|NULL Id fulfillmentové objednávky ve formátu UUID4
price_per_unit float|NULL Cena/kus za kterou byla položka naskladněna
extra_cost_per_unit float|NULL Náklady/kus za kterou byla položka naskladněna
quantity int Počet kusů
created string Datum a čas vytvoření ve formátu "Y-m-d H:i:s"

ReklamačníFormulář.cz

Pro implementaci funkce aplikace reklamacniformular.cz

Popis:

seznam typů požadavku

Úplná adresa:

https://client.api.dropshipping.cz/v1/complaint/issues/types

JSON požadavek:

GET https://client.api.dropshipping.cz/v1/complaint/issues/types HTTP/1.1
Authorization: TOKEN
Accept: application/json

JSON odpověď:

HTTP/1.1 200
Content-type: application/json;

{
    "code": 200,
    "message": "",
    "totalCount": 4,
    "data": [
        {
            "id": 4,
            "name": "Vrácení zboží do 14 dní (odstoupení od kupní smlouvy)",
            "content": "..."
        }
    ]
}
Popis polí odpovědi:
Klíč Typ Komentář
id int ID typu
name string Název typu
content string HTML text zobrazený po odeslání žádosti

Popis:

vkládání požadavků

Úplná adresa:

https://client.api.dropshipping.cz/v1/complaint/issues

JSON požadavek:

POST https://client.api.dropshipping.cz/v1/complaint/issues HTTP/1.1
Authorization: TOKEN
Accept: application/json
Idempotency-Key: string1

{
    "type": 4,
    "orderNumber": "10-0001",
    "name": "John Doe",
    "email": "john@doe.com",
    "note": "Text požadavku",
    "sendCopy": true
}

1 doporučená hlavička pro zabránění duplicitního vložení požadavku. Použijte jakykoliv řetězec (char 36), unikátní pro konkrétní zadání požadavku. Ideálně UUID4 (wikipedie, PHP knihovna)


Popis polí požadavku:
Klíč Typ Povinné Komentář
type integer ANO ID typu požadavku
orderNumber string ANO Číslo objednávky. Musí odpovídat některé z vaších objednávek v systému dropshipping.cz
name string ANO Jméno a příjmení zákazníka
email string ANO Kontaktní e-mail zákazníka
note string ANO Text požadavku
sendCopy bool ANO Odeslat odpověď na e-mail zákazníka?

JSON odpověď:

HTTP/1.1 201
Content-type: application/json;

{
    "code": 201,
    "message": ""
}