Tömeges importálás CSV- vagy XLSX-fájlból

Sok csomag egyszerre – feltöltés, oszlop-hozzárendelés, soronkénti ellenőrzés és javítás, létrehozás és címkenyomtatás egy lépésben. A mintafájl oszlopai.

9 perc olvasásFrissítve: 2026. 11. 03.

Ha egyszerre sok csomagot adsz fel – például a webshopod napi rendeléseit –, nem kell egyenként rögzítened őket. Töltsd fel a rendeléseket tartalmazó táblázatot, és a Rackoon a sorokból csomagokat hoz létre.

Az importálást a Csomagok menüpont Import fülén, vagy a Csomagok oldal jobb felső sarkában az Importálás gombbal indítod (az Új csomag gomb melletti menüben is megtalálod).

Megjegyzés: Importálni az tud, aki csomagot is rögzíthet: a Tulajdonos, az Adminisztrátor és a Raktár szerepkör. Alfiókban a csomagok az alfiókba kerülnek, az alfiók szolgáltatásaival és telephelyeivel.

A folyamat röviden

  1. Feltöltés – CSV- vagy XLSX-fájl, a fejléc az első sor.
  2. Oszlopok hozzárendelése – megmondod, melyik oszlopban mi van. A fejléceket automatikusan felismerjük.
  3. Ellenőrzés – minden sor ugyanazon az ellenőrzésen megy át, mint az egyedi csomagrögzítés. A hibás cellát a táblában javíthatod.
  4. Létrehozás – a hibátlan sorokból csomag lesz. A címkéket egy PDF-ben nyomtathatod.

Fájlformátum és korlátok

  • CSV: pontosvessző (;) vagy vessző (,) elválasztóval. Kódolás: UTF-8 (BOM-mal vagy anélkül) vagy Windows-1250. Ez utóbbi a magyar Excel alapértelmezése, így a „CSV (pontosvesszővel tagolt)” mentésnél is rendben lesznek az ékezetek.
  • XLSX: az első munkalapot olvassuk be.
  • Egy fájlban legfeljebb 2000 adatsor lehet, a fájl mérete legfeljebb 5 MB. Nagyobb tételt bonts több fájlra.
  • Az üres sorokat kihagyjuk. A sorszámok a fájl soraira utalnak (a fejléc az 1. sor).

A Tömeges importálás oldalon letöltheted a mintafájlt CSV- és XLSX-formátumban is. A minta magyar fejlécekkel és egy példasorral készül.

A mintafájl oszlopai

A sorrend tetszőleges, és nem kell minden oszlop. A felismerés a kis- és nagybetűt, az ékezeteket és az írásjeleket nem veszi figyelembe, és sok angol fejlécet is ismer (pl. Name, Zip, Postcode, City, Phone, Weight, COD, Order number).

Oszlop Kötelező Leírás Példa
Név igen A címzett neve. Két oszlop (vezetéknév, keresztnév) is hozzárendelhető, szóközzel fűzzük össze. Kiss Anna
Cég nem A címzett cégneve.
Telefon igen A címzett telefonszáma, lehetőleg nemzetközi formában. +36301234567
E-mail nem A címzett e-mail-címe. A vásárlói értesítésekhez kell, egyes szolgáltatóknál kötelező. [email protected]
Ország nem Kétbetűs országkód vagy az ország neve magyarul, angolul, németül. Üresen az alapértelmezett ország (Magyarország). HU
Irányítószám igen 1052
Település igen Budapest
Utca igen Közterület neve és jellege, a házszám is szerepelhet benne. Váci utca
Házszám nem 12.
Emelet, ajtó nem Cím-kiegészítés. 2. emelet 5.
Hivatkozás nem Saját azonosító, jellemzően a rendelésszám. Az ismétlődést ez alapján jelezzük. WS-1042
Súly (kg) igen* A csomag teljes súlya, tizedesvesszővel vagy -ponttal. Több darabnál egyenlően osztjuk el. 1,2
Darabszám nem Hány darabból áll a küldemény (1–20). Üresen 1. 1
Méretek (cm) nem Hosszúság × szélesség × magasság egy cellában, darabonként. 30x20x10
Tartalom nem A csomag tartalma röviden. Könyv
Utánvét nem A beszedendő összeg a célország pénznemében. Az „Ft” jelölés és a szóközös ezres tagolás is jó. 12990
Biztosítási érték nem Ha a szolgáltató biztosítása engedélyezve van a fiókodban.
Szolgáltató nem* A szolgáltató neve vagy kódja (pl. GLS, MPL, Magyar Posta, DPD, Packeta, FoxPost). GLS
Szolgáltatás nem* A szolgáltatás kódja vagy neve. A webshop szállítási módja is jó, ha szerepel benne a szolgáltató neve (pl. „GLS csomagpont”).
Csomagpont-azonosító nem A csomagpont vagy automata azonosítója a szolgáltatónál. Csomagpontos szolgáltatásnál kötelező.
Telephely nem A feladó telephely kódja vagy neve. Üresen az alapértelmezett telephely.
Megjegyzés nem Megjegyzés a futárnak. Délután hívj

* A súly elhagyható, ha alapértelmezett súlyt adsz meg. Szolgáltató és szolgáltatás nélkül az alapértelmezett szolgáltatással dolgozunk.

Utánvét webshop-exportból

Webshop-exportnál ritkán van külön utánvét-oszlop. Ha a Fizetési mód és a Rendelés végösszege oszlopot is hozzárendeled, és a fizetési mód utánvétes (pl. „Utánvét”, „Cash on delivery”, „Fizetés átvételkor”), a végösszeg lesz az utánvét összege. Más fizetési módnál nincs utánvét.

Oszlopok hozzárendelése

A feltöltés után a fájl minden oszlopa mellett látod az első sorok értékeit és a felismert mezőt. Ha valami nem stimmel, válaszd ki a helyes mezőt, vagy állítsd Nem importálom értékre.

  • Webshop-előbeállítás: UNAS-, Shoprenter- és WooCommerce-exportnál válaszd ki a webshopot a feltöltéskor vagy a hozzárendelésnél. Az előbeállítás a szokásos exportfejléceket ismeri, a hozzárendelést ilyenkor is ellenőrizheted és módosíthatod.
  • Mentett hozzárendelés: pipáld be a Hozzárendelés mentése a következő importhoz lehetőséget, és adj neki nevet. Legközelebb azonos fejlécű fájlnál a feltöltéskor kiválaszthatod. Az alapértékeket is elmentjük. A mentett hozzárendelés a fiókodhoz tartozik.
  • Alapértékek: az alapértelmezett szolgáltatás, a feladó telephely, az alapértelmezett súly és ország akkor érvényes, ha a sorban az adat hiányzik.

Ha a sorban csak a szolgáltató szerepel, a szolgáltató hozzá illő szolgáltatását választjuk: csomagpont-azonosítónál a pont típusához illő csomagpontos vagy automatás szolgáltatást, külföldi címnél a célországba szállító szolgáltatást. A kiválasztott szolgáltatást az előnézetben soronként látod.

Ellenőrzés és javítás

Az ellenőrzés a háttérben fut, nagy fájlnál néhány másodpercig tart. Minden sor ugyanazon az ellenőrzésen megy át, mint egy egyedileg rögzített csomag: kiszolgálja-e a szolgáltatás a célországot, belefér-e a súly- és méretkorlátba, választható-e a csomagpont, engedélyezett-e az utánvét, és helyes-e az összege.

  • A hibás cellát pirossal jelöljük, alatta látod a hiba okát. Kattints a cellára, javítsd ki, és nyomj Entert: a sort azonnal újraellenőrizzük.
  • A szűrővel külön megnézheted a hibás, a hibátlan vagy a figyelmeztetéses sorokat.
  • Egy sort a Kihagyás gombbal kihagyhatsz az importból.
  • A hibás sorokat CSV-ben is letöltheted, kijavíthatod a táblázatkezelőben, és újra feltöltheted.

Figyelmeztetések

A figyelmeztetés nem akadályozza a létrehozást, csak felhívja rá a figyelmedet:

  • Ismétlődő hivatkozás: ugyanaz a hivatkozás a fájlban többször szerepel, vagy az elmúlt 30 napban már rögzítettél ilyen hivatkozású csomagot. Így elkerülheted, hogy egy rendelést kétszer adj fel.
  • EU-n kívüli cím: az ilyen csomag vámadat nélkül piszkozatként jön létre. A vámadatot a csomag oldalán töltsd ki, majd onnan add fel. Lásd: Nemzetközi csomagok és vámkezelés.

Várható költség

Soronként és összesítve is látod a várható nettó költséget a saját díjtábládból (élő szolgáltatói árajánlat nélkül). A tényleges díj a szolgáltatói riportból derül ki.

Létrehozás

Válaszd ki, mi történjen a csomagokkal:

  • Címke generálása azonnal – rögzítjük a csomagokat, és rögtön elkészül a címkéjük.
  • Címke generálása a háttérben – rögzítjük a csomagokat, a címkéket a háttérben generáljuk. Sok csomagnál ez a leggyorsabb.
  • Mentés piszkozatként – a csomagokat piszkozatként mentjük, a címkét később a csomag oldalán generálhatod. A piszkozat a havi csomagkeretbe nem számít bele.

A létrehozás a háttérben, kisebb adagokban fut, az oldalt közben bezárhatod. Egy sorból akkor sem lesz két csomag, ha a feldolgozás megszakad és újraindul. A havi csomagkeretet előre ellenőrizzük: ha az importban több csomag van, mint amennyit a keretedből még feladhatsz, mentsd őket piszkozatként, vagy válts nagyobb díjcsomagra.

Korlátozott alfiókban (ha a fő fiók letiltotta a feladást) importálni sem tudsz.

Eredmény

Az import végén látod, hány csomag jött létre, hány sor hibás és hány maradt ki.

  • Címkék egy PDF-ben: a feladott csomagok címkéi egyetlen fájlban, nyomtatásra.
  • Hibás sorok javításhoz (CSV): a sikertelen és a kihagyott hibás sorok az eredeti oszlopokkal és egy Hiba oszloppal. A táblázatban végzett javításaid is benne vannak. Javítás után töltsd fel újra.
  • A táblából minden létrehozott csomag megnyitható.

A korábbi importjaidat a Tömeges importálás oldal alján találod. A feltöltött fájlt 30 napig őrizzük meg, utána töröljük. Az import eredménye 180 napig látható.

Importálás API-n

Fejlesztőként ugyanezt a POST /v1/shipments/import végponttal érheted el (fájl, hozzárendelés és beállítások egy hívásban), az eredményt a GET /v1/shipments/import/{id} végpont adja vissza. A részleteket az API-dokumentációban találod: Fejlesztőknek.