Shipment Return AWB

This guide explains how to test the shipment return flow for a Shipping App end to end and verify that it correctly generates the return shipment AWB label inside a Salla store.

What you will learn

In this article, the focus is on testing shipment returns using a demo store and confirming that the related App works behave as expected.

How to test the shipment return flow

Testing the shipment return flow is important to detect issues before publishing the app. This helps ensure that return shipments are created correctly and that the AWB label, tracking link, and status updates work as expected.

The Shipping App can be tested using a Salla demo store to confirm the connection between the App and the store, which is fired when the merchant generates a return shipping policy.

App Testing Scenarios

For this testing scenario, the focus will be on the flow where the merchant generates a shipping policy, which allows the return shipment logic to be tested.

Start the return-label flow

Pick an order that already has its original shipping label, open the action dropdown, and choose Create return label so Salla knows you want to generate a return AWB.

Fill the return shipment form

Complete the return-label form with the required package information, pickup/drop-off details, and any carrier-specific data, then click Apply action.

Call to App Functions (Shipment Creation)

When you apply the action, Salla will make a call to the App Functions (Shipment Creation) you created. Find out more details as explained in the Shipment Creating article here.

Shipping App generates and returns AWB data

After receiving the call to App Functions, the Shipping App must call the shipping company's API to generate the return shipment AWBs.
That API will respond with the relevant shipping details, such as :

PDF label

Tracking link

Tracking number

Your App Function then maps these values into Salla’s Shipment response, which will update the shipment details directly to Salla.

Response from App Functions

Success

Error

Once successful, you will be able to see a message on the screen indicating that the shipment is created.

What you will learn#

How to test the shipment return flow#

App Testing Scenarios#

What you will learn

How to test the shipment return flow

App Testing Scenarios