PUT
/
v1
/
warranty
curl --location --request PUT 'https://api.stateset.com/v1/warranty' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "user_group_id": "example_1",
    "name": "Example 1",
    "mapping": {"40": "213", "134": "386"},
    "properties": {"filterValue": "value"}
}'

{
    "warranties": [
        {
            "id": "0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
            "created_date": "2023-06-28T19:34:59.189838+00:00",
            "amount": null,
            "action_needed": null,
            "condition": null,
            "customerEmail": "customer@gmail.com",
            "customer_id": null,
            "description": null,
            "enteredBy": null,
            "flat_rate_shipping": null,
            "order_date": null,
            "order_id": "524213310335630636",
            "reason_category": null,
            "reported_condition": null,
            "requested_date": null,
            "rma": "#1014-R5",
            "serial_number": null,
            "shipped_date": null,
            "status": "RCV",
            "tax_refunded": null,
            "total_refunded": null,
            "tracking_number": null,
            "warranty_line_items": []
        },
    ]
}

​
Body

​
warranty_id
string
This is the id of the warranty.
​
warranty
object
The warranty object

​
Response

​
id
string
This is the id of the warranty.
​
action_needed
boolean
Indicates whether any action is needed for the warranty.
​
advanced_replacement
boolean
Indicates if advanced replacement is available for the warranty.
​
amount
decimal
The monetary amount associated with the warranty.
​
condition
string
Describes the condition of the item or situation.
​
condition_date
datetime
Date and time when the condition was recorded or observed.
​
country
string
Country associated with the warranty entry.
​
created_date
datetime
Date and time when the warranty entry was created.
​
customerEmail
string
Email address of the customer associated with the warranty.
​
customer_id
integer
Unique identifier for the customer associated with the warranty.
​
description
string
Brief description or additional details about the warranty.
​
enteredBy
string
Name or identifier of the person who entered the warranty.
​
issue
string
Issue or problem associated with the warranty.
​
match
boolean
Indicates whether the warranty matches the specified conditions.
​
order_date
datetime
Date and time when the order associated with the warranty was placed.
​
order_id
integer
Unique identifier for the order associated with the warranty.
​
reason_category
string
Category or reason associated with the warranty.
​
replacement_color
string
Color of the replacement item for the warranty.
​
model
string
Model of the replacement item for the warranty.
​
replacement_order_created
boolean
Indicates if a replacement order has been created for the warranty.
​
reported_condition
string
Condition as reported by the customer or user.
​
requested_date
datetime
Date and time when a specific request was made for the warranty.
​
rma
string
Return Merchandise Authorization (RMA) number for the warranty.
​
scanned_serial_number
string
Serial number obtained through scanning for the warranty.
​
serial_number
string
Unique serial number associated with the item in the warranty.
​
shipstation_order_id
string
ShipStation order ID associated with the warranty.
​
shipped_date
datetime
Date and time when the item was shipped or dispatched.
​
sso_id
string
Single Sign-On (SSO) ID associated with the warranty.
​
status
string
Current status or state of the warranty.
​
stripe_invoice_id
string
Stripe invoice ID associated with the warranty.
​
tax_refunded
decimal
The amount of tax refunded for the warranty.
​
total_refunded
decimal
The total amount refunded for the warranty.
​
tracking_number
string
Tracking number associated with the shipment for the warranty.
​
warehouse_received_date
datetime
Date and time when the item was received in the warehouse.
​
warranty_line_items
object
This is an array of warranty line items.
curl --location --request PUT 'https://api.stateset.com/v1/warranty' \
--header 'Content-Type: application/json' \
--header 'Authorization: Token <token>' \
--data-raw '{
    "user_group_id": "example_1",
    "name": "Example 1",
    "mapping": {"40": "213", "134": "386"},
    "properties": {"filterValue": "value"}
}'

{
    "warranties": [
        {
            "id": "0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
            "created_date": "2023-06-28T19:34:59.189838+00:00",
            "amount": null,
            "action_needed": null,
            "condition": null,
            "customerEmail": "customer@gmail.com",
            "customer_id": null,
            "description": null,
            "enteredBy": null,
            "flat_rate_shipping": null,
            "order_date": null,
            "order_id": "524213310335630636",
            "reason_category": null,
            "reported_condition": null,
            "requested_date": null,
            "rma": "#1014-R5",
            "serial_number": null,
            "shipped_date": null,
            "status": "RCV",
            "tax_refunded": null,
            "total_refunded": null,
            "tracking_number": null,
            "warranty_line_items": []
        },
    ]
}