Dnešním dnem jsme přidali do Balíkuj novou funkci, díky které můžete Balíkuj jednoduše napojit na jakékoliv e-shop řešení pomocí našeho API rozhraní. Mimo již integrované řešení Upgates nebo Shoptet tak můžete nahrávat objednávky z jakéhokoliv systému, spravovat je v Balíkuj, kde budete provádět automatizaci, expedici zásilek a mnoho dalšího.
API rozhraní Balíkuj
Platforma Balíkuj je již od základu postavena na programovém API rozhraní, díky kterému můžete prakticky vše spravovat a ovládat pomocí jednoduchých příkazů ze svých aplikací nebo ze svého kódu.
Ať již máte aplikaci nebo svůj e-shop na jakékoliv platformě, můžete jednoduše využívat funkce Balíkuj odkudkoliv.
Dokumentaci k API rozhraní postupně píšeme, doplňujeme a naleznete ji na následujících odkazech:
- https://docs.balikuj.cz/docs/api/intro - hlavní dokumentace k Balíkuj
- https://balikuj.cz/swagger/index.html - Swagger dokumentace včetně popisků a modelů
- https://balikuj.docs.apiary.io - Apiary dokumentace - postupně zapracováváme
Vytvoření nové aplikace
Balíkuj přiřazuje každou objednávku pod vlastní aplikaci, abyste objednávky mohli jednoduše filtrovat a spravovat. Je tedy potřeba si vytvořit novou aplikaci typu "Vlastní e-shop". To uděláte tak, že půjdete do menu Nastavení -> Aplikace -> Přidat Aplikaci.
Následně vyberete aplikací "Vlastní e-shop" a kliknete na tlačítko Pokračovat.
Nakonec je třeba vyplnit Doménu e-shopu v záložce Základní nastavení a údaje v záložce Kontaktní údaje. Vše dokončíte kliknutím na tlačítko Aktivovat aplikaci.
Nahrání nové objednávky do Balíkuj
Nahrát novou objednávku do Balíkuj není nijak složité. Na začátku je třeba se připojit k API rozhraní Balíkuj (viz Dokumentace), přihlásit se a získat Token. Následně stačí odeslat požadavek na vytvoření objednávky:
{
"orders": [
{
"orderNumber": "000666", // ID objednávky
"applicationId": 1, // ID aplikace, kterou jsme vygenerovali v předchozích krocích
"billingAddress": { // Fakturační adresa objednávky
"name": "Josef Novák",
"street": "Štěpnická 1083",
"city": "Uherské Hradiště",
"zip": "68606"
},
"deliveryAddress": { // Dodací adresa objednávky
"name": "Test Testovič",
"street": "Štěpnická 1000",
"city": "Zlín",
"zip": "76001"
},
"created": "2024-09-07T11:44:27", // Datum vytvoření objednávky
"currency": "CZK", // Měna objednávky
"vatPriceMode": "WithoutVat", // Typ počítání DPH (WithoutVat = uvedené ceny jsou bez DPH, WithVat = uvedené ceny jsou vč. DPH a budou vypočítány na základ + DPH)
"items": [ // Pole položek objednávky
{
"code": "POLOZKA0001", // Kód položky, bude sloužit v budoucnu k párování skladů
"itemPriceVatRate": 21, // Sazba DPH
"itemPrice": 1000, // Cena položky
"name": "Testovací produkt 1", // Název položky
"quantity": 2, // Množství
"weight": 1.1, // Jednotková váha
"buyPriceVatRate": 21, // Sazba DPH nákupní ceny
"buyPrice": 500.0, // Nákupní cena
"ean": "EAN",
"note": "Poznámka!!",
"stockLocation": "location", // Umístění produktu - bude nahrazeno sklady v budoucnu
"unit": "ks"
},
{
"code": "POLOZKA0002",
"itemPriceVatRate": 21,
"itemPrice": 100,
"name": "Testovací produkt 2",
"quantity": 1,
"weight": 0.5
}
],
"language": "CS", // Jazky objednávky
"paymentId": 1, // Typ platby, ID je možné získat v přehledu platebních metod
"statusId": 1, // Stav objednávky, ID je možné získat v přehledu stavů objednávky
"carrierCode": "PPL", // Kód dopravce
"serviceType": "ParcelCzPrivate", // Kód služby dopravce
"customerNote": "Customer Note",
"internalNote": "Internal Note",
"externalCode": "External code",
"paymentVatRate": 21, // Sazba DPH platební metody
"paymentPrice": 40, // Cena za platební metodu
"shippingVatRate": 21, // Sazba DPH dopravy
"shippingPrice": 100 // Cena za dopravu
}
]
}
Takto vytvoříte novou objednávku v Balíkuj a je možné takto vytvořit až 100 objednávek najednou.
Závěr
Zajímá Vás něco dalšího? Napište nám a rádi Vám se vším pomůžeme!