Skip to main content
Qargo

Gegevensimport: productgegevens importeren

Een volledige handleiding voor het importeren van productgegevens. Hiermee wordt de productcatalogus in bulk gevuld, wat het aanmaken van orders vereenvoudigt en zorgt voor consistente omschrijvingen en meeteenheden.

Inhoudsopgave
  1. 📖 Belangrijke begrippen
  2. ✅ Belangrijke importvereisten voor producten
  3. 🛠️ Stapsgewijs gegevens importeren
  4. Stap 1: Sjabloon downloaden
  5. Stap 2: Excel-sjabloon invullen
  6. Stap 3: Indienen om te uploaden
  7. 📝 Details van het importsjabloon voor producten
  8. 🔎 Veelvoorkomende fouten bij de productimport oplossen
  9. ✨ Beste werkwijzen voor het importeren van producten
  10. ➡️ Volgende stappen
  11. 📈 Toepassingen van de productimport

Door productgegevens te importeren kan een bedrijf de productcatalogus in Qargo snel vullen. Dat is vooral nuttig voor organisaties die een vaste lijst van items vervoeren. Het vereenvoudigt het aanmaken van orders en zorgt voor consistente omschrijvingen en meeteenheden. Dit artikel beschrijft de specifieke vereisten, de beste werkwijzen en veelvoorkomende problemen bij het importeren van productgegevens.


📖 Belangrijke begrippen

Voor de duidelijkheid worden in deze handleiding de volgende begrippen gebruikt.

  • ADR: De Europese Overeenkomst betreffende het internationaal vervoer van gevaarlijke goederen over de weg. Dit verdrag regelt het veilige vervoer van gevaarlijke goederen over internationale grenzen heen en legt voorschriften vast voor de verpakking, etikettering en documentatie ervan.
  • Product: Een specifiek item of goed dat aan een order kan worden toegevoegd en kan worden vervoerd.
  • Producttype: Een algemene indeling om producten met gemeenschappelijke kenmerken te groeperen, zoals verpakking of vorm. Zo kan één producttype zoals ‘Doos’ meerdere afzonderlijke producten bevatten.

✅ Belangrijke importvereisten voor producten

Voor het importeren van productgegevens moet rekening worden gehouden met de volgende vereisten en waarschuwingen om de integriteit van de gegevens te garanderen.

  • Code: Elk product moet een unieke Code hebben. De import mislukt als er een dubbele code in het importbestand staat of als de code al in Qargo bestaat.
  • Verplichte velden: De Naam van het product en het Type zijn verplichte velden. Een import mislukt als een van beide leeg is.

🛠️ Stapsgewijs gegevens importeren

Stap 1: Sjabloon downloaden

Er is een specifiek spreadsheetsjabloon beschikbaar om productgegevens te uploaden. Om de gegevens te kunnen bewerken en uploaden, moet een kopie van het sjabloon worden gedownload:

  1. Op de link klikken: Sjabloon voor import van productgegevens
  2. Zodra het sjabloon geopend is, Bestand > Downloaden kiezen
  3. Het sjabloon (in .xlsx- of .csv-formaat) op de computer opslaan en beginnen met het invullen van de bedrijfsgegevens.

Stap 2: Excel-sjabloon invullen

Het sjabloon openen en 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 de verplichte velden staat in de volgende sectie van dit artikel). Een import mislukt als deze velden leeg zijn.
  • Opmaak: Goed letten op het opgegeven gegevensformaat (bv. datums, getallen, tekst).

Stap 3: Indienen om te uploaden

  1. Tijdens de onboarding: Rechtstreeks samenwerken met de onboardingmanager om de eerste bedrijfsgegevens te uploaden. De onboardingmanager begeleidt het proces en zorgt voor een geslaagde import.
  2. Na de onboarding: Voor alle toekomstige gegevensupdates en imports contact opnemen met de accountmanager. De accountmanager helpt bij het uploaden en biedt doorlopende support.

📝 Details van het importsjabloon voor producten

De volgende tabel geeft per veld een gedetailleerde uitleg van het Excel-sjabloon voor de productimport, met gegevensformaten, verplichte velden en de beste werkwijze voor het invullen van elke kolom.

Kolomnaam Verplicht/optioneel Opmerkingen Voorbeeld
name Verplicht Productnaam die in Qargo wordt weergegeven Aardappelen
description Optioneel
code Optioneel
product_type_name Verplicht Producttype dat in Qargo is geconfigureerd. Eén producttype kan meerdere producten hebben.
adr_internal_code Optioneel Interne ADR-code die aan het product is toegekend.
adr_edition Optioneel Editie van de ADR-voorschriften.
adr_class Optioneel ADR-gevarenklasse van het product.
un_number Optioneel UN-nummer (Verenigde Naties) van het gevaarlijke goed.
packing_group Optioneel
specific_gravity Optioneel Soortelijk gewicht van het product.
absolute_min_temperature Optioneel Laagste temperatuur die het product verdraagt.
absolute_max_temperature Optioneel Hoogste temperatuur die het product verdraagt.
loading_meters Optioneel Ruimte die het product inneemt, in laadmeters.
pallet_spaces Optioneel Aantal standaardpalletplaatsen dat het product inneemt.
actual_pickup_temperature Optioneel Werkelijke temperatuur van het product bij de ophaling.
actual_delivery_temperature Optioneel Werkelijke temperatuur van het product bij de levering.
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

🔎 Veelvoorkomende fouten bij de productimport oplossen

Deze sectie behandelt specifieke fouten die kunnen optreden bij het importeren van productgegevens.

  • Dubbele productcode: De meest voorkomende fout ontstaat wanneer een product-Code in het sjabloon al in Qargo bestaat. Elke code moet uniek zijn.

  • Ontbrekende verplichte velden: De import mislukt voor elke rij waarin de Naam of het Type van het product leeg is.

  • Bladnaam: Het blad in het Excel-sjabloon moet exact ‘Import’ heten. Elke andere naam veroorzaakt een fout bij het uploaden van het bestand.

  • Hoofdlettergevoelige kolomkoppen: Kolomkoppen moeten met de juiste hoofdletters en kleine letters worden ingevoerd (bv. vat_number, niet VAT_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 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 vermeldt dat voor een specifiek veld een apostrof moet worden gebruikt.

  • Aangepaste velden: De kolomnaam moet de conventie custom_field__[ID] volgen (de dubbele underscore niet vergeten 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:


✨ Beste werkwijzen voor het importeren van producten

Voor een vlotte en nauwkeurige import zijn de volgende werkwijzen aan te raden.

  • Consistente eenheden gebruiken: Een standaard en consistente set meeteenheden voor alle producten zorgt voor nauwkeurigheid en voorkomt verwarring bij het aanmaken van orders.
  • Testen met een kleine reeks: Het is aan te raden het importproces eerst te testen met een kleine steekproef van 5–10 producten. Zo kan worden gecontroleerd of de gegevens correct zijn opgemaakt voordat een volledige catalogus wordt geüpload.

➡️ Volgende stappen

Zodra de producten met succes zijn geïmporteerd, zijn ze beschikbaar in het platform. De logische volgende stap is nieuwe orders aanmaken en deze producten uit de catalogus selecteren.


📈 Toepassingen van de productimport

Het importeren van productgegevens is een waardevol hulpmiddel voor verschillende belangrijke bedrijfsprocessen.

  • De catalogus vullen: De belangrijkste toepassing is een volledige productcatalogus in bulk vullen, zodat alle vaak vervoerde items in het systeem beschikbaar zijn.
  • Eenvoudiger orders aanmaken: Met een vooraf bepaalde lijst van producten kunnen planners en verkoopteams sneller en nauwkeuriger orders aanmaken. Ze selecteren gewoon uit een lijst in plaats van de productdetails telkens handmatig in te voeren.