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 goods can exist in handlingUnits for 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

ServiceCodeDescriptionTrigger
0000Innight serviceModel.serviceLevelReference 'NIGHT' or 'nightBelow40kg' (weight below 40kg)
999Innight serviceModel.serviceLevelReference 'NIGHT' or 'nightAbove40kg' (weight above 40kg)
880Standard serviceModel.serviceLevelReference 'STANDARD' or 'standardBelow40kg' (weight below 40kg)
888Standard serviceModel.serviceLevelReference 'STANDARD' or 'standardAbove40kg' (weight above 40kg)
ECOEconomy serviceModel.serviceLevelReference 'ECONOMY' or 'economy'
H12Next day pre 12Model.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

OptionTriggerScenario
Cash on deliveryModel.serviceOptions.cashOnDelivery?.value and Model.serviceOptions.cashOnDelivery?.currencyCode’cash-on-delivery’
CooledModel.serviceOptions.equipmentTemperature = COOLED’cooled’
Dangerous goodsModel.containsDangerousGoodstrue
FrozenModel.serviceOptions.equipmentTemperature = FROZEN’frozen’
TailliftModel.serviceOptions.liftGate.collection or Model.serviceOptions.liftGate.delivery’true’

Configuration

ConfigureSection UseNumber
Configuration.ftpClientReferenceProductionrequest URLN/A
Configuration.ftpClientReferencePlaygroundrequest URLN/A
Configuration.onboarding.helFilenameprefixrequest URLN/A
Configuration.onboarding.helDepartmentOR06
Configuration.onboarding.loadingValueTokenZN71
Configuration.onboarding.unloadingValueTokenZN81
Configuration.onboarding.hellmanReference1ValueTokenZN101
Configuration.onboarding.hellmanReference2ValueTokenZN102
Configuration.onboarding.hellmanReference3ValueTokenZN105
Configuration.onboarding.hellmanLogisticUnitIdentificationReference GeneratorN/A
Configuration.communicatorSftpSFTP uploadN/A