openapi: 3.0.0
info:
title: Shipment Orders
description: A document used by an organization to specify what items or packages are to be transferred from a storage location or warehouse to what person and to what new location is called a shipment order. It is typically sent along with a shipment of goods so that the person receiving them(your customer) can verify that the document correctly reflects the items that they actually received.
contact: {}
version: 1.0.0
servers:
- url: https://www.zohoapis.com/inventory/v1
description: API Endpoint
tags:
- name: shipmentorders
description: ShipmentOrders Module
paths:
/shipmentorders:
x-mcp-group:
- Shipment Orders
post:
tags:
- shipmentorders
operationId: create_shipment_order
summary: Create a Shipment Order
description: A new shipment order can a be created. To create shipment, URL parameter's package_ids and salesorder_id are mandatory.
parameters:
- name: package_ids
in: query
description: Array of package_id(s) to be shipped
required: false
schema:
type: array
items:
type: object
properties:
package_id:
$ref: '#/components/schemas/package_id'
example:
- 4815000000017005
- 4815000000017006
- name: salesorder_id
in: query
description: Unique ID generated by the server for the Sales Order. This is used as identifier.
required: false
schema:
type: string
example: 4815000000044895
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/create-a-shipment-order-request'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/create-a-shipment-order-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.shipmentorders.CREATE
parameters:
- $ref: '#/components/parameters/organization_id'
/shipmentorders/{shipmentorder_id}:
x-mcp-group:
- Shipment Orders
get:
tags:
- shipmentorders
operationId: get_shipment_order
summary: Retrieve a Shipment Order
description: Retrieves details for an existing Shipment Orders.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/retrieve-a-shipment-order-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.shipmentorders.READ
put:
tags:
- shipmentorders
operationId: update_shipment_order
summary: Update a Shipment Order
description: Update details of an existing Shipment Order in Zoho Inventory.
parameters:
- name: package_ids
in: query
description: Array of package_id(s) to be shipped
required: true
schema:
type: string
example: 4815000000017005,4815000000017006
- name: salesorder_id
in: query
description: Unique ID generated by the server for the Sales Order. This is used as identifier.
required: true
schema:
type: string
example: 4815000000044895
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/update-a-shipment-order-request'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/update-a-shipment-order-response'
security:
- Zoho_Auth:
- ZohoInventory.shipmentorders.UPDATE
delete:
tags:
- shipmentorders
operationId: delete_shipment_order
summary: Delete a Shipment Order
description: Deletes an existing Shipment Order.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/delete-a-shipment-order-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.shipmentorders.DELETE
parameters:
- name: shipmentorder_id
in: path
required: true
description: Unique identifier of the shipment order.
schema:
type: string
example: 4815000000044598
- $ref: '#/components/parameters/organization_id'
/shipmentorders/{shipmentorder_id}/status/delivered:
x-mcp-group:
- Shipment Orders
post:
tags:
- shipmentorders
operationId: mark_shipment_order_as_delivered
summary: Mark as Delivered
description: Change the status of the Shipment to delivered.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/mark-as-delivered-response'
deprecated: false
security:
- Zoho_Auth:
- ZohoInventory.shipmentorders.CREATE
parameters:
- name: shipmentorder_id
in: path
required: true
description: Unique identifier of the shipment order.
schema:
type: string
example: 4815000000044598
- $ref: '#/components/parameters/organization_id'
components:
parameters:
organization_id:
name: organization_id
description: ID of the organization
in: query
required: true
schema:
type: string
example: '10234695'
schemas:
gendoc-attributes-schema:
$ref: '#/components/schemas/shipment_order-response'
shipment_order-response:
type: object
properties:
salesorder_id:
$ref: '#/components/schemas/salesorder_id'
salesorder_number:
$ref: '#/components/schemas/salesorder_number'
shipment_id:
$ref: '#/components/schemas/shipment_id'
shipment_number:
$ref: '#/components/schemas/shipment_number'
date:
$ref: '#/components/schemas/date'
status:
$ref: '#/components/schemas/status'
detailed_status:
$ref: '#/components/schemas/detailed_status'
status_message:
$ref: '#/components/schemas/status_message'
carrier:
$ref: '#/components/schemas/carrier'
service:
$ref: '#/components/schemas/service'
delivery_days:
$ref: '#/components/schemas/delivery_days'
delivery_guarantee:
$ref: '#/components/schemas/delivery_guarantee'
reference_number:
$ref: '#/components/schemas/reference_number'
customer_id:
$ref: '#/components/schemas/customer_id'
customer_name:
$ref: '#/components/schemas/customer_name'
contact_persons:
$ref: '#/components/schemas/contact_persons'
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'
tracking_number:
$ref: '#/components/schemas/tracking_number'
line_items:
$ref: '#/components/schemas/line_items'
shipping_charge:
$ref: '#/components/schemas/shipping_charge'
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'
is_emailed:
$ref: '#/components/schemas/is_emailed'
billing_address:
$ref: '#/components/schemas/billing_address'
shipping_address:
$ref: '#/components/schemas/shipping_address'
template_id:
$ref: '#/components/schemas/template_id'
template_name:
$ref: '#/components/schemas/template_name'
template_type:
$ref: '#/components/schemas/template_type'
notes:
$ref: '#/components/schemas/notes'
shipmentorder_custom_fields:
$ref: '#/components/schemas/custom_fields'
created_time:
$ref: '#/components/schemas/created_time'
last_modified_time:
$ref: '#/components/schemas/last_modified_time'
salesorder_id:
description: Unique ID generated by the server for the Sales Order. This is used as identifier.
type: string
example: 4815000000044895
salesorder_number:
description: The Sales Order number. This is unique for each sales order.
type: string
example: SO-00003
shipment_id:
description: Unique ID generated by the server for the shipment. This is used as an identifier.
type: string
example: 4815000000044917
shipment_number:
description: Shipment number of the package.
type: string
example: SH-00004
date:
description: Date on which package is prepared
type: string
example: '2017-01-11'
status:
description: Status of the Shipment Order
type: string
example: shipped
detailed_status:
description: Detailed shipment details received from the courier
type: string
example: Reached a courier facility near Toronto.
status_message:
description: Status message of the shipment.
type: string
example: Shipped
carrier:
description: Carrier used for shipment.
type: string
example: FedEx
service:
description: Type of service selected for shipment
type: string
example: FEDEX_2_DAY
delivery_days:
description: Number of days taken by the courier for delivering in package
type: integer
example: 2
delivery_guarantee:
description: guarantee assured by the courier. For guaranteed on-time deliveries, it is true else it is false
type: boolean
example: true
reference_number:
description: Tracking number for the Shipment.
type: string
example: TKG424242
customer_id:
description: Unique ID generated by the for the customer
type: string
example: 481500000000062000
customer_name:
description: Name of the customer
type: string
example: Peter James
contact_person_id:
description: Unique ID generated by the server for the contact person
type: string
example: 4815000000044080
contact_persons:
description: Array of contact person IDs.
type: array
items:
type: object
properties:
contact_person_id:
$ref: '#/components/schemas/contact_person_id'
example: 4815000000044080
currency_id:
description: Unique ID generated by the server for the currency. This is used as an identifier.
type: string
example: 4815000000000097
currency_code:
description: Currency code.
type: string
example: USD
currency_symbol:
description: The symbol for the selected currency.
type: string
example: $
exchange_rate:
description: Exchange rate of the currency, with respect to the base currency.
type: number
format: double
example: 1
discount_amount:
description: Discount to be applied on the Sales Order.
type: number
format: double
example: 0
discount:
description: Discount applied to the shipment order, which can be either a percentage or a flat amount. For percentage discounts, the value should include the % symbol (e.g., 10%). For example, on Rs.1000, a 10% discount results in Rs.900, while a flat Rs.200 discount results in Rs.800.
type: number
format: double
example: 20.00%
is_discount_before_tax:
description: Used to check whether the discount is applied before tax or after tax.
type: boolean
example: true
discount_type:
description: Type of discount
type: string
example: entity_level
estimate_id:
description: Unique ID generated by the server from the Estimate created in Zoho Books. This is used as an identifier.
type: string
example: 4815000000045091
delivery_method:
description: Delivery method of the shipment.
type: string
example: FedEx
delivery_method_id:
description: Unique ID generated by the server for the delivery method. This is used as an identifier.
type: string
example: 4815000000044822
tracking_number:
description: Tracking number of shipment.
type: string
example: TRK214124124
item_id:
description: Unique ID generated by the server for the item. This is used as an identifier.
type: string
example: 4815000000044100
line_item_id:
description: Unique ID generated by the server for each line item. This is used as an identifier.
type: string
example: 4815000000044897
name:
description: Name of the line item.
type: string
example: Laptop-white/15inch/dell
description:
description: Description of the line item.
type: string
example: Just a sample description.
item_order:
description: The order of the line items, starts from 0 by default.
type: integer
example: 0
bcy_rate:
description: Item rate in the organization's base currency.
type: number
format: double
example: 122
rate:
description: Rate / Selling Price of the line item.
type: number
format: double
example: 122
quantity:
description: Quantity of the line item.
type: number
format: double
example: 2
unit:
description: Unit of line item.
type: string
example: qty
tax_id:
description: Unique ID generated by the server for the tax. This is used as an identifier.
type: string
example: 4815000000044043
tax_name:
description: Name of the tax applied on the line item.
type: string
example: Sales Tax
tax_type:
description: Denotes the type of the tax. This can either be a single tax or a tax group.
type: string
example: tax
tax_percentage:
description: Percentage of the tax.
type: number
format: double
example: 12
item_total:
description: Total of line item.
type: number
format: double
example: 244
is_invoiced:
description: Checks whether the Sales Order has been invoiced or not.
type: boolean
example: true
line_items:
description: List of items in a package. Each line item contains line_item_id,item_id,name,description,item_order,bcy_rate,rate,quantity,unit,tax_id,tax_name,tax_type,tax_percentage,item_total,is_invoiced.
type: array
items:
type: object
properties:
item_id:
$ref: '#/components/schemas/item_id'
line_item_id:
$ref: '#/components/schemas/line_item_id'
name:
$ref: '#/components/schemas/name'
description:
$ref: '#/components/schemas/description'
item_order:
$ref: '#/components/schemas/item_order'
bcy_rate:
$ref: '#/components/schemas/bcy_rate'
rate:
$ref: '#/components/schemas/rate'
unit:
$ref: '#/components/schemas/unit'
tax_id:
$ref: '#/components/schemas/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'
is_invoiced:
$ref: '#/components/schemas/is_invoiced'
shipping_charge:
description: Shipping charges that are applied to the Shipment.
type: number
format: double
example: 7
sub_total:
description: Sub total of the Sales Order.
type: number
format: double
example: 244
tax_total:
description: Tax total of the Sales Order.
type: number
format: double
example: 29
total:
description: Total amount of the Sales Order.
type: number
format: double
example: 350
tax_amount:
description: Amount of the tax.
type: number
format: double
example: 29.28
taxes:
description: 'Number of taxes applied on sales order. Each tax contains: tax_name and tax_amount.'
type: array
items:
type: object
properties:
tax_name:
$ref: '#/components/schemas/tax_name'
tax_amount:
$ref: '#/components/schemas/tax_amount'
price_precision:
description: The precision level for the price's decimal point in a Shipment.
type: integer
example: 2
is_emailed:
description: Checks whether the Package has been emailed to the customer or not.
type: boolean
example: true
address:
description: Name of the street of the customer's billing address.
type: string
example: No:234,90 Church Street
city:
description: Name of the city of the customer's billing address.
type: string
example: New York City
state:
description: Name of the state of the customer's billing address.
type: string
example: New York
zip:
description: Zip code of the customer's billing address.
type: string
example: 10048
country:
description: Name of the country of the customer's billing address.
type: string
example: U.S.A
fax:
description: Fax number of the customer's billing address.
type: string
example: 324-524242
billing_address:
description: Customer's billing address. It contains - address, city, state, zip, country and fax.
type: array
items:
type: object
properties:
address:
$ref: '#/components/schemas/address'
city:
$ref: '#/components/schemas/city'
state:
$ref: '#/components/schemas/state'
zip:
$ref: '#/components/schemas/zip'
country:
$ref: '#/components/schemas/country'
fax:
$ref: '#/components/schemas/fax'
shipping_address:
description: Customer's shipping address. It contains - address, city, state, zip, country and fax.
type: array
items:
type: object
properties:
address:
$ref: '#/components/schemas/address'
city:
$ref: '#/components/schemas/city'
state:
$ref: '#/components/schemas/state'
zip:
$ref: '#/components/schemas/zip'
country:
$ref: '#/components/schemas/country'
fax:
$ref: '#/components/schemas/fax'
template_id:
description: Unique ID generated by the server for the Template. This is used as an identifier.
type: string
example: 4815000000017003
template_name:
description: Name of the template used for the Shipment.
type: string
example: Standard
template_type:
description: Type of the template.
type: string
example: standard
notes:
description: Notes for package
type: string
example: notes
customfield_id:
type: string
description: Unique ID of the custom field.
label:
description: Label of the Custom Field
type: string
value:
description: Value of the Custom Field
type: string
example: Normal
custom_fields:
description: Custom fields for a shipmentorder.
type: array
items:
type: object
properties:
customfield_id:
$ref: '#/components/schemas/customfield_id'
label:
$ref: '#/components/schemas/label'
value:
$ref: '#/components/schemas/value'
created_time:
description: Time at which the Shipment Details was created.
type: string
example: 2015-05-28T00:00:00.000Z
package_id:
description: Unique ID generated by the server for packages
type: string
example: 4815000000017005
package_ids:
description: Array of package_id(s) to be shipped
type: array
items:
type: object
properties:
package_id:
$ref: '#/components/schemas/package_id'
example:
- 4815000000017005
- 4815000000017006
last_modified_time:
description: Time at which the Shipment Details details were last modified.
type: string
example: 2015-05-28T00:00:00.000Z
create-a-shipment-order-request:
required:
- shipment_number
- date
- delivery_method
- tracking_number
type: object
properties:
shipment_number:
$ref: '#/components/schemas/shipment_number'
date:
$ref: '#/components/schemas/date'
reference_number:
$ref: '#/components/schemas/reference_number'
contact_persons:
$ref: '#/components/schemas/contact_persons'
delivery_method:
$ref: '#/components/schemas/delivery_method'
tracking_number:
$ref: '#/components/schemas/tracking_number'
shipping_charge:
$ref: '#/components/schemas/shipping_charge'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
template_id:
$ref: '#/components/schemas/template_id'
notes:
$ref: '#/components/schemas/notes'
shipmentorder_custom_fields:
$ref: '#/components/schemas/custom_fields'
update-a-shipment-order-request:
required:
- shipment_number
- date
- delivery_method
type: object
properties:
shipment_number:
$ref: '#/components/schemas/shipment_number'
date:
$ref: '#/components/schemas/date'
reference_number:
$ref: '#/components/schemas/reference_number'
contact_persons:
$ref: '#/components/schemas/contact_persons'
delivery_method:
$ref: '#/components/schemas/delivery_method'
tracking_number:
$ref: '#/components/schemas/tracking_number'
shipping_charge:
$ref: '#/components/schemas/shipping_charge'
exchange_rate:
$ref: '#/components/schemas/exchange_rate'
template_id:
$ref: '#/components/schemas/template_id'
notes:
$ref: '#/components/schemas/notes'
shipmentorder_custom_fields:
$ref: '#/components/schemas/custom_fields'
create-a-shipment-order-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: Shipment created successfully.
readOnly: true
shipment_order:
$ref: '#/components/schemas/shipment_order-response'
update-a-shipment-order-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: Shipment Order updated successfully.
readOnly: true
shipmentorder:
type: object
properties:
salesorder_id:
$ref: '#/components/schemas/salesorder_id'
salesorder_number:
$ref: '#/components/schemas/salesorder_number'
shipment_id:
$ref: '#/components/schemas/shipment_id'
shipment_number:
$ref: '#/components/schemas/shipment_number'
date:
$ref: '#/components/schemas/date'
status:
$ref: '#/components/schemas/status'
detailed_status:
$ref: '#/components/schemas/detailed_status'
status_message:
$ref: '#/components/schemas/status_message'
carrier:
$ref: '#/components/schemas/carrier'
service:
$ref: '#/components/schemas/service'
delivery_days:
$ref: '#/components/schemas/delivery_days'
delivery_guarantee:
$ref: '#/components/schemas/delivery_guarantee'
reference_number:
$ref: '#/components/schemas/reference_number'
customer_id:
$ref: '#/components/schemas/customer_id'
customer_name:
$ref: '#/components/schemas/customer_name'
contact_persons:
$ref: '#/components/schemas/contact_persons'
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'
tracking_number:
$ref: '#/components/schemas/tracking_number'
line_items:
$ref: '#/components/schemas/line_items'
shipping_charge:
$ref: '#/components/schemas/shipping_charge'
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'
is_emailed:
$ref: '#/components/schemas/is_emailed'
billing_address:
$ref: '#/components/schemas/billing_address'
shipping_address:
$ref: '#/components/schemas/shipping_address'
template_id:
$ref: '#/components/schemas/template_id'
template_name:
$ref: '#/components/schemas/template_name'
template_type:
$ref: '#/components/schemas/template_type'
notes:
$ref: '#/components/schemas/notes'
shipmentorder_custom_fields:
$ref: '#/components/schemas/custom_fields'
created_time:
$ref: '#/components/schemas/created_time'
last_modified_time:
$ref: '#/components/schemas/last_modified_time'
retrieve-a-shipment-order-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: success
readOnly: true
shipment_order:
type: object
properties:
salesorder_id:
$ref: '#/components/schemas/salesorder_id'
salesorder_number:
$ref: '#/components/schemas/salesorder_number'
shipment_id:
$ref: '#/components/schemas/shipment_id'
shipment_number:
$ref: '#/components/schemas/shipment_number'
date:
$ref: '#/components/schemas/date'
status:
$ref: '#/components/schemas/status'
detailed_status:
$ref: '#/components/schemas/detailed_status'
status_message:
$ref: '#/components/schemas/status_message'
carrier:
$ref: '#/components/schemas/carrier'
service:
$ref: '#/components/schemas/service'
delivery_days:
$ref: '#/components/schemas/delivery_days'
delivery_guarantee:
$ref: '#/components/schemas/delivery_guarantee'
reference_number:
$ref: '#/components/schemas/reference_number'
customer_id:
$ref: '#/components/schemas/customer_id'
customer_name:
$ref: '#/components/schemas/customer_name'
contact_persons:
$ref: '#/components/schemas/contact_persons'
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'
tracking_number:
$ref: '#/components/schemas/tracking_number'
line_items:
$ref: '#/components/schemas/line_items'
shipping_charge:
$ref: '#/components/schemas/shipping_charge'
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'
is_emailed:
$ref: '#/components/schemas/is_emailed'
billing_address:
$ref: '#/components/schemas/billing_address'
shipping_address:
$ref: '#/components/schemas/shipping_address'
template_id:
$ref: '#/components/schemas/template_id'
template_name:
$ref: '#/components/schemas/template_name'
template_type:
$ref: '#/components/schemas/template_type'
notes:
$ref: '#/components/schemas/notes'
shipmentorder_custom_fields:
$ref: '#/components/schemas/custom_fields'
created_time:
$ref: '#/components/schemas/created_time'
last_modified_time:
$ref: '#/components/schemas/last_modified_time'
delete-a-shipment-order-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The Shipment Order has been deleted.
readOnly: true
mark-as-delivered-response:
type: object
properties:
code:
type: integer
example: 0
readOnly: true
message:
type: string
example: The Shipment Order has been marked as Delivered.
readOnly: true
securitySchemes:
Zoho_Auth:
type: oauth2
flows:
implicit:
authorizationUrl: https://accounts.zoho.com/oauth/v2/auth
scopes:
ZohoInventory.shipmentorders.CREATE: Create Shipmentorders
ZohoInventory.shipmentorders.READ: Read Shipmentorders
ZohoInventory.shipmentorders.UPDATE: Update Shipmentorders
ZohoInventory.shipmentorders.DELETE: Delete Shipmentorders