CSV import umožňuje nahrávat nákladová data dopravy pro výpočet analýzy nákladů a ziskových marží. Tato funkce je užitečná pro dopravce bez automatického zpracování faktur nebo pro doplnění chybějících informací.

Kdy použít CSV import

Import nákladových dat od dopravců bez automatického zpracování
Doplnění cenových informací o zákazníkovi, které nejsou v objednávkovém feedu
Import historických dat pro analýzu nákladů
Testování funkčnosti analýzy nákladů s vlastními daty

Formát CSV souboru

Technické požadavky

Formát: CSV (Comma Separated Values)
Kódování: UTF-8
Oddělovač: Čárka (,)
Uvozovky: Dvojité uvozovky (") pro pole s čárkami nebo uvozovkami
Hlavička: První řádek musí obsahovat názvy sloupců (case-sensitive)
Struktura: Všech 9 sloupců musí být přítomno v každém řádku

Specifikace sloupců

Sloupec	Povinný	Popis	Příklad
`tracking_number`	Ano	Unikátní identifikátor zásilky (max. 255 znaků)	Z123456789
`carrier_currency`	Ano	ISO 4217 kód měny dopravce (3 velká písmena)	EUR, CZK
`carrier_price`	Ano	Náklady dopravce (max. 4 desetinná místa)	15.50
`weight`	Ne	Hmotnost v kg (max. 3 desetinná místa)	2.5
`number_of_packets`	Ne	Počet balíků (výchozí: 1)	1
`invoice_date`	Ne	Datum faktury (formát YYYY-MM-DD)	2025-01-15
`customer_currency`	Ne	ISO 4217 kód měny zákazníka	EUR
`customer_price`	Ne	Částka účtovaná zákazníkovi	18.50
`customer_email`	Ne	E-mail zákazníka pro párování zásilek	[email protected]

Důležité: Sloupce customer_currency a customer_price musí být zadány společně. Pokud vyplníte jeden, musíte vyplnit i druhý.

Párování zásilek

Kritické: Formát tracking_number musí být identický s formátem v objednávkové integraci. Jakékoliv rozdíly (mezery, pomlčky, velká/malá písmena) způsobí, že se zásilka nespáruje.

Pravidla pro úspěšné párování

Identický formát: "ABC-123-456" v integraci = "ABC-123-456" v CSV
Velká/malá písmena: "abc123" ≠ "ABC123"
Mezery a znaky: "ABC 123" ≠ "ABC123"
Předpony/přípony: Zachovejte všechny (např. "CZ" před číslem)

Vylepšené párování pomocí customer_email

Při duplicitních zásilkách se stejným tracking_number systém využije customer_email pro přesnější párování. Pokud více zásilek sdílí stejné číslo, systém se pokusí spárovat podle e-mailu zákazníka z objednávky.

Způsoby importu

1. E-mailový import (doporučený)

V Nastavení > Analýza nákladů najděte e-mailovou adresu pro import
Odešlete e-mail s předmětem "CSV import" (přesně takto)
Přiložte CSV soubor
Systém automaticky zpracuje soubor

2. Přímý upload

Přejděte do Nastavení > Analýza nákladů
Použijte sekci pro CSV import
Vyberte soubor a klikněte na import

Příklady CSV souborů

Minimální data (pouze náklady dopravce)

tracking_number,carrier_currency,carrier_price,weight,number_of_packets,invoice_date,customer_currency,customer_price,customer_email
Z123456789,EUR,15.50,,,,,,

Kompletní data včetně zákaznických cen

tracking_number,carrier_currency,carrier_price,weight,number_of_packets,invoice_date,customer_currency,customer_price,customer_email
Z123456789,EUR,15.50,2.5,1,2025-01-15,EUR,18.50,[email protected]
12345678901,CZK,350.00,1.2,1,2025-01-15,CZK,420.00,[email protected]

Zpracování dat

Konverze měn

Všechny měny se automaticky převádějí na CZK
Kurz se určuje podle invoice_date nebo aktuálního data
Měny dopravce a zákazníka se převádějí nezávisle

Zákaznické ceny

Data z CSV mají přednost před daty z objednávkového feedu
Umožňují výpočet marží i bez kompletních objednávkových dat
Užitečné když objednávkový feed neobsahuje přesné náklady na dopravu

Řešení problémů

Nejčastější chyby

Chyba	Řešení
Chybějící sloupce	CSV musí obsahovat všech 9 sloupců
Neplatná měna	Použijte ISO 4217 kód (3 velká písmena)
Špatný formát data	Použijte formát YYYY-MM-DD
Zásilka se nespárovala	Ověřte formát tracking_number v Trackingu
E-mail se nezpracoval	Předmět musí být přesně "CSV import"