Aan de slag met filedrop‑integratie (import) – nShift Ship Help Center

Het merendeel van de nShift-klanten heeft een vorm van integratie tussen nShift Ship en hun ERP-, WMS- of andere systemen. De filedrop-integratie (Import Setup) in On-premises heeft veel geavanceerde mogelijkheden en kan worden geconfigureerd om in vrijwel elke opzet te passen.

Dit artikel legt uit hoe u een basis filedrop-integratie instelt in nShift On-premises. Neem contact op met onze klantenservice als u hulp nodig heeft bij het configureren van uw integratie of als u vragen heeft over de geavanceerde configuratiemogelijkheden.

Inhoud van dit artikel:

Concept en workflow
Activeren van Import Setup
Bestandsinhoud specificeren
Velden toevoegen en verwijderen
Configureren van vervoerder-voorinstellingen

Concept en workflow

Ship On-premises kan orders importeren uit elk systeem dat een bestand kan genereren. Het systeem moet een bestand kunnen aanmaken en dit plaatsen in een gedeelde map die voor beide systemen toegankelijk is. Ship On-premises zal de map monitoren en zodra het een herkenbaar bestand in de importmap detecteert, zal het het bestand importeren en lezen, en het vervolgens verwijderen of naar een back-upmap verplaatsen na verwerking.

FileDrop model

In de onderstaande voorbeelden hebben we een CSV-bestand gebruikt. Dit formaat is eenvoudig om mee te werken, maar nShift Ship ondersteunt vrijwel alle formaten, waaronder platte tekstbestanden, standaard veldlengtes, Excel en XML. Als u XML-bestanden gebruikt, transformeert de import de bestanden op basis van een XSLT-stylesheet die u moet opgeven.

Activeren van Import Setup

Ga naar Setup en selecteer waar u de importinstelling wilt plaatsen. Deze kan worden geplaatst op Installation, Location, of Actor-niveau. Klik met de rechtermuisknop aan de rechterkant van het scherm en selecteer New > Import Setup.
Om te beginnen, vink Import Active aan. De integratie is alleen actief wanneer dit vakje is aangevinkt, en het moet actief zijn om wijzigingen te kunnen maken.
Klik op New en specificeer een Source Folder waar On-premises de bestanden uit uw systeem ophaalt. Het is mogelijk om meerdere bronmappen toe te voegen.
Specificeer de bestandsnaam en extensie.
Threads worden gebruikt om meerdere bestanden tegelijkertijd te verwerken. Het aantal threads komt overeen met het aantal bestanden dat gelijktijdig kan worden geïmporteerd vanuit dezelfde bronmap. Meerdere bronnen worden één voor één verwerkt.
Klik op OK om op te slaan.
In de sectie After Import moet u selecteren wat er moet gebeuren nadat On-premises een bestand heeft verwerkt. U kunt ervoor kiezen om het automatisch te verwijderen, naar de prullenbak te verplaatsen of naar een opgegeven map te verplaatsen. Klik op OK om uw instellingen op te slaan.

Bestandsinhoud specificeren

U moet in On‑premises configureren hoe bestanden uit uw systeem worden gelezen, door het scheidingsteken op te geven en te bepalen hoe de velden in het bestand worden gekoppeld aan de velden in On‑premises. Het tabblad Import Setup bevat veel functionaliteit. Dit artikel legt de instellingen uit die nodig zijn voor een basisimportinstelling.

Ga naar het tabblad Import Setup.
Specificeer de Character separator die in uw bestanden wordt gebruikt. In dit voorbeeld wordt "," gebruikt. (Om XML-bestanden te gebruiken, moet u op de knop Select klikken en een XSLT-bestand opgeven.)
Verschillende systemen gebruiken verschillende eenheden, dus het is belangrijk om de eenheden te specificeren die in uw bestanden worden gebruikt. Klik op de knop Unit om uw eenheden te specificeren en klik op OK.
Nu moet u de velden in uw bestanden koppelen aan velden in On-premises. Dit is eenvoudiger als u een voorbeeldbestand uit uw systeem heeft. Kies Select file, zoek een bestand en klik op Preview om een lijst van alle velden in het bestand te zien.
Koppel de velden door op elke regel in de kolom Shipment Field te klikken en het overeenkomstige On-premises-veld te selecteren uit de keuzelijst. U kunt in de keuzelijst zoeken door te typen.
In het onderstaande scherm zijn alle velden gekoppeld. Als u een veld in uw bestand heeft dat door On-premises moet worden genegeerd, kunt u de waarde Unknown->Unknown behouden.

Velden toevoegen en verwijderen

U kunt velden toevoegen of verwijderen door op de knop Fields te klikken.

append field

Bij het toevoegen van een veld moet u het veldtype kiezen. Kies tussen een normaal veld en een expressie. De velden in het bovenstaande voorbeeld zijn van het type Field.

Het toevoegen van expressies aan uw importinstelling geeft u de mogelijkheid om verschillende regels in te stellen en waarden in verschillende velden te vergelijken en te wijzigen. Ga voor meer informatie over het gebruik van expressies naar het artikel: Using expressions in your import setup.

Configureren van vervoerder-voorinstellingen

Op het tabblad Carrier PreSettings kunt u codes uit uw ERP-systeem specificeren die kunnen worden gebruikt om een specifieke locatie, actor, subvervoerder, product en services te selecteren om een zending te maken.

Selecteer de Location en Actor waarop de configuratie van toepassing moet zijn. Als de Import Setup is toegevoegd op Location- of Actor-niveau, kunt u geen andere locatie kiezen dan de huidige.
Klik op de knop New.
Voer een Carrier code in en, indien van toepassing, een Actor alias. De actor alias kan worden gebruikt om een specifieke actor in de bestanden te selecteren.
Selecteer Carrier, SubCarrier, en Product. De inhoud van Enabled Carriers weerspiegelt de geselecteerde Location en Actor in stap 1.
Selecteer Services indien relevant. U kunt meerdere services selecteren of deze leeg laten, tenzij u een vervoerdercode maakt voor een product met verplichte services.
Selecteer een Stack als u wilt dat de zendingen naar een andere stack worden gestuurd dan de standaard stack voor het product.
Als u Autoprint labels aanvinkt, worden alle zendingen die overeenkomen met de vervoerder-voorinstellingen automatisch verzonden na import.
Mappings kunnen worden gebruikt om verschillende codes te vertalen. U kunt bijvoorbeeld dezelfde code gebruiken voor een pallet bij al uw vervoerders, ook al gebruiken zij verschillende codes.

In dit voorbeeld hebben we de goederentypecode "BOX" gekoppeld aan het goederentype "PA-BOX-Parcel" bij vervoerder DHL Express.
Klik op OK op de pagina Carrier PreSettings wanneer u alle instellingen heeft geconfigureerd. U kunt nu de vervoerdercodes in uw bestanden gebruiken om zendingen te maken met de opgegeven producten en services.