Order
Manages orders, including processing, tracking, and updating order status.
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
# List bag cancellation reasons
GET
# Get bag
GET
# List bags
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
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.
PlatformShipmentReasonsResponseSchema
reasons
array of object (Reason)
An array of reasons associated with the platform.
Array of Reason
id
integer
A unique identifier for the reason.
display_name
string
The display name for the reason, used for user-facing purposes.
reasons
array of object (Reason)
A list of sub-reasons under the main reason. These provide additional layers of granularity to the main reason.
Array of Reason
qc_type
array of string
List of QC (Quality Control) types -- having return reason types indicating the stage at which QC is performed. - "Doorstep QC" refers involves inspecting products for damages at the customer's location before delivery. - "Pre QC" requires customers to upload product photos for a preliminary quality check by the operations team before a return or exchange pickup is arranged, ensuring criteria are met and optimizing logistics.
Enum
question_set
array of object (QuestionSet)
An array of question sets linked to the reason, defining the questions to be answered.
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
Meta object of the reason. This contains any additional metadata that might be relevant to the reason.
is_active
boolean
Indicates whether the reason is currently active. Active reasons are those that are currently in use within the system.
success
boolean
Indicates whether the API call was successful (true) or not (false).
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
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.
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 measurement of the object, typically representing the vertical dimension.
width
number
Nullable
The width measurement of the object, indicating the horizontal dimension.
is_default
boolean
Nullable
A flag indicating whether these dimensions are the default measurements for the object.
unit
string
Nullable
The unit of measurement used for the dimensions (e.g., centimeters, inches).
length
number
Nullable
The length measurement of the object, representing the longest dimension.
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.
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.
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.
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 measurement of the object, typically representing the vertical dimension.
width
number
Nullable
The width measurement of the object, indicating the horizontal dimension.
is_default
boolean
Nullable
A flag indicating whether these dimensions are the default measurements for the object.
unit
string
Nullable
The unit of measurement used for the dimensions (e.g., centimeters, inches).
length
number
Nullable
The length measurement of the object, representing the longest dimension.
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
Indicates whether the article is eligible for return, allowing customers to send it back under specified conditions.
time
number
Nullable
The time frame within which the return must be initiated, typically measured in days.
unit
string
Nullable
The unit of time for the return period (e.g., days, weeks).
code
string
Nullable
Internal code or identifier for the article, used for reference.
weight
object (Weight)
Weight
is_default
boolean
Nullable
Indicates whether this weight value is the default weight used for the article.
shipping
integer
Nullable
The weight of the article specifically for shipping purposes, usually measured in grams or kilograms.
unit
string
Nullable
The unit of measurement for the weight (e.g., grams, kilograms, pounds).
_id
string
The unique identifier for the article within the database.
identifiers
object
Details of identifiers associated with the article, including SKU codes and other relevant identifiers.
raw_meta
string
Nullable
Raw metadata associated with the article, providing additional context or information.
size
string
Size of the article, which may vary for clothing, accessories, etc.
is_set
boolean
Nullable
Indicates whether the article is part of a set or collection.
tags
array of string
Nullable
Tags associated with the article for categorization and search optimization.
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
Indicates whether the bag is being forwarded to the next stage in the shipment process.
store_id
integer
Nullable
Unique identifier for the store associated with the bag's current status.
delivery_awb_number
string
Nullable
The Air Waybill (AWB) number used for tracking the delivery of the bag.
kafka_sync
boolean
Nullable
Indicates if the status update has been synchronized with Kafka for real-time processing.
delivery_partner_id
integer
Nullable
Identifier for the delivery partner responsible for the shipment.
app_display_name
string
Nullable
The display name of the application that is handling the bag status update.
state_id
integer
Nullable
Unique identifier for the current state of the bag in the shipment process.
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
Unique identifier for the bag status history entry.
created_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was created.
created_ts
string
Nullable
Timestamp of creation in a different format, if applicable.
shipment_id
string
Nullable
Identifier for the shipment associated with this bag status entry.
updated_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was last updated.
updated_ts
string
Nullable
Timestamp of last update in a different format, if applicable.
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
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
Unique identifier for the bag whose status is being tracked.
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Current status of the bag in the shipment process.
display_name
string
Nullable
User-friendly name that describes the current state of the bag.
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
Indicates whether the bag is being forwarded to the next stage in the shipment process.
store_id
integer
Nullable
Unique identifier for the store associated with the bag's current status.
delivery_awb_number
string
Nullable
The Air Waybill (AWB) number used for tracking the delivery of the bag.
kafka_sync
boolean
Nullable
Indicates if the status update has been synchronized with Kafka for real-time processing.
delivery_partner_id
integer
Nullable
Identifier for the delivery partner responsible for the shipment.
app_display_name
string
Nullable
The display name of the application that is handling the bag status update.
state_id
integer
Nullable
Unique identifier for the current state of the bag in the shipment process.
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
Unique identifier for the bag status history entry.
created_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was created.
created_ts
string
Nullable
Timestamp of creation in a different format, if applicable.
shipment_id
string
Nullable
Identifier for the shipment associated with this bag status entry.
updated_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was last updated.
updated_ts
string
Nullable
Timestamp of last update in a different format, if applicable.
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
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
Unique identifier for the bag whose status is being tracked.
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Current status of the bag in the shipment process.
display_name
string
Nullable
User-friendly name that describes the current state of the bag.
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
Indicates whether the bag is being forwarded to the next stage in the shipment process.
store_id
integer
Nullable
Unique identifier for the store associated with the bag's current status.
delivery_awb_number
string
Nullable
The Air Waybill (AWB) number used for tracking the delivery of the bag.
kafka_sync
boolean
Nullable
Indicates if the status update has been synchronized with Kafka for real-time processing.
delivery_partner_id
integer
Nullable
Identifier for the delivery partner responsible for the shipment.
app_display_name
string
Nullable
The display name of the application that is handling the bag status update.
state_id
integer
Nullable
Unique identifier for the current state of the bag in the shipment process.
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
Unique identifier for the bag status history entry.
created_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was created.
created_ts
string
Nullable
Timestamp of creation in a different format, if applicable.
shipment_id
string
Nullable
Identifier for the shipment associated with this bag status entry.
updated_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was last updated.
updated_ts
string
Nullable
Timestamp of last update in a different format, if applicable.
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
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
Unique identifier for the bag whose status is being tracked.
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Current status of the bag in the shipment process.
display_name
string
Nullable
User-friendly name that describes the current state of the bag.
current_status
object (BagStatusHistory)
BagStatusHistory
forward
boolean
Nullable
Indicates whether the bag is being forwarded to the next stage in the shipment process.
store_id
integer
Nullable
Unique identifier for the store associated with the bag's current status.
delivery_awb_number
string
Nullable
The Air Waybill (AWB) number used for tracking the delivery of the bag.
kafka_sync
boolean
Nullable
Indicates if the status update has been synchronized with Kafka for real-time processing.
delivery_partner_id
integer
Nullable
Identifier for the delivery partner responsible for the shipment.
app_display_name
string
Nullable
The display name of the application that is handling the bag status update.
state_id
integer
Nullable
Unique identifier for the current state of the bag in the shipment process.
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
Unique identifier for the bag status history entry.
created_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was created.
created_ts
string
Nullable
Timestamp of creation in a different format, if applicable.
shipment_id
string
Nullable
Identifier for the shipment associated with this bag status entry.
updated_at
string
| date-time
Nullable
Timestamp when the bag status history transaction was last updated.
updated_ts
string
Nullable
Timestamp of last update in a different format, if applicable.
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
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
Unique identifier for the bag whose status is being tracked.
reasons
array of object
Nullable
List of reasons associated with the current status of the bag.
status
string
Current status of the bag in the shipment process.
display_name
string
Nullable
User-friendly name that describes the current state of the bag.
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.
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
The amount of refund credits applicable for the transaction.
amount_paid_roundoff
integer
Nullable
Total amount paid, rounded off to the nearest integer for billing purposes.
price_effective
number
The effective price after applying discounts and before any taxes.
promotion_effective_discount
number
The amount of discount applied from promotional offers.
transfer_price
number
The fixed selling price applicable for payouts by the brand.
coupon_effective_discount
number
The discount applied through a coupon code, if applicable.
gst_fee
number
Total Goods and Services Tax (GST) fee charged on the goods or services.
tax_collected_at_source
number
Nullable
Tax amount collected at the source of income or transaction.
brand_calculated_amount
number
Amount calculated by the brand, possibly reflecting various costs or fees.
delivery_charge
number
Fee applicable for the delivery of the goods.
gst_tag
string
A tag used to denote GST-related attributes or classifications.
hsn_code
string
The HSN Code (Harmonized System of Nomenclature Code) is an internationally standardized system for classifying goods, used in trade and commerce for uniform identification across different countries.
cashback
number
The cashback amount provided to the customer, if applicable.
item_name
string
The name or description of the item related to the financial breakup.
value_of_good
number
The assessed value of the goods before applying any taxes or fees.
cashback_applied
number
The effective cashback value that has been applied to the transaction.
cod_charges
number
Charges applicable for Cash on Delivery (COD) orders.
price_marked
number
The indicated price or value assigned to an item before any discounts or adjustments.
size
string
The size of the item, if applicable.
amount_paid
number
Total amount paid by the customer for the transaction.
coupon_value
number
The effective value of the coupon used in the transaction.
discount
number
Total amount discounted from the original price of the goods.
fynd_credits
number
Credits provided by Fynd to the customer, possibly as part of a rewards program.
gst_tax_percentage
number
The percentage of GST applicable on the goods or services.
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
The total number of units involved in the transaction.
added_to_fynd_cash
boolean
Indicates whether the amount has been added to Fynd cash for future use.
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
The percentage of Central Goods and Services Tax (CGST) applicable on the goods or services.
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
The assessed value of the goods before applying any taxes or fees.
gst_fee
number
The total GST fee charged on the goods or services.
igst_tax_percentage
number
Nullable
The percentage of Integrated Goods and Services Tax (IGST) applicable for inter-state transactions.
gst_tax_percentage
number
Nullable
The overall GST tax percentage applicable to the goods or services.
hsn_code_id
string
Nullable
Unique identifier for the Harmonized System of Nomenclature (HSN) code used to classify goods.
igst_gst_fee
number
Nullable
The GST fee applicable for IGST, usually for inter-state transactions.
is_default_hsn_code
boolean
Nullable
Indicates whether this HSN code is the default classification for the goods.
sgst_gst_fee
number
Nullable
The GST fee applicable for State Goods and Services Tax (SGST).
tax_collected_at_source
number
Tax amount collected at the source of income or transaction, often for compliance and revenue tracking.
brand_calculated_amount
number
Amount calculated by the brand, potentially reflecting costs, fees, or pricing structures.
cgst_gst_fee
number
Nullable
The GST fee applicable for CGST.
gst_tag
string
Nullable
A tag or label used to denote GST-related attributes or classifications.
sgst_tax_percentage
number
Nullable
The percentage of State Goods and Services Tax (SGST) applicable on the goods or services.
hsn_code
string
Nullable
The HSN Code (Harmonized System of Nomenclature Code) is an internationally standardized system for classifying goods. It is used in trade and commerce to identify products and services uniformly across different countries and industries. The system was developed by the World Customs Organization (WCO) and is widely used in customs processes and tax systems.
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
A dictionary of product attributes
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-time
Date and time when the order was created.
user_id
string
Nullable
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
gstin
string
Nullable
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.
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.
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.
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)
An array of Charge objects related to the line item.
Array of Charge
name
string
The name of the charge that indicates its purpose.
amount
object (AmountSchema)
AmountSchema
currency
string
The value indicating the currency used for the transactions.
value
number
The final amount of the charge.
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
An object representing the total tax amount calculated for the transaction.
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.
external_shipment_id
string
External shipment identifier or marketplace's unique shipment identifier.
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