Inventory

Konnect API reference (1.0.0)

Welcome to the Fynd Konnect API Reference, 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

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

Download OpenAPI description
konnect.json
konnect.yaml
Languages
Servers
Fynd Konnect [Sandbox]
https://fyndkonnect.konnect.uat.fyndx1.de/
Ginesys <> Konnect [Sandbox]
https://ginesys.konnect.uat.fyndx1.de/
Unicommerce <> Konnect [Sandbox]
https://unicommerce.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

  • Lets a partner maintain and retrieve detailed product listings in the Fynd OMS Includes endpoints to fetch the total SKU count and specific product listings with pagination or SKU filters

  • Ideal for validating data synchronization, bulk updates, or verifying new product onboarding

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

Update Inventory

Request

Increase or decrease stock levels for each SKU at a specific location. It enables near real-time synchronization and can help prevent overselling scenarios.

This API supports up to 500 record updates per request.

Bodyapplication/jsonrequiredArray [
location_idstringrequired

Store code or location identifier

skustringrequired

Store Identifier of the product

quantityintegerrequired

Quantity of the SKU in that location

]
curl -i -X PUT \
  https://fyndkonnect.konnect.uat.fyndx1.de/ims/v3/inventory \
  -H 'Content-Type: application/json' \
  -H 'x-access-token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "location_id": "string",
      "sku": "string",
      "quantity": 0
    }
  ]'

Responses

Successful (or partial) inventory 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": {
    "ack_id": "679c7a1e733b526d91f9a1b8",
    "integrationId": "64b8e312269b5327f0affee7",
    "time": "2025-01-31T06:58:37.608+00:00",
    "status": "SUCCESS"
  }
}

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

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
© 2025 Shopsense Retail Technologies | MadeInIndia