Bill of Lading Surrender Conformance for Carriers
This page provides a step-by-step guide for measuring the conformance of a carrier application with the Surrender 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 the DCSA synthetic platform (eBL Solution Provider) running in the sandbox will send API surrender requests to your carrier application
- how your carrier application will send asynchronous surrender responses to the DCSA synthetic platform running in the sandbox.
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 Surrender scenario run
This is a step-by-step example of running the typical Surrender scenario, which involves just receiving the surrender request and sending back the asynchronous surrender 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 values with those for which your carrier application can process a surrender request as indicated by the scenario type:
Handle the issuance request
Once you submit the scenario parameters, the synthetic platform (eBL solution provider) running in the DCSA sandbox will send a surrender request with those parameters to your carrier application, after which the scenario should look like this:
If your carrier application processes surrender requests and sends surrender responses automatically, the remaining checks can already be green as well.
Otherwise, have your carrier application process the surrender request and send an asynchronous surrender response back to the synthetic platform running in the DCSA sandbox.
Refresh the status to see the updated conformance validation results:
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:
