Order Confirmation

The POST Order Confirmation API supports the bulk confirmation of orders, marking them as confirmed. If an order has been partially canceled by the customer, only the non-canceled items will be confirmed. Complete shipment confirmations will fail if the entire shipment is canceled by the customer.

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

Try out Fynd Konnect's Order Confirmation Endpoint

Common Request Header

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

Important Considerations

Supports bulk confirmation of upto 20 orders.
Confirms only non-canceled items in case of partial cancellation by customer.
Fails to confirm if the entire shipment is canceled by the customer.

Body

orderIdstringrequired

Unique identifier for the order being confirmed

orderItemsArray of objects

Success Response

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/confirm \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "orderId": "string",
      "orderItems": [
        {
          "orderItemId": "string",
          "quantity": 0
        }
      ]
    }
  ]'

Response

application/json

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

Error Codes

Reason	Code	Description
Canceled by customer/seller	O400	If `orderId` or `orderItemId` is canceled
Invalid orderId	O422	If `orderId` doesn't belong to the requested location

Next Steps

To invoice the order if auto-invoicing on Fynd Commerce is toggled off for the merchant, check out Update Invoice
For self-ship orders (where auto-invoicing is enabled on Fynd Commerce), to provide Fynd with the Air Waybill number for the order, see Update AWB
To pass a pack call to Fynd for channel shipping orders (where auto-invoicing and auto courier assignment are enabled on Fynd Commerce), head over to Order Pack