Chyby synchronizace API IS Premier a jejich řešení

Než začnete

• Přihlaste se do Depota jako správce.
• Mějte aktivní napojení na účetní systém Premier (IS Premier).
• Připravte si konkrétní chybovou zprávu synchronizace.

Přehled nejčastějších chybových hlášek integrace mezi systémy Depoto a IS Premier. Pokud narazíte na chybu, kterou tu nenajdete, projděte i článek Přehled nejčastějších chybových hlášek s IS PREMIER.

Premier API timeout

„Na adrese AdresaVašehoServeru:ČísloPortu došlo k timeoutu. Prosím, zjistěte, zda nedošlo k výpadku serveru nebo API služby.“

Tato chyba může mít dvě příčiny:

1. Fyzický výpadek vašeho stroje nebo internetu. Kontaktujte svého poskytovatele internetu, případně IT správce. Pokud nastává často, bude třeba najít lepšího poskytovatele internetu nebo server umístit do datacentra Premieru, kde je zaručena velmi kvalitní konektivita.
2. Pokud server jede a přes vzdálenou plochu se do Premieru dostanete, může být problém ve službě „Premier API“. Na stroji je třeba ve správci úloh tuto službu restartovat. Kontaktujte správce IS Premier a požádejte ho o restart. Vhodným preventivním řešením je také automatický restart služby každý den v ranních hodinách – poté, co proběhnou plánované zálohy a údržby systému.

Premier API error – ID neexistuje

„Při poslání dat z DEPOTO na PREMIER API na adrese AdresaVašehoServeru:ČísloPortu došlo k chybě. CHYBA: error in request: ID [<...dlouhé ID zákazníka...>] neexistuje. Založte nového partnera pro objednávku.“

Tato chyba běžně nastává, pokud v Premieru smažete zákazníka, který tam dříve existoval, ale nesmažete ho v Depotu a vytvoříte na něj v Depotu objednávku.

Řešení: ručně zpracovat danou objednávku a pro budoucí stav vyřešit kartu zákazníka – například smazat zákazníka v Depotu a vytvořit v Premieru novou kartu, která se následně importuje do Depota.

Nepropsání karty zákazníka do Depota

Často se stává, že nedojde k propsání zákazníka do Depota z důvodu, že v Premieru máte více zákazníků se stejnou e-mailovou adresou (například více firem, jedna účetní). Depoto vyžaduje pro každého zákazníka unikátní e-mailovou adresu.

Řešení: upravit adresy na kartách zákazníků tak, že vytvoříte validní alias pomocí znaku +. Pokud je například původní e-mail ucetni@example.com, dejte k jedné firmě nově ucetni+1@example.com, k další ucetni+2@example.com a tak dále. Znak + v e-mailu před zavináčem je validní – příjemci e-maily stále chodí, protože vše za + až po zavináč se při doručení ignoruje.

V novější verzi propojení se zákazník, jehož e-mail už v Depotu existuje, uloží s náhradní jedinečnou e-mailovou adresou odvozenou z čísla a interního označení karty; skutečný e-mail zůstane na jeho adresách. Karta se proto přenese i bez úpravy e-mailu.

Objednávka se přenesla, ale něco v ní chybí

V Depotu chybí položka, kterou jste do objednávky přidali v Premieru. Objednávka, která už se do Depota přenesla, se při změně v Premieru znovu nepřenáší. Položku přidanou v Premieru až po přenosu přidejte do objednávky v Depotu ručně.

V Depotu je jako dodací adresa uvedená fakturační. Dodací adresa se přenese jen tehdy, když je na objednávce v Premieru vybraná dodací adresa odběratele. Adresu zapsanou jen jako text, například v poli konečného příjemce, Depoto nepřevezme a jako dodací použije fakturační adresu. Když zboží jde jinam než na fakturační adresu, vyberte na objednávce v Premieru dodací adresu odběratele a vyplňte u ní telefon a e-mail příjemce. Dopravci je potřebují pro avizaci.

Tipy

• Zaveďte ve firmě pravidlo, že kartu zákazníka mažete vždy v Premieru i Depotu zároveň. Tím předejdete chybám typu „ID neexistuje“.
• U firem se sdílenou účetní (ucetni@…) systematicky nastavte aliasy +1, +2, +3 – ušetříte si pozdější nedohledatelné chyby.
• Pro detailní logy synchronizace pošlete podpoře Depoto čas chyby + číslo objednávky / partnera – v drtivé většině případů jsme schopni rychle pomoci.

Související články

• IS Premier: přehled propojení s Depotem
• Chybové hlášky u propojení s IS Premier: jak postupovat