Tento návod platí pro napojení na Brani – skladový / fulfillment systém (brani.cz). Obecné ovládání aplikace najdete v základní příručce.
Jak propojení funguje
ShopSync komunikuje s Brani přes jejich API (adresa api.brani.cz,
přístupový token). Databáze, FTP ani PHP můstek se nepoužívají.
Standardní součástí napojení je přenos produktů: ShopSync vezme aktuální sortiment z účetního systému a nahraje ho do Brani vždy jako kompletní balík (Brani nepodporuje dílčí aktualizace – i malá změna znamená odeslání celého sortimentu; zpracování na straně Brani chvíli trvá, to je normální).
Existují dvě základní varianty integrace:
- ERP jako „e-shop" pro Brani balič – v Brani baliči pak vyřizujete objednávky z účetního systému, jsou tam vidět produkty a způsoby platby a dopravy. Součástí je posílání objednávek do skladu a hlášení „zabaleno" a čísel zásilek zpět přes události (webhooky).
- ERP napojené na Brani sklad – do účetního systému se načítají výdejky a příjemky ze skladu, lze poslat inventuru a předávat seznam produktů oběma směry.
Konkrétní rozsah (a případné zakázkové úpravy nad rámec obou variant) domluvíme při nasazení.
Co si připravte předem
- Přístupový token k API Brani – získáte od podpory Brani
(support@brani.cz). Tamtéž vám sdělí i číslo e-shopu (
brani_eshop_id), pokud ho napojení používá. - Aktivní e-shop a sklad v Brani – token patří ke konkrétnímu e-shopu v Brani; sklad musí být aktivní.
- Jedinečné a stabilní kódy zboží v účetním systému – kód je párovací klíč; při změně kódu vznikne v Brani nová položka.
- Hmotnosti zboží vyplněné v účetním systému – Brani je používá pro dopravu (nevyplněná hmotnost se přenese jako 0).
- Pokud se mají posílat objednávky: seznam stavů objednávek, doprav a plateb – před prvním přenosem se registrují do Brani a musí si odpovídat.
- Dopravce a jejich služby si nastavujete přímo v Brani (napojení na Balíkobot, Zásilkovnu apod.) – ShopSync je jen využívá.
Pole na záložce „Připojení k eshopu"
U Brani se záložka Připojení k eshopu nepoužívá – všechna pole nechte prázdná (adresa API je pevně daná).
Záložka Nastavení
Položky se zadávají ručně do sekce 8. Ostatní (automatická inicializace je u Brani nevytvoří):
| Položka | Co vyplnit |
|---|---|
brani_token |
Přístupový token k API Brani – jediný povinný údaj. |
brani_eshop_id |
Číslo e-shopu v Brani – jen pokud se používá hlášení událostí (zabaleno, číslo zásilky). |
debug |
Podrobnost logu (1–2) – jen při řešení problémů. |
Další položky (nastavuje technik podle rozsahu napojení):
brani_prijemka_days_back, brani_vydejka_days_back,
brani_inventura_days_back (kolik dní zpět se načítají doklady ze skladu),
brani_receipt_doc_type_id / brani_issue_doc_type_id (typy skladových
dokladů v Brani – zjišťují se z API pro konkrétní účet).
Časté problémy
- „Při operaci nastala chyba (HTTP 401/403)" – neplatný nebo expirovaný token.
- Import produktů dlouho „běží" – zpracování snapshotu na straně Brani je asynchronní; ShopSync na výsledek čeká a stav pravidelně kontroluje.
- Zboží se v Brani zdvojilo – změnil se kód zboží v účetním systému.