.. _cancel-label:

POST /orders/cancel
-------------------

**Description** - The Cancel Orders API enables the seller to cancel an order that may already have been approved by the Flipkart Marketplace.

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

.. container:: toggle

    .. container:: header

        **☰ SHOW | HIDE**

    **URL:** ``https://api.flipkart.net/sellers/v2/orders/cancel``

    **Request Body Parameters**

    +-----------------+----------+------------+-------------------------------------------+
    |Parameter        |Type      |Requirement | Description                               |
    +=================+==========+============+===========================================+
    |``orderItemId``  |Long      |Mandatory   |``orderItemId`` of the primary item        |
    |                 |          |            |cancelled                                  |
    +-----------------+----------+------------+-------------------------------------------+
    |``reason``       |String    |Optional    |Reason for cancellation. Permitted values: |
    |                 |          |            |``cannot_procure_item``,                   |
    |                 |          |            |``not_enough_inventory``, and ``b2b_order``|
    +-----------------+----------+------------+-------------------------------------------+

    **Validations** ::

        Maximum 100 orders per request.


    **Possible Response Error Codes**

        ==================================  ======================
        Error Code                          Reason for error
        ==================================  ======================
        ``DEPENDENT_SYSTEM_CALL_FAILED``    Error in cancelling the order.
        ``UNPROCESSABLE_ENTITY``            When invalid request is received.
        ==================================  ======================

|

`Try it out! <https://sandbox-api.flipkart.net/api-tools/#!/v2_orders/cancelOrders>`_
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|