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.
Dieser Artikel ist derzeit nur auf Ungarisch verfügbar.
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
- Feltöltés – CSV- vagy XLSX-fájl, a fejléc az első sor.
- Oszlopok hozzárendelése – megmondod, melyik oszlopban mi van. A fejléceket automatikusan felismerjük.
- 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.
- 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 |
| 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.