Update Warranty

This endpoint updates an existing warranty.

PUT /v1/warranty

cURL

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

   mutation UpdateWarranty(
     $ticket_id: String
     $warranty: warranties_set_input!
   ) {
     update_warranties (
     where: { id : { _eq: $ticket_id }}
     _set: $warranty
     ) {
       returning {
        id
        order_id
        serial_number
        customer_id
        description
        status
        tracking_number
        zendesk_number
        action_needed
        issue
        shipped_date
        requested_date
        enteredBy
        customerEmail
        rma
        country
       }
     }
    };

const warranties = await stateset.warranties.update({
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
});

warranties = stateset.Warranty.modify(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
)

warranties = Stateset::Warranties.update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
)

warranties, err := stateset.Warranties.Update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
)

Warranties warranties = stateset.warranties.update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
);

$warranties = $stateset->warranties->update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
);

Response

{
  "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": "[e-mail]",
      "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.

Show Show child attributes

amount · decimal

The monetary amount associated with the warranty line item.

condition · string

Describes the condition of the replaced item.

flat_rate_shipping · boolean

Indicates whether the shipping rate is a flat rate.

id · integer

Unique identifier for the warranty line item.

name · string

Name or description of the warranty line item.

price · decimal

The price of the warranty line item.

warranty_id · integer

Unique identifier for the warranty associated with the line item.

serial_number · string

Unique serial number associated with the warranty item.

sales_order_sku · string

Stock Keeping Unit (SKU) of the replaced item.

cURL

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

   mutation UpdateWarranty(
     $ticket_id: String
     $warranty: warranties_set_input!
   ) {
     update_warranties (
     where: { id : { _eq: $ticket_id }}
     _set: $warranty
     ) {
       returning {
        id
        order_id
        serial_number
        customer_id
        description
        status
        tracking_number
        zendesk_number
        action_needed
        issue
        shipped_date
        requested_date
        enteredBy
        customerEmail
        rma
        country
       }
     }
    };

const warranties = await stateset.warranties.update({
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
});

warranties = stateset.Warranty.modify(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
)

warranties = Stateset::Warranties.update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
)

warranties, err := stateset.Warranties.Update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
)

Warranties warranties = stateset.warranties.update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
);

$warranties = $stateset->warranties->update(
  '0901f083-aa1c-43c5-af5c-0a9d2fc64e30'
);

Response

{
  "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": "[e-mail]",
      "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": []
    }
  ]
}