Návody

Nastavení pro účetní systém Helios Nephrite

Aktualizováno 15.08.2026
Kategorie: Účetní systémy (ERP)
Štítky: Helios Nephrite

Tento návod platí pro Helios Nephrite (Asseco Solutions). Obecné ovládání aplikace najdete v základní příručce.

Jak propojení funguje

Helios Nephrite nabízí oficiální REST API pro e-shopy. ShopSync s ním komunikuje po síti – žádný program se nespouští, do databáze se nezasahuje.

  • Čtení: produkty (včetně variant a obrázků), ceník, skladové zásoby, kategorie, zákazníci.
  • Zápis: objednávky (včetně založení zákazníka).

Omezení daná výrobcem API: nepřenáší se faktury (faktura se vystavuje v Heliosu), reklamace ani storna objednávek a API neřeší jazykové mutace.

Co si připravte předem

Vše následující vám poskytne váš správce Heliosu / partner Asseco:

  1. Modul REST API pro e-shopy nainstalovaný a licencovaný, publikovaný na adrese dostupné z počítače se ShopSyncem. Zřízení a licencování REST API domluvte přímo s Assecem / svým partnerem Asseco.
  2. Tři připojovací údaje:
    • adresu API (např. http://99.86.97.44:5001),
    • adresu aplikačního serveru Heliosu (jiná adresa, typicky ve tvaru http://server/HeliosNephrite; posílá se při přihlášení a může být na serveru přednastavená – pak se nevyplňuje),
    • název databázového profilu (obdoba „agendy"; také může být přednastavený).
  3. Uživatele Heliosu pro ShopSync (jméno + heslo) s právy číst produkty, ceníky, sklady, kategorie a zákazníky a zapisovat zákazníky a objednávky.
  4. Nastavené vlastní atributy na kartách zboží – ShopSync se řídí atributy: aktiv_eshop (karta se přenáší na e-shop), viditelna_eshop, akce, nazev_varianty, pozice a vazbami na hlavní kartu produktu, obrázky a výrobce. Atributy a vazby zakládá implementátor Heliosu podle naší specifikace.
  5. Kód zboží (referenceId) vyplněný a jedinečný – páruje se s kódem v e-shopu.
  6. ID ceníku pro e-shopové ceny a ID skladu pro objednávky.
  7. Číselné identifikátory přepravních metod pro párování dopravy.

Pole na záložce „Připojení k IS"

Helios Nephrite se nevybírá v rozbalovacím seznamu Typ – napojení nastavuje náš technik volbou knihovny v technickém nastavení profilu. Běžná pole:

Pole Co vyplnit u Helios Nephrite
IČ IČO vaší firmy (informativně).
Domácí měna CZK (resp. EUR) – cizoměnové objednávky se poznají podle ní.
DPH sazby Informativně; sazby se berou z ceníku Heliosu.
Cesta k .exe / Agenda / Rok / Cesta k databázi Nepoužívá se – nechte prázdné.
Uživatelské jméno / Heslo Nepoužívá se – přihlášení k API se zadává na záložce Nastavení (viz níže).
Odkladiště souborů Pracovní složka ShopSyncu (nutná – ukládají se sem pomocné soubory synchronizace).

Záložka Nastavení

Pro Helios Nephrite se položky zadávají ručně do sekce 8. Ostatní (automatická inicializace je nevytvoří):

Položka Význam
helios_api_url Adresa REST API, např. http://99.86.97.44:5001.
helios_server_url Adresa aplikačního serveru Heliosu, např. http://server/HeliosNephrite (pokud není na serveru přednastavená).
helios_db Název databázového profilu (pokud není přednastavený).
helios_user Přihlašovací jméno uživatele pro API.
helios_pass Heslo tohoto uživatele.
debug Podrobnost logu (2–3) – jen pro řešení problémů.

Sekce 2. Způsoby platby – vlevo název platby z e-shopu, vpravo kód platby Heliosu z pevného seznamu (např. paymentOrder = převodem, cash = hotově, cashOnDelivery = dobírka, paymentCard = kartou). Jiné hodnoty se ignorují.

Sekce 3. Způsoby dopravy – vlevo název dopravy z e-shopu, vpravo číselné ID přepravní metody z Heliosu.

ID ceníku a skladu pro objednávky nastavuje náš technik v přenosovém skriptu – od vás potřebujeme jen informaci, který ceník a sklad se má používat.

Časté problémy

  • Přihlášení selže – zkontrolujte všechny tři připojovací údaje (API URL, server URL, profil) a jméno/heslo; účet nesmí být jen doménový.
  • Produkt se nepřenáší – karta nemá atribut aktiv_eshop = A, nebo chybí referenceId (kód zboží).
  • Synchronizace trvá dlouho – API má omezení počtu požadavků; u velkých katalogů je delší doba běhu normální.

Zpětné hlášení stavu objednávky a čísla zásilky do e-shopu je možné jako zakázková úprava – řeší se přes vlastní atributy (např. stav_eshop, cislo_baliku), které zakládá implementátor Heliosu. Zájem proberte s námi.