--- Title: APSi Language: cs-CZ Canonical URL to this Markdown version of this page: [https://docs.kvik.shop/cs/help/externi-sluzby/erp-a-jejich-napojeni/apsi.md](https://docs.kvik.shop/cs/help/externi-sluzby/erp-a-jejich-napojeni/apsi.md) Canonical URL to HTML version of this page (for humans): [https://docs.kvik.shop/cs/help/externi-sluzby/erp-a-jejich-napojeni/apsi](https://docs.kvik.shop/cs/help/externi-sluzby/erp-a-jejich-napojeni/apsi) --- # APSi Breadcrumb: [Help](https://docs.kvik.shop/cs/help.md) > [Externí služby](https://docs.kvik.shop/cs/help/externi-sluzby.md) > [ERP a jejich napojení](https://docs.kvik.shop/cs/help/externi-sluzby/erp-a-jejich-napojeni.md) > [APSi](https://docs.kvik.shop/cs/help/externi-sluzby/erp-a-jejich-napojeni/apsi.md) Zavedení APSi. Před samotným zavedením je nejdříve nutné kontaktovat zástupce společnosti APSi.cz a projednat s ním zavedení APSi programu a APSi databáze. V případě zájmu o propojení lokálního skladu je navíc účtována cena importu skladu. ## Export skladu z APSi Vyžaduje tento unifikovaný CSV export formát, který APSi exportuje na FTP kvik.shop a kvik.shop jejz FTP importuje. - Oddělovač: `;` středník - Enclosure: `"` dvojité uvozovky - Character escaping: `"\""` - Znakový sada: UTF-8 - Speciální UTF-8 znaky nejsou povoleny. - První řádek musí obsahovat hlavičku sloupců. - Pořadí sloupců je definováno a musí být zachováno. - Desetinná čísla mají jako oddělovač tečku `12345.23`. Číslo není nijak formátováno. ### Definice sloupců | Pořadí od nuly | Název sloupce | Popis | Ukázka | Povinné? | | :------------- | :------------ | :-----| :----- | :----------------- | | 0 | jkpov | | 0 986 AH0 811 | povinné | | 1 | id_vyrobce | TecDoc ID vyrobce; například 30 pro BOSCH | 30 | povinné | | 2 | nazev | Název produktu | Multifunkční relé BOSCH 0 986 AH0 811 | povinné | | 3 | sazba | Procentuální sazba DPH jako číslo | 21 | povinné | | 4 | cenabdph | Prodejní cena bez DPH. | 61.98 | povinné | | 5 | nc | Nákupní cena bez DPH. | 49.22 | nepovinné | | 6 | tecdoc | TecDoc číslo položky. Pouze pro TecDoc produkty. | 0 986 AH0 811 | nepoviné | | 7 | vyrobce | Název výrobce | BOSCH | povinné | | 8 | skupina | ID/kód skupiny | 30 | nepovinné | | 9 | ean | EAN číslo. Více čísel oddělených svislítkem. | 4047024511361 | nepovinné | | 10 | stav | Počet dostupných kusů. Bude se brát v potaz jako celé číslo, i když bude uvedeno desetinné. | 3.00 | povinné | | 11 | sklad_pozice | Skladová pozice daného produktu z produktové karty. | A22 | nepovinné | Automatické odesílání e-mailů (a SMS). E-shop může co 15 minut v nastaveném čase (obvykle mezi 6. a 18. hodinou UTC) kontrolovat změny stavů objednávek v APSI. Pokud je stav objednávky v APSi změněn, e-shop pošle automaticky informační email zákazníkovi. Pokud máte v e-shopu modul pro odesílání SMS, tak zároveň pošle i informační SMS. Jde o stejné e-maily, které můžete poslat ručně v administraci e-shopu na detailu objednávky. Tato funkcionalita není ve výchozím stavu zapnutá a její příprava je jednorázově zpoplatněna. 1. APSi stav "Schvalováno" Když změníte objednávku v APSi do stavu Schváleno, e-shop pošle email Zpracovává se. 2. APSi stav "Schváleno" Když změníte objednávku v APSi do stavu Schváleno tak e-shop pošle email:. A) Čeká na zaplacení, pokud je objednávka s platbou bankovním převodem a ještě není v e-shopu označena jako zaplacena B) Připraveno k odběru na prodejně, pokud je objednávka s osobním odběrem. 3. APSi stav "Rezervováno" Když změníte objednávku v APSi do stavu Rezervováno, e-shop pošle email Připraveno k odběru na prodejně, pokud je objednávka s osobním odběrem. 4. APSi stav "Expedováno – Fakturováno". Když změníte objednávku v APSi do stavu Expedováno – Fakturováno, e-shop pošle email Expedováno, pokud se jedná o dopravu nějakého dopravce. E-mail se neodešle, pokud je doprava u objednávky typu osobní odběr na prodejně nebo typu rozvoz po okolí (do servisů). Pokud byste jednu objednávku změnili v APSi vícekrát do stejného stavu, nestane se, že by e-shop poslal zákazníkovi stejný email/SMS vícekrát. Existuje pro toto ochrana a e-shop zde vždy pošle jeden typ e-mailu pouze jednou. E-shop standardně synchronizuje stavy objednávek (APSi → e-shop) mezi 6. a 18. hodinou UTC. Znamená to, že pokud by v APSi někdo změnil stav objednávky například v 23:00, tak se e-mail/SMS zákazníkovi pošle až další den ráno. Díky tomu nebudou zákazníci otravování v nočních hodinách, i kdybyste během těchto hodin objednávky připravovali a měnili jejich stav APSi. Stahují se mé objednávky do APSi? Zda byla objednávka exportována z našeho systému do APSi, si můžete snadno ověřit v Administraci → Objednávky → detail objednávky → Historie objednávky. Pokud v Historii objednávky vidíte, že objednávka byla exportována, ale přesto není v APSi, kontaktujte APSi. Jak e-shop vyhledává kartu produktu v APSi? Kartu e-shop v databázi APSi hledá vždy podle jkpov v tomto pořadí:. Takovou, která má jkpov shodné s katalogovým číslem (SKU) zadaným u produktu na e-shopu. Pokud katalogové číslo u produktu na e-shopu není vyplněno, tak se snaží najít kartu s jkpov podle konvencí APSi. Tedy jkpov shodné s MPN číslem, kde sloupec dodal je (TecDoc) ID výrobce. Pokud toto není možné najít, tak jako poslední možnost hledá kartu, která má jkpov stejné jako 20 místný vygenerovaný kód produktu na e-shopu. Důvod pro tento bod je vysvětlený níže u popisu zakládání nové karty. Pokud ani podle jednoho ze 3 hodnot kartu v APSi nenajde, vytvoří novou kartu s jkpov dle konvencí APSi. Druhý krok lze provést jen pokud je u produktu na e-shopu výrobce a číslo dílu vyplněno, jinak nejde hledání provést a tento krok se přeskočí. U dílů navázaných na TecDoc je z importu z dat dodavatelů obojí vyplněno. U druhého kroku se také hledá existující výrobce a jeho ID v databázi APSi. Pokud daný výrobce ještě v APSi založen není, e-shop je během tohoto kroku založí a vytvoří pro něj zkratku. Toto se děje ve vyjímečných případech, kdy výrobce z nějakého důvodu v APSi chybí. E-shop jej zakládá proto, aby mohl případnou novou kartu na daného výrobce v APSi navázat. Postup hledání karty produktu v APSi je stejný pro produkty s vazbou na TecDoc i bez ni.