Jak napojit WooCommerce na účetnictví, dopravce a dodavatele

WooCommerce se v praxi málokdy používá jako izolovaný e-shop. Objednávky míří do účetnictví, skladové pohyby do centrální evidence, zásilky k dopravci a informace o dostupnosti nebo cenách přicházejí od dodavatelů. Jakmile se tato data přepisují ručně, vzniká zpoždění, duplicita a nejistota, který systém má pravdu.

Dobré napojení není jen instalace konektoru. Je to návrh datového toku, odpovědností a chybových stavů. Musí být jasné, co se synchronizuje, kdy se to synchronizuje, kdo je zdrojem pravdy, jak se ověřuje příjem a co se stane při výpadku.

V článku projdeme nejčastější integrace WooCommerce s účetnictvím, dopravci a dodavateli. Principy platí i pro CRM, fakturační aplikace, ERP nebo vlastní skladový systém.

Nejdříve zmapujte systémy a odpovědnosti

Než vyberete plugin nebo začnete programovat API, sepište systémy, které v procesu vystupují. U každého typu údaje určete, kde vzniká, kde se mění a kam se pouze kopíruje.

• WooCommerce: košík, objednávka, produkty, zákaznický účet a stav nákupu.
• Účetnictví nebo fakturace: doklady, číselné řady, daňové údaje a úhrady.
• Sklad nebo ERP: dostupnost, rezervace, příjem, výdej, lokace a dodavatelské objednávky.
• Dopravce: zásilka, štítek, výdejní místo, sledovací číslo a stav doručení.
• Dodavatel: katalog, nákupní cena, dostupnost, dodací lhůta a případné nákupní objednávky.
• CRM: zákazník, obchodní případ, komunikace a navazující péče.

Například WooCommerce může být zdrojem objednávky, sklad zdrojem fyzické dostupnosti a účetní systém zdrojem vystaveného dokladu. Pokud oba systémy současně přepisují totéž pole, musí existovat explicitní pravidlo přednosti. Jinak se hodnota bude vracet tam a zpět.

Integrace účetnictví a fakturace

Nejčastějším cílem je předat do účetnictví objednávku nebo podklady pro doklad. Rozhodnutí, kdy doklad vzniká, ale není jen technická otázka. Záleží na typu zboží, platbě, datu plnění, způsobu účtování a interním procesu firmy.

Před implementací si ujasněte:

• zda se přenáší objednávka, přijatá platba, nebo až podklad pro fakturu,
• kdy je obchodní událost dostatečně potvrzená,
• které údaje dodává e-shop a které účetní systém,
• jak se mapují sazby, měny, slevy, doprava a zaokrouhlení,
• jak se řeší dobropis, storno, částečná úhrada a refundace,
• jak se uloží vazba mezi číslem objednávky a číslem dokladu.

Částka v objednávce, částka potvrzená platební bránou a částka na dokladu musí být porovnatelné. Neznamená to, že všechny systémy mají stejný formát, ale převod musí být pravidelný a dohledatelný.

Co do účetnictví neposílat bez rozmyslu

Integrace nemá automaticky exportovat celou objednávku včetně všech interních poznámek, technických logů a nepotřebných osobních údajů. Přenášejte jen data, která cílový systém potřebuje. Snižuje se tím riziko, objem i počet míst, kde může vzniknout rozpor.

Pro každý export uložte externí identifikátor a výsledek. Pokud se účetní systém ozve s chybou, obsluha musí vidět konkrétní objednávku, důvod a možnost opravy nebo opakování.

Integrace dopravců

Napojení dopravce obvykle začíná vytvořením zásilky a štítku. Tím ale proces nekončí. E-shop potřebuje pracovat také s výdejními místy, rozměry a hmotností, dobírkou, sledovacím číslem, změnou doručení a vratkou.

Praktický tok může vypadat takto:

1. WooCommerce předá validované údaje zásilky a objednávky.
2. Dopravce vrátí identifikátor zásilky a případně PDF štítek.
3. E-shop uloží vazbu a zobrazí ji obsluze.
4. Po fyzickém předání se objednávka přepne do odpovídajícího stavu.
5. Stav doručení se průběžně aktualizuje podle webhooku nebo pravidelného dotazu.
6. Vrácená zásilka vytvoří úkol pro obsluhu, nikoli tiché přepsání objednávky.

Neposílejte dopravci adresu bez kontroly délky, PSČ, země a vybrané služby. Zvláštní pozornost věnujte objednávkám s více balíky a částečným odesláním. Jedna objednávka může mít několik zásilek, každá vlastní číslo a stav.

Napojení dodavatelů a externího skladu

Dodavatelský feed často obsahuje názvy, SKU, ceny a dostupnost. Než jej importujete, určete, které hodnoty smí dodavatel přepsat. Není bezpečné automaticky přepsat název, popis, obrázky nebo prodejní cenu jen proto, že dorazily v XML či CSV.

Rozdělte data do skupin:

• Identifikační: SKU, EAN, varianta a vazba na interní produkt.
• Skladová: dostupné množství, očekávaný příjem, blokace a dodací lhůta.
• Nákupní: nákupní cena, minimální množství a balení.
• Prezentační: název, popis, fotografie a pořadí variant.
• Prodejní: cena, akce, marže a viditelnost v katalogu.

Dodavatel obvykle rozhoduje o dostupnosti a nákupní ceně. Obchodní obsah a prodejní pravidla zůstávají ve vašem katalogu. Pokud dodává více firem, potřebujete prioritu, výběr zdroje a pravidlo pro rozdílné hodnoty.

API a webhook nejsou totéž

API použijete, když se chcete jiného systému zeptat nebo mu poslat řízený požadavek. Webhook je oznámení, které přijde ve chvíli, kdy se něco stane. Kvalitní integrace často používá obojí.

• API: pravidelně načte dostupnost dodavatele, vytvoří zásilku nebo vyhledá doklad.
• Webhook: oznámí novou objednávku, potvrzenou platbu, změnu stavu zásilky nebo aktualizovaný produkt.

WooCommerce nabízí REST API pro práci s objednávkami, produkty, zákazníky a dalšími daty. Pro nové integrace se používá verze v3. Přístupové klíče mají oprávnění podle uživatele a mohou být pouze pro čtení, zápis nebo obojí. Používejte HTTPS a klíče neukládejte do veřejného repozitáře.

WooCommerce webhooky lze nastavit pro vytvoření, úpravu nebo odstranění objednávek, produktů a zákazníků. Příjemce má ověřit tajemství a podpis požadavku. Webhook se může opakovat nebo být dočasně nedoručitelný, proto musí být zpracování idempotentní.

Idempotence ochrání před duplicitami

Externí systém může stejnou událost poslat vícekrát, například když předchozí odpověď nepřišla včas. Pokud každý příjem vytvoří nový doklad, zásilku nebo skladový pohyb, vznikne chyba.

Bezpečné zpracování používá stabilní klíč události:

1. Přijme požadavek a ověří jeho podpis.
2. Najde identifikátor události nebo externího objektu.
3. Atomicky zkontroluje, zda už byl zpracován.
4. Pokud ano, vrátí úspěch bez další akce.
5. Pokud ne, uloží stav zpracování a provede povolený krok.
6. Zapíše výsledek a případnou chybu.

Stejné pravidlo platí pro ruční tlačítko Opakovat. Opakování má zopakovat neúspěšné doručení, ne založit druhou objednávku.

Mapování identifikátorů

Každý systém může používat jiné ID. WooCommerce má ID objednávky a číslo objednávky, účetnictví vlastní číslo dokladu, dopravce číslo zásilky a dodavatel vlastní SKU. Vazby ukládejte explicitně, ideálně do strukturovaných polí nebo integrační tabulky.

Ukládejte například:

• interní ID objednávky,
• číslo objednávky zobrazené zákazníkovi,
• ID objednávky v účetnictví,
• číslo dokladu a externí ID dokladu,
• ID zásilky a sledovací číslo,
• interní SKU a SKU dodavatele,
• čas poslední úspěšné synchronizace a verzi dat.

Nespoléhejte na název produktu nebo e-mail jako trvalý identifikátor. Názvy se mění, e-mail může být sdílený a dvě varianty mohou mít podobný popis.

Fronta a opakování chyb

Integrace nesmí blokovat celý checkout kvůli tomu, že účetnictví nebo dopravce na chvíli neodpovídá. Objednávku uložte a navazující úkol zpracujte ve frontě. U každého úkolu evidujte stav, počet pokusů, čas dalšího pokusu, poslední odpověď a odpovědného vlastníka.

Rozlišujte:

• Dočasná chyba: timeout, nedostupné API nebo přetížený server. Zkuste znovu s rostoucím intervalem.
• Trvalá chyba dat: neplatné PSČ, chybějící sazba nebo neznámé SKU. Opakování nepomůže, případ patří člověku.
• Konflikt: externí systém odmítá změnu, protože se mezitím změnila data. Vyžaduje rozhodnutí, který zdroj je správný.
• Bezpečnostní chyba: špatný podpis nebo oprávnění. Neopakujte slepě a upozorněte správce.

WooCommerce ukládá logy webhooků a stav neúspěšných doručení. Vlastní integrační vrstva by měla mít podobný přehled s filtrováním podle objednávky, systému a typu chyby.

Bezpečnost integrací

Integrace propojuje systémy, které často obsahují osobní a obchodně citlivá data. Každé napojení potřebuje vlastní oprávnění, nikoli jeden univerzální administrátorský klíč.

• Používejte HTTPS a ověřujte certifikát.
• API klíče ukládejte v secrets nebo konfiguračním úložišti mimo zdrojový kód.
• Omezte oprávnění na čtení, zápis a konkrétní zdroje.
• Ověřujte podpis webhooku na původním těle požadavku.
• Chraňte endpoint proti opakování a příliš velkým požadavkům.
• Do logů neukládejte hesla, celé tokeny ani citlivé platební údaje.
• Pravidelně klíče rotujte a při podezření je okamžitě zneplatněte.
• Veřejně nevystavujte interní diagnostické endpointy.

Jak integrovat účetnictví bezpečně v praxi

Začněte jediným stabilním scénářem, například exportem zaplacené objednávky do fakturačního systému. Nejprve přenášejte minimum polí, logujte výsledek a ručně porovnávejte vzorek dokladů.

1. Definujte spouštěcí událost a podmínky.
2. Namapujte produkty, sazby, měny, dopravu a slevy.
3. Vytvořte testovací objednávky s hraničními hodnotami.
4. Ověřte vznik dokladu a uložení externího ID.
5. Otestujte opakovaný webhook, timeout a neplatná data.
6. Spusťte paralelní kontrolu se stávajícím ručním procesem.
7. Teprve potom přidejte storna, refundace a dobropisy.

Jak napojit dopravce bez zmatku

Začněte jedním dopravcem a jednou službou. Ověřte adresu, hmotnost, rozměr, dobírku, výdejní místo, štítek, tracking a stav vrácené zásilky. Až poté přidávejte další dopravce. Každý má jiné limity, názvy služeb a chování API.

V administraci zobrazte obsluze jednu objednávku s vazbou na všechny zásilky. Uložte čas vytvoření štítku, identifikátor dopravce, sledovací číslo a poslední známý stav. Změna stavu zásilky nemá automaticky přepsat obchodní nebo platební stav bez pravidla.

Jak pracovat s dodavatelským feedem

Import dodavatelských dat plánujte jako řízenou synchronizaci, ne jako slepé přepsání katalogu. Každý import nejprve validujte, zaznamenejte jeho verzi a uložte počet přijatých, změněných a odmítnutých položek.

Kontrolujte především:

• unikátnost SKU a EAN,
• změnu ceny o neobvyklé procento,
• záporné nebo nesmyslné množství,
• produkt, který dodavatel z feedu náhle odstranil,
• nesoulad variant a balení,
• datum a stáří posledního feedu.

Pokud feed jeden den nedorazí, neznamená to automaticky, že všechny produkty jsou vyprodané. Nastavte ochranný režim a upozornění.

Monitoring a provozní přehled

Každá integrace potřebuje vlastní provozní metriku. Sledujte počet úspěšných a neúspěšných přenosů, stáří nejstarší chyby, délku fronty, počet opakování, rozdíly mezi systémy a poslední úspěšnou synchronizaci dodavatelů.

Upozornění má obsahovat odpověď na tři otázky: co se stalo, kterých objednávek nebo produktů se to týká a jaký je další bezpečný krok. Hlásit pouze počet chyb bez odkazu na konkrétní data obsluze nepomůže.

Testovací scénáře před spuštěním

• běžná objednávka s jednou položkou,
• objednávka s variantou, slevou, dopravou a více sazbami,
• neúspěšná a pozdě potvrzená platba,
• opakovaný nebo opožděný webhook,
• výpadek účetnictví, dopravce nebo skladu,
• chybějící SKU, neplatná adresa a neznámé výdejní místo,
• částečná expedice a více zásilek,
• storno před vystavením dokladu a po něm,
• refundace a vrácení zboží,
• feed dodavatele s neplatnou nebo zastaralou dávkou.

Po každém testu porovnejte WooCommerce, cílový systém, log integrace, e-mail a stav v administraci. Nestačí ověřit, že se zobrazila zelená hláška.

Kontrolní seznam dobrého napojení

• Má každý údaj jasně určený zdroj pravdy?
• Jsou interní a externí identifikátory uloženy explicitně?
• Je zřejmé, která událost integraci spouští?
• Je zpracování stejné události idempotentní?
• Má každý úkol stav, log a vlastníka?
• Rozlišuje systém dočasnou chybu od chybného vstupu?
• Je bezpečně řešena autentizace, podpis a rotace klíčů?
• Nezastaví výpadek externího systému checkout?
• Umí obsluha opravit data a bezpečně opakovat jen neúspěšný krok?
• Existuje záloha a postup obnovy po chybné synchronizaci?
• Probíhá pravidelné porovnání dat mezi systémy?
• Je integrace otestovaná na stagingu a zdokumentovaná?

Čistý tok dat je důležitější než počet konektorů

Úspěšná integrace není ta, která propojí nejvíce systémů. Je to ta, u které každý ví, odkud data pocházejí, kdy se mění, jak se potvrdí a co se stane při chybě. WooCommerce může zůstat přehledným obchodním rozhraním, zatímco účetnictví, sklad, dopravci a dodavatelé pracují ve svých systémech.

Začněte jedním procesem, jedním cílem a měřitelným výsledkem. Stabilní identifikátory, fronta chyb, bezpečná autentizace a pravidelná kontrola jsou důležitější než efektní, ale křehká synchronizace všeho se vším.

Potřebujete propojit WooCommerce s dalšími systémy?

Navrhneme datový tok mezi e-shopem, účetnictvím, skladem, dopravci, dodavateli a CRM. Nejprve zmapujeme proces a zdroje pravdy, potom vybereme hotové konektory nebo připravíme vlastní integrační vrstvu s monitoringem a bezpečným opakováním.

Popište nám systémy, které dnes ručně propojujete.