Delivery (DESADV) - API

Delivery (DESADV) - API

Insert a delivery for this product into the database. The delivery message can only be sent once. It will contain the delivered order lines.
There can be multiple deliveries, the DesadvNumber must be unique per delivery message. For this you need a different message.

Before sending this XML the order confirmation must be send. In this order confirmation the line numbers of the product within the order are set.

Order incoming - feedback - cXML

or

Orders PUT (feedback) - json

URL

/proxy/des_adv_xml/delivery/

Method

POST

Parameters

Extra parameter must be supplied: user and shop, eg. /proxy/des_adv_xml/delivery/?shop=1&user=10

Fields

No picture version

Field

Type

Mandatory

Description

Field

Type

Mandatory

Description

Desadv.DesadvDetail.Packaging.LineItems

array

yes

Collection of items with data

Desadv.DesadvDetail.Packaging.LineItems.Item.ItemNum

int

yes

The line number in the order

Desadv.DesadvDetail.Packaging.LineItems.Item.OrderNum

char

yes

The ERP ordernumber which belongs to the order.

It also checks the CloudSuite ordernumber when the ERP cannot be found

Desadv.DesadvDetail.Packaging.LineItems.Item.QuantityValue

decimal (12,4)

yes

The amount of items orders (fractions are possible)

Desadv.DesadvDetail.Packaging.LineItems.Item.SellerItemID

char

yes

Partnumber of the product

Desadv.DesadvHeader.Comment

char

no

Any comment about this packing slip

Desadv.DesadvHeader.DesadvDate

date (yyyy-mm-dd)

yes

Date of the packing slip, eg. 2017-07-02

Desadv.DesadvHeader.DesadvNumber

char

yes

Unique packing slip ID

Desadv.DesadvHeader.PlannedDeliveryDate

date (yyyy-mm-dd)

yes

The expected delivery of the products in this delivery, eg. 2017-07-02

Desadv.DesadvHeader.TransportDetails.TransportModeCode

char

yes, but can be empty

The transporter which sends the order

Desadv.DesadvHeader.TransportDetails.MeansOfTransport.Identification

char

yes, but can be empty

Track & Trace code

Desadv.DesadvParty.BuyerParty.IDInSupplierSys

char

yes

The ID of the customer

Desadv.DesadvParty.BuyerParty.Name

char

no

The name of the customer

Desadv.DesadvParty.ShipToParty.IDInSupplierSys

char

yes

The ID of the customer delivery address

Desadv.DesadvParty.ShipToParty.Name

char

no

The name of the customer (at the delivery location)

Desadv.DesadvParty.Extrinsic

char

no

Extra field: <Extrinsic name="IgnoreAddresses">true</Extrinsic>
This means that the specified addresses are ignored and taken directly from the order itself.

Multiple trackingcodes version / Pictures and multiple trackingcode version

Field

Type

Mandatory

Description

Field

Type

Mandatory

Description

Desadv.DesadvDetail.Packaging.LineItems

array

yes

Collection of items with data

Desadv.DesadvDetail.Packaging.LineItems.Item.ItemNum

int

yes

The line number in the order

Desadv.DesadvDetail.Packaging.LineItems.Item.OrderNum

char

yes

The ERP ordernumber which belongs to the order.

It also checks the CloudSuite ordernumber when the ERP cannot be found

Desadv.DesadvDetail.Packaging.LineItems.Item.QuantityValue

decimal (12,4)

yes

The amount of items orders (fractions are possible)

Desadv.DesadvDetail.Packaging.LineItems.Item.SellerItemID

char

yes

Partnumber of the product

Desadv.DesadvHeader.Comment

char

no

Any comment about this packing slip

Desadv.DesadvHeader.DesadvDate

date (yyyy-mm-dd)

yes

Date of the packing slip, eg. 2017-07-02

Desadv.DesadvHeader.DesadvNumber

char

yes

Unique packing slip ID

Desadv.DesadvHeader.PlannedDeliveryDate

date (yyyy-mm-dd)

yes

The expected delivery of the products in this delivery, eg. 2017-07-02

Desadv.DesadvHeader.TransportDetails.TransportModeCode

char

yes

The transporter which sends the order

Desadv.DesadvHeader.TransportDetails.MeansOfTransport.Identification.TrackingId

char

yes

Track & Trace code

Desadv.DesadvHeader.TransportDetails.MeansOfTransport.Identification.PackageId

char

yes

Unique package name (eq. if the package is send in multiple boxes in one shipment)

Desadv.DesadvHeader.TransportDetails.MeansOfTransport.Identification.Images.Image

char

yes

URL to the image (eq. the picture of the box before shipment)

Desadv.DesadvParty.BuyerParty.IDInSupplierSys

char

yes

The ID of the customer

Desadv.DesadvParty.BuyerParty.Name

char

no

The name of the customer

Desadv.DesadvParty.ShipToParty.IDInSupplierSys

char

yes

The ID of the customer delivery address

Desadv.DesadvParty.ShipToParty.Name

char

no

The name of the customer (at the delivery location)

Desadv.DesadvParty.Extrinsic

char

no

Extra field: <Extrinsic name="IgnoreAddresses">true</Extrinsic>
This means that the specified addresses are ignored and taken directly from the order itself.

Addendum

With this message it is possible to send shipments. Orders with multiple shipments and shipments with multiple orders are possible and can be combined. Also partial deliveries (even on orderline level) are possible.

ORDER

DELIVERY

DELIVERY 2

ORDER

DELIVERY

DELIVERY 2

ORDER 1
ORDER 2

DELIVERY A (complete)



ORDER 4

DELIVERY B (partial)
DELIVERY C (partial)



ORDER 5

DELIVERY B (partial)
DELIVERY C (partial)



ORDER 6 (20 pieces)

DELIVERY D (8)

DELIVERY E (12)

Body

No picture version

<?xml version="1.0" encoding="UTF-8"?> <Desadv> <DesadvHeader> <DesadvNumber>0080155790</DesadvNumber> <DesadvDate>2017-08-07</DesadvDate> <PlannedDeliveryDate>2017-12-01</PlannedDeliveryDate> <Comment>34|45|56</Comment> <TransportDetails> <TransportModeCode>Regular Transporter</TransportModeCode>   <MeansOfTransport>                 <Identification> DEADC387530204FACD</Identification>   </MeansOfTransport> </TransportDetails> </DesadvHeader> <DesadvParty> <BuyerParty> <Name>Customername</Name> <IDInSupplierSys>0000030735</IDInSupplierSys> </BuyerParty> <ShipToParty> <Name>Buyer name</Name> <IDInSupplierSys>0000030907</IDInSupplierSys> </ShipToParty> <Extrinsic name="IgnoreAddresses">true</Extrinsic> </DesadvParty> <DesadvDetail> <Packaging> <LineItems> <Item> <OrderNum>W000070</OrderNum> <ItemNum>1</ItemNum> <SellerItemID>357831</SellerItemID> <QuantityValue>1</QuantityValue> </Item> <Item> <OrderNum>W000070</OrderNum> <ItemNum>2</ItemNum> <SellerItemID>357835</SellerItemID> <QuantityValue>2</QuantityValue> </Item> </LineItems> </Packaging> </DesadvDetail> </Desadv>

Multiple trackingcodes

<?xml version="1.0" encoding="UTF-8"?> <Desadv> <DesadvHeader> <DesadvNumber>446909</DesadvNumber> <DesadvDate>2018-01-09</DesadvDate> <PlannedDeliveryDate>2018-01-12</PlannedDeliveryDate> <Comment/> <TransportDetails> <TransportModeCode>Transport</TransportModeCode> <MeansOfTransport> <Identification> <TrackingId>13123123123123</TrackingId> <PackageId>120851</PackageId> </Identification> <Identification> <TrackingId>54646465456455</TrackingId> <PackageId>120852</PackageId> </Identification> </MeansOfTransport> </TransportDetails> </DesadvHeader> <DesadvParty> <BuyerParty> <Name/> <IDInSupplierSys>addressid</IDInSupplierSys> </BuyerParty> <ShipToParty> <Name/> <IDInSupplierSys>11351</IDInSupplierSys> </ShipToParty> <Extrinsic name="IgnoreAddresses">true</Extrinsic> </DesadvParty> <DesadvDetail> <Packaging> <LineItems> <Item><OrderNum>286</OrderNum><ItemNum>10</ItemNum><SellerItemID>30010012_ZAK</SellerItemID><QuantityValue>3</QuantityValue></Item> </LineItems> </Packaging> </DesadvDetail> </Desadv>

Pictures and multiple trackingcode version

<?xml version="1.0" encoding="UTF-8"?> <Desadv> <DesadvHeader> <DesadvNumber>446909</DesadvNumber> <DesadvDate>2018-01-09</DesadvDate> <PlannedDeliveryDate>2018-01-12</PlannedDeliveryDate> <Comment/> <TransportDetails> <TransportModeCode>Secrid transport</TransportModeCode> <MeansOfTransport> <Identification> <TrackingId>https://someurl?query=123456&amp;locale=en_EN</TrackingId> <PackageId>120851</PackageId> <Images> <Image>https://someurl/b0a2402a-e8c1-40d4-ba17-2fca61e78226.jpg</Image> <Image>https://someurl/040a960a-1e42-4e08-ba93-194b4d3271a9.jpg</Image> <Image>https://someurl/1944c9b4-3caf-4a83-9a81-b900de68403f.jpg</Image> </Images> </Identification> <Identification> <TrackingId>https://someurl?query=123457&locale=en_EN</TrackingId> <PackageId>120852</PackageId> <Images> <Image>https://someurl/2dea61d6-9ff4-455f-8c6f-3ffdbb5fc4ed.jpg</Image> <Image>https://someurl/ba314147-dc01-4109-9e43-5f3423509b0d.jpg</Image> <Image>https://someurl/1762ac94-b1a9-4701-8d6a-fcd2f802406b.jpg</Image> </Images> </Identification> </MeansOfTransport> </TransportDetails> </DesadvHeader> <DesadvParty> <BuyerParty> <Name/> <IDInSupplierSys>addressid</IDInSupplierSys> </BuyerParty> <ShipToParty> <Name/> <IDInSupplierSys>11351</IDInSupplierSys> </ShipToParty> </DesadvParty> <DesadvDetail> <Packaging> <LineItems> <Item><OrderNum>O-23</OrderNum><ItemNum>1</ItemNum><SellerItemID>123456-1234</SellerItemID><QuantityValue>5</QuantityValue></Item> <Item><OrderNum>O-23</OrderNum><ItemNum>2</ItemNum><SellerItemID>12345-67</SellerItemID><QuantityValue>5</QuantityValue></Item> </LineItems> </Packaging> </DesadvDetail> </Desadv>

Result fields

Fieldname

Type

Description

Fieldname

Type

Description

Status@code

integer

The resultcode. See Generic response codes

Status@text

string

The description of the status.

Result example

<?xml version="1.0" ?> <cXML> <Reponse> <Status code="499" text="Error during processing:"/> </Reponse> </cXML>
Looking for labels? They can now be found in the details panel on the floating action bar.

Related content

© 2024 CloudSuite BV, All rights reserved