Zoho Inventory salesorders API

SalesOrders Module

Operations 15

POST /salesorders Create a Sales Order #
GET /salesorders List all Sales Orders #
DELETE /salesorders Bulk delete Sales Orders #
GET /salesorders/{salesorder_id} Retrieve a Sales Order #
PUT /salesorders/{salesorder_id} Update a Sales Order #
DELETE /salesorders/{salesorder_id} Delete a Sales Order #
POST /salesorders/{salesorder_id}/status/confirmed Mark as Confirmed #
POST /salesorders/{salesorder_id}/status/void Mark as Void #
POST /salesorders/status/confirmed Bulk confirm Sales Orders #
POST /salesorders/{salesorder_id}/submit Submit a sales order for approval #
POST /salesorders/{salesorder_id}/approve Approve a sales order #
POST /salesorders/{salesorder_id}/approve/final Final approval of a sales order #
POST /salesorders/{salesorder_id}/reject Reject a sales order #
POST /salesorders/submit Bulk submit sales orders for approval #
POST /salesorders/approve Bulk approve sales orders #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/zoho-inventory-salesorders-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zoho-inventory-salesorders-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: batches Salesorders API
  description: Batches help you track inventory items by batch numbers, manufacturing dates, and expiration dates.
  contact: {}
  version: 1.0.0
servers:
- url: https://www.zohoapis.com/inventory/v1
  description: API Endpoint
tags:
- name: salesorders
  description: SalesOrders Module
paths:
  /salesorders:
    x-mcp-group:
    - Sales Orders
    parameters:
    - $ref: '#/components/parameters/organization_id'
    post:
      tags:
      - salesorders
      operationId: create_sales_order
      summary: Create a Sales Order
      description: Creates a new Sales Order in Zoho Inventory. Description about extra parameter ignore_auto_number_generation - Ignore auto sales order number generation for this sales order. This mandates the Sales Order number to be entered. Allowed Values <code>true</code> and <code>false</code>.
      parameters:
      - name: ignore_auto_number_generation
        in: query
        description: Ignore auto sales order number generation for this sales order. This mandates the sales order number. Allowed values are <code> true </code> , <code> false </code>.
        required: false
        schema:
          type: boolean
        example: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/create-a-sales-order-request'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/create-a-sales-order-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.CREATE
    get:
      tags:
      - salesorders
      operationId: list_sales_orders
      summary: List all Sales Orders
      description: Lists all the available Sales Orders in Zoho Inventory.
      parameters:
      - name: page
        in: query
        description: Page number to be fetched. Default value is 1.
        required: false
        schema:
          type: integer
          default: 1
        example: 1
      - name: per_page
        in: query
        description: Number of records to be fetched per page. Default value is 200.
        required: false
        schema:
          type: integer
          default: 200
        example: 200
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/list-all-sales-orders-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.READ
    delete:
      tags:
      - salesorders
      operationId: bulk_delete_sales_orders
      summary: Bulk delete Sales Orders
      description: Bulk delete the selected Sales Orders.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bulk-delete-sales-orders-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.DELETE
  /salesorders/{salesorder_id}:
    x-mcp-group:
    - Sales Orders
    parameters:
    - name: salesorder_id
      in: path
      required: true
      description: Unique identifier of the sales order.
      schema:
        type: string
      example: 4815000000044895
    - $ref: '#/components/parameters/organization_id'
    get:
      tags:
      - salesorders
      operationId: get_sales_order
      summary: Retrieve a Sales Order
      description: Retrieves the details for an existing Sales Order.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/retrieve-a-sales-order-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.READ
    put:
      tags:
      - salesorders
      operationId: update_sales_order
      summary: Update a Sales Order
      description: Updates a new Sales Order in Zoho Inventory. Description about extra parameter ignore_auto_number_generation - Ignore auto sales order number generation for this sales order. This mandates the Sales Order number to be entered. Allowed Values <code>true</code> and <code>false</code>.
      parameters:
      - name: ignore_auto_number_generation
        in: query
        description: Ignore auto sales order number generation for this sales order. This mandates the sales order number. Allowed values are <code> true </code> , <code> false </code>.
        required: false
        schema:
          type: boolean
        example: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/update-a-sales-order-request'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/update-a-sales-order-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.UPDATE
    delete:
      tags:
      - salesorders
      operationId: delete_sales_order
      summary: Delete a Sales Order
      description: Deletes an existing Sales Order from Zoho Inventory.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/delete-a-sales-order-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.DELETE
  /salesorders/{salesorder_id}/status/confirmed:
    x-mcp-group:
    - Sales Orders
    parameters:
    - name: salesorder_id
      in: path
      required: true
      description: Unique identifier of the sales order.
      schema:
        type: string
      example: 4815000000044895
    - $ref: '#/components/parameters/organization_id'
    post:
      tags:
      - salesorders
      operationId: mark_sales_order_as_confirmed
      summary: Mark as Confirmed
      description: Changes the status of a Sales Order to Confirmed.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mark-as-confirmed-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.CREATE
  /salesorders/{salesorder_id}/status/void:
    x-mcp-group:
    - Sales Orders
    parameters:
    - name: salesorder_id
      in: path
      required: true
      description: Unique identifier of the sales order.
      schema:
        type: string
      example: 4815000000044895
    - $ref: '#/components/parameters/organization_id'
    post:
      tags:
      - salesorders
      operationId: mark_sales_order_as_void
      summary: Mark as Void
      description: Changes the status of a Sales Order to Void.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mark-as-void-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.CREATE
  /salesorders/status/confirmed:
    x-mcp-group:
    - Sales Orders
    post:
      tags:
      - salesorders
      operationId: bulk_confirm_sales_orders
      summary: Bulk confirm Sales Orders
      description: Mark existing Sales Orders as confirmed in Zoho Inventory
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bulk-confirm-salesorders-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.CREATE
      parameters:
      - name: salesorder_ids
        in: query
        description: <code>List of sales order ids separated by comma</code>
        required: true
        schema:
          type: string
        example: 4815000000045208,4815000000045274,4815000000045340
      - $ref: '#/components/parameters/organization_id'
  /salesorders/{salesorder_id}/submit:
    x-mcp-group:
    - Sales Orders
    post:
      tags:
      - salesorders
      operationId: submit_salesorder
      summary: Submit a sales order for approval
      description: Submit a sales order for approval workflow.
      parameters:
      - name: salesorder_id
        in: path
        description: Unique ID of the sales order.
        required: true
        schema:
          type: string
        example: '4815000000045208'
      - $ref: '#/components/parameters/organization_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/approval-action-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.UPDATE
  /salesorders/{salesorder_id}/approve:
    x-mcp-group:
    - Sales Orders
    post:
      tags:
      - salesorders
      operationId: approve_salesorder
      summary: Approve a sales order
      description: Approve a submitted sales order.
      parameters:
      - name: salesorder_id
        in: path
        description: Unique ID of the sales order.
        required: true
        schema:
          type: string
        example: '4815000000045208'
      - $ref: '#/components/parameters/organization_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/approval-action-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.UPDATE
  /salesorders/{salesorder_id}/approve/final:
    x-mcp-group:
    - Sales Orders
    post:
      tags:
      - salesorders
      operationId: approve_salesorder_final
      summary: Final approval of a sales order
      description: Perform the final approval of a sales order (admin only).
      parameters:
      - name: salesorder_id
        in: path
        description: Unique ID of the sales order.
        required: true
        schema:
          type: string
        example: '4815000000045208'
      - $ref: '#/components/parameters/organization_id'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/approval-action-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.UPDATE
  /salesorders/{salesorder_id}/reject:
    x-mcp-group:
    - Sales Orders
    post:
      tags:
      - salesorders
      operationId: reject_salesorder
      summary: Reject a sales order
      description: Reject a submitted sales order.
      parameters:
      - name: salesorder_id
        in: path
        description: Unique ID of the sales order.
        required: true
        schema:
          type: string
        example: '4815000000045208'
      - $ref: '#/components/parameters/organization_id'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/reject-request'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/approval-action-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.UPDATE
  /salesorders/submit:
    x-mcp-group:
    - Sales Orders
    post:
      tags:
      - salesorders
      operationId: bulk_submit_salesorders
      summary: Bulk submit sales orders for approval
      description: Submit multiple sales orders for approval workflow at once.
      parameters:
      - $ref: '#/components/parameters/organization_id'
      - name: salesorder_ids
        in: query
        description: Comma-separated list of sales order IDs to submit for approval.
        required: true
        schema:
          type: string
        example: 4815000000045208,4815000000045274
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/approval-action-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.UPDATE
  /salesorders/approve:
    x-mcp-group:
    - Sales Orders
    post:
      tags:
      - salesorders
      operationId: bulk_approve_salesorders
      summary: Bulk approve sales orders
      description: Approve multiple submitted sales orders at once.
      parameters:
      - $ref: '#/components/parameters/organization_id'
      - name: salesorder_ids
        in: query
        description: Comma-separated list of sales order IDs to approve.
        required: true
        schema:
          type: string
        example: 4815000000045208,4815000000045274
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/approval-action-response'
      deprecated: false
      security:
      - Zoho_Auth:
        - ZohoInventory.salesorders.UPDATE
components:
  schemas:
    create-a-sales-order-response:
      type: object
      properties:
        code:
          type: integer
          example: 0
          readOnly: true
        message:
          type: string
          example: success
          readOnly: true
        sales_order:
          $ref: '#/components/schemas/sales_order-response'
    contact_person_name:
      description: Name of the Contact Person
      type: string
      example: David
    is_discount_before_tax:
      description: Used to check whether the discount is applied before tax or after tax.
      type: boolean
      example: true
    shipment_date:
      description: Shipment date of the Sales Order.
      type: string
      example: '2015-06-02'
    create-a-sales-order-request:
      required:
      - salesorder_number
      - customer_id
      - line_items
      type: object
      properties:
        customer_id:
          $ref: '#/components/schemas/customer_id'
        salesorder_number:
          $ref: '#/components/schemas/salesorder_number'
        date:
          $ref: '#/components/schemas/date'
        shipment_date:
          $ref: '#/components/schemas/shipment_date'
        custom_fields:
          $ref: '#/components/schemas/custom_fields'
        reference_number:
          $ref: '#/components/schemas/reference_number'
        location_id:
          $ref: '#/components/schemas/location_id'
        line_items:
          description: A sales order can contain multiple line items. Each line item contains <code>item_id</code>,<code>name</code>,<code>description</code>,<code>rate</code>,<code>quantity</code>,<code>unit</code>,<code>tax_id</code>,<code>tax_name</code>,<code>tax_type</code>,<code>tax_percentage</code>,<code>item_total</code>.
          type: array
          items:
            type: object
            properties:
              item_id:
                $ref: '#/components/schemas/item_id'
              name:
                $ref: '#/components/schemas/name'
              description:
                $ref: '#/components/schemas/description'
              rate:
                $ref: '#/components/schemas/rate'
              quantity:
                $ref: '#/components/schemas/quantity'
              unit:
                $ref: '#/components/schemas/unit'
              tax_id:
                $ref: '#/components/schemas/tax_id'
              tds_tax_id:
                $ref: '#/components/schemas/tds_tax_id'
              tax_name:
                $ref: '#/components/schemas/tax_name'
              tax_type:
                $ref: '#/components/schemas/tax_type'
              tax_percentage:
                $ref: '#/components/schemas/tax_percentage'
              item_total:
                $ref: '#/components/schemas/item_total'
              mapped_items:
                $ref: '#/components/schemas/mapped_items_create'
              location_id:
                $ref: '#/components/schemas/location_id'
              hsn_or_sac:
                $ref: '#/components/schemas/hsn_or_sac'
              sat_item_key_code:
                $ref: '#/components/schemas/sat_item_key_code'
              unitkey_code:
                $ref: '#/components/schemas/unitkey_code'
              item_custom_fields:
                $ref: '#/components/schemas/item_custom_fields'
        contact_persons_associated:
          $ref: '#/components/schemas/contact_persons_associated_payload'
        notes:
          $ref: '#/components/schemas/notes'
        terms:
          $ref: '#/components/schemas/terms'
        discount:
          $ref: '#/components/schemas/discount'
        is_discount_before_tax:
          $ref: '#/components/schemas/is_discount_before_tax'
        discount_type:
          $ref: '#/components/schemas/discount_type'
        shipping_charge:
          $ref: '#/components/schemas/shipping_charge'
        delivery_method:
          $ref: '#/components/schemas/delivery_method'
        adjustment:
          $ref: '#/components/schemas/adjustment'
        pricebook_id:
          $ref: '#/components/schemas/pricebook_id'
        salesperson_id:
          $ref: '#/components/schemas/salesperson_id'
        adjustment_description:
          $ref: '#/components/schemas/adjustment_description'
        is_inclusive_tax:
          $ref: '#/components/schemas/is_inclusive_tax'
        exchange_rate:
          $ref: '#/components/schemas/exchange_rate'
        template_id:
          $ref: '#/components/schemas/template_id'
        documents:
          $ref: '#/components/schemas/documents'
        billing_address_id:
          $ref: '#/components/schemas/billing_address_id'
        shipping_address_id:
          $ref: '#/components/schemas/shipping_address_id'
        place_of_supply:
          $ref: '#/components/schemas/place_of_supply'
        gst_treatment:
          $ref: '#/components/schemas/gst_treatment'
        gst_no:
          $ref: '#/components/schemas/gst_no'
    last_name:
      description: Last Name of the Contact Person
      type: string
      example: John
    list-all-sales-orders-response:
      type: object
      properties:
        code:
          type: integer
          example: 0
          readOnly: true
        message:
          type: string
          example: success
          readOnly: true
        salesorders:
          type: array
          items:
            type: object
            properties:
              salesorder_id:
                $ref: '#/components/schemas/salesorder_id'
              customer_name:
                $ref: '#/components/schemas/customer_name'
              customer_id:
                $ref: '#/components/schemas/customer_id'
              status:
                $ref: '#/components/schemas/status'
              salesorder_number:
                $ref: '#/components/schemas/salesorder_number'
              reference_number:
                $ref: '#/components/schemas/reference_number'
              date:
                $ref: '#/components/schemas/date'
              shipment_date:
                $ref: '#/components/schemas/shipment_date'
              shipment_days:
                $ref: '#/components/schemas/shipment_days'
              quantity:
                $ref: '#/components/schemas/quantity'
              quantity_invoiced:
                $ref: '#/components/schemas/quantity_invoiced'
              quantity_packed:
                $ref: '#/components/schemas/quantity_packed'
              quantity_shipped:
                $ref: '#/components/schemas/quantity_shipped'
              currency_code:
                $ref: '#/components/schemas/currency_code'
              total:
                $ref: '#/components/schemas/total'
              bcy_total:
                $ref: '#/components/schemas/bcy_total'
              created_time:
                $ref: '#/components/schemas/created_time'
              last_modified_time:
                $ref: '#/components/schemas/last_modified_time'
              is_emailed:
                $ref: '#/components/schemas/is_emailed'
              is_drop_shipment:
                $ref: '#/components/schemas/is_drop_shipment'
              is_backorder:
                $ref: '#/components/schemas/is_backorder'
              sales_channel:
                $ref: '#/components/schemas/sales_channel'
              custom_fields:
                $ref: '#/components/schemas/custom_fields'
    is_invoiced:
      description: Checks whether the Sales Order has been invoiced or not.
      type: boolean
      example: true
    location_id:
      description: Location ID
      type: string
      example: '460000000038080'
    tax_type:
      description: Denotes the type of the tax. This can either be a single tax or a tax group.
      type: string
      example: tax
    shipment_status:
      description: Shipment status of the package.
      type: string
      example: 3
    can_send_in_mail:
      description: Checks whether the sales order can be sent as a mail or not.
      type: boolean
      example: true
    contact_person_email:
      description: Email ID of the Contact Person.
      type: string
      example: willsmith@bowmanfurniture.com
    is_backorder:
      description: Denotes if a SalesOrder is a backorder
      type: boolean
      example: false
    shipping_address_id:
      description: Unique Id generated by the server for address in contacts page. To add a shipping address to sales order, send the address_id using this node. Else, the default shipping address for that contact is used
      type: string
      example: 4815000000017005
    location_name:
      description: Name of the location
      type: string
    adjustment_description:
      description: Description for the adjustment.
      type: string
      example: Just an example description.
    notes:
      description: Notes for the Sales Order.
      type: string
      example: Sample Note
    delivery_method_id:
      description: Unique ID generated by the server for the delivery method. This is used as an identifier.
      type: string
      example: 4815000000044822
    is_drop_shipment:
      description: Denotes if a SalesOrder is a drop shipment
      type: boolean
      example: false
    documents:
      description: Sales order can have files attached to them. Each attachment has the following attributes <code>can_send_in_mail</code>, <code>file_name</code>, <code>file_type</code>, <code>file_size_formatted</code>, <code>attachment_order</code>, <code>document_id</code>, <code>file_size</code>.
      type: array
      items:
        type: object
        properties:
          can_send_in_mail:
            $ref: '#/components/schemas/can_send_in_mail'
          file_name:
            $ref: '#/components/schemas/file_name'
          file_type:
            $ref: '#/components/schemas/file_type'
          file_size_formatted:
            $ref: '#/components/schemas/file_size_formatted'
          attachment_order:
            $ref: '#/components/schemas/attachment_order'
          document_id:
            $ref: '#/components/schemas/document_id'
          file_size:
            $ref: '#/components/schemas/file_size'
    delivery_days:
      description: The expected days to be taken for the delivery.
      type: string
      example: 12
    update-a-sales-order-response:
      type: object
      properties:
        code:
          type: integer
          example: 0
          readOnly: true
        message:
          type: string
          example: Sales Order has been updated.
          readOnly: true
        sales_order:
          type: object
          properties:
            salesorder_id:
              $ref: '#/components/schemas/salesorder_id'
            salesorder_number:
              $ref: '#/components/schemas/salesorder_number'
            date:
              $ref: '#/components/schemas/date'
            status:
              $ref: '#/components/schemas/status'
            shipment_date:
              $ref: '#/components/schemas/shipment_date'
            reference_number:
              $ref: '#/components/schemas/reference_number'
            customer_id:
              $ref: '#/components/schemas/customer_id'
            customer_name:
              $ref: '#/components/schemas/customer_name'
            contact_persons_associated:
              $ref: '#/components/schemas/contact_persons_associated'
            currency_id:
              $ref: '#/components/schemas/currency_id'
            currency_code:
              $ref: '#/components/schemas/currency_code'
            currency_symbol:
              $ref: '#/components/schemas/currency_symbol'
            exchange_rate:
              $ref: '#/components/schemas/exchange_rate'
            discount_amount:
              $ref: '#/components/schemas/discount_amount'
            discount:
              $ref: '#/components/schemas/discount'
            is_discount_before_tax:
              $ref: '#/components/schemas/is_discount_before_tax'
            discount_type:
              $ref: '#/components/schemas/discount_type'
            estimate_id:
              $ref: '#/components/schemas/estimate_id'
            delivery_method:
              $ref: '#/components/schemas/delivery_method'
            delivery_method_id:
              $ref: '#/components/schemas/delivery_method_id'
            location_id:
              $ref: '#/components/schemas/location_id'
            location_name:
              $ref: '#/components/schemas/location_name'
            line_items:
              $ref: '#/components/schemas/line_items'
            shipping_charge:
              $ref: '#/components/schemas/shipping_charge'
            adjustment:
              $ref: '#/components/schemas/adjustment'
            adjustment_description:
              $ref: '#/components/schemas/adjustment_description'
            sub_total:
              $ref: '#/components/schemas/sub_total'
            tax_total:
              $ref: '#/components/schemas/tax_total'
            total:
              $ref: '#/components/schemas/total'
            taxes:
              $ref: '#/components/schemas/taxes'
            price_precision:
              $ref: '#/components/schemas/price_precision'
            pricebook_id:
              $ref: '#/components/schemas/pricebook_id'
            packages:
              $ref: '#/components/schemas/packages'
            invoices:
              $ref: '#/components/schemas/invoices'
            shipping_address:
              $ref: '#/components/schemas/shipping_address'
            billing_address:
              $ref: '#/components/schemas/billing_address'
            notes:
              $ref: '#/components/schemas/notes'
            terms:
              $ref: '#/components/schemas/terms'
            template_id:
              $ref: '#/components/schemas/template_id'
            template_name:
              $ref: '#/components/schemas/template_name'
            template_type:
              $ref: '#/components/schemas/template_type'
            created_time:
              $ref: '#/components/schemas/created_time'
            last_modified_time:
              $ref: '#/components/schemas/last_modified_time'
            attachment_name:
              $ref: '#/components/schemas/attachment_name'
            can_send_in_mail:
              $ref: '#/components/schemas/can_send_in_mail'
            salesperson_id:
              $ref: '#/components/schemas/salesperson_id'
            salesperson_name:
              $ref: '#/components/schemas/salesperson_name'
            is_pre_gst:
              $ref: '#/components/schemas/is_pre_gst'
            gst_no:
              $ref: '#/components/schemas/gst_no'
            gst_treatment:
              $ref: '#/components/schemas/gst_treatment'
            place_of_supply:
              $ref: '#/components/schemas/place_of_supply'
            custom_fields:
              $ref: '#/components/schemas/custom_fields'
    tax_name:
      description: Name of the tax applied on the line item.
      type: string
      example: Sales Tax
    salesorder_number:
      description: The Sales Order number. This is unique for each sales order.
      type: string
      example: SO-00003
    is_combo_product:
      description: Indicates whether the line item is a composite product.
      type: boolean
      example: true
    bcy_rate:
      description: Item rate in the organization's base currency.
      type: number
      format: double
      example: 122
    is_emailed:
      description: Checks whether the Sales Order has been emailed to the customer or not.
      type: boolean
      example: true
    address:
      description: Name of the street of the customer's shipping address.
      type: string
      example: No:432,Bayside,Queens
    salesperson_name:
      description: Name of the Sales Person.
      type: string
      example: Lara
    service:
      description: Name of the service provided by the carrier.
      type: string
      example: SMART_POST
    image_type:
      description: The type (file format) of the image.
      type: string
      example: jpg
    retrieve-a-sales-order-response:
      type: object
      properties:
        code:
          type: integer
          example: 0
          readOnly: true
        message:
          type: string
          example: success
          readOnly: true
        salesorder:
          type: object
          properties:
            salesorder_id:
              $ref: '#/components/schemas/salesorder_id'
            documents:
              $ref: '#/components/schemas/documents'
            salesorder_number:
              $ref: '#/components/schemas/salesorder_number'
            date:
              $ref: '#/components/schemas/date'
            status:
              $ref: '#/components/schemas/status'
            shipment_date:
              $ref: '#/components/schemas/shipment_date'
            reference_number:
              $ref: '#/components/schemas/reference_number'
            customer_id:
              $ref: '#/components/schemas/customer_id'
            customer_name:
              $ref: '#/components/schemas/customer_name'
            contact_persons_associated:
              $ref: '#/components/schemas/contact_persons_associated'
            currency_id:
              $ref: '#/components/schemas/currency_id'
            currency_code:
              $ref: '#/components/schemas/currency_code'
            currency_symbol:
              $ref: '#/components/schemas/currency_symbol'
            exchange_rate:
              $ref: '#/components/schemas/exchange_rate'
            discount_amount:
              $ref: '#/components/schemas/discount_amount'
            discount:
              $ref: '#/components/schemas/discount'
            is_discount_before_tax:
              $ref: '#/components/schemas/is_discount_before_tax'
            discount_type:
              $ref: '#/components/schemas/discount_type'
            estimate_id:
              $ref: '#/components/schemas/estimate_id'
            delivery_method:
              $ref: '#/components/schemas/delivery_method'
            delivery_method_id:
              $ref: '#/components/schemas/delivery_method_id'
            is_inclusive_tax:
              $ref: '#/components/schemas/is_inclusive_tax'
            sales_channel:
              $ref: '#/components/schemas/sales_channel'
            is_dropshipped:
              $ref: '#/components/schemas/is_dropshipped'
            is_backordered:
              $ref: '#/components/schemas/is_backordered'
            is_backorder_allowed:
              $ref: '#/components/schemas/is_backorder_allowed'
            line_items:
              $ref: '#/components/schemas/line_items'
            location_id:
              $ref: '#/components/schemas/location_id'
            location_name:
              $ref: '#/components/schemas/location_name'
            shipping_charge:
              $ref: '#/components/schemas/shipping_charge'
            adjustment:
              $ref: '#/components/schemas/adjustment'
            pricebook_id:
              $ref: '#/components/schemas/pricebook_id'
            adjustment_description:
              $ref: '#/components/schemas/adjustment_description'
            sub_total:
   

# --- truncated at 32 KB (74 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoho-inventory/refs/heads/main/openapi/zoho-inventory-salesorders-api-openapi.yml