Order
Handles all platform order and shipment api(s)
Bag represents a virtual entity to group same items which contains single or multi quantity. Bags are part of a shipment. An order will have one or more than one shipments. A shipment can contain zero or more bags.
Operations
GET
# Get reasons behind full or partial cancellation of a shipment
GET
# Get bag by ID.
GET
# Get bags.
Use this API to retrieve the issues that led to the cancellation of bags within a shipment.
Parameters
company_id
integer
Required
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
bag_id
string
Required
ID of the bag. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
state
string
Required
State for which reasons are required.
Response
200
Success. Check the example shown below or refer `PlatformShipmentReasonsResponseSchema` for more details.
PlatformShipmentReasonsResponseSchema
reasons
array of object (Reason)
Array of Reason
id
integer
display_name
string
remark_required
boolean
show_text_area
boolean
Nullable
reasons
array of object (Reason)
Array of Reason
qc_type
array of string
question_set
array of object (QuestionSet)
Array of QuestionSet
id
integer
A unique identifier for the question set.
display_name
string
The display name for the question set, used for user-facing purposes.
meta
object
is_active
boolean
is_deleted
boolean
Indicates whether reason is deleted
success
boolean
Indicates whether the API call was successful (true) or not (false).
Examples
Parameters
company_id:
2
shipment_id:
"16984021739051838556"
bag_id:
"6393"
Was this section helpful?
GET
Response
Get reasons behind full or partial cancellation of a shipment
getShipmentReasons
Parameters
company_id
integer
Required
Unique identifier of a company
bag_id
string
Unique identifier of a bag
channel_bag_id
string
Id of application bag
channel_id
string
Id of application
Response
200
Successfully retrived shipment details!
BagDetailsPlatformResponseSchema
status_code
integer
Response status_code.
Enum
data
object (BagDetails)
BagDetails
bag_update_time
number
Nullable
The timestamp indicating when the bag's information was last updated
id
string
Nullable
A unique identifier for the bag record within the system.
bag_id
integer
Nullable
A unique identifier specifically for the bag itself, used for tracking purposes.
affiliate_bag_details
object (AffiliateBagDetails)
AffiliateBagDetails
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_order_id
string
Unique identifier for the affiliate order associated with the bag.
employee_discount
number
Nullable
Discount percentage or amount applicable to employees for this order.
affiliate_bag_id
string
Unique identifier for the affiliate bag, used for tracking and reference.
loyalty_discount
number
Nullable
Discount amount applied based on customer loyalty, if applicable.
affiliate_details
object (AffiliateDetails)
AffiliateDetails
shipment_meta
object (ShipmentMeta)
ShipmentMeta
tracking_url
string
Nullable
A URL for tracking the shipment.
estimated_delivery_date
string
| date-time
Nullable
Provides a forecasted date and time by which the shipment is expected to be delivered to the recipient. This estimation is crucial for planning purposes, both for the sender in managing expectations and for the recipient in preparing for receipt.
same_store_available
boolean
Indicates whether the shipment is available for pickup from the same store.
b2b_buyer_details
object (BuyerDetails)
BuyerDetails
ajio_site_id
string
Nullable
The unique identifier for the buyer on the Ajio platform.
pincode
integer
The postal code for the buyer's shipping address, used for delivery location identification.
address
string
Provides the comprehensive address details of the buyer's shipping address.
gstin
string
The Goods and Services Tax Identification Number (GSTIN) of the buyer.
name
string
The full name of the buyer, essential for personalizing communication and delivery.
state
string
The name of the state where the buyer's shipping address is located, important for logistical purposes.
city
string
The name of the city where the buyer's shipping address is located, which helps in identifying delivery zones.
formatted
object (Formatted)
Formatted
max
string
Nullable
Represents the maximum formatted value, providing a limit for the associated data, such as dimensions or weights.
min
string
Nullable
Represents the minimum formatted value, establishing a lower limit for the associated data, ensuring it meets certain criteria or standards.
debug_info
object (DebugInfo)
DebugInfo
stormbreaker_uuid
string
Nullable
A unique identifier (UUID) associated with the Stormbreaker system, used for tracking and debugging purposes in the application.
return_awb_number
string
Nullable
The Air Waybill (AWB) number associated with a return shipment.
is_self_ship
boolean
Nullable
Indicates whether the shipment is a self-shipped order.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
einvoice_info
object (EinvoiceInfo)
EinvoiceInfo
credit_note
object
Nullable
Specifies the reverse einvoice transaction create on government portal.
invoice
object
Nullable
It specifies the forward einvoice transaction created on government portal.
return_affiliate_shipment_id
string
Nullable
The shipment ID associated with a return from an affiliate.
parent_dp_id
string
Nullable
The unique identifier for the parent delivery partner.
shipment_weight
number
Nullable
The total weight of the shipment.
dimension
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
assign_dp_from_sb
boolean
Nullable
Indicates whether to assign the delivery partner from the store’s basket.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
store_invoice_updated_date
string
| date-time
Nullable
Denotes the date and time when the store's invoice related to this shipment was updated. This timestamp is vital for tracking changes to billing details, adjustments in charges, or updates in the invoicing status.
forward_affiliate_shipment_id
string
Nullable
The shipment ID for the forward journey of an affiliate shipment.
return_store_node
integer
Nullable
The identifier for the store node involved in the return process.
fulfilment_priority_text
string
Nullable
Textual representation of the fulfillment priority for the shipment.
shipment_tags
array of object (ShipmentTags)
Tags associated with the shipment for categorization and filtering.
Array of ShipmentTags
slug
string
Nullable
A URL-friendly string representing the tag, often used for routing or categorization.
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
display_text
string
Nullable
A human-readable text representation of the tag, used for display purposes in user interfaces.
external
object
Nullable
External metadata related to the shipment.
awb_number
string
Nullable
The Air Waybill number associated with the shipment.
lock_data
object (LockData)
LockData
locked
boolean
Nullable
Indicates whether the shipment is currently locked for processing (true) or not (false).
mto
boolean
Nullable
A flag indicating whether the shipment is part of a multi-modal transport operation.
lock_message
string
Nullable
An optional message providing additional context or information regarding the lock status.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow.
Enum
ewaybill_info
object
Nullable
Electronic Way Bill details i.e ewayBillNo, ewayBillDate that are utilized in the transportation of goods.
dp_id
string
Nullable
The unique identifier for the delivery partner associated with the shipment.
shipment_volumetric_weight
number
Nullable
The volumetric weight of the shipment, which may differ from its actual weight.
marketplace_store_id
string
Nullable
The unique identifier for the marketplace store associated with the shipment.
return_details
object
Nullable
An object containing the return details of the shipment.
dp_sort_key
string
Nullable
A sort key for the delivery partner, used for prioritization.
packaging_name
string
Nullable
The name of the packaging used for the shipment.
timestamp
object (ShipmentTimeStamp)
ShipmentTimeStamp
max
integer
Nullable
Represents the maximum timestamp value, indicating the latest time relevant to the shipment.
min
integer
Nullable
Represents the minimum timestamp value, indicating the earliest time relevant to the shipment.
auto_trigger_dp_assignment_acf
boolean
Nullable
Indicates whether automatic delivery partner assignment is triggered for this shipment.
dp_name
string
Nullable
The name of the delivery partner associated with the shipment.
po_number
string
Nullable
The purchase order number associated with the shipment.
weight
integer
The weight of the shipment, typically measured in grams or kilograms.
b2c_buyer_details
object
Nullable
Contains detailed information about the buyer in a business-to-consumer (B2C) transaction. This object is designed to capture a wide array of buyer-specific data such as contact information, shipping address, preferences, and any other relevant details that enhance the understanding of the buyer's profile and needs.
forward_affiliate_order_id
string
Nullable
The order ID for the forward journey of an affiliate shipment.
return_affiliate_order_id
string
Nullable
The order ID for the return journey of an affiliate shipment.
bag_weight
object
Nullable
This object is designed to accommodate a range of weight-related information. Denotes the weight of the bag, potentially including various measurements or related details.
refund_to
string
Nullable
Specifies the recipient of any refunds related to the shipment.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_shipment_id
string
The shipment ID specific to this affiliate.
company_affiliate_tag
string
Nullable
An optional tag representing the company's affiliate association.
affiliate_order_id
string
The order ID associated with the affiliate shipment.
pdf_links
object (PDFLinks)
PDFLinks
invoice_type
string
The type of invoice issued, such as 'fynd' or other classifications.
Enum
label_a6
string
Nullable
URL or path to the A6 size label document.
invoice
string
Nullable
URL or path to the main invoice document.
label_pos
string
Nullable
URL or path to the POS label document.
invoice_a6
string
Nullable
URL or path to the A6 size invoice document.
b2b
string
Nullable
URL or path to the B2B document related to the transaction.
label
string
Nullable
URL or path to the general label document.
label_a4
string
Nullable
URL or path to the A4 size label document.
label_type
string
Specifies the type of label associated with a PDF document,indicating its purpose or content. The label_type helps in organizing and identifying PDF documents quickly, ensuring that users or systems can efficiently utilize the correct documents for required actions.
Enum
invoice_export
string
Nullable
URL or path to the exported invoice document.
credit_note_url
string
Nullable
URL or path to the credit note document.
delivery_challan_a4
string
Nullable
URL or path to the A4 delivery challan document.
label_export
string
Nullable
URL or path to the exported label document.
invoice_a4
string
Nullable
URL or path to the A4 size invoice document.
invoice_pos
string
Nullable
URL or path to the POS invoice document.
po_invoice
string
Nullable
URL or path to the purchase order invoice document.
config
object (AffiliateConfig)
AffiliateConfig
app
object (AffiliateAppConfig)
AffiliateAppConfig
id
string
description
string
updated_at
string
| date-time
The date and time when the app config was updated.
name
string
token
string
meta
array of object (AffiliateAppConfigMeta)
Array of AffiliateAppConfigMeta
value
string
name
string
owner
string
secret
string
created_at
string
| date-time
Timestamp when the app config was created.
inventory
object (AffiliateInventoryConfig)
AffiliateInventoryConfig
article_assignment
object (AffiliateInventoryArticleAssignmentConfig)
AffiliateInventoryArticleAssignmentConfig
post_order_reassignment
boolean
payment
object (AffiliateInventoryPaymentConfig)
AffiliateInventoryPaymentConfig
source
string
mode_of_payment
string
inventory
object (AffiliateInventoryStoreConfig)
AffiliateInventoryStoreConfig
store
object
Fulfilling store information related to the shipment.
order
object (AffiliateInventoryOrderConfig)
AffiliateInventoryOrderConfig
force_reassignment
boolean
logistics
object (AffiliateInventoryLogisticsConfig)
AffiliateInventoryLogisticsConfig
dp_assignment
boolean
app_company_id
integer
Nullable
A unique identifier for the company associated with the affiliate app, used for tracking and managing affiliate relationships.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_id
string
Nullable
The unique identifier for the affiliate.
affiliate_store_id
string
The unique identifier for the affiliate's store.
affiliate_bag_id
string
The unique identifier for the affiliate's bag.
id
string
Nullable
The unique identifier for the affiliate.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
applied_promos
array of object
Nullable
A list of promotional discounts that were applied to the bag's contents.
article
object (Article)
Article
child_details
object
Nullable
Contains a flexible set of key-value pairs representing detailed information about the article's child entities, including dimensions (width, height, length), weight, and unique identifiers (EAN, article code, seller identifier) for each child entity.
seller_identifier
string
Unique identifier assigned by the seller to the article, used for inventory management.
uid
string
A unique identifier for the article within the system.
set
object
Nullable
Represents the data related to combinations of articles that, while being the same product, vary by size, color, or other distinguishing features.
dimensions
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
currency
object
Nullable
Currency in which the transaction amount associated with the article is specified.
esp_modified
boolean
Nullable
Indicates whether the article has been modified by the ESP (e-commerce service provider).
return_config
object (ReturnConfig)
Nullable
Configuration related to the return policy for the article.
ReturnConfig
returnable
boolean
Nullable
Flag indicating whether product is returnable or not
time
number
Nullable
Number indicating number of hours or days
unit
string
Nullable
String indicating the unit of the time, eg. days, hours
code
string
Nullable
A unique alphanumeric identifier assigned to a specific article for inventory and tracking purposes
weight
object (Weight)
Weight
is_default
boolean
Nullable
Whether the weight is the default one or not
shipping
integer
Nullable
The shipping weight of the product
unit
string
Nullable
The unit of weight
_id
string
DB generated ID of the article
identifiers
object
Product identifiers
raw_meta
string
Nullable
Raw meta data of the article
size
string
The physical dimensions or specifications of the article, indicating its size or measurements
is_set
boolean
Nullable
A boolean indicating whether the article is a set
tags
array of string
Nullable
Tags associated with the article
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
article_details
object (ArticleStatusDetails)
ArticleStatusDetails
status
object
Nullable
Captures comprehensive status information for an article. Each status type, such as 'cancelled_fynd', contains objects keyed by unique identifiers (UIDs). These objects detail the specific status, including associated bag IDs with their quantities, total quantity affected, and reasons for the status if applicable. This structure allows for tracking multiple status conditions and their details for a single article.
bag_status
array of object (BagStatusHistory)
An array of current status records associated with the bag, reflecting its lifecycle stages (e.g., pending, placed, delivered).
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
bag_status_history
array of object (BagStatusHistory)
An array of current status records associated with the bag, reflecting its lifecycle stages (e.g., pending, placed, delivered).
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
brand
object (Brand)
Brand
credit_note_expiry_days
integer
Nullable
logo
string
Nullable
invoice_prefix
string
Nullable
credit_note_allowed
boolean
Nullable
start_date
string
| date-time
Nullable
Denotes the start date and time when the brand was created.
company
string
Nullable
is_virtual_invoice
boolean
Nullable
script_last_ran
string
Nullable
pickup_location
string
Nullable
created_on
string
| date-time
Nullable
Timestamp when the brand was created.
brand_name
string
brand_id
integer
modified_on
string
| date-time
Nullable
Timestamp when the brand of the order was modified.
id
integer
Nullable
company
object (Company)
Company
pan_no
string
Nullable
created_on
string
| date-time
Nullable
Timestamp when the company was created.
id
integer
Nullable
company_name
string
Nullable
gst_number
string
Nullable
company_type
string
Nullable
The type of company, which can be one of the following:
- `distributor`: Distributor
- `franchise`: Franchise
- `mbo`: MBO (Managed Business Operations)
- `manufacturer-owner`: Owner/Manufacturer
Enum
modified_on
string
| date-time
Nullable
Timestamp when the company was modified.
meta
object
Nullable
Meta data of the company contains additional, potentially dynamic information about the company.
business_type
string
Nullable
The type of business structure, which can be one of the following:
- `Private`: Private Limited Company
- `LLP/Partnership`: Limited Liability Partnership or Partnership
- `HUF/Proprietorship`: Hindu Undivided Family or Proprietorship.
agreement_start_date
string
| date-time
Nullable
Specifies the official beginning date and time of an agreement or contract associated with the company.
current_operational_status
object (BagStatusHistory)
BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
current_status
object (BagStatusHistory)
BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
dates
object (Dates)
Dates
delivery_date
string
| date-time
Nullable
Represents the scheduled date and time for the delivery of the entity.
order_created
string
Nullable
delivery_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
delivery_slot
object (DeliverySlotDetails)
Nullable
DeliverySlotDetails
slot
string
Nullable
upper_bound
string
Nullable
lower_bound
string
Nullable
date
string
Nullable
type
string
Nullable
display_name
string
Nullable
Name of the bag intended for user display.
dp_details
object
Nullable
Additional information about the delivery partner (DP) handling the bag.
einvoice_info
object
Nullable
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
fallback_user
object
Nullable
Details of the fallback user associated with the bag .
financial_breakup
array of object (FinancialBreakup)
A breakdown of the financial aspects associated with the bag, such as product prices, taxes, discounts, and total cost.
Array of FinancialBreakup
refund_credit
number
Refund credits provided to the customer
amount_paid_roundoff
integer
Nullable
Amount paid rounded off
price_effective
number
MRP - Initial Seller provided discount
promotion_effective_discount
number
Effective promotion discount including promotions given by seller and Platform
transfer_price
number
article
coupon_effective_discount
number
Coupon provided by brand or seller
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
tax_collected_at_source
number
Nullable
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Price Effective - Coupon Discount (Seller) - Promotion (Seller)
delivery_charge
number
The fee associated with the delivery service for transporting the item to its destination
gst_tag
string
Type of GST applied - IGST, CGST, SGST
hsn_code
string
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
cashback
number
Cashback points
item_name
string
The name of the item being referenced
value_of_good
number
Effective selling price - Product GST Amount
cashback_applied
number
Cashback applied on the order
cod_charges
number
The fee associated with the COD order
price_marked
number
The indicated price or value assigned to an item before any discounts or adjustments
size
string
The physical dimensions or specifications of the item, indicating its size or measurements
amount_paid
number
Amount paid by the customer
coupon_value
number
Stores the coupon value as shown in the cart
discount
number
The total amount discounted from the original MRP/actual price
fynd_credits
number
Credits provided by Fynd
gst_tax_percentage
number
The percentage rate of GST applied to a product or service
amount_to_be_collected
number
Amount to be collected in case of multiple modes of payments.
identifiers
object (Identifier)
Identifier
alu
string
Nullable
The ALU (Article Level Unit) code used to identify the item at a detailed level, often specific to certain retail or distribution systems.
ean
string
Nullable
The European Article Number (EAN) is a unique identifier for products, primarily used in retail and logistics. It helps in tracking and managing inventory across various platforms.
sku_code
string
Nullable
The Stock Keeping Unit (SKU) code of the item - uniquely identifies each distinct product. SKUs are used to track inventory levels, facilitate accurate stocktaking, and streamline order fulfillment processes. This code is essential for inventory management, allowing for the differentiation between products based on attributes such as price, color, and size.
upc
string
Nullable
The Universal Product Code (UPC) is a barcode symbol used for tracking trade items in stores. It is widely used in North America and helps in identifying products quickly during point-of-sale transactions.
isbn
string
Nullable
The International Standard Book Number (ISBN) is a unique identifier for books, allowing for easier management and tracking of book inventories in retail and library systems.
total_units
integer
Total number of units of the item
added_to_fynd_cash
boolean
Flag indicating whether fynd cash has been used
refund_amount
number
tcs_percentage
number
fulfilling_store
object (Store)
Nullable
Store
phone
string
is_active
boolean
Nullable
company_id
integer
alohomora_user_id
integer
Nullable
created_at
string
| date-time
Denotes the date and time when the store was created.
contact_person
string
store_email
string
is_enabled_for_recon
boolean
Nullable
pincode
string
mall_area
string
Nullable
vat_no
string
Nullable
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
store_active_from
string
Nullable
city
string
name
string
longitude
number
Nullable
brand_store_tags
array of string
Nullable
order_integration_id
string
Nullable
parent_store_id
integer
Nullable
location_type
string
Type of location of the fulfilling store.
Enum
code
string
Nullable
fulfillment_channel
string
updated_at
string
| date-time
Nullable
Denotes the date and time when any modifications were made to the store.
store_address_json
object (StoreAddress)
StoreAddress
phone
string
created_at
string
| date-time
Denotes the date and time when the transition of the store address was created.
contact_person
string
pincode
integer
address_type
string
The type of the address (e.g., home, office).
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
version
string
Nullable
address_category
string
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy.
Enum
city
string
longitude
number
address2
string
area
string
Nullable
email
string
Nullable
updated_at
string
| date-time
Denotes the date and time when any modifications were made to the store.
country_code
string
Uniquely identifies the country of the store addressds_type using the two-character standard ISO 3166-1 alpha-2 country codes. Examples include 'US' for the United States and 'IN' for India.
country
string
landmark
string
latitude
number
state
string
meta
object (StoreMeta)
StoreMeta
additional_contact_details
object
Nullable
Provides a flexible structure for storing extra contact information related to the store.
timing
array of object
Nullable
notification_emails
array of string
Nullable
gst_number
string
Nullable
ewaybill_portal_details
object
Nullable
Contains essential information and settings related to the e-Way Bill portal, which is used for generating and managing e-waybills for the transportation of goods under specific tax regulations.
einvoice_portal_details
object (EInvoicePortalDetails)
EInvoicePortalDetails
username
string
Nullable
user
string
Nullable
password
string
Nullable
gst_credentials
object (StoreGstCredentials)
StoreGstCredentials
e_invoice
object (StoreEinvoice)
StoreEinvoice
username
string
Nullable
user
string
Nullable
password
string
Nullable
enabled
boolean
e_waybill
object (StoreEwaybill)
StoreEwaybill
enabled
boolean
Nullable
stage
string
product_return_config
object
Nullable
Product return configuration details for the location. It can include details like on_same_store denoting whether return can be initiated at the same store.
documents
object (StoreDocuments)
StoreDocuments
gst
object (Document)
Document
value
string
type
string
Type of the document.
verified
boolean
legal_name
string
url
string
Nullable
display_name
string
s_id
string
Nullable
state
string
country
string
packaging_material_count
integer
Nullable
is_archived
boolean
Nullable
login_username
string
Nullable
mall_name
string
Nullable
latitude
number
Nullable
address2
string
Nullable
fyndstore_emp
object
Nullable
Fynd store employee details.
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
invoice
object (InvoiceDetails)
Nullable
InvoiceDetails
updated_date
string
| date-time
Nullable
Specifies the date and time when the invoice was last updated.
store_invoice_id
string
Nullable
invoice_url
string
Nullable
label_url
string
Nullable
item
object (Item)
Item
attributes
object (Attributes)
A dictionary of product attributes
Attributes
primary_material
string
Nullable
essential
string
Nullable
marketer_name
string
Nullable
primary_color
string
Nullable
marketer_address
string
Nullable
primary_color_hex
string
Nullable
brand_name
string
Nullable
name
string
Nullable
gender
array of string
Nullable
brand_id
integer
slug_key
string
webstore_product_url
string
Nullable
l3_category
integer
Nullable
Represents the product's classification at the third level in the e-commerce platform's category hierarchy, using an integer identifier. This finer level of categorization allows for precise product organization and easier navigation for customers seeking specific items.
l3_category_name
string
Nullable
This key specifies the name of the third-level category under which the product is listed, offering a more detailed classification within the e-commerce platform's hierarchy.
last_updated_at
string
| date-time
Nullable
Denotes the date and time when the item was updated.
name
string
l2_category
array of string
Nullable
The l2_category field represents the second level of categorization for items within an e-commerce platform's hierarchy. This allows for classification beyond the top-tier (level 1) categories, helping customers to narrow down their search and find products
brand
string
image
array of string
code
string
Nullable
l1_category_id
integer
Nullable
The unique identifier of the defines the top-tier categories to which a product belongs within the e-commerce platform's hierarchy.
item_id
integer
l1_category
array of string
Nullable
This array defines the top-tier categories to which a product belongs within the e-commerce platform's hierarchy.
gender
string
Nullable
can_cancel
boolean
Nullable
can_return
boolean
Nullable
size
string
branch_url
string
Nullable
meta
object
Nullable
Meta data of the item contains additional, potentially dynamic information about the item.
color
string
Nullable
department_id
integer
Nullable
l2_category_id
integer
Nullable
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
line_number
integer
A unique identifying number associated with the bag. It is generated sequentially as bags are created.
lock_status
boolean
Nullable
Indicates whether the bag is locked from further changes (true/false). A locked bag cannot undergo modifications until unlocked.
manifest_id
string
Nullable
The identifier-assigned bags receive after they are manifest (thereby creating a shipment in conjunction with the allocated manifest).
meta
object
Meta data of the bag details contains additional, potentially dynamic information about the bag details.
mode_of_payment
string
Nullable
This field reflects the payment method used in the transaction for a particular bag.
no_of_bags_order
integer
Nullable
The total number of bags in this bag's order.
operational_status
string
Nullable
The particular state a bag occupies in the shipment life-cycle.
order
object (OrderDetails)
OrderDetails
fynd_order_id
string
created_at
string
Date and time when the order was created.
user_id
string
Nullable
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
mongo_cart_id
number
Nullable
delivery_charges
number
Nullable
transaction_id
string
Nullable
collect_by
string
headers
object
Nullable
Header details of the order.
coupon_value
number
Nullable
order_value
number
created_time
string
currency
string
The currency in which the prices details associated with the item is specified.
total_order_value
number
ordering_channel
string
meta
object
Nullable
Meta data of the order data contains additional, potentially dynamic information about the order data.
cod_charges
number
Nullable
cashback_value
number
Nullable
refund_by
string
affiliate_order_date
string
| date-time
Nullable
Specifies the date and time of the order when it was created within the affiliate's system. It specifies that the date and time are recorded in ISO 8601 format.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
affiliate_order_id
string
payment_mode_id
number
Nullable
promotion_effective_discount
number
Nullable
mode_of_payment
string
discount
number
Nullable
cashback_applied
number
Nullable
fynd_credits
number
Nullable
affiliate_id
string
ordering_channel_logo
string
Nullable
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
order_integration_id
string
Nullable
A unique identifier used for integrating this order with external systems or services.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
order_value
number
Nullable
An estimated value of the order at the time of placement or sale.
ordering_store
object (Store)
Nullable
Store
phone
string
is_active
boolean
Nullable
company_id
integer
alohomora_user_id
integer
Nullable
created_at
string
| date-time
Denotes the date and time when the store was created.
contact_person
string
store_email
string
is_enabled_for_recon
boolean
Nullable
pincode
string
mall_area
string
Nullable
vat_no
string
Nullable
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
store_active_from
string
Nullable
city
string
name
string
longitude
number
Nullable
brand_store_tags
array of string
Nullable
order_integration_id
string
Nullable
parent_store_id
integer
Nullable
location_type
string
Type of location of the fulfilling store.
Enum
code
string
Nullable
fulfillment_channel
string
updated_at
string
| date-time
Nullable
Denotes the date and time when any modifications were made to the store.
store_address_json
object (StoreAddress)
StoreAddress
phone
string
created_at
string
| date-time
Denotes the date and time when the transition of the store address was created.
contact_person
string
pincode
integer
address_type
string
The type of the address (e.g., home, office).
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
version
string
Nullable
address_category
string
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy.
Enum
city
string
longitude
number
address2
string
area
string
Nullable
email
string
Nullable
updated_at
string
| date-time
Denotes the date and time when any modifications were made to the store.
country_code
string
Uniquely identifies the country of the store addressds_type using the two-character standard ISO 3166-1 alpha-2 country codes. Examples include 'US' for the United States and 'IN' for India.
country
string
landmark
string
latitude
number
state
string
meta
object (StoreMeta)
StoreMeta
additional_contact_details
object
Nullable
Provides a flexible structure for storing extra contact information related to the store.
timing
array of object
Nullable
notification_emails
array of string
Nullable
gst_number
string
Nullable
ewaybill_portal_details
object
Nullable
Contains essential information and settings related to the e-Way Bill portal, which is used for generating and managing e-waybills for the transportation of goods under specific tax regulations.
einvoice_portal_details
object (EInvoicePortalDetails)
EInvoicePortalDetails
username
string
Nullable
user
string
Nullable
password
string
Nullable
gst_credentials
object (StoreGstCredentials)
StoreGstCredentials
e_invoice
object (StoreEinvoice)
StoreEinvoice
username
string
Nullable
user
string
Nullable
password
string
Nullable
enabled
boolean
e_waybill
object (StoreEwaybill)
StoreEwaybill
enabled
boolean
Nullable
stage
string
product_return_config
object
Nullable
Product return configuration details for the location. It can include details like on_same_store denoting whether return can be initiated at the same store.
documents
object (StoreDocuments)
StoreDocuments
gst
object (Document)
Document
value
string
type
string
Type of the document.
verified
boolean
legal_name
string
url
string
Nullable
display_name
string
s_id
string
Nullable
state
string
country
string
packaging_material_count
integer
Nullable
is_archived
boolean
Nullable
login_username
string
Nullable
mall_name
string
Nullable
latitude
number
Nullable
address2
string
Nullable
parent_promo_bags
object
Nullable
An object containing details of parent promotional bags.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_type
string
Nullable
The Specific type of payment.
Enum
payments
object
Nullable
Defines allowed payment details for the item.
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Defines any additional charges for the product.
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
qc_required
boolean
Nullable
Indicates whether quality check is required for the product.
quantity
number
Nullable
The quantity of the product.
reasons
array of object
Nullable
Information about why the Bag's item/products are being cancelled or returned or exchanged. This keys within this object represent unique
restore_coupon
boolean
Nullable
Indicates whether voucher/wallet points can be reapplied to the product.
restore_promos
object
Nullable
Provides a flexible structure for storing information about promotion details or offers that are eligible for restoration. This can include details such as promo codes, descriptions of the offers, eligibility criteria, restoration conditions, and any other relevant data that supports the reactivation of previously paused or expired promotions.
rto_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
seller_identifier
string
Nullable
A unique identifier assigned by the seller to represent a specific transaction in their order processing system.
shipment
object (Shipment)
Shipment
line_items
array of object (LineItem)
An array of LineItem objects that represent the items included in the shipment.
Array of LineItem
charges
array of object (Charge)
These are the mandatory charges required during order creation and are integral to the order processing flow. They include fields like amount_paid, discount, and price_marked. The schema for these charges is predefined and remains consistent, ensuring seamless forward mapping in the code.
Array of Charge
name
string
The name of the charge that indicates its purpose.
amount
object (AmountSchema)
AmountSchema
ordering_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
tax
object (Tax)
Tax
name
string
The name of the tax, indicating its purpose (e.g., VAT, sales tax).
rate
number
| float
The tax rate as a decimal, applied to the transaction amount.
breakup
array of object
An array of objects detailing the components or breakdown of the tax applied.
amount
object (AmountSchema)
AmountSchema
ordering_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
code
string
An optional code associated with the charge for internal tracking.
type
string
The category or type of the charge.
meta
object
An object containing metadata relevant to articles or line items.
custom_message
string
A string for any special instructions or messages related to the line item.
quantity
integer
| int32
Quantity of the articles or line items.
seller_identifier
string
Unique identifier of the articles or line items set by seller.
external_line_id
string
External unique identifier of the articles or line items.
dynamic_charges
array of object (DynamicChargeSchema)
(Optional) These are additional charges specified by the client based on specific use cases. They allow for flexibility in adding new fields such as installation_fee, service_charge, or other dynamic costs.
Array of DynamicChargeSchema
name
string
The name of the charge.
type
string
The category or type of the charge.
code
string
An optional code associated with the charge for internal tracking.
amount
object (AmountSchema)
AmountSchema
ordering_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
taxes
object (DynamicChargeTaxSchema)
DynamicChargeTaxSchema
reporting_hsn_code
string
HSN (Harmonized System of Nomenclature) code for reporting purposes.
meta
object
Meta data of the custom charge.
distribution_logic
object (DistributionLogicSchema)
DistributionLogicSchema
distribution_level
string
The level at which the charge is distributed (order, article, shipment).
Enum
distribution
object (DistributionSchema)
DistributionSchema
type
string
Type of distribution (single or multi).
Enum
logic
string
Logic for distribution (apportion, equally).
Enum
rule
object (RuleSchema)
RuleSchema
conditions
object (RuleConditionsSchema)
RuleConditionsSchema
article_tag
string
The tag for the article.
department
array of string
List of applicable departments.
external_shipment_id
string
External shipment identifier or marketplace's unique shipment identifier.
external_location_id
string
processing_dates
object (ProcessingDates)
ProcessingDates
dp_pickup_slot
object
An object that provides details about the designated pickup time slot for the order.
dispatch_after_date
string
A string indicating the date after which the order will be dispatched.
dispatch_by_date
string
A string representing the latest date by which the order must be dispatched to meet delivery expectations.
confirm_by_date
string
A string that indicates the deadline for the merchant to confirm the order.
customer_pickup_slot
object
An object that provides details of the pick-up time slot set by the customer.
pack_by_date
string
| date-time
Defines the deadline for having the package fully packed and ready for dispatch or pickup, integral to streamlining the fulfillment process.
meta
object
Nullable
Meta data of the shipment contains additional, potentially dynamic information about the shipment.
priority
integer
| int32
An integer indicating the priority level of the shipment.
location_id
integer
| int32
Location Identifier or Store/Fulfillment Identifier of the shipment- This field is mandatory when optimal_shipment_creation flag is set to false, indicating that shipments must be associated with a specific location. When `optimal_shipment_creation` is true, the optimal location for order creation would be assigned, location_id becomes optional.
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order undergoes all state transitions typical for a delivery, from processing the shipment to final delivery at the customer's address.
- "PickAtStore": The order is prepared for pickup and moved to a state where it is ready to be handed over directly to the customer at the store. This type streamlines the process by bypassing traditional shipping stages and facilitating a quicker transition to the final handover stage.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
tags
array of object (Tag)
Nullable
Array of Tag
slug
string
A unique identifier or short label for the tag for shipment reference.
display_text
string
Label of the tag. This text is shown to users, representing the tag in an human-readable format.
system_messages
array of object (SystemMessages)
Array of SystemMessages
message_type
string
Specifies the type of message.
Enum
priority
number
This will determine the sequence of messages (1 being the highest priority).
message
string
Message to be displayed at Platform's Order Details.
inject_at
array of string
Holds the list of OMS status at which the message should be visible.
process_after_config
object (ProcessAfterConfig)
ProcessAfterConfig
is_scheduled_shipment
boolean
Indicates whether the shipment is scheduled for later processing.
enable_processing_after
string
| date-time
Specifies the UTC time after which the shipment will be automatically processed.
parent_type
string
Nullable
store_invoice_id
string
Nullable
lock_status
string
Nullable
type
string
Nullable
billing_address_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
id
string
fulfilment_priority
integer
Nullable
is_active
boolean
previous_shipment_id
string
Nullable
pdf_links
object
Nullable
PDF Links associated with the shipment.
delivery_address_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
eway_bill_id
string
Nullable
affiliate_shipment_id
string
Nullable
fynd_order_id
string
created_at
string
| date-time
Specifies the date and time when the shipment was created.
delivery_awb_number
string
Nullable
hand_over_contact_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
credit_note_id
string
Nullable
parent_id
string
Nullable
affiliate_id
string
packaging_type
string
Nullable
Defines the type of packaging used for the product, encompassing materials, design, and form factors.
vertical
string
Nullable
quantity
number
Nullable
status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
price
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
gst
object (ShipmentGstDetails)
Nullable
ShipmentGstDetails
value_of_good
number
Nullable
gst_fee
number
Nullable
brand_calculated_amount
number
Nullable
tax_collected_at_source
number
Nullable
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
shipment_details
object (ShipmentDetails)
Nullable
ShipmentDetails
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
shipments
integer
| int32
fulfillment_id
integer
| int32
articles
array of object (ArticleDetails)
Array of ArticleDetails
_id
string
A unique identifier for the article, facilitating easy reference and management within the system.
brand_id
integer
| int32
Numerical code representing the brand associated with the article, linking it to its manufacturer or creator.
dimension
object
Specifies the physical dimensions of the article, including height, width, and depth, providing a comprehensive understanding of its size.
category
object
Classifies the article into a specific category or type, aiding in organization and filtering based on its nature or usecase.
weight
object
Details the weight of the article, crucial for logistics, shipping calculations, and customer information.
attributes
object
Holds additional descriptive details and characteristics of the article, such as color, material, and style, enhancing product understanding.
quantity
integer
| int32
Specifies the available or required quantity of the article, important for inventory management and order fulfillment.
dp_id
string
| int32
Nullable
meta
object
affiliate_shipment_id
string
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
lock_status
boolean
Nullable
action_to_status
object
Nullable
This field maps potential actions (e.g., downloading an invoice or label) to their corresponding shipment lock statuses, indicating which operations are allowed depending on the shipment's current lock status. When an action is set to 'lock', it means no transitions or updates to the shipment's status can be performed until the specified action is completed. For instance, if 'download_invoice' is in a 'lock' state, the shipment cannot undergo any status transitions until the invoice is either downloaded. Similarly, 'download_label' being in a 'lock' state prevents any shipment status transitions until a new label is downloaded.
shipment_id
string
Nullable
Unique identifier of the shipment.
shipment_gst
object (ShipmentGstDetails)
Nullable
ShipmentGstDetails
value_of_good
number
Nullable
gst_fee
number
Nullable
brand_calculated_amount
number
Nullable
tax_collected_at_source
number
Nullable
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
shipment_status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
shipment_status_history
array of object (ShipmentStatusData)
Nullable
Status history of the shipment item in the order.
Array of ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
status
object (BagReturnableCancelableStatus)
BagReturnableCancelableStatus
is_returnable
boolean
Indicates whether the bag can be returned by the customer.
is_active
boolean
Specifies if the current status of the bag is active, affecting its eligibility for return or cancellation.
can_be_cancelled
boolean
Indicates if the bag order can be cancelled by the customer.
enable_tracking
boolean
Indicates whether tracking is enabled for the bag, allowing customers to monitor its status.
is_customer_return_allowed
boolean
Specifies if the customer is permitted to return the bag, based on the return policy.
tags
array of string
Nullable
A list of tags or labels associated with the bag, which might be used for filtering, sorting, or categorizing purposes.
total_shipment_bags
integer
Nullable
The total number of shipped bags.
total_shipments_in_order
integer
Nullable
The total number of shipments in the order.
transaction_type
string
Nullable
Specifies the type of the transaction being processed. This classification helps in distinguishing between different operational processes and allows for tailored handling of each transaction type. For example, a 'shipment' transaction type refers to operations related to the shipping of goods.
Enum
type
string
Nullable
The type of the bag.
updated_at
string
| date-time
Nullable
The date and time when the bag was last updated.
user
object (UserDetails)
Nullable
UserDetails
user_oid
string
Nullable
external_customer_id
string
Nullable
first_name
string
Nullable
last_name
string
Nullable
mobile
string
Nullable
email
string
Nullable
is_anonymous_user
boolean
Nullable
gender
string
Nullable
mongo_user_id
string
Nullable
meta
object
Nullable
Meta data of the user details contains additional, potentially dynamic information about the user details.
weight
object (WeightData)
Nullable
WeightData
value
number
Nullable
unit
string
Nullable
original_bag_list
array of integer
Nullable
Specifies the list of integers that specify the bag number
identifier
string
Nullable
The unique identifier for the bag.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
company_id:
528
bag_id:
"6393"
channel_bag_id:
"6393"
channel_id:
"653b8403127195717572efb0"
Was this section helpful?
GET
Response
Get bag by ID.
getBagById
Parameters
company_id
integer
Required
Id of company
bag_ids
string
Comma separated values of bag ids
shipment_ids
string
Comma separated values of shipment ids
order_ids
string
Comma separated values of order ids
channel_bag_ids
string
Comma separated values of app bag ids
channel_shipment_ids
string
Comma separated values of app shipment ids
channel_order_ids
string
Comma separated values of app order ids
channel_id
string
Comma separated values of app ids
page_no
integer
Page number for paginated data
page_size
integer
Page size of data received per page
Response
200
Successfully retrived all the given shipments details!
GetBagsPlatformResponseSchema
status_code
integer
Response status_code.
Enum
data
object (BagData)
Nullable
BagData
items
array of object (BagDetails)
Array of BagDetails
bag_update_time
number
Nullable
The timestamp indicating when the bag's information was last updated
id
string
Nullable
A unique identifier for the bag record within the system.
bag_id
integer
Nullable
A unique identifier specifically for the bag itself, used for tracking purposes.
affiliate_bag_details
object (AffiliateBagDetails)
AffiliateBagDetails
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_order_id
string
Unique identifier for the affiliate order associated with the bag.
employee_discount
number
Nullable
Discount percentage or amount applicable to employees for this order.
affiliate_bag_id
string
Unique identifier for the affiliate bag, used for tracking and reference.
loyalty_discount
number
Nullable
Discount amount applied based on customer loyalty, if applicable.
affiliate_details
object (AffiliateDetails)
AffiliateDetails
shipment_meta
object (ShipmentMeta)
ShipmentMeta
tracking_url
string
Nullable
A URL for tracking the shipment.
estimated_delivery_date
string
| date-time
Nullable
Provides a forecasted date and time by which the shipment is expected to be delivered to the recipient. This estimation is crucial for planning purposes, both for the sender in managing expectations and for the recipient in preparing for receipt.
same_store_available
boolean
Indicates whether the shipment is available for pickup from the same store.
b2b_buyer_details
object (BuyerDetails)
BuyerDetails
ajio_site_id
string
Nullable
The unique identifier for the buyer on the Ajio platform.
pincode
integer
The postal code for the buyer's shipping address, used for delivery location identification.
address
string
Provides the comprehensive address details of the buyer's shipping address.
gstin
string
The Goods and Services Tax Identification Number (GSTIN) of the buyer.
name
string
The full name of the buyer, essential for personalizing communication and delivery.
state
string
The name of the state where the buyer's shipping address is located, important for logistical purposes.
city
string
The name of the city where the buyer's shipping address is located, which helps in identifying delivery zones.
formatted
object (Formatted)
Formatted
max
string
Nullable
Represents the maximum formatted value, providing a limit for the associated data, such as dimensions or weights.
min
string
Nullable
Represents the minimum formatted value, establishing a lower limit for the associated data, ensuring it meets certain criteria or standards.
debug_info
object (DebugInfo)
DebugInfo
stormbreaker_uuid
string
Nullable
A unique identifier (UUID) associated with the Stormbreaker system, used for tracking and debugging purposes in the application.
return_awb_number
string
Nullable
The Air Waybill (AWB) number associated with a return shipment.
is_self_ship
boolean
Nullable
Indicates whether the shipment is a self-shipped order.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
einvoice_info
object (EinvoiceInfo)
EinvoiceInfo
credit_note
object
Nullable
Specifies the reverse einvoice transaction create on government portal.
invoice
object
Nullable
It specifies the forward einvoice transaction created on government portal.
return_affiliate_shipment_id
string
Nullable
The shipment ID associated with a return from an affiliate.
parent_dp_id
string
Nullable
The unique identifier for the parent delivery partner.
shipment_weight
number
Nullable
The total weight of the shipment.
dimension
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
assign_dp_from_sb
boolean
Nullable
Indicates whether to assign the delivery partner from the store’s basket.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
store_invoice_updated_date
string
| date-time
Nullable
Denotes the date and time when the store's invoice related to this shipment was updated. This timestamp is vital for tracking changes to billing details, adjustments in charges, or updates in the invoicing status.
forward_affiliate_shipment_id
string
Nullable
The shipment ID for the forward journey of an affiliate shipment.
return_store_node
integer
Nullable
The identifier for the store node involved in the return process.
fulfilment_priority_text
string
Nullable
Textual representation of the fulfillment priority for the shipment.
shipment_tags
array of object (ShipmentTags)
Tags associated with the shipment for categorization and filtering.
Array of ShipmentTags
slug
string
Nullable
A URL-friendly string representing the tag, often used for routing or categorization.
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
display_text
string
Nullable
A human-readable text representation of the tag, used for display purposes in user interfaces.
external
object
Nullable
External metadata related to the shipment.
awb_number
string
Nullable
The Air Waybill number associated with the shipment.
lock_data
object (LockData)
LockData
locked
boolean
Nullable
Indicates whether the shipment is currently locked for processing (true) or not (false).
mto
boolean
Nullable
A flag indicating whether the shipment is part of a multi-modal transport operation.
lock_message
string
Nullable
An optional message providing additional context or information regarding the lock status.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow.
Enum
ewaybill_info
object
Nullable
Electronic Way Bill details i.e ewayBillNo, ewayBillDate that are utilized in the transportation of goods.
dp_id
string
Nullable
The unique identifier for the delivery partner associated with the shipment.
shipment_volumetric_weight
number
Nullable
The volumetric weight of the shipment, which may differ from its actual weight.
marketplace_store_id
string
Nullable
The unique identifier for the marketplace store associated with the shipment.
return_details
object
Nullable
An object containing the return details of the shipment.
dp_sort_key
string
Nullable
A sort key for the delivery partner, used for prioritization.
packaging_name
string
Nullable
The name of the packaging used for the shipment.
timestamp
object (ShipmentTimeStamp)
ShipmentTimeStamp
max
integer
Nullable
Represents the maximum timestamp value, indicating the latest time relevant to the shipment.
min
integer
Nullable
Represents the minimum timestamp value, indicating the earliest time relevant to the shipment.
auto_trigger_dp_assignment_acf
boolean
Nullable
Indicates whether automatic delivery partner assignment is triggered for this shipment.
dp_name
string
Nullable
The name of the delivery partner associated with the shipment.
po_number
string
Nullable
The purchase order number associated with the shipment.
weight
integer
The weight of the shipment, typically measured in grams or kilograms.
b2c_buyer_details
object
Nullable
Contains detailed information about the buyer in a business-to-consumer (B2C) transaction. This object is designed to capture a wide array of buyer-specific data such as contact information, shipping address, preferences, and any other relevant details that enhance the understanding of the buyer's profile and needs.
forward_affiliate_order_id
string
Nullable
The order ID for the forward journey of an affiliate shipment.
return_affiliate_order_id
string
Nullable
The order ID for the return journey of an affiliate shipment.
bag_weight
object
Nullable
This object is designed to accommodate a range of weight-related information. Denotes the weight of the bag, potentially including various measurements or related details.
refund_to
string
Nullable
Specifies the recipient of any refunds related to the shipment.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_shipment_id
string
The shipment ID specific to this affiliate.
company_affiliate_tag
string
Nullable
An optional tag representing the company's affiliate association.
affiliate_order_id
string
The order ID associated with the affiliate shipment.
pdf_links
object (PDFLinks)
PDFLinks
invoice_type
string
The type of invoice issued, such as 'fynd' or other classifications.
Enum
label_a6
string
Nullable
URL or path to the A6 size label document.
invoice
string
Nullable
URL or path to the main invoice document.
label_pos
string
Nullable
URL or path to the POS label document.
invoice_a6
string
Nullable
URL or path to the A6 size invoice document.
b2b
string
Nullable
URL or path to the B2B document related to the transaction.
label
string
Nullable
URL or path to the general label document.
label_a4
string
Nullable
URL or path to the A4 size label document.
label_type
string
Specifies the type of label associated with a PDF document,indicating its purpose or content. The label_type helps in organizing and identifying PDF documents quickly, ensuring that users or systems can efficiently utilize the correct documents for required actions.
Enum
invoice_export
string
Nullable
URL or path to the exported invoice document.
credit_note_url
string
Nullable
URL or path to the credit note document.
delivery_challan_a4
string
Nullable
URL or path to the A4 delivery challan document.
label_export
string
Nullable
URL or path to the exported label document.
invoice_a4
string
Nullable
URL or path to the A4 size invoice document.
invoice_pos
string
Nullable
URL or path to the POS invoice document.
po_invoice
string
Nullable
URL or path to the purchase order invoice document.
config
object (AffiliateConfig)
AffiliateConfig
app
object (AffiliateAppConfig)
AffiliateAppConfig
id
string
description
string
updated_at
string
| date-time
The date and time when the app config was updated.
name
string
token
string
meta
array of object (AffiliateAppConfigMeta)
Array of AffiliateAppConfigMeta
value
string
name
string
owner
string
secret
string
created_at
string
| date-time
Timestamp when the app config was created.
inventory
object (AffiliateInventoryConfig)
AffiliateInventoryConfig
article_assignment
object (AffiliateInventoryArticleAssignmentConfig)
AffiliateInventoryArticleAssignmentConfig
post_order_reassignment
boolean
payment
object (AffiliateInventoryPaymentConfig)
AffiliateInventoryPaymentConfig
source
string
mode_of_payment
string
inventory
object (AffiliateInventoryStoreConfig)
AffiliateInventoryStoreConfig
store
object
Fulfilling store information related to the shipment.
order
object (AffiliateInventoryOrderConfig)
AffiliateInventoryOrderConfig
force_reassignment
boolean
logistics
object (AffiliateInventoryLogisticsConfig)
AffiliateInventoryLogisticsConfig
dp_assignment
boolean
app_company_id
integer
Nullable
A unique identifier for the company associated with the affiliate app, used for tracking and managing affiliate relationships.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_id
string
Nullable
The unique identifier for the affiliate.
affiliate_store_id
string
The unique identifier for the affiliate's store.
affiliate_bag_id
string
The unique identifier for the affiliate's bag.
id
string
Nullable
The unique identifier for the affiliate.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
applied_promos
array of object
Nullable
A list of promotional discounts that were applied to the bag's contents.
article
object (Article)
Article
child_details
object
Nullable
Contains a flexible set of key-value pairs representing detailed information about the article's child entities, including dimensions (width, height, length), weight, and unique identifiers (EAN, article code, seller identifier) for each child entity.
seller_identifier
string
Unique identifier assigned by the seller to the article, used for inventory management.
uid
string
A unique identifier for the article within the system.
set
object
Nullable
Represents the data related to combinations of articles that, while being the same product, vary by size, color, or other distinguishing features.
dimensions
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
currency
object
Nullable
Currency in which the transaction amount associated with the article is specified.
esp_modified
boolean
Nullable
Indicates whether the article has been modified by the ESP (e-commerce service provider).
return_config
object (ReturnConfig)
Nullable
Configuration related to the return policy for the article.
ReturnConfig
returnable
boolean
Nullable
Flag indicating whether product is returnable or not
time
number
Nullable
Number indicating number of hours or days
unit
string
Nullable
String indicating the unit of the time, eg. days, hours
code
string
Nullable
A unique alphanumeric identifier assigned to a specific article for inventory and tracking purposes
weight
object (Weight)
Weight
is_default
boolean
Nullable
Whether the weight is the default one or not
shipping
integer
Nullable
The shipping weight of the product
unit
string
Nullable
The unit of weight
_id
string
DB generated ID of the article
identifiers
object
Product identifiers
raw_meta
string
Nullable
Raw meta data of the article
size
string
The physical dimensions or specifications of the article, indicating its size or measurements
is_set
boolean
Nullable
A boolean indicating whether the article is a set
tags
array of string
Nullable
Tags associated with the article
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
article_details
object (ArticleStatusDetails)
ArticleStatusDetails
status
object
Nullable
Captures comprehensive status information for an article. Each status type, such as 'cancelled_fynd', contains objects keyed by unique identifiers (UIDs). These objects detail the specific status, including associated bag IDs with their quantities, total quantity affected, and reasons for the status if applicable. This structure allows for tracking multiple status conditions and their details for a single article.
bag_status
array of object (BagStatusHistory)
An array of current status records associated with the bag, reflecting its lifecycle stages (e.g., pending, placed, delivered).
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
bag_status_history
array of object (BagStatusHistory)
An array of current status records associated with the bag, reflecting its lifecycle stages (e.g., pending, placed, delivered).
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
brand
object (Brand)
Brand
credit_note_expiry_days
integer
Nullable
logo
string
Nullable
invoice_prefix
string
Nullable
credit_note_allowed
boolean
Nullable
start_date
string
| date-time
Nullable
Denotes the start date and time when the brand was created.
company
string
Nullable
is_virtual_invoice
boolean
Nullable
script_last_ran
string
Nullable
pickup_location
string
Nullable
created_on
string
| date-time
Nullable
Timestamp when the brand was created.
brand_name
string
brand_id
integer
modified_on
string
| date-time
Nullable
Timestamp when the brand of the order was modified.
id
integer
Nullable
company
object (Company)
Company
pan_no
string
Nullable
created_on
string
| date-time
Nullable
Timestamp when the company was created.
id
integer
Nullable
company_name
string
Nullable
gst_number
string
Nullable
company_type
string
Nullable
The type of company, which can be one of the following:
- `distributor`: Distributor
- `franchise`: Franchise
- `mbo`: MBO (Managed Business Operations)
- `manufacturer-owner`: Owner/Manufacturer
Enum
modified_on
string
| date-time
Nullable
Timestamp when the company was modified.
meta
object
Nullable
Meta data of the company contains additional, potentially dynamic information about the company.
business_type
string
Nullable
The type of business structure, which can be one of the following:
- `Private`: Private Limited Company
- `LLP/Partnership`: Limited Liability Partnership or Partnership
- `HUF/Proprietorship`: Hindu Undivided Family or Proprietorship.
agreement_start_date
string
| date-time
Nullable
Specifies the official beginning date and time of an agreement or contract associated with the company.
current_operational_status
object (BagStatusHistory)
BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
current_status
object (BagStatusHistory)
BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
dates
object (Dates)
Dates
delivery_date
string
| date-time
Nullable
Represents the scheduled date and time for the delivery of the entity.
order_created
string
Nullable
delivery_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
delivery_slot
object (DeliverySlotDetails)
Nullable
DeliverySlotDetails
slot
string
Nullable
upper_bound
string
Nullable
lower_bound
string
Nullable
date
string
Nullable
type
string
Nullable
display_name
string
Nullable
Name of the bag intended for user display.
dp_details
object
Nullable
Additional information about the delivery partner (DP) handling the bag.
einvoice_info
object
Nullable
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
fallback_user
object
Nullable
Details of the fallback user associated with the bag .
financial_breakup
array of object (FinancialBreakup)
A breakdown of the financial aspects associated with the bag, such as product prices, taxes, discounts, and total cost.
Array of FinancialBreakup
refund_credit
number
Refund credits provided to the customer
amount_paid_roundoff
integer
Nullable
Amount paid rounded off
price_effective
number
MRP - Initial Seller provided discount
promotion_effective_discount
number
Effective promotion discount including promotions given by seller and Platform
transfer_price
number
article
coupon_effective_discount
number
Coupon provided by brand or seller
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
tax_collected_at_source
number
Nullable
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Price Effective - Coupon Discount (Seller) - Promotion (Seller)
delivery_charge
number
The fee associated with the delivery service for transporting the item to its destination
gst_tag
string
Type of GST applied - IGST, CGST, SGST
hsn_code
string
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
cashback
number
Cashback points
item_name
string
The name of the item being referenced
value_of_good
number
Effective selling price - Product GST Amount
cashback_applied
number
Cashback applied on the order
cod_charges
number
The fee associated with the COD order
price_marked
number
The indicated price or value assigned to an item before any discounts or adjustments
size
string
The physical dimensions or specifications of the item, indicating its size or measurements
amount_paid
number
Amount paid by the customer
coupon_value
number
Stores the coupon value as shown in the cart
discount
number
The total amount discounted from the original MRP/actual price
fynd_credits
number
Credits provided by Fynd
gst_tax_percentage
number
The percentage rate of GST applied to a product or service
amount_to_be_collected
number
Amount to be collected in case of multiple modes of payments.
identifiers
object (Identifier)
Identifier
alu
string
Nullable
The ALU (Article Level Unit) code used to identify the item at a detailed level, often specific to certain retail or distribution systems.
ean
string
Nullable
The European Article Number (EAN) is a unique identifier for products, primarily used in retail and logistics. It helps in tracking and managing inventory across various platforms.
sku_code
string
Nullable
The Stock Keeping Unit (SKU) code of the item - uniquely identifies each distinct product. SKUs are used to track inventory levels, facilitate accurate stocktaking, and streamline order fulfillment processes. This code is essential for inventory management, allowing for the differentiation between products based on attributes such as price, color, and size.
upc
string
Nullable
The Universal Product Code (UPC) is a barcode symbol used for tracking trade items in stores. It is widely used in North America and helps in identifying products quickly during point-of-sale transactions.
isbn
string
Nullable
The International Standard Book Number (ISBN) is a unique identifier for books, allowing for easier management and tracking of book inventories in retail and library systems.
total_units
integer
Total number of units of the item
added_to_fynd_cash
boolean
Flag indicating whether fynd cash has been used
refund_amount
number
tcs_percentage
number
fulfilling_store
object (Store)
Nullable
Store
phone
string
is_active
boolean
Nullable
company_id
integer
alohomora_user_id
integer
Nullable
created_at
string
| date-time
Denotes the date and time when the store was created.
contact_person
string
store_email
string
is_enabled_for_recon
boolean
Nullable
pincode
string
mall_area
string
Nullable
vat_no
string
Nullable
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
store_active_from
string
Nullable
city
string
name
string
longitude
number
Nullable
brand_store_tags
array of string
Nullable
order_integration_id
string
Nullable
parent_store_id
integer
Nullable
location_type
string
Type of location of the fulfilling store.
Enum
code
string
Nullable
fulfillment_channel
string
updated_at
string
| date-time
Nullable
Denotes the date and time when any modifications were made to the store.
store_address_json
object (StoreAddress)
StoreAddress
phone
string
created_at
string
| date-time
Denotes the date and time when the transition of the store address was created.
contact_person
string
pincode
integer
address_type
string
The type of the address (e.g., home, office).
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
version
string
Nullable
address_category
string
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy.
Enum
city
string
longitude
number
address2
string
area
string
Nullable
email
string
Nullable
updated_at
string
| date-time
Denotes the date and time when any modifications were made to the store.
country_code
string
Uniquely identifies the country of the store addressds_type using the two-character standard ISO 3166-1 alpha-2 country codes. Examples include 'US' for the United States and 'IN' for India.
country
string
landmark
string
latitude
number
state
string
meta
object (StoreMeta)
StoreMeta
additional_contact_details
object
Nullable
Provides a flexible structure for storing extra contact information related to the store.
timing
array of object
Nullable
notification_emails
array of string
Nullable
gst_number
string
Nullable
ewaybill_portal_details
object
Nullable
Contains essential information and settings related to the e-Way Bill portal, which is used for generating and managing e-waybills for the transportation of goods under specific tax regulations.
einvoice_portal_details
object (EInvoicePortalDetails)
EInvoicePortalDetails
username
string
Nullable
user
string
Nullable
password
string
Nullable
gst_credentials
object (StoreGstCredentials)
StoreGstCredentials
e_invoice
object (StoreEinvoice)
StoreEinvoice
username
string
Nullable
user
string
Nullable
password
string
Nullable
enabled
boolean
e_waybill
object (StoreEwaybill)
StoreEwaybill
enabled
boolean
Nullable
stage
string
product_return_config
object
Nullable
Product return configuration details for the location. It can include details like on_same_store denoting whether return can be initiated at the same store.
documents
object (StoreDocuments)
StoreDocuments
gst
object (Document)
Document
value
string
type
string
Type of the document.
verified
boolean
legal_name
string
url
string
Nullable
display_name
string
s_id
string
Nullable
state
string
country
string
packaging_material_count
integer
Nullable
is_archived
boolean
Nullable
login_username
string
Nullable
mall_name
string
Nullable
latitude
number
Nullable
address2
string
Nullable
fyndstore_emp
object
Nullable
Fynd store employee details.
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
invoice
object (InvoiceDetails)
Nullable
InvoiceDetails
updated_date
string
| date-time
Nullable
Specifies the date and time when the invoice was last updated.
store_invoice_id
string
Nullable
invoice_url
string
Nullable
label_url
string
Nullable
item
object (Item)
Item
attributes
object (Attributes)
A dictionary of product attributes
Attributes
primary_material
string
Nullable
essential
string
Nullable
marketer_name
string
Nullable
primary_color
string
Nullable
marketer_address
string
Nullable
primary_color_hex
string
Nullable
brand_name
string
Nullable
name
string
Nullable
gender
array of string
Nullable
brand_id
integer
slug_key
string
webstore_product_url
string
Nullable
l3_category
integer
Nullable
Represents the product's classification at the third level in the e-commerce platform's category hierarchy, using an integer identifier. This finer level of categorization allows for precise product organization and easier navigation for customers seeking specific items.
l3_category_name
string
Nullable
This key specifies the name of the third-level category under which the product is listed, offering a more detailed classification within the e-commerce platform's hierarchy.
last_updated_at
string
| date-time
Nullable
Denotes the date and time when the item was updated.
name
string
l2_category
array of string
Nullable
The l2_category field represents the second level of categorization for items within an e-commerce platform's hierarchy. This allows for classification beyond the top-tier (level 1) categories, helping customers to narrow down their search and find products
brand
string
image
array of string
code
string
Nullable
l1_category_id
integer
Nullable
The unique identifier of the defines the top-tier categories to which a product belongs within the e-commerce platform's hierarchy.
item_id
integer
l1_category
array of string
Nullable
This array defines the top-tier categories to which a product belongs within the e-commerce platform's hierarchy.
gender
string
Nullable
can_cancel
boolean
Nullable
can_return
boolean
Nullable
size
string
branch_url
string
Nullable
meta
object
Nullable
Meta data of the item contains additional, potentially dynamic information about the item.
color
string
Nullable
department_id
integer
Nullable
l2_category_id
integer
Nullable
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
line_number
integer
A unique identifying number associated with the bag. It is generated sequentially as bags are created.
lock_status
boolean
Nullable
Indicates whether the bag is locked from further changes (true/false). A locked bag cannot undergo modifications until unlocked.
manifest_id
string
Nullable
The identifier-assigned bags receive after they are manifest (thereby creating a shipment in conjunction with the allocated manifest).
meta
object
Meta data of the bag details contains additional, potentially dynamic information about the bag details.
mode_of_payment
string
Nullable
This field reflects the payment method used in the transaction for a particular bag.
no_of_bags_order
integer
Nullable
The total number of bags in this bag's order.
operational_status
string
Nullable
The particular state a bag occupies in the shipment life-cycle.
order
object (OrderDetails)
OrderDetails
fynd_order_id
string
created_at
string
Date and time when the order was created.
user_id
string
Nullable
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
mongo_cart_id
number
Nullable
delivery_charges
number
Nullable
transaction_id
string
Nullable
collect_by
string
headers
object
Nullable
Header details of the order.
coupon_value
number
Nullable
order_value
number
created_time
string
currency
string
The currency in which the prices details associated with the item is specified.
total_order_value
number
ordering_channel
string
meta
object
Nullable
Meta data of the order data contains additional, potentially dynamic information about the order data.
cod_charges
number
Nullable
cashback_value
number
Nullable
refund_by
string
affiliate_order_date
string
| date-time
Nullable
Specifies the date and time of the order when it was created within the affiliate's system. It specifies that the date and time are recorded in ISO 8601 format.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
affiliate_order_id
string
payment_mode_id
number
Nullable
promotion_effective_discount
number
Nullable
mode_of_payment
string
discount
number
Nullable
cashback_applied
number
Nullable
fynd_credits
number
Nullable
affiliate_id
string
ordering_channel_logo
string
Nullable
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
order_integration_id
string
Nullable
A unique identifier used for integrating this order with external systems or services.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
order_value
number
Nullable
An estimated value of the order at the time of placement or sale.
ordering_store
object (Store)
Nullable
Store
phone
string
is_active
boolean
Nullable
company_id
integer
alohomora_user_id
integer
Nullable
created_at
string
| date-time
Denotes the date and time when the store was created.
contact_person
string
store_email
string
is_enabled_for_recon
boolean
Nullable
pincode
string
mall_area
string
Nullable
vat_no
string
Nullable
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
store_active_from
string
Nullable
city
string
name
string
longitude
number
Nullable
brand_store_tags
array of string
Nullable
order_integration_id
string
Nullable
parent_store_id
integer
Nullable
location_type
string
Type of location of the fulfilling store.
Enum
code
string
Nullable
fulfillment_channel
string
updated_at
string
| date-time
Nullable
Denotes the date and time when any modifications were made to the store.
store_address_json
object (StoreAddress)
StoreAddress
phone
string
created_at
string
| date-time
Denotes the date and time when the transition of the store address was created.
contact_person
string
pincode
integer
address_type
string
The type of the address (e.g., home, office).
address1
string
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
version
string
Nullable
address_category
string
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy.
Enum
city
string
longitude
number
address2
string
area
string
Nullable
email
string
Nullable
updated_at
string
| date-time
Denotes the date and time when any modifications were made to the store.
country_code
string
Uniquely identifies the country of the store addressds_type using the two-character standard ISO 3166-1 alpha-2 country codes. Examples include 'US' for the United States and 'IN' for India.
country
string
landmark
string
latitude
number
state
string
meta
object (StoreMeta)
StoreMeta
additional_contact_details
object
Nullable
Provides a flexible structure for storing extra contact information related to the store.
timing
array of object
Nullable
notification_emails
array of string
Nullable
gst_number
string
Nullable
ewaybill_portal_details
object
Nullable
Contains essential information and settings related to the e-Way Bill portal, which is used for generating and managing e-waybills for the transportation of goods under specific tax regulations.
einvoice_portal_details
object (EInvoicePortalDetails)
EInvoicePortalDetails
username
string
Nullable
user
string
Nullable
password
string
Nullable
gst_credentials
object (StoreGstCredentials)
StoreGstCredentials
e_invoice
object (StoreEinvoice)
StoreEinvoice
username
string
Nullable
user
string
Nullable
password
string
Nullable
enabled
boolean
e_waybill
object (StoreEwaybill)
StoreEwaybill
enabled
boolean
Nullable
stage
string
product_return_config
object
Nullable
Product return configuration details for the location. It can include details like on_same_store denoting whether return can be initiated at the same store.
documents
object (StoreDocuments)
StoreDocuments
gst
object (Document)
Document
value
string
type
string
Type of the document.
verified
boolean
legal_name
string
url
string
Nullable
display_name
string
s_id
string
Nullable
state
string
country
string
packaging_material_count
integer
Nullable
is_archived
boolean
Nullable
login_username
string
Nullable
mall_name
string
Nullable
latitude
number
Nullable
address2
string
Nullable
parent_promo_bags
object
Nullable
An object containing details of parent promotional bags.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_type
string
Nullable
The Specific type of payment.
Enum
payments
object
Nullable
Defines allowed payment details for the item.
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Defines any additional charges for the product.
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
qc_required
boolean
Nullable
Indicates whether quality check is required for the product.
quantity
number
Nullable
The quantity of the product.
reasons
array of object
Nullable
Information about why the Bag's item/products are being cancelled or returned or exchanged. This keys within this object represent unique
restore_coupon
boolean
Nullable
Indicates whether voucher/wallet points can be reapplied to the product.
restore_promos
object
Nullable
Provides a flexible structure for storing information about promotion details or offers that are eligible for restoration. This can include details such as promo codes, descriptions of the offers, eligibility criteria, restoration conditions, and any other relevant data that supports the reactivation of previously paused or expired promotions.
rto_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
seller_identifier
string
Nullable
A unique identifier assigned by the seller to represent a specific transaction in their order processing system.
shipment
object (Shipment)
Shipment
line_items
array of object (LineItem)
An array of LineItem objects that represent the items included in the shipment.
Array of LineItem
charges
array of object (Charge)
These are the mandatory charges required during order creation and are integral to the order processing flow. They include fields like amount_paid, discount, and price_marked. The schema for these charges is predefined and remains consistent, ensuring seamless forward mapping in the code.
Array of Charge
name
string
The name of the charge that indicates its purpose.
amount
object (AmountSchema)
AmountSchema
ordering_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
tax
object (Tax)
Tax
name
string
The name of the tax, indicating its purpose (e.g., VAT, sales tax).
rate
number
| float
The tax rate as a decimal, applied to the transaction amount.
breakup
array of object
An array of objects detailing the components or breakdown of the tax applied.
amount
object (AmountSchema)
AmountSchema
ordering_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
code
string
An optional code associated with the charge for internal tracking.
type
string
The category or type of the charge.
meta
object
An object containing metadata relevant to articles or line items.
custom_message
string
A string for any special instructions or messages related to the line item.
quantity
integer
| int32
Quantity of the articles or line items.
seller_identifier
string
Unique identifier of the articles or line items set by seller.
external_line_id
string
External unique identifier of the articles or line items.
dynamic_charges
array of object (DynamicChargeSchema)
(Optional) These are additional charges specified by the client based on specific use cases. They allow for flexibility in adding new fields such as installation_fee, service_charge, or other dynamic costs.
Array of DynamicChargeSchema
name
string
The name of the charge.
type
string
The category or type of the charge.
code
string
An optional code associated with the charge for internal tracking.
amount
object (AmountSchema)
AmountSchema
ordering_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
CurrencyValueSchema
value
number
| float
The numerical value of the charge.
currency
string
The currency code (e.g., USD, INR).
taxes
object (DynamicChargeTaxSchema)
DynamicChargeTaxSchema
reporting_hsn_code
string
HSN (Harmonized System of Nomenclature) code for reporting purposes.
meta
object
Meta data of the custom charge.
distribution_logic
object (DistributionLogicSchema)
DistributionLogicSchema
distribution_level
string
The level at which the charge is distributed (order, article, shipment).
Enum
distribution
object (DistributionSchema)
DistributionSchema
type
string
Type of distribution (single or multi).
Enum
logic
string
Logic for distribution (apportion, equally).
Enum
rule
object (RuleSchema)
RuleSchema
conditions
object (RuleConditionsSchema)
RuleConditionsSchema
article_tag
string
The tag for the article.
department
array of string
List of applicable departments.
external_shipment_id
string
External shipment identifier or marketplace's unique shipment identifier.
external_location_id
string
processing_dates
object (ProcessingDates)
ProcessingDates
dp_pickup_slot
object
An object that provides details about the designated pickup time slot for the order.
dispatch_after_date
string
A string indicating the date after which the order will be dispatched.
dispatch_by_date
string
A string representing the latest date by which the order must be dispatched to meet delivery expectations.
confirm_by_date
string
A string that indicates the deadline for the merchant to confirm the order.
customer_pickup_slot
object
An object that provides details of the pick-up time slot set by the customer.
pack_by_date
string
| date-time
Defines the deadline for having the package fully packed and ready for dispatch or pickup, integral to streamlining the fulfillment process.
meta
object
Nullable
Meta data of the shipment contains additional, potentially dynamic information about the shipment.
priority
integer
| int32
An integer indicating the priority level of the shipment.
location_id
integer
| int32
Location Identifier or Store/Fulfillment Identifier of the shipment- This field is mandatory when optimal_shipment_creation flag is set to false, indicating that shipments must be associated with a specific location. When `optimal_shipment_creation` is true, the optimal location for order creation would be assigned, location_id becomes optional.
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order undergoes all state transitions typical for a delivery, from processing the shipment to final delivery at the customer's address.
- "PickAtStore": The order is prepared for pickup and moved to a state where it is ready to be handed over directly to the customer at the store. This type streamlines the process by bypassing traditional shipping stages and facilitating a quicker transition to the final handover stage.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
tags
array of object (Tag)
Nullable
Array of Tag
slug
string
A unique identifier or short label for the tag for shipment reference.
display_text
string
Label of the tag. This text is shown to users, representing the tag in an human-readable format.
system_messages
array of object (SystemMessages)
Array of SystemMessages
message_type
string
Specifies the type of message.
Enum
priority
number
This will determine the sequence of messages (1 being the highest priority).
message
string
Message to be displayed at Platform's Order Details.
inject_at
array of string
Holds the list of OMS status at which the message should be visible.
process_after_config
object (ProcessAfterConfig)
ProcessAfterConfig
is_scheduled_shipment
boolean
Indicates whether the shipment is scheduled for later processing.
enable_processing_after
string
| date-time
Specifies the UTC time after which the shipment will be automatically processed.
parent_type
string
Nullable
store_invoice_id
string
Nullable
lock_status
string
Nullable
type
string
Nullable
billing_address_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
id
string
fulfilment_priority
integer
Nullable
is_active
boolean
previous_shipment_id
string
Nullable
pdf_links
object
Nullable
PDF Links associated with the shipment.
delivery_address_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
eway_bill_id
string
Nullable
affiliate_shipment_id
string
Nullable
fynd_order_id
string
created_at
string
| date-time
Specifies the date and time when the shipment was created.
delivery_awb_number
string
Nullable
hand_over_contact_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
credit_note_id
string
Nullable
parent_id
string
Nullable
affiliate_id
string
packaging_type
string
Nullable
Defines the type of packaging used for the product, encompassing materials, design, and form factors.
vertical
string
Nullable
quantity
number
Nullable
status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
price
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
gst
object (ShipmentGstDetails)
Nullable
ShipmentGstDetails
value_of_good
number
Nullable
gst_fee
number
Nullable
brand_calculated_amount
number
Nullable
tax_collected_at_source
number
Nullable
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
shipment_details
object (ShipmentDetails)
Nullable
ShipmentDetails
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
shipments
integer
| int32
fulfillment_id
integer
| int32
articles
array of object (ArticleDetails)
Array of ArticleDetails
_id
string
A unique identifier for the article, facilitating easy reference and management within the system.
brand_id
integer
| int32
Numerical code representing the brand associated with the article, linking it to its manufacturer or creator.
dimension
object
Specifies the physical dimensions of the article, including height, width, and depth, providing a comprehensive understanding of its size.
category
object
Classifies the article into a specific category or type, aiding in organization and filtering based on its nature or usecase.
weight
object
Details the weight of the article, crucial for logistics, shipping calculations, and customer information.
attributes
object
Holds additional descriptive details and characteristics of the article, such as color, material, and style, enhancing product understanding.
quantity
integer
| int32
Specifies the available or required quantity of the article, important for inventory management and order fulfillment.
dp_id
string
| int32
Nullable
meta
object
affiliate_shipment_id
string
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
lock_status
boolean
Nullable
action_to_status
object
Nullable
This field maps potential actions (e.g., downloading an invoice or label) to their corresponding shipment lock statuses, indicating which operations are allowed depending on the shipment's current lock status. When an action is set to 'lock', it means no transitions or updates to the shipment's status can be performed until the specified action is completed. For instance, if 'download_invoice' is in a 'lock' state, the shipment cannot undergo any status transitions until the invoice is either downloaded. Similarly, 'download_label' being in a 'lock' state prevents any shipment status transitions until a new label is downloaded.
shipment_id
string
Nullable
Unique identifier of the shipment.
shipment_gst
object (ShipmentGstDetails)
Nullable
ShipmentGstDetails
value_of_good
number
Nullable
gst_fee
number
Nullable
brand_calculated_amount
number
Nullable
tax_collected_at_source
number
Nullable
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
shipment_status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
shipment_status_history
array of object (ShipmentStatusData)
Nullable
Status history of the shipment item in the order.
Array of ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
status
object (BagReturnableCancelableStatus)
BagReturnableCancelableStatus
is_returnable
boolean
Indicates whether the bag can be returned by the customer.
is_active
boolean
Specifies if the current status of the bag is active, affecting its eligibility for return or cancellation.
can_be_cancelled
boolean
Indicates if the bag order can be cancelled by the customer.
enable_tracking
boolean
Indicates whether tracking is enabled for the bag, allowing customers to monitor its status.
is_customer_return_allowed
boolean
Specifies if the customer is permitted to return the bag, based on the return policy.
tags
array of string
Nullable
A list of tags or labels associated with the bag, which might be used for filtering, sorting, or categorizing purposes.
total_shipment_bags
integer
Nullable
The total number of shipped bags.
total_shipments_in_order
integer
Nullable
The total number of shipments in the order.
transaction_type
string
Nullable
Specifies the type of the transaction being processed. This classification helps in distinguishing between different operational processes and allows for tailored handling of each transaction type. For example, a 'shipment' transaction type refers to operations related to the shipping of goods.
Enum
type
string
Nullable
The type of the bag.
updated_at
string
| date-time
Nullable
The date and time when the bag was last updated.
user
object (UserDetails)
Nullable
UserDetails
user_oid
string
Nullable
external_customer_id
string
Nullable
first_name
string
Nullable
last_name
string
Nullable
mobile
string
Nullable
email
string
Nullable
is_anonymous_user
boolean
Nullable
gender
string
Nullable
mongo_user_id
string
Nullable
meta
object
Nullable
Meta data of the user details contains additional, potentially dynamic information about the user details.
weight
object (WeightData)
Nullable
WeightData
value
number
Nullable
unit
string
Nullable
original_bag_list
array of integer
Nullable
Specifies the list of integers that specify the bag number
identifier
string
Nullable
The unique identifier for the bag.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
page
object (BagsPage)
BagsPage
item_total
integer
has_next
boolean
page_type
string
The type of the page.
current
integer
size
integer
Examples
Parameters
company_id:
528
bag_ids:
"6393"
shipment_ids:
"16984021739051838556,16984021739051838556"
order_ids:
"FY653B8F7C0EE4EE0DB4,FY653B8F7C0EE4EE0DB4"
channel_bag_ids:
"6393,6393"
channel_shipment_ids:
"16984021800861979616,16984021800861979616"
channel_order_ids:
"FY653B8F7C0EE4EE0DB4,FY653B8F7C0EE4EE0DB4"
channel_id:
"653b8403127195717572efb0,653b8403127195717572efb0"
page_no:
1
page_size:
20
Was this section helpful?
GET
Response
Get bags.
getBags
A manifest is a document listing the contents of a shipment. It details each item included in the shipment, along with its quantity and any relevant information for the carrier for example weight, dimensions. This information is crucial for sellers and courier partners to track goods, ensure everything arrives at its destination. This document acts as proof of delivery between seller and courier partner.
Operations
GET
# get Manifest Filters.
Parameters
company_id
integer
Required
Id of company
view
string
Required
Name of View
Default Value : manifest
Enum
Response
200
List of filters
ManifestFiltersResponseSchema
advance
array of object (FiltersInfo)
Array of FiltersInfo
options
array of object (FilterInfoOption)
Nullable
Options of the filter.[dropdown]
Array of FilterInfoOption
text
string
Nullable
The display text of the option.
name
string
Nullable
Name of the option.
placeholder_text
string
Nullable
Placeholder text of the option.
value
string
Nullable
The value of the option.
min_search_size
integer
| int32
Nullable
Minimum search size of the option.
show_ui
boolean
Nullable
Specifies whether the option should be shown in the UI.
text
string
Display text of filter
placeholder_text
string
Nullable
Placeholder text of filter.
value
string
The value of the filter.
required
boolean
Nullable
Specifies whether the filter is required or not.
type
string
single_select/multi_select
Enum
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
company_id:
1
view:
"manifest"
Was this section helpful?
GET
Response
get Manifest Filters.
getManifestfilters
Order represents a customer's intent to purchase a specific set of products from your platform. Here platform could be a Website, POS machine, External integrations etc. It typically includes details like customer information, billing/shipping addresses, items ordered, quantities, pricing, and chosen fulfillment method. Meta of an order can be edited.
Operations
GET
# Get announcements.
PUT
# Update an order
GET
# Get failed order logs according to the filter provided
GET
# Get failed order logs according to the filter provided
GET
# Get role-based actions.
POST
# Check order status.
POST
# Create order.
PUT
# Enables the updating of various order properties, including tax_details, meta, and more, providing flexibility and precision in order adjustments.
GET
# Get order by ID.
GET
# Get lane configuration.
GET
# Get orders.
PUT
# Update User view(Parent view and child view) position
GET
# Get custom view for every unique user cross company pair.
POST
# Add custom view for every unique user cross company pair.
PUT
# Update custom view for every unique user cross company pair.
DEL
# Delete custom view for every unique user cross company pair.
GET
# Get global filters for populating filter listing and powering views api.
GET
# Get filters.
GET
# Get the Order Configuration for the application.
POST
# Update/Insert the Order Configuration for the application.
Retrieve announcements related to orders fulfilment configured by platform or company admin
Parameters
company_id
integer
Required
date
string
Date On which the announcement is Active (Date should in ISO Datetime format IST Time)
Response
200
Announcements retrieved successfully
AnnouncementsResponseSchema
announcements
array of object (AnnouncementResponseSchema)
Array of AnnouncementResponseSchema
to_datetime
string
The end date and time for the event, indicating when the issue is expected to be resolved.
id
integer
| int32
A unique identifier for the announcement.
description
string
A brief description providing additional context about the announcement.
platform_name
string
The name of the platform associated with this announcement.
from_datetime
string
The start date and time of the announcement going live.
platform_id
string
The unique identifier associated with the platform. In this case, it appears to be the same as the platform name, which might indicate a specific category or type.
title
string
The title summarizing the nature of the announcement.
company_id
integer
| int32
Nullable
A unique identifier for the company related to this announcement.
logo_url
string
A URL linking to the logo image associated with the platform or company.
created_at
string
The timestamp of when this announcement was created, providing context for its age and relevance.
success
boolean
Indicates whether the API call was successful (true) or not (false).
status
integer
Represents the HTTP status code of the API response
message
string
A descriptive message providing additional information about the API response.
Examples
Parameters
company_id:
1
date:
"2023-06-28T09:00:00Z"
Was this section helpful?
GET
Response
Get announcements.
getAnnouncements
Used to update an order's meta information. These meta information can be accessed via order or shipment details API.
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
order_id
string
Required
A string that represents the unique identifier assigned to the order.
Response
200
400
We are processing the order!
ResponseDetail
success
boolean
Indicates whether the API call was successful (true) or not (false).
message
string
A descriptive message providing additional information about the API response.
status
integer
Represents the HTTP status code of the API response.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
PUT
Response
Update an order
orderUpdate
This endpoint allows users to get failed order logs listing for filters based on order id, user contact number, user email id and sales channel id.
Parameters
company_id
integer
Required
Company ID
page_no
integer
Page Number
page_size
integer
Page Size
search_type
string
Search type for filter
search_value
string
Search value for filter
Response
200
400
Order Logs listing fetched successfully
FailedOrderLogs
items
array of object (FailedOrdersItem)
Array of FailedOrdersItem
log_id
integer
order_id
string
channel
object (LogsChannelDetails)
LogsChannelDetails
channel_id
string
Nullable
name
string
Nullable
logo
string
Nullable
channel_shipment_id
string
Nullable
payment
object (LogPaymentDetails)
LogPaymentDetails
payment_mode
string
Nullable
amount_paid
string
Nullable
created_at
string
| date-time
Created date and time of the failed order.
error_message
string
A technical description of the error that occurred, intended for debugging purposes.
display_message
string
A user-friendly message that can be displayed to the end-user, explaining the failure in a more general and understandable manner.
method_name
string
meta
object
Meta data of the failed orders that contains additional, potentially dynamic information about the order.
page
object (PageDetails)
PageDetails
current
integer
| int32
Nullable
Current page number
has_next
boolean
Nullable
if next page contains any result
has_previous
boolean
Nullable
if previous page contains any result
item_total
integer
| int32
Total count of the results present in the requested filter
size
integer
| int32
Nullable
Page size
total
integer
| int32
Nullable
Total
type
string
Nullable
Type of the page
Enum
Examples
Parameters
company_id:
1
page_no:
1
page_size:
10
Was this section helpful?
GET
Response
Get failed order logs according to the filter provided
getFailedOrderLogs
This endpoint allows users to get the exact error trace from the log id provided
Parameters
company_id
integer
Required
Company ID
log_id
string
Required
Log Error ID
Response
200
404
Order Logs listing fetched successfully
FailedOrderLogDetails
error_trace
string
This field is intended to store the error trace of the error that occurred.For example, "Exception Trace" represents a placeholder for the actual stack trace data that would be captured when an exception occurs."Internal Server Error" indicates a generic error message suggesting that the server encountered an unexpected condition that prevented it from fulfilling the request.
exception
string
This field captures the exception raised by the system during an Order Failure. It indicates an event that disrupts the normal flow of the program's instructions.
Examples
Parameters
company_id:
1
log_id:
"6cf7e378-1282-407f-bd4b-3cf5f0d2cac7"
Was this section helpful?
GET
Response
Get failed order logs according to the filter provided
failedOrderLogDetails
Retrieve permissible actions based on user roles such as company_admin, company_operation, customer_care, and read_only.
Parameters
company_id
integer
Required
Response
200
You will get an array of actions allowed for that particular user based on their role
GetActionsResponseSchema
permissions
array of object (ActionInfo)
A response object that contains a list of permissions available to the user.
Array of ActionInfo
display_text
string
A user-friendly text that represents the action associated with the permission.
id
integer
| int32
A unique identifier for the permission, used for referencing within the system.
description
string
A detailed explanation of what the permission allows the user to do.
slug
string
A URL-friendly string that serves as a unique identifier for the permission, often used in routing or API calls.
Examples
Parameters
company_id:
1
Was this section helpful?
GET
Response
Get role-based actions.
getRoleBasedActions
Parameters
company_id
integer
Required
Request body
order_details
array of object (FyndOrderIdList)
An array of objects that provide details about the orders, including their respective order IDs.
Array of FyndOrderIdList
fynd_order_id
array of string
An array of strings that represent unique identifiers assigned to an order.
start_date
string
A string representing the start date for the order status query.
end_date
string
A string representing the end date for the order status query.
mobile
integer
An integer representing the mobile number associated with the order.
start_date
string
| date-time
Required
Denotes the start date and time when the order was created.
end_date
string
| date-time
Required
Specifies the deadline by which a particular action related to the order needs to be completed.
mobile
integer
| int32
Required
Response
200
Order Status retrieved successfully
OrderStatusResult
status_code
integer
success
boolean
Indicates whether the API call was successful (true) or not (false).
result
array of object (OrderStatusData)
The order's current status and related shipment details.
Array of OrderStatusData
order_details
object (OrderDetails)
OrderDetails
fynd_order_id
string
created_at
string
Date and time when the order was created.
user_id
string
Nullable
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
mongo_cart_id
number
Nullable
delivery_charges
number
Nullable
transaction_id
string
Nullable
collect_by
string
headers
object
Nullable
Header details of the order.
coupon_value
number
Nullable
order_value
number
created_time
string
currency
string
The currency in which the prices details associated with the item is specified.
total_order_value
number
ordering_channel
string
meta
object
Nullable
Meta data of the order data contains additional, potentially dynamic information about the order data.
cod_charges
number
Nullable
cashback_value
number
Nullable
refund_by
string
affiliate_order_date
string
| date-time
Nullable
Specifies the date and time of the order when it was created within the affiliate's system. It specifies that the date and time are recorded in ISO 8601 format.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
affiliate_order_id
string
payment_mode_id
number
Nullable
promotion_effective_discount
number
Nullable
mode_of_payment
string
discount
number
Nullable
cashback_applied
number
Nullable
fynd_credits
number
Nullable
affiliate_id
string
ordering_channel_logo
string
Nullable
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
errors
array of string
A list of any errors that occurred while attempting to obtain the order's status.
shipment_details
array of object (ShipmentDetail)
A list of the individual shipments associated with the order and their current statuses.
Array of ShipmentDetail
shipment_id
string
Unique identifier for the shipment associated with the order.
status
string
A string representing the current status of the shipment
id
integer
| int32
An integer that serves as a unique identifier for the shipment detail
bag_list
array of integer
A list of bag identifiers associated with the shipment.
meta
object (Meta)
Meta
kafka_emission_status
integer
| int32
An integer representing the status of the message upon emission to Kafka. 0 indicates success, while 1 indicates failure.
state_manager_used
string
A string that specifies the state manager utilized for handling the order's state.
remarks
string
A string for any additional comments or notes related to the shipment,
text
string
A label or description of the delivery status, such as 'Expected Delivery Date'.
value
string
The detailed delivery status or time information, such as 'Arriving on 24 Nov 2022 15:54:00'.
color_code
string
Hex code for the color representing the delivery status.
expected_delivery_date
string
| date-time
The ISO 8601 formatted date and time when the delivery is expected, e.g., '2022-11-24T22:15:54+00:00'.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Check order status.
checkOrderStatus
Parameters
company_id
integer
Required
Id of the company.
Request body
shipments
array of object (Shipment)
Required
List of Shipments which includes shipment data like shipment items, shipment promise, Shipment type, shipment order type, shipment dp options etc.
Array of Shipment
line_items
array of object (LineItem)
Required
An array of LineItem objects that represent the items included in the shipment.
Array of LineItem
charges
array of object (Charge)
Required
These are the mandatory charges required during order creation and are integral to the order processing flow. They include fields like amount_paid, discount, and price_marked. The schema for these charges is predefined and remains consistent, ensuring seamless forward mapping in the code.
Array of Charge
name
string
Required
The name of the charge that indicates its purpose.
amount
object (AmountSchema)
Required
AmountSchema
ordering_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
tax
object (Tax)
Tax
name
string
Required
The name of the tax, indicating its purpose (e.g., VAT, sales tax).
rate
number
| float
Required
The tax rate as a decimal, applied to the transaction amount.
breakup
array of object
An array of objects detailing the components or breakdown of the tax applied.
amount
object (AmountSchema)
Required
AmountSchema
ordering_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
code
string
An optional code associated with the charge for internal tracking.
type
string
Required
The category or type of the charge.
meta
object
An object containing metadata relevant to articles or line items.
custom_message
string
A string for any special instructions or messages related to the line item.
quantity
integer
| int32
Quantity of the articles or line items.
seller_identifier
string
Required
Unique identifier of the articles or line items set by seller.
external_line_id
string
External unique identifier of the articles or line items.
dynamic_charges
array of object (DynamicChargeSchema)
(Optional) These are additional charges specified by the client based on specific use cases. They allow for flexibility in adding new fields such as installation_fee, service_charge, or other dynamic costs.
Array of DynamicChargeSchema
name
string
Required
The name of the charge.
type
string
Required
The category or type of the charge.
code
string
An optional code associated with the charge for internal tracking.
amount
object (AmountSchema)
Required
AmountSchema
ordering_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
taxes
object (DynamicChargeTaxSchema)
DynamicChargeTaxSchema
reporting_hsn_code
string
Required
HSN (Harmonized System of Nomenclature) code for reporting purposes.
meta
object
Meta data of the custom charge.
distribution_logic
object (DistributionLogicSchema)
DistributionLogicSchema
distribution_level
string
Required
The level at which the charge is distributed (order, article, shipment).
Enum
distribution
object (DistributionSchema)
Required
DistributionSchema
type
string
Required
Type of distribution (single or multi).
Enum
logic
string
Required
Logic for distribution (apportion, equally).
Enum
rule
object (RuleSchema)
RuleSchema
conditions
object (RuleConditionsSchema)
Required
RuleConditionsSchema
article_tag
string
Required
The tag for the article.
department
array of string
Required
List of applicable departments.
external_shipment_id
string
External shipment identifier or marketplace's unique shipment identifier.
external_location_id
string
processing_dates
object (ProcessingDates)
ProcessingDates
dp_pickup_slot
object
An object that provides details about the designated pickup time slot for the order.
dispatch_after_date
string
A string indicating the date after which the order will be dispatched.
dispatch_by_date
string
A string representing the latest date by which the order must be dispatched to meet delivery expectations.
confirm_by_date
string
A string that indicates the deadline for the merchant to confirm the order.
customer_pickup_slot
object
An object that provides details of the pick-up time slot set by the customer.
pack_by_date
string
| date-time
Defines the deadline for having the package fully packed and ready for dispatch or pickup, integral to streamlining the fulfillment process.
meta
object
Nullable
Meta data of the shipment contains additional, potentially dynamic information about the shipment.
priority
integer
| int32
An integer indicating the priority level of the shipment.
location_id
integer
| int32
Location Identifier or Store/Fulfillment Identifier of the shipment- This field is mandatory when optimal_shipment_creation flag is set to false, indicating that shipments must be associated with a specific location. When `optimal_shipment_creation` is true, the optimal location for order creation would be assigned, location_id becomes optional.
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order undergoes all state transitions typical for a delivery, from processing the shipment to final delivery at the customer's address.
- "PickAtStore": The order is prepared for pickup and moved to a state where it is ready to be handed over directly to the customer at the store. This type streamlines the process by bypassing traditional shipping stages and facilitating a quicker transition to the final handover stage.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
tags
array of object (Tag)
Nullable
Array of Tag
slug
string
A unique identifier or short label for the tag for shipment reference.
display_text
string
Label of the tag. This text is shown to users, representing the tag in an human-readable format.
system_messages
array of object (SystemMessages)
Array of SystemMessages
message_type
string
Required
Specifies the type of message.
Enum
priority
number
Required
This will determine the sequence of messages (1 being the highest priority).
message
string
Required
Message to be displayed at Platform's Order Details.
inject_at
array of string
Holds the list of OMS status at which the message should be visible.
process_after_config
object (ProcessAfterConfig)
ProcessAfterConfig
is_scheduled_shipment
boolean
Indicates whether the shipment is scheduled for later processing.
enable_processing_after
string
| date-time
Specifies the UTC time after which the shipment will be automatically processed.
parent_type
string
Nullable
store_invoice_id
string
Nullable
lock_status
string
Nullable
type
string
Nullable
billing_address_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
id
string
fulfilment_priority
integer
Nullable
is_active
boolean
previous_shipment_id
string
Nullable
pdf_links
object
Nullable
PDF Links associated with the shipment.
delivery_address_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
eway_bill_id
string
Nullable
affiliate_shipment_id
string
Nullable
fynd_order_id
string
created_at
string
| date-time
Specifies the date and time when the shipment was created.
delivery_awb_number
string
Nullable
hand_over_contact_json
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
credit_note_id
string
Nullable
parent_id
string
Nullable
affiliate_id
string
packaging_type
string
Nullable
Defines the type of packaging used for the product, encompassing materials, design, and form factors.
vertical
string
Nullable
quantity
number
Nullable
status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
price
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
gst
object (ShipmentGstDetails)
Nullable
ShipmentGstDetails
value_of_good
number
Nullable
gst_fee
number
Nullable
brand_calculated_amount
number
Nullable
tax_collected_at_source
number
Nullable
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
shipping_info
object
Required
billing_info
object
Required
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
external_order_id
string
A unique identifier for the order assigned by an external system.
charges
array of object (Charge)
These are the mandatory charges required during order creation and are integral to the order processing flow. They include fields like amount_paid, discount, and price_marked, etc.. The schema for these charges is predefined and remains consistent, ensuring seamless forward mapping in the code.
Array of Charge
name
string
Required
The name of the charge that indicates its purpose.
amount
object (AmountSchema)
Required
AmountSchema
ordering_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
tax
object (Tax)
Tax
name
string
Required
The name of the tax, indicating its purpose (e.g., VAT, sales tax).
rate
number
| float
Required
The tax rate as a decimal, applied to the transaction amount.
breakup
array of object
An array of objects detailing the components or breakdown of the tax applied.
amount
object (AmountSchema)
Required
AmountSchema
ordering_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
code
string
An optional code associated with the charge for internal tracking.
type
string
Required
The category or type of the charge.
external_creation_date
string
| date-time
A string that specifies the date and time when the order was created in an external system
meta
object
Meta data of the order that contains additional, potentially dynamic information about the order.
tax_info
object (TaxInfo)
TaxInfo
b2b_gstin_number
string
A string representing the GSTIN (Goods and Services Tax Identification Number) for business-to-business transactions.
gstin
string
A string that specifies the GSTIN for the seller.
pan_no
string
A string representing the PAN assigned to individuals or entities for tax purposes in India.
config
object (CreateOrderConfig)
Required
CreateOrderConfig
dp_configuration
object (DPConfiguration)
Required
DPConfiguration
shipping_by
string
shipping_by denotes dp assignment strategy- if shipping_by is fynd dp assignment would be handled by OMS
Enum
location_reassignment
boolean
Flag denotes if the location for the store needs to be reassigned post cancellation. If true,location for the store gets auto reassigned post cancellation, if set false location reassignment will not be performed as its disabled.
payment
object (PaymentConfig)
PaymentConfig
mode_of_payment
string
Specifies the mode through which the payment was collected, serving as an identifier for the payment's origin.
source
string
The source field identifies the channel through which the order was placed, such as MARKETPLACE, ECOMM.
optimal_shipment_creation
boolean
Denotes the shipment breaking strategy. If the flag is set true, the shipment is created using optimal shipment creation strategy based on the servicability & packaging dimensions by OMS .If false, shipment details, including location_id, must be passed to FDK for processing.
Default Value : false
lock_state_messages
array of object (LockStateMessage)
A list of state-specific custom lock messages.
Array of LockStateMessage
state
string
The state for which the custom lock message applies.
message
string
Custom lock message used when the shipment is locked in the specified state.
integration_type
string
Flag denotes integration type which is used to retrieve specific configurations and application details relevant to channel fulfillment.
Enum
payment_info
object (PaymentInfo)
Required
PaymentInfo
primary_mode
string
Required
A string that indicates the primary payment method used for the order.
payment_mode
string
A string that indicates the payment mode used for the order.
payment_methods
array of object (PaymentMethod)
A lists all available payment methods used in the transaction.
Default Value :
Array of PaymentMethod
collect_by
string
Required
A string indicating the entity responsible for collecting the payment.
mode
string
Required
A string that specifies the mode of payment.
refund_by
string
Required
A string that indicates the entity responsible for processing refunds.
name
string
Required
A string representing the name of the payment method.
amount
number
| float
Required
A number representing the monetary value associated with the payment method.
meta
object
An object for any additional metadata related to the payment method.
Default Value : [object Object]
transaction_data
object
An object that holds transaction-specific information.
Default Value : [object Object]
collected
boolean
Required
display_name
string
Required
merchant_transaction_id
string
Required
user_info
object (UserInfo)
UserInfo
user_id
string
The unique identifier assigned to the user.
user_type
string
A string representing the type of the user.
primary_email
string
Required
A string representing the primary email address for the user.
gender
string
A string specifying the gender of the user.
first_name
string
Required
A string which specifies the user's first name.
last_name
string
A string which specifies the user's last name.
primary_mobile_number
string
Required
A string representing the primary mobile number for the user.
is_authenticated
boolean
meta
object
ordering_store_id
integer
| int32
Unique identifier for the store where the order was placed.
order_platform
string
The platform used to place the order.
Enum
status
string
Represents the current status of the order, specifying whether the order is in a 'pendency' state (awaiting further action) or marked as 'complete'.
Enum
system_messages
array of object (SystemMessages)
Array of SystemMessages
message_type
string
Required
Specifies the type of message.
Enum
priority
number
Required
This will determine the sequence of messages (1 being the highest priority).
message
string
Required
Message to be displayed at Platform's Order Details.
inject_at
array of string
Holds the list of OMS status at which the message should be visible.
order_type
string
A string that specifies the type of order being placed.
Enum
fynd_order_id
string
Unique identifier for the order.
application_id
string
A unique identifier for the application or system that is making the order request.
external_shipment_id
string
External shipment identifier or marketplace's unique shipment identifier.
unlock_before_transition
boolean
lock_after_transition
boolean
dynamic_charges
array of object (DynamicChargeSchema)
(Optional) These are additional charges specified by the client based on specific use cases. They allow for flexibility in adding new fields such as installation_fee, service_charge, or other dynamic costs.
Array of DynamicChargeSchema
name
string
Required
The name of the charge.
type
string
Required
The category or type of the charge.
code
string
An optional code associated with the charge for internal tracking.
amount
object (AmountSchema)
Required
AmountSchema
ordering_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
base_currency
object (CurrencyValueSchema)
Required
CurrencyValueSchema
value
number
| float
Required
The numerical value of the charge.
currency
string
Required
The currency code (e.g., USD, INR).
taxes
object (DynamicChargeTaxSchema)
DynamicChargeTaxSchema
reporting_hsn_code
string
Required
HSN (Harmonized System of Nomenclature) code for reporting purposes.
meta
object
Meta data of the custom charge.
distribution_logic
object (DistributionLogicSchema)
DistributionLogicSchema
distribution_level
string
Required
The level at which the charge is distributed (order, article, shipment).
Enum
distribution
object (DistributionSchema)
Required
DistributionSchema
type
string
Required
Type of distribution (single or multi).
Enum
logic
string
Required
Logic for distribution (apportion, equally).
Enum
rule
object (RuleSchema)
RuleSchema
conditions
object (RuleConditionsSchema)
Required
RuleConditionsSchema
article_tag
string
Required
The tag for the article.
department
array of string
Required
List of applicable departments.
custom_json
object
Nullable
An object containing additional metadata, ensuring only the required fields are included as needed.
Response
200
Successfully created an order!
CreateOrderResponseSchema
fynd_order_id
string
A string that represents the unique identifier assigned to the order.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Create order.
createOrder
PUT
Enables the updating of various order properties, including tax_details, meta, and more, providing flexibility and precision in order adjustments.
Enables the updating of various order properties, including tax_details, meta, and more, providing flexibility and precision in order adjustments.
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
order_id
string
Required
Request body
data
array of object (OrderData)
Array of OrderData
key
string
The unique identifier for the data item within an order.
value
string
Defines new value for the order property. Direct assignment occurs for basic types (string, number, etc.). For objects, it updates or adds specific fields without replacing the entire property.
oneOf Schema from below
ordering_channel
string
The specific channel through which the order was placed.
order_date
string
| date-time
Required
Specifies the exact date and time when the order was placed by the customer, serving as a key timestamp for the initiation of the order processing cycle.
created_ts
string
Order created timestamp
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
fynd_order_id
string
Required
System generated unique identifier of the order
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Order level charges
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Required
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
Required
ChargeAmount
base_currency
object (ChargeAmountCurrency)
Required
ChargeAmountCurrency
value
number
Required
Charge currency value or amount
currency
string
Required
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
Required
ChargeAmountCurrency
value
number
Required
Charge currency value or amount
currency
string
Required
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
Required
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
Required
ChargeDistributionSchema
type
string
Required
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
Required
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
Required
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. This includes metadata such as logos, payment IDs, and merchant codes, as well as transaction-specific details like the payment mode, name, amount, and entities responsible for refunds and collections. The structure is designed to accommodate any number of payment methods, providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_info
array of object (PaymentInfoData)
Nullable
Array of object containing payment methods used for placing an order.
Array of PaymentInfoData
meta
object
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
mode
string
Information about the payment source. For eg, NB_ICICI.
name
string
The name of the payment method (e.g., "Credit Card", "PayPal").
amount
number
Amount paid using this payment method.
collected
boolean
Indicates whether this payment method has been collected or not.
refund_by
string
Payment refund by for the customer and seller (e.g fynd, seller).
collect_by
string
Payment collected by for the customer and seller (e.g fynd, seller).
display_name
string
The name of the payment method as it should be displayed to the user.
merchant_transaction_id
string
A unique identifier associated with the payment transaction, such as TR669796C0012CF31BBD. This ID helps track and reference the specific transaction within the merchant's system.
transaction_data
object
All necessary data for transaction received
affiliate_order_id
string
External Order id
affiliate_id
string
Unique identifier for the sales channel.
source
string
Specifies the origin from from which the order is created, including mobile applications, web interfaces, social media integrations, or external APIs.
currency
object (CurrencySchema)
CurrencySchema
currency_code
string
The ISO 4217 currency code, such as 'INR' for Indian Rupee. This field represents the standardized three-letter code of a currency.
currency_symbol
string
The symbol representing the currency, such as '₹' for Indian Rupee. This is used for display purposes alongside currency amounts.
created_at
string
| date-time
raw_user_agent
string
comment
string
currency_info
object
Response
200
206
400
Contains success message when order is updated successfully!
OrderUpdateResponseDetail
success
boolean
Indicates whether the order update was successful.
message
string
Provides a message related to the order update operation, which could be an error message or a success confirmation.
validation_errors
object
An object containing any validation errors that occurred during the order update process.
Examples
Parameters
company_id:
1
order_id:
"FY5E9175435813769749"
body:
body
Was this section helpful?
PUT
Response
Enables the updating of various order properties, including tax_details, meta, and more, providing flexibility and precision in order adjustments.
updateOrder
Parameters
company_id
integer
Required
Id of company
order_id
string
Required
Flag for order id
my_orders
boolean
allow_inactive
boolean
Flag to allow inactive shipments
Response
200
We are processing the report!
OrderDetailsResponseSchema
order
object (OrderData)
OrderData
key
string
The unique identifier for the data item within an order.
value
string
Defines new value for the order property. Direct assignment occurs for basic types (string, number, etc.). For objects, it updates or adds specific fields without replacing the entire property.
oneOf Schema from below
ordering_channel
string
The specific channel through which the order was placed.
order_date
string
| date-time
Specifies the exact date and time when the order was placed by the customer, serving as a key timestamp for the initiation of the order processing cycle.
created_ts
string
Order created timestamp
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
fynd_order_id
string
System generated unique identifier of the order
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Order level charges
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. This includes metadata such as logos, payment IDs, and merchant codes, as well as transaction-specific details like the payment mode, name, amount, and entities responsible for refunds and collections. The structure is designed to accommodate any number of payment methods, providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_info
array of object (PaymentInfoData)
Nullable
Array of object containing payment methods used for placing an order.
Array of PaymentInfoData
meta
object
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
mode
string
Information about the payment source. For eg, NB_ICICI.
name
string
The name of the payment method (e.g., "Credit Card", "PayPal").
amount
number
Amount paid using this payment method.
collected
boolean
Indicates whether this payment method has been collected or not.
refund_by
string
Payment refund by for the customer and seller (e.g fynd, seller).
collect_by
string
Payment collected by for the customer and seller (e.g fynd, seller).
display_name
string
The name of the payment method as it should be displayed to the user.
merchant_transaction_id
string
A unique identifier associated with the payment transaction, such as TR669796C0012CF31BBD. This ID helps track and reference the specific transaction within the merchant's system.
transaction_data
object
All necessary data for transaction received
affiliate_order_id
string
External Order id
affiliate_id
string
Unique identifier for the sales channel.
source
string
Specifies the origin from from which the order is created, including mobile applications, web interfaces, social media integrations, or external APIs.
currency
object (CurrencySchema)
CurrencySchema
currency_code
string
The ISO 4217 currency code, such as 'INR' for Indian Rupee. This field represents the standardized three-letter code of a currency.
currency_symbol
string
The symbol representing the currency, such as '₹' for Indian Rupee. This is used for display purposes alongside currency amounts.
created_at
string
| date-time
raw_user_agent
string
comment
string
currency_info
object
success
boolean
Key for success or failure
shipments
array of object (PlatformShipment)
Nullable
List of shipments
Array of PlatformShipment
picked_date
string
| date-time
Nullable
Indicates the date and time when the shipment was physically picked up from the sender or the origin point by the delivery service. This timestamp is crucial for tracking the commencement of the shipment's journey.
tracking_list
array of object (TrackingList)
A list of tracking updates associated with the shipment.
Array of TrackingList
is_passed
boolean
Nullable
A flag indicating whether the tracking event has already occurred. If true, it means the event is in the past; otherwise, it is either current or future.
text
string
A descriptive message or status update associated with the tracking event, providing context about the shipment's progress or condition.
is_current
boolean
Nullable
A flag indicating whether this tracking event is the most recent update. If true, it reflects the latest status of the shipment.
time
string
Nullable
A timestamp representing when the tracking event occurred. This helps in understanding the timeline of the shipment's journey.
created_ts
string
Nullable
A timestamp indicating when the tracking information was created or logged in the system. This may differ from the event time.
status
string
The specific status associated with the tracking event, such as "In Transit," "Delivered," or "Out for Delivery," providing clarity on the shipment's current phase.
state
string
invoice
object (InvoiceInfo)
InvoiceInfo
store_invoice_id
string
Nullable
A unique identifier for the invoice generated by the store or platform, used for internal tracking and reference.
invoice_url
string
Nullable
A URL linking to the digital version of the invoice, allowing users to view or download the invoice document online.
updated_date
string
| date-time
Nullable
Denotes the date and time when the invoice information was modified or updated, providing a record of the most recent changes.
external_invoice_id
string
Nullable
An identifier for the invoice used by external systems or partners, facilitating cross-system tracking and reconciliation.
label_url
string
Nullable
A URL linking to the shipping label associated with the invoice, which may be used for shipment tracking and logistics.
credit_note_id
string
Nullable
The identifier for any credit note related to the invoice, used in cases of refunds or adjustments to the original billing.
links
object
An object containing additional links relevant to the invoice, which may include related documents or resources.
shipment_status
string
Nullable
Represents the current status of the shipment.
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
order_status
object (OrderStatusData)
OrderStatusData
order_details
object (OrderDetails)
OrderDetails
fynd_order_id
string
created_at
string
Date and time when the order was created.
user_id
string
Nullable
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
mongo_cart_id
number
Nullable
delivery_charges
number
Nullable
transaction_id
string
Nullable
collect_by
string
headers
object
Nullable
Header details of the order.
coupon_value
number
Nullable
order_value
number
created_time
string
currency
string
The currency in which the prices details associated with the item is specified.
total_order_value
number
ordering_channel
string
meta
object
Nullable
Meta data of the order data contains additional, potentially dynamic information about the order data.
cod_charges
number
Nullable
cashback_value
number
Nullable
refund_by
string
affiliate_order_date
string
| date-time
Nullable
Specifies the date and time of the order when it was created within the affiliate's system. It specifies that the date and time are recorded in ISO 8601 format.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
affiliate_order_id
string
payment_mode_id
number
Nullable
promotion_effective_discount
number
Nullable
mode_of_payment
string
discount
number
Nullable
cashback_applied
number
Nullable
fynd_credits
number
Nullable
affiliate_id
string
ordering_channel_logo
string
Nullable
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
errors
array of string
A list of any errors that occurred while attempting to obtain the order's status.
shipment_details
array of object (ShipmentDetail)
A list of the individual shipments associated with the order and their current statuses.
Array of ShipmentDetail
shipment_id
string
Unique identifier for the shipment associated with the order.
status
string
A string representing the current status of the shipment
id
integer
| int32
An integer that serves as a unique identifier for the shipment detail
bag_list
array of integer
A list of bag identifiers associated with the shipment.
meta
object (Meta)
Meta
kafka_emission_status
integer
| int32
An integer representing the status of the message upon emission to Kafka. 0 indicates success, while 1 indicates failure.
state_manager_used
string
A string that specifies the state manager utilized for handling the order's state.
remarks
string
A string for any additional comments or notes related to the shipment,
text
string
A label or description of the delivery status, such as 'Expected Delivery Date'.
value
string
The detailed delivery status or time information, such as 'Arriving on 24 Nov 2022 15:54:00'.
color_code
string
Hex code for the color representing the delivery status.
expected_delivery_date
string
| date-time
The ISO 8601 formatted date and time when the delivery is expected, e.g., '2022-11-24T22:15:54+00:00'.
delivery_slot
object
Nullable
Represents a specific time window allocated for the delivery of an order or shipment.
order
object (OrderDetailsData)
OrderDetailsData
order_date
string
| date-time
Nullable
Represents the date and time when the order was placed by the customer. This timestamp is essential for tracking the initiation of the order process, scheduling deliveries, and analyzing order timelines.
created_ts
string
Nullable
A timestamp indicating when the order was created in the system.
tax_details
object
Nullable
Contains a flexible and comprehensive set of key-value pairs detailing the tax calculations and classifications applicable to the order.
cod_charges
string
Nullable
The charges associated with Cash on Delivery (COD) payments.
source
string
Nullable
The source from which the order originated.
fynd_order_id
string
An unique identifier for the order.
affiliate_id
string
Nullable
Identifier for the application, can be application_id or extension_id
affiliate_order_id
string
Nullable
Identifier of the order assigned by the application
ordering_channel_logo
object
Nullable
Represents the logo of the channel through which the order was placed, encapsulating branding elements and any relevant styling attributes. This object is designed to be flexible, allowing for the inclusion of various properties that define how the logo should be displayed across different platforms or documents related to the order.
order_value
string
Nullable
The total monetary value of the order
ordering_channel
string
Nullable
The specific channel through which the order was placed
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
payment_methods
object
payment_info
array of object
created_at
string
| date-time
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
raw_user_agent
string
comment
string
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
user
object (UserDataInfo)
UserDataInfo
id
integer
Nullable
The unique identifier associated with the user.
user_oid
string
Nullable
The object ID for the user, used for referencing the user in various operations.
mongo_user_id
string
Nullable
User Object ID assigned within the system
external_customer_id
string
Nullable
The identifier for the user in external systems.
first_name
string
Nullable
The first name of the user.
last_name
string
Nullable
The last name of the user.
mobile
string
Nullable
The mobile phone number of the user.
email
string
Nullable
The email address of the user.
meta
string
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
avis_user_id
string
Nullable
Avis user id
name
string
Nullable
A full name of the user, which may be a combination of first and last name.
gender
string
Nullable
The gender of the user.
country_phone_code
string
The country-specific phone code, useful for formatting mobile numbers correctly.
enable_dp_tracking
boolean
Nullable
A flag indicating whether the delivery partner tracking feature is enabled for this shipment.
custom_message
string
Nullable
A custom message or note associated with the shipment.
estimated_sla_time
string
Nullable
The estimated service level agreement (SLA) time for the shipment, indicating expected delivery timelines.
estimated_sla_ts
string
Nullable
A timestamp indicating when the estimated SLA time is expected to be met.
can_update_dimension
boolean
Nullable
Indicates whether the dimensions of the shipment can be updated after creation.
shipment_images
array of string
Nullable
A list of URLs for images related to the shipment.
delivery_details
object
A list of details about the delivery of an order.
billing_details
object
Information regarding the billing for the shipment, including billing address and payment method.
forward_shipment_id
string
Nullable
The ID of the parent forward journey shipment.
fulfilment_priority
integer
Nullable
The fulfilment priority, with lower numbers indicating a higher priority.
shipment_details
object (ShipmentLockDetails)
ShipmentLockDetails
lock_status
boolean
Nullable
Represents the lock status of the shipment.
lock_message
string
Nullable
A user-friendly message that explains the reason for locking the shipment.
action_to_status
object
Nullable
This field maps potential actions (e.g., downloading an invoice or label) to their corresponding shipment lock statuses, indicating which operations are allowed depending on the shipment's current lock status. When an action is set to 'lock', it means no transitions or updates to the shipment's status can be performed until the specified action is completed. For instance, if 'download_invoice' is in a 'lock' state, the shipment cannot undergo any status transitions until the invoice is either downloaded. Similarly, 'download_label' being in a 'lock' state prevents any shipment status transitions until a new label is downloaded.
custom_meta
array of object
Nullable
An array of custom metadata objects that may contain additional, dynamic information specific to the shipment.
shipment_quantity
integer
Nullable
The total quantity of items included in the shipment.
company_details
object (CompanyDetails)
CompanyDetails
company_name
string
Nullable
The name of the company.
address
object
Nullable
It contains the properties for the address of a company.
company_cin
string
Nullable
The Corporate Identification Number (CIN) of the company.
company_id
integer
Nullable
A unique identifier for the company on the platform.
company_gst
string
Nullable
The Goods and Services Tax (GST) number of the company.
company_contact
object (ContactDetails)
ContactDetails
phone
array of object (PhoneDetails)
Nullable
An array of phone numbers associated with the contact.
Array of PhoneDetails
country_code
integer
Nullable
Identifies the country of the user's phone number using the two-character standard ISO 3166-1 alpha-2 country codes. Examples include 'US' for the United States and 'IN' for India.
number
string
Nullable
The actual phone number of the user.
emails
array of string
Nullable
An array of email addresses associated with the contact.
ordering_store
object (OrderingStoreDetails)
OrderingStoreDetails
phone
string
Nullable
The contact phone number for the ordering store.
pincode
string
Nullable
The postal code associated with the ordering store's location.
meta
object
Nullable
Meta data of the ordering store contains additional, potentially dynamic information about the ordering store.
address
string
Nullable
The complete address of the ordering store.
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
Formatted address based on the title-template provided by the partner.
id
integer
Nullable
A unique identifier for the ordering store.
code
string
Nullable
A specific code associated with the ordering store.
store_name
string
Nullable
The name of the ordering store.
country
string
Nullable
The country in which the ordering store is located.
contact_person
string
Nullable
The name of the primary contact person at the ordering store.
state
string
Nullable
The state or region where the ordering store is situated.
city
string
Nullable
The city in which the ordering store is located.
store_email
string
Nullable
Email address of store
order_platform
string
Nullable
The platform used to place the order.
lock_status
boolean
Nullable
Indicates whether the shipment is currently locked or not for modifications or updates.
platform_logo
string
Nullable
The URL of the ordering platform's logo.
user_agent
string
Nullable
Information about the user agent string, typically containing details about the browser or application used to place the order.
dp_details
object (DPDetailsData)
DPDetailsData
pincode
string
Nullable
The postal code associated with the delivery partner's location
track_url
string
Nullable
A URL that provides access to real-time tracking information for the shipment.
eway_bill_id
string
Nullable
The unique identifier for the e-way bill generated for the shipment.
id
integer
Nullable
A unique identifier for the delivery partner details.
country
string
Nullable
The country in which the delivery partner operates.
awb_no
string
Nullable
The Air Waybill number, a tracking number used for air freight shipments, allowing for the identification and tracking of the package in transit.
gst_tag
string
Nullable
A tag associated with the Goods and Services Tax (GST) for the shipment.
name
string
Nullable
The name of the delivery partner or service provider responsible for transporting the shipment.
dp_charges
number
dp_return_charges
number
amount_handling_charges
number
eway_bill_number
number
Nullable
dp_otp
string
invoice_id
string
Nullable
The unique identifier for the invoice associated with the shipment.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_info
array of object (ShipmentPaymentInfoData)
Nullable
An array of objects containing detailed information about the payments made for the shipment.
Array of ShipmentPaymentInfoData
mode
string
Stands for 'Mode of Payment'. This is a short code (like 'COD' for Cash On Delivery) that represents the payment method used.
name
string
Specifies name of the payment method.
collect_by
string
Whomsoever collected the money
refund_by
string
Whomsoever will refund the money
meta
object
Object that stores additional meta data related to the payment.
amount
number
Amount paid using this payment method.
unique_identifier
string
A unique string identifier for the transaction, this is essential for referencing individual payments.
display_name
string
The name of the payment method as it should be displayed to the user.
transaction_data
object
All necessary data for transaction received
coupon
object
Nullable
Coupon data of the shipment which denotes if coupon is applied, coupon code, coupon amount, coupon title and coupon message.
affiliate_details
object (AffiliateDetails)
AffiliateDetails
shipment_meta
object (ShipmentMeta)
ShipmentMeta
tracking_url
string
Nullable
A URL for tracking the shipment.
estimated_delivery_date
string
| date-time
Nullable
Provides a forecasted date and time by which the shipment is expected to be delivered to the recipient. This estimation is crucial for planning purposes, both for the sender in managing expectations and for the recipient in preparing for receipt.
same_store_available
boolean
Indicates whether the shipment is available for pickup from the same store.
b2b_buyer_details
object (BuyerDetails)
BuyerDetails
ajio_site_id
string
Nullable
The unique identifier for the buyer on the Ajio platform.
pincode
integer
The postal code for the buyer's shipping address, used for delivery location identification.
address
string
Provides the comprehensive address details of the buyer's shipping address.
gstin
string
The Goods and Services Tax Identification Number (GSTIN) of the buyer.
name
string
The full name of the buyer, essential for personalizing communication and delivery.
state
string
The name of the state where the buyer's shipping address is located, important for logistical purposes.
city
string
The name of the city where the buyer's shipping address is located, which helps in identifying delivery zones.
formatted
object (Formatted)
Formatted
max
string
Nullable
Represents the maximum formatted value, providing a limit for the associated data, such as dimensions or weights.
min
string
Nullable
Represents the minimum formatted value, establishing a lower limit for the associated data, ensuring it meets certain criteria or standards.
debug_info
object (DebugInfo)
DebugInfo
stormbreaker_uuid
string
Nullable
A unique identifier (UUID) associated with the Stormbreaker system, used for tracking and debugging purposes in the application.
return_awb_number
string
Nullable
The Air Waybill (AWB) number associated with a return shipment.
is_self_ship
boolean
Nullable
Indicates whether the shipment is a self-shipped order.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
einvoice_info
object (EinvoiceInfo)
EinvoiceInfo
credit_note
object
Nullable
Specifies the reverse einvoice transaction create on government portal.
invoice
object
Nullable
It specifies the forward einvoice transaction created on government portal.
return_affiliate_shipment_id
string
Nullable
The shipment ID associated with a return from an affiliate.
parent_dp_id
string
Nullable
The unique identifier for the parent delivery partner.
shipment_weight
number
Nullable
The total weight of the shipment.
dimension
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
assign_dp_from_sb
boolean
Nullable
Indicates whether to assign the delivery partner from the store’s basket.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
store_invoice_updated_date
string
| date-time
Nullable
Denotes the date and time when the store's invoice related to this shipment was updated. This timestamp is vital for tracking changes to billing details, adjustments in charges, or updates in the invoicing status.
forward_affiliate_shipment_id
string
Nullable
The shipment ID for the forward journey of an affiliate shipment.
return_store_node
integer
Nullable
The identifier for the store node involved in the return process.
fulfilment_priority_text
string
Nullable
Textual representation of the fulfillment priority for the shipment.
shipment_tags
array of object (ShipmentTags)
Tags associated with the shipment for categorization and filtering.
Array of ShipmentTags
slug
string
Nullable
A URL-friendly string representing the tag, often used for routing or categorization.
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
display_text
string
Nullable
A human-readable text representation of the tag, used for display purposes in user interfaces.
external
object
Nullable
External metadata related to the shipment.
awb_number
string
Nullable
The Air Waybill number associated with the shipment.
lock_data
object (LockData)
LockData
locked
boolean
Nullable
Indicates whether the shipment is currently locked for processing (true) or not (false).
mto
boolean
Nullable
A flag indicating whether the shipment is part of a multi-modal transport operation.
lock_message
string
Nullable
An optional message providing additional context or information regarding the lock status.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow.
Enum
ewaybill_info
object
Nullable
Electronic Way Bill details i.e ewayBillNo, ewayBillDate that are utilized in the transportation of goods.
dp_id
string
Nullable
The unique identifier for the delivery partner associated with the shipment.
shipment_volumetric_weight
number
Nullable
The volumetric weight of the shipment, which may differ from its actual weight.
marketplace_store_id
string
Nullable
The unique identifier for the marketplace store associated with the shipment.
return_details
object
Nullable
An object containing the return details of the shipment.
dp_sort_key
string
Nullable
A sort key for the delivery partner, used for prioritization.
packaging_name
string
Nullable
The name of the packaging used for the shipment.
timestamp
object (ShipmentTimeStamp)
ShipmentTimeStamp
max
integer
Nullable
Represents the maximum timestamp value, indicating the latest time relevant to the shipment.
min
integer
Nullable
Represents the minimum timestamp value, indicating the earliest time relevant to the shipment.
auto_trigger_dp_assignment_acf
boolean
Nullable
Indicates whether automatic delivery partner assignment is triggered for this shipment.
dp_name
string
Nullable
The name of the delivery partner associated with the shipment.
po_number
string
Nullable
The purchase order number associated with the shipment.
weight
integer
The weight of the shipment, typically measured in grams or kilograms.
b2c_buyer_details
object
Nullable
Contains detailed information about the buyer in a business-to-consumer (B2C) transaction. This object is designed to capture a wide array of buyer-specific data such as contact information, shipping address, preferences, and any other relevant details that enhance the understanding of the buyer's profile and needs.
forward_affiliate_order_id
string
Nullable
The order ID for the forward journey of an affiliate shipment.
return_affiliate_order_id
string
Nullable
The order ID for the return journey of an affiliate shipment.
bag_weight
object
Nullable
This object is designed to accommodate a range of weight-related information. Denotes the weight of the bag, potentially including various measurements or related details.
refund_to
string
Nullable
Specifies the recipient of any refunds related to the shipment.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_shipment_id
string
The shipment ID specific to this affiliate.
company_affiliate_tag
string
Nullable
An optional tag representing the company's affiliate association.
affiliate_order_id
string
The order ID associated with the affiliate shipment.
pdf_links
object (PDFLinks)
PDFLinks
invoice_type
string
The type of invoice issued, such as 'fynd' or other classifications.
Enum
label_a6
string
Nullable
URL or path to the A6 size label document.
invoice
string
Nullable
URL or path to the main invoice document.
label_pos
string
Nullable
URL or path to the POS label document.
invoice_a6
string
Nullable
URL or path to the A6 size invoice document.
b2b
string
Nullable
URL or path to the B2B document related to the transaction.
label
string
Nullable
URL or path to the general label document.
label_a4
string
Nullable
URL or path to the A4 size label document.
label_type
string
Specifies the type of label associated with a PDF document,indicating its purpose or content. The label_type helps in organizing and identifying PDF documents quickly, ensuring that users or systems can efficiently utilize the correct documents for required actions.
Enum
invoice_export
string
Nullable
URL or path to the exported invoice document.
credit_note_url
string
Nullable
URL or path to the credit note document.
delivery_challan_a4
string
Nullable
URL or path to the A4 delivery challan document.
label_export
string
Nullable
URL or path to the exported label document.
invoice_a4
string
Nullable
URL or path to the A4 size invoice document.
invoice_pos
string
Nullable
URL or path to the POS invoice document.
po_invoice
string
Nullable
URL or path to the purchase order invoice document.
config
object (AffiliateConfig)
AffiliateConfig
app
object (AffiliateAppConfig)
AffiliateAppConfig
id
string
description
string
updated_at
string
| date-time
The date and time when the app config was updated.
name
string
token
string
meta
array of object (AffiliateAppConfigMeta)
Array of AffiliateAppConfigMeta
value
string
name
string
owner
string
secret
string
created_at
string
| date-time
Timestamp when the app config was created.
inventory
object (AffiliateInventoryConfig)
AffiliateInventoryConfig
article_assignment
object (AffiliateInventoryArticleAssignmentConfig)
AffiliateInventoryArticleAssignmentConfig
post_order_reassignment
boolean
payment
object (AffiliateInventoryPaymentConfig)
AffiliateInventoryPaymentConfig
source
string
mode_of_payment
string
inventory
object (AffiliateInventoryStoreConfig)
AffiliateInventoryStoreConfig
store
object
Fulfilling store information related to the shipment.
order
object (AffiliateInventoryOrderConfig)
AffiliateInventoryOrderConfig
force_reassignment
boolean
logistics
object (AffiliateInventoryLogisticsConfig)
AffiliateInventoryLogisticsConfig
dp_assignment
boolean
app_company_id
integer
Nullable
A unique identifier for the company associated with the affiliate app, used for tracking and managing affiliate relationships.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_id
string
Nullable
The unique identifier for the affiliate.
affiliate_store_id
string
The unique identifier for the affiliate's store.
affiliate_bag_id
string
The unique identifier for the affiliate's bag.
id
string
Nullable
The unique identifier for the affiliate.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
priority_text
string
Nullable
Text that indicates the priority level of the shipment.
bag_status_history
array of object (BagStatusHistory)
A history of status changes for bags associated with the shipment.
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
is_dp_assign_enabled
boolean
Nullable
A flag indicating whether delivery partner assignment features are enabled for the shipment.
bags
array of object (OrderBags)
A list of bags included in the shipment
Array of OrderBags
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
bag_status
array of object (BagStatusHistory)
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
parent_promo_bags
object
Nullable
An object containing details of parent promotional bags.
financial_breakup
object (FinancialBreakup)
FinancialBreakup
refund_credit
number
Refund credits provided to the customer
amount_paid_roundoff
integer
Nullable
Amount paid rounded off
price_effective
number
MRP - Initial Seller provided discount
promotion_effective_discount
number
Effective promotion discount including promotions given by seller and Platform
transfer_price
number
article
coupon_effective_discount
number
Coupon provided by brand or seller
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
tax_collected_at_source
number
Nullable
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Price Effective - Coupon Discount (Seller) - Promotion (Seller)
delivery_charge
number
The fee associated with the delivery service for transporting the item to its destination
gst_tag
string
Type of GST applied - IGST, CGST, SGST
hsn_code
string
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
cashback
number
Cashback points
item_name
string
The name of the item being referenced
value_of_good
number
Effective selling price - Product GST Amount
cashback_applied
number
Cashback applied on the order
cod_charges
number
The fee associated with the COD order
price_marked
number
The indicated price or value assigned to an item before any discounts or adjustments
size
string
The physical dimensions or specifications of the item, indicating its size or measurements
amount_paid
number
Amount paid by the customer
coupon_value
number
Stores the coupon value as shown in the cart
discount
number
The total amount discounted from the original MRP/actual price
fynd_credits
number
Credits provided by Fynd
gst_tax_percentage
number
The percentage rate of GST applied to a product or service
amount_to_be_collected
number
Amount to be collected in case of multiple modes of payments.
identifiers
object (Identifier)
Identifier
alu
string
Nullable
The ALU (Article Level Unit) code used to identify the item at a detailed level, often specific to certain retail or distribution systems.
ean
string
Nullable
The European Article Number (EAN) is a unique identifier for products, primarily used in retail and logistics. It helps in tracking and managing inventory across various platforms.
sku_code
string
Nullable
The Stock Keeping Unit (SKU) code of the item - uniquely identifies each distinct product. SKUs are used to track inventory levels, facilitate accurate stocktaking, and streamline order fulfillment processes. This code is essential for inventory management, allowing for the differentiation between products based on attributes such as price, color, and size.
upc
string
Nullable
The Universal Product Code (UPC) is a barcode symbol used for tracking trade items in stores. It is widely used in North America and helps in identifying products quickly during point-of-sale transactions.
isbn
string
Nullable
The International Standard Book Number (ISBN) is a unique identifier for books, allowing for easier management and tracking of book inventories in retail and library systems.
total_units
integer
Total number of units of the item
added_to_fynd_cash
boolean
Flag indicating whether fynd cash has been used
refund_amount
number
tcs_percentage
number
bag_configs
object (BagConfigs)
BagConfigs
is_returnable
boolean
Indicates whether the bag is eligible for return by the customer.
allow_force_return
boolean
A flag that determines if a forced return can be initiated for the bag.
is_active
boolean
A flag indicating whether the bag is active or not.
can_be_cancelled
boolean
A flag that determines if the bag can be cancelled.
enable_tracking
boolean
A flag that determines if shipment tracking is enabled for the bag.
is_customer_return_allowed
boolean
A flag that determines if customer return is allowed for the bag.
seller_identifier
string
Nullable
Sellers identifier of the article
delivery_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
article
object (OrderBagArticle)
OrderBagArticle
identifiers
object
Nullable
Details of Identifiers associated with the article.
return_config
object (ReturnConfig)
ReturnConfig
returnable
boolean
Nullable
Flag indicating whether product is returnable or not
time
number
Nullable
Number indicating number of hours or days
unit
string
Nullable
String indicating the unit of the time, eg. days, hours
uid
string
Nullable
A unique identifier for the article within the order bag.
size
string
Nullable
The size of the article, which may be relevant for clothing.
tags
array of string
Nullable
An array of tags associated with the article.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
group_info
object
group_info_ids
array of object
brand
object (OrderBrandName)
OrderBrandName
logo
string
Nullable
A URL or path to the logo image associated with the brand.
company
integer
Nullable
A unique identifier for the company associated with the brand.
id
integer
A unique identifier for the brand within the system.
created_on
string
| date-time
Nullable
Timestamp when the brand of the order was created.
brand_name
string
Nullable
The name of the brand associated with the order.
modified_on
string
| date-time
Nullable
Timestamp when the brand of the order was modified.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
group_id
string
Nullable
affiliate_bag_details
object (AffiliateBagsDetails)
AffiliateBagsDetails
affiliate_bag_id
string
Nullable
A unique identifier for the affiliate bag.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
item
object (PlatformItem)
PlatformItem
id
integer
Nullable
Unique identifier for the platform item.
attributes
object (PlatformArticleAttributes)
PlatformArticleAttributes
currency
string
Nullable
The currency in which the price of the article is specified.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
brand_id
integer
Nullable
Identifier for the brand associated with the item.
slug_key
string
Nullable
A user-friendly string that represents the item, often used in URLs.
l3_category
integer
Nullable
Represents the product's classification at the third level in the e-commerce platform's category hierarchy, using an integer identifier.
l3_category_name
string
Nullable
Name of the third-level category under which the product is listed.
last_updated_at
string
| date-time
Nullable
Timestamp when any aspect of the associated record was modified, formatted as date-time.
name
string
Nullable
The name of the product item.
l2_category
array of string
Nullable
Represents the second level of categorization for items, helping customers narrow down their search.
brand
string
Nullable
Name of the brand associated with the item.
image
array of string
Nullable
Array of image URLs representing the item.
code
string
Nullable
Unique code for the item, often used for inventory management.
l1_category
array of string
Nullable
Represents the highest or top-tier level of categorization for the product.
size
string
Nullable
Size specification of the product, if applicable.
can_cancel
boolean
Nullable
Indicates whether the item can be canceled after order placement.
can_return
boolean
Nullable
Indicates whether the item is eligible for return.
branch_url
string
Nullable
URL linking to a specific branch or store where the item is available.
meta
object
Nullable
Meta data containing additional, dynamic information about the item.
color
string
Nullable
Color specification of the product, if applicable.
department_id
integer
Nullable
Identifier for the department associated with the product.
images
array of string
Nullable
Array of image URLs representing different views or angles of the item.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
tags
array of string
l2_category_id
number
payment_methods
array of object (BagPaymentMethods)
An array detailing the various payment methods utilized for the transaction. Each item within this array represents a distinct method of payment. It encapsulates the details of various payment methods available for completing a transaction. It includes comprehensive information such as the payment mode, amount, transaction status, and identifiers for each payment method.
Array of BagPaymentMethods
mode
string
Nullable
The payment mode used for the transaction.
amount
number
Nullable
The total amount associated with the payment method
refund_by
string
collect_by
string
display_name
string
payment_info
array of object (BagPaymentMethods)
Array of BagPaymentMethods
mode
string
Nullable
The payment mode used for the transaction.
amount
number
Nullable
The total amount associated with the payment method
refund_by
string
collect_by
string
display_name
string
quantity
number
Nullable
The number of items contained in the bag.
identifier
string
Nullable
A unique identifier for the bag.
can_return
boolean
Nullable
Indicates whether the items in the bag are eligible for return by the customer.
can_cancel
boolean
Nullable
Indicates whether the bag is eligible for cancellation by the customer.
display_name
string
Nullable
A user-friendly name for the bag.
line_number
integer
Nullable
A unique identifier for each line item in a bag.
meta
object
Meta data of the bags contains additional, potentially dynamic information about the bags.
applied_promos
array of object (AppliedPromos)
Array of AppliedPromos
promotion_type
string
Nullable
Specifies the type of discount or deal applied to the current promotion, defining how the promotion modifies the price or adds value to the purchase. Each type represents a different promotional strategy - percentage- Discount by a percentage of the original price. - amount- Discount by a specific amount off the original price. - fixed_price- Sets the price to a specific fixed amount. - bogo- Buy One Get One or at a discount. - contract_price- Special pricing based on a contract or agreement. - shipping_price- Discount or deal related to the shipping cost. - ladder_price- Price changes based on quantity purchased. - bundle_price_percentage- Discount on a bundle purchase by a percentage. - bundle_price_amount- Discount on a bundle purchase by a specific amount. - bundle_amount_percentage- A percentage of the purchase amount is applied as a discount when buying in a bundle. - custom- A custom promotion not covered by other types. - free_gift_items- Free gift items are included with the purchase. - free_non_sellable_items- Free items that are not for sale are included with the purchase.
Enum
promotion_name
string
Nullable
The name of the promotional campaign or offer.
discount_rules
array of object (DiscountRules)
A list of rules that define the conditions under which discounts are applied.
Array of DiscountRules
value
integer
Nullable
type
string
Nullable
amount
number
Nullable
The total monetary value of the discount or promotion.
article_quantity
integer
Nullable
The quantity of articles required to qualify for the promotion.
buy_rules
array of object (BuyRules)
A list of rules that outline the conditions for purchasing items under the promotion.
Array of BuyRules
item_criteria
object (ItemCriterias)
ItemCriterias
item_brand
array of integer
Nullable
cart_conditions
object
Nullable
Specifies the rules that must be met at the cart level for any purchasing rules or promotional discounts to be applied. Specifically, it includes criteria such as the total quantity of items in the cart. For instance, a rule might require that the cart contains at least one item for the promotion to apply. This setup allows for the dynamic application of discounts or special buying rules based on cart conditions.
promo_id
string
Nullable
A unique identifier for the promotion.
mrp_promotion
boolean
Nullable
A flag that designates whether or not the promotion is an MRP (manufacturer's reduced price) promotion.
applied_free_articles
array of object (AppliedFreeArticles)
A list of articles that are eligible for free under the promotion.
Array of AppliedFreeArticles
article_id
string
A unique identifier for the article to which the free gift is applied.
free_gift_item_details
object (FreeGiftItems)
Details of the free gift item associated with the article, including relevant attributes like name, description, and any other specifications.
FreeGiftItems
item_slug
string
A unique identifier for the item, typically used in URLs for SEO purposes.
item_name
string
The name of the item.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
The minimum price value. Represents the lowest price in the price range.
max
number
| float
The maximum price value. Represents the highest price in the price range.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
The minimum price value. Represents the lowest price in the price range.
max
number
| float
The maximum price value. Represents the highest price in the price range.
currency
string
The currency in which the prices details associated with the item is specified.
item_brand_name
string
The brand name of the item.
item_id
integer
| int32
A unique numerical identifier for the item.
item_images_url
array of string
A list of URLs pointing to images of the item.
parent_item_identifier
string
An identifier for the parent item with which the free gift is associated, typically used to link the free gift to the original purchased item.
quantity
number
The quantity of the free gift items applied to the article.
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
current_status
object (CurrentStatus)
CurrentStatus
store_id
integer
Nullable
A unique identifier for the store associated with the shipment.
delivery_awb_number
string
Nullable
The Air Waybill (AWB) number for the delivery.
kafka_sync
boolean
Nullable
A flag indicating whether the current status is synchronized with Kafka or not.
delivery_partner_id
integer
Nullable
A unique identifier for the delivery partner responsible for handling the shipment.
state_type
string
Nullable
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey, including route optimization and carrier selection.
Enum
state_id
integer
Nullable
A unique identifier for the specific state of the shipment.
id
integer
A unique identifier for the current status entry
created_at
string
| date-time
Nullable
Denotes the date and time when the bag status was created.
created_ts
string
| date-time
Nullable
A timestamp indicating when the status was created
shipment_id
string
Nullable
A unique identifier for the shipment.
updated_at
string
| date-time
Nullable
The date and time when the current status was last updated.
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
A unique identifier for the bag associated with the shipment.
status
string
Nullable
A descriptive label representing the current status of the shipment.
bag_id
integer
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
is_parent
boolean
Nullable
A flag indicating whether the current bag is a parent entity or not.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
mark_as_returnable
boolean
returnable_date
string
| date-time
Nullable
dp_assignment
boolean
Nullable
Indicates whether a delivery partner has been assigned to the shipment.
total_items
integer
Nullable
The total number of items contained within the shipment,
fulfilling_store
object (FulfillingStore)
FulfillingStore
phone
string
The contact phone number for the fulfilling store.
pincode
string
The postal code for the fulfilling store's location.
meta
object
Meta data of the fulfilling store contains additional, potentially dynamic information about the fulfilling store.
address
string
The complete address of the fulfilling store.
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
Display friendly version of the Fulfilment Store Address.
id
integer
The unique id or identifier of a fulfilment store.
code
string
The unique code of the fulfilment store.
store_name
string
The unique name of a fulfillment store.
country
string
The name of the country associated with a specific fulfilment store.
fulfillment_channel
string
The channel through which fulfillment is managed.
contact_person
string
The name of the contact person associated with a fulfilling store.
state
string
The state or region where the fulfilling store is located.
city
string
The city in which the fulfilling store is situated.
store_email
string
Nullable
Email of the recipient associated with the store
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
meta
object
Meta data of the shipment contains additional, potentially dynamic information about the shipment.
pdf_links
object
PDF Links associated with the shipment.
payment_mode
string
Nullable
The mode of payment used for the shipment.
packaging_type
string
Nullable
Defines the type of packaging used for the product, encompassing materials, design, and form factors.
journey_type
string
Nullable
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
An array of charges applied to the shipment.
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
vertical
string
Nullable
The business vertical or category to which the shipment belongs.
shipment_id
string
A unique identifier for the shipment.
payments
object (ShipmentPayments)
ShipmentPayments
mode
string
Nullable
The payment mode used for the shipment.
logo
string
Nullable
A URL or path to the logo associated with the payment method.
source
string
Nullable
The source or origin of the payment
operational_status
string
Nullable
The operational status of the shipment.
status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
total_bags
integer
Nullable
The total number of bags in the shipment.
shipment_created_at
string
| date-time
Nullable
Denotes the date and time when the shipment was created.
shipment_created_ts
string
Nullable
A timestamp representing when the shipment was created.
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
is_lapa_enabled
boolean
Flag to show NDR actions based on LAPA (Logistic As Per Actual) plan subscription. If LAPA plan taken, true, else false.
previous_shipment_id
string
Nullable
The ID of the previous shipment in the sequence.
shipment_update_time
number
Nullable
A numerical representation of the last update time for the shipment
rto_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
credit_note_id
string
Nullable
The identifier for any credit note issued for the shipment
is_self_ship
boolean
Nullable
A flag indicating whether the shipment is being self-shipped by the seller or vendor.
mode_of_payment
string
Nullable
The specific mode of payment used for the transaction
affiliate_shipment_id
string
Nullable
Identifier of the shipment assigned by the application
tracking_url
string
Nullable
URL for monitoring the status and location of the shipment.
forward_end_shipment_id
string
Nullable
The forward_end_shipment_id represents the shipment ID of the original forward journey shipment. When a shipment is transitioned to a return journey, the original shipment ID from the forward journey is recorded in the forward_end_shipment_id field of the return journey shipment. Even if the return shipment is later split into multiple shipments, each of these shipments will retain the same forward_end_shipment_id value that was assigned during the initial return journey initiation. This ensures that all return shipments can be traced back to the original forward journey shipment.
logistics_meta
object
An object storing detailed logistics-related information, including courier partner details and other relevant metadata.
refund_information
array of object
manifest_id
string
Nullable
company_id
number
pickup_slot
object
can_process
boolean
mark_as_returnable
boolean
order_source_domain
string
actionable
boolean
transition_config
object
next_possible_states
object
is_processing
boolean
total_bag_qty
number
order_created_time
string
order_created_ts
string
company
object
fyndstore_emp
object
is_not_fynd_source
boolean
is_fynd_coupon
boolean
user_id
string
email_id
string
escalation
object
Nullable
beneficiary_details
boolean
can_break
boolean
Nullable
is_packaging_order
boolean
delivery_status
array of object
current_shipment_status
object
order_type
string
Enum
can_cancel
boolean
enable_tracking
boolean
can_return
boolean
is_invoiced
boolean
child_nodes
array of object
user_info
object
status_progress
number
items
array of object
refund_details
array of object
financial_status
string
Nullable
track_info
array of object
Examples
Parameters
company_id:
3
order_id:
"FY639CC0D90F0FC2331C"
Was this section helpful?
GET
Response
Get order by ID.
getOrderById
Parameters
company_id
integer
Required
Id of company
super_lane
string
Name of lane for which data is to be fetched
Enum
group_entity
string
Name of group entity
Enum
from_date
string
| date-time
Start Date in DD-MM-YYYY format
to_date
string
| date-time
start_date
string
| date-time
UTC Start Date in ISO format
end_date
string
| date-time
UTC End Date in ISO format
dp_ids
string
Comma separated values of delivery partner ids
stores
string
Comma separated values of store ids
sales_channels
string
payment_mode
string
Comma separated values of payment modes
bag_status
string
Comma separated values of bag statuses
search_type
string
search_type refers to the field that will be used as the target for the search operation
Enum
search_value
string
tags
string
time_to_dispatch
integer
time_to_dispatch refers to estimated SLA time.
payment_methods
string
my_orders
boolean
show_cross_company_data
boolean
Flag to view cross & non-cross company order
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
Response
200
400
Response containing count of shipments of the given status
LaneConfigResponseSchema
super_lanes
array of object (SuperLane)
Array of SuperLane
value
string
options
array of object (SubLane)
Array of SubLane
value
string
text
string
total_items
integer
actions
array of object
index
integer
text
string
total_items
integer
Examples
Parameters
company_id:
2
super_lane:
"unfulfilled"
group_entity:
"shipments"
from_date:
"2024-02-18T18:30:00Z"
to_date:
"2024-03-20T18:29:59Z"
start_date:
"2024-02-18T18:30:00Z"
end_date:
"2024-03-20T18:29:59Z"
dp_ids:
"12,19"
stores:
"34,19"
sales_channels:
"fynd"
payment_mode:
"all"
bag_status:
"delivered"
search_type:
"shipment_id"
search_value:
"16984021739051838556"
tags:
"12,19"
time_to_dispatch:
1
payment_methods:
"all"
my_orders:
true
order_type:
"HomeDelivery"
Was this section helpful?
GET
Response
Get lane configuration.
getLaneConfig
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
lane
string
Lane refers to a section where orders are assigned, indicating its grouping
Enum
search_type
string
Search_type refers to the field that will be used as the target for the search operation
Enum
bag_status
string
Bag_status refers to the status of the entity. Filters orders based on the status.
time_to_dispatch
integer
Time_to_dispatch refers to the estimated SLA time.
payment_methods
string
Comma separated values of payment methods that were used to place order.
tags
string
Tags refer to additional descriptive labels associated with the order
search_value
string
Search_value is matched against the field specified by the search_type
Default Value : 16854460524441037000
from_date
string
| date-time
Date time in UTC timezone as per ISO format.
to_date
string
| date-time
Date time in UTC timezone as per ISO format.
start_date
string
| date-time
Date time in UTC timezone as per ISO format.
end_date
string
| date-time
Date time in UTC timezone as per ISO format.
dp_ids
string
Delivery Partner IDs to which shipments are assigned.
stores
string
A comma-separated list of store IDs used to filter results to only those related to specific stores.
sales_channels
string
A comma-separated list of sales channel IDs to filter results based on the sales channels involved.
page_no
integer
Specifies the page number for paginated results.
Default Value : 1
page_size
integer
Determines the number of results returned per page.
Default Value : 10
is_priority_sort
boolean
custom_meta
array of object
my_orders
boolean
show_cross_company_data
boolean
Flag to view cross & non-cross company order
customer_id
string
The unique identifier for the customer associated with the query, useful for filtering results to a specific customer.
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
operational_status
string
Statuses relating to shipment transition in order processing journey. Comma separated values of operational statuses.
financial_status
string
Statuses relating to finance related operations in the order processing journey. Comma separated values of financial statuses.
logistics_status
string
Statuses relating to delivery and pickup related operations in the order processing journey. Comma separated values of logistics statuses.
parent_view_slug
string
Parent view is used for grouping of child views. Slug of parent view.
child_view_slug
string
Child view is user configured view, which has filters added by the user on which shipments/orders are fetched. Slug of child view.
group_entity
string
Defines the grouping criterion for retrieving shipments or orders. It specifies whether the results should be organized based on shipment groups or order groups. For example, using 'shipments' groups results by shipment, while an invalid value like 'abcd' may not be recognized, leading to errors or default behavior.
enforce_date_filter
boolean
Applies a date filter for listing orders. This is useful when fetching data for a specific date range while performing searches.
Default Value : false
Response
200
400
We are processing the report!
OrderListingResponseSchema
filters
object (Filters)
Nullable
Filters
date_range
object (DateRange)
DateRange
from_date
string
The start date of the range.
to_date
string
| date
end_date
string
| date
start_date
string
| date
logo
string
CDN link of the logo displayed on the manifest page.
from_date
string
The start date for filtering records, provided in UTC and formatted in ISO format.
stores
integer
| int32
Specifies a specific store ID for filtering the records.
to_date
string
The end date for filtering records, provided in UTC and formatted in ISO format.
dp_name
string
The name of the courier partner to filter records by.
dp_ids
string
| int32
Combination of courier partner ids separated by comma operator.
lane
string
Specifies criteria related to the shipment lanes.
selected_shipments
string
A list of selected shipments that are mapped to the manifest.
store_name
string
The name of the store for filtering records.
deselected_shipments
string
A list of shipments that have been unmapped from the manifest.
type
string
total_count
integer
Nullable
The total number of orders matching the query criteria.
message
string
Nullable
A message providing additional context about the response.
success
boolean
Nullable
Indicates whether the API call was successful (true) or not (false).
items
array of object (PlatformOrderItems)
Nullable
An array of shipment items returned as part of the response.
Array of PlatformOrderItems
breakup_values
array of object (PlatformBreakupValues)
The breakup_values array contains detailed breakdowns of different pricing components related to an order. Each item in the array is a reference to the PlatformBreakupValues schema, which provides specific details about each component such as loyalty points, coupon discounts, raw pricing data, and display information.
Array of PlatformBreakupValues
value
string
Nullable
Represents the value associated with a specific component of the price breakdown.
name
string
Nullable
Represents the name associated with a specific component of the price breakdown.
display
string
Nullable
A user-friendly display name for the component, intended for presentation in user interfaces.
total_order_value
number
Nullable
Total order value
meta
object
Nullable
It contains the additional properties related to order transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic, potentially.
order_created_time
string
Nullable
The Date and time when the order was created.
order_created_ts
string
Nullable
The timestamp indicating when the order was created.
payment_mode
string
Nullable
The payment mode used for the order.
shipments
array of object (PlatformShipment)
An array of shipment items returned as part of the order.
Array of PlatformShipment
picked_date
string
| date-time
Nullable
Indicates the date and time when the shipment was physically picked up from the sender or the origin point by the delivery service. This timestamp is crucial for tracking the commencement of the shipment's journey.
tracking_list
array of object (TrackingList)
A list of tracking updates associated with the shipment.
Array of TrackingList
is_passed
boolean
Nullable
A flag indicating whether the tracking event has already occurred. If true, it means the event is in the past; otherwise, it is either current or future.
text
string
A descriptive message or status update associated with the tracking event, providing context about the shipment's progress or condition.
is_current
boolean
Nullable
A flag indicating whether this tracking event is the most recent update. If true, it reflects the latest status of the shipment.
time
string
Nullable
A timestamp representing when the tracking event occurred. This helps in understanding the timeline of the shipment's journey.
created_ts
string
Nullable
A timestamp indicating when the tracking information was created or logged in the system. This may differ from the event time.
status
string
The specific status associated with the tracking event, such as "In Transit," "Delivered," or "Out for Delivery," providing clarity on the shipment's current phase.
state
string
invoice
object (InvoiceInfo)
InvoiceInfo
store_invoice_id
string
Nullable
A unique identifier for the invoice generated by the store or platform, used for internal tracking and reference.
invoice_url
string
Nullable
A URL linking to the digital version of the invoice, allowing users to view or download the invoice document online.
updated_date
string
| date-time
Nullable
Denotes the date and time when the invoice information was modified or updated, providing a record of the most recent changes.
external_invoice_id
string
Nullable
An identifier for the invoice used by external systems or partners, facilitating cross-system tracking and reconciliation.
label_url
string
Nullable
A URL linking to the shipping label associated with the invoice, which may be used for shipment tracking and logistics.
credit_note_id
string
Nullable
The identifier for any credit note related to the invoice, used in cases of refunds or adjustments to the original billing.
links
object
An object containing additional links relevant to the invoice, which may include related documents or resources.
shipment_status
string
Nullable
Represents the current status of the shipment.
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
order_status
object (OrderStatusData)
OrderStatusData
order_details
object (OrderDetails)
OrderDetails
fynd_order_id
string
created_at
string
Date and time when the order was created.
user_id
string
Nullable
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
mongo_cart_id
number
Nullable
delivery_charges
number
Nullable
transaction_id
string
Nullable
collect_by
string
headers
object
Nullable
Header details of the order.
coupon_value
number
Nullable
order_value
number
created_time
string
currency
string
The currency in which the prices details associated with the item is specified.
total_order_value
number
ordering_channel
string
meta
object
Nullable
Meta data of the order data contains additional, potentially dynamic information about the order data.
cod_charges
number
Nullable
cashback_value
number
Nullable
refund_by
string
affiliate_order_date
string
| date-time
Nullable
Specifies the date and time of the order when it was created within the affiliate's system. It specifies that the date and time are recorded in ISO 8601 format.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
affiliate_order_id
string
payment_mode_id
number
Nullable
promotion_effective_discount
number
Nullable
mode_of_payment
string
discount
number
Nullable
cashback_applied
number
Nullable
fynd_credits
number
Nullable
affiliate_id
string
ordering_channel_logo
string
Nullable
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
errors
array of string
A list of any errors that occurred while attempting to obtain the order's status.
shipment_details
array of object (ShipmentDetail)
A list of the individual shipments associated with the order and their current statuses.
Array of ShipmentDetail
shipment_id
string
Unique identifier for the shipment associated with the order.
status
string
A string representing the current status of the shipment
id
integer
| int32
An integer that serves as a unique identifier for the shipment detail
bag_list
array of integer
A list of bag identifiers associated with the shipment.
meta
object (Meta)
Meta
kafka_emission_status
integer
| int32
An integer representing the status of the message upon emission to Kafka. 0 indicates success, while 1 indicates failure.
state_manager_used
string
A string that specifies the state manager utilized for handling the order's state.
remarks
string
A string for any additional comments or notes related to the shipment,
text
string
A label or description of the delivery status, such as 'Expected Delivery Date'.
value
string
The detailed delivery status or time information, such as 'Arriving on 24 Nov 2022 15:54:00'.
color_code
string
Hex code for the color representing the delivery status.
expected_delivery_date
string
| date-time
The ISO 8601 formatted date and time when the delivery is expected, e.g., '2022-11-24T22:15:54+00:00'.
delivery_slot
object
Nullable
Represents a specific time window allocated for the delivery of an order or shipment.
order
object (OrderDetailsData)
OrderDetailsData
order_date
string
| date-time
Nullable
Represents the date and time when the order was placed by the customer. This timestamp is essential for tracking the initiation of the order process, scheduling deliveries, and analyzing order timelines.
created_ts
string
Nullable
A timestamp indicating when the order was created in the system.
tax_details
object
Nullable
Contains a flexible and comprehensive set of key-value pairs detailing the tax calculations and classifications applicable to the order.
cod_charges
string
Nullable
The charges associated with Cash on Delivery (COD) payments.
source
string
Nullable
The source from which the order originated.
fynd_order_id
string
An unique identifier for the order.
affiliate_id
string
Nullable
Identifier for the application, can be application_id or extension_id
affiliate_order_id
string
Nullable
Identifier of the order assigned by the application
ordering_channel_logo
object
Nullable
Represents the logo of the channel through which the order was placed, encapsulating branding elements and any relevant styling attributes. This object is designed to be flexible, allowing for the inclusion of various properties that define how the logo should be displayed across different platforms or documents related to the order.
order_value
string
Nullable
The total monetary value of the order
ordering_channel
string
Nullable
The specific channel through which the order was placed
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
payment_methods
object
payment_info
array of object
created_at
string
| date-time
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
raw_user_agent
string
comment
string
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
user
object (UserDataInfo)
UserDataInfo
id
integer
Nullable
The unique identifier associated with the user.
user_oid
string
Nullable
The object ID for the user, used for referencing the user in various operations.
mongo_user_id
string
Nullable
User Object ID assigned within the system
external_customer_id
string
Nullable
The identifier for the user in external systems.
first_name
string
Nullable
The first name of the user.
last_name
string
Nullable
The last name of the user.
mobile
string
Nullable
The mobile phone number of the user.
email
string
Nullable
The email address of the user.
meta
string
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
avis_user_id
string
Nullable
Avis user id
name
string
Nullable
A full name of the user, which may be a combination of first and last name.
gender
string
Nullable
The gender of the user.
country_phone_code
string
The country-specific phone code, useful for formatting mobile numbers correctly.
enable_dp_tracking
boolean
Nullable
A flag indicating whether the delivery partner tracking feature is enabled for this shipment.
custom_message
string
Nullable
A custom message or note associated with the shipment.
estimated_sla_time
string
Nullable
The estimated service level agreement (SLA) time for the shipment, indicating expected delivery timelines.
estimated_sla_ts
string
Nullable
A timestamp indicating when the estimated SLA time is expected to be met.
can_update_dimension
boolean
Nullable
Indicates whether the dimensions of the shipment can be updated after creation.
shipment_images
array of string
Nullable
A list of URLs for images related to the shipment.
delivery_details
object
A list of details about the delivery of an order.
billing_details
object
Information regarding the billing for the shipment, including billing address and payment method.
forward_shipment_id
string
Nullable
The ID of the parent forward journey shipment.
fulfilment_priority
integer
Nullable
The fulfilment priority, with lower numbers indicating a higher priority.
shipment_details
object (ShipmentLockDetails)
ShipmentLockDetails
lock_status
boolean
Nullable
Represents the lock status of the shipment.
lock_message
string
Nullable
A user-friendly message that explains the reason for locking the shipment.
action_to_status
object
Nullable
This field maps potential actions (e.g., downloading an invoice or label) to their corresponding shipment lock statuses, indicating which operations are allowed depending on the shipment's current lock status. When an action is set to 'lock', it means no transitions or updates to the shipment's status can be performed until the specified action is completed. For instance, if 'download_invoice' is in a 'lock' state, the shipment cannot undergo any status transitions until the invoice is either downloaded. Similarly, 'download_label' being in a 'lock' state prevents any shipment status transitions until a new label is downloaded.
custom_meta
array of object
Nullable
An array of custom metadata objects that may contain additional, dynamic information specific to the shipment.
shipment_quantity
integer
Nullable
The total quantity of items included in the shipment.
company_details
object (CompanyDetails)
CompanyDetails
company_name
string
Nullable
The name of the company.
address
object
Nullable
It contains the properties for the address of a company.
company_cin
string
Nullable
The Corporate Identification Number (CIN) of the company.
company_id
integer
Nullable
A unique identifier for the company on the platform.
company_gst
string
Nullable
The Goods and Services Tax (GST) number of the company.
company_contact
object (ContactDetails)
ContactDetails
phone
array of object (PhoneDetails)
Nullable
An array of phone numbers associated with the contact.
Array of PhoneDetails
country_code
integer
Nullable
Identifies the country of the user's phone number using the two-character standard ISO 3166-1 alpha-2 country codes. Examples include 'US' for the United States and 'IN' for India.
number
string
Nullable
The actual phone number of the user.
emails
array of string
Nullable
An array of email addresses associated with the contact.
ordering_store
object (OrderingStoreDetails)
OrderingStoreDetails
phone
string
Nullable
The contact phone number for the ordering store.
pincode
string
Nullable
The postal code associated with the ordering store's location.
meta
object
Nullable
Meta data of the ordering store contains additional, potentially dynamic information about the ordering store.
address
string
Nullable
The complete address of the ordering store.
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
Formatted address based on the title-template provided by the partner.
id
integer
Nullable
A unique identifier for the ordering store.
code
string
Nullable
A specific code associated with the ordering store.
store_name
string
Nullable
The name of the ordering store.
country
string
Nullable
The country in which the ordering store is located.
contact_person
string
Nullable
The name of the primary contact person at the ordering store.
state
string
Nullable
The state or region where the ordering store is situated.
city
string
Nullable
The city in which the ordering store is located.
store_email
string
Nullable
Email address of store
order_platform
string
Nullable
The platform used to place the order.
lock_status
boolean
Nullable
Indicates whether the shipment is currently locked or not for modifications or updates.
platform_logo
string
Nullable
The URL of the ordering platform's logo.
user_agent
string
Nullable
Information about the user agent string, typically containing details about the browser or application used to place the order.
dp_details
object (DPDetailsData)
DPDetailsData
pincode
string
Nullable
The postal code associated with the delivery partner's location
track_url
string
Nullable
A URL that provides access to real-time tracking information for the shipment.
eway_bill_id
string
Nullable
The unique identifier for the e-way bill generated for the shipment.
id
integer
Nullable
A unique identifier for the delivery partner details.
country
string
Nullable
The country in which the delivery partner operates.
awb_no
string
Nullable
The Air Waybill number, a tracking number used for air freight shipments, allowing for the identification and tracking of the package in transit.
gst_tag
string
Nullable
A tag associated with the Goods and Services Tax (GST) for the shipment.
name
string
Nullable
The name of the delivery partner or service provider responsible for transporting the shipment.
dp_charges
number
dp_return_charges
number
amount_handling_charges
number
eway_bill_number
number
Nullable
dp_otp
string
invoice_id
string
Nullable
The unique identifier for the invoice associated with the shipment.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_info
array of object (ShipmentPaymentInfoData)
Nullable
An array of objects containing detailed information about the payments made for the shipment.
Array of ShipmentPaymentInfoData
mode
string
Stands for 'Mode of Payment'. This is a short code (like 'COD' for Cash On Delivery) that represents the payment method used.
name
string
Specifies name of the payment method.
collect_by
string
Whomsoever collected the money
refund_by
string
Whomsoever will refund the money
meta
object
Object that stores additional meta data related to the payment.
amount
number
Amount paid using this payment method.
unique_identifier
string
A unique string identifier for the transaction, this is essential for referencing individual payments.
display_name
string
The name of the payment method as it should be displayed to the user.
transaction_data
object
All necessary data for transaction received
coupon
object
Nullable
Coupon data of the shipment which denotes if coupon is applied, coupon code, coupon amount, coupon title and coupon message.
affiliate_details
object (AffiliateDetails)
AffiliateDetails
shipment_meta
object (ShipmentMeta)
ShipmentMeta
tracking_url
string
Nullable
A URL for tracking the shipment.
estimated_delivery_date
string
| date-time
Nullable
Provides a forecasted date and time by which the shipment is expected to be delivered to the recipient. This estimation is crucial for planning purposes, both for the sender in managing expectations and for the recipient in preparing for receipt.
same_store_available
boolean
Indicates whether the shipment is available for pickup from the same store.
b2b_buyer_details
object (BuyerDetails)
BuyerDetails
ajio_site_id
string
Nullable
The unique identifier for the buyer on the Ajio platform.
pincode
integer
The postal code for the buyer's shipping address, used for delivery location identification.
address
string
Provides the comprehensive address details of the buyer's shipping address.
gstin
string
The Goods and Services Tax Identification Number (GSTIN) of the buyer.
name
string
The full name of the buyer, essential for personalizing communication and delivery.
state
string
The name of the state where the buyer's shipping address is located, important for logistical purposes.
city
string
The name of the city where the buyer's shipping address is located, which helps in identifying delivery zones.
formatted
object (Formatted)
Formatted
max
string
Nullable
Represents the maximum formatted value, providing a limit for the associated data, such as dimensions or weights.
min
string
Nullable
Represents the minimum formatted value, establishing a lower limit for the associated data, ensuring it meets certain criteria or standards.
debug_info
object (DebugInfo)
DebugInfo
stormbreaker_uuid
string
Nullable
A unique identifier (UUID) associated with the Stormbreaker system, used for tracking and debugging purposes in the application.
return_awb_number
string
Nullable
The Air Waybill (AWB) number associated with a return shipment.
is_self_ship
boolean
Nullable
Indicates whether the shipment is a self-shipped order.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
einvoice_info
object (EinvoiceInfo)
EinvoiceInfo
credit_note
object
Nullable
Specifies the reverse einvoice transaction create on government portal.
invoice
object
Nullable
It specifies the forward einvoice transaction created on government portal.
return_affiliate_shipment_id
string
Nullable
The shipment ID associated with a return from an affiliate.
parent_dp_id
string
Nullable
The unique identifier for the parent delivery partner.
shipment_weight
number
Nullable
The total weight of the shipment.
dimension
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
assign_dp_from_sb
boolean
Nullable
Indicates whether to assign the delivery partner from the store’s basket.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
store_invoice_updated_date
string
| date-time
Nullable
Denotes the date and time when the store's invoice related to this shipment was updated. This timestamp is vital for tracking changes to billing details, adjustments in charges, or updates in the invoicing status.
forward_affiliate_shipment_id
string
Nullable
The shipment ID for the forward journey of an affiliate shipment.
return_store_node
integer
Nullable
The identifier for the store node involved in the return process.
fulfilment_priority_text
string
Nullable
Textual representation of the fulfillment priority for the shipment.
shipment_tags
array of object (ShipmentTags)
Tags associated with the shipment for categorization and filtering.
Array of ShipmentTags
slug
string
Nullable
A URL-friendly string representing the tag, often used for routing or categorization.
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
display_text
string
Nullable
A human-readable text representation of the tag, used for display purposes in user interfaces.
external
object
Nullable
External metadata related to the shipment.
awb_number
string
Nullable
The Air Waybill number associated with the shipment.
lock_data
object (LockData)
LockData
locked
boolean
Nullable
Indicates whether the shipment is currently locked for processing (true) or not (false).
mto
boolean
Nullable
A flag indicating whether the shipment is part of a multi-modal transport operation.
lock_message
string
Nullable
An optional message providing additional context or information regarding the lock status.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow.
Enum
ewaybill_info
object
Nullable
Electronic Way Bill details i.e ewayBillNo, ewayBillDate that are utilized in the transportation of goods.
dp_id
string
Nullable
The unique identifier for the delivery partner associated with the shipment.
shipment_volumetric_weight
number
Nullable
The volumetric weight of the shipment, which may differ from its actual weight.
marketplace_store_id
string
Nullable
The unique identifier for the marketplace store associated with the shipment.
return_details
object
Nullable
An object containing the return details of the shipment.
dp_sort_key
string
Nullable
A sort key for the delivery partner, used for prioritization.
packaging_name
string
Nullable
The name of the packaging used for the shipment.
timestamp
object (ShipmentTimeStamp)
ShipmentTimeStamp
max
integer
Nullable
Represents the maximum timestamp value, indicating the latest time relevant to the shipment.
min
integer
Nullable
Represents the minimum timestamp value, indicating the earliest time relevant to the shipment.
auto_trigger_dp_assignment_acf
boolean
Nullable
Indicates whether automatic delivery partner assignment is triggered for this shipment.
dp_name
string
Nullable
The name of the delivery partner associated with the shipment.
po_number
string
Nullable
The purchase order number associated with the shipment.
weight
integer
The weight of the shipment, typically measured in grams or kilograms.
b2c_buyer_details
object
Nullable
Contains detailed information about the buyer in a business-to-consumer (B2C) transaction. This object is designed to capture a wide array of buyer-specific data such as contact information, shipping address, preferences, and any other relevant details that enhance the understanding of the buyer's profile and needs.
forward_affiliate_order_id
string
Nullable
The order ID for the forward journey of an affiliate shipment.
return_affiliate_order_id
string
Nullable
The order ID for the return journey of an affiliate shipment.
bag_weight
object
Nullable
This object is designed to accommodate a range of weight-related information. Denotes the weight of the bag, potentially including various measurements or related details.
refund_to
string
Nullable
Specifies the recipient of any refunds related to the shipment.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_shipment_id
string
The shipment ID specific to this affiliate.
company_affiliate_tag
string
Nullable
An optional tag representing the company's affiliate association.
affiliate_order_id
string
The order ID associated with the affiliate shipment.
pdf_links
object (PDFLinks)
PDFLinks
invoice_type
string
The type of invoice issued, such as 'fynd' or other classifications.
Enum
label_a6
string
Nullable
URL or path to the A6 size label document.
invoice
string
Nullable
URL or path to the main invoice document.
label_pos
string
Nullable
URL or path to the POS label document.
invoice_a6
string
Nullable
URL or path to the A6 size invoice document.
b2b
string
Nullable
URL or path to the B2B document related to the transaction.
label
string
Nullable
URL or path to the general label document.
label_a4
string
Nullable
URL or path to the A4 size label document.
label_type
string
Specifies the type of label associated with a PDF document,indicating its purpose or content. The label_type helps in organizing and identifying PDF documents quickly, ensuring that users or systems can efficiently utilize the correct documents for required actions.
Enum
invoice_export
string
Nullable
URL or path to the exported invoice document.
credit_note_url
string
Nullable
URL or path to the credit note document.
delivery_challan_a4
string
Nullable
URL or path to the A4 delivery challan document.
label_export
string
Nullable
URL or path to the exported label document.
invoice_a4
string
Nullable
URL or path to the A4 size invoice document.
invoice_pos
string
Nullable
URL or path to the POS invoice document.
po_invoice
string
Nullable
URL or path to the purchase order invoice document.
config
object (AffiliateConfig)
AffiliateConfig
app
object (AffiliateAppConfig)
AffiliateAppConfig
id
string
description
string
updated_at
string
| date-time
The date and time when the app config was updated.
name
string
token
string
meta
array of object (AffiliateAppConfigMeta)
Array of AffiliateAppConfigMeta
value
string
name
string
owner
string
secret
string
created_at
string
| date-time
Timestamp when the app config was created.
inventory
object (AffiliateInventoryConfig)
AffiliateInventoryConfig
article_assignment
object (AffiliateInventoryArticleAssignmentConfig)
AffiliateInventoryArticleAssignmentConfig
post_order_reassignment
boolean
payment
object (AffiliateInventoryPaymentConfig)
AffiliateInventoryPaymentConfig
source
string
mode_of_payment
string
inventory
object (AffiliateInventoryStoreConfig)
AffiliateInventoryStoreConfig
store
object
Fulfilling store information related to the shipment.
order
object (AffiliateInventoryOrderConfig)
AffiliateInventoryOrderConfig
force_reassignment
boolean
logistics
object (AffiliateInventoryLogisticsConfig)
AffiliateInventoryLogisticsConfig
dp_assignment
boolean
app_company_id
integer
Nullable
A unique identifier for the company associated with the affiliate app, used for tracking and managing affiliate relationships.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_id
string
Nullable
The unique identifier for the affiliate.
affiliate_store_id
string
The unique identifier for the affiliate's store.
affiliate_bag_id
string
The unique identifier for the affiliate's bag.
id
string
Nullable
The unique identifier for the affiliate.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
priority_text
string
Nullable
Text that indicates the priority level of the shipment.
bag_status_history
array of object (BagStatusHistory)
A history of status changes for bags associated with the shipment.
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
is_dp_assign_enabled
boolean
Nullable
A flag indicating whether delivery partner assignment features are enabled for the shipment.
bags
array of object (OrderBags)
A list of bags included in the shipment
Array of OrderBags
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
bag_status
array of object (BagStatusHistory)
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
parent_promo_bags
object
Nullable
An object containing details of parent promotional bags.
financial_breakup
object (FinancialBreakup)
FinancialBreakup
refund_credit
number
Refund credits provided to the customer
amount_paid_roundoff
integer
Nullable
Amount paid rounded off
price_effective
number
MRP - Initial Seller provided discount
promotion_effective_discount
number
Effective promotion discount including promotions given by seller and Platform
transfer_price
number
article
coupon_effective_discount
number
Coupon provided by brand or seller
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
tax_collected_at_source
number
Nullable
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Price Effective - Coupon Discount (Seller) - Promotion (Seller)
delivery_charge
number
The fee associated with the delivery service for transporting the item to its destination
gst_tag
string
Type of GST applied - IGST, CGST, SGST
hsn_code
string
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
cashback
number
Cashback points
item_name
string
The name of the item being referenced
value_of_good
number
Effective selling price - Product GST Amount
cashback_applied
number
Cashback applied on the order
cod_charges
number
The fee associated with the COD order
price_marked
number
The indicated price or value assigned to an item before any discounts or adjustments
size
string
The physical dimensions or specifications of the item, indicating its size or measurements
amount_paid
number
Amount paid by the customer
coupon_value
number
Stores the coupon value as shown in the cart
discount
number
The total amount discounted from the original MRP/actual price
fynd_credits
number
Credits provided by Fynd
gst_tax_percentage
number
The percentage rate of GST applied to a product or service
amount_to_be_collected
number
Amount to be collected in case of multiple modes of payments.
identifiers
object (Identifier)
Identifier
alu
string
Nullable
The ALU (Article Level Unit) code used to identify the item at a detailed level, often specific to certain retail or distribution systems.
ean
string
Nullable
The European Article Number (EAN) is a unique identifier for products, primarily used in retail and logistics. It helps in tracking and managing inventory across various platforms.
sku_code
string
Nullable
The Stock Keeping Unit (SKU) code of the item - uniquely identifies each distinct product. SKUs are used to track inventory levels, facilitate accurate stocktaking, and streamline order fulfillment processes. This code is essential for inventory management, allowing for the differentiation between products based on attributes such as price, color, and size.
upc
string
Nullable
The Universal Product Code (UPC) is a barcode symbol used for tracking trade items in stores. It is widely used in North America and helps in identifying products quickly during point-of-sale transactions.
isbn
string
Nullable
The International Standard Book Number (ISBN) is a unique identifier for books, allowing for easier management and tracking of book inventories in retail and library systems.
total_units
integer
Total number of units of the item
added_to_fynd_cash
boolean
Flag indicating whether fynd cash has been used
refund_amount
number
tcs_percentage
number
bag_configs
object (BagConfigs)
BagConfigs
is_returnable
boolean
Indicates whether the bag is eligible for return by the customer.
allow_force_return
boolean
A flag that determines if a forced return can be initiated for the bag.
is_active
boolean
A flag indicating whether the bag is active or not.
can_be_cancelled
boolean
A flag that determines if the bag can be cancelled.
enable_tracking
boolean
A flag that determines if shipment tracking is enabled for the bag.
is_customer_return_allowed
boolean
A flag that determines if customer return is allowed for the bag.
seller_identifier
string
Nullable
Sellers identifier of the article
delivery_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
article
object (OrderBagArticle)
OrderBagArticle
identifiers
object
Nullable
Details of Identifiers associated with the article.
return_config
object (ReturnConfig)
ReturnConfig
returnable
boolean
Nullable
Flag indicating whether product is returnable or not
time
number
Nullable
Number indicating number of hours or days
unit
string
Nullable
String indicating the unit of the time, eg. days, hours
uid
string
Nullable
A unique identifier for the article within the order bag.
size
string
Nullable
The size of the article, which may be relevant for clothing.
tags
array of string
Nullable
An array of tags associated with the article.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
group_info
object
group_info_ids
array of object
brand
object (OrderBrandName)
OrderBrandName
logo
string
Nullable
A URL or path to the logo image associated with the brand.
company
integer
Nullable
A unique identifier for the company associated with the brand.
id
integer
A unique identifier for the brand within the system.
created_on
string
| date-time
Nullable
Timestamp when the brand of the order was created.
brand_name
string
Nullable
The name of the brand associated with the order.
modified_on
string
| date-time
Nullable
Timestamp when the brand of the order was modified.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
group_id
string
Nullable
affiliate_bag_details
object (AffiliateBagsDetails)
AffiliateBagsDetails
affiliate_bag_id
string
Nullable
A unique identifier for the affiliate bag.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
item
object (PlatformItem)
PlatformItem
id
integer
Nullable
Unique identifier for the platform item.
attributes
object (PlatformArticleAttributes)
PlatformArticleAttributes
currency
string
Nullable
The currency in which the price of the article is specified.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
brand_id
integer
Nullable
Identifier for the brand associated with the item.
slug_key
string
Nullable
A user-friendly string that represents the item, often used in URLs.
l3_category
integer
Nullable
Represents the product's classification at the third level in the e-commerce platform's category hierarchy, using an integer identifier.
l3_category_name
string
Nullable
Name of the third-level category under which the product is listed.
last_updated_at
string
| date-time
Nullable
Timestamp when any aspect of the associated record was modified, formatted as date-time.
name
string
Nullable
The name of the product item.
l2_category
array of string
Nullable
Represents the second level of categorization for items, helping customers narrow down their search.
brand
string
Nullable
Name of the brand associated with the item.
image
array of string
Nullable
Array of image URLs representing the item.
code
string
Nullable
Unique code for the item, often used for inventory management.
l1_category
array of string
Nullable
Represents the highest or top-tier level of categorization for the product.
size
string
Nullable
Size specification of the product, if applicable.
can_cancel
boolean
Nullable
Indicates whether the item can be canceled after order placement.
can_return
boolean
Nullable
Indicates whether the item is eligible for return.
branch_url
string
Nullable
URL linking to a specific branch or store where the item is available.
meta
object
Nullable
Meta data containing additional, dynamic information about the item.
color
string
Nullable
Color specification of the product, if applicable.
department_id
integer
Nullable
Identifier for the department associated with the product.
images
array of string
Nullable
Array of image URLs representing different views or angles of the item.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
tags
array of string
l2_category_id
number
payment_methods
array of object (BagPaymentMethods)
An array detailing the various payment methods utilized for the transaction. Each item within this array represents a distinct method of payment. It encapsulates the details of various payment methods available for completing a transaction. It includes comprehensive information such as the payment mode, amount, transaction status, and identifiers for each payment method.
Array of BagPaymentMethods
mode
string
Nullable
The payment mode used for the transaction.
amount
number
Nullable
The total amount associated with the payment method
refund_by
string
collect_by
string
display_name
string
payment_info
array of object (BagPaymentMethods)
Array of BagPaymentMethods
mode
string
Nullable
The payment mode used for the transaction.
amount
number
Nullable
The total amount associated with the payment method
refund_by
string
collect_by
string
display_name
string
quantity
number
Nullable
The number of items contained in the bag.
identifier
string
Nullable
A unique identifier for the bag.
can_return
boolean
Nullable
Indicates whether the items in the bag are eligible for return by the customer.
can_cancel
boolean
Nullable
Indicates whether the bag is eligible for cancellation by the customer.
display_name
string
Nullable
A user-friendly name for the bag.
line_number
integer
Nullable
A unique identifier for each line item in a bag.
meta
object
Meta data of the bags contains additional, potentially dynamic information about the bags.
applied_promos
array of object (AppliedPromos)
Array of AppliedPromos
promotion_type
string
Nullable
Specifies the type of discount or deal applied to the current promotion, defining how the promotion modifies the price or adds value to the purchase. Each type represents a different promotional strategy - percentage- Discount by a percentage of the original price. - amount- Discount by a specific amount off the original price. - fixed_price- Sets the price to a specific fixed amount. - bogo- Buy One Get One or at a discount. - contract_price- Special pricing based on a contract or agreement. - shipping_price- Discount or deal related to the shipping cost. - ladder_price- Price changes based on quantity purchased. - bundle_price_percentage- Discount on a bundle purchase by a percentage. - bundle_price_amount- Discount on a bundle purchase by a specific amount. - bundle_amount_percentage- A percentage of the purchase amount is applied as a discount when buying in a bundle. - custom- A custom promotion not covered by other types. - free_gift_items- Free gift items are included with the purchase. - free_non_sellable_items- Free items that are not for sale are included with the purchase.
Enum
promotion_name
string
Nullable
The name of the promotional campaign or offer.
discount_rules
array of object (DiscountRules)
A list of rules that define the conditions under which discounts are applied.
Array of DiscountRules
value
integer
Nullable
type
string
Nullable
amount
number
Nullable
The total monetary value of the discount or promotion.
article_quantity
integer
Nullable
The quantity of articles required to qualify for the promotion.
buy_rules
array of object (BuyRules)
A list of rules that outline the conditions for purchasing items under the promotion.
Array of BuyRules
item_criteria
object (ItemCriterias)
ItemCriterias
item_brand
array of integer
Nullable
cart_conditions
object
Nullable
Specifies the rules that must be met at the cart level for any purchasing rules or promotional discounts to be applied. Specifically, it includes criteria such as the total quantity of items in the cart. For instance, a rule might require that the cart contains at least one item for the promotion to apply. This setup allows for the dynamic application of discounts or special buying rules based on cart conditions.
promo_id
string
Nullable
A unique identifier for the promotion.
mrp_promotion
boolean
Nullable
A flag that designates whether or not the promotion is an MRP (manufacturer's reduced price) promotion.
applied_free_articles
array of object (AppliedFreeArticles)
A list of articles that are eligible for free under the promotion.
Array of AppliedFreeArticles
article_id
string
A unique identifier for the article to which the free gift is applied.
free_gift_item_details
object (FreeGiftItems)
Details of the free gift item associated with the article, including relevant attributes like name, description, and any other specifications.
FreeGiftItems
item_slug
string
A unique identifier for the item, typically used in URLs for SEO purposes.
item_name
string
The name of the item.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
The minimum price value. Represents the lowest price in the price range.
max
number
| float
The maximum price value. Represents the highest price in the price range.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
The minimum price value. Represents the lowest price in the price range.
max
number
| float
The maximum price value. Represents the highest price in the price range.
currency
string
The currency in which the prices details associated with the item is specified.
item_brand_name
string
The brand name of the item.
item_id
integer
| int32
A unique numerical identifier for the item.
item_images_url
array of string
A list of URLs pointing to images of the item.
parent_item_identifier
string
An identifier for the parent item with which the free gift is associated, typically used to link the free gift to the original purchased item.
quantity
number
The quantity of the free gift items applied to the article.
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
current_status
object (CurrentStatus)
CurrentStatus
store_id
integer
Nullable
A unique identifier for the store associated with the shipment.
delivery_awb_number
string
Nullable
The Air Waybill (AWB) number for the delivery.
kafka_sync
boolean
Nullable
A flag indicating whether the current status is synchronized with Kafka or not.
delivery_partner_id
integer
Nullable
A unique identifier for the delivery partner responsible for handling the shipment.
state_type
string
Nullable
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey, including route optimization and carrier selection.
Enum
state_id
integer
Nullable
A unique identifier for the specific state of the shipment.
id
integer
A unique identifier for the current status entry
created_at
string
| date-time
Nullable
Denotes the date and time when the bag status was created.
created_ts
string
| date-time
Nullable
A timestamp indicating when the status was created
shipment_id
string
Nullable
A unique identifier for the shipment.
updated_at
string
| date-time
Nullable
The date and time when the current status was last updated.
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
A unique identifier for the bag associated with the shipment.
status
string
Nullable
A descriptive label representing the current status of the shipment.
bag_id
integer
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
is_parent
boolean
Nullable
A flag indicating whether the current bag is a parent entity or not.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
mark_as_returnable
boolean
returnable_date
string
| date-time
Nullable
dp_assignment
boolean
Nullable
Indicates whether a delivery partner has been assigned to the shipment.
total_items
integer
Nullable
The total number of items contained within the shipment,
fulfilling_store
object (FulfillingStore)
FulfillingStore
phone
string
The contact phone number for the fulfilling store.
pincode
string
The postal code for the fulfilling store's location.
meta
object
Meta data of the fulfilling store contains additional, potentially dynamic information about the fulfilling store.
address
string
The complete address of the fulfilling store.
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
Display friendly version of the Fulfilment Store Address.
id
integer
The unique id or identifier of a fulfilment store.
code
string
The unique code of the fulfilment store.
store_name
string
The unique name of a fulfillment store.
country
string
The name of the country associated with a specific fulfilment store.
fulfillment_channel
string
The channel through which fulfillment is managed.
contact_person
string
The name of the contact person associated with a fulfilling store.
state
string
The state or region where the fulfilling store is located.
city
string
The city in which the fulfilling store is situated.
store_email
string
Nullable
Email of the recipient associated with the store
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
meta
object
Meta data of the shipment contains additional, potentially dynamic information about the shipment.
pdf_links
object
PDF Links associated with the shipment.
payment_mode
string
Nullable
The mode of payment used for the shipment.
packaging_type
string
Nullable
Defines the type of packaging used for the product, encompassing materials, design, and form factors.
journey_type
string
Nullable
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
An array of charges applied to the shipment.
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
vertical
string
Nullable
The business vertical or category to which the shipment belongs.
shipment_id
string
A unique identifier for the shipment.
payments
object (ShipmentPayments)
ShipmentPayments
mode
string
Nullable
The payment mode used for the shipment.
logo
string
Nullable
A URL or path to the logo associated with the payment method.
source
string
Nullable
The source or origin of the payment
operational_status
string
Nullable
The operational status of the shipment.
status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
total_bags
integer
Nullable
The total number of bags in the shipment.
shipment_created_at
string
| date-time
Nullable
Denotes the date and time when the shipment was created.
shipment_created_ts
string
Nullable
A timestamp representing when the shipment was created.
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
is_lapa_enabled
boolean
Flag to show NDR actions based on LAPA (Logistic As Per Actual) plan subscription. If LAPA plan taken, true, else false.
previous_shipment_id
string
Nullable
The ID of the previous shipment in the sequence.
shipment_update_time
number
Nullable
A numerical representation of the last update time for the shipment
rto_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
credit_note_id
string
Nullable
The identifier for any credit note issued for the shipment
is_self_ship
boolean
Nullable
A flag indicating whether the shipment is being self-shipped by the seller or vendor.
mode_of_payment
string
Nullable
The specific mode of payment used for the transaction
affiliate_shipment_id
string
Nullable
Identifier of the shipment assigned by the application
tracking_url
string
Nullable
URL for monitoring the status and location of the shipment.
forward_end_shipment_id
string
Nullable
The forward_end_shipment_id represents the shipment ID of the original forward journey shipment. When a shipment is transitioned to a return journey, the original shipment ID from the forward journey is recorded in the forward_end_shipment_id field of the return journey shipment. Even if the return shipment is later split into multiple shipments, each of these shipments will retain the same forward_end_shipment_id value that was assigned during the initial return journey initiation. This ensures that all return shipments can be traced back to the original forward journey shipment.
logistics_meta
object
An object storing detailed logistics-related information, including courier partner details and other relevant metadata.
refund_information
array of object
manifest_id
string
Nullable
company_id
number
pickup_slot
object
can_process
boolean
mark_as_returnable
boolean
order_source_domain
string
actionable
boolean
transition_config
object
next_possible_states
object
is_processing
boolean
total_bag_qty
number
order_created_time
string
order_created_ts
string
company
object
fyndstore_emp
object
is_not_fynd_source
boolean
is_fynd_coupon
boolean
user_id
string
email_id
string
escalation
object
Nullable
beneficiary_details
boolean
can_break
boolean
Nullable
is_packaging_order
boolean
delivery_status
array of object
current_shipment_status
object
order_type
string
Enum
can_cancel
boolean
enable_tracking
boolean
can_return
boolean
is_invoiced
boolean
child_nodes
array of object
user_info
object
status_progress
number
items
array of object
refund_details
array of object
financial_status
string
Nullable
track_info
array of object
order_id
string
Nullable
A unique identifier associated with the order.
channel
object (PlatformChannel)
PlatformChannel
logo
string
Nullable
Represents the logo of the channel through which the order was placed.
name
string
Nullable
Represents the name of the channel through which the order was placed
user_info
object (UserDataInfo)
UserDataInfo
id
integer
Nullable
The unique identifier associated with the user.
user_oid
string
Nullable
The object ID for the user, used for referencing the user in various operations.
mongo_user_id
string
Nullable
User Object ID assigned within the system
external_customer_id
string
Nullable
The identifier for the user in external systems.
first_name
string
Nullable
The first name of the user.
last_name
string
Nullable
The last name of the user.
mobile
string
Nullable
The mobile phone number of the user.
email
string
Nullable
The email address of the user.
meta
string
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
avis_user_id
string
Nullable
Avis user id
name
string
Nullable
A full name of the user, which may be a combination of first and last name.
gender
string
Nullable
The gender of the user.
country_phone_code
string
The country-specific phone code, useful for formatting mobile numbers correctly.
order_value
number
Nullable
Value of the order
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
affiliate_order_id
string
Nullable
Identifier of the order assigned by the application
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
lane
string
Nullable
The lane associated with the order.
page
object (Page)
Page
item_total
integer
| int32
The total number of items on the page.
next_id
string
The identifier for the next page.
has_previous
boolean
Indicates whether there is a previous page.
has_next
boolean
Indicates whether there is a next page.
current
integer
| int32
The current page number.
type
string
The type of the page, such as 'PageType'.
size
integer
| int32
The number of items per page.
total
integer
| int32
Total number of items.
Examples
Parameters
company_id:
2
lane:
"new"
search_type:
"shipment_id"
bag_status:
"placed, bag_confirmed, bag_invoiced"
time_to_dispatch:
1
payment_methods:
"credit_card"
tags:
"fragile"
search_value:
"16854460524441037000"
from_date:
"2024-02-18T18:30:00Z"
to_date:
"2024-03-20T18:29:59Z"
start_date:
"2024-02-18T18:30:00Z"
end_date:
"2024-03-20T18:29:59Z"
dp_ids:
"19"
stores:
"12"
sales_channels:
"000000000000000000000001,614b42d1ea943427b5f46d1e"
page_no:
1
page_size:
10
is_priority_sort:
true
custom_meta:
my_orders:
true
customer_id:
"63a2ce177e9f59d3166dd700"
order_type:
"HomeDelivery"
operational_status:
"placed,bag_confirmed"
financial_status:
"refund_initiated,refund_completed"
logistics_status:
"dummy_logistics_state"
parent_view_slug:
"unfulfilled"
child_view_slug:
"new"
group_entity:
"orders"
Was this section helpful?
GET
Response
Get orders.
getOrders
Update User view(Parent view and child view) position
Parameters
company_id
integer
Required
Id of company
Request body
view_type
string
Required
Type of user created view that is used on platform to fetch shipments/orders based on filters added. child_view => View with filters to fetch shipments/orders. parent_view => Used to group child views.
Enum
view_id
string
Id(view id) used for updating position of child view.
slug
string
Slug(parent view slug) used for updating position of parent view.
label
string
Label(parent view text) used for updating position of parent view.
new_position
integer
Required
New position of the view.
show_in
string
Required
Name of view on platform (shipment_view, order_view)
Response
200
Success. Check the example shown below.
CreateUpdateDeleteResponseSchema
message
string
success
boolean
errors
array of string
Indicates events of errors at the time of processing views.
Examples
Parameters
company_id:
2
body:
body
Was this section helpful?
PUT
Response
Update User view(Parent view and child view) position
updateUserViewPosition
Get custom view for every unique user cross company pair.
Parameters
company_id
integer
Required
Id of company
show_in
string
Required
Name of view to get filters for.
Enum
Response
200
Success. Check the example shown below.
UserViewsResponseSchema
parent_views
array of object (ParentViews)
Array of ParentViews
views
array of object (ViewDetails)
Used to fetch shipments/orders based on filters added by user.
Array of ViewDetails
id
string
Unique identifier of a view. Used to update/delete/edit a view.
slug
string
Used to identify a View.
label
string
Name of the view.
filters
array of object (FiltersList)
Criterion on which shipments/orders must be fetched.
Array of FiltersList
label
string
Name of the filter.
value
string
Key of the filter to query the input data on.
filter_type
string
To identify if its a global filter or advanced filters. global filters => Shown on UI alongside listing. advanced filters => Shown on panel on right side opened by clicking on filter icon.
Enum
type
string
Type of the filter.
Enum
placeholder_text
string
Sample input text.
required
boolean
If field value is required or not.
is_active
boolean
Whether the filter should be shown on ui or not.
options
array of object (FilterOptions)
Different options of a single filter.
Array of FilterOptions
label
string
Name of the FilterOption.
value
string
Key of the filterOption to query the input data on.
state_type
string
To identify type of status (financial, operational, logistics)
name
string
Name of the FilterOption.
text
string
Text of the FilterOption.
min_search_size
integer
Minimum search size.
placeholder_text
string
Placeholder showing hint what text can be passed into filter.
show_ui
boolean
Whether to show on UI or not.
is_editable
boolean
Flag to identify if view is editable(whether filters can be updated) or not.
position
integer
Position of the view on UI.
show_in
string
Name of view on platform (shipment_view, order_view)
slug
string
Used to identify a parent view.
label
string
Name of the view.
is_editable
boolean
Flag to identify if view is editable(whether filters can be updated) or not.
position
integer
Position of the parent view on UI.
show_in
string
Name of view on platform (shipment_view, order_view)
Examples
Parameters
company_id:
2
show_in:
"shipment_view"
Was this section helpful?
GET
Response
Get custom view for every unique user cross company pair.
getUserViews
Add custom view for every unique user cross company pair.
Parameters
company_id
integer
Required
Id of company
Request body
parent_views
array of object (ParentViews)
Array of ParentViews
views
array of object (ViewDetails)
Required
Used to fetch shipments/orders based on filters added by user.
Array of ViewDetails
id
string
Unique identifier of a view. Used to update/delete/edit a view.
slug
string
Required
Used to identify a View.
label
string
Required
Name of the view.
filters
array of object (FiltersList)
Criterion on which shipments/orders must be fetched.
Array of FiltersList
label
string
Required
Name of the filter.
value
string
Required
Key of the filter to query the input data on.
filter_type
string
To identify if its a global filter or advanced filters. global filters => Shown on UI alongside listing. advanced filters => Shown on panel on right side opened by clicking on filter icon.
Enum
type
string
Type of the filter.
Enum
placeholder_text
string
Sample input text.
required
boolean
If field value is required or not.
is_active
boolean
Whether the filter should be shown on ui or not.
options
array of object (FilterOptions)
Different options of a single filter.
Array of FilterOptions
label
string
Required
Name of the FilterOption.
value
string
Required
Key of the filterOption to query the input data on.
state_type
string
To identify type of status (financial, operational, logistics)
name
string
Name of the FilterOption.
text
string
Text of the FilterOption.
min_search_size
integer
Minimum search size.
placeholder_text
string
Placeholder showing hint what text can be passed into filter.
show_ui
boolean
Whether to show on UI or not.
is_editable
boolean
Required
Flag to identify if view is editable(whether filters can be updated) or not.
position
integer
Position of the view on UI.
show_in
string
Required
Name of view on platform (shipment_view, order_view)
slug
string
Required
Used to identify a parent view.
label
string
Required
Name of the view.
is_editable
boolean
Required
Flag to identify if view is editable(whether filters can be updated) or not.
position
integer
Position of the parent view on UI.
show_in
string
Required
Name of view on platform (shipment_view, order_view)
Response
200
Success. Check the example shown below.
CreateUpdateDeleteResponseSchema
message
string
success
boolean
errors
array of string
Indicates events of errors at the time of processing views.
Examples
Parameters
company_id:
2
body:
body
Was this section helpful?
POST
Response
Add custom view for every unique user cross company pair.
addUserViews
Update custom view for every unique user cross company pair.
Parameters
company_id
integer
Required
Id of company
Request body
parent_views
array of object (ParentViews)
Array of ParentViews
views
array of object (ViewDetails)
Required
Used to fetch shipments/orders based on filters added by user.
Array of ViewDetails
id
string
Unique identifier of a view. Used to update/delete/edit a view.
slug
string
Required
Used to identify a View.
label
string
Required
Name of the view.
filters
array of object (FiltersList)
Criterion on which shipments/orders must be fetched.
Array of FiltersList
label
string
Required
Name of the filter.
value
string
Required
Key of the filter to query the input data on.
filter_type
string
To identify if its a global filter or advanced filters. global filters => Shown on UI alongside listing. advanced filters => Shown on panel on right side opened by clicking on filter icon.
Enum
type
string
Type of the filter.
Enum
placeholder_text
string
Sample input text.
required
boolean
If field value is required or not.
is_active
boolean
Whether the filter should be shown on ui or not.
options
array of object (FilterOptions)
Different options of a single filter.
Array of FilterOptions
label
string
Required
Name of the FilterOption.
value
string
Required
Key of the filterOption to query the input data on.
state_type
string
To identify type of status (financial, operational, logistics)
name
string
Name of the FilterOption.
text
string
Text of the FilterOption.
min_search_size
integer
Minimum search size.
placeholder_text
string
Placeholder showing hint what text can be passed into filter.
show_ui
boolean
Whether to show on UI or not.
is_editable
boolean
Required
Flag to identify if view is editable(whether filters can be updated) or not.
position
integer
Position of the view on UI.
show_in
string
Required
Name of view on platform (shipment_view, order_view)
slug
string
Required
Used to identify a parent view.
label
string
Required
Name of the view.
is_editable
boolean
Required
Flag to identify if view is editable(whether filters can be updated) or not.
position
integer
Position of the parent view on UI.
show_in
string
Required
Name of view on platform (shipment_view, order_view)
Response
200
Success. Check the example shown below.
CreateUpdateDeleteResponseSchema
message
string
success
boolean
errors
array of string
Indicates events of errors at the time of processing views.
Examples
Parameters
company_id:
2
body:
body
Was this section helpful?
PUT
Response
Update custom view for every unique user cross company pair.
updateUserViews
Delete custom view for every unique user cross company pair.
Parameters
company_id
integer
Required
Id of company
view_id
string
Required
Comma separated values of view ids
Response
200
Success. Check the example shown below.
CreateUpdateDeleteResponseSchema
message
string
success
boolean
errors
array of string
Indicates events of errors at the time of processing views.
Examples
Parameters
company_id:
2
view_id:
"66a3628634e4f86adac7fed3"
Was this section helpful?
DEL
Response
Delete custom view for every unique user cross company pair.
deleteUserViews
Get global filters for populating filter listing and powering views api.
Parameters
company_id
integer
Required
Id of company
show_in
string
Required
Name of view to get filters for
Enum
Response
200
Global list of filters
GlobalFiltersResponseSchema
config
string
Indicates the unique property to identify a filter config.
filters
array of object (FiltersList)
Array of FiltersList
label
string
Name of the filter.
value
string
Key of the filter to query the input data on.
filter_type
string
To identify if its a global filter or advanced filters. global filters => Shown on UI alongside listing. advanced filters => Shown on panel on right side opened by clicking on filter icon.
Enum
type
string
Type of the filter.
Enum
placeholder_text
string
Sample input text.
required
boolean
If field value is required or not.
is_active
boolean
Whether the filter should be shown on ui or not.
options
array of object (FilterOptions)
Different options of a single filter.
Array of FilterOptions
label
string
Name of the FilterOption.
value
string
Key of the filterOption to query the input data on.
state_type
string
To identify type of status (financial, operational, logistics)
name
string
Name of the FilterOption.
text
string
Text of the FilterOption.
min_search_size
integer
Minimum search size.
placeholder_text
string
Placeholder showing hint what text can be passed into filter.
show_ui
boolean
Whether to show on UI or not.
company_id
integer
Nullable
unique identifier for a company
show_in
string
request_source
string
Source of the request (platform/administrator)
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Get global filters for populating filter listing and powering views api.
getGlobalFilters
Parameters
company_id
integer
Required
Id of company
view
string
Required
Name of view
Default Value : manifest
group_entity
string
Name of group entity
Default Value : orders
Enum
Response
200
List of filters
FiltersResponseSchema
advance_filter
object (AdvanceFilterInfo)
AdvanceFilterInfo
returned
array of object (FiltersInfo)
Nullable
Array of FiltersInfo
options
array of object (FilterInfoOption)
Nullable
Options of the filter.[dropdown]
Array of FilterInfoOption
text
string
Nullable
The display text of the option.
name
string
Nullable
Name of the option.
placeholder_text
string
Nullable
Placeholder text of the option.
value
string
Nullable
The value of the option.
min_search_size
integer
| int32
Nullable
Minimum search size of the option.
show_ui
boolean
Nullable
Specifies whether the option should be shown in the UI.
text
string
Display text of filter
placeholder_text
string
Nullable
Placeholder text of filter.
value
string
The value of the filter.
required
boolean
Nullable
Specifies whether the filter is required or not.
type
string
single_select/multi_select
Enum
action_centre
array of object (FiltersInfo)
Nullable
Array of FiltersInfo
options
array of object (FilterInfoOption)
Nullable
Options of the filter.[dropdown]
Array of FilterInfoOption
text
string
Nullable
The display text of the option.
name
string
Nullable
Name of the option.
placeholder_text
string
Nullable
Placeholder text of the option.
value
string
Nullable
The value of the option.
min_search_size
integer
| int32
Nullable
Minimum search size of the option.
show_ui
boolean
Nullable
Specifies whether the option should be shown in the UI.
text
string
Display text of filter
placeholder_text
string
Nullable
Placeholder text of filter.
value
string
The value of the filter.
required
boolean
Nullable
Specifies whether the filter is required or not.
type
string
single_select/multi_select
Enum
unfulfilled
array of object (FiltersInfo)
Nullable
Array of FiltersInfo
options
array of object (FilterInfoOption)
Nullable
Options of the filter.[dropdown]
Array of FilterInfoOption
text
string
Nullable
The display text of the option.
name
string
Nullable
Name of the option.
placeholder_text
string
Nullable
Placeholder text of the option.
value
string
Nullable
The value of the option.
min_search_size
integer
| int32
Nullable
Minimum search size of the option.
show_ui
boolean
Nullable
Specifies whether the option should be shown in the UI.
text
string
Display text of filter
placeholder_text
string
Nullable
Placeholder text of filter.
value
string
The value of the filter.
required
boolean
Nullable
Specifies whether the filter is required or not.
type
string
single_select/multi_select
Enum
filters
array of object (FiltersInfo)
Nullable
Array of FiltersInfo
options
array of object (FilterInfoOption)
Nullable
Options of the filter.[dropdown]
Array of FilterInfoOption
text
string
Nullable
The display text of the option.
name
string
Nullable
Name of the option.
placeholder_text
string
Nullable
Placeholder text of the option.
value
string
Nullable
The value of the option.
min_search_size
integer
| int32
Nullable
Minimum search size of the option.
show_ui
boolean
Nullable
Specifies whether the option should be shown in the UI.
text
string
Display text of filter
placeholder_text
string
Nullable
Placeholder text of filter.
value
string
The value of the filter.
required
boolean
Nullable
Specifies whether the filter is required or not.
type
string
single_select/multi_select
Enum
processed
array of object (FiltersInfo)
Nullable
Array of FiltersInfo
options
array of object (FilterInfoOption)
Nullable
Options of the filter.[dropdown]
Array of FilterInfoOption
text
string
Nullable
The display text of the option.
name
string
Nullable
Name of the option.
placeholder_text
string
Nullable
Placeholder text of the option.
value
string
Nullable
The value of the option.
min_search_size
integer
| int32
Nullable
Minimum search size of the option.
show_ui
boolean
Nullable
Specifies whether the option should be shown in the UI.
text
string
Display text of filter
placeholder_text
string
Nullable
Placeholder text of filter.
value
string
The value of the filter.
required
boolean
Nullable
Specifies whether the filter is required or not.
type
string
single_select/multi_select
Enum
applied_filters
object
Nullable
Specifies the set of filters currently applied , search result, or view, detailing the criteria used to narrow down or sort the information presented. This object is designed to be highly flexible, allowing for the inclusion of various filter types such as date ranges, categories, status flags, or custom search terms.
page
object
Nullable
An object representing a page with pagination details.
global_filter
array of object (FiltersInfo)
Array of FiltersInfo
options
array of object (FilterInfoOption)
Nullable
Options of the filter.[dropdown]
Array of FilterInfoOption
text
string
Nullable
The display text of the option.
name
string
Nullable
Name of the option.
placeholder_text
string
Nullable
Placeholder text of the option.
value
string
Nullable
The value of the option.
min_search_size
integer
| int32
Nullable
Minimum search size of the option.
show_ui
boolean
Nullable
Specifies whether the option should be shown in the UI.
text
string
Display text of filter
placeholder_text
string
Nullable
Placeholder text of filter.
value
string
The value of the filter.
required
boolean
Nullable
Specifies whether the filter is required or not.
type
string
single_select/multi_select
Enum
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
company_id:
2
view:
"my_orders"
group_entity:
"shipments"
Was this section helpful?
GET
Response
Get filters.
getfilters
Parameters
company_id
integer
Required
app_id
string
Required
Response
200
Sucessfully fetched the order config for the application.
OrderConfig
create_user
boolean
article_lookup
string
bag_end_state
string
affiliate
object (Affiliate)
Affiliate
id
string
config
object (AffiliateConfig)
AffiliateConfig
app
object (AffiliateAppConfig)
AffiliateAppConfig
id
string
description
string
updated_at
string
| date-time
The date and time when the app config was updated.
name
string
token
string
meta
array of object (AffiliateAppConfigMeta)
Array of AffiliateAppConfigMeta
value
string
name
string
owner
string
secret
string
created_at
string
| date-time
Timestamp when the app config was created.
inventory
object (AffiliateInventoryConfig)
AffiliateInventoryConfig
article_assignment
object (AffiliateInventoryArticleAssignmentConfig)
AffiliateInventoryArticleAssignmentConfig
post_order_reassignment
boolean
payment
object (AffiliateInventoryPaymentConfig)
AffiliateInventoryPaymentConfig
source
string
mode_of_payment
string
inventory
object (AffiliateInventoryStoreConfig)
AffiliateInventoryStoreConfig
store
object
Fulfilling store information related to the shipment.
order
object (AffiliateInventoryOrderConfig)
AffiliateInventoryOrderConfig
force_reassignment
boolean
logistics
object (AffiliateInventoryLogisticsConfig)
AffiliateInventoryLogisticsConfig
dp_assignment
boolean
app_company_id
integer
Nullable
A unique identifier for the company associated with the affiliate app, used for tracking and managing affiliate relationships.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
token
string
store_lookup
string
affiliate_store_id_mapping
array of object (AffiliateStoreIdMapping)
Array of AffiliateStoreIdMapping
store_id
integer
| int32
marketplace_store_id
string
config
object (ConfigData)
ConfigData
acknowledged
boolean
Indicates whether the update operation was acknowledged by the database.
is_upserted
boolean
Indicates whether the update operation resulted in an upsert (an update or insert).
is_inserted
boolean
Indicates whether the update operation resulted in a new document being inserted.
status_sync_config
object (StatusSyncConfig)
StatusSyncConfig
status_data
array of object (StatusData)
Array of StatusData
status
string
enabled
boolean
success
boolean
Examples
Parameters
company_id:
1
app_id:
"64410d95bdb39c39d1ce3397"
Was this section helpful?
GET
Response
Get the Order Configuration for the application.
getOrderConfig
Update/Insert the Order Configuration for the application.
Parameters
company_id
integer
Required
app_id
string
Required
Request body
acknowledged
boolean
Indicates whether the update operation was acknowledged by the database.
is_upserted
boolean
Indicates whether the update operation resulted in an upsert (an update or insert).
is_inserted
boolean
Indicates whether the update operation resulted in a new document being inserted.
status_sync_config
object (StatusSyncConfig)
StatusSyncConfig
status_data
array of object (StatusData)
Array of StatusData
status
string
enabled
boolean
Response
200
400
Success. Check the example shown below.
CreateUpdateDeleteResponseSchema
message
string
success
boolean
errors
array of string
Indicates events of errors at the time of processing views.
Examples
Parameters
company_id:
1
app_id:
"64410d95bdb39c39d1ce3397"
body:
body
Was this section helpful?
POST
Response
Update/Insert the Order Configuration for the application.
updateOrderConfig
Operations
POST
# Allows esm config updation
GET
# Retrieves Entity State Manager configuration which includes flags, hooks, and filters, for a specific application within a company's setup.
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
data
object (TransitionConfigData)
TransitionConfigData
conditions
object (TransitionConfigCondition)
Conditions that must be met for the ESM config to be applied.
TransitionConfigCondition
app_id
string
Required
The unique identifier of the application to which the configuration applies.
ordering_channel
string
Required
The channel through which the order was placed, such as ECOMM or another specified channel.
entity
string
Required
The type of entity that the configuration pertains to.
configs
array of object (Config)
The configuration settings for the entity transition. This includes pre_hooks, post_hooks, and flags for each transition state.
Array of Config
from_state
string
Source state from which state transition will take place
to_state
string
Target state to which state transition will take place
pre_hooks
array of object (PreHook)
Tasks to be run before state transition
Array of PreHook
task
string
Required
Name of the hook that has to be added
kwargs
object
Additional parameters for the hook
filters
object (Filter)
Criteria to filter which hooks are applied based on certain conditions.
Filter
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
is_partial_transition
boolean
Specifies whether a partial transition of the order is allowed, allowing some components to progress while others remain in the current state.
auto_trigger_dp_assignment_acf
boolean
Indicates whether the assignment of a designated person is automatically triggered in the context of ACF.
lock_status
string
Indicates the current locking status of the shipment.
Enum
lock_after_transition
boolean
Specifies whether locking is required after transitioning to the next status.
lock_after_transition : true - Lock Transition enabled
lock_after_transition : false - Lock Transition set false
resume_tasks_after_unlock
boolean
Indicates whether tasks should resume automatically after unlocking, such as DP assignment task and invoicing task.
is_invoice_id_present
boolean
Indicates whether an invoice ID is present for the order.
is_credit_note_generated
boolean
Indicates whether a credit note has been generated for the order.
fulfill_virtual_invoice
boolean
Specifies whether an automated virtual invoice ID is associated with the order.
next_status
string
Indicates the next status to which the order will transition.
Enum
is_hook_enabled
boolean
Indicates whether a task is enabled for the order.
pos_credit_note_check
boolean
Specifies whether a credit note check is performed in a point of sale (POS) scenario.
order_platform
string
Specifies the platform on which the order was placed.
Enum
refund_type
string
Indicates the type of refund associated with the order.
Enum
is_non_pos_platform
boolean
Specifies whether the platform is non-point of sale (POS) in nature.
is_self_ship
boolean
Indicates whether the order is self-shipped by the seller.
seller_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `seller_country_code`: US
- `seller_country_code`: UK
- `seller_country_code`: IN
customer_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `customer_country_code`: US
- `customer_country_code`: UK
- `customer_country_code`: IN
is_test_order
boolean
Indicates whether the order is a test order used for testing purposes - `is_test_order` : True - indicates test order
task_trigger_condition
array of string
Specifies trigger conditions:
- `status_update`: Status Update
- `data_update`: Data Update
Enum
post_hooks
array of object (PostHook)
Tasks to be run after state transition
Array of PostHook
task
string
Required
Name of the hook that has to be added
kwargs
object
Additional parameters for the hook
filters
object (Filter)
Criteria to filter which hooks are applied based on certain conditions.
Filter
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
is_partial_transition
boolean
Specifies whether a partial transition of the order is allowed, allowing some components to progress while others remain in the current state.
auto_trigger_dp_assignment_acf
boolean
Indicates whether the assignment of a designated person is automatically triggered in the context of ACF.
lock_status
string
Indicates the current locking status of the shipment.
Enum
lock_after_transition
boolean
Specifies whether locking is required after transitioning to the next status.
lock_after_transition : true - Lock Transition enabled
lock_after_transition : false - Lock Transition set false
resume_tasks_after_unlock
boolean
Indicates whether tasks should resume automatically after unlocking, such as DP assignment task and invoicing task.
is_invoice_id_present
boolean
Indicates whether an invoice ID is present for the order.
is_credit_note_generated
boolean
Indicates whether a credit note has been generated for the order.
fulfill_virtual_invoice
boolean
Specifies whether an automated virtual invoice ID is associated with the order.
next_status
string
Indicates the next status to which the order will transition.
Enum
is_hook_enabled
boolean
Indicates whether a task is enabled for the order.
pos_credit_note_check
boolean
Specifies whether a credit note check is performed in a point of sale (POS) scenario.
order_platform
string
Specifies the platform on which the order was placed.
Enum
refund_type
string
Indicates the type of refund associated with the order.
Enum
is_non_pos_platform
boolean
Specifies whether the platform is non-point of sale (POS) in nature.
is_self_ship
boolean
Indicates whether the order is self-shipped by the seller.
seller_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `seller_country_code`: US
- `seller_country_code`: UK
- `seller_country_code`: IN
customer_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `customer_country_code`: US
- `customer_country_code`: UK
- `customer_country_code`: IN
is_test_order
boolean
Indicates whether the order is a test order used for testing purposes - `is_test_order` : True - indicates test order
task_trigger_condition
array of string
Specifies trigger conditions:
- `status_update`: Status Update
- `data_update`: Data Update
Enum
flags
object (Flags)
Various flags related to the transition. These include options and settings that influence the behavior of the state transition, such as whether partial transitions are allowed or whether the transition can break the entity.
Flags
allow_partial_transition
array of object (FlagData)
Indicates whether a partial transition of bags to the next state is permissible,
allowing some bags to progress while others remain in the current state.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
can_break_entity
array of object (FlagData)
Specifies whether bags within a shipment, set,cdf or entity can be broken individually or as a group.
If set to false, all bags within the entity must remain together and transition together to the same state.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_bag_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at the bag level.
Allowed fields are:
- meta
- pdf_links
- affiliate_meta
- delivery_awb_number
- store_invoice_id
- store_id
- return_store_id
- eway_bill_id
- external_store_id
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_bag_status_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at the bag status level.
Allowed fields are:
- json
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_entity_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at shipment level.
Allowed fields are:
- meta
- pdf_links
- affiliate_meta
- delivery_awb_number
- store_invoice_id
- store_id
- return_store_id
- eway_bill_id
- logistics_meta
- external_store_id
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_entity_status_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at the Entity status level.
Allowed fields are:
- json
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
status_update_type
array of object (FlagData)
Describes the type of journey associated with the particular status of the shipment.
Possible values are:
- positive
- negative
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
is_bag_status_reason_allowed
array of object (FlagData)
Indicates whether a reason at the product level should be allowed for a particular status.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
is_entity_status_reason_allowed
array of object (FlagData)
Indicates whether a reason at the shipment level should be allowed for a particular status.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
transition_strategy
array of object (FlagData)
This flag is used to define the shipment breaking strategy.
Possible values are:
- break_shipment_based_on_location_reassignment
- break_shipment_based_on_groups
- break_shipment_based_on_stormbreaker
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Response
200
400
Config updated successfully
ConfigUpdatedResponseSchema
data
array of object (ConfigData)
The result of the config update operation, including whether it was acknowledged, upserted, or inserted.
Array of ConfigData
acknowledged
boolean
Indicates whether the update operation was acknowledged by the database.
is_upserted
boolean
Indicates whether the update operation resulted in an upsert (an update or insert).
is_inserted
boolean
Indicates whether the update operation resulted in a new document being inserted.
status_sync_config
object (StatusSyncConfig)
StatusSyncConfig
status_data
array of object (StatusData)
Array of StatusData
status
string
enabled
boolean
success
boolean
Indicates whether the config update operation was successful.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Allows esm config updation
addStateManagerConfig
GET
Retrieves Entity State Manager configuration which includes flags, hooks, and filters, for a specific application within a company's setup.
This endpoint retrieves the ESM (Entity State Manager) configuration for a specific application within a company. The retrieval is based on parameters such as application ID, ordering channel, and entity type.
The ESM config stores order processing configuration. Each document in the ESM config collection of Order Management System - OMS's database is a JSON object representing the configuration of a specific application ID. This includes filters, hooks, flags set on different state-transitions. This configuration is picked and accordingly features are enabled.
Parameters
company_id
integer
Required
The unique identifier of the company on the platform.
app_id
string
The unique identifier of the application.
ordering_channel
string
The channel through which orders are placed.
entity
string
The entity for which the configuration is applied.
Response
200
This denotes a successful response. ESM config data fetched successfully for given application ID, ordering channel, and entity.
Properties
success
boolean
Indicates whether the request was successful.
data
array of object
An array of ESM configuration objects.
Array of Properties
conditions
object (TransitionConfigCondition)
Requested params that were passed in the API request. This includes application_id, ordering_channel and entity.
TransitionConfigCondition
app_id
string
The unique identifier of the application to which the configuration applies.
ordering_channel
string
The channel through which the order was placed, such as ECOMM or another specified channel.
entity
string
The type of entity that the configuration pertains to.
configs
array of object (Config)
The configuration settings for the entity transition. This includes pre_hooks, post_hooks, and flags for each state transition.
Array of Config
from_state
string
Source state from which state transition will take place
to_state
string
Target state to which state transition will take place
pre_hooks
array of object (PreHook)
Tasks to be run before state transition
Array of PreHook
task
string
Name of the hook that has to be added
kwargs
object
Additional parameters for the hook
filters
object (Filter)
Criteria to filter which hooks are applied based on certain conditions.
Filter
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
is_partial_transition
boolean
Specifies whether a partial transition of the order is allowed, allowing some components to progress while others remain in the current state.
auto_trigger_dp_assignment_acf
boolean
Indicates whether the assignment of a designated person is automatically triggered in the context of ACF.
lock_status
string
Indicates the current locking status of the shipment.
Enum
lock_after_transition
boolean
Specifies whether locking is required after transitioning to the next status.
lock_after_transition : true - Lock Transition enabled
lock_after_transition : false - Lock Transition set false
resume_tasks_after_unlock
boolean
Indicates whether tasks should resume automatically after unlocking, such as DP assignment task and invoicing task.
is_invoice_id_present
boolean
Indicates whether an invoice ID is present for the order.
is_credit_note_generated
boolean
Indicates whether a credit note has been generated for the order.
fulfill_virtual_invoice
boolean
Specifies whether an automated virtual invoice ID is associated with the order.
next_status
string
Indicates the next status to which the order will transition.
Enum
is_hook_enabled
boolean
Indicates whether a task is enabled for the order.
pos_credit_note_check
boolean
Specifies whether a credit note check is performed in a point of sale (POS) scenario.
order_platform
string
Specifies the platform on which the order was placed.
Enum
refund_type
string
Indicates the type of refund associated with the order.
Enum
is_non_pos_platform
boolean
Specifies whether the platform is non-point of sale (POS) in nature.
is_self_ship
boolean
Indicates whether the order is self-shipped by the seller.
seller_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `seller_country_code`: US
- `seller_country_code`: UK
- `seller_country_code`: IN
customer_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `customer_country_code`: US
- `customer_country_code`: UK
- `customer_country_code`: IN
is_test_order
boolean
Indicates whether the order is a test order used for testing purposes - `is_test_order` : True - indicates test order
task_trigger_condition
array of string
Specifies trigger conditions:
- `status_update`: Status Update
- `data_update`: Data Update
Enum
post_hooks
array of object (PostHook)
Tasks to be run after state transition
Array of PostHook
task
string
Name of the hook that has to be added
kwargs
object
Additional parameters for the hook
filters
object (Filter)
Criteria to filter which hooks are applied based on certain conditions.
Filter
order_type
string
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow. For example:
- "HomeDelivery": The order goes through all the steps needed for delivery, from being packed to arriving at the customer’s address.
- "PickAtStore": The order is prepared for pickup at the store, skipping shipping steps to make it ready faster for the customer to collect in person.
- "Digital": This order type likely refers to orders that involve digital goods or services, such as software, digital subscriptions, e-books, online courses, or any other item that can be delivered electronically.
Enum
is_partial_transition
boolean
Specifies whether a partial transition of the order is allowed, allowing some components to progress while others remain in the current state.
auto_trigger_dp_assignment_acf
boolean
Indicates whether the assignment of a designated person is automatically triggered in the context of ACF.
lock_status
string
Indicates the current locking status of the shipment.
Enum
lock_after_transition
boolean
Specifies whether locking is required after transitioning to the next status.
lock_after_transition : true - Lock Transition enabled
lock_after_transition : false - Lock Transition set false
resume_tasks_after_unlock
boolean
Indicates whether tasks should resume automatically after unlocking, such as DP assignment task and invoicing task.
is_invoice_id_present
boolean
Indicates whether an invoice ID is present for the order.
is_credit_note_generated
boolean
Indicates whether a credit note has been generated for the order.
fulfill_virtual_invoice
boolean
Specifies whether an automated virtual invoice ID is associated with the order.
next_status
string
Indicates the next status to which the order will transition.
Enum
is_hook_enabled
boolean
Indicates whether a task is enabled for the order.
pos_credit_note_check
boolean
Specifies whether a credit note check is performed in a point of sale (POS) scenario.
order_platform
string
Specifies the platform on which the order was placed.
Enum
refund_type
string
Indicates the type of refund associated with the order.
Enum
is_non_pos_platform
boolean
Specifies whether the platform is non-point of sale (POS) in nature.
is_self_ship
boolean
Indicates whether the order is self-shipped by the seller.
seller_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `seller_country_code`: US
- `seller_country_code`: UK
- `seller_country_code`: IN
customer_country_code
string
Specifies the country code of the seller in ISO 3166-1 alpha-2 format.
- `customer_country_code`: US
- `customer_country_code`: UK
- `customer_country_code`: IN
is_test_order
boolean
Indicates whether the order is a test order used for testing purposes - `is_test_order` : True - indicates test order
task_trigger_condition
array of string
Specifies trigger conditions:
- `status_update`: Status Update
- `data_update`: Data Update
Enum
flags
object (Flags)
Various flags related to the transition. These include options and settings that influence the behavior of the state transition, such as whether partial transitions are allowed or whether the transition can break the entity.
Flags
allow_partial_transition
array of object (FlagData)
Indicates whether a partial transition of bags to the next state is permissible,
allowing some bags to progress while others remain in the current state.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
can_break_entity
array of object (FlagData)
Specifies whether bags within a shipment, set,cdf or entity can be broken individually or as a group.
If set to false, all bags within the entity must remain together and transition together to the same state.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_bag_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at the bag level.
Allowed fields are:
- meta
- pdf_links
- affiliate_meta
- delivery_awb_number
- store_invoice_id
- store_id
- return_store_id
- eway_bill_id
- external_store_id
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_bag_status_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at the bag status level.
Allowed fields are:
- json
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_entity_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at shipment level.
Allowed fields are:
- meta
- pdf_links
- affiliate_meta
- delivery_awb_number
- store_invoice_id
- store_id
- return_store_id
- eway_bill_id
- logistics_meta
- external_store_id
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
allowed_entity_status_updates
array of object (FlagData)
Specifies which fields are permitted to be updated at the Entity status level.
Allowed fields are:
- json
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
status_update_type
array of object (FlagData)
Describes the type of journey associated with the particular status of the shipment.
Possible values are:
- positive
- negative
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
is_bag_status_reason_allowed
array of object (FlagData)
Indicates whether a reason at the product level should be allowed for a particular status.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
is_entity_status_reason_allowed
array of object (FlagData)
Indicates whether a reason at the shipment level should be allowed for a particular status.
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
transition_strategy
array of object (FlagData)
This flag is used to define the shipment breaking strategy.
Possible values are:
- break_shipment_based_on_location_reassignment
- break_shipment_based_on_groups
- break_shipment_based_on_stormbreaker
Array of FlagData
filter
object
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
Examples
Parameters
company_id:
2
app_id:
"63f8926ad139ce26cab2ed11"
ordering_channel:
"ECOMM"
entity:
"shipment"
Was this section helpful?
GET
Response
Retrieves Entity State Manager configuration which includes flags, hooks, and filters, for a specific application within a company's setup.
getStateManagerConfig
The Refund resource has two major components: - Transaction summary of money returned to the customer through multiple MOPs - Refund options available against shipment id at present
Operations
POST
# Refund State Configuration
GET
# Refund State Configuration
GET
# Refund State Configurationb
POST
# refund configuration.
GET
# refund configuration.
GET
# Retrieve refund options with amount breakup for specific shipment and bags.
POST
# Fetch credit balance detail.
POST
# Fetch refund mode config.
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
app_id
string
Required
Request body
prepaid
object (RefundStateConfigurationByPaymentType)
RefundStateConfigurationByPaymentType
states
array of string
allow_refund_initiate
boolean
non_prepaid
object (RefundStateConfigurationByPaymentType)
RefundStateConfigurationByPaymentType
states
array of string
allow_refund_initiate
boolean
mix_mop
object (RefundStateConfigurationByPaymentType)
RefundStateConfigurationByPaymentType
states
array of string
allow_refund_initiate
boolean
Response
200
create refund configuration successfully
PostRefundStateConfigurationResponseSchema
refund_config
string
success
boolean
Examples
Parameters
app_id:
"65057a8b6599714daeb5e24c"
body:
body
Was this section helpful?
POST
Response
Refund State Configuration
postRefundStateConfiguration
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
app_id
string
Required
Response
200
It shows the Refund configuration
GetRefundStateConfigurationResponseSchema
success
boolean
config
object (PostRefundStateConfiguration)
PostRefundStateConfiguration
prepaid
object (RefundStateConfigurationByPaymentType)
RefundStateConfigurationByPaymentType
states
array of string
allow_refund_initiate
boolean
non_prepaid
object (RefundStateConfigurationByPaymentType)
RefundStateConfigurationByPaymentType
states
array of string
allow_refund_initiate
boolean
mix_mop
object (RefundStateConfigurationByPaymentType)
RefundStateConfigurationByPaymentType
states
array of string
allow_refund_initiate
boolean
Examples
Parameters
company_id:
1
app_id:
"default_fynd"
Was this section helpful?
GET
Response
Refund State Configuration
getRefundStateConfiguration
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Response
200
It shows the Refund states
GetRefundStates
success
boolean
items
array of object (RefundStates)
Array of RefundStates
state
string
display_name
string
status
integer
| int32
Examples
Parameters
company_id:
1
Was this section helpful?
GET
Response
Refund State Configurationb
getRefundEnableStateList
Parameters
company_id
integer
Required
app_id
string
Required
Request body
prepaid
object (RefundStateManualWithoutMessage)
RefundStateManualWithoutMessage
is_manual
boolean
non_prepaid
object (RefundStateManualWithoutMessage)
RefundStateManualWithoutMessage
is_manual
boolean
mix_mop
object (RefundStateManualWithoutMessage)
RefundStateManualWithoutMessage
is_manual
boolean
Response
200
refund config.
RefundStateConfigurationManualSchemaResponseSchema
success
boolean
data
object (RefundStateManualWithMessageData)
RefundStateManualWithMessageData
prepaid
object (RefundStateManualWithMessage)
RefundStateManualWithMessage
is_manual
boolean
message
string
non_prepaid
object (RefundStateManualWithMessage)
RefundStateManualWithMessage
is_manual
boolean
message
string
mix_mop
object (RefundStateManualWithMessage)
RefundStateManualWithMessage
is_manual
boolean
message
string
Examples
Parameters
company_id:
1
app_id:
"9876543211"
body:
body
Was this section helpful?
POST
Response
refund configuration.
postRefundConfiguration
Parameters
company_id
integer
Required
app_id
string
Required
Response
200
refund config.
RefundStateConfigurationManualSchemaResponseSchema
success
boolean
data
object (RefundStateManualWithMessageData)
RefundStateManualWithMessageData
prepaid
object (RefundStateManualWithMessage)
RefundStateManualWithMessage
is_manual
boolean
message
string
non_prepaid
object (RefundStateManualWithMessage)
RefundStateManualWithMessage
is_manual
boolean
message
string
mix_mop
object (RefundStateManualWithMessage)
RefundStateManualWithMessage
is_manual
boolean
message
string
Examples
Parameters
app_id:
"1"
Was this section helpful?
GET
Response
refund configuration.
getRefundConfiguration
This API can be used for giving the refund amount with available option of MOPs.
Parameters
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
company_id
integer
Required
This is the company_id for the sales channel.
bag_ids
string
It is the bag_id of the bags with comma separated.
state
string
It is the desired state at which refund amount needs to be calculated.
optin_app_id
string
It is affiliate id of the order in case of cross selling.
optin_company_id
integer
It is company id of the order in case of cross selling.
status
string
It specifies the desired status to which the shipment should be updated. It represents the next step in the shipment's lifecycle, such as being cancelled by the customer or moved to another status in the shipping process.
Response
200
refund option.
RefundOptionsSchemaResponseSchema
success
boolean
currency
object (CurrencySchema)
CurrencySchema
currency_code
string
The ISO 4217 currency code, such as 'INR' for Indian Rupee. This field represents the standardized three-letter code of a currency.
currency_symbol
string
The symbol representing the currency, such as '₹' for Indian Rupee. This is used for display purposes alongside currency amounts.
refund_options
array of object (RefundOptionShipmentResponseSchema)
Array of RefundOptionShipmentResponseSchema
id
integer
| int32
ID of the refund option
name
string
Name of the refund option
display_name
string
Display name of the refund option
is_active
boolean
Whether the refund option is active
breakups
array of object (RefundBreakup)
List of refund breakups (optional)
Array of RefundBreakup
mode
string
Specifies the method or channel through which the refund is divided or processed, such as Online or Offline. This indicates how the refund amount is split across different refund methods.
amount
number
| float
Amount for the refund breakup
display_name
string
Display name for the refund breakup mode
offline
boolean
Whether the breakup is offline
option
array of object (RefundSubOption)
List of sub-options for the refund option
Array of RefundSubOption
id
integer
| int32
ID of the refund sub-option
name
string
Name of the refund sub-option
display_name
string
Display name of the refund sub-option
is_active
boolean
Whether the refund sub-option is active
offline
boolean
Whether the refund option is offline
amount
number
| float
Amount for the refund option (optional)
slug
string
Slug of refund option
value
string
Value of refund for this refund option
type
string
Type of refund option
Examples
Parameters
shipment_id:
"17210282542051402375"
company_id:
"1234"
bag_ids:
"21248920"
state:
"cancelled_customer"
optin_app_id:
"5e2fafc88b352fdcbc49fa30"
optin_company_id:
123
status:
"cancelled_customer"
Was this section helpful?
GET
Response
Retrieve refund options with amount breakup for specific shipment and bags.
getRefundOptions
Retrieve details about credit balance on the basis of customer mobile number
Parameters
company_id
integer
Required
Request body
affiliate_id
string
Required
seller_id
integer
Required
customer_mobile_number
string
Required
Response
200
Credit Balance will be fetched
FetchCreditBalanceResponsePayload
message
string
status
number
success
boolean
data
object (CreditBalanceInfo)
CreditBalanceInfo
total_credited_balance
number
reason
string
customer_mobile_number
string
is_cn_locked
boolean
total_locked_amount
number
allowed_redemption_amount
number
Examples
Parameters
company_id:
288
body:
body
Was this section helpful?
POST
Response
Fetch credit balance detail.
fetchCreditBalanceDetail
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
fynd_order_id
string
Required
A unique identifier for the order placed through the Fynd platform.
seller_id
integer
| int32
Required
A unique identifier representing the seller associated with the order.
affiliate_id
string
Required
An identifier for the affiliate partner associated with the order.
customer_mobile_number
number
The mobile phone number of the customer who placed the order.
Response
200
Refund mode config is returned based on input parameter
RefundModeConfigResponsePayload
success
boolean
Indicates whether the API call was successful (true) or not (false).
data
array of object (RefundModeInfo)
An array of possible refund mode information objects.
Array of RefundModeInfo
format
object (RefundModeInfoFormat)
RefundModeInfoFormat
refund_to
string
manual_refund_data
object
is_active
boolean
A flag indicating whether the refund mode is currently active or not.
slug
string
A unique identifier for the refund mode.
options
array of object (RefundOption)
A list of available refund options associated with this refund mode.
Array of RefundOption
value
string
The actual value representing the refund option.
slug
string
A unique identifier for the refund mode
name
string
A user-friendly name for the refund option.
type
string
A string indicating the type of refund information provided.
display_name
string
A user-friendly name for the refund mode.
status
integer
| int32
Represents the HTTP status code of the API response.
message
string
A descriptive message providing additional information about the API response.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Fetch refund mode config.
fetchRefundModeConfig
Shipment represents the physical movement of goods from the seller (or your warehouse) to the customer. It's associated with a specific order and includes details like tracking information, carrier used, weight, dimensions, and estimated delivery date. An Order can contain multiple shipments. Shipments are created based on multiple factors like selling location assigned to that shipment, the packaging material available etc. A shipment will get created whenever there is a partial transition of items also when there is a negative state transition is invoked. Negative state transition can be defined against a state. Currently only some defined states are configured as negative. If any state is to be added as negative state then please contact support team.
Operations
POST
# Reassign location.
GET
# Click to call.
PUT
# Update shipment status.
GET
# Get shipment history.
POST
# Post shipment history.
POST
# Send SMS via Ninja.
POST
# Update packaging dimensions.
GET
# Get state transition map.
POST
# Attach order user.
POST
# Send user mobile OTP.
POST
# Verify Mobile OTP
POST
# Downloads lanes shipment/orders.
GET
# Fetches details for the job of the provided batch_id
GET
# Get the file download URL used for performing bulk operation
POST
# Retry e-invoice after failure
GET
# Retrieve courier partner tracking details for a given shipment id or awb no.
POST
# Update shipment tracking.
POST
# Update shipment lock.
PUT
# Update shipment status.
GET
# List shipments
GET
# Get shipment details
GET
# Get bulk shipment Excel file.
GET
# Get bulk action template.
GET
# Download bulk action template.
GET
# Generate POS receipt by order ID.
GET
# Gets All the allowed Templates to perform Bulk Operations.
GET
# Get the Excel or CSV file URL for the Template.
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
store_id
integer
| int32
Required
Unique id of the store.
bag_id
integer
| int32
Nullable
Identifier for the bag associated with the reassignment.
affiliate_order_id
string
Nullable
Identifier for the affiliate order id associated with the reassignment.
affiliate_id
string
Nullable
Identifier for the affiliate id associated with the reassignment.
item_id
string
Nullable
Identifier for the item associated with the reassignment.
fynd_order_id
string
Nullable
Identifier for the fynd order id associated with the reassignment.
Maximum Length : 30
set_id
string
Nullable
Identifier for the set of items associated with the reassignment.
affiliate_bag_id
string
Nullable
Identifiers for bags associated with the reassignment.
reason_ids
array of integer
Nullable
List of reason ids for the reassignment.
mongo_article_id
string
Nullable
Identifier for the article id associated with the reassignment.
Response
200
400
Successfully reassigned location!
StoreReassignResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
message
string
A descriptive message providing additional information about the API response.
Examples
Parameters
body:
body
Was this section helpful?
POST
Response
Reassign location.
reassignLocation
Parameters
caller
string
Required
Call Number
receiver
string
Required
Receiver Number
bag_id
string
Required
Bag Id for the query
caller_id
string
Caller Id
method
string
Provider Method to Call
company_id
integer
Required
Unique identifier of a company on the platform.
Response
200
400
Process call on request!
Click2CallResponseSchema
call_id
string
Call ID from the provider
success
boolean
Success
Examples
Parameters
caller:
"1"
receiver:
"1"
bag_id:
"1"
caller_id:
"9999999999"
method:
"9999999999"
company_id:
1
Was this section helpful?
GET
Response
Click to call.
click2Call
Parameters
company_id
integer
Required
company id from where are transitioning the shipment state or data
Request body
force_transition
boolean
Indicates whether to force the status transition, overriding any restrictions or checks that may normally apply.
statuses
array of object (StatuesRequestSchema)
A list of status updates to be applied to the shipment.
Array of StatuesRequestSchema
status
string
The new status to be assigned to the shipment(s).
shipments
array of object (ShipmentsRequestSchema)
A list of shipments to which the new status will be applied.
Array of ShipmentsRequestSchema
identifier
string
Required
Unique identifier for the shipment.
reasons
object (ReasonsData)
ReasonsData
products
array of object (ProductsReasons)
A list of reasons specifically related to products involved in the shipment.
Array of ProductsReasons
filters
array of object (ProductsReasonsFilters)
A list of filters applied to specify which products the reasons pertain to.
Array of ProductsReasonsFilters
line_number
integer
| int32
The line number for the product or bag, which helps identify the specific item in a list or order.
identifier
string
The unique article or item identifier for the product or bag.
quantity
number
| float
The quantity of the product or bag being referenced.
data
object (ProductsReasonsData)
ProductsReasonsData
reason_text
string
A descriptive text providing the reason for the action or status associated with the product or bag.
reason_id
integer
| int32
A unique identifier for the reason, used to reference specific reasons in the system.
entities
array of object (EntitiesReasons)
A list of reasons specifically related to shipment.
Array of EntitiesReasons
filters
array of object
A list of filters applied to specify which entities the reasons pertain to.
data
object (EntityReasonData)
EntityReasonData
reason_text
string
A descriptive text providing the reason for the action or status associated with the product or bag.
reason_id
integer
| int32
A unique identifier for the reason, used to reference specific reasons in the system.
products
array of object (Products)
A list of products or bags that need to be updated as part of the shipment status change.
Array of Products
line_number
integer
| int32
The line number for the product or bag, which helps identify the specific item in a list or order.
identifier
string
The unique article or item identifier for the product or bag.
quantity
number
| float
The quantity of the product or bag being referenced.
data_updates
object (DataUpdates)
DataUpdates
order_item_status
array of object (OrderItemDataUpdates)
A list of updates related to the status of order items.
Array of OrderItemDataUpdates
data
object
Contains the specific data for updating shipment bags data.
products
array of object (ProductsDataUpdates)
A list of updates related to the properties of products or bags.
Array of ProductsDataUpdates
filters
array of object (ProductsDataUpdatesFilters)
A list of filters applied to specify which products or bags are targeted for updates.
Array of ProductsDataUpdatesFilters
line_number
integer
| int32
Represents the specific line item within a bag, used to identify and reference a particular product in a list. This helps in pinpointing the exact item being updated or processed.
identifier
string
A unique string that serves as the product’s identifier, such as a SKU, barcode, or another distinct code. This ensures the product is correctly identified and distinguished from other items in the system.
quantity
number
| float
The quantity of the product or item. This indicates how many units of the product are being referenced or processed, such as the number of items in a bag or shipment.
data
object
Contains the specific data for updating the products or bags.
entities
array of object (EntitiesDataUpdates)
A list of updates related to the properties of any relevant entities.
Array of EntitiesDataUpdates
filters
array of object
A list of filters used to specify which shipments are targeted for updates.
data
object
Encapsulates a dynamic set of updates and modifications applied to the entity.
repriced_products
array of object (RepricedProductsDataUpdates)
To update the prices of the line items and trigger the repricing event process.
Array of RepricedProductsDataUpdates
line_number
integer
| int32
A unique identifier to filter the product or bag within the shipment.
identifier
string
A seller's product identifier used to filter the bag within the shipment.
price
integer
| int32
Adjusted price of the bag.
order
array of object (OrderDataUpdates)
Array of OrderDataUpdates
data
object
Encapsulates a dynamic set of updates and modifications applied to the order.
transition_comments
array of object (TransitionComments)
Array of TransitionComments
title
string
Title of the comment
message
string
Comment to be added
exclude_bags_next_state
string
Specifies the state to which remaining bags or products should be changed, effectively excluding them from the current status update.
split_shipment
boolean
A flag indicating whether the shipment should be split into multiple parts. If set to true, the shipment will be divided according to the specified logic or criteria.
lock_after_transition
boolean
Specifies whether the shipment should be locked automatically after a transition occurs.
unlock_before_transition
boolean
Specifies whether the shipment should be unlocked before a transition occurs.
task
boolean
Indicates whether to run the status update as a background task, allowing other processes to continue without waiting for this operation to complete.
resume_tasks_after_unlock
boolean
Indicates whether tasks should resume automatically after unlocking, such as DP assignment task and invoicing task.
Response
200
NOTE success response can contains success and failed result as well
UpdateShipmentStatusResponseBody
statuses
array of object (StatuesResponseSchema)
List of statuses of the shipments after a status update operation. Includes an array of status objects, each containing details about shipments that have undergone data updates.
Array of StatuesResponseSchema
shipments
array of object (ShipmentsResponseSchema)
List of Shipments which includes data for each shipment, the current status code, final state information including reasons for cancellation (if applicable), and unique shipment identifiers are provided.
Array of ShipmentsResponseSchema
status
integer
| int32
Nullable
final_state
object
Nullable
identifier
string
Nullable
stack_trace
string
Nullable
code
string
Nullable
meta
object
Nullable
message
string
Nullable
exception
string
Nullable
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
PUT
Response
Update shipment status.
updateShipmentStatus
Parameters
company_id
integer
Required
Company Id
shipment_id
string
Shipment Id
bag_id
integer
Bag/Product Id
Response
200
400
It shows the journey of the shipment!
ShipmentHistoryResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
activity_history
array of object (HistoryDict)
A list of activity records related to the shipment, providing details on actions taken, comments added, or notifications sent.
Array of HistoryDict
user_details
object
User Details
display_message
string
User-friendly message displaying the activity or status change.
bag_id
integer
| int32
Identifier for the bag associated with the activity.
ticket_url
string
Nullable
URL for any related tickets.
l3_detail
string
Nullable
L3 details regarding the bag or activity.
createdat
string
Date and time when the activity was created.
created_ts
string
Timestamp for when the activity was created in ISO format.
ticket_id
string
Nullable
Unique identifier for the ticket associated with the activity.
type
string
Defines the category of event-related information for a shipment, indicating the nature of the update. This includes whether the update pertains to the status of the shipment, comments added to it, or notifications about specific events.
Enum
activity_type
string
Enum
l2_detail
string
Nullable
L2 details regarding the bag or activity.
assigned_agent
string
Nullable
Name of the agent assigned to the activity.
meta
object (HistoryMeta)
HistoryMeta
store_id
integer
| int32
Nullable
Unique identifier for the store involved in the activity.
status
string
Nullable
Current status of the activity or item.
status1
string
Nullable
Additional status information if necessary.
call_id
string
Nullable
Identifier for any related calls, if applicable.
starttime
string
Nullable
Start time of the activity.
reason
object (HistoryReason)
HistoryReason
text
string
Nullable
A reason for the activity or change.
category
string
Nullable
Category of the reason for the status change.
state
string
Nullable
Current state related to the reason.
dislay_name
string
Nullable
Display name of the reason for better user understanding.
code
integer
| int32
Nullable
Unique code identifying the reason.
quantity
integer
| int32
Nullable
Quantity related to the reason, if applicable.
short_link
string
Nullable
A shortened link related to the activity, if available.
endtime
string
Nullable
End time of the activity.
store_name
string
Nullable
Name of the store involved in the activity.
caller
string
Nullable
Name of the caller associated with the activity.
store_code
string
Nullable
Code associated with the store.
billsec
string
Nullable
Duration of the billable period, if applicable.
recordpath
string
Nullable
Path to any related recordings, if applicable.
status2
string
Nullable
Additional status information if necessary.
callerid
string
Nullable
Caller ID associated with the activity, if applicable.
duration
string
Nullable
Total duration of the activity.
channel_type
string
Nullable
Type of channel used for the activity, if applicable.
Enum
activity_comment
string
Nullable
Comments related to the activity, if applicable.
activity_type
string
Nullable
Defines the category of event-related information for a shipment, indicating the nature of the update. This includes whether the update pertains to the status of the shipment, comments added to it, or notifications about specific events.
Enum
receiver
string
Nullable
Name of the receiver involved in the activity, if applicable.
recipient
string
Nullable
Recipient of the activity, if applicable.
slug
string
Nullable
Slug identifier for the activity.
message
string
Nullable
type
string
Nullable
prev_store_name
string
Nullable
The name of the store where the item was previously located before being transferred or processed. This field can be null if the previous store information is not applicable or available.
prev_store_code
string
Nullable
The unique code associated with the previous store. This code helps identify the store in the system and can be null if the previous store code is not recorded or required.
prev_store_id
string
Nullable
The unique identifier (ID) of the previous store in the database or system. This ID can be null if the previous store information is not relevant or if the store did not have a designated ID.
refund_to
string
Nullable
The destination or method by which a refund will be issued. This indicates where the refunded amount will be sent, such as back to the original payment source (e.g., 'Back To Source').
refund_information
array of object (RefundInformation)
Array of RefundInformation
mode
string
The payment method used for the order, such as CARD, Net Banking (NB), or other options. This field indicates how the original payment was made and will determine how the refund is processed.
amount
number
| float
The amount to be refunded, represented as a floating-point number. This specifies the exact value that will be returned to the customer.
merchant_transaction_id
string
A unique identifier associated with the payment transaction, such as TR669796C0012CF31BBD. This ID helps track and reference the specific transaction within the merchant's system.
refund_status
string
The current status of the refund process, indicating whether the refund has been completed, is pending, or has encountered an issue (e.g., 'refund_done', 'refund_failed'). This field reflects the state of the refund operation.
l1_detail
string
Nullable
L1 details regarding the bag or activity.
message
string
Message or comment regarding the history.
user
string
Name of the user who created the history record.
Examples
Parameters
company_id:
1
shipment_id:
"16923636461991932987"
bag_id:
21247739
Was this section helpful?
GET
Response
Get shipment history.
getShipmentHistory
Parameters
company_id
integer
Required
Request body
activity_history
array of object (PostHistoryDict)
A list of activity history records, each adhering to the PostHistoryDict schema.
Array of PostHistoryDict
filters
array of object (PostHistoryFilters)
Required
A list of filter objects, each following the PostHistoryFilters schema, used to identify which shipment history records are relevant.
Array of PostHistoryFilters
shipment_id
string
Required
Unique identifier for the shipment
line_number
string
Optional field to specify a particular line item in the shipment.
identifier
string
Optional field for any additional identifier related to the shipment.
data
object (PostHistoryData)
Required
PostHistoryData
user_name
string
Required
The name or email of the user who performed the action or recorded the entry.
message
string
Required
A descriptive message detailing the action taken or the status related to the shipment.
Response
200
400
It shows the journey of the shipment!
ShipmentHistoryResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
activity_history
array of object (HistoryDict)
A list of activity records related to the shipment, providing details on actions taken, comments added, or notifications sent.
Array of HistoryDict
user_details
object
User Details
display_message
string
User-friendly message displaying the activity or status change.
bag_id
integer
| int32
Identifier for the bag associated with the activity.
ticket_url
string
Nullable
URL for any related tickets.
l3_detail
string
Nullable
L3 details regarding the bag or activity.
createdat
string
Date and time when the activity was created.
created_ts
string
Timestamp for when the activity was created in ISO format.
ticket_id
string
Nullable
Unique identifier for the ticket associated with the activity.
type
string
Defines the category of event-related information for a shipment, indicating the nature of the update. This includes whether the update pertains to the status of the shipment, comments added to it, or notifications about specific events.
Enum
activity_type
string
Enum
l2_detail
string
Nullable
L2 details regarding the bag or activity.
assigned_agent
string
Nullable
Name of the agent assigned to the activity.
meta
object (HistoryMeta)
HistoryMeta
store_id
integer
| int32
Nullable
Unique identifier for the store involved in the activity.
status
string
Nullable
Current status of the activity or item.
status1
string
Nullable
Additional status information if necessary.
call_id
string
Nullable
Identifier for any related calls, if applicable.
starttime
string
Nullable
Start time of the activity.
reason
object (HistoryReason)
HistoryReason
text
string
Nullable
A reason for the activity or change.
category
string
Nullable
Category of the reason for the status change.
state
string
Nullable
Current state related to the reason.
dislay_name
string
Nullable
Display name of the reason for better user understanding.
code
integer
| int32
Nullable
Unique code identifying the reason.
quantity
integer
| int32
Nullable
Quantity related to the reason, if applicable.
short_link
string
Nullable
A shortened link related to the activity, if available.
endtime
string
Nullable
End time of the activity.
store_name
string
Nullable
Name of the store involved in the activity.
caller
string
Nullable
Name of the caller associated with the activity.
store_code
string
Nullable
Code associated with the store.
billsec
string
Nullable
Duration of the billable period, if applicable.
recordpath
string
Nullable
Path to any related recordings, if applicable.
status2
string
Nullable
Additional status information if necessary.
callerid
string
Nullable
Caller ID associated with the activity, if applicable.
duration
string
Nullable
Total duration of the activity.
channel_type
string
Nullable
Type of channel used for the activity, if applicable.
Enum
activity_comment
string
Nullable
Comments related to the activity, if applicable.
activity_type
string
Nullable
Defines the category of event-related information for a shipment, indicating the nature of the update. This includes whether the update pertains to the status of the shipment, comments added to it, or notifications about specific events.
Enum
receiver
string
Nullable
Name of the receiver involved in the activity, if applicable.
recipient
string
Nullable
Recipient of the activity, if applicable.
slug
string
Nullable
Slug identifier for the activity.
message
string
Nullable
type
string
Nullable
prev_store_name
string
Nullable
The name of the store where the item was previously located before being transferred or processed. This field can be null if the previous store information is not applicable or available.
prev_store_code
string
Nullable
The unique code associated with the previous store. This code helps identify the store in the system and can be null if the previous store code is not recorded or required.
prev_store_id
string
Nullable
The unique identifier (ID) of the previous store in the database or system. This ID can be null if the previous store information is not relevant or if the store did not have a designated ID.
refund_to
string
Nullable
The destination or method by which a refund will be issued. This indicates where the refunded amount will be sent, such as back to the original payment source (e.g., 'Back To Source').
refund_information
array of object (RefundInformation)
Array of RefundInformation
mode
string
The payment method used for the order, such as CARD, Net Banking (NB), or other options. This field indicates how the original payment was made and will determine how the refund is processed.
amount
number
| float
The amount to be refunded, represented as a floating-point number. This specifies the exact value that will be returned to the customer.
merchant_transaction_id
string
A unique identifier associated with the payment transaction, such as TR669796C0012CF31BBD. This ID helps track and reference the specific transaction within the merchant's system.
refund_status
string
The current status of the refund process, indicating whether the refund has been completed, is pending, or has encountered an issue (e.g., 'refund_done', 'refund_failed'). This field reflects the state of the refund operation.
l1_detail
string
Nullable
L1 details regarding the bag or activity.
message
string
Message or comment regarding the history.
user
string
Name of the user who created the history record.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Post shipment history.
postShipmentHistory
Parameters
company_id
integer
Required
Company Id
Request body
bag_id
integer
| int32
Required
Unique identifier for the bag, used for tracking activity history related to this SMS.
data
object (SmsDataPayload)
SmsDataPayload
days
integer
Required
days
reason
string
Required
reason
shipment_id
string
Required
Unique identifier which is used to identify a shipment.
phone_number
string
Required
The recipient's phone number for communication.
amount_paid
number
| double
The amount that has been paid, as mapped in the communication template.
order_id
string
Required
Unique identifier for the order associated with the shipment.
payment_mode
string
The mode of payment used for the order, as mapped in the communication template.
customer_name
string
Required
The name of the customer, as mapped in the communication template.
brand_name
string
Required
The name of the brand associated with the order, as mapped in the communication template.
message
string
Required
The content of the SMS to be sent to the recipient.
country_code
string
Required
The country code for the recipient's phone number, necessary for proper SMS delivery.
slug
string
Required
Slug name for the SMS template mapped in the communication system, used to identify the specific messaging format or content.
Response
200
Sms Sent successfully
SendSmsResponseSchema
success
boolean
Indicates whether the SMS was sent successfully. A value of `true` means the SMS was sent without errors, while `false` indicates there was an issue.
message
string
Provides additional information about the success or failure of the SMS sending operation. If `success` is `false`, this message may contain error details.
Examples
Parameters
company_id:
261
body:
body
Was this section helpful?
POST
Response
Send SMS via Ninja.
sendSmsNinja
Parameters
company_id
integer
Required
Request body
shipment_id
string
Required
Unique identifier for the shipment for which the packaging dimensions are being updated.
current_status
string
Required
The current status of the shipment.
dimension
array of object (Dimension)
Required
A list of dimensions for the packaging.
Array of Dimension
packaging_type
string
Defines the type of packaging used for the product, encompassing materials, design, and form factors.
weight
number
The weight of the package in kilograms.
height
number
The height of the package in centimetres.
length
number
The length of the package in centimetres.
width
number
The width of the package in centimetres.
Response
200
400
Manifest will be processed!
UpdatePackagingDimensionsResponseSchema
message
string
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Update packaging dimensions.
updatePackagingDimensions
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Response
200
State Transition Mapping, for next possible state
BagStateTransitionMap
fynd
object
affiliate
object
Examples
Parameters
company_id:
1
Was this section helpful?
GET
Response
Get state transition map.
getStateTransitionMap
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
otp_data
object (AttachUserOtpData)
Required
AttachUserOtpData
request_id
string
Required
A string representing a unique identifier for the OTP request.
fynd_order_id
string
Required
A unique identifier for the order associated with the user attach.
user_info
object (AttachUserInfo)
Required
AttachUserInfo
first_name
string
Required
A string representing the user's first name.
last_name
string
Required
A string representing the user's last name.
mobile
string
Required
A string representing the user's mobile number.
country_code
string
Uniquely identifies the country associated with the user information. This code is essential for international shipments, ensuring accurate routing and delivery across global postal and customs services. Examples include 'US' for the United States, 'IN' for India.
Response
200
400
Attach user to order
AttachOrderUserResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
message
string
A descriptive message providing additional information about the API response.
status
integer
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Attach order user.
attachOrderUser
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
mobile
number
Required
The mobile phone number of the user to whom the OTP (One-Time Password) will be sent.
country_code
string
Uniquely identifies the country associated with the mobile number. This code is essential for for correctly formatting and routing the OTP messages to mobile phones across international borders. Examples include 'US' for the United States, 'IN' for India.
Response
200
Send OTP to user mobile
SendUserMobileOtpResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
status
integer
The HTTP status code of the API response (200/400/500/503).
message
string
A descriptive message providing additional information about the API response.
data
object (PointBlankOtpData)
PointBlankOtpData
request_id
string
A unique identifier for the OTP request.
resend_timer
integer
| int32
The amount of time (in seconds) before the OTP can be resent to the user.
message
string
A message providing additional information about the OTP request.
mobile
integer
The mobile number (in integer format) associated with the OTP request.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Send user mobile OTP.
sendUserMobileOTP
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
otp_data
object (VerifyOtpData)
Required
VerifyOtpData
request_id
string
Required
A unique identifier for the OTP verification request.
mobile
string
Required
The mobile number associated with the OTP verification.
otp_code
string
Required
The OTP code received by the user.
fynd_order_id
string
Required
A unique identifier for the order associated with the OTP verification.
Response
200
400
Verify OTP
VerifyOtpResponseSchema
status
integer
| int32
Represents the HTTP status code of the API response.
success
boolean
Indicates whether the API call was successful (true) or not (false).
message
string
A descriptive message providing additional information about the API response.
data
object (VerifyOtpResponseData)
VerifyOtpResponseData
mobile
string
The mobile number associated with the verified OTP.
email
string
message
string
A string that provides a message about the outcome of the verification process.
fynd_order_id
string
Unique identifier for the order associated with the OTP verification.
country_code
string
A string indicating the country code associated with the mobile number.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Verify Mobile OTP
verifyMobileOTP
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
store_ids
array of string
A list of specific store IDs for which the reports should be generated.
lane_type
string
Defines the category or type of lane for which the report is being requested for download.
custom_headers
array of string
Allows users to specify custom headers for the downloaded report.
report_type
string
Indicates the type of report being requested.
Enum
start_date
string
UTC start date in ISO format, defines the beginning of the date range for which the report data should be collected.
end_date
string
UTC end date in ISO format, defines the end date range for which the report data should be collected.
entities
array of string
Download for specific enitites or for search filters applied, entities can be bag, shipment or order_id, etc.
filter_type
string
Specifies the type of filtering to be applied to the report data.
is_cross_company_enabled
boolean
Indicates whether the report should include data from cross-company operations.
custom_filters_for_lane
object
A flexible object that allows users to define custom filters specific to the lanes being reported on.
filters
object
Download report with given filters - shipment_status, dates, payment_mode, sales_channels etc.
Response
200
400
Bulk Report creation initiated.
BulkReportsDownloadResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
batch_id
string
A unique identifier for the batch of reports generated.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Downloads lanes shipment/orders.
downloadLanesReport
Fetches details for the job of the provided batch_id
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
batch_id
string
Required
A unique identifier for the batch associated with this bulk action.
Response
200
400
Job details.
JobDetailsResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
data
array of object (JobDetailsData)
An array representing the details of a job.
Array of JobDetailsData
batch_id
string
A unique identifier for the batch of bulk actions associated with this job.
total_shipments_count
integer
The total number of shipments processed in this job.
successful_shipment_ids
array of string
An array of identifiers for shipments that were successfully processed.
successful_shipments_count
integer
The number of successful shipments processed in this job.
failed_shipments_count
integer
The number of shipments that failed to process in this job.
processing_shipments_count
integer
The number of shipments currently being processed for this job.
company_id
string
Unique identifier of a company on the platform.
file_url
string
An URL to download the submitted job file.
message
string
A message providing additional context about the request's outcome.
failed_records
array of object
An array of records that failed during processing, with additional properties providing details about each failure.
uploaded_by
string
the name or identifier of the user who uploaded the job.
user_id
string
The unique identifier for the user who performed the upload.
created_ts
string
| date-time
A timestamp indicating when the job was created.
uploaded_on
string
A timestamp indicating when the job was uploaded.
status
string
The current status of the job.
Examples
Parameters
company_id:
1
batch_id:
"123"
Was this section helpful?
GET
Response
Fetches details for the job of the provided batch_id
jobDetails
Get the file download URL used for performing bulk operation
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
batch_id
string
Required
Batch Id to identify the bulk operation request.
status
string
Required
The status of the jobs to filter the results.
file_type
string
Required
Default Value : xlsx
Enum
report_type
string
The type of report to be downloaded.
Default Value : generation_report
Enum
Response
200
400
Job details.
JobFailedResponseSchema
file_name
string
The name of the file associated with the failed job.
url
string
The URL where the uploaded bulk file can be accessed.
Examples
Parameters
company_id:
1
batch_id:
"123"
status:
"failed"
file_type:
"xlsx"
report_type:
"generation_report"
Was this section helpful?
GET
Response
Get the file download URL used for performing bulk operation
getFileByStatus
Parameters
company_id
integer
Required
Request body
shipments_data
array of object (EInvoiceRetryShipmentData)
Array of EInvoiceRetryShipmentData
shipment_id
string
Required
einvoice_type
string
Required
Defines the category or type of e-invoice generated for the shipment. This property must be set to one of the following values to qualify the shipment for e-invoice generation. invoice- A document detailing the sale, including goods, services, prices, and taxes, requesting payment. credit_note- Issued as an adjustment or correction to a previously issued invoice. It may indicate a reduction in the amount often due to reasons such as returned goods, overbilling, or a post-sale discount. A credit note effectively reverses or alters the charges outlined in the original invoice, either partially or in full.
Enum
Response
200
400
E-invoice generated successfully for all/few shipments from given list of shipments.
EInvoiceRetryResponseSchema
response_data
array of object (EInvoiceResponseData)
Array of EInvoiceResponseData
shipment_id
string
einvoice_type
string
Defines the category or type of e-invoice generated for the shipment. This property must be set to one of the following values to qualify the shipment for e-invoice generation. invoice- A document detailing the sale, including goods, services, prices, and taxes, requesting payment. credit_note- Issued as an adjustment or correction to a previously issued invoice. It may indicate a reduction in the amount often due to reasons such as returned goods, overbilling, or a post-sale discount. A credit note effectively reverses or alters the charges outlined in the original invoice, either partially or in full.
Enum
status
integer
message
string
einvoice_info
object (EInvoiceDetails)
EInvoiceDetails
irn_details
object (EInvoiceIrnDetails)
EInvoiceIrnDetails
ack_dt
string
ack_no
string
irn
string
signed_invoice
string
signed_qr_code
string
QR code containing the signed e-invoice data for quick and secure verification purposes.
error_details
array of object (EInvoiceErrorDetails)
Array of EInvoiceErrorDetails
error_code
string
Represents an identifier for the specific error encountered during the e-invoice generation or processing. This code facilitates quick identification and troubleshooting of issues, allowing for more efficient resolution.
error_message
string
Examples
Parameters
company_id:
288
body:
body
Was this section helpful?
POST
Response
Retry e-invoice after failure
eInvoiceRetry
Retrieve courier partner tracking details for a given shipment id or awb no.
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
shipment_id
string
Unique identifier of a shipment on the platform.
awb
string
AWB number
page_no
integer
Page number for pagination.
page_size
integer
Number of records per page for pagination.
Response
200
400
Shipment Tracking fetched successfully
CourierPartnerTrackingResponseSchema
items
array of object (CourierPartnerTrackingDetails)
Array of CourierPartnerTrackingDetails
awb
string
The Air Waybill (AWB) number associated with the shipment, used for tracking the parcel in transit.
dp_location
string
Nullable
The current geographic location of the courier partner.
dp_name
string
The name of the courier partner responsible for the shipment.
dp_status
string
The current status of the shipment as updated by the courier partner.
dp_status_updated_at
string
The timestamp when the status was last updated by the courier partner.
estimated_delivery_date
string
Nullable
The estimated date and time for delivery as provided by the courier partner.
id
integer
| int32
A unique identifier for the tracking history entry.
journey
string
Indicates the type of journey the shipment.
Enum
meta
object
A field to store additional metadata related to the courier partner's operations or the shipment.
operational_status
string
The operational status of the shipment.
promised_delivery_date
string
Nullable
PThe promised date and time for delivery as provided by the courier partner.
remark
string
Nullable
Any additional remarks or comments from the courier partner regarding the shipment.
shipment_id
string
The unique identifier for the shipment.
page
object (PageDetails)
PageDetails
current
integer
| int32
Nullable
Current page number
has_next
boolean
Nullable
if next page contains any result
has_previous
boolean
Nullable
if previous page contains any result
item_total
integer
| int32
Total count of the results present in the requested filter
size
integer
| int32
Nullable
Page size
total
integer
| int32
Nullable
Total
type
string
Nullable
Type of the page
Enum
Examples
Parameters
company_id:
148
shipment_id:
"17270022113341641815"
page_no:
1
page_size:
2
Was this section helpful?
GET
Response
Retrieve courier partner tracking details for a given shipment id or awb no.
trackShipment
Modify courier partner tracking details for a given shipment id or awb no.
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
awb
string
Required
The Air Waybill (AWB) number associated with the shipment, used for tracking the parcel in transit.
dp_location
string
Nullable
The current geographic location of the courier partner.
dp_name
string
Required
The name of the courier partner responsible for the shipment.
dp_status
string
Required
The current status of the shipment as updated by the courier partner.
dp_status_updated_at
string
Required
The timestamp when the status was last updated by the courier partner.
estimated_delivery_date
string
Nullable
The estimated date and time for delivery as provided by the courier partner.
id
integer
| int32
A unique identifier for the tracking history entry.
journey
string
Required
Indicates the type of journey the shipment.
Enum
meta
object
A field to store additional metadata related to the courier partner's operations or the shipment.
operational_status
string
Required
The operational status of the shipment.
promised_delivery_date
string
Nullable
PThe promised date and time for delivery as provided by the courier partner.
remark
string
Nullable
Any additional remarks or comments from the courier partner regarding the shipment.
shipment_id
string
Required
The unique identifier for the shipment.
Response
200
400
Shipment Tracking updated successfully
CourierPartnerTrackingDetails
awb
string
The Air Waybill (AWB) number associated with the shipment, used for tracking the parcel in transit.
dp_location
string
Nullable
The current geographic location of the courier partner.
dp_name
string
The name of the courier partner responsible for the shipment.
dp_status
string
The current status of the shipment as updated by the courier partner.
dp_status_updated_at
string
The timestamp when the status was last updated by the courier partner.
estimated_delivery_date
string
Nullable
The estimated date and time for delivery as provided by the courier partner.
id
integer
| int32
A unique identifier for the tracking history entry.
journey
string
Indicates the type of journey the shipment.
Enum
meta
object
A field to store additional metadata related to the courier partner's operations or the shipment.
operational_status
string
The operational status of the shipment.
promised_delivery_date
string
Nullable
PThe promised date and time for delivery as provided by the courier partner.
remark
string
Nullable
Any additional remarks or comments from the courier partner regarding the shipment.
shipment_id
string
The unique identifier for the shipment.
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Update shipment tracking.
updateShipmentTracking
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Request body
entity_type
string
Required
Specifies the type of entity being locked or unlocked.
Enum
action
string
Required
Indicates the action to be performed on the entity.
Enum
action_type
string
Required
Defines the current lock state or lock type of a shipment, dictating the types of transitions or actions that can be performed next.The action_type can be one of the following - complete- Complete lock specifies that no action can be performed for that shipment. - operational- The shipment is in an operational phase, during which only financial-related actions are permissible. - financial- The shipment is in a financial phase, allowing for operational actions to be taken.
Enum
user_id
string
The ID of the user.
entities
array of object (LockManagerEntities)
Required
List of entities to be locked or unlocked
Array of LockManagerEntities
id
string
Shipment ID if 'entity_type': shipments | Bag Id if 'entity_type': bags
affiliate_order_id
string
External identifier for the order id associated with shipment.
affiliate_id
string
Identifier for application associated with the shipment.
reason_text
string
Required
A descriptive reason text for lock/unlock action of a shipment/bag.
affiliate_bag_id
string
External identifier for the bag id associated with orders/shipment.
affiliate_shipment_id
string
External identifier for the shipment id associated with orders/shipment.
resume_tasks_after_unlock
boolean
Nullable
Indicates whether tasks should resume automatically after unlocking, such as DP assignment task and invoicing task.
lock_after_transition
boolean
Specifies whether the shipment should be locked automatically after a transition occurs.
unlock_before_transition
boolean
Specifies whether the shipment should be unlocked before a transition occurs.
Response
200
400
Successfully update the Lock and get check status of the shipment/Bag
UpdateShipmentLockResponseSchema
success
boolean
Indicates whether the API call was successful (true) or not (false).
message
string
A descriptive message providing additional information about the API response, such as success confirmation or error details.
check_response
array of object (CheckResponseSchema)
An array containing the lock status of entities if the action performed was a 'check'. Each item in the array represents the status of a specific entity.
Array of CheckResponseSchema
shipment_id
string
Shipment ID
status
string
Status
is_bag_locked
boolean
Is Bag Locked
affiliate_id
string
Affiliate ID
original_filter
object (OriginalFilter)
Filter
OriginalFilter
affiliate_shipment_id
string
Affiliate Shipment ID
affiliate_id
string
Affiliate ID
shipment_id
string
Shipment ID
is_shipment_locked
boolean
Is Shipment Locked
lock_status
string
Nullable
Lock Status: Expected lock_status: [complete, operational, financial]
affiliate_shipment_id
string
Affiliate Shipment ID
bags
array of object (Bags)
Array of Bags
bag_id
integer
| int32
Bag Id
affiliate_bag_id
string
Application/Affiliate Bag ID, Required if the ID is missing
is_locked
boolean
Is Bag Locked
affiliate_order_id
string
Application/Affiliate Order ID, Required if the ID is missing
status
integer
Status
Examples
Parameters
company_id:
288
body:
body
Was this section helpful?
POST
Response
Update shipment lock.
updateShipmentLock
Parameters
company_id
integer
Required
company id from where are transitioning the shipment state or data
Request body
force_transition
boolean
Force Transition
statuses
array of object (RequestActionSchema)
Array of RequestActionSchema
action
string
Action Enum for Corresponding state name
shipments
array of object (ShipmentsRequestSchema)
Array of ShipmentsRequestSchema
identifier
string
Required
Unique identifier for the shipment.
reasons
object (ReasonsData)
ReasonsData
products
array of object (ProductsReasons)
A list of reasons specifically related to products involved in the shipment.
Array of ProductsReasons
filters
array of object (ProductsReasonsFilters)
A list of filters applied to specify which products the reasons pertain to.
Array of ProductsReasonsFilters
line_number
integer
| int32
The line number for the product or bag, which helps identify the specific item in a list or order.
identifier
string
The unique article or item identifier for the product or bag.
quantity
number
| float
The quantity of the product or bag being referenced.
data
object (ProductsReasonsData)
ProductsReasonsData
reason_text
string
A descriptive text providing the reason for the action or status associated with the product or bag.
reason_id
integer
| int32
A unique identifier for the reason, used to reference specific reasons in the system.
entities
array of object (EntitiesReasons)
A list of reasons specifically related to shipment.
Array of EntitiesReasons
filters
array of object
A list of filters applied to specify which entities the reasons pertain to.
data
object (EntityReasonData)
EntityReasonData
reason_text
string
A descriptive text providing the reason for the action or status associated with the product or bag.
reason_id
integer
| int32
A unique identifier for the reason, used to reference specific reasons in the system.
products
array of object (Products)
A list of products or bags that need to be updated as part of the shipment status change.
Array of Products
line_number
integer
| int32
The line number for the product or bag, which helps identify the specific item in a list or order.
identifier
string
The unique article or item identifier for the product or bag.
quantity
number
| float
The quantity of the product or bag being referenced.
data_updates
object (DataUpdates)
DataUpdates
order_item_status
array of object (OrderItemDataUpdates)
A list of updates related to the status of order items.
Array of OrderItemDataUpdates
data
object
Contains the specific data for updating shipment bags data.
products
array of object (ProductsDataUpdates)
A list of updates related to the properties of products or bags.
Array of ProductsDataUpdates
filters
array of object (ProductsDataUpdatesFilters)
A list of filters applied to specify which products or bags are targeted for updates.
Array of ProductsDataUpdatesFilters
line_number
integer
| int32
Represents the specific line item within a bag, used to identify and reference a particular product in a list. This helps in pinpointing the exact item being updated or processed.
identifier
string
A unique string that serves as the product’s identifier, such as a SKU, barcode, or another distinct code. This ensures the product is correctly identified and distinguished from other items in the system.
quantity
number
| float
The quantity of the product or item. This indicates how many units of the product are being referenced or processed, such as the number of items in a bag or shipment.
data
object
Contains the specific data for updating the products or bags.
entities
array of object (EntitiesDataUpdates)
A list of updates related to the properties of any relevant entities.
Array of EntitiesDataUpdates
filters
array of object
A list of filters used to specify which shipments are targeted for updates.
data
object
Encapsulates a dynamic set of updates and modifications applied to the entity.
repriced_products
array of object (RepricedProductsDataUpdates)
To update the prices of the line items and trigger the repricing event process.
Array of RepricedProductsDataUpdates
line_number
integer
| int32
A unique identifier to filter the product or bag within the shipment.
identifier
string
A seller's product identifier used to filter the bag within the shipment.
price
integer
| int32
Adjusted price of the bag.
order
array of object (OrderDataUpdates)
Array of OrderDataUpdates
data
object
Encapsulates a dynamic set of updates and modifications applied to the order.
transition_comments
array of object (TransitionComments)
Array of TransitionComments
title
string
Title of the comment
message
string
Comment to be added
exclude_bags_next_state
string
State to be change for Remaining Bag/Products
split_shipment
boolean
Flag to split shipment
lock_after_transition
boolean
Lock Shipment After Transition
unlock_before_transition
boolean
Unlock Shipment After Transition
task
boolean
To Run Status Update as a background Task
Response
200
NOTE success response can contains success and failed result as well
UpdateShipmentStatusResponseBody
statuses
array of object (StatuesResponseSchema)
List of statuses of the shipments after a status update operation. Includes an array of status objects, each containing details about shipments that have undergone data updates.
Array of StatuesResponseSchema
shipments
array of object (ShipmentsResponseSchema)
List of Shipments which includes data for each shipment, the current status code, final state information including reasons for cancellation (if applicable), and unique shipment identifiers are provided.
Array of ShipmentsResponseSchema
status
integer
| int32
Nullable
final_state
object
Nullable
identifier
string
Nullable
stack_trace
string
Nullable
code
string
Nullable
meta
object
Nullable
message
string
Nullable
exception
string
Nullable
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
PUT
Response
Update shipment status.
updateShipment
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
lane
string
Name of lane for which data is to be fetched
Enum
bag_status
string
Comma separated values of bag statuses.
status_override_lane
boolean
Use this flag to fetch by bag_status and override lane.
Default Value : false
time_to_dispatch
integer
Indicates the time to dispatch.
Enum
search_type
string
Specifies the key used to determine the type of search being performed.
Enum
search_value
string
The value corresponding to the search type, such as a specific shipment ID or order ID.
start_date
string
| date-time
The UTC start date in ISO format (YYYY-MM-DDTHH:MM:SSZ) for filtering results.
end_date
string
| date-time
The UTC end date in ISO format (YYYY-MM-DDTHH:MM:SSZ) for filtering results.
dp_ids
string
A comma-separated list of delivery partner IDs to filter results by specific delivery partners.
stores
string
A comma-separated list of store IDs used to filter results to only those related to specific stores.
sales_channels
string
A comma-separated list of sales channel IDs to filter results based on the sales channels involved.
page_no
integer
Specifies the page number for paginated results.
Default Value : 1
page_size
integer
Determines the number of results returned per page.
Default Value : 10
fetch_active_shipment
boolean
A boolean flag that indicates whether to include only active shipments in the results.
Default Value : true
allow_inactive
boolean
A flag indicating whether to allow the inclusion of inactive shipments in the results.
Default Value : false
exclude_locked_shipments
boolean
A flag to specify whether to exclude shipments that are locked from the results.
Default Value : true
payment_methods
string
A comma-separated list of payment methods.
channel_shipment_id
string
The shipment ID used in the application, which can be used to reference specific shipments.
channel_order_id
string
The order ID used in the application.
custom_meta
string
Custom metadata associated with the query, allowing for additional filtering or information to be passed.
ordering_channel
string
The channel through which the order was placed.
company_affiliate_tag
string
A tag used to identify the company's affiliation for filtering or reporting purposes.
my_orders
boolean
A boolean flag indicating whether the query should return only the user's orders.
platform_user_id
string
The unique identifier of the user on the platform, useful for filtering orders related to a specific user.
sort_type
string
Determines the sorting order of the results based on specific criteria.
Default Value : sla_asc
Enum
show_cross_company_data
boolean
A flag indicating whether to include data from both cross-company and non-cross-company orders in the results.
Default Value : false
tags
string
A comma-separated list of tags associated with the orders to filter results based on specific characteristics.
customer_id
string
The unique identifier for the customer associated with the query, useful for filtering results to a specific customer.
order_type
string
The type of order being queried.
Enum
operational_status
string
Statuses relating to shipment transition in order processing journey. Comma separated values of operational statuses.
financial_status
string
Statuses relating to finance related operations in the order processing journey. Comma separated values of financial statuses.
logistics_status
string
Statuses relating to delivery and pickup related operations in the order processing journey. Comma separated values of logistics statuses.
parent_view_slug
string
Parent view is used for grouping of child views. Slug of parent view.
child_view_slug
string
Child view is user configured view which has filters added by the user on which shipments/orders are fetched. Slug of child view.
lock_status
string
Flag to identify if a shipment is locked or not.
group_entity
string
Defines the grouping criterion for retrieving shipments or orders. It specifies whether the results should be organized based on shipment groups or order groups. For example, using 'shipments' groups results by shipment, while an invalid value like 'abcd' may not be recognized, leading to errors or default behavior.
enforce_date_filter
boolean
Applies a date filter for listing shipments. This is useful when fetching data for a specific date range while performing searches.
Default Value : false
Response
200
400
We are processing the report!
ShipmentInternalPlatformViewResponseSchema
total_count
integer
Nullable
The total number of shipments matching the query criteria.
message
string
Nullable
A message providing additional context about the response.
success
boolean
Nullable
Indicates whether the API call was successful (true) or not (false).
items
array of object (ShipmentItem)
Nullable
An array of shipment items returned as part of the response.
Array of ShipmentItem
order_date
string
| date-time
Nullable
Denotes the date and time when an order was placed by the customer. This timestamp is crucial for tracking the order'
order_created_ts
string
Nullable
Order created date
shipment_status
object (ShipmentStatus)
ShipmentStatus
current_shipment_status
string
Nullable
Current shipment status; it can be financial, logistics or operational
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
id
integer
Nullable
A unique identifier for the shipment status.
bag_list
array of string
Nullable
A list of bags associated with the shipment, useful for tracking individual items within the shipment.
title
string
A brief title or label for the shipment status, summarizing its current state.
display_name
string
A user-friendly name or identifier for the shipment status.
created_at
string
| date-time
Nullable
Timestamp when the shipment was initially created.This timestamp is crucial for tracking the shipment's age, scheduling, and historical analysis.
created_ts
string
Nullable
A general timestamp for when the shipment was created, formatted for internal processing.
shipment_id
string
Nullable
A unique identifier for the shipment.
status_created_at
string
| date-time
Nullable
Timestamp when the transition for the status of the shipment was created. Date time in UTC timezone as per ISO format.
status_created_ts
string
Nullable
Shipment status created date timestamp
status
string
This key denotes the status of the shipment, providing a clear indication of its current processing stage.
updated_ts
string
Nullable
A general timestamp indicating when the status was updated, useful for processing and tracking.
user
object (UserDataInfo)
UserDataInfo
id
integer
Nullable
The unique identifier associated with the user.
user_oid
string
Nullable
The object ID for the user, used for referencing the user in various operations.
mongo_user_id
string
Nullable
User Object ID assigned within the system
external_customer_id
string
Nullable
The identifier for the user in external systems.
first_name
string
Nullable
The first name of the user.
last_name
string
Nullable
The last name of the user.
mobile
string
Nullable
The mobile phone number of the user.
email
string
Nullable
The email address of the user.
meta
string
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
avis_user_id
string
Nullable
Avis user id
name
string
Nullable
A full name of the user, which may be a combination of first and last name.
gender
string
Nullable
The gender of the user.
country_phone_code
string
The country-specific phone code, useful for formatting mobile numbers correctly.
estimated_sla_time
string
Nullable
The estimated Service Level Agreement (SLA) time for the shipment.
estimated_sla_ts
string
Nullable
The timestamp for the estimated SLA, providing a specific time for expected delivery.
delivery_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
billing_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
affiliate_details
object (AffiliateDetails)
AffiliateDetails
shipment_meta
object (ShipmentMeta)
ShipmentMeta
tracking_url
string
Nullable
A URL for tracking the shipment.
estimated_delivery_date
string
| date-time
Nullable
Provides a forecasted date and time by which the shipment is expected to be delivered to the recipient. This estimation is crucial for planning purposes, both for the sender in managing expectations and for the recipient in preparing for receipt.
same_store_available
boolean
Indicates whether the shipment is available for pickup from the same store.
b2b_buyer_details
object (BuyerDetails)
BuyerDetails
ajio_site_id
string
Nullable
The unique identifier for the buyer on the Ajio platform.
pincode
integer
The postal code for the buyer's shipping address, used for delivery location identification.
address
string
Provides the comprehensive address details of the buyer's shipping address.
gstin
string
The Goods and Services Tax Identification Number (GSTIN) of the buyer.
name
string
The full name of the buyer, essential for personalizing communication and delivery.
state
string
The name of the state where the buyer's shipping address is located, important for logistical purposes.
city
string
The name of the city where the buyer's shipping address is located, which helps in identifying delivery zones.
formatted
object (Formatted)
Formatted
max
string
Nullable
Represents the maximum formatted value, providing a limit for the associated data, such as dimensions or weights.
min
string
Nullable
Represents the minimum formatted value, establishing a lower limit for the associated data, ensuring it meets certain criteria or standards.
debug_info
object (DebugInfo)
DebugInfo
stormbreaker_uuid
string
Nullable
A unique identifier (UUID) associated with the Stormbreaker system, used for tracking and debugging purposes in the application.
return_awb_number
string
Nullable
The Air Waybill (AWB) number associated with a return shipment.
is_self_ship
boolean
Nullable
Indicates whether the shipment is a self-shipped order.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
einvoice_info
object (EinvoiceInfo)
EinvoiceInfo
credit_note
object
Nullable
Specifies the reverse einvoice transaction create on government portal.
invoice
object
Nullable
It specifies the forward einvoice transaction created on government portal.
return_affiliate_shipment_id
string
Nullable
The shipment ID associated with a return from an affiliate.
parent_dp_id
string
Nullable
The unique identifier for the parent delivery partner.
shipment_weight
number
Nullable
The total weight of the shipment.
dimension
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
assign_dp_from_sb
boolean
Nullable
Indicates whether to assign the delivery partner from the store’s basket.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
store_invoice_updated_date
string
| date-time
Nullable
Denotes the date and time when the store's invoice related to this shipment was updated. This timestamp is vital for tracking changes to billing details, adjustments in charges, or updates in the invoicing status.
forward_affiliate_shipment_id
string
Nullable
The shipment ID for the forward journey of an affiliate shipment.
return_store_node
integer
Nullable
The identifier for the store node involved in the return process.
fulfilment_priority_text
string
Nullable
Textual representation of the fulfillment priority for the shipment.
shipment_tags
array of object (ShipmentTags)
Tags associated with the shipment for categorization and filtering.
Array of ShipmentTags
slug
string
Nullable
A URL-friendly string representing the tag, often used for routing or categorization.
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
display_text
string
Nullable
A human-readable text representation of the tag, used for display purposes in user interfaces.
external
object
Nullable
External metadata related to the shipment.
awb_number
string
Nullable
The Air Waybill number associated with the shipment.
lock_data
object (LockData)
LockData
locked
boolean
Nullable
Indicates whether the shipment is currently locked for processing (true) or not (false).
mto
boolean
Nullable
A flag indicating whether the shipment is part of a multi-modal transport operation.
lock_message
string
Nullable
An optional message providing additional context or information regarding the lock status.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow.
Enum
ewaybill_info
object
Nullable
Electronic Way Bill details i.e ewayBillNo, ewayBillDate that are utilized in the transportation of goods.
dp_id
string
Nullable
The unique identifier for the delivery partner associated with the shipment.
shipment_volumetric_weight
number
Nullable
The volumetric weight of the shipment, which may differ from its actual weight.
marketplace_store_id
string
Nullable
The unique identifier for the marketplace store associated with the shipment.
return_details
object
Nullable
An object containing the return details of the shipment.
dp_sort_key
string
Nullable
A sort key for the delivery partner, used for prioritization.
packaging_name
string
Nullable
The name of the packaging used for the shipment.
timestamp
object (ShipmentTimeStamp)
ShipmentTimeStamp
max
integer
Nullable
Represents the maximum timestamp value, indicating the latest time relevant to the shipment.
min
integer
Nullable
Represents the minimum timestamp value, indicating the earliest time relevant to the shipment.
auto_trigger_dp_assignment_acf
boolean
Nullable
Indicates whether automatic delivery partner assignment is triggered for this shipment.
dp_name
string
Nullable
The name of the delivery partner associated with the shipment.
po_number
string
Nullable
The purchase order number associated with the shipment.
weight
integer
The weight of the shipment, typically measured in grams or kilograms.
b2c_buyer_details
object
Nullable
Contains detailed information about the buyer in a business-to-consumer (B2C) transaction. This object is designed to capture a wide array of buyer-specific data such as contact information, shipping address, preferences, and any other relevant details that enhance the understanding of the buyer's profile and needs.
forward_affiliate_order_id
string
Nullable
The order ID for the forward journey of an affiliate shipment.
return_affiliate_order_id
string
Nullable
The order ID for the return journey of an affiliate shipment.
bag_weight
object
Nullable
This object is designed to accommodate a range of weight-related information. Denotes the weight of the bag, potentially including various measurements or related details.
refund_to
string
Nullable
Specifies the recipient of any refunds related to the shipment.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_shipment_id
string
The shipment ID specific to this affiliate.
company_affiliate_tag
string
Nullable
An optional tag representing the company's affiliate association.
affiliate_order_id
string
The order ID associated with the affiliate shipment.
pdf_links
object (PDFLinks)
PDFLinks
invoice_type
string
The type of invoice issued, such as 'fynd' or other classifications.
Enum
label_a6
string
Nullable
URL or path to the A6 size label document.
invoice
string
Nullable
URL or path to the main invoice document.
label_pos
string
Nullable
URL or path to the POS label document.
invoice_a6
string
Nullable
URL or path to the A6 size invoice document.
b2b
string
Nullable
URL or path to the B2B document related to the transaction.
label
string
Nullable
URL or path to the general label document.
label_a4
string
Nullable
URL or path to the A4 size label document.
label_type
string
Specifies the type of label associated with a PDF document,indicating its purpose or content. The label_type helps in organizing and identifying PDF documents quickly, ensuring that users or systems can efficiently utilize the correct documents for required actions.
Enum
invoice_export
string
Nullable
URL or path to the exported invoice document.
credit_note_url
string
Nullable
URL or path to the credit note document.
delivery_challan_a4
string
Nullable
URL or path to the A4 delivery challan document.
label_export
string
Nullable
URL or path to the exported label document.
invoice_a4
string
Nullable
URL or path to the A4 size invoice document.
invoice_pos
string
Nullable
URL or path to the POS invoice document.
po_invoice
string
Nullable
URL or path to the purchase order invoice document.
config
object (AffiliateConfig)
AffiliateConfig
app
object (AffiliateAppConfig)
AffiliateAppConfig
id
string
description
string
updated_at
string
| date-time
The date and time when the app config was updated.
name
string
token
string
meta
array of object (AffiliateAppConfigMeta)
Array of AffiliateAppConfigMeta
value
string
name
string
owner
string
secret
string
created_at
string
| date-time
Timestamp when the app config was created.
inventory
object (AffiliateInventoryConfig)
AffiliateInventoryConfig
article_assignment
object (AffiliateInventoryArticleAssignmentConfig)
AffiliateInventoryArticleAssignmentConfig
post_order_reassignment
boolean
payment
object (AffiliateInventoryPaymentConfig)
AffiliateInventoryPaymentConfig
source
string
mode_of_payment
string
inventory
object (AffiliateInventoryStoreConfig)
AffiliateInventoryStoreConfig
store
object
Fulfilling store information related to the shipment.
order
object (AffiliateInventoryOrderConfig)
AffiliateInventoryOrderConfig
force_reassignment
boolean
logistics
object (AffiliateInventoryLogisticsConfig)
AffiliateInventoryLogisticsConfig
dp_assignment
boolean
app_company_id
integer
Nullable
A unique identifier for the company associated with the affiliate app, used for tracking and managing affiliate relationships.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_id
string
Nullable
The unique identifier for the affiliate.
affiliate_store_id
string
The unique identifier for the affiliate's store.
affiliate_bag_id
string
The unique identifier for the affiliate's bag.
id
string
Nullable
The unique identifier for the affiliate.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
is_active
boolean
This flag denotes whether the shipment is active or not.
channel
object (ShipmentListingChannel)
ShipmentListingChannel
channel_shipment_id
string
Nullable
A unique identifier for the shipment associated with a specific channel, facilitating tracking and management.
is_affiliate
boolean
Nullable
Indicates whether the shipment is associated with an affiliate program, which may affect processing and fulfillment.
logo
string
Nullable
A URL or path to the logo of the shipment channel, used for branding and identification purposes.
name
string
Nullable
The name of the shipment channel, providing a human-readable reference for the channel through which the shipment is processed.
previous_shipment_id
string
Nullable
The ID of any previous shipment related to this order.
forward_end_shipment_id
string
Nullable
The forward_end_shipment_id represents the shipment ID of the original forward journey shipment. When a shipment is transitioned to a return journey, the original shipment ID from the forward journey is recorded in the forward_end_shipment_id field of the return journey shipment. Even if the return shipment is later split into multiple shipments, each of these shipments will retain the same forward_end_shipment_id value that was assigned during the initial return journey initiation. This ensures that all return shipments can be traced back to the original forward journey shipment.
lock_status
boolean
Nullable
Indicates whether the shipment is currently locked for processing (true) or not (false).
invoice_id
string
Nullable
The ID of the invoice associated with the shipment.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. This includes metadata such as logos, payment IDs, and merchant codes, as well as transaction-specific details like the payment mode, name, amount, and entities responsible for refunds and collections. The structure is designed to accommodate any number of payment methods, providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_info
array of object
Nullable
An array of payment information items related to the shipment, detailing transaction specifics.
status_created_at
string
| date-time
Date time in UTC timezone as per ISO format.
status_created_ts
string
The timestamp indicating when the current status was logged, usually in ISO 8601 format.
display_name
string
Nullable
A user-friendly name or identifier for the shipment, useful for display purposes.
bags
array of object (BagUnit)
An array of bags included in the shipment.
Array of BagUnit
bag_type
string
Nullable
Specifies the type or category of the bag.
Enum
gst
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
financial_breakup
array of object (FinancialBreakup)
Array of FinancialBreakup
refund_credit
number
Refund credits provided to the customer
amount_paid_roundoff
integer
Nullable
Amount paid rounded off
price_effective
number
MRP - Initial Seller provided discount
promotion_effective_discount
number
Effective promotion discount including promotions given by seller and Platform
transfer_price
number
article
coupon_effective_discount
number
Coupon provided by brand or seller
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
tax_collected_at_source
number
Nullable
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Price Effective - Coupon Discount (Seller) - Promotion (Seller)
delivery_charge
number
The fee associated with the delivery service for transporting the item to its destination
gst_tag
string
Type of GST applied - IGST, CGST, SGST
hsn_code
string
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
cashback
number
Cashback points
item_name
string
The name of the item being referenced
value_of_good
number
Effective selling price - Product GST Amount
cashback_applied
number
Cashback applied on the order
cod_charges
number
The fee associated with the COD order
price_marked
number
The indicated price or value assigned to an item before any discounts or adjustments
size
string
The physical dimensions or specifications of the item, indicating its size or measurements
amount_paid
number
Amount paid by the customer
coupon_value
number
Stores the coupon value as shown in the cart
discount
number
The total amount discounted from the original MRP/actual price
fynd_credits
number
Credits provided by Fynd
gst_tax_percentage
number
The percentage rate of GST applied to a product or service
amount_to_be_collected
number
Amount to be collected in case of multiple modes of payments.
identifiers
object (Identifier)
Identifier
alu
string
Nullable
The ALU (Article Level Unit) code used to identify the item at a detailed level, often specific to certain retail or distribution systems.
ean
string
Nullable
The European Article Number (EAN) is a unique identifier for products, primarily used in retail and logistics. It helps in tracking and managing inventory across various platforms.
sku_code
string
Nullable
The Stock Keeping Unit (SKU) code of the item - uniquely identifies each distinct product. SKUs are used to track inventory levels, facilitate accurate stocktaking, and streamline order fulfillment processes. This code is essential for inventory management, allowing for the differentiation between products based on attributes such as price, color, and size.
upc
string
Nullable
The Universal Product Code (UPC) is a barcode symbol used for tracking trade items in stores. It is widely used in North America and helps in identifying products quickly during point-of-sale transactions.
isbn
string
Nullable
The International Standard Book Number (ISBN) is a unique identifier for books, allowing for easier management and tracking of book inventories in retail and library systems.
total_units
integer
Total number of units of the item
added_to_fynd_cash
boolean
Flag indicating whether fynd cash has been used
refund_amount
number
tcs_percentage
number
bag_expiry_date
string
| date-time
Nullable
Indicates the date and time when the contents of a bag, or the bag itself, are no longer considered valid or safe for use. This is particularly relevant in contexts where the bag contains perishable goods, sensitive materials, or items with a limited shelf life
bag_status
array of object (BagStatusHistory)
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
current_operational_status
object (BagStatusHistory)
BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
article
object (Article)
Article
child_details
object
Nullable
Contains a flexible set of key-value pairs representing detailed information about the article's child entities, including dimensions (width, height, length), weight, and unique identifiers (EAN, article code, seller identifier) for each child entity.
seller_identifier
string
Unique identifier assigned by the seller to the article, used for inventory management.
uid
string
A unique identifier for the article within the system.
set
object
Nullable
Represents the data related to combinations of articles that, while being the same product, vary by size, color, or other distinguishing features.
dimensions
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
currency
object
Nullable
Currency in which the transaction amount associated with the article is specified.
esp_modified
boolean
Nullable
Indicates whether the article has been modified by the ESP (e-commerce service provider).
return_config
object (ReturnConfig)
Nullable
Configuration related to the return policy for the article.
ReturnConfig
returnable
boolean
Nullable
Flag indicating whether product is returnable or not
time
number
Nullable
Number indicating number of hours or days
unit
string
Nullable
String indicating the unit of the time, eg. days, hours
code
string
Nullable
A unique alphanumeric identifier assigned to a specific article for inventory and tracking purposes
weight
object (Weight)
Weight
is_default
boolean
Nullable
Whether the weight is the default one or not
shipping
integer
Nullable
The shipping weight of the product
unit
string
Nullable
The unit of weight
_id
string
DB generated ID of the article
identifiers
object
Product identifiers
raw_meta
string
Nullable
Raw meta data of the article
size
string
The physical dimensions or specifications of the article, indicating its size or measurements
is_set
boolean
Nullable
A boolean indicating whether the article is a set
tags
array of string
Nullable
Tags associated with the article
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
brand
object (ShipmentListingBrand)
ShipmentListingBrand
logo
string
Nullable
URL or path to the logo image of the brand associated with the shipment.
created_on
string
| date-time
Nullable
Timestamp indicating when the brand of the shipment was created, formatted as date-time.
name
string
Nullable
The name of the brand linked to the shipment.
logo_base64
string
Nullable
Base64 encoded string of the brand's logo image, allowing for direct embedding in documents or applications.
affiliate_bag_details
object (AffiliateBagDetails)
AffiliateBagDetails
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_order_id
string
Unique identifier for the affiliate order associated with the bag.
employee_discount
number
Nullable
Discount percentage or amount applicable to employees for this order.
affiliate_bag_id
string
Unique identifier for the affiliate bag, used for tracking and reference.
loyalty_discount
number
Nullable
Discount amount applied based on customer loyalty, if applicable.
item
object (PlatformItem)
PlatformItem
id
integer
Nullable
Unique identifier for the platform item.
attributes
object (PlatformArticleAttributes)
PlatformArticleAttributes
currency
string
Nullable
The currency in which the price of the article is specified.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
brand_id
integer
Nullable
Identifier for the brand associated with the item.
slug_key
string
Nullable
A user-friendly string that represents the item, often used in URLs.
l3_category
integer
Nullable
Represents the product's classification at the third level in the e-commerce platform's category hierarchy, using an integer identifier.
l3_category_name
string
Nullable
Name of the third-level category under which the product is listed.
last_updated_at
string
| date-time
Nullable
Timestamp when any aspect of the associated record was modified, formatted as date-time.
name
string
Nullable
The name of the product item.
l2_category
array of string
Nullable
Represents the second level of categorization for items, helping customers narrow down their search.
brand
string
Nullable
Name of the brand associated with the item.
image
array of string
Nullable
Array of image URLs representing the item.
code
string
Nullable
Unique code for the item, often used for inventory management.
l1_category
array of string
Nullable
Represents the highest or top-tier level of categorization for the product.
size
string
Nullable
Size specification of the product, if applicable.
can_cancel
boolean
Nullable
Indicates whether the item can be canceled after order placement.
can_return
boolean
Nullable
Indicates whether the item is eligible for return.
branch_url
string
Nullable
URL linking to a specific branch or store where the item is available.
meta
object
Nullable
Meta data containing additional, dynamic information about the item.
color
string
Nullable
Color specification of the product, if applicable.
department_id
integer
Nullable
Identifier for the department associated with the product.
images
array of string
Nullable
Array of image URLs representing different views or angles of the item.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
tags
array of string
l2_category_id
number
reasons
array of object
Nullable
A collection of reasons associated with the bag, which could pertain to returns, cancellations, or other relevant contexts.
product_quantity
integer
The total quantity of products contained within the bag.
can_return
boolean
Nullable
Indicates whether the items in the bag are eligible for return.
display_name
string
Nullable
A user-friendly name or label for the bag, which may be displayed in interfaces.
can_cancel
boolean
Nullable
Indicates whether the bag or its contents can be canceled.
size
string
Nullable
Specifies the size of the bag, which may be relevant for packaging or shipping considerations.
line_number
integer
Nullable
Represents the line number in an order or transaction associated with the bag.
meta
object
Nullable
Meta data of the bag contains additional, potentially dynamic information about the bag.
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
dates
object (Dates)
Dates
delivery_date
string
| date-time
Nullable
Represents the scheduled date and time for the delivery of the entity.
order_created
string
Nullable
current_status
object (BagStatusHistory)
BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
bag_id
integer
Unique identifier for the bag.
entity_type
string
Nullable
Specifies the type of entity.
Enum
status
object (BagReturnableCancelableStatus)
BagReturnableCancelableStatus
is_returnable
boolean
Indicates whether the bag can be returned by the customer.
is_active
boolean
Specifies if the current status of the bag is active, affecting its eligibility for return or cancellation.
can_be_cancelled
boolean
Indicates if the bag order can be cancelled by the customer.
enable_tracking
boolean
Indicates whether tracking is enabled for the bag, allowing customers to monitor its status.
is_customer_return_allowed
boolean
Specifies if the customer is permitted to return the bag, based on the return policy.
fulfilling_store
object (ShipmentItemFulFillingStore)
ShipmentItemFulFillingStore
phone
string
Nullable
Contact phone number for the store.
brand_store_tags
array of string
Nullable
Brand store tags
pincode
string
Nullable
Postal code (pincode) of the stores location.
meta
object
Nullable
Meta object for extra data
address
string
Nullable
Comprehensive address details of the fulfilling store, including all necessary components for locating the store.
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
Address1 compiles all into a single formatted string.
The address is formed by the template provided and whichever keys are present in the template are
populated as is from store address fields.
Template Example: {address} {address2}_{area} {state}_{country},
display_address
string
Nullable
Formatted display version of the address
location_type
string
Nullable
Type of location of the fulfilling store.
Enum
id
integer
Unique identifier for the store.
code
string
Alphanumeric code representing the store.
store_email
string
Nullable
Store email
name
string
Nullable
Name of the store
state
string
Nullable
State where the store is located.
city
string
Nullable
City where the store is located.
tags
array of string
Nullable
Array of tags associated with the store
company_id
integer
Identifier of the company responsible for fulfilling shipments from this store
meta
object
Meta data of the item contains additional, potentially dynamic information about the item.
payment_mode
string
Nullable
The mode of payment used for the shipment.
can_process
boolean
Nullable
Indicates whether the shipment can currently be processed (true) or not (false).
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
order_id
string
The unique identifier of the order for the shipment.
ordering_channnel
string
Nullable
The channel used for ordering the shipment.
shipment_id
string
Nullable
The unique identifier for the shipment itself.
customer_note
string
Nullable
Any special notes or instructions provided by the customer related to the shipment.
total_bags
integer
The total number of bags in the shipment.
shipment_created_at
string
| date-time
Timestamp of the shipment created.
mode_of_payment
string
The method of payment used to create the order.
shipment_created_ts
string
The timestamp indicating when the shipment was created.
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
is_lapa_enabled
boolean
Flag to show NDR actions based on LAPA (Logistic As Per Actual) plan subscription. If LAPA plan taken, true, else false.
logistics_meta
object
Nullable
An object storing detailed logistics-related information, including courier partner details and other relevant metadata.
affiliate_shipment_id
string
Nullable
Identifier of the shipment assigned by the application
affiliate_order_id
string
Nullable
Identifier of the order assigned by the application
lane
string
Nullable
The lane associated with the shipment.
page
object (Page)
Page
item_total
integer
| int32
The total number of items on the page.
next_id
string
The identifier for the next page.
has_previous
boolean
Indicates whether there is a previous page.
has_next
boolean
Indicates whether there is a next page.
current
integer
| int32
The current page number.
type
string
The type of the page, such as 'PageType'.
size
integer
| int32
The number of items per page.
total
integer
| int32
Total number of items.
Examples
Parameters
company_id:
1
lane:
"new"
bag_status:
"placed, bag_confirmed, bag_invoiced"
time_to_dispatch:
1
search_type:
"shipment_id"
search_value:
"16578901076461551493K"
start_date:
"2023-08-21T09:48:40Z"
end_date:
"2023-08-21T09:48:40Z"
dp_ids:
"19,26"
stores:
"19,26"
sales_channels:
"000000000000000000000001,614b42d1ea943427b5f46d1e"
page_no:
1
page_size:
10
exclude_locked_shipments:
true
payment_methods:
"COD,PREPAID"
channel_shipment_id:
"16731535496121004000"
channel_order_id:
"FY63BA4C0D0125F8A075"
custom_meta:
"{"store_id":"67319add85607a3120cd4bf0"}"
ordering_channel:
"ECOMM"
company_affiliate_tag:
"company tag"
platform_user_id:
"AKFBAD9C3DEC9EB773"
sort_type:
"sla_asc"
tags:
"gifting,international"
customer_id:
"63a2ce177e9f59d3166dd700"
order_type:
"HomeDelivery"
operational_status:
"placed,bag_confirmed"
financial_status:
"refund_initiated,refund_completed"
logistics_status:
"dummy_logistics_state"
parent_view_slug:
"unfulfilled"
child_view_slug:
"new"
lock_status:
"true"
group_entity:
"shipments"
Was this section helpful?
GET
Response
List shipments
getShipments
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
channel_shipment_id
string
The shipment ID used in the application, which can be used to reference specific shipments.
shipment_id
string
The unique identifier for a shipment.
fetch_active_shipment
boolean
flag to fetch active or deactivated shipments
Response
200
400
We are processing the report!
ShipmentInfoResponseSchema
message
string
Nullable
A descriptive message providing additional information about the API response.
success
boolean
Indicates whether the API call was successful (true) or not (false).
shipments
array of object (PlatformShipment)
A list of platform shipment objects, containing information related to a shipment.
Array of PlatformShipment
picked_date
string
| date-time
Nullable
Indicates the date and time when the shipment was physically picked up from the sender or the origin point by the delivery service. This timestamp is crucial for tracking the commencement of the shipment's journey.
tracking_list
array of object (TrackingList)
A list of tracking updates associated with the shipment.
Array of TrackingList
is_passed
boolean
Nullable
A flag indicating whether the tracking event has already occurred. If true, it means the event is in the past; otherwise, it is either current or future.
text
string
A descriptive message or status update associated with the tracking event, providing context about the shipment's progress or condition.
is_current
boolean
Nullable
A flag indicating whether this tracking event is the most recent update. If true, it reflects the latest status of the shipment.
time
string
Nullable
A timestamp representing when the tracking event occurred. This helps in understanding the timeline of the shipment's journey.
created_ts
string
Nullable
A timestamp indicating when the tracking information was created or logged in the system. This may differ from the event time.
status
string
The specific status associated with the tracking event, such as "In Transit," "Delivered," or "Out for Delivery," providing clarity on the shipment's current phase.
state
string
invoice
object (InvoiceInfo)
InvoiceInfo
store_invoice_id
string
Nullable
A unique identifier for the invoice generated by the store or platform, used for internal tracking and reference.
invoice_url
string
Nullable
A URL linking to the digital version of the invoice, allowing users to view or download the invoice document online.
updated_date
string
| date-time
Nullable
Denotes the date and time when the invoice information was modified or updated, providing a record of the most recent changes.
external_invoice_id
string
Nullable
An identifier for the invoice used by external systems or partners, facilitating cross-system tracking and reconciliation.
label_url
string
Nullable
A URL linking to the shipping label associated with the invoice, which may be used for shipment tracking and logistics.
credit_note_id
string
Nullable
The identifier for any credit note related to the invoice, used in cases of refunds or adjustments to the original billing.
links
object
An object containing additional links relevant to the invoice, which may include related documents or resources.
shipment_status
string
Nullable
Represents the current status of the shipment.
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
order_status
object (OrderStatusData)
OrderStatusData
order_details
object (OrderDetails)
OrderDetails
fynd_order_id
string
created_at
string
Date and time when the order was created.
user_id
string
Nullable
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
The pan number associated with a business entity
gstin
string
Nullable
The Goods and Services Tax Identification Number (GSTIN) associated with a business entity
mongo_cart_id
number
Nullable
delivery_charges
number
Nullable
transaction_id
string
Nullable
collect_by
string
headers
object
Nullable
Header details of the order.
coupon_value
number
Nullable
order_value
number
created_time
string
currency
string
The currency in which the prices details associated with the item is specified.
total_order_value
number
ordering_channel
string
meta
object
Nullable
Meta data of the order data contains additional, potentially dynamic information about the order data.
cod_charges
number
Nullable
cashback_value
number
Nullable
refund_by
string
affiliate_order_date
string
| date-time
Nullable
Specifies the date and time of the order when it was created within the affiliate's system. It specifies that the date and time are recorded in ISO 8601 format.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
affiliate_order_id
string
payment_mode_id
number
Nullable
promotion_effective_discount
number
Nullable
mode_of_payment
string
discount
number
Nullable
cashback_applied
number
Nullable
fynd_credits
number
Nullable
affiliate_id
string
ordering_channel_logo
string
Nullable
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
errors
array of string
A list of any errors that occurred while attempting to obtain the order's status.
shipment_details
array of object (ShipmentDetail)
A list of the individual shipments associated with the order and their current statuses.
Array of ShipmentDetail
shipment_id
string
Unique identifier for the shipment associated with the order.
status
string
A string representing the current status of the shipment
id
integer
| int32
An integer that serves as a unique identifier for the shipment detail
bag_list
array of integer
A list of bag identifiers associated with the shipment.
meta
object (Meta)
Meta
kafka_emission_status
integer
| int32
An integer representing the status of the message upon emission to Kafka. 0 indicates success, while 1 indicates failure.
state_manager_used
string
A string that specifies the state manager utilized for handling the order's state.
remarks
string
A string for any additional comments or notes related to the shipment,
text
string
A label or description of the delivery status, such as 'Expected Delivery Date'.
value
string
The detailed delivery status or time information, such as 'Arriving on 24 Nov 2022 15:54:00'.
color_code
string
Hex code for the color representing the delivery status.
expected_delivery_date
string
| date-time
The ISO 8601 formatted date and time when the delivery is expected, e.g., '2022-11-24T22:15:54+00:00'.
delivery_slot
object
Nullable
Represents a specific time window allocated for the delivery of an order or shipment.
order
object (OrderDetailsData)
OrderDetailsData
order_date
string
| date-time
Nullable
Represents the date and time when the order was placed by the customer. This timestamp is essential for tracking the initiation of the order process, scheduling deliveries, and analyzing order timelines.
created_ts
string
Nullable
A timestamp indicating when the order was created in the system.
tax_details
object
Nullable
Contains a flexible and comprehensive set of key-value pairs detailing the tax calculations and classifications applicable to the order.
cod_charges
string
Nullable
The charges associated with Cash on Delivery (COD) payments.
source
string
Nullable
The source from which the order originated.
fynd_order_id
string
An unique identifier for the order.
affiliate_id
string
Nullable
Identifier for the application, can be application_id or extension_id
affiliate_order_id
string
Nullable
Identifier of the order assigned by the application
ordering_channel_logo
object
Nullable
Represents the logo of the channel through which the order was placed, encapsulating branding elements and any relevant styling attributes. This object is designed to be flexible, allowing for the inclusion of various properties that define how the logo should be displayed across different platforms or documents related to the order.
order_value
string
Nullable
The total monetary value of the order
ordering_channel
string
Nullable
The specific channel through which the order was placed
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
payment_methods
object
payment_info
array of object
created_at
string
| date-time
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
raw_user_agent
string
comment
string
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
user
object (UserDataInfo)
UserDataInfo
id
integer
Nullable
The unique identifier associated with the user.
user_oid
string
Nullable
The object ID for the user, used for referencing the user in various operations.
mongo_user_id
string
Nullable
User Object ID assigned within the system
external_customer_id
string
Nullable
The identifier for the user in external systems.
first_name
string
Nullable
The first name of the user.
last_name
string
Nullable
The last name of the user.
mobile
string
Nullable
The mobile phone number of the user.
email
string
Nullable
The email address of the user.
meta
string
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
avis_user_id
string
Nullable
Avis user id
name
string
Nullable
A full name of the user, which may be a combination of first and last name.
gender
string
Nullable
The gender of the user.
country_phone_code
string
The country-specific phone code, useful for formatting mobile numbers correctly.
enable_dp_tracking
boolean
Nullable
A flag indicating whether the delivery partner tracking feature is enabled for this shipment.
custom_message
string
Nullable
A custom message or note associated with the shipment.
estimated_sla_time
string
Nullable
The estimated service level agreement (SLA) time for the shipment, indicating expected delivery timelines.
estimated_sla_ts
string
Nullable
A timestamp indicating when the estimated SLA time is expected to be met.
can_update_dimension
boolean
Nullable
Indicates whether the dimensions of the shipment can be updated after creation.
shipment_images
array of string
Nullable
A list of URLs for images related to the shipment.
delivery_details
object
A list of details about the delivery of an order.
billing_details
object
Information regarding the billing for the shipment, including billing address and payment method.
forward_shipment_id
string
Nullable
The ID of the parent forward journey shipment.
fulfilment_priority
integer
Nullable
The fulfilment priority, with lower numbers indicating a higher priority.
shipment_details
object (ShipmentLockDetails)
ShipmentLockDetails
lock_status
boolean
Nullable
Represents the lock status of the shipment.
lock_message
string
Nullable
A user-friendly message that explains the reason for locking the shipment.
action_to_status
object
Nullable
This field maps potential actions (e.g., downloading an invoice or label) to their corresponding shipment lock statuses, indicating which operations are allowed depending on the shipment's current lock status. When an action is set to 'lock', it means no transitions or updates to the shipment's status can be performed until the specified action is completed. For instance, if 'download_invoice' is in a 'lock' state, the shipment cannot undergo any status transitions until the invoice is either downloaded. Similarly, 'download_label' being in a 'lock' state prevents any shipment status transitions until a new label is downloaded.
custom_meta
array of object
Nullable
An array of custom metadata objects that may contain additional, dynamic information specific to the shipment.
shipment_quantity
integer
Nullable
The total quantity of items included in the shipment.
company_details
object (CompanyDetails)
CompanyDetails
company_name
string
Nullable
The name of the company.
address
object
Nullable
It contains the properties for the address of a company.
company_cin
string
Nullable
The Corporate Identification Number (CIN) of the company.
company_id
integer
Nullable
A unique identifier for the company on the platform.
company_gst
string
Nullable
The Goods and Services Tax (GST) number of the company.
company_contact
object (ContactDetails)
ContactDetails
phone
array of object (PhoneDetails)
Nullable
An array of phone numbers associated with the contact.
Array of PhoneDetails
country_code
integer
Nullable
Identifies the country of the user's phone number using the two-character standard ISO 3166-1 alpha-2 country codes. Examples include 'US' for the United States and 'IN' for India.
number
string
Nullable
The actual phone number of the user.
emails
array of string
Nullable
An array of email addresses associated with the contact.
ordering_store
object (OrderingStoreDetails)
OrderingStoreDetails
phone
string
Nullable
The contact phone number for the ordering store.
pincode
string
Nullable
The postal code associated with the ordering store's location.
meta
object
Nullable
Meta data of the ordering store contains additional, potentially dynamic information about the ordering store.
address
string
Nullable
The complete address of the ordering store.
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
Formatted address based on the title-template provided by the partner.
id
integer
Nullable
A unique identifier for the ordering store.
code
string
Nullable
A specific code associated with the ordering store.
store_name
string
Nullable
The name of the ordering store.
country
string
Nullable
The country in which the ordering store is located.
contact_person
string
Nullable
The name of the primary contact person at the ordering store.
state
string
Nullable
The state or region where the ordering store is situated.
city
string
Nullable
The city in which the ordering store is located.
store_email
string
Nullable
Email address of store
order_platform
string
Nullable
The platform used to place the order.
lock_status
boolean
Nullable
Indicates whether the shipment is currently locked or not for modifications or updates.
platform_logo
string
Nullable
The URL of the ordering platform's logo.
user_agent
string
Nullable
Information about the user agent string, typically containing details about the browser or application used to place the order.
dp_details
object (DPDetailsData)
DPDetailsData
pincode
string
Nullable
The postal code associated with the delivery partner's location
track_url
string
Nullable
A URL that provides access to real-time tracking information for the shipment.
eway_bill_id
string
Nullable
The unique identifier for the e-way bill generated for the shipment.
id
integer
Nullable
A unique identifier for the delivery partner details.
country
string
Nullable
The country in which the delivery partner operates.
awb_no
string
Nullable
The Air Waybill number, a tracking number used for air freight shipments, allowing for the identification and tracking of the package in transit.
gst_tag
string
Nullable
A tag associated with the Goods and Services Tax (GST) for the shipment.
name
string
Nullable
The name of the delivery partner or service provider responsible for transporting the shipment.
dp_charges
number
dp_return_charges
number
amount_handling_charges
number
eway_bill_number
number
Nullable
dp_otp
string
invoice_id
string
Nullable
The unique identifier for the invoice associated with the shipment.
payment_methods
object
Nullable
This field stores a collection of payment method objects used in a transaction. Each key within this object represents a unique payment method code (e.g., "COD" for Cash On Delivery), and its value is an object containing detailed information about that payment method. The structure is designed to accommodate any number of payment methods,providing flexibility and comprehensive insights into each transaction's payment aspect.
payment_info
array of object (ShipmentPaymentInfoData)
Nullable
An array of objects containing detailed information about the payments made for the shipment.
Array of ShipmentPaymentInfoData
mode
string
Stands for 'Mode of Payment'. This is a short code (like 'COD' for Cash On Delivery) that represents the payment method used.
name
string
Specifies name of the payment method.
collect_by
string
Whomsoever collected the money
refund_by
string
Whomsoever will refund the money
meta
object
Object that stores additional meta data related to the payment.
amount
number
Amount paid using this payment method.
unique_identifier
string
A unique string identifier for the transaction, this is essential for referencing individual payments.
display_name
string
The name of the payment method as it should be displayed to the user.
transaction_data
object
All necessary data for transaction received
coupon
object
Nullable
Coupon data of the shipment which denotes if coupon is applied, coupon code, coupon amount, coupon title and coupon message.
affiliate_details
object (AffiliateDetails)
AffiliateDetails
shipment_meta
object (ShipmentMeta)
ShipmentMeta
tracking_url
string
Nullable
A URL for tracking the shipment.
estimated_delivery_date
string
| date-time
Nullable
Provides a forecasted date and time by which the shipment is expected to be delivered to the recipient. This estimation is crucial for planning purposes, both for the sender in managing expectations and for the recipient in preparing for receipt.
same_store_available
boolean
Indicates whether the shipment is available for pickup from the same store.
b2b_buyer_details
object (BuyerDetails)
BuyerDetails
ajio_site_id
string
Nullable
The unique identifier for the buyer on the Ajio platform.
pincode
integer
The postal code for the buyer's shipping address, used for delivery location identification.
address
string
Provides the comprehensive address details of the buyer's shipping address.
gstin
string
The Goods and Services Tax Identification Number (GSTIN) of the buyer.
name
string
The full name of the buyer, essential for personalizing communication and delivery.
state
string
The name of the state where the buyer's shipping address is located, important for logistical purposes.
city
string
The name of the city where the buyer's shipping address is located, which helps in identifying delivery zones.
formatted
object (Formatted)
Formatted
max
string
Nullable
Represents the maximum formatted value, providing a limit for the associated data, such as dimensions or weights.
min
string
Nullable
Represents the minimum formatted value, establishing a lower limit for the associated data, ensuring it meets certain criteria or standards.
debug_info
object (DebugInfo)
DebugInfo
stormbreaker_uuid
string
Nullable
A unique identifier (UUID) associated with the Stormbreaker system, used for tracking and debugging purposes in the application.
return_awb_number
string
Nullable
The Air Waybill (AWB) number associated with a return shipment.
is_self_ship
boolean
Nullable
Indicates whether the shipment is a self-shipped order.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
einvoice_info
object (EinvoiceInfo)
EinvoiceInfo
credit_note
object
Nullable
Specifies the reverse einvoice transaction create on government portal.
invoice
object
Nullable
It specifies the forward einvoice transaction created on government portal.
return_affiliate_shipment_id
string
Nullable
The shipment ID associated with a return from an affiliate.
parent_dp_id
string
Nullable
The unique identifier for the parent delivery partner.
shipment_weight
number
Nullable
The total weight of the shipment.
dimension
object (Dimensions)
Dimensions
height
number
Nullable
The height of the product
width
number
Nullable
The width of the product
is_default
boolean
Nullable
Whether the dimension is the default one or not
unit
string
Nullable
The unit of dimension
length
number
Nullable
The length of the product
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
assign_dp_from_sb
boolean
Nullable
Indicates whether to assign the delivery partner from the store’s basket.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
store_invoice_updated_date
string
| date-time
Nullable
Denotes the date and time when the store's invoice related to this shipment was updated. This timestamp is vital for tracking changes to billing details, adjustments in charges, or updates in the invoicing status.
forward_affiliate_shipment_id
string
Nullable
The shipment ID for the forward journey of an affiliate shipment.
return_store_node
integer
Nullable
The identifier for the store node involved in the return process.
fulfilment_priority_text
string
Nullable
Textual representation of the fulfillment priority for the shipment.
shipment_tags
array of object (ShipmentTags)
Tags associated with the shipment for categorization and filtering.
Array of ShipmentTags
slug
string
Nullable
A URL-friendly string representing the tag, often used for routing or categorization.
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
display_text
string
Nullable
A human-readable text representation of the tag, used for display purposes in user interfaces.
external
object
Nullable
External metadata related to the shipment.
awb_number
string
Nullable
The Air Waybill number associated with the shipment.
lock_data
object (LockData)
LockData
locked
boolean
Nullable
Indicates whether the shipment is currently locked for processing (true) or not (false).
mto
boolean
Nullable
A flag indicating whether the shipment is part of a multi-modal transport operation.
lock_message
string
Nullable
An optional message providing additional context or information regarding the lock status.
order_type
string
Nullable
Defines the specific journey a shipment will follow based on the application's operational needs and customer preferences. This field categorizes orders into distinct types, each associated with a unique processing flow.
Enum
ewaybill_info
object
Nullable
Electronic Way Bill details i.e ewayBillNo, ewayBillDate that are utilized in the transportation of goods.
dp_id
string
Nullable
The unique identifier for the delivery partner associated with the shipment.
shipment_volumetric_weight
number
Nullable
The volumetric weight of the shipment, which may differ from its actual weight.
marketplace_store_id
string
Nullable
The unique identifier for the marketplace store associated with the shipment.
return_details
object
Nullable
An object containing the return details of the shipment.
dp_sort_key
string
Nullable
A sort key for the delivery partner, used for prioritization.
packaging_name
string
Nullable
The name of the packaging used for the shipment.
timestamp
object (ShipmentTimeStamp)
ShipmentTimeStamp
max
integer
Nullable
Represents the maximum timestamp value, indicating the latest time relevant to the shipment.
min
integer
Nullable
Represents the minimum timestamp value, indicating the earliest time relevant to the shipment.
auto_trigger_dp_assignment_acf
boolean
Nullable
Indicates whether automatic delivery partner assignment is triggered for this shipment.
dp_name
string
Nullable
The name of the delivery partner associated with the shipment.
po_number
string
Nullable
The purchase order number associated with the shipment.
weight
integer
The weight of the shipment, typically measured in grams or kilograms.
b2c_buyer_details
object
Nullable
Contains detailed information about the buyer in a business-to-consumer (B2C) transaction. This object is designed to capture a wide array of buyer-specific data such as contact information, shipping address, preferences, and any other relevant details that enhance the understanding of the buyer's profile and needs.
forward_affiliate_order_id
string
Nullable
The order ID for the forward journey of an affiliate shipment.
return_affiliate_order_id
string
Nullable
The order ID for the return journey of an affiliate shipment.
bag_weight
object
Nullable
This object is designed to accommodate a range of weight-related information. Denotes the weight of the bag, potentially including various measurements or related details.
refund_to
string
Nullable
Specifies the recipient of any refunds related to the shipment.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_shipment_id
string
The shipment ID specific to this affiliate.
company_affiliate_tag
string
Nullable
An optional tag representing the company's affiliate association.
affiliate_order_id
string
The order ID associated with the affiliate shipment.
pdf_links
object (PDFLinks)
PDFLinks
invoice_type
string
The type of invoice issued, such as 'fynd' or other classifications.
Enum
label_a6
string
Nullable
URL or path to the A6 size label document.
invoice
string
Nullable
URL or path to the main invoice document.
label_pos
string
Nullable
URL or path to the POS label document.
invoice_a6
string
Nullable
URL or path to the A6 size invoice document.
b2b
string
Nullable
URL or path to the B2B document related to the transaction.
label
string
Nullable
URL or path to the general label document.
label_a4
string
Nullable
URL or path to the A4 size label document.
label_type
string
Specifies the type of label associated with a PDF document,indicating its purpose or content. The label_type helps in organizing and identifying PDF documents quickly, ensuring that users or systems can efficiently utilize the correct documents for required actions.
Enum
invoice_export
string
Nullable
URL or path to the exported invoice document.
credit_note_url
string
Nullable
URL or path to the credit note document.
delivery_challan_a4
string
Nullable
URL or path to the A4 delivery challan document.
label_export
string
Nullable
URL or path to the exported label document.
invoice_a4
string
Nullable
URL or path to the A4 size invoice document.
invoice_pos
string
Nullable
URL or path to the POS invoice document.
po_invoice
string
Nullable
URL or path to the purchase order invoice document.
config
object (AffiliateConfig)
AffiliateConfig
app
object (AffiliateAppConfig)
AffiliateAppConfig
id
string
description
string
updated_at
string
| date-time
The date and time when the app config was updated.
name
string
token
string
meta
array of object (AffiliateAppConfigMeta)
Array of AffiliateAppConfigMeta
value
string
name
string
owner
string
secret
string
created_at
string
| date-time
Timestamp when the app config was created.
inventory
object (AffiliateInventoryConfig)
AffiliateInventoryConfig
article_assignment
object (AffiliateInventoryArticleAssignmentConfig)
AffiliateInventoryArticleAssignmentConfig
post_order_reassignment
boolean
payment
object (AffiliateInventoryPaymentConfig)
AffiliateInventoryPaymentConfig
source
string
mode_of_payment
string
inventory
object (AffiliateInventoryStoreConfig)
AffiliateInventoryStoreConfig
store
object
Fulfilling store information related to the shipment.
order
object (AffiliateInventoryOrderConfig)
AffiliateInventoryOrderConfig
force_reassignment
boolean
logistics
object (AffiliateInventoryLogisticsConfig)
AffiliateInventoryLogisticsConfig
dp_assignment
boolean
app_company_id
integer
Nullable
A unique identifier for the company associated with the affiliate app, used for tracking and managing affiliate relationships.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
affiliate_id
string
Nullable
The unique identifier for the affiliate.
affiliate_store_id
string
The unique identifier for the affiliate's store.
affiliate_bag_id
string
The unique identifier for the affiliate's bag.
id
string
Nullable
The unique identifier for the affiliate.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
priority_text
string
Nullable
Text that indicates the priority level of the shipment.
bag_status_history
array of object (BagStatusHistory)
A history of status changes for bags associated with the shipment.
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
is_dp_assign_enabled
boolean
Nullable
A flag indicating whether delivery partner assignment features are enabled for the shipment.
bags
array of object (OrderBags)
A list of bags included in the shipment
Array of OrderBags
gst_details
object (GSTDetailsData)
GSTDetailsData
cgst_tax_percentage
number
Nullable
Percentage of Central Goods and Services Tax (CGST) applied to the transaction, applicable for intra-state transactions within the same state
gstin_code
string
Nullable
A GST Number (Goods and Services Tax Identification Number, often abbreviated as GSTIN) is a unique identifier assigned to a business or individual registered under the Goods and Services Tax (GST) system in countries like India. The GST number is essential for businesses to comply with tax regulations and for the government to track tax payments and returns.
value_of_good
number
Effective selling price - Product GST Amount
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
igst_tax_percentage
number
Nullable
Percentage of Integrated Goods and Services Tax (IGST) applied to the transaction, applicable for inter-state transactions
gst_tax_percentage
number
Nullable
The percentage rate of GST applied to a product or service
hsn_code_id
string
Nullable
The unique identifier associated with HSN code
igst_gst_fee
number
Nullable
Amount of Integrated Goods and Services Tax (IGST) fee applied to the transaction, relevant for inter-state transactions
is_default_hsn_code
boolean
Nullable
Indicates if the HSN code is default
sgst_gst_fee
number
Nullable
Amount of State Goods and Services Tax (SGST) fee applied to the transaction, relevant for intra-state transactions within the same state
tax_collected_at_source
number
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Effective selling price - Brands additional discounts
cgst_gst_fee
number
Nullable
Amount of Central Goods and Services Tax (CGST) fee applied to the transaction, applicable for intra-state transactions within the same state
gst_tag
string
Nullable
Type of GST applied - IGST, CGST, SGST
sgst_tax_percentage
number
Nullable
Percentage of State Goods and Services Tax (SGST) applied to the transaction, applicable for intra-state transactions within the same state
hsn_code
string
Nullable
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
bag_status
array of object (BagStatusHistory)
Array of BagStatusHistory
forward
boolean
Nullable
Flag to check forward
store_id
integer
Nullable
Store id associated with the bag
delivery_awb_number
string
Nullable
Airway Bill (AWB) number associated with the delivery
kafka_sync
boolean
Nullable
Flag indicating whether the bag status history update has been sync with Kafka
delivery_partner_id
integer
Nullable
Unique identifier of delivery partner
app_display_name
string
Nullable
The display name of a shipment status as it appears on the sale channels website
state_id
integer
Nullable
The unique identifier associated with the state
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
Enum
bsh_id
integer
Nullable
The unique identifier associated with the state
created_at
string
| date-time
Nullable
Date and time when the bag status history record was created
created_ts
string
Nullable
Timestamp indicating the exact time when the bag status history record was created
shipment_id
string
Nullable
Unique shipment no. that is auto-generated
updated_at
string
| date-time
Nullable
Date and time of the most recent update to the bag status history record
updated_ts
string
Nullable
Timestamp indicating the last time the bag status history record was updated
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
The unique identifier associated with the bag
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Webhook shipment status, i.e., either create or update
display_name
string
Nullable
The display name of a shipment status as it appears on the platform
app_facing
boolean
action_user
object
id
number
parent_promo_bags
object
Nullable
An object containing details of parent promotional bags.
financial_breakup
object (FinancialBreakup)
FinancialBreakup
refund_credit
number
Refund credits provided to the customer
amount_paid_roundoff
integer
Nullable
Amount paid rounded off
price_effective
number
MRP - Initial Seller provided discount
promotion_effective_discount
number
Effective promotion discount including promotions given by seller and Platform
transfer_price
number
article
coupon_effective_discount
number
Coupon provided by brand or seller
gst_fee
number
The fee associated with Goods and Services Tax (GST) for a product or service
tax_collected_at_source
number
Nullable
The tax amount collected at the source of income or transaction
brand_calculated_amount
number
Price Effective - Coupon Discount (Seller) - Promotion (Seller)
delivery_charge
number
The fee associated with the delivery service for transporting the item to its destination
gst_tag
string
Type of GST applied - IGST, CGST, SGST
hsn_code
string
The Harmonized System of Nomenclature (HSN) code, used for classifying goods traded internationally
cashback
number
Cashback points
item_name
string
The name of the item being referenced
value_of_good
number
Effective selling price - Product GST Amount
cashback_applied
number
Cashback applied on the order
cod_charges
number
The fee associated with the COD order
price_marked
number
The indicated price or value assigned to an item before any discounts or adjustments
size
string
The physical dimensions or specifications of the item, indicating its size or measurements
amount_paid
number
Amount paid by the customer
coupon_value
number
Stores the coupon value as shown in the cart
discount
number
The total amount discounted from the original MRP/actual price
fynd_credits
number
Credits provided by Fynd
gst_tax_percentage
number
The percentage rate of GST applied to a product or service
amount_to_be_collected
number
Amount to be collected in case of multiple modes of payments.
identifiers
object (Identifier)
Identifier
alu
string
Nullable
The ALU (Article Level Unit) code used to identify the item at a detailed level, often specific to certain retail or distribution systems.
ean
string
Nullable
The European Article Number (EAN) is a unique identifier for products, primarily used in retail and logistics. It helps in tracking and managing inventory across various platforms.
sku_code
string
Nullable
The Stock Keeping Unit (SKU) code of the item - uniquely identifies each distinct product. SKUs are used to track inventory levels, facilitate accurate stocktaking, and streamline order fulfillment processes. This code is essential for inventory management, allowing for the differentiation between products based on attributes such as price, color, and size.
upc
string
Nullable
The Universal Product Code (UPC) is a barcode symbol used for tracking trade items in stores. It is widely used in North America and helps in identifying products quickly during point-of-sale transactions.
isbn
string
Nullable
The International Standard Book Number (ISBN) is a unique identifier for books, allowing for easier management and tracking of book inventories in retail and library systems.
total_units
integer
Total number of units of the item
added_to_fynd_cash
boolean
Flag indicating whether fynd cash has been used
refund_amount
number
tcs_percentage
number
bag_configs
object (BagConfigs)
BagConfigs
is_returnable
boolean
Indicates whether the bag is eligible for return by the customer.
allow_force_return
boolean
A flag that determines if a forced return can be initiated for the bag.
is_active
boolean
A flag indicating whether the bag is active or not.
can_be_cancelled
boolean
A flag that determines if the bag can be cancelled.
enable_tracking
boolean
A flag that determines if shipment tracking is enabled for the bag.
is_customer_return_allowed
boolean
A flag that determines if customer return is allowed for the bag.
seller_identifier
string
Nullable
Sellers identifier of the article
delivery_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
article
object (OrderBagArticle)
OrderBagArticle
identifiers
object
Nullable
Details of Identifiers associated with the article.
return_config
object (ReturnConfig)
ReturnConfig
returnable
boolean
Nullable
Flag indicating whether product is returnable or not
time
number
Nullable
Number indicating number of hours or days
unit
string
Nullable
String indicating the unit of the time, eg. days, hours
uid
string
Nullable
A unique identifier for the article within the order bag.
size
string
Nullable
The size of the article, which may be relevant for clothing.
tags
array of string
Nullable
An array of tags associated with the article.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
group_info
object
group_info_ids
array of object
brand
object (OrderBrandName)
OrderBrandName
logo
string
Nullable
A URL or path to the logo image associated with the brand.
company
integer
Nullable
A unique identifier for the company associated with the brand.
id
integer
A unique identifier for the brand within the system.
created_on
string
| date-time
Nullable
Timestamp when the brand of the order was created.
brand_name
string
Nullable
The name of the brand associated with the order.
modified_on
string
| date-time
Nullable
Timestamp when the brand of the order was modified.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
group_id
string
Nullable
affiliate_bag_details
object (AffiliateBagsDetails)
AffiliateBagsDetails
affiliate_bag_id
string
Nullable
A unique identifier for the affiliate bag.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
affiliate_meta
object (AffiliateMeta)
AffiliateMeta
order_item_id
string
Nullable
A unique identifier for the order item associated with the affiliate shipment.
channel_order_id
string
Nullable
The order ID assigned by the sales channel for tracking purposes.
employee_discount
number
Nullable
The discount percentage or amount applied to the order for employees.
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
quantity
integer
Nullable
The total quantity of items in the order.
size_level_total_qty
integer
Nullable
The total quantity of items grouped by size level for the order.
loyalty_discount
number
Nullable
The discount percentage or amount applied to the order based on customer loyalty.
replacement_details
object (ReplacementDetails)
ReplacementDetails
replacement_type
string
Nullable
Specifies the nature or category of the replacement requested or processed for an item.
original_affiliate_order_id
string
Nullable
The original order ID associated with the item that is being replaced.
channel_shipment_id
string
Nullable
The shipment ID assigned by the sales channel for tracking purposes.
marketplace_invoice_id
string
Nullable
The invoice ID related to the marketplace for the transaction.
due_date
string
| date-time
Nullable
Specifies the deadline by which a particular action related to the affiliate shipment needs to be completed.
coupon_code
string
Nullable
A unique code provided to customers for redeeming special offers or discounts on their purchases.
is_priority
boolean
Nullable
Indicates whether the shipment is a priority for fulfillment.
is_serial_number_required
boolean
Nullable
Indicates whether a serial number is required for the items in the shipment.
fulfilment_priority
integer
Nullable
A value indicating the priority level of order fulfillment.
customer_selling_price
number
Nullable
The selling price at which the product is offered to the customer.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
item
object (PlatformItem)
PlatformItem
id
integer
Nullable
Unique identifier for the platform item.
attributes
object (PlatformArticleAttributes)
PlatformArticleAttributes
currency
string
Nullable
The currency in which the price of the article is specified.
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
brand_id
integer
Nullable
Identifier for the brand associated with the item.
slug_key
string
Nullable
A user-friendly string that represents the item, often used in URLs.
l3_category
integer
Nullable
Represents the product's classification at the third level in the e-commerce platform's category hierarchy, using an integer identifier.
l3_category_name
string
Nullable
Name of the third-level category under which the product is listed.
last_updated_at
string
| date-time
Nullable
Timestamp when any aspect of the associated record was modified, formatted as date-time.
name
string
Nullable
The name of the product item.
l2_category
array of string
Nullable
Represents the second level of categorization for items, helping customers narrow down their search.
brand
string
Nullable
Name of the brand associated with the item.
image
array of string
Nullable
Array of image URLs representing the item.
code
string
Nullable
Unique code for the item, often used for inventory management.
l1_category
array of string
Nullable
Represents the highest or top-tier level of categorization for the product.
size
string
Nullable
Size specification of the product, if applicable.
can_cancel
boolean
Nullable
Indicates whether the item can be canceled after order placement.
can_return
boolean
Nullable
Indicates whether the item is eligible for return.
branch_url
string
Nullable
URL linking to a specific branch or store where the item is available.
meta
object
Nullable
Meta data containing additional, dynamic information about the item.
color
string
Nullable
Color specification of the product, if applicable.
department_id
integer
Nullable
Identifier for the department associated with the product.
images
array of string
Nullable
Array of image URLs representing different views or angles of the item.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
tags
array of string
l2_category_id
number
payment_methods
array of object (BagPaymentMethods)
An array detailing the various payment methods utilized for the transaction. Each item within this array represents a distinct method of payment. It encapsulates the details of various payment methods available for completing a transaction. It includes comprehensive information such as the payment mode, amount, transaction status, and identifiers for each payment method.
Array of BagPaymentMethods
mode
string
Nullable
The payment mode used for the transaction.
amount
number
Nullable
The total amount associated with the payment method
refund_by
string
collect_by
string
display_name
string
payment_info
array of object (BagPaymentMethods)
Array of BagPaymentMethods
mode
string
Nullable
The payment mode used for the transaction.
amount
number
Nullable
The total amount associated with the payment method
refund_by
string
collect_by
string
display_name
string
quantity
number
Nullable
The number of items contained in the bag.
identifier
string
Nullable
A unique identifier for the bag.
can_return
boolean
Nullable
Indicates whether the items in the bag are eligible for return by the customer.
can_cancel
boolean
Nullable
Indicates whether the bag is eligible for cancellation by the customer.
display_name
string
Nullable
A user-friendly name for the bag.
line_number
integer
Nullable
A unique identifier for each line item in a bag.
meta
object
Meta data of the bags contains additional, potentially dynamic information about the bags.
applied_promos
array of object (AppliedPromos)
Array of AppliedPromos
promotion_type
string
Nullable
Specifies the type of discount or deal applied to the current promotion, defining how the promotion modifies the price or adds value to the purchase. Each type represents a different promotional strategy - percentage- Discount by a percentage of the original price. - amount- Discount by a specific amount off the original price. - fixed_price- Sets the price to a specific fixed amount. - bogo- Buy One Get One or at a discount. - contract_price- Special pricing based on a contract or agreement. - shipping_price- Discount or deal related to the shipping cost. - ladder_price- Price changes based on quantity purchased. - bundle_price_percentage- Discount on a bundle purchase by a percentage. - bundle_price_amount- Discount on a bundle purchase by a specific amount. - bundle_amount_percentage- A percentage of the purchase amount is applied as a discount when buying in a bundle. - custom- A custom promotion not covered by other types. - free_gift_items- Free gift items are included with the purchase. - free_non_sellable_items- Free items that are not for sale are included with the purchase.
Enum
promotion_name
string
Nullable
The name of the promotional campaign or offer.
discount_rules
array of object (DiscountRules)
A list of rules that define the conditions under which discounts are applied.
Array of DiscountRules
value
integer
Nullable
type
string
Nullable
amount
number
Nullable
The total monetary value of the discount or promotion.
article_quantity
integer
Nullable
The quantity of articles required to qualify for the promotion.
buy_rules
array of object (BuyRules)
A list of rules that outline the conditions for purchasing items under the promotion.
Array of BuyRules
item_criteria
object (ItemCriterias)
ItemCriterias
item_brand
array of integer
Nullable
cart_conditions
object
Nullable
Specifies the rules that must be met at the cart level for any purchasing rules or promotional discounts to be applied. Specifically, it includes criteria such as the total quantity of items in the cart. For instance, a rule might require that the cart contains at least one item for the promotion to apply. This setup allows for the dynamic application of discounts or special buying rules based on cart conditions.
promo_id
string
Nullable
A unique identifier for the promotion.
mrp_promotion
boolean
Nullable
A flag that designates whether or not the promotion is an MRP (manufacturer's reduced price) promotion.
applied_free_articles
array of object (AppliedFreeArticles)
A list of articles that are eligible for free under the promotion.
Array of AppliedFreeArticles
article_id
string
A unique identifier for the article to which the free gift is applied.
free_gift_item_details
object (FreeGiftItems)
Details of the free gift item associated with the article, including relevant attributes like name, description, and any other specifications.
FreeGiftItems
item_slug
string
A unique identifier for the item, typically used in URLs for SEO purposes.
item_name
string
The name of the item.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
The minimum price value. Represents the lowest price in the price range.
max
number
| float
The maximum price value. Represents the highest price in the price range.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
The minimum price value. Represents the lowest price in the price range.
max
number
| float
The maximum price value. Represents the highest price in the price range.
currency
string
The currency in which the prices details associated with the item is specified.
item_brand_name
string
The brand name of the item.
item_id
integer
| int32
A unique numerical identifier for the item.
item_images_url
array of string
A list of URLs pointing to images of the item.
parent_item_identifier
string
An identifier for the parent item with which the free gift is associated, typically used to link the free gift to the original purchased item.
quantity
number
The quantity of the free gift items applied to the article.
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
current_status
object (CurrentStatus)
CurrentStatus
store_id
integer
Nullable
A unique identifier for the store associated with the shipment.
delivery_awb_number
string
Nullable
The Air Waybill (AWB) number for the delivery.
kafka_sync
boolean
Nullable
A flag indicating whether the current status is synchronized with Kafka or not.
delivery_partner_id
integer
Nullable
A unique identifier for the delivery partner responsible for handling the shipment.
state_type
string
Nullable
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey, including route optimization and carrier selection.
Enum
state_id
integer
Nullable
A unique identifier for the specific state of the shipment.
id
integer
A unique identifier for the current status entry
created_at
string
| date-time
Nullable
Denotes the date and time when the bag status was created.
created_ts
string
| date-time
Nullable
A timestamp indicating when the status was created
shipment_id
string
Nullable
A unique identifier for the shipment.
updated_at
string
| date-time
Nullable
The date and time when the current status was last updated.
bag_state_mapper
object (BagStateMapper)
BagStateMapper
is_active
boolean
Nullable
Indicates whether the state is currently active in the shipment process.
app_display_name
string
Nullable
Display name used in the application to represent this state.
state_type
string
Serves as a key identifier to differentiate among the diverse types
of states a shipment can undergo throughout its journey.
- 'operational': Pertains to states that involve the physical handling and movement of the shipment, such as packing, in transit, and delivery.
- 'financial': Relates to states associated with the payment, invoicing, and any monetary transactions or obligations tied to the shipment.
- 'logistics': Encompasses states that deal with the broader logistical planning and coordination necessary for the shipment's journey,
including route optimization and carrier selection.
Enum
id
integer
The unique identifier associated with the state
journey_type
string
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
app_state_name
string
Nullable
The name of the state as used within the application, providing a clear reference.
name
string
Official name of the state in the context of the shipment process.
app_facing
boolean
Nullable
Indicates if this state is visible to the customer in the application.
notify_customer
boolean
Nullable
Indicates whether the customer should be notified upon reaching this state.
display_name
string
User-friendly name for the state, suitable for display purposes.
bag_id
integer
Nullable
A unique identifier for the bag associated with the shipment.
status
string
Nullable
A descriptive label representing the current status of the shipment.
bag_id
integer
entity_type
string
Nullable
Type of entity that the tag is associated to (bag, shipments).
Enum
is_parent
boolean
Nullable
A flag indicating whether the current bag is a parent entity or not.
variants
object
Nullable
This represents different variants of items such as color, shade, material, storage variants, size and more.
mark_as_returnable
boolean
returnable_date
string
| date-time
Nullable
dp_assignment
boolean
Nullable
Indicates whether a delivery partner has been assigned to the shipment.
total_items
integer
Nullable
The total number of items contained within the shipment,
fulfilling_store
object (FulfillingStore)
FulfillingStore
phone
string
The contact phone number for the fulfilling store.
pincode
string
The postal code for the fulfilling store's location.
meta
object
Meta data of the fulfilling store contains additional, potentially dynamic information about the fulfilling store.
address
string
The complete address of the fulfilling store.
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
Display friendly version of the Fulfilment Store Address.
id
integer
The unique id or identifier of a fulfilment store.
code
string
The unique code of the fulfilment store.
store_name
string
The unique name of a fulfillment store.
country
string
The name of the country associated with a specific fulfilment store.
fulfillment_channel
string
The channel through which fulfillment is managed.
contact_person
string
The name of the contact person associated with a fulfilling store.
state
string
The state or region where the fulfilling store is located.
city
string
The city in which the fulfilling store is situated.
store_email
string
Nullable
Email of the recipient associated with the store
additionalProperties
Allows you to attach properties in addition to the ones mentioned above. Any additional properties are allowed.
meta
object
Meta data of the shipment contains additional, potentially dynamic information about the shipment.
pdf_links
object
PDF Links associated with the shipment.
payment_mode
string
Nullable
The mode of payment used for the shipment.
packaging_type
string
Nullable
Defines the type of packaging used for the product, encompassing materials, design, and form factors.
journey_type
string
Nullable
It is a type being used to represent the journey of shipment through the performed status transition. Forward Journey: The forward journey encompasses all the stages of shipping, including order placement, packing, dispatch, in-transit updates, and delivery. Return Journey: Contrary to the forward journey, the return journey involves the process of sending items back from the customer to the original sender or a designated return facility.
Enum
prices
object (Prices)
Prices
refund_credit
number
Nullable
Refund credits applicable to the customer in case of returns or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid, rounded off to the nearest integer.
price_effective
number
Nullable
Effective price after applying discounts to the MRP (Maximum Retail Price).
promotion_effective_discount
number
Nullable
Discount amount provided through promotions applicable to the purchase.
pm_price_split
number
Nullable
Updated selling price of the product in the event of repricing.
refund_amount
number
Nullable
Total amount to be refunded in case of cancellation or return.
transfer_price
number
Nullable
Fixed selling price applicable for payouts by the brand to the platform.
coupon_effective_discount
number
Nullable
Discount amount applicable when using a coupon.
tax_collected_at_source
number
Nullable
Tax amount collected at the source during the transaction.
brand_calculated_amount
number
Nullable
Calculated price after deducting coupon and promotion discounts from the effective price.
delivery_charge
number
Nullable
Fee charged for delivery, as stipulated by the delivery partner.
cashback
number
Nullable
Cashback points or amount provided to the customer post-purchase.
value_of_good
number
Nullable
Effective selling price minus the GST amount applicable to the product.
cashback_applied
number
Nullable
Actual cashback value that has been applied to the purchase.
cod_charges
number
Nullable
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
Nullable
The marked price of the item before any discounts or adjustments.
amount_paid
number
Nullable
Total amount actually paid by the customer for the purchase.
coupon_value
number
Nullable
The effective value of the coupon applied to the transaction.
discount
number
Nullable
Total discount amount deducted from the original price of the product.
fynd_credits
number
Nullable
Credits awarded by Fynd, which can be used for future purchases.
gift_price
number
Nullable
The amount associated with any gift card used in the transaction.
amount_to_be_collected
number
Nullable
Total amount to be collected in scenarios involving multiple payment methods.
added_to_fynd_cash
boolean
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
charges
array of object (PriceAdjustmentCharge)
An array of charges applied to the shipment.
Array of PriceAdjustmentCharge
code
string
Nullable
Code defined for charge
name
string
Display name for charge (charge is unique by the name)
type
string
Nullable
Type defined for charge
amount
object (ChargeAmount)
ChargeAmount
base_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
ordering_currency
object (ChargeAmountCurrency)
ChargeAmountCurrency
value
number
Charge currency value or amount
currency
string
Charge currency code
distribution_logic
object (ChargeDistributionLogic)
ChargeDistributionLogic
distribution
object (ChargeDistributionSchema)
ChargeDistributionSchema
type
string
This field defines the distribution type, e.g values('multi', 'single')
multi: distribute the changes across all entity
single: distribute the changes across to any one single entity
Enum
logic
string
This field defines the distribution logic e.g values('apportion', 'equally') apportion: distribute charge amount based of weighted average amount of all the entity (like article with
[10, 20] will get charge of 9 as [3, 6])
equally: distribute charge amount 'equally' to all the entity
distribution_level
string
This field defines the distribution level, e.g distribution level is (order, shipment, article)
ordering_currency_prices
object (OrderingCurrencyPrices)
OrderingCurrencyPrices
refund_credit
number
Nullable
Amount of refund credits applicable to the customer's account for returned items or cancellations.
amount_paid_roundoff
number
Nullable
Total amount paid by the customer, rounded off to the nearest integer for ease of processing.
price_effective
number
Nullable
Final effective price of the product after applying discounts to the marked retail price (MRP).
promotion_effective_discount
number
Nullable
Total discount amount applied through promotional offers specific to the customer's purchase.
pm_price_split
number
Nullable
Updated selling price of the product after any repricing adjustments made before the sale.
refund_amount
number
Nullable
Amount that will be refunded to the customer in case of order cancellation or product return.
transfer_price
number
Nullable
Fixed price set for payouts by the brand, representing the cost to the retailer or affiliate.
coupon_effective_discount
number
Nullable
Discount value realized through the use of a coupon code applied at the time of purchase.
tax_collected_at_source
number
Nullable
Total tax amount that is collected at the point of sale, often applicable for tax regulations.
brand_calculated_amount
number
Nullable
Amount calculated by the brand after applying any relevant coupons and promotions to the base price.
delivery_charge
number
Nullable
Cost charged for the delivery service, as determined by the delivery partner handling the shipment.
cashback
number
Nullable
Points or monetary value returned to the customer as a reward for their purchase, which can be used for future transactions.
value_of_good
number
Nullable
Net selling price of the product after excluding the GST (Goods and Services Tax) amount from the total.
cashback_applied
number
Nullable
Total cashback value that has been applied to the customer's account or to the current transaction.
cod_charges
number
Nullable
Additional fee charged for orders placed via cash on delivery (COD) payment method.
price_marked
number
Nullable
The original price indicated for the product before any discounts or promotions are applied.
amount_paid
number
Nullable
The total amount the customer has paid for their order, including all applicable charges and discounts.
coupon_value
number
Nullable
The specific value of the coupon used in the transaction, reflecting its impact on the total price.
discount
number
Nullable
Total amount discounted from the original price of the product, reflecting savings for the customer.
fynd_credits
number
Nullable
Credits provided by Fynd, which can be used for discounts on future purchases.
gift_price
number
Nullable
Monetary value assigned to a gift card purchased by the customer, usable for future transactions.
amount_to_be_collected
number
Nullable
Amount to be collected from the customer when multiple payment methods are utilized for a single order.
added_to_fynd_cash
number
gst_tax_percentage
number
tcs_percentage
number
cn_refund_amount
number
applied_emi_discount
number
applied_instant_discount
number
vertical
string
Nullable
The business vertical or category to which the shipment belongs.
shipment_id
string
A unique identifier for the shipment.
payments
object (ShipmentPayments)
ShipmentPayments
mode
string
Nullable
The payment mode used for the shipment.
logo
string
Nullable
A URL or path to the logo associated with the payment method.
source
string
Nullable
The source or origin of the payment
operational_status
string
Nullable
The operational status of the shipment.
status
object (ShipmentStatusData)
ShipmentStatusData
meta
object
Nullable
It contains the additional properties related to shipment status transition like Kafka_emission_status, user_name, etc. Additionally it is dynamic.
bag_list
array of string
Nullable
The list of bags that are in this shipment status transition.
id
integer
Nullable
Unique identifier for a shipment status.
created_at
string
| date-time
Nullable
Denotes the date and time when the transition was created.
created_ts
string
Nullable
A timestamp indicating when the status entry was created.
shipment_id
string
Nullable
The unique identifier for the shipment.
status
string
Nullable
The current status of the shipment.
display_name
string
Nullable
A user-friendly name or description of the current shipment status.
current_shipment_status
string
Nullable
Reflects the most recent status of the shipment.
status_created_at
string
| date-time
Nullable
Denotes the date and time when the transition of the status of the shipment was created.
name
string
total_bags
integer
Nullable
The total number of bags in the shipment.
shipment_created_at
string
| date-time
Nullable
Denotes the date and time when the shipment was created.
shipment_created_ts
string
Nullable
A timestamp representing when the shipment was created.
currency
object (Currency)
Currency
currency_code
string
This specifies the currency code for all amounts. The currency_code field will hold a string value representing the code for the currency in which all monetary amounts are denominated. This code typically follows the ISO 4217 standard, which uses three-letter alphabetic codes to define different currencies around the world. For example, 'USD' for United States Dollar, 'INR' for Indian Rupees.
currency_symbol
string
For particular code will show currency symbol
currency_info
object (CurrencyInfo)
CurrencyInfo
currency
object (CurrencyInfoCurrency)
CurrencyInfoCurrency
currency_code
string
currency_name
string
currency_sub_unit
string
currency_symbol
string
order_currency
string
conversion_rate
object (ConversionRate)
ConversionRate
base
string
The base currency code, example 'INR' for Indian Rupee, against which all conversion rates are calculated. Follows the ISO 4217 standard.This includes the currency's name, its conversion rate relative to the base currency ('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency conversion but also enriches the data with useful currency descriptors, enhancing financial operations and analyses.
rates
object
An object , where each key is a currency code and its value is an object containing detailed information
about that currency. This includes the currency's name, its conversion rate relative to the base currency
('value'), the currency symbol, and any sub-unit of the currency. This setup not only facilitates currency
conversion but also enriches the data with useful currency descriptors.
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
Currency code like INR, UAE
currency_name
string
Currency name
currency_symbol
string
For particular code will show currency symbol
currency_sub_unit
string
Currency sub unit
is_lapa_enabled
boolean
Flag to show NDR actions based on LAPA (Logistic As Per Actual) plan subscription. If LAPA plan taken, true, else false.
previous_shipment_id
string
Nullable
The ID of the previous shipment in the sequence.
shipment_update_time
number
Nullable
A numerical representation of the last update time for the shipment
rto_address
object (Address)
Nullable
Address
phone
string
Nullable
The phone number at the address, used for contact purposes.
address2
string
Nullable
An optional additional field for the street address of the address.
address
string
Nullable
An optional additional field for the street address of the address.
longitude
integer
Nullable
The longitude coordinate of the address.
pincode
string
Nullable
The postal code of the address.
area
string
Nullable
Area details of the address.
address_type
string
Nullable
The type of the address.
Enum
country
string
Nullable
The name of the country of the address.
address_category
string
Nullable
Category or classification of the address. The address_category field
that includes "store", "delivery", and "billing" serves to classify
addresses based on various business processes.
addresses based on various business processes
- 'store': Identifies addresses associated with physical retail locations or warehouses which is essential for inventory management, order fulfillment, and facilitating in-store pickups or returns.
- 'delivery': Identifies addresses where orders are shipped to customers which ensures successful delivery, enhancing customer satisfaction, and optimizing logistics operations.
- 'billing': Identifies addresses used for billing and financial transactions which are essential for payment processing, invoice generation, and maintaining financial accuracy
Enum
email
string
Nullable
The email of the person associated with the order.
created_at
string
| date-time
Nullable
Created at date for address
address1
string
Nullable
The primary address dynamically forms based on a template. If the template
includes a single key, Address1 contains that data. For templates with multiple keys like
{address} {address2} {area} {state} {country}, Address1 compiles all into a single formatted string.
display_address
string
Nullable
A formatted version of the address for display purposes.
landmark
string
Nullable
A notable landmark near the address, aiding in location identification.
updated_at
string
| date-time
Nullable
Updated at date for address
version
string
Nullable
The version number of the address record
latitude
integer
Nullable
The latitude coordinate of the address.
contact_person
string
Nullable
The full name of the person associated with the address.
state
string
Nullable
The name of the region (for example, province, state, or prefecture) of the address.
city
string
Nullable
The city, town of the address.
area_code_slug
string
Nullable
A slug representation of the area code.
country_code
string
Nullable
A code representing the country for the address.
country_iso_code
string
Nullable
The ISO code representing the country for the address.
country_phone_code
string
Nullable
The country-specific phone code for formatting phone numbers.
delivery_address_id
string
A unique identifier for the delivery address.
geo_location
object
An object containing additional geographical information related to the address.
name
string
A unique identifier for the name associated with the address.
sector
string
The sector or zone of the address, if applicable.
state_code
string
A code representing the state or region for the address.
uid
string
A unique identifier for the user associated with the address.
user_id
string
The unique identifier of the user in the system.
code
string
store_address_json
object
id
number
location_type
string
Enum
company_id
number
store_email
string
credit_note_id
string
Nullable
The identifier for any credit note issued for the shipment
is_self_ship
boolean
Nullable
A flag indicating whether the shipment is being self-shipped by the seller or vendor.
mode_of_payment
string
Nullable
The specific mode of payment used for the transaction
affiliate_shipment_id
string
Nullable
Identifier of the shipment assigned by the application
tracking_url
string
Nullable
URL for monitoring the status and location of the shipment.
forward_end_shipment_id
string
Nullable
The forward_end_shipment_id represents the shipment ID of the original forward journey shipment. When a shipment is transitioned to a return journey, the original shipment ID from the forward journey is recorded in the forward_end_shipment_id field of the return journey shipment. Even if the return shipment is later split into multiple shipments, each of these shipments will retain the same forward_end_shipment_id value that was assigned during the initial return journey initiation. This ensures that all return shipments can be traced back to the original forward journey shipment.
logistics_meta
object
An object storing detailed logistics-related information, including courier partner details and other relevant metadata.
refund_information
array of object
manifest_id
string
Nullable
company_id
number
pickup_slot
object
can_process
boolean
mark_as_returnable
boolean
order_source_domain
string
actionable
boolean
transition_config
object
next_possible_states
object
is_processing
boolean
total_bag_qty
number
order_created_time
string
order_created_ts
string
company
object
fyndstore_emp
object
is_not_fynd_source
boolean
is_fynd_coupon
boolean
user_id
string
email_id
string
escalation
object
Nullable
beneficiary_details
boolean
can_break
boolean
Nullable
is_packaging_order
boolean
delivery_status
array of object
current_shipment_status
object
order_type
string
Enum
can_cancel
boolean
enable_tracking
boolean
can_return
boolean
is_invoiced
boolean
child_nodes
array of object
user_info
object
status_progress
number
items
array of object
refund_details
array of object
financial_status
string
Nullable
track_info
array of object
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Get shipment details
getShipmentById
Generates the report which can be filled and uploaded to perform the bulk operation based on the filters provided
Parameters
company_id
integer
Required
Id of company
sales_channels
string
Comma separated values of sales channel ids
dp_ids
string
Comma separated values of delivery partner ids
start_date
string
| date-time
UTC start date in ISO format
end_date
string
| date-time
UTC end date in ISO format
stores
string
Comma separated values of store ids
tags
string
Comma separated values of tags
bag_status
string
Comma separated values of bag statuses
payment_methods
string
Comma separated values of payment methods
file_type
string
File type to be downloaded
time_to_dispatch
integer
Sla breached or not breached
page_no
integer
page_size
integer
Response
200
400
We are processing the file!
TemplateDownloadResponseSchema
file_name
string
file_path
string
content_type
string
method
string
namespace
string
operation
string
size
integer
upload
object (Upload)
Upload
expiry
integer
url
string
cdn
object (CDN)
CDN
url
string
absolute_url
string
relative_url
string
tags
array of string
Examples
Parameters
company_id:
2
sales_channels:
"000000000000000000000001,614b42d1ea943427b5f46d1e"
dp_ids:
"12"
start_date:
"2023-08-21T09:48:40Z"
end_date:
"2023-08-21T09:48:40Z"
stores:
"12"
bag_status:
"bag_confirmed"
payment_methods:
"COD,PREPAID"
file_type:
"xlsx"
time_to_dispatch:
1
page_no:
1
page_size:
10
Was this section helpful?
GET
Response
Get bulk shipment Excel file.
getBulkShipmentExcelFile
Parameters
company_id
integer
Required
Id of company
Response
200
Slug names
BulkActionTemplateResponseSchema
template_x_slug
array of object (BulkActionTemplate)
Allowed bulk action template slugs
Array of BulkActionTemplate
value
string
text
string
Examples
Parameters
company_id:
2
Was this section helpful?
GET
Response
Get bulk action template.
getBulkActionTemplate
Download bulk seller templates which can be used to perform operations in bulk
Parameters
company_id
integer
Required
Id of company
template_slug
string
Slug name of template to be downloaded
Response
200
400
We are processing the file!
TemplateDownloadResponseSchema
file_name
string
file_path
string
content_type
string
method
string
namespace
string
operation
string
size
integer
upload
object (Upload)
Upload
expiry
integer
url
string
cdn
object (CDN)
CDN
url
string
absolute_url
string
relative_url
string
tags
array of string
Examples
Parameters
company_id:
2
template_slug:
"PARTIAL_CANCELLATION"
Was this section helpful?
GET
Response
Download bulk action template.
downloadBulkActionTemplate
Create a point-of-sale (POS) receipt for a specific order by order Id.
Parameters
company_id
integer
Required
order_id
string
Required
shipment_id
string
document_type
string
A document type denotes the format for which the file type is streamed.
Default Value : a4
Enum
Response
200
404
We are processing the request!
GeneratePosOrderReceiptResponseSchema
customer_cn_receipt
string
success
boolean
order_id
string
invoice_receipt
string
payment_receipt
string
merchant_cn_receipt
string
payment_receipt_template
string
customer_cn_receipt_template
string
invoice_receipt_template
string
Examples
Parameters
company_id:
528
order_id:
"FY63A99F2F0DB9999FC3"
shipment_id:
"16720607200841418717"
document_type:
"a4"
Was this section helpful?
GET
Response
Generate POS receipt by order ID.
generatePOSReceiptByOrderId
Gets All the allowed Templates to perform Bulk Operations.
Parameters
company_id
integer
Required
Response
200
Successfully Found the templates.
AllowedTemplatesResponseSchema
template_x_slug
array of object (Templates)
Array of Templates
text
string
value
string
Examples
Parameters
company_id:
2
Was this section helpful?
GET
Response
Gets All the allowed Templates to perform Bulk Operations.
getAllowedTemplatesForBulk
Parameters
company_id
integer
Required
template_name
string
Required
Response
200
400
Sucessfully Created the Template Url.
TemplateDownloadResponseSchema
file_name
string
file_path
string
content_type
string
method
string
namespace
string
operation
string
size
integer
upload
object (Upload)
Upload
expiry
integer
url
string
cdn
object (CDN)
CDN
url
string
absolute_url
string
relative_url
string
tags
array of string
Examples
Parameters
company_id:
2
template_name:
"PARTIAL_CANCELLATION"
Was this section helpful?
GET
Response