Szolgáltatói riportok: díj és utánvét csomagonként
Töltsd fel a szolgáltató CSV-riportját, a rendszer pedig csomagonként rögzíti a szolgáltatói díjat, az alfiókok díját és a beérkezett utánvétet.
Dieser Artikel ist derzeit nur auf Ungarisch verfügbar.
A Szolgáltatói riportok oldalon (Szolgáltatók → Riportok fül) a szolgáltatótól kapott CSV-riportokat töltöd fel. A rendszer a riport sorait a nyomkövetési szám alapján párosítja a csomagjaidhoz, és csomagonként rögzíti:
- a szolgáltatói díjat (nettó) – alfiók csomagjánál a jutalékkal növelt alfiók díját is,
- a beérkezett utánvétet és annak dátumát.
Fontos: Csomagrögzítéskor a saját díjtábládból várható költséget mutatunk. A tényleges szolgáltatói díj a riport feldolgozása után jelenik meg a csomagon.

Kinek érhető el?
A Szolgáltatói riportok oldal csak a fő fiókban érhető el, a Szolgáltatói riportok jogosultsággal. Ez a Tulajdonos, az Adminisztrátor és a Pénzügy szerepkör része. Riportot csak bekötött szolgáltatóhoz tölthetsz fel.
Riport feltöltése
- Nyisd meg a Szolgáltatók → Riportok fület, és kattints a Riport feltöltése gombra.
- Válaszd ki a Szolgáltató mezőt.
- Válaszd ki a Riport típusa mezőt: Utánvét-átutalás, Számlamelléklet vagy Kézbesítési riport.
- Ha van, add meg a Hivatkozás mezőben az átutalás- vagy számlaszámot (opcionális).
- Add meg az Időszak kezdete és az Időszak vége dátumot.
- A Fájl mezőben válaszd ki a CSV-fájlt.
- Kattints a Feltöltés és feldolgozás gombra.
A feldolgozás után az üzenet mutatja, hány sort dolgoztunk fel, és hányat párosítottunk csomaghoz. Ha maradt párosítatlan sor, azt is jelezzük. Ezután megnyílik a riport részletes oldala.
Tipp: Az Időszak vége dátum lesz a beérkezett utánvét dátuma a csomagokon. Ha üresen hagyod, a feltöltés napját rögzítjük.
Fontos: Ugyanazt a riportot nem töltheted fel kétszer: felismerjük az azonos fájlt és az azonos szolgáltatóhoz, típushoz és hivatkozáshoz tartozó riportot is. Javított változat feltöltése előtt töröld a korábbit.
A riportlistát Szolgáltató és Riport típusa szerint szűrheted. Soronként látod a Sorok, a Díj összesen és az Utánvét összesen értékét, az állapotot és a feltöltés idejét.
A fájl formátuma
- CSV-fájl, pontosvesszővel (
;) vagy vesszővel (,) tagolva, legfeljebb 20 MB. - Kódolás: UTF-8 (BOM-mal vagy anélkül) vagy a magyar Excel-exportokra jellemző Windows-1250.
- Az első sor a fejléc. A számokban a tizedesvessző, a tizedespont és az ezres tagolás is elfogadott (például
12 990,50 Ft).
A Mintafájl gombbal töltheted le a sablont:
tracking_number;reference;cod_amount;weight_kg;fee_net
83255426856;WS-261002-402;12990;1,5;1490
PN528577843HU;WS-261001-658;0;3,6;1790Oszlopfelismerés
Az oszlopokat a fejlécből ismerjük fel. A kis- és nagybetű, az ékezet és az írásjel nem számít, így a Csomagszám és a csomag_szam ugyanazt jelenti.
| Mező | Elfogadott fejlécek |
|---|---|
| Nyomkövetési szám (kötelező) | tracking_number, tracking, trackingnumber, parcel_number, parcelnumber, parcel_no, csomagszam, ragszam, nyomkovetesi_szam, kuldemenyazonosito, kuldemeny_azonosito, barcode, clfoxid, packet_id, awb |
| Hivatkozás | reference, ref, order, order_number, hivatkozas, rendelesszam, rendeles_szam, ugyfel_hivatkozas, clientreference |
| Utánvét | cod, cod_amount, codamount, utanvet, utanvet_osszeg, utanvet_osszege, arufizetes, beszedett_osszeg, collected_amount, cash_on_delivery |
| Súly (kg) | weight_kg, weight, suly, suly_kg, merlegelt_suly, billed_weight, tomeg |
| Súly (g) | weight_g, suly_g, suly_gramm |
| Nettó díj | fee, fee_net, net_fee, dij, netto_dij, szallitasi_dij, fuvardij, price, netto, amount_net |
Fontos: Ha nem találunk nyomkövetésiszám-oszlopot, a feldolgozás meghiúsul, és a riport Sikertelen állapotú lesz. Nevezd át a fejlécet egy elfogadott változatra, és töltsd fel újra a fájlt.
Párosítás a csomagokhoz
A riport sorait a nyomkövetési szám alapján, a kiválasztott szolgáltató csomagjai között párosítjuk. Többcsomagos küldeménynél az egyes darabok nyomkövetési számát is a küldeményhez párosítjuk.
Párosított csomagonként:
| Riportadat | Mit rögzítünk a csomagon |
|---|---|
| Nettó díj | Soronként egy díjtétel a csomagon. Számlamellékletből és kézbesítési riportból Szállítási díj, utánvét-átutalásból Utánvétkezelési díj (például a kártyás fizetés díja). |
| Utánvét | Az utánvét-átutalás riportok 0-nál nagyobb utánvétes sorait összeadjuk: ez a Beérkezett utánvét. Dátuma a legutóbbi ilyen riport időszakának vége, ha az nincs megadva, a feltöltés napja. |
Egy csomaghoz több riport is tartozhat: például a díj a havi számlamellékletben, a kártyás utánvét és annak kezelési díja később, az utánvét-átutalásban érkezik. A rendszer minden riport tételeit és a kézi tételeket összeadja. A csomag Szolgáltatói díja a díjtételek összege, erre számoljuk az alfiók jutalékát. Az eredmény nem függ a feltöltés sorrendjétől.
Megjegyzés: A fő fiók saját csomagjaira nincs jutalék, ezeknél a szolgáltatói díj a csomag díja. A jutalék beállításáról: Jutalék alfiókonként.
A riport részletes oldala
A riport oldalának tetején ezeket az értékeket látod: Sorok, Csomaghoz párosítva, Díj összesen (nettó) és Utánvét összesen.
A sorokat szűrheted (Összes, Párosítva, Nem párosított), és nyomkövetési számra vagy hivatkozásra kereshetsz. A táblázatban soronként látod a nyomkövetési számot, a párosított csomagot, a súlyt, az utánvétet, a Szolgáltatói díj és az Alfiók díja értékét, alfiók csomagjánál a jutalék összegét is.
A riport állapota:
| Állapot | Jelentés |
|---|---|
| Feldolgozva | Minden sort csomaghoz párosítottunk. |
| … nem párosított (például „3 nem párosított”) | Ennyi sorhoz nem találtunk csomagot. |
| Sikertelen | A fájlt nem tudtuk feldolgozni (például hiányzik a nyomkövetési szám oszlopa). |
Újrafeldolgozás
Az Újrafeldolgozás gombbal újra feldolgozhatod a riportot. Ez akkor hasznos, ha:
- egy párosítatlan csomaghoz időközben megérkezett a nyomkövetési szám,
- módosítottad az alfiók jutalékszabályait, és az új jutalékot erre a riportra is alkalmaznád.
Újrafeldolgozáskor csak ennek a riportnak a tételeit cseréljük. A többi riport és a kézi tételek nem változnak.
Törlés
A Törlés gombbal törlöd a riportot, a sorait és a belőle származó díjtételeket. Az érintett csomagok díját és beérkezett utánvétjét a megmaradt riportokból és a kézi tételekből újraszámoljuk.
Az eredmény a csomagon
A csomag oldalán a Díj és utánvét panel mutatja a riportból származó adatokat:
| Sor | Mit mutat | Ki látja |
|---|---|---|
| Utánvét | A csomag utánvétje | Mindenki |
| Beérkezett utánvét | Az összeg és a dátum, a fő fiókban a riport hivatkozása is. Riport előtt: „Még nem érkezett riport”. Csak utánvétes csomagnál jelenik meg. | Mindenki |
| Szolgáltatói díjak (nettó) | A díjtételek listája (típus, forrásriport vagy „Kézi” és a rögzítő neve, összeg) és a Szolgáltatói díj összesen. | Csak a fő fiók |
| Jutalék | Az alfiók csomagjára számolt jutalék | Csak a fő fiók |
| Alfiók díja | Szolgáltatói díj + jutalék | Csak a fő fiók, jutalékos csomagnál |
| Szállítási díj (nettó) | Szolgáltatói díj + jutalék, egy összegben. Riport előtt: „A szolgáltatói riport után jelenik meg”. | Csak az alfiók |
Az alfiók soha nem látja a díjtételeket és a jutalékot külön, csak a Szállítási díj (nettó) végösszegét.
Kézi díjtétel
Ha a szolgáltató a riporton kívül jelez díjat (például levélben súlyeltérés miatti felárat), a fő fiók a csomag oldalán rögzítheti: Díj és utánvét → Szolgáltatói díjak → Tétel. Válaszd ki a típust (Szállítási díj, Felár, Utánvétkezelési díj, Biztosítási díj, Korrekció, Egyéb), add meg a nettó összeget és szükség szerint egy megjegyzést, majd kattints a Rögzítés gombra. Jóváírásnál negatív összeget adj meg.

A kézi tételt a kuka ikonnal törölheted. A riportból származó tételeket itt nem törölheted: ezek a riport újrafeldolgozásával vagy törlésével változnak. Díjtételt a Szolgáltatói riportok jogosultsággal rendelkező fő fiókos felhasználók rögzíthetnek.
A REST API-ban a csomag price mezője a riport feldolgozásáig null, a várható költséget addig a quote mező adja. Részletek: REST API – gyors kezdés.
Tipp: Ha egy csomagot kézbesítettek, de az utánvét 14 nap után sem érkezett meg, a Reklamációk oldal a Javasolt eszkalációk között felajánlja. Lásd: Reklamációs határidők és eszkaláció.