Intro
This markdown contains documentation about integration with Hellman for inserting shipments into their Nachon TMS
General Information
-
Reference generator used to create a tracking reference per handlingUnit.
-
A generic package label is created with common function
getPackageLabel() -
The upload file name consists of the following
$filePrefix + "_hellman_" + $timeStamp + ".csv"$filePrefix== Configuration.onboarding.helFilenameprefix
-
Only
x1 dangerous goodscan existin handlingUnitsfor a single order request. -
Consignment Instructions will be added to ZN10 number 3:
_3ConsignmentInstruction:"Collection:" + Model?.instructions.carrierInstructions.collection +"| Delivery:" + Model?.instructions.carrierInstructions.delivery +"| Transport:" + Model?.instructions.carrierInstructions.transport | string.slice 0 200,
Services Supported
| ServiceCode | Description | Trigger |
|---|---|---|
| 0000 | Innight service | Model.serviceLevelReference 'NIGHT' or 'nightBelow40kg' (weight below 40kg) |
| 999 | Innight service | Model.serviceLevelReference 'NIGHT' or 'nightAbove40kg' (weight above 40kg) |
| 880 | Standard service | Model.serviceLevelReference 'STANDARD' or 'standardBelow40kg' (weight below 40kg) |
| 888 | Standard service | Model.serviceLevelReference 'STANDARD' or 'standardAbove40kg' (weight above 40kg) |
| ECO | Economy service | Model.serviceLevelReference 'ECONOMY' or 'economy' |
| H12 | Next day pre 12 | Model.serviceLevelReference 'H12' or 'nextDay1200' |
ServiceLevel and ZN4: Unloading times
serviceLevelReference == NIGHT
_1UnloadingDate: (Model.timeWindows.pickup.end |date.parse) |date.to_string '%d/%m/%y',_2UnloadingTimeFrom: "",_3UnloadingTimeTo: ""serviceLevelReference != NIGHT
_1UnloadingDate: Model.timeWindows.delivery.end |date.parse | date.to_string '%d/%m/%y',_2UnloadingTimeFrom: Model.timeWindows.delivery.start |date.parse | date.to_string '%H:%M',_3UnloadingTimeTo: Model.timeWindows.delivery.end |date.parse | date.to_string '%H:%M'Service options
| Option | Trigger | Scenario |
|---|---|---|
| Cash on delivery | Model.serviceOptions.cashOnDelivery?.value and Model.serviceOptions.cashOnDelivery?.currencyCode | ’cash-on-delivery’ |
| Cooled | Model.serviceOptions.equipmentTemperature = COOLED | ’cooled’ |
| Dangerous goods | Model.containsDangerousGoods | true |
| Frozen | Model.serviceOptions.equipmentTemperature = FROZEN | ’frozen’ |
| Taillift | Model.serviceOptions.liftGate.collection or Model.serviceOptions.liftGate.delivery | ’true’ |
Configuration
| Configure | Section Use | Number |
|---|---|---|
| Configuration.ftpClientReferenceProduction | request URL | N/A |
| Configuration.ftpClientReferencePlayground | request URL | N/A |
| Configuration.onboarding.helFilenameprefix | request URL | N/A |
| Configuration.onboarding.helDepartment | OR0 | 6 |
| Configuration.onboarding.loadingValueToken | ZN7 | 1 |
| Configuration.onboarding.unloadingValueToken | ZN8 | 1 |
| Configuration.onboarding.hellmanReference1ValueToken | ZN10 | 1 |
| Configuration.onboarding.hellmanReference2ValueToken | ZN10 | 2 |
| Configuration.onboarding.hellmanReference3ValueToken | ZN10 | 5 |
| Configuration.onboarding.hellmanLogisticUnitIdentification | Reference Generator | N/A |
| Configuration.communicatorSftp | SFTP upload | N/A |