Gegevensimport: locatiegegevens importeren
Een uitgebreide handleiding voor het importeren van locatiegegevens. Hiermee kunnen locaties in bulk worden geïmporteerd, samen met aliassen voor externe integraties en configuraties voor het vooraf invullen van stops.
Inhoudsopgave
- 📖 Belangrijke begrippen
- ✅ Belangrijke importvereisten en beperkingen
- 🛠️ Gegevensimport stap voor stap
- Stap 1: het sjabloon downloaden
- Stap 2: het Excel-sjabloon invullen
- Stap 3: aanleveren voor upload
- 🔎 Veelvoorkomende fouten bij de locatie-import oplossen
- ✨ Aanbevolen werkwijze voor het importeren van locaties
- ➡️ Volgende stappen
- 📈 Toepassingen van de locatie-import
De locatie-import is een nuttige tool om een Qargo-tenant in bulk te vullen met essentiële locatiegegevens. Deze handleiding beschrijft het volledige proces: van het invullen van het aangeleverde sjabloon tot de verschillende configureerbare secties.
📖 Belangrijke begrippen
- Locatie: één fysiek adres of bedrijf.
- Orderimportalias: een unieke identificatie van een locatie, gebruikt om de locatie aan een extern systeem te koppelen voor imports en exports.
- Vooraf invullen van stops: een sectie waarmee specifieke details voor alle stops op een locatie vooraf kunnen worden ingevuld, zoals de duur of tijdvensters.
✅ Belangrijke importvereisten en beperkingen
-
Verplichte velden: een import slaagt alleen als alle verplichte kolommen zijn ingevuld. Het gaat om address, city, country, name en postal_code.
-
Unieke identificaties:
-
row_id: dit is de primaire identificatie. Als een row_id is opgegeven, gebruikt het systeem die om een bestaande locatie te herkennen en bij te werken. Alle andere identificaties worden dan overschreven.
-
order_import_alias__location_identifier: als er geen row_id is, wordt dit veld gebruikt om de locatie te identificeren. Dit is alleen relevant wanneer een alias wordt toegevoegd of bijgewerkt.
-
address: dit is de standaard unieke identificatie en de meest voorkomende toepassing. Als er geen row_id en geen order_import_alias__location_identifier is opgegeven, gebruikt het systeem het adres om de locatie te identificeren of aan te maken.
- Wanneer het address als unieke identificatie wordt gebruikt, maakt het systeem een nieuwe locatie aan als het geïmporteerde adres niet exact overeenkomt met een bestaand adres. Zo kunnen dubbele locaties ontstaan.
-
-
Configuratie voor het vooraf invullen van stops: de velden voor het vooraf invullen van stops worden alleen gebruikt als de kolom stop_prefill__type is ingevuld.
🛠️ Gegevensimport stap voor stap
Stap 1: het sjabloon downloaden
Voor het uploaden van locatiegegevens is een specifiek spreadsheetsjabloon beschikbaar. Om de gegevens te kunnen bewerken en uploaden, moet een kopie van het sjabloon worden gedownload:
- Klikken op de link: Sjabloon voor de import van locatiegegevens
- 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 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 blijven.
- Opmaak: goed letten op het opgegeven gegevensformaat (bv. datums, getallen, tekst).
Stap 3: aanleveren voor upload
- 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 toekomstige gegevensupdates en imports contact opnemen met de accountmanager. De accountmanager helpt bij het uploadproces en biedt doorlopend support.
📝 Details van het sjabloon voor de locatie-import
De volgende tabellen geven per veld een gedetailleerde uitleg van het Excel-sjabloon voor de locatie-import. Het sjabloon bestaat uit drie delen: Locatiedetails, Orderimportaliassen en Configuratie voor het vooraf invullen van stops. De uitleg omvat de gegevensformaten, de verplichte velden en de beste werkwijze voor het invullen van elke kolom:
Locatiedetails
| Kolomnaam | Verplicht/optioneel | Opmerkingen | Voorbeeld |
|---|---|---|---|
| name | Verplicht | De gangbare naam van de plaats of het bedrijf. | Googleplex |
| address | Verplicht | Het hoofdadres (straat) van de locatie. | 1600 Amphitheatre Parkway |
| address_second_line | Een optionele tweede regel voor extra adresgegevens, zoals een appartements- of kantoornummer. | Suite 201 | |
| city | Verplicht | De stad of gemeente | Mountain View |
| postal_code | Verplicht | De postcode | 94043 |
| state | De staat, provincie of regio. | California | |
| country | Verplicht | Het land waar de locatie zich bevindt. | United States |
| description | Gedetailleerde beschrijving van de plaats, het doel of de kenmerken ervan. | Een mooi park met wandelpaden en een grote speeltuin. | |
| latitude | geografische coördinaat (noord-zuid) | 51.21049 | |
| longitude | geografische coördinaat (oost-west) | 3.808144 | |
| place_id | Een unieke identificatie van de plaats, uit Google Places | ChIJ2e6n95nFwoAR0pG9C-PTBOM | |
| display_name | De code en weergavenaam van de locatie | ABC-12345 | |
| row_id | Interne Qargo-ID (om een update af te dwingen) | ||
| selectable_on_customer_portal | Geeft aan welke locaties zichtbaar zijn in het klantenportaal.\ | ||
| Zichtbaarheid beperkt tot alle klanten (ALL) of geen enkele klant (NONE). | ALL |
Orderimportaliassen
| Kolomnaam | Verplicht/optioneel | Opmerkingen | Voorbeeld |
|---|---|---|---|
| order_import_alias__location_identifier | Verplicht als export of import op true staat. | Orderimportalias uit het externe systeem.\ | |
| Wanneer dit veld is ingevuld, wordt het gebruikt om bestaande locaties te herkennen. Als import of export op true staat, wordt voor deze locatie ook een nieuwe orderimportalias aangemaakt als die nog niet bestaat | LOC12345 | ||
| order_import_alias__export | Op TRUE zetten als de alias moet worden gebruikt voor het exporteren van orders. | TRUE | |
| order_import_alias__import | Op TRUE zetten als de alias moet worden gebruikt voor het importeren van orders. | TRUE | |
| order_import_alias__name | Gebruiken wanneer de identificatie een technische code is. | Hoofdmagazijn | |
| order_import_alias__integration_partner | De integratiepartner voor de export. Deze waarde opvragen bij het Professional Services-team | MORETMS |
Configuratie voor het vooraf invullen van stops
| Kolomnaam | Verplicht/optioneel | Opmerkingen | Voorbeeld |
|---|---|---|---|
| stop_prefill__type | Bepaalt het type van de vooraf ingevulde stop. Uitzonderingen worden niet ondersteund via bulkupload\ | ||
| Ondersteunde waarden: PICKUP, DELIVERY, OTHER of ALL. Per locatie wordt slechts één waarde ondersteund | PICKUP | ||
| stop_prefill__duration | Afwijkende duur van de stop. Deze waarde overschrijft elke standaardduur. | 6000 (seconden) | |
| stop_prefill__reference_number | Referentienummer dat op de stops wordt ingevuld. | REC-011 | |
| stop_prefill__notes | Extra informatie | Twee keer aanbellen | |
| stop_prefill__time_start | Tijdvenster voor deze locatie. Formaat:\ | ||
| UU:MM, waarbij MM 00 of 30 moet zijn. | 09:00 | ||
| stop_prefill__time_end | Tijdvenster voor deze locatie. Formaat:\ | ||
| UU:MM, waarbij MM 00 of 30 moet zijn. | 17:30 | ||
| stop_prefill__time_window | Naam van het tijdvenster. Dit tijdvenster moet bestaan en de naam moet correct gespeld zijn; deze namen worden aangeleverd door het Professional Services-team. | Volledige dag | |
| stop_prefill__extras | Lijst van extra’s, gescheiden door ;\ | ||
| De extra moet bestaan en de naam of code moet correct gespeld zijn; deze worden aangeleverd door het Professional Services-team. | Herlevering ; Eerste levering | ||
| stop_prefill__custom_fields__<custom_field> | Naam van het aangepaste veld.\ | ||
| Dit veld moet bestaan en de identificatie moet correct gespeld zijn; deze worden aangeleverd door het Professional Services-team. |
Openingsuren (spaties en enkele cijfers niet toegestaan)
| Kolomnaam | Verplicht/optioneel | Opmerkingen | Voorbeeld |
|---|---|---|---|
| opening_hours__monday | Lijst van tijdsintervallen, gescheiden door ; | 08:30-9:30;13:00-14:00 | |
| opening_hours__tuesday | Lijst van tijdsintervallen, gescheiden door ; | 08:30-9:30;13:00-14:00 | |
| opening_hours__wednesday | Lijst van tijdsintervallen, gescheiden door ; | 08:30-9:30;13:00-14:00 | |
| opening_hours__thursday | Lijst van tijdsintervallen, gescheiden door ; | 08:30-9:30;13:00-14:00 | |
| opening_hours__friday | Lijst van tijdsintervallen, gescheiden door ; | 08:30-9:30;13:00-14:00 | |
| opening_hours__saturday | Lijst van tijdsintervallen, gescheiden door ; | 08:30-9:30;13:00-14:00 | |
| opening_hours__sunday | Lijst van tijdsintervallen, gescheiden door ; | 08:30-9:30;13:00-14:00 |
🔎 Veelvoorkomende fouten bij de locatie-import oplossen
-
Ontbrekende verplichte velden: de import mislukt als een van de verplichte velden (address, city, country, name of postal_code) leeg is.
-
Dubbele locaties aangemaakt: deze fout treedt op wanneer het address als unieke identificatie wordt gebruikt en het geïmporteerde adres niet exact overeenkomt met een bestaand record. In dat geval maakt het systeem een nieuwe locatie aan in plaats van de bestaande bij te werken. Ervoor zorgen dat het adres exact overeenkomt, of de row_id of order_import_alias__location_identifier gebruiken om het record bij te werken.
-
Onjuist gegevensformaat: controleren of gegevens in velden zoals country (het landveld vereist een code van twee letters, bv. GB, niet “UK”; zie deze lijst voor de alpha-2-landcodes) en time_start (UU:MM) correct zijn opgemaakt.
-
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.
-
Ongeldige waarde voor het vooraf invullen van stops: de import mislukt als de waarde in stop_prefill__type niet een van de ondersteunde waarden is.
-
Fout bij adresvalidatie: er treedt een fout op als het address niet kan worden gevalideerd door de Google Places API en de coördinaten latitude en longitude ook ontbreken. Om dit op te lossen, controleren of het adres correct is, of de coördinaten latitude en longitude handmatig invoeren.
-
Hoofdlettergevoelige kolomkoppen: kolomkoppen moeten met de juiste hoofdletters en kleine letters worden ingevoerd (bv.
vat_number, nietVAT_number). Bij onjuist hoofdlettergebruik 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 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.
-
Waarom selecteert Qargo bij een import het verkeerde adres?
De meest waarschijnlijke oorzaak is een onjuiste importalias op het locatierecord. Als een locatie een alias heeft die overeenkomt met een naam in het importbestand, koppelt Qargo de import aan die locatie, ook als het de verkeerde is. De locatie in Qargo openen, naar de instellingen gaan en de sectie Aliassen onder het tabblad Locaties controleren. Met het potloodpictogram de alias corrigeren, of de alias volledig verwijderen als die er niet hoort te staan. -
Waarom kiest het AI/OCR-systeem de verkeerde locatie uit een document?
Dit gebeurt meestal wanneer de locatiegegevens in Qargo niet goed overeenkomen met de bewoording op het document. Controleren of de locatienaam, het adres en de weergavenaam overeenkomen met hoe ze op de PDF of het geïmporteerde document staan. Hoe beter de overeenkomst, hoe nauwkeuriger de AI de juiste locatie kan herkennen. -
Hoe kan een verkeerde adresselectie in de toekomst worden voorkomen?
Drie zaken helpen: aliassen up-to-date houden en ze alleen instellen wanneer dat echt nodig is, overal in Qargo consequente naamgevingsregels voor locaties gebruiken, en nieuwe importinstellingen eerst met voorbeeldgegevens testen voordat ze volledig worden uitgevoerd.
✨ Aanbevolen werkwijze voor het importeren van locaties
- Een nieuw sjabloon gebruiken: voor elke nieuwe import altijd een leeg sjabloon gebruiken dat rechtstreeks van het Qargo-platform is gedownload.
- De gegevens opschonen: vóór een import controleren of de gegevens in het bronbestand opgeschoond, consistent en correct opgemaakt zijn, om fouten te beperken.
- Rekening houden met de bestandsgrootte: het verwerken van langere werkbladen kan veel tijd in beslag nemen.
➡️ Volgende stappen
Zodra de locaties met succes zijn geïmporteerd, kunnen ze worden gebruikt bij het aanmaken van orders. Ze verschijnen als beschikbare ophaal- en leveringspunten bij het aanmaken van een nieuw order.
📈 Toepassingen van de locatie-import
De locatie-import is een waardevol hulpmiddel voor verschillende belangrijke bedrijfsprocessen:
- Initiële inrichting van de tenant: een nieuwe Qargo-tenant vullen met een volledige lijst van vaste klant-, leveranciers- of magazijnlocaties.
- Nieuwe locaties toevoegen: na een uitbreiding van het bedrijf nieuwe bedrijfslocaties of ophaal- en leveringspunten in bulk toevoegen.
- Integraties instellen: de orderimportaliassen van een locatie aanmaken of bijwerken om de locatie aan een extern systeem te koppelen.
