Implementing the DCSA Bill of Lading Standard (SI+TD)

This is a guide to implementing the Shipping Instructions (SI) and Transport Document (TD) modules of the DCSA Bill of Lading (eBL) standard version 3.0, written for the technical teams of DCSA adopting organizations.There are separate guides for implementing the Issuance module and for implementing the Surrender module of the standard.

Reference Documentation

To get acquainted with the standard, refer to the introductory Bill of Lading standard page.To understand the key concepts, user stories, use cases and data overview of the standard, refer to the Bill of Lading documentation page.For an overview of the business processes addressed by the standard, refer to the DCSA Industry Blueprint.To understand the data structures used by the standard and how they can be mapped to your own organization's data types, consult the Transport Document model in version 2024.Q4 of the DCSA Information Model.

Implementing the Standard

To get acquainted with the general principles applicable when implementing any DCSA standard, consult the DCSA API Design and Implementation Principles.To review the reference implementation of the Bill of Lading standard, created by DCSA to verify the standard and used for measuring the conformance of adopter implementations, consult the Bill of Lading module of the DCSA conformance GitHub repository.To ensure that your organization becomes a successful adopter in the DCSA Bill of Lading standard API ecosystem, use the DCSA conformance framework periodically throughout your implementation project, to measure the conformance of your implementation and to improve it as needed.You can use a DCSA conformance sandbox as a counterpart in your development, since it allows you to easily test the most relevant scenarios that your application needs to support.

Carrier Implementation

To implement the Shipping Instructions (SI) and Transport Document (TD) modules of the Bill of Lading standard API as a carrier, use your organization's technology stack to implement each of the "/v3/shipping-instructions" and "/v3/transport-documents" endpoints of the DCSA Bill of Lading OpenAPI specification page.

Carrier To-Do list

Here is are some examples of what could be documented as part of a Carrier implementation:

The DCSA Bill of Lading (EBL) and Booking (BKG) model allows a many-to-many relation between Booking (BKG) and Shipping Instructions (SI). If your system only allows a one-to-many a many-to-one or event a one-to-one relation between the two please remember to document this
Remember to document any properties or objects that are not supported by your system. This should be done on the API and in the Feedback object returned as part of any response. As part of the Feedback object: if properties are echoed back (in a GET request) but not supported further downstream - please document this as a PROPERTY_WILL_BE_IGNORED code. If properties are removed/deleted automatically (because your system cannot store them) - please document this as a PROPERTY_HAS_BEEN_DELETED code.
Document if Notifications are supported and how to subscribe to them
Document at which points during the Shipping Instructions (SI) and Transport Document (TD) lifecycle the shippingInstructionsReference and transportDocumentReference are valid. Some carriers do not allow the use of shippingInstructionsReference after a Transport Document has been drafted.
Specify if Dangerous Goods (DG) and Reefer is supported

Shipper Implementation

To create and manage Shipping Instructions or to amend Transport Documents through the DCSA Bill of Lading standard API implementation of any carrier, use your organization's technology stack to build a backend API client application using the DCSA Bill of Lading OpenAPI specification page.As an alternative, you can also use directly the corresponding API specification page of one of the carriers with which you need to create and manage bookings through the DCSA Bill of Lading standard API.To optionally receive notifications through the DCSA Bill of Lading API SI / TD Notifications endpoints about the Shipping Instructions or Transport Documents of your organization from a carrier who offers notifications support, use your organization's technology stack to implement the "/v3/shipping-instructions-notifications" and "/v3/transport-document-notifications" endpoints of the DCSA Bill of Lading OpenAPI specification page and use the carrier's proprietary process to register your endpoints.

Booking and Bill of Lading

For a technical guide to implementing Booking and Bill of Lading together please visit: Implementing Booking and Bill of Lading.👉Important note: While implementing the standard, run conformance periodically and use the Conformance Tool as a compass to guide the implementation. Don't wait until implementation has been finished and then run Conformance.

Version overview

List of changes and the version they are released in

Version	Date of Publication	Change	Purpose of change
3.0.1	31 July 2025	Added a new optional property Shipping Instructions requestor in the Shipping Instructions.	This allows customers to provide the details of the agent/third party who submitted the Shipping Instructions on behalf of the shipper to the carrier, so that the carrier can contact them in case any clarifications or corrections are needed.
3.0.1	31 July 2025	Added a new optional property Transport Document Reference in the Shipping Instructions.	This allows customers to indicate which Transport Document Reference should be linked with this Shipping Instructions. This is relevant when the customer has previously received from the carrier a list of Transport Document References that they can choose from.
3.0.1	31 July 2025	Added 2 new optional properties in SI: Carrier Code and Carrier Code List Provider.	This allows a service provider receiving the Shipping Instructions from their customers to know to which carrier the Shipping Instructions should be routed to.
3.0.1	31 July 2025	Removed upper limit on number of lines for Displayed address	This allows the carrier to customize the address printed on paper BLs, based on the number of lines supported by their system.
3.0.1	31 July 2025	Updated definition of Party contact details.	This removes ambiguity on which party it refers to.
3.0.1	31 July 2025	Added 4 new eBL Solution Providers: COVA (Covantis) ETIT (e-title) KTNE (KTNET) CRED (Credore)	This allows to use the DCSA Bill of Lading standard with all the eBL Solution Providers approved by IGP&I up to July 28, 2025.