Skip to content
/
Customer Invoice

Konnect API Reference

Fynd Konnect is a unified platform built to streamline e-commerce and omni-channel operations by connecting seller's downstream systems (OMS, WMS, ERP, & POS) with the the top marketplaces and webstores alongside Fynd Commerce

Fynd Konnect API Reference is a resource designed for quickly testing and exploring the functionality offered by Fynd Konnect. This reference provides:

  • Schema Definitions: Clear, concise data models for requests and responses to facilitate debugging and prototyping API integrations

  • Try It Console: Interactive testing directly from the documentation, enabling real-time experimentation with endpoints, response examination, and setup validation

  • Endpoint Overview: A structured catalog of Fynd Konnect APIs (Authorization, Catalog, Pricing, Inventory, Orders, Returns) for streamlined discovery and usage

Dive into how Fynd Konnect can support operational and technical needs in a sandboxed, experimentation-friendly environment

Download OpenAPI description
konnect.json
konnect.yaml
Overview
Fynd Support
help@fyndplatform.com
Terms of Service
Languages
Servers
Fynd Konnect [Sandbox]
https://fyndkonnect.konnect.uat.fyndx1.de/

Authorization

  • Provides endpoints for obtaining and managing authentication tokens Supports both Company-Level and Location-Level authorization modes, giving you fine-grained access control across multiple stores or warehouses
  • Integrate seamlessly with Fynd Konnect by exchanging your credentials for time-bound access tokens, ensuring secure interactions with all other APIs
Operations

Catalog

  • Unified suite of APIs to manage product catalogs on Fynd Commerce Platform

  • Retrieve core catalog entities (brands, categories, departments, templates) and reference metadata (attributes, HS codes, tax rules) needed for product creation

  • Create, update, and delete products in bulk with full validation support

  • Fetch product listings and counts with pagination and filtering options

  • Track processing status for write operations via Check Product Status

  • Ideal for product synchronization, bulk catalog management, and validating data consistency across systems

Operations

Pricing

  • Offers a way to set or update the MRP and ESP for your SKUs on a per-location basis, ensuring pricing uniformity across your internal systems and the Fynd platform
  • Supports high-volume updates (up to 500 records) in one call, streamlining real-time price adjustments for flash sales, promotions, or omni-channel pricing consistency
Operations

Inventory

  • Enables real-time stock-level management in the Fynd OMS. Update inventory quantities for each SKU across multiple locations, ensuring that Fynd accurately reflects item availability. Prevent overselling or stockouts by syncing frequently
  • Maximum 500 records can be updated in a single request
Operations

Orders

  • Covers the entire end-to-end lifecycle of orders on Fynd, from initial retrieval through packing, dispatching, and final delivery. Includes:

    • Fetching new or updated orders

    • Cancellation of orders or specific items before invoicing

    • Confirmation of orders in bulk

    • Invoicing or credit note generation

    • Make order pack and dispatch calls

    • AWB and courier updates for self-ship scenarios

    • Order status transitions for self-ship scenarios (bag_picked, delivery_done, etc.)

  • Maximum 20 records can be updated in a single request

Operations

Orders

Request

  • Retrieve orders filtered by Order Status, Ordering Channel, Date Range, or Location Code (when using company-level auth).

  • Useful to identify newly placed orders for fulfillment, manage different statuses in a consolidated environment, or Customer Returns by specifying orderStatus as RETURN_DELIVERED in parameters.

  • An Order can also be fetched by passing its shipment ID in parameters.

Security
ApiKeyAuth
Query
orderIdstring

Unique shipment identifier

If a particular order need to be fetched, none of the other parameters need to be filled; only the orderId is required

orderingChannelstring

Filter shipments by the sales channel (e.g., ECOMM, FYND)

orderStatusstringrequired

Filters orders by current status

To fetch Returns, use RETURN_DELIVERED

Enum"CREATED""CANCELLED""CONFIRMED""PROCESSING""COMPLETED""TRANSIT""HANDED_OVER_TO_CUSTOMER""DELIVERED""RETURN_PROCESSING""RETURN_DELIVERED"
pageNumberinteger

Page number for paginated results

pageSizeinteger

Number of results per page

locationCodestring

Store or warehouse location code

If Company-level auth is being used then locationCode field is mandatory

orderDateFromstring(date)

Filters orders from this date (dd-mm-yyyy)

orderDateTostring(date)

Filters orders up to this date (dd-mm-yyyy)

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment?orderId=string&orderingChannel=string&orderStatus=CREATED&pageNumber=0&pageSize=0&locationCode=string&orderDateFrom=2019-08-24&orderDateTo=2019-08-24' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Successful response

Bodyapplication/jsonArray [
idstring

Unique shipment identifier

forwardIdstring

Forward shipment ID (same as id for forward orders, a unique shipment id is created for returns and cancellations)

marketplaceOrderIdstring

Marketplace-specific order identifier

marketplaceReturnIdstring or null

Marketplace-specific return identifier (null for forward orders)

marketplaceInvoiceNumberstring or null

Marketplace-provided invoice number

shippingAddressobject

Customer's shipping address details

billingAddressobject

Customer's billing primary address

multiPackShipmentboolean

Indicates if the shipment contains multiple packages

packagesArray of objects

Package dimensions and weight information

fulfillmentTypestring

Fulfillment type

sellerInvoicedboolean

Indicates if the seller has generated an invoice

courierNamestring or null

Name of the assigned courier partner

courierCodestring or null

Courier partner code

awbNumberArray of strings

List of Air Waybill numbers for tracking

additionalInfostring

Additional information or notes about the order

orderPriceobject

Order pricing details

orderItemsArray of objects(OrderItem)

List of items in the order

orderStatusstring

Current status of the entire order (e.g., CREATED, CONFIRMED, PROCESSING, DELIVERED)

orderDatestring(date-time)

Timestamp when the order was placed

modifiedDatestring

Last status modified timestamp of the shipment

paymentTypestring

Payment method (e.g., COD, Prepaid)

taxExemptedboolean

Indicates if the shipment is tax-exempted

gstinstring or null

GST Identification Number (IRN) for B2B orders

packAfterDatestring or null

Date after which the order should be packed

packByDatestring or null

Date by which the order must be packed

pickUpSlotsArray of objects

Available pickup time slots

orderingChannelstring

Sales channel name for webstore or marketplace

labelPdfUrlstring or null

URL for the shipping label PDF (A4 size)

labelA6PdfUrlstring or null

URL for the shipping label PDF (A6 size)

purchaseOrderPdfUrlstring or null

URL for the purchase order PDF

invoiceNumberstring or null

Invoice number generated for the shipment either by Fynd or the Seller

returnInvoiceNumberstring or null

Credit note/return invoice number generated for the shipment either by Fynd or the Seller

irnNumberstring or null

Invoice Reference Number (IRN) for e-invoicing

invoiceQrCodestring or null

QR code data for the invoice

signedInvoicestring or null

Digitally signed invoice data

orderBusinessTypestring

Business type (e.g., B2C, B2B)

lockStatusboolean

Indicates if the order is locked for processing

fulfillmentPrioritystring or null

Priority level for order fulfillment

journeyTypestring

Order journey type (e.g., forward, return)

invoiceGenerationDatestring(date-time)

Timestamp when the invoice was generated

shipmentTagsArray of strings

Tags or labels associated with the shipment

slastring

Service Level Agreement - Order processing Turn Around Time (TAT)

cformProvidedboolean

Indicates if C-Form has been provided for inter-state sales

channel_bag_idstring

Channel-specific bag identifier

channel_shipment_idstring

Channel-specific shipment identifier

A4invoicePdfUrlstring or null

URL for the invoice PDF (A4 size)

A6invoicePdfUrlstring or null

URL for the invoice PDF (A6 size)

is_returnlessboolean

Indicates if the order is non-returnable

is_self_shipboolean

Indicates if this is a self-ship order (seller manages logistics)

]
Response
application/json
[
  {
    "id": "17614789115571370742",
    "forwardId": "17614789115571370742",
    "marketplaceOrderId": "FY68FE08FF517FA67468",
    "marketplaceReturnId": null,
    "marketplaceInvoiceNumber": null,
    "shippingAddress": { … },
    "billingAddress": { … },
    "multiPackShipment": false,
    "packages": [ … ],
    "fulfillmentType": "marketplaceFulfilled",
    "sellerInvoiced": false,
    "courierName": null,
    "courierCode": null,
    "awbNumber": [],
    "additionalInfo": "You can add additional info here",
    "orderPrice": { … },
    "orderItems": [ … ],
    "orderStatus": "CREATED",
    "orderDate": "2025-10-26T17:11:52+00:00",
    "modifiedDate": "2025-10-26T17:11:52",
    "paymentType": "COD",
    "taxExempted": false,
    "gstin": null,
    "packAfterDate": null,
    "packByDate": null,
    "pickUpSlots": [],
    "orderingChannel": "RTI Marketplaces",
    "labelPdfUrl": null,
    "labelA6PdfUrl": "https://storage.googleapis.com/fynd-staging-assets-private/x5/addsale/documents/label_a6/PDFs/17614789115571370742_label_a6.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=grindor-non-prod%40fynd-non-prod.iam.gserviceaccount.com%2F20251026%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20251026T114333Z&X-Goog-Expires=604800&X-Goog-SignedHeaders=host&X-Goog-Signature=32166aec0f791d1e012ba1293f3f323a31fe7ad2cb0e56641b6e2e6c0116850c6e58ac3570f83fed8822b403008e80329171c08634d72b5357b1a11a66a6ff8c9d01a03c114cbb20e95525545f475dffe45b01ca35ab2dc2a326f0473a8e286e3bb463cbbd314d3cd6037193c9e836df1a2c6f28ab9373a6d2fc5f6cc4aed4d5aba07d4c4b9da587dfc6e9b63dca47943023f410d0ee8fda3568d86cc903d6a20f45a6576418d2c8079fc68716652c37f0cd8f8edac8e5d90048560057a300519e7e527c1ba00977485e28657aaa48a21a5ac2919e478a84e100dddb13e4fe0d67f8858980526f589342ab0f007189b32c903a080210f807f19fcaf6a8824ea3",
    "purchaseOrderPdfUrl": null,
    "invoiceNumber": null,
    "returnInvoiceNumber": null,
    "irnNumber": null,
    "invoiceQrCode": null,
    "signedInvoice": null,
    "orderBusinessType": "B2C",
    "lockStatus": false,
    "fulfillmentPriority": null,
    "journeyType": "forward",
    "invoiceGenerationDate": "2025-10-26T17:11:52+00:00",
    "shipmentTags": [],
    "sla": "2025-10-28T11:00:00.000000+05:30",
    "cformProvided": false,
    "channel_bag_id": "3628064",
    "channel_shipment_id": "17614789115571370742",
    "A4invoicePdfUrl": null,
    "A6invoicePdfUrl": "https://storage.googleapis.com/fynd-staging-assets-private/x5/addsale/documents/invoice_a6/PDFs/17614789115571370742_invoice_a6.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=grindor-non-prod%40fynd-non-prod.iam.gserviceaccount.com%2F20251026%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20251026T114332Z&X-Goog-Expires=604800&X-Goog-SignedHeaders=host&X-Goog-Signature=0b9719f7d5cb0c83fbb0aef44e1a573317afcaebb4fb1646cb451b59e9b4174c26c4133c7c227cab7df23ad42b9a51bfbff52505ed25d30839ffa8e2f43c6bf04afa349d6cf1b3cebec87304cbe8fa77fae9a8077172e9f1c5bd0f761b045d755bc0b90a79d2d819f59ec3151b1f470b1bad3d874c9bb945e05278c6d2e6c57b404f5cadffdcb0245e419bbbd5115f1c4922d29794ef6425374c70c6463ee0b243ee76db410b700166185d15923ada6881633f862b3a91bc3d975f2a9aaf54e2d0348af605432255847073237f54725d1e0e01d724f180e3684a96af6a036e69b19358acc507c98b78b472267bff3419449c480c4d2398e047e8476421911c55",
    "is_returnless": false,
    "is_self_ship": false
  }
]

Shipment Info

Request

A lightweight API specifically designed to efficiently retrieve crucial order and lock information - such as order status, order type, SLA, and lock status - without the need to poll for the entire order payload. This endpoint is ideal for quick status checks.

Either orderId or orderStatus is mandatory in the request parameters.

Security
ApiKeyAuth
Query
orderIdstring

Unique shipment identifier

orderStatusstring

Filter by order status (e.g., CREATED, CONFIRMED, etc.)

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/info?orderId=string&orderStatus=string' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Responses

Successful response with order information

Bodyapplication/json
ordersArray of objects

Array of order information objects

Response
application/json
{
  "orders": [
    { … }
  ]
}

Order Cancellation

Request

Cancel entire orders or specific items before invoicing. Handles partial or full cancellations when the order is still in a pre-invoiced state.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Unique identifier for the shipment to be canceled. Can be found under id in order fetch payload

orderItemsArray of objectsrequired
orderItems[].​orderItemIdstringrequired

Unique identifier for the specific bag item(s)

orderItems[].​quantityintegerrequired

Quantity of this order item to be canceled

orderItems[].​reasonCodestring

Reason code explaining why the bag item(s) is being canceled

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

Responses

Order cancellation response

Bodyapplication/json
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

Response
application/json
{
  "payloadCount": 2,
  "successCount": 2,
  "failedCount": 0,
  "status": "SUCCESS",
  "errors": []
}

Order Confirmation

Request

This endpoint enables the finalization of the order after any required cancellations for subsequent packing, invoicing, and dispatch flows.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Unique identifier for the shipment being confirmed. Can be found under id in order fetch payload

orderItemsArray of objectsrequired

List of items to confirm within the order

orderItems[].​orderItemIdstringrequired

Unique identifier for the specific bag item(s)

orderItems[].​quantityintegerrequired

Quantity of this bag item to confirm

]
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
        }
      ]
    }
  ]'

Responses

Order confirmation response

Bodyapplication/json
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

Response
application/json
{
  "payloadCount": 2,
  "successCount": 2,
  "failedCount": 0,
  "status": "SUCCESS",
  "errors": []
}

Update Invoice

Request

Provide invoice details, overwrite packaging dimensions, or push IRN to Fynd Commerce for B2B invoicing using this endpoint.

Limits update of 20 orders per request

Note: To generate credit note for a customer return or an RTO, pass "invoiceType": "return"

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Shipment Id of the order to be invoiced

invoiceNumberstringrequired

Unique invoice reference number

invoiceTypestringrequired

Type of invoice (Either sale for the forward order invoice series or return for the customer return credit note)

invoiceQrCodestring

QR code data for the invoice

irnNumberstring

Invoice Reference Number for e-invoicing

signedInvoicestring

Digitally signed invoice data

ackNumberstring

Acknowledgment number from tax authority

ackDatestring

Date of acknowledgment receipt

orderItemsArray of objects

List of items included in the invoice

packagesArray of objects

Meta data for packaging if applicable; overwrites the existing package dimensions

]
curl -i -X POST \
  https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/invoiceUpdate \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "orderId": "string",
      "invoiceNumber": "string",
      "invoiceType": "string",
      "invoiceQrCode": "string",
      "irnNumber": "string",
      "signedInvoice": "string",
      "ackNumber": "string",
      "ackDate": "string",
      "orderItems": [
        {
          "orderItemId": "string",
          "quantity": 0,
          "imeiSerialNumber": [
            "string"
          ]
        }
      ],
      "packages": [
        {
          "packageId": "string",
          "packageLengthCm": 0,
          "packageWidthCm": 0,
          "packageHeightCm": 0,
          "packageWeightGms": 0
        }
      ]
    }
  ]'

Responses

Invoice update or credit note response

Bodyapplication/json
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

Response
application/json
{
  "payloadCount": 2,
  "successCount": 2,
  "failedCount": 0,
  "status": "SUCCESS",
  "errors": []
}

Update AWB

Request

Add Air Waybill number and courier name for self-ship orders once they have physically shipped from the seller's warehouse.

  • Order: Update when the order is in the dp_assigned state on Fynd.

    • Fetch such orders using the GET Orders endpoint with "orderStatus = PROCESSING")

  • Returns: Update in the return_dp_assigned state on Fynd.

    • Fetch such returns using the GET Orders endpoint with "orderStatus = RETURN_PROCESSING")

Note: Set autoDispatch = true for automatic state transition from dp_assigned to bag_picked on Fynd in one step.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
awbNumberstringrequired

Air Way Bill number for the shipment

courierNamestringrequired

Courier partner's name

orderIdstringrequired

Unique identifier of the order

autoDispatchbooleanrequired

When true, auto-transitions order from dp_assigned → bag_picked state on Fynd OMS

Enumfalsetrue
]
curl -i -X PUT \
  https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/awb \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "awbNumber": "string",
      "courierName": "string",
      "orderId": "string",
      "autoDispatch": false
    }
  ]'

Responses

Successful AWB update

Bodyapplication/json
dataobject

Response data regarding payload processing

metaobject

Metadata about the operation's result

Response
application/json
{
  "data": {
    "payload_count": 5,
    "success_count": 5,
    "failed_count": 0,
    "errors": []
  },
  "meta": {
    "trace_id": "766199ba-df9a-11ef-bc17-6b1b0369fe3a",
    "time": "2025-01-31T11:43:18.672+05:30",
    "status": "SUCCESS"
  }
}

Order Pack

Request

Marks unfulfilled orders as packed, readying them for dispatch.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Unique identifier for the shipment for which the order pack call needs to be pushed to Fynd. Can be found under id in order fetch payload

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

Responses

Order packing response

Bodyapplication/json
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

Response
application/json
{
  "payloadCount": 2,
  "successCount": 2,
  "failedCount": 0,
  "status": "SUCCESS",
  "errors": []
}

Courier Details

Request

Retrieve courier information for specific orders.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Unique identifier for the shipment for which the courier details need to be fetched. Can be found under id in order fetch payload

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

Responses

Courier details response

Bodyapplication/jsonArray [
courierNamestring

Name of the courier service provider

courierCodestring

Fynd unique code identifying the courier partner

awbNumberArray of strings

List of airway bill numbers for tracking

additionalInfostring

Any extra information about the shipment

orderIdstring

Shipment ID of the order for which the courier has been assigned

]
Response
application/json
[
  {
    "courierName": "FyndTest",
    "courierCode": "FyndTest",
    "awbNumber": [ … ],
    "additionalInfo": "You can add additional info here",
    "orderId": "17788083923861469968"
  },
  {
    "courierName": "FyndTest",
    "courierCode": "FyndTest",
    "awbNumber": [ … ],
    "additionalInfo": "You can add additional info here",
    "orderId": "17888083923861469000"
  }
]

Shipping Label

Request

Generate and retrieve shipping label PDFs for one or more orders. Requested post Pack stage to attach shipping labels to outgoing parcels.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Unique identifier for the shipment for which the shipping label need to be fetched. Can be found under id in order fetch payload

printSizestring

Optional parameter to specify the print size. Defaults to A4

Default "a4"
Enum"a4""a6""pos"
]
curl -i -X POST \
  https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/labels \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "orderId": "string",
      "printSize": "a4"
    }
  ]'

Responses

Returns shipping label PDF

Bodyapplication/pdf
string(pdf)
Response
application/pdf
As a response, the shipping label PDF will be the output.

Customer Invoice

Request

Generate and retrieve a customer invoice (PDF) for orders ready for dispatch.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Unique identifier for the shipment for which the invoice needs to be fetched from Fynd. Can be found under id in order fetch payload

printSizestring

Optional parameter to specify the print size. Defaults to A4

Default "a4"
Enum"a4""a6""pos"
]
curl -i -X POST \
  https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/invoice \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "orderId": "string",
      "printSize": "a4"
    }
  ]'

Responses

Returns a customer invoice PDF

Bodyapplication/pdf
string(binary)
Response
application/pdf
As a response, the customer invoice PDF will be the output.

Order Dispatch

Request

Mark the order(s) as dispatched; indicating it has been handed over to the delivery partner.

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Unique identifier for the shipment for which the order dispatch call needs to be pushed to Fynd. Can be found under id in order fetch payload

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

Responses

Order dispatch response

Bodyapplication/json
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

Response
application/json
{
  "payloadCount": 2,
  "successCount": 2,
  "failedCount": 0,
  "status": "SUCCESS",
  "errors": []
}

Update Shipment Status

Request

Enables the updating of shipment statuses for self-ship orders post-dispatch. Allowed order status flow on Fynd for self-ship orders/returns:

  • Forward flow: dp_assigned → bag_picked → out_for_delivery (optional) → delivery_attempt_failed (optional) → delivery_reattempt_requested (optional) → delivery_done

  • Return flow: return_dp_assigned → return_bag_in_transit → return_bag_delivered

  • RTO flow: dp_assigned → bag_picked → rto_bag_delivered

Limits update of 20 orders per request

Security
ApiKeyAuth
Bodyapplication/jsonrequiredArray [
orderIdstringrequired

Identifier of the order to update

orderStatusstringrequired

Next order status

Enum"bag_picked""bag_lost""out_for_delivery""delivery_attempt_failed""delivery_reattempt_requested""delivery_done""rto_bag_delivered""return_bag_in_transit""return_bag_delivered"
metaobject

Additional metadata for the update

]
curl -i -X PUT \
  https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/status \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "orderId": "string",
      "orderStatus": "bag_picked",
      "meta": {
        "remark": "string",
        "reasonCode": 0,
        "dpLocation": "string",
        "promised_delivery_date": "string",
        "estimated_delivery_date": "string"
      }
    }
  ]'

Responses

Successful shipment status update

Bodyapplication/json
dataobject

Response data regarding payload processing

metaobject

Metadata about the operation's result

Response
application/json
{
  "data": {
    "payload_count": 2,
    "success_count": 2,
    "failed_count": 0,
    "errors": []
  },
  "meta": {
    "trace_id": "db6dfa6b-df9a-11ef-bc17-2fcac2e9681c",
    "time": "2025-01-31T11:46:07.751+05:30",
    "status": "SUCCESS"
  }
}

Track Shipment

Request

Track the real-time status and location of shipments using either shipment ID or AWB number

Either shipment_id or awb_number is mandatory; if both are provided, shipment_id takes priority. Supports tracking for both forward and return journeys

Security
ApiKeyAuth
Bodyapplication/jsonrequired
shipment_idstring

Unique shipment identifier (forward or return)

awb_numberstring

Air Waybill number (forward or return)

curl -i -X POST \
  https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment/track \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '{
    "shipment_id": "string",
    "awb_number": "string"
  }'

Responses

Successful shipment tracking

Bodyapplication/json
statusstring

Response status

dataobject
Response
application/json
{
  "status": "success",
  "data": {
    "courier": "fynd-test",
    "current_status": "DL",
    "last_updated": "2025-10-31T13:55:59",
    "eta": null,
    "promised_delivery_date": "2025-11-02T10:00:00",
    "tracking_url": "https://www.fynd.com/",
    "location": "{\"coordinates\":{\"latitude\":19.0369701,\"longitude\":73.0136186}}",
    "shipment_id": "17618887002341430000",
    "awb_number": "FY12345",
    "operational_status": "delivery_done",
    "journey": "forward",
    "events": [ … ],
    "meta": { … }
  }
}

Returns

  • Manages the reverse and RTO (Return to Origin) journeys for your orders:

    • Fetch returns by using GET Orders endpoint with RETURN_DELIVERED as the order status
    • Quality Check acceptance after items are returned to the seller
    • Credit Note issuance for returns or RTO using the PUT Update Inventory endpoint with "invoiceType: return"

  • All reverse processes remain in sync with Fynd OMS

  • Maximum 20 records can be updated in a single request

Operations
© 2026 Shopsense Retail Technologies | MadeInIndia