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
List bag cancellation reasons
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.
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.
code
string
Nullable
A unique identifier associated with store.
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
The specific channel through which your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
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.
code
string
Nullable
A unique identifier associated with store.
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
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
Nullable
A unique identifier associated with store.
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
Nullable
A unique identifier associated with store.
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
Nullable
A unique identifier associated with store.
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.
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.
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.
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.
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.
Examples
Parameters
company_id:
1
bag_id:
"value"
channel_bag_id:
"value"
channel_id:
"value"
Was this section helpful?
GET
Response
Get bag
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
Default Value : 1
page_size
integer
Page size of data received per page
Default Value : 20
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.
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.
code
string
Nullable
A unique identifier associated with store.
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
The specific channel through which your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
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.
code
string
Nullable
A unique identifier associated with store.
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
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
Nullable
A unique identifier associated with store.
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
Nullable
A unique identifier associated with store.
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
Nullable
A unique identifier associated with store.
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.
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.
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.
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.
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.
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:
1
bag_ids:
"value"
shipment_ids:
"value"
order_ids:
"value"
channel_bag_ids:
"value"
channel_shipment_ids:
"value"
channel_order_ids:
"value"
channel_id:
"value"
page_no:
1
page_size:
1
Was this section helpful?
GET
Response
List bags
getBags
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.
Operations
POST
# Create order
GET
# Get channel configuration
POST
# Create channel configuration
POST
# Attach order to a user
GET
# Get order
GET
# List orders
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Headers
x-ordering-source
string
To uniquely identify the source through which order has been placed.
Enum
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)
An array of Charge objects related to the line item.
Array of Charge
name
string
Required
The name of the charge that indicates its purpose.
amount
object (AmountSchema)
Required
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
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
Required
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
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.
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
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
Nullable
A unique identifier associated with store.
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
Nullable
A unique identifier associated with store.
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
Nullable
A unique identifier associated with store.
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.
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.
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 (ShippingInfo)
Required
ShippingInfo
alternate_mobile_number
string
A string for an alternate mobile number to reach the customer, providing an additional contact method.
state
string
A string representing the name of the state for shipping purposes.
customer_code
string
A string representing the customer's unique identifier in the seller's system.
shipping_type
string
Specifies the method or service used for the shipping of the shipment.
Enum
middle_name
string
A string containing the customer's middle name.
primary_mobile_number
string
A string for the customer's primary mobile number.
last_name
string
A string containing the customer's last name.
geo_location
object (GeoLocationSchema)
GeoLocationSchema
latitude
number
A number representing the geographical latitude of the location.
longitude
number
A number representing the geographical longitude of the location
gender
string
A string representing the customer's gender.
house_no
string
A string representing the house or apartment number of the customer.
first_name
string
A string representing the customer's first name.
title
string
A string representing the customer's title or prefix.
landmark
string
A string representing a landmark or reference point near the customer's location.
country
string
A string representing the customer's country.
address_type
string
A string representing the address type in the seller's system.
Enum
state_code
string
A string representing the state code of the customer's location.
city
string
A string representing the city of the customer's location.
external_customer_code
string
A string representing an external customer code in the seller's system.
floor_no
string
A string representing the floor number of the customer's location.
alternate_email
string
A string representing an alternate email address for the customer.
slot
array of object
A list of objects representing available time slot for delivery or pickup.
address
string
A comma-separated string representing the address.
area
string
A string representing the area of the customer's location.
address1
string
A string representing the first line of the address.
pincode
string
A string representing the pincode of the customer's location.
primary_email
string
A string representing the primary email address for the customer.
address2
string
A string representing the second line of the address.
country_code
string
Uniquely identifies the country associated with the shipping address. 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.
country_iso_code
string
Specifies the country's unique identifier ollowing the ISO 3166-1 alpha-2 standard. This two-letter code is crucial for distinguishing countries in international transactions, data processing, and shipping logistics.
billing_info
object (ShippingInfo)
Required
ShippingInfo
alternate_mobile_number
string
A string for an alternate mobile number to reach the customer, providing an additional contact method.
state
string
A string representing the name of the state for shipping purposes.
customer_code
string
A string representing the customer's unique identifier in the seller's system.
shipping_type
string
Specifies the method or service used for the shipping of the shipment.
Enum
middle_name
string
A string containing the customer's middle name.
primary_mobile_number
string
A string for the customer's primary mobile number.
last_name
string
A string containing the customer's last name.
geo_location
object (GeoLocationSchema)
GeoLocationSchema
latitude
number
A number representing the geographical latitude of the location.
longitude
number
A number representing the geographical longitude of the location
gender
string
A string representing the customer's gender.
house_no
string
A string representing the house or apartment number of the customer.
first_name
string
A string representing the customer's first name.
title
string
A string representing the customer's title or prefix.
landmark
string
A string representing a landmark or reference point near the customer's location.
country
string
A string representing the customer's country.
address_type
string
A string representing the address type in the seller's system.
Enum
state_code
string
A string representing the state code of the customer's location.
city
string
A string representing the city of the customer's location.
external_customer_code
string
A string representing an external customer code in the seller's system.
floor_no
string
A string representing the floor number of the customer's location.
alternate_email
string
A string representing an alternate email address for the customer.
slot
array of object
A list of objects representing available time slot for delivery or pickup.
address
string
A comma-separated string representing the address.
area
string
A string representing the area of the customer's location.
address1
string
A string representing the first line of the address.
pincode
string
A string representing the pincode of the customer's location.
primary_email
string
A string representing the primary email address for the customer.
address2
string
A string representing the second line of the address.
country_code
string
Uniquely identifies the country associated with the shipping address. 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.
country_iso_code
string
Specifies the country's unique identifier ollowing the ISO 3166-1 alpha-2 standard. This two-letter code is crucial for distinguishing countries in international transactions, data processing, and shipping logistics.
currency_info
object
This object can accommodate a range of currency-related information, provides a flexible structure for storing comprehensive details about the currency or currencies involved in a transaction.
external_order_id
string
A unique identifier for the order assigned by an external system.
charges
array of object (Charge)
An array of charge objects that detail the various fees associated with the order.
Array of Charge
name
string
Required
The name of the charge that indicates its purpose.
amount
object (AmountSchema)
Required
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
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
Required
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
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]
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
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.
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.
Response
200
Successfully created an order!
CreateOrderResponseSchema
fynd_order_id
string
A string that represents the unique identifier assigned to the order.
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Create order
createOrder
Parameters
company_id
integer
Required
Response
200
Successfully created the config data
CreateChannelConfigData
config_data
object (CreateChannelConfig)
CreateChannelConfig
dp_configuration
object (DPConfiguration)
DPConfiguration
shipping_by
string
shipping_by denotes dp assignment strategy- if shipping_by is fynd dp assignment would be handled by OMS
Enum
shipment_assignment
string
location_reassignment
boolean
logo_url
object
payment_info
object (CreateChannelPaymentInfo)
CreateChannelPaymentInfo
source
string
payment_methods
array of object (PaymentMethods)
Array of PaymentMethods
collect_by
string
refund_by
string
mode
string
mode_of_payment
string
lock_states
array of string
Examples
Parameters
company_id:
1
Was this section helpful?
GET
Response
Get channel configuration
getChannelConfig
Set up configuration for a channel specific to orders which has implications over how the order fulfilment happens in a channel
Parameters
company_id
integer
Required
Request body
config_data
object (CreateChannelConfig)
CreateChannelConfig
dp_configuration
object (DPConfiguration)
DPConfiguration
shipping_by
string
shipping_by denotes dp assignment strategy- if shipping_by is fynd dp assignment would be handled by OMS
Enum
shipment_assignment
string
location_reassignment
boolean
logo_url
object
payment_info
object (CreateChannelPaymentInfo)
CreateChannelPaymentInfo
source
string
payment_methods
array of object (PaymentMethods)
Array of PaymentMethods
collect_by
string
refund_by
string
mode
string
mode_of_payment
string
lock_states
array of string
Response
200
Successfully updateShipmentStatus!
CreateChannelConfigResponseSchema
is_inserted
boolean
is_upserted
boolean
acknowledged
boolean
Examples
Parameters
company_id:
1
body:
body
Was this section helpful?
POST
Response
Create channel configuration
createChannelConfig
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
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.
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Attach order to a user
attachOrderUser
Parameters
company_id
integer
Required
Id of company
order_id
string
Required
Default Value : FY6299E19701B4EAEFC2
my_orders
boolean
allow_inactive
boolean
Flag to allow inactive shipments
Default Value : false
Response
200
We are processing the report!
OrderDetailsResponseSchema
order
object (OrderData)
OrderData
ordering_channel
string
The specific channel through which your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
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
tax_details
object (TaxDetails)
TaxDetails
pan_no
string
Nullable
gstin
string
Nullable
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
fynd_order_id
string
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)
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.
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 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.
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.
success
boolean
shipments
array of object (PlatformShipment)
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.
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
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.
order_status
object (OrderStatusData)
OrderStatusData
order_details
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
The specific channel through which your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
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)
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
Affiliate id associated with order.
affiliate_order_id
string
Nullable
Affiliate order id associated with order.
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 your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
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
The identifier for the user.
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
object
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
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.
name
string
Nullable
The name of the ordering store.
store_email
string
Nullable
The email address of the ordering store.
order_platform
string
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.
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
Nullable
An array of objects containing detailed information about the payments made for the shipment.
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 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.
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
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.
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
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.
bag_status
array of object (BagStatusHistory)
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.
parent_promo_bags
object
Nullable
An object containing details of parent promotional bags.
financial_breakup
object (FinancialBreakup)
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.
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
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
Nullable
A unique identifier associated with store.
article
object (OrderBagArticle)
OrderBagArticle
identifiers
object
Nullable
Details of Identifiers associated with the article.
return_config
object (ReturnConfig)
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).
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.
_custom_json
object
Nullable
A custom JSON object containing additional details or configurations specific to the article.
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.
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.
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.
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.
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
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
quantity
integer
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.
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.
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
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.
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
The email address of the fulfilling store.
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.
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.
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.
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
The symbol representing the currency.
currency_info
object (CurrencyInfo)
CurrencyInfo
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
This specifies the currency code for all amounts.
currency_name
string
The full name of the currency.
currency_symbol
string
The symbol representing the currency.
currency_sub_unit
string
The sub-unit of the currency
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.
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
Nullable
A unique identifier associated with store.
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
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.
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.
Examples
Parameters
company_id:
1
order_id:
"value"
my_orders:
false
allow_inactive:
false
Was this section helpful?
GET
Response
Get order
getOrderById
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
Default Value : 37
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 status of the entity. Filters orders based on the status.
time_to_dispatch
integer
time_to_dispatch refers to estimated SLA time.
Enum
payment_methods
string
Comma separated values of payment methods that were used to place order.
tags
string
tags refers 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
Date time in UTC timezone as per ISO format.
to_date
string
| date
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
Default Value : true
custom_meta
string
Default Value : 6388422a5ebd6a6cf4a8ede6
my_orders
boolean
show_cross_company_data
boolean
Flag to view cross & non-cross company order
Default Value : false
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
allow_inactive
boolean
Flag indicating whether inactive shipments are allowed
Default Value : false
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
fulfillment_type
string
Define the Fulfillment Type for Listing Orders, This is use when we want to get list of shipments or orders by cross store or cross company or fulfilling Store (by default), this is also depends on the login user accessType and store access
Enum
Response
200
We are processing the report!
OrderListingResponseSchema
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)
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
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.
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
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.
order_status
object (OrderStatusData)
OrderStatusData
order_details
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
The specific channel through which your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
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)
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
Affiliate id associated with order.
affiliate_order_id
string
Nullable
Affiliate order id associated with order.
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 your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
meta
object
Meta data of the order contains additional, potentially dynamic information about the order.
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
The identifier for the user.
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
object
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
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.
name
string
Nullable
The name of the ordering store.
store_email
string
Nullable
The email address of the ordering store.
order_platform
string
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.
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
Nullable
An array of objects containing detailed information about the payments made for the shipment.
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 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.
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
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.
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
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.
bag_status
array of object (BagStatusHistory)
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.
parent_promo_bags
object
Nullable
An object containing details of parent promotional bags.
financial_breakup
object (FinancialBreakup)
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.
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
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
Nullable
A unique identifier associated with store.
article
object (OrderBagArticle)
OrderBagArticle
identifiers
object
Nullable
Details of Identifiers associated with the article.
return_config
object (ReturnConfig)
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).
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.
_custom_json
object
Nullable
A custom JSON object containing additional details or configurations specific to the article.
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.
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.
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.
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.
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
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
quantity
integer
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.
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.
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
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.
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
The email address of the fulfilling store.
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.
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.
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.
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
The symbol representing the currency.
currency_info
object (CurrencyInfo)
CurrencyInfo
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
This specifies the currency code for all amounts.
currency_name
string
The full name of the currency.
currency_symbol
string
The symbol representing the currency.
currency_sub_unit
string
The sub-unit of the currency
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.
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
Nullable
A unique identifier associated with store.
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
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.
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.
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
The identifier for the user.
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
object
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
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
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
The symbol representing the currency.
currency_info
object (CurrencyInfo)
CurrencyInfo
ordering_currency
object (OrderingCurrency)
OrderingCurrency
currency_code
string
This specifies the currency code for all amounts.
currency_name
string
The full name of the currency.
currency_symbol
string
The symbol representing the currency.
currency_sub_unit
string
The sub-unit of the currency
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.
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.
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.
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.
page_size
integer
| int32
The number of items per page.
Examples
Parameters
company_id:
1
lane:
"value"
search_type:
"value"
bag_status:
"value"
time_to_dispatch:
1
payment_methods:
"value"
tags:
"value"
search_value:
"value"
from_date:
"value"
to_date:
"value"
start_date:
"value"
end_date:
"value"
dp_ids:
"value"
stores:
"value"
sales_channels:
"value"
page_no:
1
page_size:
1
is_priority_sort:
false
custom_meta:
"value"
my_orders:
false
show_cross_company_data:
false
customer_id:
"value"
order_type:
"value"
allow_inactive:
false
group_entity:
"value"
enforce_date_filter:
false
fulfillment_type:
"value"
Was this section helpful?
GET
Response
List orders
getOrders
The State Manager is responsible for handling state logic for entities such as Shipment and Bag. It determines the behavior of the Shipment, including whether shipment breaking should be allowed, and what tasks should be run during particular state transitions, such as generating an invoice ID. Additionally, it controls which states are permissible after certain states. The State Manager is enabled at the application level and if not set it has default behavior, which determines the default flow of a shipment if no custom behavior is set.
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
The specific channel through which your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
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
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
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
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.
success
boolean
Indicates whether the config update operation was successful.
Examples
Parameters
Parameters are not required.
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.
ordering_source
string
To uniquely identify the source through which order has been placed.
Enum
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 specific channel through which your order was placed. This field will be phased out after version 2.4.0. Please use ordering_source instead to ensure accurate order tracking and processing.
ordering_source
string
Nullable
To uniquely identify the source through which order has been placed.
Enum
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
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
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
Parameters are not required.
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 Payment module is responsible for handling payment methods operations. These will include updating payment mode of entities.
Operations
PUT
# Update payment details for an order, its shipments and its bags.
Updates the payment mode for an order, its shipments and its bags. This endpoint allows for modifying payment methods, and associated details but not amount.
Parameters
company_id
string
Required
Request body
shipment_id
string
Required
Unique identifier used to filter the shipment.
products
array of object (ProductSchema)
List of products attached with the shipment against which the payment methods needs to be overridden.
Array of ProductSchema
line_number
integer
Required
The line number of a product used to uniquely identify and filter the specific product within the shipment.
payment_methods
array of object (PaymentMethodSchema)
Required
List of payment methods that needs to be updated against filtered product.
Array of PaymentMethodSchema
name
string
Required
The name of the payment method (e.g., "Credit Card", "PayPal").
mode
string
Required
The mode of payment (e.g., "PREPAID", "COD").
amount
number
| float
Required
The amount to be paid using this payment method.
meta
object (PaymentMetaDataSchema)
PaymentMetaDataSchema
payment_gateway
string
The name or identifier of the payment gateway used.
payment_identifier
string
A unique identifier for this payment transaction.
logo_url
object (PaymentMetaLogoURLSchema)
PaymentMetaLogoURLSchema
large
string
Required
URL for the large version of the payment method's logo.
small
string
Required
URL for the small version of the payment method's logo.
identifier
string
Required
Unique identifier for this payment method.
display_name
string
Required
The name to be displayed for this payment method.
aggregator
string
Required
The payment aggregator or service provider used for this payment method.
action
object (ActionDetailSchema)
Required
ActionDetailSchema
name
object
Required
The type of action to be performed (currently only "override" is supported).
Enum
current_mode
string
Required
The current payment mode before the action is applied.
current_identifier
string
Required
The current identifier of the payment method before the action is applied.
refund_to
string
Specifies where the refund should be directed to, if applicable.
refund_by
string
Required
Payment refund by for the customer and seller (e.g fynd, seller).
collect_by
string
Required
Payment collected by for the customer and seller (e.g fynd, seller).
payment_methods
array of object (PaymentMethodSchema)
List of payment methods that needs to be updated on shipment level.
Array of PaymentMethodSchema
name
string
Required
The name of the payment method (e.g., "Credit Card", "PayPal").
mode
string
Required
The mode of payment (e.g., "PREPAID", "COD").
amount
number
| float
Required
The amount to be paid using this payment method.
meta
object (PaymentMetaDataSchema)
PaymentMetaDataSchema
payment_gateway
string
The name or identifier of the payment gateway used.
payment_identifier
string
A unique identifier for this payment transaction.
logo_url
object (PaymentMetaLogoURLSchema)
PaymentMetaLogoURLSchema
large
string
Required
URL for the large version of the payment method's logo.
small
string
Required
URL for the small version of the payment method's logo.
identifier
string
Required
Unique identifier for this payment method.
display_name
string
Required
The name to be displayed for this payment method.
aggregator
string
Required
The payment aggregator or service provider used for this payment method.
action
object (ActionDetailSchema)
Required
ActionDetailSchema
name
object
Required
The type of action to be performed (currently only "override" is supported).
Enum
current_mode
string
Required
The current payment mode before the action is applied.
current_identifier
string
Required
The current identifier of the payment method before the action is applied.
refund_to
string
Specifies where the refund should be directed to, if applicable.
refund_by
string
Required
Payment refund by for the customer and seller (e.g fynd, seller).
collect_by
string
Required
Payment collected by for the customer and seller (e.g fynd, seller).
Response
200
422
The request was successful, and the payment mode has been updated for the specified order and shipments.
Properties
success
boolean
message
string
Examples
Parameters
company_id:
"value"
body:
body
Was this section helpful?
PUT
Response
Update payment details for an order, its shipments and its bags.
updatePaymentInfo
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
POST
# Update a shipment lock
PUT
# Update shipment address
PUT
# Update a shipment's status
GET
# Get a shipment's history
POST
# Create shipment history
POST
# Update packaging dimensions
POST
# Send user mobile OTP
POST
# Verify mobile OTP
POST
# Retry E-invoice
GET
# Track shipment
POST
# Update shipment tracking
POST
# Generate and attach invoice Id
GET
# List shipments
GET
# Get shipment details
Reassign the shipment to a another location and update its status to 'Store Reassigned.'
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
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
Parameters are not required.
Was this section helpful?
POST
Response
Reassign location
reassignLocation
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
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
Successfully updated 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
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
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Update a shipment lock
updateShipmentLock
Update the address details of an existing shipment based on the provided address_category. This operation allows the modification of critical shipment details, potentially affecting delivery/billing accuracy and customer communication.
Parameters
company_id
integer
Required
ID of the company fulfilling the shipment
shipment_id
string
Required
Unique shipment no. that is auto-generated
Request body
updated_address
object (UpdatedAddressSchema)
UpdatedAddressSchema
address
string
The complete address.
area
string
The locality or area associated with the address.
landmark
string
A prominent nearby landmark for locating the address.
pincode
string
The postal code (for example, zip, postcode, or Eircode) of the address.
city
string
The city, town, or village of the address.
state
string
The state or province of the address.
name
string
The name of the person associated with the address.
phone
string
Phone number associated with the address user.
email
string
Email address associated with the address user.
country
string
The country of the address.
country_iso_code
string
The ISO code representing the country of the address.
latitude
number
| double
The latitude of the address.
longitude
number
| double
The longitude of the address.
address_type
string
The type of address (e.g., office, home).
Enum
address_category
string
The category of the address (e.g., delivery, billing).
Enum
Response
200
Updated Address will be processed!
BaseResponseSchema
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
Parameters are not required.
Was this section helpful?
PUT
Response
Update shipment address
updateAddress
Used for updating a shipment and its status. Can also be used for updating bags present in that shipment.
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
integer
| int32
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
integer
| int32
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
integer
| int32
The quantity of the product or item, specified as an integer. 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.
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)
Comments or notes associated with the transition of shipment status.
Array of TransitionComments
title
string
Required
Title for the transition message.
message
string
Required
Message for the transition.
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
Parameters are not required.
Was this section helpful?
PUT
Response
Update a shipment's status
updateShipmentStatus
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
shipment_id
string
Identifier for the shipment
bag_id
integer
Identifier for a bag or product.
Response
200
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
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
URL for any related tickets.
l3_detail
string
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
Unique identifier for the ticket associated with the activity.
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
l2_detail
string
L2 details regarding the bag or activity.
assigned_agent
string
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.
display_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
Any additional messages related to the activity.
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
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
Parameters are not required.
Was this section helpful?
GET
Response
Get a shipment's 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
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
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
URL for any related tickets.
l3_detail
string
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
Unique identifier for the ticket associated with the activity.
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
l2_detail
string
L2 details regarding the bag or activity.
assigned_agent
string
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.
display_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
Any additional messages related to the activity.
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
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
Parameters are not required.
Was this section helpful?
POST
Response
Create shipment history
postShipmentHistory
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
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
Packaging Dimensions updated successfully
UpdatePackagingDimensionsResponseSchema
message
string
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Update packaging dimensions
updatePackagingDimensions
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
Parameters are not required.
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
integer
| int32
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
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.
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
Parameters are not required.
Was this section helpful?
POST
Response
Verify mobile OTP
verifyMobileOTP
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
body:
body
Was this section helpful?
POST
Response
Retry E-invoice
eInvoiceRetry
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
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
| date-time
The timestamp when the status was last updated by the courier partner.
estimated_delivery_date
string
| date-time
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
| date-time
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
type
string
Nullable
Type of the page
Enum
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Track shipment
trackShipment
Modify courier partner tracking details for a given shipment Id or AWB number
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
| date-time
Required
The timestamp when the status was last updated by the courier partner.
estimated_delivery_date
string
| date-time
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
| date-time
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
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
| date-time
The timestamp when the status was last updated by the courier partner.
estimated_delivery_date
string
| date-time
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
| date-time
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
Parameters are not required.
Was this section helpful?
POST
Response
Update shipment tracking
updateShipmentTracking
Parameters
company_id
integer
Required
Unique identifier of a company on the platform.
invoice_type
string
Required
mention the type of invoice id to generate
Enum
Request body
shipment_ids
array of string
Required
List of shipment IDs for which invoice need to be generated.
Response
200
NOTE success response can contains success and failed result as well
GenerateInvoiceIDResponseSchema
items
array of object (GenerateInvoiceIDResponseData)
Array of GenerateInvoiceIDResponseData
shipment_id
string
The unique identifier for the shipment associated with the invoice.
success
boolean
Indicates whether the API call was successful (true) or not (false).
invoice_id
string
Nullable
The generated invoice ID, or null if the generation failed.
error_message
boolean
Nullable
Provides a descriptive error message.
Examples
Parameters
company_id:
1
invoice_type:
"value"
body:
body
Was this section helpful?
POST
Response
Generate and attach invoice Id
generateInvoiceID
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_assigned
string
Used to filter shipments based on status present in shipment_status_history. For more information on these statuses, refer to the Fynd Partners documentation.
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.
from_date
string
| date
Start Date in DD-MM-YYYY format
to_date
string
| date
End Date in DD-MM-YYYY format
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.
status_assigned_start_date
string
| date-time
Specifies the starting UTC date and time (in ISO format, YYYY-MM-DDTHH:MM:SSZ) to define the lower boundary for filtering shipments based on the `created_at` timestamp of statuses in the shipment's status history. It allows filtering statuses that were created within a specific time range.
status_assigned_end_date
string
| date-time
Specifies the ending UTC date and time (in ISO format, YYYY-MM-DDTHH:MM:SSZ) to define the upper boundary for filtering shipments based on the `created_at` timestamp of statuses in the shipment's status history.
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
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
fulfillment_type
string
Define the Fulfillment Type for Listing Orders, This is use when we want to get list of shipments or orders by cross store or cross company or fulfilling Store (by default), this is also depends on the login user accessType and store access
Enum
Response
200
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)
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
The timestamp indicating when the order was created.
shipment_status
object (ShipmentStatus)
ShipmentStatus
current_shipment_status
string
Nullable
The current status of the shipment.
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.
updated_ts
string
Nullable
A general timestamp indicating when the status was updated, useful for processing and tracking.
status
string
This key denotes the status of the shipment, providing a clear indication of its current processing stage.
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
The identifier for the user.
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
object
Nullable
Additional metadata related to the user.
is_anonymous_user
boolean
Nullable
Indicates whether the user is an anonymous user (true) or registered (false).
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
Nullable
A unique identifier associated with store.
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
Nullable
A unique identifier associated with store.
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.
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
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.
financial_breakup
array of object (FinancialBreakup)
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.
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
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_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.
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.
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.
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.
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.
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.
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