The returns and cancellations module handles order lifecycle events that originate in NetSuite. The template includes two flows: one that submits return authorizations from NetSuite back to Amazon MCF, and one that cancels MCF orders when a cancellation is recorded in NetSuite.
Flow 1: NetSuite RMA to Amazon Returns
The returns flow reads NetSuite Return Merchandise Authorization (RMA) records and creates the corresponding Amazon MCF return requests via the SP-API. Amazon MCF manages physical return logistics through its own returns processing network.
How the flow works
- Get NetSuite Returns (Export): Uses a NetSuite saved search (Search ID: 6387, record type: returnauthorization, "once" mode) to fetch return authorization records that have not yet been exported to Amazon.
- Create Amazon Fulfillment Return (Import): For each RMA, calls the Amazon Returns API (POST /fba/outbound/2020-07-01/fulfillmentOrders/{sellerFulfillmentOrderId}/return) with the return items and quantities.
Note: Ensure the originating sales order exists and has a corresponding Item Fulfillment record in NetSuite before the returns flow will process correctly. The return is linked to the Amazon fulfillment order via the sellerFulfillmentOrderId (the NetSuite sales order number).
Flow 2: NetSuite Cancellation to Amazon (MCF) Cancellation Add
The Cancellations flow sends order cancellation requests from NetSuite to Amazon MCF. Orders can only be cancelled before they enter the Processing status. Once Amazon has begun picking and packing, the order cannot be cancelled via API.
How the flow works
- Get NetSuite Amazon MCF Order Cancellations (Export): Uses a NetSuite saved search (Search ID: 6390, record type: salesorder, "once" mode using the custbody_celigo_amzmcf_can_order_exp boolean field) to find sales orders that have been cancelled and have a corresponding Amazon MCF fulfillment order.
- Cancel MCF Order in Amazon (Import): Calls the Amazon cancelFulfillmentOrder API (PUT /fba/outbound/2020-07-01/fulfillmentOrders/{SellerFulfillmentOrderId}/cancel) to cancel the fulfillment order if it is still in a cancellable state.
Cancellability by Amazon MCF Order Status
| Amazon MCF order status | Can be cancelled? | Notes |
|---|---|---|
| Received | Yes | Order submitted to Amazon but not yet assigned to a fulfillment center. |
| Planning | Yes | Amazon is planning the shipment but has not started physical fulfillment. |
| Processing | No | Amazon has started picking and packing. Contact Amazon Seller Support if cancellation is critical. |
| Shipped | No | Order is on its way to the customer. Initiate a return instead. |
| Complete | No | Order is delivered. Initiate a return instead. |
| Unfulfillable | No | Amazon could not fulfill the order (e.g., out of stock). Already inactive. |
Important: Always cancel MCF orders as soon as possible after the cancellation decision is made. Amazon fulfillment centers begin processing orders quickly. If an order cannot be cancelled, the fulfillment will complete, and you will need to process a return once the customer receives the package.
Cancellations settings
Access and configure the cancellations setting from the Integration tile > Settings > Cancellations before enabling the cancellations flow.
| Setting (field label) | Type | Required | Description |
|---|---|---|---|
| NetSuite saved search for syncing cancelled orders | Export Select (Saved Search picker) | Yes | Select the NetSuite saved search that identifies cancelled sales orders with a corresponding Amazon MCF fulfillment order (eTail Order ID is populated). The flow uses this search to determine which orders to send cancellation requests for in Amazon. |
Returns and Cancellations decision guide
| Situation | Action |
|---|---|
| Order submitted but not yet in Processing status | Cancel via the NetSuite Cancellation to Amazon (MCF) Cancellation Add flow. No return needed. |
| Order shipped; customer wants to return | Wait for delivery, then initiate a return via the NetSuite RMA to Amazon Returns flow. |
| Order in Processing status; customer wants to cancel | Cannot cancel via API. Contact Amazon Seller Support. If shipped, process a return after delivery. |
| Order created in Hold status and no longer needed | Cancel via the cancellations flow. Hold orders are in Received status and are cancellable. |