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.