Helios Red

Export dokumentů z Alice do účetního systému Helios Red probíhá formou CSV souborů zabalených do ZIP archivu. Jedná se o jednosměrný offline export -- data se exportují z Alice do Helios Red, a poté je uživatel ručně importuje do účetního systému.

Typ integrace

Export Helios Red je offline export -- vytváří se CSV soubory ke stažení, které následně importujete do účetního systému. Neprobíhá žádné online propojení ani automatická synchronizace.

Jak to funguje?

Po označení dokumentu k exportu (stav K exportu) Alice vygeneruje ZIP archiv se dvěma CSV soubory (PRIFAK.csv + PRIPOL.csv). Soubor si uživatel ručně stáhne a naimportuje do Helios Red. Po stažení Alice doklad označí jako Exportovaný. Při neúspěšném vygenerování doklad zůstane ve stavu Chyba -- viz Diagnostika. Přehled všech stavů viz Stavy dokumentů.

Schéma datového toku

graph LR
    A[Alice] -->|ZIP s CSV| B[Helios Red]

Žádné online propojení -- mezi Alice a Helios Red figuruje uživatel s ručním přenosem souboru.

Podporované verze a předpoklady

Oblast	Požadavek
Aplikace	Helios Red s podporou importu CSV
Typ integrace	Offline -- CSV soubory ke stažení
Síť	Žádné připojení mezi Alice a Helios Red
Můstek	Není potřeba
Hromadný export	Nepodporován -- exportuje se vždy 1 doklad jako 1 ZIP

Podporované typy dokumentů

Typ dokumentu	Podpora
Přijaté faktury	Podporováno
Účtenky	Nepodporováno
Vydané faktury	Nepodporováno
Slovenské faktury	Nepodporováno
Dobropisy	Nepodporováno
Zálohy	Nepodporováno
Objednávky	Nepodporováno

Omezení exportu

Export do Helios Red je možný pouze pro jednotlivé dokumenty -- hromadný export není podporován.

Jak export funguje

Export do Helios Red probíhá v těchto krocích:

V Alice otevřete českou přijatou fakturu, kterou chcete exportovat
V detailu dokumentu vyberte možnost exportu Helios Red (CSV)
Systém automaticky vytvoří ZIP soubor obsahující dva CSV soubory
Stáhnete ZIP soubor na svůj počítač
Rozbalíte ZIP archiv a získáte dva CSV soubory
Tyto soubory importujete do Helios Red systému
V Helios Red zkontrolujete správnost importovaných dat

Pojmenování souboru

Exportovaný soubor má název ve formátu: heliosRed_{nazev_puvodniho_souboru}_{timestamp}.zip

Například: heliosRed_faktura_2024_001_132456789012345.zip

Struktura exportovaného souboru

ZIP archiv obsahuje dva CSV soubory:

PRIFAK.csv - Hlavička dokladu

Obsahuje hlavní informace o přijaté faktuře.

Sloupec	Popis
CISLO	Číslo řádku (vždy `1`)
DATUM	Datum vystavení faktury (formát dd-MM-yyyy)
DATUM2	Datum zdanitelného plnění (formát dd-MM-yyyy)
DOKLAD	Číslo faktury
DOKLAD2	Variabilní symbol
CIS	Číslo zákazníka -- vždy konstanta `0` (Alice neumí přiřadit zákaznický kód v Helios Red)
TEXT	Fakturační adresa dodavatele
KCS	Celková částka včetně DPH
ZN	Základ s nulovou sazbou DPH
Z0	Základ s nulovou sazbou DPH (duplikát ZN -- Helios Red očekává oba sloupce)
Z5	DPH 12 %
D5	Základ DPH 12 %
Z23	DPH 21 %
D23	Základ DPH 21 %
DRUH	Druh dokladu -- vždy konstanta `FP` (Faktura přijatá)
DATSPL	Datum splatnosti (formát dd-MM-yyyy)
DOD_ICO	IČO dodavatele
POZNAMKA	Poznámka k dokladu
STRED	Nákladové středisko (vyžaduje vlastní pole)
STRED2	Zakázka/kontrakt (vyžaduje vlastní pole)

PRIPOL.csv -- Řádky položek

Obsahuje souhrnný řádek dokladu (ne jednotlivé položky -- viz upozornění níže).

Sloupec	Popis
P_CISLO	Číslo řádku (vždy `1`)
P_TYP	Datum vystavení (formát dd-MM-yyyy)
P_DRUH	Druh dokladu -- vždy konstanta `FP` (Faktura přijatá)
P_TEXT	Fakturační adresa dodavatele (ne text položky)
P_CELKEM	Celková částka dokladu
P_CM	Cizí měna -- vždy konstanta `0` (cizí měny nejsou podporovány)
P_ZAKLAD	Základ DPH 21 % (z hlavičky dokladu)
P_PROCENTO	Procento DPH -- vždy konstanta `21`
P_DAN	Částka DPH 21 % (z hlavičky dokladu)
P_MAJETEK	Příznak majetku -- vždy konstanta `.F.` (False)

Omezení položek

Aktuální verze exportu nepřenáší jednotlivé položky dokladu. Místo toho se vygeneruje jeden souhrnný řádek z hodnot na hlavičce dokladu, a to pouze pro sazbu 21 %:

Hodnoty P_PROCENTO, P_ZAKLAD, P_DAN jsou pevně dané pro 21% sazbu
Pokud má doklad položky v 12 % nebo 0 %, do CSV se nepropíší a po importu do Helios Red bude potřeba částky doplnit ručně

Technické parametry CSV

Kódování: Windows-1250 (kompatibilní s českými znaky)
Oddělovač: Čárka (,)
První řádek: Obsahuje názvy sloupců
Formát data: dd-MM-yyyy

Mapování polí dokumentu

Při exportu se data z Alice automaticky mapují do polí CSV souborů:

Identifikační údaje

Pole v Alice	Sloupec v CSV
Číslo faktury	DOKLAD
Variabilní symbol	DOKLAD2
IČO dodavatele	DOD_ICO

Datumy

Pole v Alice	Sloupec v CSV
Datum vystavení	DATUM
Datum zdanitelného plnění	DATUM2
Datum splatnosti	DATSPL

Částky a DPH

Pole v Alice	Sloupec v CSV
Celková částka	KCS
Základ DPH 21%	D23
DPH 21%	Z23
Základ DPH 12%	D5
DPH 12%	Z5
Základ DPH 0%	Z0, ZN

Textové informace

Pole v Alice	Sloupec v CSV
Fakturační adresa	TEXT
Poznámka	POZNAMKA

Podporované DPH sazby

Export do Helios Red podporuje následující sazby DPH:

21% - základní sazba DPH
12% - snížená sazba DPH
0% - osvobozeno od DPH

Omezení měn

Export aktuálně nepodporuje cizí měny. Všechny částky musí být v základní měně účetní jednotky (CZK).

Volitelná pole - Středisko a Zakázka

Export podporuje mapování vlastních polí pro:

Nákladové středisko → sloupec STRED
Zakázku/kontrakt → sloupec STRED2

Nastavení vlastních polí

Pro export střediska nebo zakázky je potřeba vytvořit vlastní pole typu ENUM s mapováním na:

Středisko - pro sloupec STRED
Zakázku - pro sloupec STRED2

Více informací o nastavení vlastních polí najdete v sekci Vlastní pole.

Import do Helios Red

Po stažení a rozbalení ZIP souboru s CSV soubory postupujte následovně:

Přihlaste se do účetního systému Helios Red
Přejděte do sekce pro import dat
Vyberte možnost "Import z CSV souboru"
Nahrajte soubor PRIFAK.csv (hlavička dokladu)
Nahrajte soubor PRIPOL.csv (řádky položek)
Postupujte podle pokynů systému pro dokončení importu
Po importu zkontrolujte, zda byly všechny údaje správně nahrány

Kontrola dat

Po importu vždy zkontrolujte:

Správnost částek a sazeb DPH
Datum vystavení, zdanitelného plnění a splatnosti
Přiřazení střediska a zakázky (pokud používáte)
Údaje dodavatele (IČO, adresa)

Omezení exportu

Export Helios Red má následující omezení:

Omezení	Popis
Offline export	Žádné online propojení ani automatická synchronizace
Pouze české faktury	Export není dostupný pro SK faktury, účtenky nebo vydané faktury
Jednotlivý export	Nelze exportovat více dokumentů najednou (hromadný export)
Žádné číselníky	Nesynchronizuje se žádný číselník z Helios Red
Pouze CZK	Nepodporuje cizí měny
Ruční import	CSV soubory je nutné ručně importovat do Helios Red

Ukázkový soubor

HeliosRed_ukazkovy_dokument

Diagnostika

Vzhledem k offline charakteru exportu se chyby projeví obvykle dvěma způsoby:

Doklad nelze exportovat / chyba při generování ZIP

Příčina: Doklad nemá vyplněná povinná pole, nebo není označen ke správnému typu exportu.

Řešení: Zkontrolujte v náhledu dokumentu detail chyby a doplňte chybějící údaje (datum vystavení, číslo faktury, IČO dodavatele).

Helios Red odmítá importovat CSV

Příčina: Nesoulad v kódování, oddělovači nebo struktuře dat.

Řešení: Ověřte, že importujete oba CSV soubory (PRIFAK.csv před PRIPOL.csv). CSV jsou v kódování Windows-1250 -- otevřením v textovém editoru zkontrolujte čitelnost diakritiky.

Po importu chybí položky v jiných sazbách DPH

Příčina: Export přenáší pouze souhrn za sazbu 21 % -- viz omezení položek.

Řešení: Po importu částky pro 12 % a 0 % sazby doplňte v Helios Red ručně.

Časté dotazy | FAQ

Proč nelze exportovat více dokumentů najednou?

Hromadný export do Helios Red není momentálně podporován. Je potřeba exportovat každý dokument zvlášť. Export probíhá formou CSV souborů, které jsou optimalizovány pro jednotlivé dokumenty.

Jak nastavím mapování střediska a zakázky?

Pro export střediska nebo zakázky je potřeba vytvořit vlastní pole typu ENUM v nastavení typů dokumentů. Při vytváření vlastního pole vyberte mapování na "Středisko" (pro sloupec STRED) nebo "Zakázku" (pro sloupec STRED2). Poté můžete hodnoty vyplňovat v dokumentech a budou se exportovat do příslušných sloupců CSV.

Mohu exportovat vydané faktury nebo účtenky?

Ne, export Helios Red je momentálně dostupný pouze pro české přijaté faktury. Vydané faktury, účtenky a slovenské faktury nejsou podporovány.

Podporuje export faktur v cizí měně?

Ne, export Helios Red aktuálně nepodporuje cizí měny. Všechny částky musí být v základní měně účetní jednotky (CZK).

Jak importuji CSV soubory do Helios Red?

Po stažení a rozbalení ZIP archivu získáte dva CSV soubory (PRIFAK.csv a PRIPOL.csv). Tyto soubory importujte v Helios Red systému v sekci pro import dat. Nejprve importujte hlavičku dokladu (PRIFAK.csv) a poté řádky položek (PRIPOL.csv).

Proč má CSV soubor kódování Windows-1250?

Kódování Windows-1250 je standardní kódování pro české znaky v účetních systémech, včetně Helios Red. Zajišťuje správné zobrazení diakritiky při importu do systému.

Co znamená 'FP' ve sloupci DRUH?

FP je zkratka pro "Faktura Přijatá" a označuje typ dokladu v Helios Red systému. Tento kód je automaticky přiřazen při exportu.