Gegevensimport – Containergegevens importeren
Een uitgebreide handleiding voor het importeren van containergegevens. Met dit proces kunnen containers van zowel de organisatie als haar onderaannemers in bulk worden aangemaakt, zodat er een direct beschikbare catalogus is voor het aanmaken van orders.
Inhoudsopgave
- 📖 Belangrijke begrippen
- ✅ Belangrijke importvereisten voor containers
- 🛠️ Gegevensimport stap voor stap
- Stap 1: Sjabloon downloaden
- Stap 2: Het Excel-sjabloon invullen
- Stap 3: Indienen om te uploaden
- 📝 Details van het sjabloon voor containerimport
- 🔎 Veelvoorkomende fouten bij containerimport oplossen
- ✨ Best practices voor het importeren van containers
- ➡️ Volgende stappen
- 📈 Toepassingen van containerimport
Door containergegevens te importeren, kunnen containers in bulk worden aangemaakt. Deze containers kunnen van het eigen bedrijf of van een onderaannemer zijn. Dit is een cruciale stap voor organisaties die hun eigen containervloot beheren, omdat er zo een direct beschikbare database is voor het aanmaken van orders. Dit artikel beschrijft de specifieke vereisten, best practices en veelvoorkomende problemen bij het importeren van containergegevens.
📖 Belangrijke begrippen
Voor de duidelijkheid worden in deze handleiding de volgende begrippen gebruikt.
- Container: een herbruikbare eenheid voor transport en opslag.
- Containernr.: de unieke identificatie van een container.
- Onderaannemer: een bedrijf dat eigenaar of gebruiker is van een container.
- Code: een unieke identificatie van een container uit een extern systeem, waarmee gegevens nauwkeurig kunnen worden bijgewerkt.
✅ Belangrijke importvereisten voor containers
Voordat containergegevens worden geïmporteerd, moet rekening worden gehouden met de volgende vereisten en waarschuwingen om de juistheid van de gegevens te garanderen.
- Voorwaarde voor onderaannemers: voordat een container van een onderaannemer kan worden geïmporteerd, moet het bedrijfsrecord van die onderaannemer al in Qargo bestaan. De import mislukt als de opgegeven onderaannemer niet kan worden gevonden.
- Unieke identificatie: Qargo herkent bestaande containers aan hun unieke Containernr..
- Verplicht veld: de Naam van de container is een verplicht veld. Een import mislukt als dit veld leeg blijft.
🛠️ Gegevensimport stap voor stap
Stap 1: Sjabloon downloaden
Er is een specifiek spreadsheetsjabloon beschikbaar om containergegevens te uploaden. Om de gegevens te kunnen bewerken en uploaden, moet een kopie van het sjabloon worden gedownload:
- Op de link klikken: Sjabloon voor import van containergegevens
- Zodra het sjabloon geopend is, naar Bestand gaan en Downloaden selecteren
- Het sjabloon (in .xlsx- of .csv-formaat) op de computer opslaan en beginnen met het invoeren van de bedrijfsgegevens.

Stap 2: Het Excel-sjabloon invullen
Het sjabloon openen en met de vereiste gegevens invullen. Het sjabloon bevat kolomkoppen die overeenkomen met de velden in Qargo.
- Verplichte velden: alle verplichte velden invullen (een volledige lijst van verplichte velden staat in het volgende deel van dit artikel). Een import mislukt als deze velden leeg blijven.
- Opmaak: goed letten op het opgegeven gegevensformaat (bv. datums, getallen, tekst).
Stap 3: Indienen om te uploaden
- Tijdens de onboarding: rechtstreeks samenwerken met de onboardingmanager om de initiële bedrijfsgegevens te uploaden. De onboardingmanager begeleidt het proces en zorgt voor een geslaagde import.
- Na de onboarding: voor alle latere gegevensupdates en imports contact opnemen met de accountmanager. De accountmanager helpt bij het uploadproces en biedt doorlopende support.
📝 Details van het sjabloon voor containerimport
De volgende tabel geeft per veld een gedetailleerde uitleg van het Excel-sjabloon voor containerimport, met gegevensformaten, verplichte velden en best practices voor het invullen van elke kolom.
| Kolomnaam | Verplicht/optioneel | Opmerkingen | Voorbeeld |
|---|---|---|---|
| name | Verplicht | Naam van de container zoals weergegeven in Qargo | |
| code | Optioneel | ||
| manufacturer | Optioneel | Exagon | |
| container_number | Optioneel | 1212 | |
| standard_size | Optioneel | Feet_25 | |
| note | Optioneel | ||
| subcontractor_company | Optioneel | ||
| gross_weight | Optioneel | Ton | 1 |
| tare_weight | Optioneel | Kilogram | 1.0 |
| capacity_volume | Optioneel | m³ | 1.000 |
| capacity_weight | Optioneel | 1 | |
| exterior_length | Optioneel | Meter | 1.000 |
| exterior_width | Optioneel | Meter | 1.000 |
| exterior_height | Optioneel | Meter | 1.000 |
| custom_fields__example | Optioneel | Om waarden van aangepaste velden te importeren. Opmerking: het formaat gebruikt een dubbele underscore (__) om het voorvoegsel custom_fields aan de unieke veld-ID te koppelen |
Standaardformaat: toegestane waarden
De kolom standard_size accepteert de volgende waarden. Het formaat moet exact overeenkomen (het veld is niet hoofdlettergevoelig, maar het onderstaande patroon van underscore en hoofdletters wordt aanbevolen):
| Waarde | Formaat |
|---|---|
Feet_20 |
20 ft |
Feet_23 |
23 ft |
Feet_24 |
24 ft |
Feet_25 |
25 ft |
Feet_26 |
26 ft |
Feet_30 |
30 ft |
Feet_35 |
35 ft |
Feet_40 |
40 ft |
🔎 Veelvoorkomende fouten bij containerimport oplossen
Dit deel behandelt specifieke fouten die kunnen optreden bij het importeren van containergegevens.
-
Record van onderaannemer niet gevonden: dit is de meest voorkomende fout bij containers van onderaannemers. De fout treedt op wanneer de naam van het bedrijf van de onderaannemer in het sjabloon niet exact overeenkomt met een bestaand bedrijf in Qargo. De onderaannemer moet in het systeem bestaan voordat de containers van die onderaannemer kunnen worden geïmporteerd.
-
Naam van het werkblad: het werkblad in het Excel-sjabloon moet exact ‘Import’ heten. Elke andere naam veroorzaakt een fout bij het uploaden van het bestand.
-
Ontbrekend verplicht veld: de import mislukt voor elke rij waarin de naam van de container leeg is.
-
Hoofdlettergevoelige kolomkoppen: kolomkoppen moeten met de juiste hoofdletters en kleine letters worden ingevoerd (bv.
vat_number, nietVAT_number). Bij verkeerde hoofdletters worden de gegevens in die kolom zonder melding genegeerd en niet geïmporteerd, omdat het systeem de kolomkop niet herkent. -
Fouten door een apostrof vooraan: gegevens in een cel mogen niet met een apostrof (’) beginnen. Als er toch een apostrof wordt gebruikt, herkent het systeem de waarde niet en kan er een fout optreden. Deze regel geldt alleen niet als het artikel uitdrukkelijk aangeeft dat voor een specifiek veld een apostrof moet worden gebruikt.
-
Aangepaste velden: de kolomnaam moet de conventie custom_field__[ID] volgen (de dubbele underscore behouden om het voorvoegsel custom_field aan de unieke veld-ID te koppelen), met de specifieke ID uit de instellingen organisatie in Qargo. Op de kopieerknop naast het aangepaste veld klikken om de ID ervan te kopiëren:

✨ Best practices voor het importeren van containers
Voor een vlotte en nauwkeurige import zijn de volgende best practices aan te raden.
- Zorgen voor volledige gegevens van onderaannemers: voordat containers van onderaannemers worden geïmporteerd, controleren of alle betrokken onderaannemers al met succes als bedrijf in het systeem zijn geïmporteerd.
- Gegevens consistent houden: goed letten op de spelling en de hoofdletters van namen van onderaannemers en containernummers. Elke inconsistentie zorgt ervoor dat de koppeling mislukt.
- De code van de container gebruiken: hoewel het veld Code van de container optioneel is, wordt het gebruik ervan sterk aanbevolen. Het biedt een betrouwbare manier om containerrecords bij te werken en voorkomt conflicten door dubbele nummers.
➡️ Volgende stappen
Zodra de containers met succes zijn geïmporteerd, kunnen ze worden gebruikt bij het aanmaken van orders. Logische volgende stappen zijn:
- Producten importeren: indien nodig kunnen producten die bij het aanmaken van orders worden gebruikt in bulk worden geïmporteerd.
- Orders importeren: een reeks testorders kan worden geïmporteerd om een sandboxomgeving te vullen.
📈 Toepassingen van containerimport
Het importeren van containergegevens is een waardevol hulpmiddel voor verschillende belangrijke bedrijfsprocessen.
- Initiële inrichting van de vloot: de belangrijkste toepassing is een Qargo-tenant vullen met een volledige containervloot, met zowel eigen containers als containers van vaste onderaannemers.
- Onboarding van een nieuwe vloot: wanneer een nieuwe bedrijfseenheid of containervloot wordt overgenomen, kunnen de gegevens ervan in bulk aan Qargo worden toegevoegd.
