Systém FOFR poskytuje služby pro online spolupráci s našimi obchodními partnery a zákazníky.
Služby pro import dat, sledování zásilek, výpočet ceny, tisk štítků, skeny přepravních listů a další využívají obvykle datové struktury XML.
Prosím nezapomínejte na ošetření speciálních znaků pro XML, dodržení deklarovaného kódování, délky textových polí a správné rozsahy hodnot 😉
Služby lze volat z jakékoliv IP adresy, ale maximální počet dotazů pro jednotlivé služby je omezen na 1500 za den.
Poté je služba odepřena a vrací textovou informaci o překročení limitů.
V odůvodněných případech je možné vyžádat navýšení tohoto limitu pro vaší IP.
- Sledování zásilek – Track and Trace – zásilka info (html, xml, json) – 60
- Výpočet ceny FOFR kompletní definice včetně zboží – 11
- Stažení naskenovaného přepravního listu – 12
- Vzdálenost a kódy středisek fofru podle psč – 13
- 16 – pohyby zásilky – textový formát s oddělovačem
- 17 – pohyby zásilky – vrácení stavu více zásilek najednou formát csv nebo xml
- 18 – pohyby zásilky – xml formát pro službu KdeJeBalík.cz
- 20 – Zobrazení mapy a kontaktů pro konkrétní pobočku FOFRU
- 21 – hromadné zasílání dobírek zúčtovacím centrem FOFR
- 22 – importní XML soubor do online systému
- 27 – číselník stavů FOFR
- 50 – popis tisku polepek zboží v systému FOFR
- 51 – seznam stavů zásilky FOFR status
- 51.1 – seznam stavů zásilky NETSPEDICE
- 52 – seznam států fofr
- 53 – číselník obvodů fofr pro ČR
- 54 – číselník obvodů fofr pro SK – pouze pro tisk polepek
- 55 – seznam doporučených kódů obalů
- 56 – seznam dep FOFR
- 57 – číselník ADR podle UN čísla
Sledování zásilky – Track and Trace
Zásilka info (pro objednatele, partnery) – 60
Informace obsahují kompletní adresy!
Ujistěte se, že máte potřebné souhlasy s nakládáním a sdílením informací s ohledem na GDPR a pod.
V případě, že rok neuvedete, předpokládá se aktuální rok a formát html
https://objednavky.fofrcz.cz/zasilka-info/3421452796
https://objednavky.fofrcz.cz/zasilka-info/3421452796/2023/html
https://objednavky.fofrcz.cz/zasilka-info/čísloZásilky/rok/formátVýstupu
Formáty pro snadnou integraci do vašich informačních systémů:
https://objednavky.fofrcz.cz/zasilka-info/3421452796/2023/json
https://objednavky.fofrcz.cz/zasilka-info/3421452796/2023/xml
https://objednavky.fofrcz.cz/zasilka-info/3421452796/2023/txt
Sledování zásilky vhodné pro zákazníky
(bez osobních údajů)
V případě, že rok neuvedete, předpokládá se aktuální rok a formát html
https://objednavky.fofrcz.cz/zasilka-sledovani/3815865798/2024
https://objednavky.fofrcz.cz/zasilka-sledovani/3815865798/2024/json
https://objednavky.fofrcz.cz/zasilka-sledovani/3815865798/2024/xml
Online výpočet ceny FOFR kompletní definice včetně zboží – 11
Doporučujeme: Výpočet ceny přes webovou službu (Soap): https://info.tfw.cz/import-objednavek-netspedice/2/#prepravaInfo
Parametry:
- company_center = CB středisko FOFRU pod které spadá objednavatel přepravy
- firm_id = 20126 číslo firmy objednavatele u pobočky FOFRU
- psc_od = 37001 psč nakládky
- psc_do = 62000 psč vykládky
- goods = 2 25 0,35 PALETA 0,45 0,12 0,7T^ 3 55 KARTON 0,12 0,7T 333123T definice zboží (detailní popis níže)
- dobirka =500 hodnota dobírky
- modul = F požadovaný modul – pokud zboží danému modulu neodpovídá, tak je vrácen modul odpovídající definici zboží
Výsledek je vrácen v XML formátu. Pokud je v elementu <PRICE_WITH_VAT> vypočtena částka, jsou parametry vyplněny správně.
V oddílu REQUEST je sumář vstupních parametrů v oddílu RESPONSE jsou výsledné hodnoty
<?xml version="1.0" encoding="utf-8"?>
<FOFR>
<REQUEST>
<COMPANY_ID>20126</COMPANY_ID>
<COMPANY_CENTER>CB</COMPANY_CENTER>
<ZIP_FROM>37001</ZIP_FROM>
<ZIP_TO>62000</ZIP_TO>
<COD>500</COD>
<GOODS> 2 25 0,35 PALETA 0,45 0,12 0,7T^ 3 55 KARTON 0,12 0,7T333123T</GOODS>
<MODUL>C</MODUL>
</REQUEST>
<RESPONSE>
<CENTER_FROM>CB</CENTER_FROM> kód pobočky psč z
<CENTER_TO>BR</CENTER_TO> kód pobočky psč do
<PRICE_WITH_VAT>224.70</PRICE_WITH_VAT> celková cena s dph
<PRICE_WITHOUT_VAT>185.70</PRICE_WITHOUT_VAT> celková cena bez DPH
<PRICE_COD>10.00</PRICE_COD> doběrečné v případě dobírky – tato částka je již zahrnuta v ceně
<GOODS_TOTAL_WEIGHT>80.00</GOODS_TOTAL_WEIGHT> zboží celkem hmotnost
<GOODS_TOTAL_VOLUME>0.3500</GOODS_TOTAL_VOLUME> zboží celkem objem
<GOODS_TOTAL_COLLI>5</GOODS_TOTAL_COLLI> poček kusů celkem
<DISTANCE_KM>193</DISTANCE_KM> vypočtený pásnový tarif FOFR (interní informace)
<SELECTED_MODUL>C</SELECTED_MODUL> vybraný modul přepravy na základě požadovaného/možného modulu
</RESPONSE>
</FOFR>
Zboží je nutno definovat pomocí pevných délek sloupců, prázdné znaky mohou být u numerických polí doplněné nulami, mezerami anebo znakem @ (vhodné pro čitelný zápis url). Zarovnání v rámci sloupce může být zprava nebo zleva. Jako oddělovač jednotlivých řádků zboží je použit znak ^(stříška).
Maximu řádků pro výpočet zboží v systému FOFR je 9. Každý řádek může obsahovat maximálně 99 kusů zboží stejného obalu.
Hmotnost a objem je možno uvádět za kusy celkem nebo za jednotlivý kus, rozlišuje se parametrem HMOBJ_CELKEM, kde T = hmotnost a objem celkem za všechny kusy pro daný řádek, F = hmotnost a objem za 1 kus, vynásobí se počtem kusů.
Pokud některé informace o zboží nevíte, zasílejte pouze celkový počet kusů a hmotnost.
Pokud bude zboží výrazně jinak definované oproti skutečnosti, bude zásilka převážena/přeměřena.
Jako oddělovač desetinných míst použijte čárku.
Popis polí definice zboží:
KUSY(5), HMOTNOST(7), OBJEM(7), OBAL(8), DELKA(6), VYSKA(6), SIRKA(6), HMOBJ_CELKEM(1), ADR_UN(7), ADR_SKUPINA(3), JE_TO_OBALKA(1)
Příklad:
2 25 0,35 PALETA 0,45 0,12 0,7T^ 3 55 KARTON 0,12 0,7T 333123
Příklad výše ukazuje 2 řádky zboží na prvním je:
2 kusy 25 kg 0,35m3 balení PALETA s rozměry 0,45×0,12×0,7 hmotnost a objem je uveden celkem za 2 kusy
na druhém je:
3 kusy 55kg bez uvedeného objemu balení KARTON, šířka 0,12 a délka 0,7 vše uvedeno celkem a následuje definice ADR, to znamená že k ceně bude připočítán ADR příplatek
Vrácení naskenovaného přepravního listu -12
Vrací Content-Type: image/jpeg obrázek je ve formátu jpg.
Sledování zásilek (track&trace) – 14
odkaz na track&trace : https://objednavky.fofrcz.cz/index.php?id=sledovani&rok=2021&shipment_num=3316506113

Vzdálenost a kódy středisek fofru podle psč – 15
https://objednavky.fofrcz.cz/vzdalenost.php?pscodes=69801&pscprij=81101¢re_origin=OV
UH^UH^15 (do roku 2018) – Data se načítají z číselníku konkrétní pobočky (kopie na wedosu) podle prvního psč.
https://objednavky.fofrcz.cz/kody-a-vzdalenost.php?pscodes=37001&pscprij=81101¢re_origin=CB
UH^SK^300^S2 (od roku 2018) – Data se načítají z číselníku konkrétní pobočky (kopie na wedosu) podle prvního psč. Výsledek vrátí text kód střediska pro pscodes, pscprij a teoretickou vzdálenost v km pro výpočet ceny v sazebníku fofr. To je důležité například pro vlastní tisk polepek FOFRu, kdy je nutno uvést kód zakládacího, podacího a dodacího střediska.
Nově vrací také kód pobočky pro polepku na/z Slovenska. Tento kód (v tomto případě S2) je nutné použít pouze pro tisk polepek a do dat a čárových kódů stále nahrávat kód SK.
Pohyby zásilky – textový formát s oddělovačem – 16
^OL^2017-01-12^OL/D/1/88-svážená - MAREK Jaroslav 734853638-^ ^OL^2017-01-12^OL/P/1/9-přepravovaná - Vavřiník Martin = CP !!!!! 605756678-^ ^CP^2017-01-12^CP/P/1/9-převzatá - Vavřiník Martin = CP !!!!! 605756678-^ ^CP^2017-01-12^CP/T/1/171-přepravovaná - -^ ^CB^2017-01-13^CB/T/1/171-převzatá - -^ ^CB^2017-01-13^CB/D/1/62-rozvážená - Michal Kubíček 736 520 747-^ ^CB^2017-01-13^CB///-odeslaná placená SMS - -^ ^CB^2017-01-13^CB/D/1/62-doručená - Michal Kubíček 736 520 747-^
Pohyby zásilky – vrácení stavu více zásilek najednou formát csv nebo xml – 17
- 1 – informace o posledním stavu zásilky
- 2 – elementy pro čas události a pokud existují údaje z aplikace řidiče datum a čas převzetí, předání zásilky zákazníkovi
- 3 – datum uhrazení dobírky zúčtovacím centrem


Pohyby zásilky – xml formát pro službu KdeJeBalík.cz -18
https://objednavky.fofrcz.cz/procedure/track_and_trace_sledovani_zasilek.php?shipment=3319181043
<trackandtrace>
<FOFR ID="6090013481" CentreOrigin="PL" CentreFrom="PL" CentreTo="OV" Code="" Colli="1" Weight="100.00" Volume="0.000">
<Statuses>
<Status StCode="1" StDate="2014-7-21 8:34" Depo="PL" Kontakt="Kratochvíl" StInfo=""/>
<Status StCode="4" StDate="2014-7-21 17:50" Depo="PL" Kontakt="Kalcovský" StInfo=""/>
<Status StCode="2" StDate="2014-7-22 0:36" Depo="CP" Kontakt="Kalcovský" StInfo=""/>
<Status StCode="4" StDate="2014-7-22 0:39" Depo="CP" Kontakt="" StInfo=""/>
<Status StCode="3" StDate="2014-7-22 1:26" Depo="CP" Kontakt="" StInfo=""/>
<Status StCode="3" StDate="2014-7-22 1:26" Depo="CP" Kontakt="Kalcovský" StInfo=""/>
<Status StCode="16" StDate="2014-7-22 5:22" Depo="CP" Kontakt="Inventura CP" StInfo=""/>
<Status StCode="4" StDate="2014-7-22 18:43" Depo="CP" Kontakt="" StInfo=""/>
<Status StCode="2" StDate="2014-7-23 7:36" Depo="OV" Kontakt="" StInfo=""/>
<Status StCode="5" StDate="2014-7-24 7:58" Depo="OV" Kontakt="Uhlíř Vladimír 739 452 476" StInfo=""/>
<Status StCode="6" StDate="2014-7-24 16:28" Depo="OV" Kontakt="Uhlíř Vladimír" StInfo=""/>
</Statuses>
</FOFR>2p1i4b
</trackandtrace>
Zobrazení mapy a kontaktů pro konkrétní pobočku FOFRU – 20
Hromadné zasílání dobírek zúčtovacím centrem FOFR – 21
Pokud má zákazník denně více dobírek, je možné tyto dobírky sdružit do jedné hromadné platby a tu zasílat na účet odesílatele. Současně se vytvoří e-mail a odešle se informace, jaké přepravy jsou v balíku plateb zahrnuty. Sdružené zasílání dobírek je možné pouze po domluvě s dispečerem zúčtovacího centra dobírek, kontakt zde.
Zasílaný soubor je ve formátu csv a obsahuje tyto pole:
- Variabilní symbol platby
- Číslo zásilky FOFR
- Částka
- Měna
- Příjemce
- Externí barcode (pro SK)
- Datum doručení zásilky
příklad souboru zde:
https://info.tfw.cz/wp-content/priklady_souboru/320135.csv

Importování dat do systému online systému FOFR NetSpedice – 22
Číselník stavů FOFR – 27
Online načítání z databáze
pro seznam stavů FOFR je možno použít čísleník zde:
Popis polepek zboží tištěných pro systém FOFR – 50
https://info.tfw.cz/polepka-zbozi-pro-prepravni-system-fofr/
Seznam stavů fofr – 51
Seznam stavů, které vrací online služby pro pohyb zásilky fofr:
| ID stavu | Název stavu | Skupina stavu |
|---|---|---|
| 0 | evidovaná | Evidovaná |
| 1 | svážená | Zásilka je přepravována. |
| 2 | převzatá | Zásilka je přepravována. |
| 3 | skladovaná | Zásilka je přepravována. |
| 4 | přepravovaná | Zásilka je přepravována. |
| 5 | rozvážená | Zásilka je přepravována. |
| 6 | doručená | Zásilka doručena |
| 7 | vyložená | Zásilka je přepravována. |
| 8 | ztracená | Evidovaná |
| 9 | zrušeno | Zrušená přeprava |
| 10 | vyložená navíc | Zásilka je přepravována. |
| 11 | nedoručená | Zásilka je přepravována. |
| 12 | přepravovaná středisková | Zásilka je přepravována. |
| 13 | nezvěstná | Zásilka je přepravována. |
| 14 | dodatečné naložení | Zásilka je přepravována. |
| 15 | změna zboží | Zásilka je přepravována. |
| 16 | Inventura zboží | Zásilka je přepravována. |
| 17 | nesvezená | Evidovaná |
| 18 | svážená (zahraničí) | Zásilka je přepravována. |
| 19 | rozvážená (zahraničí) | Zásilka je přepravována. |
| 21 | převzatá na jiném vozidle | Zásilka je přepravována. |
| 22 | evidovaná v partnerském systému SDS (slovensko) | Zásilka je přepravována. |
| 35 | vratka zásilky | Zásilka vrácena odesílateli |
| 40 | poškozená | Zásilka je přepravována. |
| 41 | nezpracovaná | Evidovaná |
| 42 | logovaná nulová akce | Zásilka je přepravována. |
| 43 | zboží skenováno skladem | Zásilka je přepravována. |
| 45 | dočasně neevidováno CP | Zásilka je přepravována. |
| 46 | odeslaná placená SMS | Zásilka je přepravována. |
| 47 | vytvořen zápis o škodě | Zásilka je přepravována. |
| 50 | úhrada hotovosti platební kartou na svozu | Zásilka je přepravována. |
| 51 | úhrada hotovosti platební kartou na rozvozu | Zásilka je přepravována. |
| 60 | doručená – vráceno odesílateli | Zásilka vrácena odesílateli |
| 71 | řidič – převzatá | Zásilka je přepravována. |
| 72 | řidič – doručená | Zásilka doručena |
| 73 | řidič – nezastižen zákazník | Zásilka je přepravována. |
| 74 | řidič – není hotovost | Zásilka je přepravována. |
| 75 | řidič – dohoda jiný termín | Zásilka je přepravována. |
| 76 | řidič – poškozená zásilka | Zásilka je přepravována. |
| 77 | řidič – odmítnutí přijetí | Zásilka je přepravována. |
| 78 | řidič – chybná adresa | Zásilka je přepravována. |
| 79 | řidič – jiný neobjek. důvod | Zásilka je přepravována. |
| 80 | řidič – nekompletní zásilka | Zásilka je přepravována. |
| 90 | STORNO – zrušená přeprava | Zrušená přeprava |
Seznam stavů zásilky NetSpedice – 51.1
Seznam stavů kterých může nabýt zásilka v NetSpedici.
- NEULOŽENÁ
- POŽADAVEK NA ZRUŠENÍ
- POŘÍZENÁ – EXPORTOVANÁ
- POŘÍZENÁ – NEKOMPETNÍ
- POŘÍZENÁ – POZASTAVENÁ
- ZRUŠENO STŘEDISKEM
- ČEKÁ NA AUT.PŘENOS
Seznam států pro import dat do online systému FOFR – 52
- Černá Hora
- Česká republika
- Belgie
- Bosna a Hercegovina
- Chorvatsko
- Itálie
- Lucembursko
- Makedonie
- Maďarsko
- Nizozemsko
- Německo
- Polsko
- Portugalsko
- Rakousko
- Slovensko, Slovak republic
- Slovinsko
- Srbsko
- Španělsko
Číselník obvodů fofr pro ČR – 53
Online načítání z databáze NetSpedice (poslední změna 1.4.2024)
pro správné určení obvodů fofr je možno použít offline číselník zde:
xml – https://objednavky.fofrcz.cz/obvody/fofr/xml
csv – https://objednavky.fofrcz.cz/obvody/fofr/csv
txt – https://objednavky.fofrcz.cz/obvody/fofr/txt
html – https://objednavky.fofrcz.cz/obvody/fofr/html
Číselník obvodů fofr pro SK – pouze pro tisk polepek -54
Online načítání z databáze NetSpedice (poslední změna 27.6.2024)
pro správné určení obvodů na Slovensku pouze pro tisk polepek fofr je možno použít offline číselník zde:
xml – https://objednavky.fofrcz.cz/obvody/fofrsk/xml
csv – https://objednavky.fofrcz.cz/obvody/fofrsk/csv
txt – https://objednavky.fofrcz.cz/obvody/fofrsk/txt
html – https://objednavky.fofrcz.cz/obvody/fofrsk/html
Seznam doporučených kódů obalů – 55
Maximální velikost 6 znaků, do kódu může být zapsáno cokoliv, kromě speciálních typů obalů.
- COLLI – obecný název pro jakýkoliv obal
- BALÍK
- KARTON
- BEDNA
- KBELÍK
- KRABIC
- PNEU
- PYTEL
- ROLE
- SOUDEK
- SUD
- SVAZEK
Speciální typy obalů s významem při výpočtu ceny nebo určení modulu :
(Pro modul B balíkovka nemůže být použit typ obalu s významem paleta nebo europaleta.)
- V-EUR – vratná europaleta
- P-EUR – nevratná europaleta pro paletový modul
- P-PAL – nevratná nestandardní paleta pro paletový modul
- PALETA – nestandardní paleta
- OBÁLKA – obálka připojená k přepravě
- VRATDL – kód pro vratný dodací list odesílateli – vzhledem k tomu že se jedná o zboží je zde potřeba uvést i jen minimální váhu
- V-OBAL – kód pro vratný obal v rámci systému FOFR odesílateli zpoplatněná služba
- V-IBC – kód pro vratný obal v rámci systému FOFR odesílateli zpoplatněná služba
Seznam dep FOFR – 56
xml – https://objednavky.fofrcz.cz/seznam-dep/xml
xml – https://objednavky.fofrcz.cz/seznam-dep/xml2 – identický formát jako zásilkovna
html – https://objednavky.fofrcz.cz/seznam-dep/html
csv – https://objednavky.fofrcz.cz/seznam-dep/csv
Číselník ADR podle UN čísla – 57
Online načítání z databáze NetSpedice (poslední změna 6.5.2020)
txt – https://objednavky.fofrcz.cz/seznam-adr/txt
csv – https://objednavky.fofrcz.cz/seznam-adr/csv
xml – https://objednavky.fofrcz.cz/seznam-adr/xml
html – https://objednavky.fofrcz.cz/seznam-adr/html
