Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipments & Fulfillment APIs
  • Salla AWB
  • Recurring Payments API
  • App Functions
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Ecommerce Events
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Generating AWB
  • Getting Started
  • Setup Shipping App
  • Create Shipping App
  • App Functions
    • Shipment Cancelled
    • Shipment Creating
  • Generating AWB
    • Shipment AWB
    • Shipment Return AWB
    • Shipment Cancelled AWB
  1. Generating AWB

Shipment Cancelled AWB

This guide explains how to test the shipment cancellation flow for a Shipping App end to end and verify that it correctly updates the shipment status inside a Salla store.

What you will learn#

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

How to test the shipment cancellation flow#

Testing the shipment cancellation flow is important to detect issues before publishing the app. This helps ensure that cancellation requests are handled correctly and that status updates behave 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 requests to cancel an existing shipment.

App Testing Scenarios#

For this testing scenario, the focus will be on the flow where the merchant initiates a cancellation request, and allows the cancellation logic to be tested end to end.
1
Open Orders to locate a cancellable shipment
From the Merchant dashboard, hover over Orders and click All Orders to locate the shipment that is eligible for cancellation.
SCR-20251120-jmwf.png
2
Start the cancellation flow
Select an order that already has its shipping label. Open the action dropdown and choose Cancel shipment to begin the cancellation request.
SCR-20251120-jnbb.png
3
Handling the cancellation event
When you apply the action, Salla will make a call to the app function you created, where retrieve cancelled shipment details happens and then update shipment status to “Cancelled” on the shipping api system. For more details follow the details here
Shipping companies can reject cancellation if the shipment is already dispatched/delivered.
4
Success Page
Once successful, you will be able to see a message on the screen indicating that the shipment is cancelled.
Screenshot 2025-11-23 at 2.50.00 PM.png
Modified at 2025-11-24 08:48:28
Previous
Shipment Return AWB