Bill of Lading Issuance Conformance for Carriers

This page provides a step-by-step guide for measuring the conformance of a carrier application with the Issuance module of the DCSA Bill of Lading 3.0.0 standard.

To access all conformance documentation, return to the DCSA Conformance page.

 

Create and configure the sandbox

Use the instructions in the Conformance Sandboxes page to create a sandbox with the following parameters:

Use the instructions in the Conformance Sandbox Configuration page to configure:

• how your carrier application will send issuance API requests to the DCSA synthetic platform (eBL solution provider) running in the sandbox;
• how the DCSA synthetic platform (eBL solution provider) running in the sandbox will send asynchronous issuance responses to your carrier application.

 

Run each scenario

Read the Conformance Scenarios page to understand the key concepts involved in executing DCSA conformance scenarios to measure the conformance of your application with the implemented DCSA standard.

Start each scenario from the sandbox home page that is supported by your application at this time, and perform each action as explained in the general scenario page above and illustrated in the example below.

 

Example Issuance scenario run

This is a step-by-step example of running the typical Issuance scenario, which involves just sending the issuance request and processing the asynchronous issuance response.

 

Supply scenario parameters

As soon as you start the scenario, you will be prompted to supply the scenario parameters with which your application can run this scenario.

Copy the example JSON parameters into the text area below, replacing the example certificate with the certificate to be used for validating the issuance content signed by your carrier application. Remove all newlines from the exported X509 .pem certificate, keep the header and footer intact, and insert the four characters '\r\n' before and after the single-line Base64 certificate content.

 

Send the issuance request

Once you submit the scenario parameters, you get prompted to have your carrier application request the issuance of a new bill of lading of a specified (scenario-dependent) type:

Once your carrier application has submitted the issuance request, the synthetic platform running in the DCSA sandbox will respond and then send back the asynchronous issuance response.

Refresh the status to see the updated conformance status:

If the "[Response]" check is still a grey question mark, it means the issuance response has not yet been sent or has not yet been processed by your application. Just click "Refresh status" again a few seconds later.

Press "Action completed" and confirm to complete the step, which also completes the scenario. Back to the sandbox overview, the scenario is now complete and you can start another scenario, or restart the same one if there were errors that you want to fix in your carrier application and retest: