MyÚčto MyÚčto.cz Manuál
Stáhnout PDF Zpět na hlavní stránku

37. Shoptet

Stránka E-shop → Shoptet napojí e-shop na platformě Shoptet bez jeho API. Stačí exporty a importy souborů, které Shoptet nabízí na všech tarifech:

Stránka má čtyři záložky: Objednávky, Doklady, Export pro Shoptet a Nastavení. U každé je krátký návod krok za krokem. Stránka je součástí skladového modulu a řídí se oprávněním k e-shopu. Zakládání objednávek navíc vyžaduje oprávnění k prodejním objednávkám a import dokladů oprávnění vystavovat faktury.

37.1 Kdo vystavuje doklady

V jednom e-shopu smí daňové doklady vystavovat právě jeden systém. Jinak se tatáž tržba zaeviduje dvakrát. V záložce Nastavení proto zvolte:

VolbaCo to znamená
MyÚčto (doporučeno)V Shoptetu vypněte automatické vystavování dokladů. Faktury vystavíte z importovaných objednávek v MyÚčtu. DPH, OSS i číselná řada jsou pod kontrolou MyÚčta. Import dokladů ze Shoptetu je vypnutý.
ShoptetDoklady vystavuje Shoptet a MyÚčto je převezme importem s původním číslem. Z objednávek ze Shoptetu MyÚčto doklad nevystaví. Pokus o vystavení faktury z takové objednávky skončí hláškou, že doklady vystavuje Shoptet.

Režim MyÚčto je doporučený: MyÚčto zná vlastní zařazení DPH (OSS, přenesení daňové povinnosti) a nepřebírá výpočet jiného systému. Shoptet počítá DPH položky jako rozdíl ceny s DPH a bez DPH, takže se součty mohou lišit o haléře.

37.2 Nastavení exportu objednávek v Shoptetu

  1. V administraci Shoptetu otevřete Objednávky → Export.
  2. Vytvořte vlastní šablonu ve formátu XML nebo zkopírujte systémovou šablonu Shoptet - XML. Pro CSV zapněte export jednotlivých položek objednávky a řádek s hlavičkou.
  3. Šablona musí obsahovat:
  1. V poli Zahrnout objednávky zvolte Všechny. Změny od posledního stažení si MyÚčto hlídá samo.
  2. V Nastavení → Administrace → Zabezpečení exportů vytvořte partnera s hashem a povolte stahování jen z IP adresy serveru MyÚčta.
  3. Zkopírujte trvalý odkaz exportu (tvar https://…/export/orders.xml?patternId=…&hash=…) a vložte ho v MyÚčtu v záložce Nastavení → Odkaz na export objednávek.

Odkaz obsahuje hash, se kterým jde stáhnout údaje zákazníků. MyÚčto ho ukládá šifrovaně a zobrazuje jen zkráceně. Stahuje jen přes https a jen z veřejné adresy e-shopu.

Co musí obsahovat soubor

MyÚčto čte XML ve tvaru systémové šablony Shoptetu. Kořen je ORDERS, každá objednávka je ORDER a obsahuje:

U CSV MyÚčto pozná oddělovač sám (středník, čárka, tabulátor). Kódování může být UTF-8 i Windows-1250. Sloupce páruje podle názvu: přijímá názvy placeholderů Shoptetu (například code, billCompanyId, orderItemCode, orderItemVatRate) i české popisky. Neznámé elementy a sloupce se ignorují. Chybí-li objednávce kód, množství, cena nebo sazba DPH, zobrazí se chyba jen u této objednávky, ostatní se naimportují.

37.3 Import objednávek

V záložce Objednávky:

  1. Nahrajte export (XML nebo CSV, nejvýš 20 MB) a klikněte na Náhled souboru, nebo klikněte na Stáhnout z odkazu.
  2. Náhled ukáže, co se s každou objednávkou stane: založí se, aktualizuje se, zůstane beze změny, změna se nepřevezme, nebo chyba. U objednávek jsou i upozornění a důvody ke kontrole DPH. Nic se zatím neuložilo.
  3. Klikněte na Importovat objednávky. Objednávky vzniknou v Prodejní objednávky.

Co se přenáší:

Když se objednávka v Shoptetu změní a importujete ji znovu:

Stav objednávky v MyÚčtuCo se stane
rozpracovaná, bez fakturypřepíše se podle Shoptetu
potvrzená, vyfakturovaná, stornovaná nebo uzavřenázměna se nepřevezme a objednávka se objeví v přehledu ke kontrole

Doklad se nikdy nepřepisuje. Změnu vyfakturované objednávky řešte opravným dokladem.

Volba Importované objednávky rovnou potvrdit a rezervovat zásobu v nastavení objednávky rovnou potvrdí. Když zásoba nestačí, objednávka zůstane rozpracovaná a v reportu je upozornění.

Po importu lze v přehledu Poslední dávky smazat objednávky, které dávka založila. Smažou se jen rozpracované nebo stornované objednávky bez faktury, výdeje a vratky.

37.4 Kontrola DPH u objednávek

MyÚčto uloží údaje Shoptetu o DPH: zemi doručení, IČO, DIČ, sazby a případně režim DPH. Porovná je s vlastním zařazením plnění. Objednávku označí ke kontrole, když:

Objednávku ke kontrole nejde vyfakturovat. V přehledu Objednávky ke kontrole si objednávku otevřete, zkontrolujte zařazení a klikněte na Kontrola hotová.

37.5 Automatické stahování objednávek

V nastavení zapněte Stahovat objednávky automaticky a zvolte interval (15 minut až jednou denně). Stahování zajišťuje cron úloha cron-shoptet-orders (viz kapitola Po instalaci).

37.6 Import dokladů ze Shoptetu

Jen v režimu Doklady vystavuje Shoptet. V režimu MyÚčto je import odmítnutý, aby nevznikla dvojí fakturace.

  1. V Shoptetu otevřete Nastavení → Objednávky → Doklady → Export dokladů a zapněte Používat formát ISDOC.
  2. V přehledu Daňové doklady klikněte na Export, zvolte XML (ISDOC), období a měnu. Stejně exportujte Dobropisy a Doklady k přijaté platbě.
  3. Zálohové faktury Shoptet ve formátu ISDOC nevydává. Exportujte je jako XML (Pohoda).
  4. V záložce Doklady nahrajte soubory nebo ZIP a klikněte na Importovat doklady.

Jak se doklady uloží:

Doklad uložený jako koncept. Faktura, která odečítá zálohy (v souboru je odpočet zaplacené nebo zdaněné zálohy), nebo jejíž součet řádků se od dokladu liší o víc než 1 Kč, se uloží jako koncept a v reportu je u ní varování. Koncept nejde do DPH ani do pohledávek. Odpočet zálohy je v souboru mimo řádky dokladu, a kdyby se faktura převzala jako vystavená, tatáž platba by se zdanila podruhé (jednou na dokladu k přijaté platbě, podruhé na faktuře). Fakturu otevřete, navažte ji na daňový doklad k záloze, zkontrolujte částky a teprve pak ji vystavte. Stejně se chová i běžný import vydaných faktur (viz Importy).

Druhá faktura k téže objednávce se odmítne. Když má objednávka ze Shoptetu už navázanou fakturu (nebo je v téže dávce jiná faktura ke stejné objednávce), další faktura se nenaimportuje a report uvede, ke které faktuře objednávka patří. Tatáž tržba by se jinak zaevidovala dvakrát. Dobropis a doklad k přijaté platbě k téže objednávce projdou, opakovaný import navázané faktury se přeskočí jako duplicita.

Report importu je stejný jako u běžného importu faktur a dávku lze zahodit, dokud doklady nejsou zaúčtované ani uhrazené (viz Importy).

37.7 Export zásob a cen pro Shoptet

Shoptet umí automaticky importovat produkty z XML feedu na adrese URL. MyÚčto tento feed vystavuje.

  1. V záložce Export pro Shoptet klikněte na Vygenerovat odkaz na feed a odkaz zkopírujte. Zobrazí se jen jednou. MyÚčto si ukládá jen jeho otisk, takže ho později nezobrazí. Můžete jen vygenerovat nový odkaz (starý tím přestane platit), nebo feed vypnout.
  2. V administraci Shoptetu otevřete Produkty → Import → Automatické importy a přidejte import z URL.
  3. Vložte odkaz, zvolte formát Shoptet XML a párování podle kódu produktu. V aktualizačním importu zaškrtněte jen Sklad, případně Cenu.
  4. Na kartách zboží v MyÚčtu zapněte export na e-shop. Kód karty musí být stejný jako kód produktu nebo varianty v Shoptetu.

Co feed obsahuje:

Feed je stabilní, bez časového razítka, a nese hlavičky ETag a Last-Modified. Shoptet ho zpracuje jen tehdy, když se od posledního importu změnil. Formát vychází ze specifikace Shoptet XML (Relax NG products-supplier-v10.rng).

Ruční stažení: tlačítko Stáhnout XML stáhne tentýž feed. Stáhnout CSV připraví soubor pro ruční import produktů v Shoptetu (Produkty → Import) se sloupci code, pairCode, stock, price a includingVat. Oddělovač je středník, kódování UTF-8. CSV obsahuje jen produkty bez variant, protože varianty Shoptet páruje přes svůj párovací kód. Ten MyÚčto nezná, varianty proto přenášejte XML feedem. Vynechá také produkty, jejichž kód začíná znakem =, +, - nebo @: tabulkový procesor by kód četl jako vzorec. Takové produkty přenese XML feed.

Samostatný formát jen pro zásoby Shoptet nemá. Aktualizaci skladu umí jen XML feed (automaticky) a import produktů v CSV nebo XLSX (ručně).

37.8 Omezení

37.9 Doporučení