Zhipster logo

Integration between Ongoing WMS and Zhipster

Zhipster is a SaaS solution for delivery and shipping management.

Features

Generate labels directly from Ongoing WMS

You can create shipments in Zhipster based on an order in Ongoing WMS. The integration supports return shipments as well. All label information (address, number of packages, etc.) can be entered into Ongoing WMS, and then transferred to Zhipster at the click of a button.

When the shipment has been created, Ongoing WMS will receive a response from Zhipster containing the label and tracking information.

Default setup

The order is sent to Zhipster when the Send button is pressed in Ongoing WMS.

If it validates, a label will be returned to Ongoing WMS immediately, which is printed automatically.

Preparations

The following data is required to set up an integration with Zhipster:

  1. API Key
Please ask Zhipster to supply this to you.

After you have gathered this information, please see this guide on how to set up an integration between Ongoing WMS and Zhipster.

Mapping

Zhipster shipment - Ongoing WMS Order

Show field mapping

Zhipster Ongoing WMS
ShipmentType"Standard"
ShipmentStatus"Registered"
ShipmentKeyOrderInfo⇒OrderId (+ "-R" for returns)
ShipmentTemplateIDReturnTransporter⇒WaybillTemplate or Financial⇒WaybillTemplate
TransportInformation
ForwarderEDI
ReserveShipmentfalse
TransferShipmentfalse
RequestPickupfalse
ForwarderIDReturnTransporter⇒TransporterCode or Transporter⇒Code
ForwarderNameReturnTransporter⇒TransporterName or Transporter⇒TransporterName
TermsOfDeliveryIDOrderInfo⇒TermsOfDelivery (None* for returns)
FreightPaymentBybased on Financial⇒TransportPaymentType
FreightPaymentThirdPartyTransportPayer⇒CustomerCode (if FreightPaymentBy is ThirdParty)
DeliveryInstructionsOrderInfo⇒DeliveryInstruction (None* for returns)
IsReturnShipmenttrue for returns, false otherwise
Shipper
PartyIDIntegration settings ⇒ Party ID of shipper in Zhipster
Name[GoodsOwnerInfo⇒Name] c/o [Name of warehouse]
AddressAndContactAddress details of the goodsowner's default warehouse.
Consignee
PartyIDConsignee⇒CustomerNumber
NameConsignee⇒Name
Address
NameConsignee⇒Name
Street1Consignee⇒Address
Street2Consignee⇒Address2
CityConsignee⇒City
ZipCodeConsignee⇒PostCode
CountryCodeConsignee⇒CountryCode
StateCodeConsignee⇒CountryStateCode
Contact
NameConsignee⇒Name
PhoneNumberOrderInfo⇒SMSNotification (or OrderInfo⇒TelephoneNotification if SMSNotification is empty)
EmailAddressOrderInfo⇒EmailNotification
Commercial
PartyIDReturnTransporter⇒TransporterContractEdiCode or Financial⇒PriceListCode
NameGoodsOwnerInfo⇒Name
Address
NameGoodsOwnerInfo⇒Name
Street1GoodsOwnerInfo⇒Address
Street2GoodsOwnerInfo⇒Address2
CityGoodsOwnerInfo⇒City
ZipCodeGoodsOwnerInfo⇒PostCode
CountryCodeGoodsOwnerInfo⇒CountryCode
Contact
NameGoodsOwnerInfo⇒Name
PhoneNumberGoodsOwnerInfo⇒TelePhone
EmailAddressGoodsOwnerInfo⇒Email
GoodsItemsEach GoodsItem is mapped as follows
GoodsItemKeyGoodsItem⇒Id
NumberOfPackagesGoodsItem⇒NumberOfPackages
PackageTypeIDGoodsItem⇒PackageTypeCode
ItemDescriptionGoodsItem⇒GoodsCategory
WeightInKgGoodsItem⇒Weight (or PackageTyperArr;Weight if GoodsItem⇒Weight is 0)
LengthInCm, WidthInCm, HeightInCmFrom GoodsItem if all three fields on GoodsItem are non-zero, otherwise all three are taken from PackageType.
VolumeInM3GoodsItem⇒Volume
LoadingMetersGoodsItem⇒LoadMeters
PrintSettingsNone* if Integration settings ⇒ Printing strategy = "None". Otherwise the following, once for each document type.
Document"ParcelLabel", "ConsignmentNote"
PrintMode"Url" (The URL in response is used by the integration to fetch the PDF and print it.)
NumberOfCopies"1"
DispatchOrderNone* for returns, otherwise the following.
DispatchOrderKeyOrderInfo⇒OrderId
DispatchOrderNumberOrderInfo⇒GoodsOwnerOrderNumber
DispatchOrderLinesEach picked order line is mapped as follows
DispatchLineKeyPickedOrderLine⇒OrderLineSystemId
DispatchLineNumberPickedOrderLine⇒ExternalOrderLineCode (or OrderLineSystemId if ExternalOrderLineCode is empty)
ConnectedLineKeyPickedOrderLine⇒ParentOrderLineId (None* if the order line is not part of a structure.)
RequestedQuantityPickedOrderLine⇒OrderedNumberOfItems
DispatchedQuantityPickedOrderLine⇒PickedNumberOfItems
ArticleDescriptionPickedOrderLine⇒Article⇒Name
SuppliersArticleNumberPickedOrderLine⇒Article⇒ArticleNumber
MeasurementUnitPickedOrderLine⇒Article⇒ArticleUnitCode
WeightInKgPickedOrderLine⇒Article⇒Weight
NetWeightInKgPickedOrderLine⇒Article⇒NetWeight
LengthInCmPickedOrderLine⇒Article⇒Length * 100
WidthInCmPickedOrderLine⇒Article⇒Width * 100
HeightInCmPickedOrderLine⇒Article⇒Height * 100
VolumeInM3PickedOrderLine⇒Article⇒Volume

None* = those fields are not in the default set up, but it is easy to set them to any field in Ongoing WMS.