Vous êtes sur la page 1sur 12

This tab defines the order scenarios available in the "Execution of Scenarios" tab of this file.

Order Design: A(3) Order Design: A(2) B(1) Order Design: A(1) B(1) C(1)
SKU A (Qty: 1)
SKU A (Qty: 2) SKU B (Qty: 1)
Scenario # Action SKU A (Qty: 3) SKU B (Qty: 1) SKU C (Qty: 1)
Ship All Items in Order Ship All Items in Order Ship All Items in Order
1 Full Order Shipment
One Shipment One Shipment One Shipment
Ship A, Qty 1 (first tracking #)
2 Partial/Split Shipments Ship A Qty 1 (first tracking #) Ship A, Qty 1 (first tracking #) Ship B, Qty 1 (second tracking #)
Ship A Qty 2 (second tracking #) Ship A, Qty 1 and B, Qty 1 (second tracking #) Ship C, Qty 1 (third tracking #)
Full Order Level Cancellation (Order Level)
3
Used when Marketplace Allows Order Level Cancel All Items in Order (at Order Level) Cancel All Items in Order (at Order Level) Cancel All Items in Order (at Order Level)
Full Order Level Cancellation (Order Item Level)
4
Used when Marketplace Doesn't Allow Order Level Cancel Items in Order (at Order Line Item Level) Cancel Items in Order (at Order Line Item Level) Cancel Items in Order (at Order Line Item Level)
Full Shipment,
5 Full Refund (Order Level) Ship All Items in Order; Ship All Items in Order; Ship All Items in Order;
Used when Marketplace Allows Order Level Refund All Costs on Order (at Order Level) Refund All Costs on Order (at Order Level) Refund All Costs on Order (at Order Level)
Full Shipment, Ship All Items in Order; Ship All Items in Order; Ship All Items in Order;
6 Full Refund (Order Item Level) Refund All Costs on Order (at Order Line Item Refund All Costs on Order (at Order Line Item Refund All Costs on Order (at Order Line Item
Used when Marketplace Doesn't Allow Order Level Level) Level) Level)
Full Shipment, Ship All Items in Order; Ship All Items in Order; Ship All Items in Order;
7
Partial Refund Refund SKU A, Qty 1 Refund SKU A, Qty 1 Refund SKU A, Qty 1
Ship All Items in Order; Ship All Items in Order; Ship All Items in Order;
Full Shipment,
8 Refund SKU A, Qty 1; Refund SKU A, Qty 1; Refund SKU A, Qty 1;
Multiple Partial Refunds
Refund SKU A, Qty 1 Refund SKU B, Qty 1 Refund SKU B, Qty 1
Partial Cancellation, Cancel SKU A, Qty 1; Cancel SKU A, Qty 1; Cancel SKU A, Qty 1;
9
Full Shipment Ship Remaining Items in Order Ship Remaining Items in Order Ship Remaining Items in Order
Partial Cancellation, Cancel SKU A, Qty 1; Cancel SKU A, Qty 1; Cancel SKU A, Qty 1;
10 Partial Shipment, Ship Remaining Items in Order Ship Remaining Items in Order Ship Remaining Items in Order
Partial Refund Refund SKU A, Qty 1 Refund SKU A, Qty 1 Refund SKU B, Qty 1
Partial Cancellation, Cancel SKU A, Qty 1; Cancel SKU A, Qty 1; Cancel SKU A, Qty 1;
Partial Shipment, Ship Remaining Items in Order Ship Remaining Items in Order Ship Remaining Items in Order
11
Full Refund (Order Level) Refund All Remaining Items in Order in One Refund All Remaining Items in Order in One Refund All Remaining Items in Order in One
Used when Marketplace Allows Order Level Request Request Request
Partial Cancellation,
Partial Shipment,
Full Refund (Order Item Level) Cancel SKU A, Qty 1;
12 Used when Marketplace Doesn't Allow Order Level Cancel SKU A, Qty 1; Ship Remaining Items in Order
OR Cancel SKU A, Qty 1; Ship Remaining Items in Order Refund SKU B, Qty 1
When Want to Retain Shipping Costs Until Last Ship Remaining Items in Order Refund SKU A, Qty 1 Refund SKU C, Qty 1
Refund Request is Made Refund SKU A, Qty 2 Refund SKU B, Qty 1 Refund SKU A Remaining Costs
Cancel SKU A, Qty 2; Cancel SKU A, Qty 1; Cancel SKU A, Qty 1
13 Multiple Partial Cancellations
Cancel SKU A, Qty 1 Cancel SKU A, Qty 1 and SKU B, Qty 1 Cancel SKU B, Qty and SKU C, Qty 1
Legend
Columns: A(3), A(2)B(1) and A(1)B(1)C(1) represent orders that consist of different SKUs. Value in the brackets specifies product's quantity.
Please assume the following about these orders:
ChannelAdvisor Order ID ChannelAdvisor Item ID ChannelAdvisor Order Item ID
A(3) = 000 A = 123 A = 0123
A(2)B(1) = 111 B = 234 B = 0234
A(1)B(1)C(1) = 222 C = 345 C = 0345

Unit Price (Currency is Irrelevant) Order Level Delivery Cost (Currency is Irrelevant)
A=5 A = 2.99
B=7 B=4
C = 10 C = 10

+++ Marketplaces do not allow partial cancellations that retain shipping costs as required in these scenarios.
There are two ways to handle this:
1) Provide quantity on the cancellation request and ChannelAdvisor will complete the math to refund an appropriate part of item price, tax, shipping, and shipping tax on the order, ignoring any price-level data
sent.
2) Mark the 'cancelled' item as shipped, then complete a normal refund on the item, defining quantity and item price refund (including tax if needed), but do not adjust the shipping or shipping tax.
Note: some marketplaces do not allow partial price refunds.
These examples outline #2 as if the item had been shipped. If this same request is made pre-shipment, it ChannelAdvisor will handle it as #1.

Requirements
Delivery cost should be refunded back to customer only if all the orders' items have been cancelled and/or returned:
- Applicable scenarios: 3, 4, 12, 13
- There should be no partial delivery cost refund for any scenario.
Each cancellation/return should refund 100% of the items cost (including tax) back to customer.
Always provide a valid reason for cancellation - avoid using "GeneralAdjustment" where possible.
Always restock items upon cancellation or refund.

Example Format
Scenario: 1, Order A(3) SKU A (Qty: 3)
URL: /v1/Orders(000)/Ship
RequestBody:
{
"Value":
{
"TrackingNumber": "Any Tracking Number",
"DeliveryStatus": "Complete",
"ShippingCarrier": "A Shipping Carrier",
"ShippingClass": "A Shipping Class"
}
}
# Action A (3) A (2) B (1) A (1) B (1) C (1)
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Ship URL: /v1/Orders(111)/Ship URL: /v1/Orders(222)/Ship
Request Body: Request Body: Request Body:
{ { {
"Value":{ "Value":{ "Value":{
1 Full Order Shipment "TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"DeliveryStatus": "Complete", "DeliveryStatus": "Complete", "DeliveryStatus": "Complete",
"ShippingCarrier": "UPS", "ShippingCarrier": "UPS", "ShippingCarrier": "UPS",
"ShippingClass": "Ground" "ShippingClass": "Ground" "ShippingClass": "Ground"
} } }
} } }
Split Shipment - First Shipment - One A:
Verb: POST
URL: /v1/Orders(222)/Ship
Request Body:
{
"Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 1234",
Split Shipment - First Shipment - One A: "DeliveryStatus": "Complete",
Verb: POST "ShippingCarrier": "UPS",
Split Shipment - First Shipment - One A: URL: /v1/Orders(111)/Ship "ShippingClass": "Ground",
Verb: POST Request Body: "Items":[
URL: /v1/Orders(000)/Ship { {
Request Body: "Value":{ "Sku":"123",
{ "TrackingNumber": "1Z 999 AA1 01 2345 1234", "Quantity":1
"Value":{ "DeliveryStatus": "Complete", }]
"TrackingNumber": "1Z 999 AA1 01 2345 1234", "ShippingCarrier": "UPS", }
"DeliveryStatus": "Complete", "ShippingClass": "Ground", }
"ShippingCarrier": "UPS", "Items":[
"ShippingClass": "Ground", { Split Shipment - Second Shipment - One B:
"Items":[ "Sku":"123", Verb: POST
{ "Quantity":1 URL: /v1/Orders(222)/Ship
"Sku":"123", }] Request Body:
"Quantity":1 } {
}] } "Value":{
} "TrackingNumber": "1Z 999 AA1 01 2345 1235",
} Split Shipment - Second Shipment - One A & One B: "DeliveryStatus": "Complete",
2 Partial/Split Shipments Verb: POST "ShippingCarrier": "UPS",
Split Shipment - Second Shipment - Two A: URL: /v1/Orders(111)/Ship "ShippingClass": "Ground",
Verb: POST Request Body: "Items":[
URL: /v1/Orders(000)/Ship { {
Request Body: "Value":{ "Sku":"234",
{ "TrackingNumber": "1Z 999 AA1 01 2345 1235", "Quantity": 1
"Value":{ "DeliveryStatus": "Complete", }
"TrackingNumber": "1Z 999 AA1 01 2345 1235", "ShippingCarrier": "UPS", }
"DeliveryStatus": "Complete", "ShippingClass": "Ground", }
"ShippingCarrier": "UPS", "Items":[
"ShippingClass": "Ground", { Split Shipment - Second Shipment - One C:
"Items":[ "Sku":"123", Verb: POST
{ "Quantity": 1 URL: /v1/Orders(222)/Ship
"Sku":"123", }, Request Body:
"Quantity": 2 { {
}] "Sku":"234", "Value":{
} "Quantity": 1 "TrackingNumber": "1Z 999 AA1 01 2345 1236",
} }] "DeliveryStatus": "Complete",
} "ShippingCarrier": "UPS",
} "ShippingClass": "Ground",
"Items":[
{
"Sku":"345",
"Quantity": 1
}
}
}
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Adjust URL: /v1/Orders(111)/Adjust URL: /v1/Orders(222)/Adjust
Full Order Level Cancellation Request Body: Request Body: Request Body:
3 (Order Level) { { {
Used when Marketplace Allows Order Level "Reason": "BuyerCancelled", "Reason": "BuyerCancelled", "Reason": "BuyerCancelled",
"Restock":"True" "Restock":"True" "Restock":"True"
} } }

Verb: POST
Verb: POST URL: /v1/OrdersItems(0123)/Adjust
Verb: POST URL: /v1/OrdersItems(0123)/Adjust AND
URL: /v1/OrderItems(0123)/Adjust AND URL: /v1/OrdersItems(0234)/Adjust
Full Order Level Cancellation Request Body: URL: /v1/OrdersItems(0234)/Adjust AND
4 (Order Item Level) { Request Body (for Both Requests): URL: /v1/OrdersItems(0345)/Adjust
Used when Marketplace Doesn't Allow Order Level "Reason": "BuyerCancelled", { Request Body (for All Requests):
"Restock":"True" "Reason": "BuyerCancelled", {
} "Restock":"True" "Reason": "BuyerCancelled",
} "Restock":"True"
}
Full Ship: Full Ship: Full Ship:
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Ship URL: /v1/Orders(111)/Ship URL: /v1/Orders(222)/Ship
Request Body: Request Body: Request Body:
{ { {
"Value":{ "Value":{ "Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"DeliveryStatus": "Complete", "DeliveryStatus": "Complete", "DeliveryStatus": "Complete",
"ShippingCarrier": "UPS", "ShippingCarrier": "UPS", "ShippingCarrier": "UPS",
Full Shipment, "ShippingClass": "Ground" "ShippingClass": "Ground" "ShippingClass": "Ground"
5 Full Refund (Order Level) } } }
Used when Marketplace Allows Order Level } } }

Full Return (Will Refund Shipping Cost): Full Return (Will Refund Shipping Cost): Full Return (Will Refund Shipping Cost):
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Adjust URL: /v1/Orders(111)/Adjust URL: /v1/Orders(222)/Adjust
Request Body: Request Body: Request Body:
{ { {
"Reason": "BuyerReturnedItem", "Reason": "BuyerReturnedItem", "Reason": "BuyerReturnedItem",
"Restock":"True" "Restock":"True" "Restock":"True"
} } }
Full Ship:
Full Ship: Verb: POST
Full Ship: Verb: POST URL: /v1/Orders(222)/Ship
Verb: POST URL: /v1/Orders(111)/Ship Request Body:
URL: /v1/Orders(000)/Ship Request Body: {
Request Body: { "Value":{
{ "Value":{ "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"Value":{ "TrackingNumber": "1Z 999 AA1 01 2345 6784", "DeliveryStatus": "Complete",
"TrackingNumber": "1Z 999 AA1 01 2345 6784", "DeliveryStatus": "Complete", "ShippingCarrier": "UPS",
"DeliveryStatus": "Complete", "ShippingCarrier": "UPS", "ShippingClass": "Ground"
"ShippingCarrier": "UPS", "ShippingClass": "Ground" }
Full Shipment, "ShippingClass": "Ground" } }
6 Full Refund (Order Item Level) } }
Used when Marketplace Doesn't Allow Order Level } Full Return (Will Refund Shipping Cost):
Full Return (Will Refund Shipping Cost): Verb: POST
Full Return (Will Refund Shipping Cost): Verb: POST URL: /v1/OrderItems(0123)/Adjust
Verb: POST URL: /v1/OrderItems(0123)/Adjust AND
URL: /v1/OrderItems(0123)/Adjust AND URL: /v1/OrderItems(0234)/Adjust
Request Body: URL: /v1/OrderItems(0234)/Adjust AND
{ Request Body (for Both Requests): URL: /v1/OrderItems(0345)/Adjust
"Reason": "BuyerReturnedItem", { Request Body (for All Requests):
"Restock":"True" "Reason": "BuyerReturnedItem", {
} "Restock":"True" "Reason": "BuyerReturnedItem",
} "Restock":"True"
}
Full Ship: Full Ship: Full Ship:
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Ship URL: /v1/Orders(111)/Ship URL: /v1/Orders(222)/Ship
Request Body: Request Body: Request Body:
{ { {
"Value":{ "Value":{ "Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"DeliveryStatus": "Complete", "DeliveryStatus": "Complete", "DeliveryStatus": "Complete",
"ShippingCarrier": "UPS", "ShippingCarrier": "UPS", "ShippingCarrier": "UPS",
"ShippingClass": "Ground" "ShippingClass": "Ground" "ShippingClass": "Ground"
} } }
Full Shipment, } } }
7
Partial Refund
Partial Refund - One A (Does Not Refund Shipping): Partial Refund - One A (Does Not Refund Shipping): Partial Refund - One A (Does Not Refund Shipping):
Verb: POST Verb: POST Verb: POST
URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0123)/Adjust
Request Body: Request Body: Request Body:
{ { {
"Reason": "BuyerReturnedItem", "Reason": "BuyerReturnedItem", "Reason": "BuyerReturnedItem",
"Restock": "True", "Restock": "True", "Restock": "True",
"Quantity": 1, "Quantity": 1, "Quantity": 1,
"ItemAdjustment": 5, "ItemAdjustment": 7, "ItemAdjustment": 10,
"ShippingAdjustment": 0 "ShippingAdjustment": 0 "ShippingAdjustment": 0
} } }
Full Ship: Full Ship: Full Ship:
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Ship URL: /v1/Orders(111)/Ship URL: /v1/Orders(222)/Ship
Request Body: Request Body: Request Body:
{ { {
"Value":{ "Value":{ "Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"DeliveryStatus": "Complete", "DeliveryStatus": "Complete", "DeliveryStatus": "Complete",
"ShippingCarrier": "UPS", "ShippingCarrier": "UPS", "ShippingCarrier": "UPS",
"ShippingClass": "Ground" "ShippingClass": "Ground" "ShippingClass": "Ground"
} } }
} } }
Full Shipment,
8
Multiple Partial Refunds
Multiple Partial Refunds (Does Not Refund Shipping): Multiple Partial Refunds (Does Not Refund Shipping): Multiple Partial Refunds (Does Not Refund Shipping):
Verb: POST Verb: POST Verb: POST
URL (for Refund One A and Refund One A): /v1/OrderItems URL (Refund One A): /v1/OrderItems(0123)/Adjust URL (Refund One A): /v1/OrderItems(0123)/Adjust
(0123)/Adjust URL (Refund One B): /v1/OrderItems(0234)/Adjust URL (Refund One B): /v1/OrderItems(0234)/Adjust
Request Body (for Refund One A and Refund One A): Request Body (for Refund A and Refund B): Request Body (for Refund A and Refund B):
{ { {
"Reason": "BuyerReturnedItem", "Reason": "BuyerReturnedItem", "Reason": "BuyerReturnedItem",
"Restock": "True", "Restock": "True", "Restock": "True",
"Quantity": 1, "Quantity": 1, "Quantity": 1,
"ItemAdjustment": 5, "ItemAdjustment": 7, "ItemAdjustment": 10,
"ShippingAdjustment": 0 "ShippingAdjustment": 0 "ShippingAdjustment": 0
} } }
Full Ship: Full Ship: Full Ship:
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Ship URL: /v1/Orders(111)/Ship URL: /v1/Orders(222)/Ship
Request Body: Request Body: Request Body:
{ { {
"Value":{ "Value":{ "Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"DeliveryStatus": "Complete", "DeliveryStatus": "Complete", "DeliveryStatus": "Complete",
"ShippingCarrier": "UPS", "ShippingCarrier": "UPS", "ShippingCarrier": "UPS",
"ShippingClass": "Ground" "ShippingClass": "Ground" "ShippingClass": "Ground"
} } }
+++Partial Cancellation, } } }
9
Full Shipment
Cancel One A (Does Not Refund Shipping Costs): Cancel One A (Does Not Refund Shipping Costs): Cancel One B (Does Not Refund Shipping Costs):
Verb: POST Verb: POST Verb: POST
URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0234)/Adjust
Request Body: Request Body: Request Body:
{ { {
"Reason": "BuyerCancelled", "Reason": "BuyerCancelled", "Reason": "BuyerCancelled",
"Restock": "True", "Restock": "True", "Restock": "True",
"Quantity": 1, "Quantity": 1, "Quantity": 1,
"ItemAdjustment": 5, "ItemAdjustment": 7, "ItemAdjustment": 10,
"ShippingAdjustment": 0 "ShippingAdjustment": 0 "ShippingAdjustment": 0
} } }
STEP 1 - Ship All Items: STEP 1 - Ship All Items: STEP 1 - Ship All Items:
Verb: POST Verb: POST Verb: POST
URL: /v1/Orders(000)/Ship URL: /v1/Orders(111)/Ship URL: /v1/Orders(222)/Ship
Request Body: Request Body: Request Body:
{ { {
"Value":{ "Value":{ "Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"DeliveryStatus": "Complete", "DeliveryStatus": "Complete", "DeliveryStatus": "Complete",
"ShippingCarrier": "UPS", "ShippingCarrier": "UPS", "ShippingCarrier": "UPS",
"ShippingClass": "Ground" "ShippingClass": "Ground" "ShippingClass": "Ground"
} } }
} } }

STEP 2 - Cancel One A (Does Not Refund Shipping Costs): STEP 2 - Cancel One A (Does Not Refund Shipping Costs): STEP 2 - Cancel One A (Does Not Refund Shipping Costs):
Verb: POST Verb: POST Verb: POST
URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0123)/Adjust
Request Body: Request Body: Request Body:
+++Partial Cancellation,
{ { {
10 Partial Shipment,
"Reason": "BuyerCancelled", "Reason": "BuyerCancelled", "Reason": "BuyerCancelled",
Partial Refund
"Restock": "True", "Restock": "True", "Restock": "True",
"Quantity": 1, "Quantity": 1, "Quantity": 1,
"ItemAdjustment": 4, "ItemAdjustment": 7, "ItemAdjustment": 10,
"ShippingAdjustment": 0 "ShippingAdjustment": 0 "ShippingAdjustment": 0
} } }

STEP 3 - Refund One B (Does Not Refund Shipping Costs): STEP 3 - Refund One A (Does Not Refund Shipping Costs): STEP 3 - Refund One B (Does Not Refund Shipping Costs):
Verb: POST Verb: POST Verb: POST
URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0234)/Adjust
Request Body: Request Body: Request Body:
{ { {
"Reason": "CustomerReturnedItem", "Reason": "CustomerReturnedItem", "Reason": "CustomerReturnedItem",
"Restock": "True", "Restock": "True", "Restock": "True",
"Quantity": 1, "Quantity": 1, "Quantity": 1,
"ItemAdjustment": 4, "ItemAdjustment": 4, "ItemAdjustment": 4,
"ShippingAdjustment": 0 "ShippingAdjustment": 0 "ShippingAdjustment": 0
} } }
STEP 1 - Ship All Items: STEP 1 - Ship All Items:
STEP 1 - Ship All Items:
Verb: POST Verb: POST
Verb: POST
URL: /v1/Orders(111)/Ship URL: /v1/Orders(222)/Ship
URL: /v1/Orders(000)/Ship
Request Body: Request Body:
Request Body:
{ {
{
"Value":{ "Value":{
"Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784", "TrackingNumber": "1Z 999 AA1 01 2345 6784",
"TrackingNumber": "1Z 999 AA1 01 2345 6784",
"DeliveryStatus": "Complete", "DeliveryStatus": "Complete",
"DeliveryStatus": "Complete",
"ShippingCarrier": "UPS", "ShippingCarrier": "UPS",
"ShippingCarrier": "UPS",
"ShippingClass": "Ground" "ShippingClass": "Ground"
"ShippingClass": "Ground"
} }
}
} }
}
STEP 2 - Cancel One A (Sent as Partial Price Refund - Does STEP 2 - Cancel One A (Sent as Partial Price Refund - Does
STEP 2 - Cancel One A (Sent as Partial Price Refund - Does
Not Refund Shipping Cost): Not Refund Shipping Cost):
Not Refund Shipping Cost):
+++Partial Cancellation, Verb: POST Verb: POST
Verb: POST
Partial Shipment, URL: /v1/OrderItems(0123)/Adjust URL: /v1/OrderItems(0123)/Adjust
11 URL: /v1/OrderItems(0123)/Adjust
Full Refund (Order Level) Request Body: Request Body:
Request Body:
Used when Marketplace Allows Order Level { {
{
"Reason": "BuyerCancelled", "Reason": "BuyerCancelled",
"Reason": "BuyerCancelled",
"Restock": "True", "Restock": "True",
"Restock": "True",
"Quantity": 1, "Quantity": 1,
"Quantity": 1,
"ItemAdjustment": 7, "ItemAdjustment": 10,
"ItemAdjustment": 5
"ShippingAdjustment": 0 "ShippingAdjustment": 0
}
} }
STEP 3 - Full Return Remaining Items (Two A) (Refunds
STEP 3 - Full Return of Remaining Items (One A and One B) STEP 3 - Full Return of Remaining Items (One B and One C)
Shipping Costs):
(Refunds Shipping Costs): (Refunds Shipping Costs):
Verb: POST
Verb: POST Verb: POST
URL: /v1/Orders(000)/Adjust
URL: /v1/Orders(111)/Adjust URL: /v1/Orders(222)/Adjust
Request Body:
{ {
{
"Reason": "CustomerReturnedItem", "Reason": "CustomerReturnedItem",
"Reason": "CustomerReturnedItem"
"Restock":"True" "Restock":"True"
}
} }
STEP 1 - Ship All Items:
Verb: POST
URL: /v1/Orders(222)/Ship
STEP 1 - Ship All Items:
Request Body:
Verb: POST
{
URL: /v1/Orders(111)/Ship
"Value":{
Request Body:
"TrackingNumber": "1Z 999 AA1 01 2345 6784",
{
STEP 1 - Ship All Items: "DeliveryStatus": "Complete",
"Value":{
Verb: POST "ShippingCarrier": "UPS",
"TrackingNumber": "1Z 999 AA1 01 2345 6784",
URL: /v1/Orders(000)/Ship "ShippingClass": "Ground"
"DeliveryStatus": "Complete",
Request Body: }
"ShippingCarrier": "UPS",
{ }
"ShippingClass": "Ground"
"Value":{
}
"TrackingNumber": "1Z 999 AA1 01 2345 6784", STEP 2 - Cancel One A (Sent as Partial Price Refund - Does
}
"DeliveryStatus": "Complete", Not Refund Shipping Cost):
"ShippingCarrier": "UPS", Verb: POST
STEP 2 - Cancel One A (Sent as Partial Price Refund - Does
"ShippingClass": "Ground" URL: /v1/OrderItems(0123)/Adjust
Not Refund Shipping Cost):
} Request Body:
Verb: POST
} {
URL: /v1/OrderItems(0123)/Adjust
"Reason": "BuyerCancelled",
+++Partial Cancellation, Request Body:
STEP 2 - Cancel One A (Sent as Partial Price Refund - Does "Restock": "True",
Partial Shipment, {
Not Refund Shipping Cost): "Quantity": 1,
Full Refund (Order Item Level) "Reason": "BuyerCancelled",
Verb: POST "ItemAdjustment": 10,
12 Used when Marketplace Doesn't Allow Order Level "Restock": "True",
URL: /v1/OrderItems(0123)/Adjust "ShippingAdjustment": 0
OR "Quantity": 1,
Request Body: }
When Want to Retain Shipping Costs Until Last "ItemAdjustment": 7,
{
Refund Request is Made "ShippingAdjustment": 0
"Reason": "BuyerCancelled", STEP 3 - Full Return of One B and One C (Refunds Shipping
}
"Restock": "True", Costs):
"Quantity": 1, Verb: POST
STEP 3 - Full Return of One A and One B (Refunds Shipping
"ItemAdjustment": 5 URL (Return - One B): /v1/OrderItems(0234)/Adjust
Costs):
} {
Verb: POST
"Reason": "CustomerReturnedItem",
URL (Return - One A): /v1/OrderItems(0123)/Adjust
STEP 3 - Full Return Two A (Refunds Shipping Costs): "Restock":"True",
{
Verb: POST "Quantity": 1
"Reason": "CustomerReturnedItem",
URL: /v1/OrderItems(0123)/Adjust }
"Restock":"True",
Request Body: AND
"Quantity": 1
{ URL (Return - One C): /v1/OrderItems(0345)/Adjust
}
"Reason": "CustomerReturnedItem" {
AND
} "Reason": "CustomerReturnedItem"
URL (Return - One B): /v1/OrderItems(0234)/Adjust
"Restock":"True"
{
}
"Reason": "CustomerReturnedItem"
"Restock":"True"
STEP 4 - Refund of Shipping Cost from A:
}
Verb: POST
URL (Return): /v1/OrderItems(0123)/Adjust
STEP 1 - Ship All Items:
STEP 1 - Ship All Items:
Verb: POST
Verb: POST
URL: /v1/Orders(222)/Ship
URL: /v1/Orders(111)/Ship
Request Body:
Request Body:
{
{
"Value":{
"Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784",
"TrackingNumber": "1Z 999 AA1 01 2345 6784",
STEP 1 - Ship All Items: "DeliveryStatus": "Complete",
"DeliveryStatus": "Complete",
Verb: POST "ShippingCarrier": "UPS",
"ShippingCarrier": "UPS",
URL: /v1/Orders(000)/Ship "ShippingClass": "Ground"
"ShippingClass": "Ground"
Request Body: }
}
{ }
}
"Value":{
"TrackingNumber": "1Z 999 AA1 01 2345 6784", STEP 2 - Cancel One A (Sent as Partial Price Refund - Does
STEP 2 - Cancel One A (Sent as Partial Price Refund - Does
"DeliveryStatus": "Complete", Not Refund Shipping Cost):
Not Refund Shipping Cost):
"ShippingCarrier": "UPS", Verb: POST
Verb: POST
"ShippingClass": "Ground" URL: /v1/OrderItems(0123)/Adjust
URL: /v1/OrderItems(0123)/Adjust
} Request Body:
Request Body:
} {
{
"Reason": "BuyerCancelled",
"Reason": "BuyerCancelled",
STEP 2 - Cancel Two A and Cancel One A "Restock": "True",
"Restock": "True",
(Sent as Partial Price Refund - Does Not Refund Shipping "Quantity": 1,
"Quantity": 1,
Cost): "ItemAdjustment": 10,
"ItemAdjustment": 7,
13 +++Multiple Partial Cancellations Verb: POST "ShippingAdjustment": 0
"ShippingAdjustment": 0
URL (Cancel - Two A): /v1/OrderItems(0123)/Adjust }
}
Request Body:
{ STEP 3 - Cancel One A and Cancel One B
STEP 3 - Cancel One A and Cancel One B
"Reason": "BuyerCancelled", (Sent as Partial Price Refund - Does Not Refund Shipping
(Sent as Partial Price Refund - Does Not Refund Shipping
"Restock": "True", Cost):
Cost):
"Quantity": 2, Verb: POST
Verb: POST
"ItemAdjustment": 10, URL (Cancel One B): /v1/OrderItems(0234)/Adjust
URL (Cancel One A): /v1/OrderItems(0123)/Adjust
"ShippingAdjustment": 0 URL (Cancel One C): /v1/OrderItems(0345)/Adjust
Request Body:
} Request Body (for Both Requests):
{
AND {
"Reason": "BuyerCancelled",
URL (Cancel - One A): /v1/OrderItems(0123)/Adjust "Reason": "BuyerCancelled",
"Restock": "True",
Request Body: "Restock": "True",
"Quantity": 1,
{ "Quantity": 1,
"ItemAdjustment": 7,
"Reason": "BuyerCancelled" "ItemAdjustment": 10,
"ShippingAdjustment": 0
"Restock":"True" "ShippingAdjustment": 0
}
} }
AND
AND
URL (Cancel One B): /v1/OrderItems(0234)/Adjust
URL (Cancel One C): /v1/OrderItems(0345)/Adjust
Request Body:
Request Body:
{
{
"Reason": "BuyerCancelled"
"Reason": "BuyerCancelled"
"Restock":"True"
"Restock":"True"
}
}
Order Tax Types (Data Found in Order Retrieval)
NoTax No tax is included in item-level costs - see tax fields for separate tax costs
Standard No tax is included in item-level costs - see tax fields for separate tax costs
ExclusiveVat No tax is included in item-level costs - see tax fields for separate tax costs
Tax is included in the item's costs (Item and shipping taxes as noted). The Item
and Order Level Taxes (Item and Shipping Taxes) provided within the order are
InclusiveVat calculated by ChannelAdvisor and are for reference purposes only.

For Item Cancellations & Refunds:


ChannelAdvisor has no behavioral differences among NoTax, Standard, and ExclusiveVat.
Variances may exist among "OrderTaxType", "ShippingTaxType", and "GiftOptionsTaxType" across orders, but within an order, these values will not vary.
When an order has "InclusiveVat" tax for OrderTaxType and ShippingTaxType, the following fields are for informational purposes only:
TotalTaxPrice
TotalShippingTaxPrice
OrderItem / TaxPrice
OrderItem / ShippingTaxPrice
When making Item adjustments (refunds and adjustments), ensure item price and tax adjustments align with Order Tax Types from the original order.

Vous aimerez peut-être aussi