Webhook for Return Data (Returns V1)

Name

Type

Description

order_name

string

Shopify's order name

original_order_name

string

Return order’s original order name

order_id

string

Shopify's order ID

rma

string

SWAP's RMA number

date_created

date

Date the return was created

date_updated

date

Date the return was updated

type_string

string

A comma separated string containing the types of returns.

type

list of strings

An array listing the types of returns. Can be one of the following: Refund, Shop Now Credit, Shop Later Credit, Additional Payment, Recycle, Warranty

shipping_status

string

The shipping status. Possible values: Pre-Transit, In-Transit, Delivered

status

string

The status of the return. Possible values are: Open, Needs Review, Closed, Expired, On Hold, Cancelled

total

number

Total amount of the return

return_id

string

SWAP's internal return ID

store_id

string

SWAP's internal store ID

total_additional_payment

number

If there was an additional payment involved, this shows the total amount

total_refund_value_customer_currency

number

Total value of the refund value

store_name

string

The name of the store

customer_currency

string

The currency that the customer used to pay

customer_name

string

The name of the customer

customer_email

string

The email of the customer

screen_type

string

Can be "Desktop" or "Mobile"

customer_locale

string

The language locale used by the customer

shipping_carrier

string

The carrier in charge of the shipment

shopify_order_date

date

The date the order was created in Shopify

shipment_from_address_country

string

Country where the shipment is shipped from

shipment_from_address_city

string

City where the shipment is shipped from

shipment_from_address_parcel_weight

number

Weight of the parcel (in grams)

shipment_from_address_state

string

State where the shipment is shipped from

tags

string

Order tags

billing_address

object

Billing address information

processed_by

string

Name of the agent that processed the return

order_alt_type

string

Used to designate a different use case/type for a returnOrder outside of a normal return RMA (Recycle, refurbishment, etc.)

total_recycle_credit

number

Credit earned from recycling

num_recycled_products

number

Total number of the recycled products

total_weight_recycle_products

number

Total weight of the recycled products

quality_control_status

string

Pass if condition of all products is Sellable. Fail otherwise.

delivered_date

date

Date the return order was delivered.

date_closed

date

Date that the return was closed

tracking_number

string

The return's tracking number

products

list of products

The list of products whose "productActionType" equals to Return.

Name

Type

Description

name

string

Billing address full name

address1

string

Billing address line 1

address2

string

Billing address line 2

city

string

Billing address city

postcode

string

Billing address zip/postcode

state_province_code

string

Billing address state/province code

country_code

string

Billing address country code

Parameter

Type

Description

product_id

string

SWAP's internal product id

shopify_product_id

string

Shopify's Product ID

shopify_variant_id

string

Shopify's Variant ID

order_number

string

The return's order number

original_order_name

string

Return order’s original order name

date

date

Date the product was created

product_name

string

Name of the product

variant_name

string

Name of the variant

full_sku_description

string

Product + Variant name

sku

string

SKU

main_reason_id

string

ID of the main reason for the return

main_reason_text

string

Text of the main reason for the return

sub_reason_id

string

ID of the sub reason for the return

sub_reason_text

string

Text of the sub reason for the return

comments

string

Customer’s comments

item_count

number

Number of items

cost

number

Total cost

return_type

string

Return type. Can be one of the following: Refund, Shop Now Credit, Shop Later Credit, Additional Payment, Recycle, Warranty

currency

string

Currency used by the customer

vendor

string

Name of the vendor

collection

list of strings

List of names of the collections this product is part of

product_alt_type

string

Used to designate a different use case/type for a product outside of a normal return RMA (Recycle, refurbishment, etc.)

recycle_material

string

Used with the recycle feature. Collects the material type for the product being returned for recycling

grams

number

Product's weight, in grams

intake_reason

string

Dropdown options for each item on the returns dashboard. Used to keep a record of the condition of the item returned. Current values: Sellable, Damaged, Missing, Wrong Item

tags

string

Product tags