.. _returnsstartoct-label:

POST /v3/returns/otc/start/details
----------------------------------

**Description** - The Start OTC API serves the same purpose as the Generate Start OTC button on the FK Seller Hub. On hitting the API, the FEs who have reached the location, along with their Start OTCs, are returned in response.

**Purpose:** Generate One-time codes for FEs who have reached the seller location and are on the Start OTC page.

.. important::
   - OTCs are generated ONLY for FEs who have reached the seller location and are on the Start OTC page
   - Each OTC has an expiry time and must be used before expiration
   - If no FEs are on the Start OTC page, otcDetails will be empty

Request and Response Parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: toggle

    .. container:: header

        **☰ SHOW | HIDE**
    
    **URL:** ``https://api.flipkart.net/sellers/v3/returns/otc/start/details``

    **Request Header Parameters**

    +------------------+------------+------------+----------------------------------------+
    |Parameter         |Type        |Requirement | Description                            |
    +==================+============+============+========================================+
    |``Content-Type``  |String      |Mandatory   |Must be ``application/json``            |
    +------------------+------------+------------+----------------------------------------+
    |``Authorization`` |String      |Mandatory   |Bearer token for authentication         |
    +------------------+------------+------------+----------------------------------------+

    **Request Body Parameters**

    +----------------------+-------------+--------------+--------------------------------------+
    |Parameter             |Type         |Requirement   | Description                          |
    +======================+=============+==============+======================================+
    |``sellerLocationId``  |String       |Mandatory     |Seller location identifier            |
    +----------------------+-------------+--------------+--------------------------------------+
    |``taskType``          |String       |Mandatory     |Task type. Must be ``RETURN``         |
    +----------------------+-------------+--------------+--------------------------------------+

    **Sample Request**

    .. code-block:: json

        {
          "sellerLocationId": "LOC1",
          "taskType": "RETURN"
        }

    **Response Body Parameters (Success - 200 OK)**

    +---------------------------------------------+--------+---------------------------------------------+
    | Parameter/Attribute                         | Type   | Description                                 |
    +=============================================+========+=============================================+
    | ``otcDetails``                              | Object | OTC details for Field Executives            |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}``                       | Object | FE Identifier (key of the JSON Map),        |
    |                                             |        | like fe12303, fe45601                       |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}.feName``                | String | Field Executive name                        |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}.taskId``                | String | Task identifier                             |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}.otc``                   | String | One-time code                               |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}.expiryTime``            | Long   | OTC expiry timestamp (Epoch format in       |
    |                                             |        | milliseconds)                               |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}.createdAt``             | Long   | OTC creation timestamp (Epoch format in     |
    |                                             |        | milliseconds)                               |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}.logisticPartner``       | String | Logistics partner (e.g., eKart)             |
    +---------------------------------------------+--------+---------------------------------------------+
    | ``otcDetails.{feId}.lob``                   | String | Line of Business. Values: ``LARGE`` or      |
    |                                             |        | ``NONLARGE``                                |
    +---------------------------------------------+--------+---------------------------------------------+

    **Sample Response (Success - 200 OK)**

    .. code-block:: json

        {
          "otcDetails": {
            "fe12303": {
              "feName": "Ram",
              "taskId": "123",
              "otc": "123456",
              "expiryTime": 1739382981,
              "createdAt": 1739382981,
              "logisticPartner": "eKart",
              "lob": "LARGE | NONLARGE"
            },
            "fe45601": {
              "feName": "Shyam",
              "taskId": "456",
              "otc": "567890",
              "expiryTime": 1739382981,
              "createdAt": 1739382981,
              "logisticPartner": "eKart",
              "lob": "LARGE | NONLARGE"
            }
          }
        }

    **No OTC Generated Response (200 OK)**

    .. code-block:: json

        {
          "otcDetails": {}
        }

    **Possible Error Response Codes**

    =======================================        =========================
    Error Codes                                    Reason for Error
    =======================================        =========================
    ``TRIPSHEET_TASK_NOT_FOUND``                   No RETURN task found for seller
    ``INVALID_TASK_TYPE_ERROR``                    Task type is not Return
    ``TRIPSHEET_CLOSED_ERROR``                     Task is closed
    ``UNAUTHORIZED_ERROR``                         Authentication failed
    ``INTERNAL_SERVER_ERROR``                      Internal server error
    ``BAD_GATEWAY_ERROR``                          Bad gateway error
    ``SERVICE_UNAVAILABLE_ERROR``                  Service unavailable
    ``GATEWAY_TIMEOUT_ERROR``                      Gateway timeout
    =======================================        =========================

|

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|