Skip to Content
Author's profile photo Tim Chang

Third Party Logistics in BYD using External Warehouses – An Overview Part 1 of 2

Many medium-sized companies (or even large ones) find it more cost-effective to outsource their shipping and logistics to outside vendors, especially in international countries.  It makes a lot of sense with savings in time, money and business experience than the option of investing major dollars in setting up their own warehouses, hiring, etc…

This leads to one of my favorite features in BYD —  Third Party Logistics or 3PL.  

The business scenario is where the BYD system integrates with the system of an external warehouse provider in outbound deliveries, inbound goods receipts and inventory management.  We call this the 3PL provider – who may control multiple warehouses in different countries.

In part 1 of this blog, let’s talk about the outbound section.  In BYD, you create sales orders which are tagged to ship from the external 3PL warehouse.  These orders then generate into delivery proposals.  The proposals are converted to 3PL requests which are sent as XML messages to your 3PL provider.  They receive the electronic requests, and ship the goods out to the customer from their warehouse. 

Sounds neat, doesn’t it ?

3PL Outbound Flow.png

The implementation of 3PL in BYD is essentially an integration project. 

BYD  provides the Third-Party Logistics work center to manage this. 

3PL WC.png

As part of this integration project, the Third-Party Logistics Integration communication arrangement will be used.

For outbound deliveries, there are 2 web services used – each with its own XML template.


  • Outbound Delivery Request (ODER
  • Outbound Delivery Confirmation (ODEC)

The 2 web services support the request-response paradigm of 3PL.  When a request is sent out to your 3PL vendor to do a delivery of an order, they must send back a confirmation to that request as to items and quantity shipped.  If no confirmation is sent back, the ODER is still outstanding and the Sales Order is not completed.

Outbound delivery requests (ODERs) will also include Return to Suppliers and Stock Transfer actions (essentially anything outbound).

Like any integration project, it requires project planning, tight coordination, technical expertise to consume the web services, test case planning and execution to make it a success.  There is no coding work on the BYD side.  The 3PL vendor will need to be able to consume the BYD web services and its XML payloads – so the programming effort is generally needed on the 3PL vendor systems to be implemented.

My experience in leading the 3PL implementation project at a Silicon Valley company shows that the 3PL feature works quite well in supporting Sales-to-Shipping process at multiple international warehouses.

Next week I will write part 2 of this blog on the inbound side of the 3PL feature.

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Suresh Babu Mula
      Suresh Babu Mula

      good content helps many to understand 3PL

      Author's profile photo Former Member
      Former Member

      This is really very useful, but can someone point me in the right direction for some data mapping documentation on the fields in the XML string, and the type codes accepted by ByD for the different transactions?

      John Meadows

      Author's profile photo Stefan Resag
      Stefan Resag

      Hi John,

      you might find the following information helpful:

      Down there you can find a section B2B messages, which provide you with the mapping information. There is also a How to guide which gives a good overview of the process.

      Best regards,


      Author's profile photo Former Member
      Former Member


      We are acting as a 3PL for a ByD customer. Can you explain the messaging that would come into play if the Sales Order that generated the ODER was cancelled? What message would be sent to the 3PL to attempt a cancellation? I know the 3PL may not be able to action if the order has been fulfilled or waved into a pick but is there a facility for this message to be sent and accepted / rejected by the 3PL?



      Author's profile photo Tim Chang
      Tim Chang
      Blog Post Author

      Sorry for the delay.   In our project, the 3PL reviewed all the ODERs nightly, and if there were cancellations (thru email or phone call),  they would reply with ODEC that it was not fulfilled.


      Author's profile photo Yvonne van Straten
      Yvonne van Straten

      Hello Tim,


      I was wondering if within the 3PL integration an update of the outbound delivery is foreseen?

      Eg for our customer, we get an outbound delivery via 3PL, and an updated proof of delivery (Date and timestamp) later on. We xan easily extend the outbound delivery object, but it is not yet clear to me if the outbound delivery notiication can execute an update message, or only a create message.


      Hope to hear from you


      Kind regards,



      Author's profile photo Tim Chang
      Tim Chang
      Blog Post Author


      Yvonne,   I think you will have to test that idea as it's been some time since my article, and things may change since then.  Try with soapUI with a 2nd ODEC and updated timestamps and see how it looks.   You can copy the XML from the 1st ODEC and change it up.

      Author's profile photo Lena Wacker
      Lena Wacker

      Hi Tim,

      is it also possible to use the 3PL-scenario with Service Orders?
      Or is it just available for Sales Orders?


      Best regards