Update Return and QC

The Update Return and QC API marks orders as RETURN_ACCEPTED and supports bulk return acceptance.

Request Type: POST
Scheme: HTTPS
Endpoint: https://{{host}}/oms/v3/shipment/return

Try out Fynd Konnect's Update Return and QC Endpoint

Common Request Header

Header	Mandatory	Description
`x-access-token`	Yes	Access token used for authenticating API requests to Fynd Konnect.

Important Considerations

Supports return accepted updates for up to 20 orders in a single API call.
For reconciliations or to record the final state of a return, accepted returns can be fetched using Fetch Returns with "orderStatus: RETURN_ACCEPTED"

Body

orderIdstringrequired

Unique identifier for the order that is to be accepted after a quality control check by the seller

orderItemsArray of objects

Success Resposne

payloadCountinteger

Number of payloads in the request

successCountinteger

Number of successfully processed payloads

failedCountinteger

Number of payloads that failed

statusstring

Status of the API call

errorsArray of objects

Empty if everything succeeded

API Call Example

curl -i -X POST \
  https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/return \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "orderId": "string",
      "orderItems": [
        {
          "orderItemId": "string",
          "quantity": 0,
          "reasonCode": "string"
        }
      ]
    }
  ]'

Response

application/json

{
  "payloadCount": 1,
  "successCount": 1,
  "failedCount": 0,
  "status": "SUCCESS",
  "errors": []
}

QC Code to Fynd Reason Code Mapping

An empty return reason code will be treated as 'GOOD Condition'

QC Code (Generic Qualifier)	Fynd Reason Code Slug
BAD	`tag_missing`
BAD	`package_damaged`
BAD	`refinish_damaged`
BAD	`refinish_for_pressing`
BAD	`seal_opened`
BAD	`wrong_product_received`
MISSING	`lost`
MISSING	`short_received`
MISSING	`empty_box_received`
MISSING	`free_gift_missing`
MISSING	`component_missing`
UGLY	`fully_damaged`
UGLY	`non_channel_products`
UGLY	`customer_abuse`