Online služby FOFR / netSpedice

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ásilky – Track and Trace

Zásilka info (pro objednatele, partnery) – 60

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

https://objednavky.fofrcz.cz/procedure/spocitej-fofr-cenu-xml.php?company_center=CB&firm_id=20126&psc_od=37001&psc_do=62000&goods=@@@@2@@@@@25@@@0,35@@PALETA@@0,45@@0,12@@@0,7T%5E@@@@3@@@@@55@@@@@@@@@KARTON@@@@@@@@0,12@@@0,7T@@@@333123T@&dobirka=500&modul=F

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.

Odkaz: https://objednavky.fofrcz.cz/procedure/spocitej_prepravni_listy_fofr.php?rok=2022&pobocka=1&shipment_num=3316506809

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&centre_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&centre_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-^

odkaz: https://objednavky.fofrcz.cz/procedure/spocitej_pohyby_zasilky_fofr.php?rok=2017&pobocka=1&shipment_num=3319181043

  • 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
xml výstup
csv výstup


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

https://www.fofrcz.cz/mapa.php?stredisko=PT

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

náhled

Importování dat do systému online systému FOFR NetSpedice – 22

https://info.tfw.cz/import-objednavek-netspedice/

Čí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 stavuNázev stavuSkupina stavu
0evidovanáEvidovaná
1sváženáZásilka je přepravována.
2převzatáZásilka je přepravována.
3skladovanáZásilka je přepravována.
4přepravovanáZásilka je přepravována.
5rozváženáZásilka je přepravována.
6doručenáZásilka doručena
7vyloženáZásilka je přepravována.
8ztracenáEvidovaná
9zrušenoZrušená přeprava
10vyložená navícZásilka je přepravována.
11nedoručenáZásilka je přepravována.
12přepravovaná střediskováZásilka je přepravována.
13nezvěstnáZásilka je přepravována.
14dodatečné naloženíZásilka je přepravována.
15změna zbožíZásilka je přepravována.
16Inventura zbožíZásilka je přepravována.
17nesvezenáEvidovaná
18svážená (zahraničí)Zásilka je přepravována.
19rozvážená (zahraničí)Zásilka je přepravována.
21převzatá na jiném vozidleZásilka je přepravována.
22evidovaná v partnerském systému SDS (slovensko)Zásilka je přepravována.
35vratka zásilkyZásilka vrácena odesílateli
40poškozenáZásilka je přepravována.
41nezpracovanáEvidovaná
42logovaná nulová akceZásilka je přepravována.
43zboží skenováno sklademZásilka je přepravována.
45dočasně neevidováno CPZásilka je přepravována.
46odeslaná placená SMSZásilka je přepravována.
47vytvořen zápis o škoděZásilka je přepravována.
50úhrada hotovosti platební kartou na svozuZásilka je přepravována.
51úhrada hotovosti platební kartou na rozvozuZásilka je přepravována.
60doručená – vráceno odesílateliZá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íkZásilka je přepravována.
74řidič – není hotovostZásilka je přepravována.
75řidič – dohoda jiný termínZásilka je přepravována.
76řidič – poškozená zásilkaZásilka je přepravována.
77řidič – odmítnutí přijetíZásilka je přepravována.
78řidič – chybná adresaZásilka je přepravována.
79řidič – jiný neobjek. důvodZásilka je přepravována.
80řidič – nekompletní zásilkaZásilka je přepravována.
90STORNO – zrušená přepravaZruš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

Čí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