POST api/v2/rmas

Submit a ReturnTrak type RMA.

Request Information

URI Parameters

None.

Body Parameters

rma
NameDescriptionTypeAdditional information
rma_number

Only letters, digits or '-' sign are allowed. It could be auto-generated, depends on the account settings.

string

Max length: 25

rma_date

RMA date. Date in ISO-8601 format. Only date part (no time).

date

None.

original_order_number

Only letters, digits or '-' sign are allowed.

string

Max length: 25

shipping_carrier

Shipping carrier name (example: 'UPS').

string

Max length: 30

shipping_service

Shipping service name (example: 'GROUND').

string

Max length: 30

customer_number

You can store your customer id for reference. Also, highly recommended for B2B account.

string

Max length: 25

comments

It will appear on the packing list.

string

Max length: 255

shipping_instructions

RMA comments.

string

Max length: 255

shipping_address

Shipping address.

address

Required

order_amount

decimal number

None.

shipping_handling

decimal number

None.

sales_tax

decimal number

None.

restocking_fee

decimal number

None.

total_amount

decimal number

None.

rma_type

Type of ReturnTrak RMA to submit.

rma_type

Required

disposition

RMA disposition.

disposition

Required

custom_option1

Must match with the input data defined in ReturnTrak. Required only if is required in ReturnTrak.

string

None.

custom_option2

Must match with the input data defined in ReturnTrak. Required only if is required in ReturnTrak.

string

None.

custom_option3

Must match with the input data defined in ReturnTrak. Required only if is required in ReturnTrak.

string

None.

custom_option4

Must match with the input data defined in ReturnTrak. Required only if is required in ReturnTrak.

string

None.

custom_option5

Must match with the input data defined in ReturnTrak. Required only if is required in ReturnTrak.

string

None.

custom_option6

Must match with the input data defined in ReturnTrak. Required only if is required in ReturnTrak.

string

None.

custom_option7

Must match with the input data defined in ReturnTrak. Required only if is required in ReturnTrak.

string

None.

generate_return_service_label

Generate a return service label.

boolean

Default value is false

return_weight_lb

Weight, in pounds, of the returned items (required if a return service label is needed).

decimal number

None.

rma_location

RMA location.

string

Required

rma_account_number

RMA account number.

string

Required

shipping_location

Shipping location.

string

None.

shipping_account_number

Shipping account number.

string

None.

auth_lines

Collection of auth_line

Required

ship_lines

Collection of ship_line

None.

Request Formats

application/json, text/json

Sample:
{
  "rma_number": "RMADEM001",
  "rma_date": "2017-07-21",
  "original_order_number": "",
  "shipping_carrier": "UPS",
  "shipping_service": "GROUND",
  "customer_number": "",
  "comments": "",
  "shipping_instructions": "",
  "shipping_address": {
    "company": "DCL Corp",
    "attention": "Walter P",
    "address1": "48641 Milmont dr",
    "address2": "",
    "email": "",
    "phone": "",
    "city": "Fremont",
    "state_province": "CA",
    "postal_code": "94538",
    "country_code": "US"
  },
  "order_amount": 0.00,
  "shipping_handling": 0.00,
  "sales_tax": 0.00,
  "restocking_fee": 0.00,
  "total_amount": 0.00,
  "rma_type": 1,
  "disposition": 1,
  "custom_option1": "Best Buy",
  "generate_return_service_label": true,
  "return_weight_lb": 2.50,
  "rma_location": "FR",
  "rma_account_number": "10501",
  "shipping_location": "LA",
  "shipping_account_number": "10501",
  "auth_lines": [
    {
      "item_number": "1001-001-DEMO",
      "description": "Product For Demo",
      "quantity": 1,
      "serial_number": "ABC123"
    }
  ],
  "ship_lines": [
    {
      "item_number": "1002-002-DEMO2",
      "description": "Product For Demo 2",
      "quantity": 5,
      "price": 0.00
    },
    {
      "item_number": "1005-005-DEMO5",
      "description": "Product For Demo 5",
      "quantity": 3,
      "price": 14.99
    }
  ]
}

Response Information

Resource Description

response_post_rmas
NameDescriptionTypeAdditional information
error_code

Zero if no errors. When different from zero, the rma is rejected. See 'error_message' for a detailed description of the error.

integer

None.

error_message

Returns a detailed description of the error.

string

None.

rma_number

RMA number generated.

string

None.

return_label_url

Return label URL.

string

None.

return_label_tracking_number

Return label tracking number.

string

None.

Response Formats

application/json, text/json

Sample:
{
  "error_code": 0,
  "error_message": "",
  "rma_number": "RMADEM001",
  "return_label_url": "https://wwwcie.ups.com/u.a/L.class?8RnCteVzjRbtwWbAMNdJd8frHHmrrtMHdLP0Sp",  
  "return_label_tracking_number": "1Z05R2W19091897311"
}