# 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


## Orders

 - [GET /oms/v3/shipment](https://documentation.fynd.com/konnect/apis/konnect/orders/getorders.md): - 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.

## Shipment Info

 - [GET /oms/v3/shipment/info](https://documentation.fynd.com/konnect/apis/konnect/orders/getshipmentinfo.md): 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.

## Order Cancellation

 - [POST /oms/v3/shipment/cancel](https://documentation.fynd.com/konnect/apis/konnect/orders/cancelorder.md): 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

## Order Confirmation

 - [POST /oms/v3/shipment/confirm](https://documentation.fynd.com/konnect/apis/konnect/orders/confirmorder.md): 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

## Update Invoice

 - [POST /oms/v3/shipment/invoiceUpdate](https://documentation.fynd.com/konnect/apis/konnect/orders/updateinvoice.md): 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"

## Update AWB

 - [PUT /oms/v3/shipment/awb](https://documentation.fynd.com/konnect/apis/konnect/orders/updateawb.md): 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

## Order Pack

 - [POST /oms/v3/shipment/pack](https://documentation.fynd.com/konnect/apis/konnect/orders/packorder.md): Marks unfulfilled orders as packed, readying them for dispatch.
  > Limits update of 20 orders per request

## Courier Details

 - [POST /oms/v3/shipment/courierDetails](https://documentation.fynd.com/konnect/apis/konnect/orders/getcourierdetails.md): Retrieve courier information for specific orders.
  > Limits update of 20 orders per request

## Shipping Label

 - [POST /oms/v3/shipment/labels](https://documentation.fynd.com/konnect/apis/konnect/orders/getshippinglabel.md): 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

## Customer Invoice

 - [POST /oms/v3/shipment/invoice](https://documentation.fynd.com/konnect/apis/konnect/orders/fetchcustomerinvoice.md): Generate and retrieve a customer invoice (PDF) for orders ready for dispatch.
  > Limits update of 20 orders per request

## Order Dispatch

 - [POST /oms/v3/shipment/dispatch](https://documentation.fynd.com/konnect/apis/konnect/orders/dispatchorder.md): Mark the order(s) as dispatched; indicating it has  been handed over to the delivery partner.
  > Limits update of 20 orders per request

## Update Shipment Status

 - [PUT /oms/v3/shipment/status](https://documentation.fynd.com/konnect/apis/konnect/orders/updateshipmentstatus.md): 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

## Track Shipment

 - [POST /oms/v3/shipment/track](https://documentation.fynd.com/konnect/apis/konnect/orders/trackshipment.md): 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