Order

Manages orders, including processing, tracking, and updating order status.

Default

Default

Operations
GET
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/ordering-sources/{slug}
# Get ordering source config for a given company and application.
PUT
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/ordering-sources/{slug}
# Update ordering source config for a given company and application.
GET
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/ordering-sources
# List ordering sources for a given company and application.
GET

Get ordering source config for a given company and application.

Retrieves the ordering source config for a given company and application.
Parameters
company_idpath
string
Required
application_idpath
string
Required
slugpath
string
Required
GET
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/ordering-sources/{slug}
Loading...
Response
200
The request was successful, and the response contains the ordering source config.
Hide
Ordering source config for a given company and application.
slug
string
Slug of the ordering source.
configs
array of object (OrderingSourceFeature)
Show
logo
string
Logo of the ordering source.
Examples
Parameters
company_id:
"1"
application_id:
"6573205f9217394923560aae"
slug:
"gofynd"
Response
Loading...
PUT

Update ordering source config for a given company and application.

Updates the ordering source config for a given company and application.
Parameters
company_idpath
string
Required
application_idpath
string
Required
slugpath
string
Required
Request body
slug
string
Slug of the ordering source.
configs
array of object (OrderingSourceFeature)
Show
logo
string
Logo of the ordering source.
PUT
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/ordering-sources/{slug}
Loading...
Response
200
The request was successful, and the response contains the ordering source config.
Hide
Ordering source config for a given company and application.
slug
string
Slug of the ordering source.
configs
array of object (OrderingSourceFeature)
Show
logo
string
Logo of the ordering source.
Examples
Parameters
company_id:
"1"
application_id:
"6573205f9217394923560aae"
slug:
"gofynd"
body:
body
Response
Loading...
GET

List ordering sources for a given company and application.

Retrieves the list of ordering sources for a given company and application.
Parameters
company_idpath
string
Required
application_idpath
string
Required
typequery
string
Enum
page_noquery
integer
page_sizequery
integer
GET
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/ordering-sources
Loading...
Response
200
The request was successful, and the response contains the ordering source config.
Hide
items
array of object (OrderingSourceSummary)
Show
page
object (Page)
Show
Examples
Parameters
company_id:
"1"
application_id:
"6573205f9217394923560aae"
type:
"SALES_CHANNEL"
page_no:
1
page_size:
100
Response
Loading...

RMA

Return Merchandise Authorization (RMA) enables you to create and manage rules that define the specific reasons and sub-reasons to present to customers during a return process. These rules also allow you to specify an optional quality control (QC) mechanism to ensure that the returned merchandise meets the required standards before processing the return.

Operations
POST
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/rule_list
# List of RMA rules based on the given input conditions.
POST

List of RMA rules based on the given input conditions.

Retrieves a comprehensive list of RMA (Return Merchandise Authorization) rules associated with a specific company and application. These rules dictate the processes for handling returns, including actions, reasons, quality control (QC) types, and associated questions. The endpoint allows for filtering and pagination based on input conditions, providing a tailored set of rules that match the criteria specified.
Parameters
company_idpath
string
Required
application_idpath
string
Required
Request body
page_no
integer
The page number to be retrieved. This determines the starting point for the list of rules to be returned.
channel
array of string
An array of channel (application ID) identifiers. These channels represent the specific application contexts for which the rules are being requested.
department
array of string
An array of department identifiers. The rules returned will be applicable to these specified departments.
id
array of string
An array of rule identifiers. This allows for retrieving specific rules based on their unique IDs.
is_active
boolean
Indicates whether the rules to be retrieved are active. This flag helps filter the rules based on their current status.
POST
/service/platform/order-manage/v1.0/company/{company_id}/application/{application_id}/rule_list
Loading...
Response
200
400
The request was successful, and the response contains a list of RMA rules that match the specified criteria, along with pagination details.
Hide
Contains the rules related to RMA (Return Merchandise Authorization). These rules define the conditions, actions, and quality checks that need to be enforced during the RMA process. Each rule specifies a combination of reasons, quality control types, associated questions, and other necessary attributes that govern the return and exchange of merchandise. The response also includes pagination information to manage large sets of rules, along with a success indicator and error details if applicable.
page
object (RMAPageInfo)
Provides information about the pagination of the rule list. This includes details like the current page, the total number of items, and whether there are previous or next pages available.
Show
items
array of object (RuleItem)
A list of rule items included in the response. Each item represents a specific RMA rule, detailing its unique identifier, entity type, associated actions, conditions, and other relevant attributes. This list is essential for understanding the individual rules that are applied within the system for return merchandise authorization.
Show
success
boolean
Indicates whether the request was successful. A value of `true` means the rules were retrieved successfully, while `false` indicates an error occurred during the request.
error
object (RuleError)
Contains error details if the request was not successful. This includes the type of error, the value that caused the issue, and a message explaining the error. These details help in diagnosing and resolving issues that may arise when retrieving the rules.
Show
Response
Loading...

Shipment

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
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/orders/shipments/{shipment_id}/line_number/{line_number}/reasons
# Retrieve Reasons for Cancellation and Return journey
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/shipments/
# List sales channel shipments
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/orders/shipments/{shipment_id}/track
# Track shipment
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/orders/shipments/reasons/{action}
# List shipment cancellation reasons
GET

Retrieve Reasons for Cancellation and Return journey

Allows users to retrieve a comprehensive list of reasons for cancellation or returning a shipment. It provides both cancellation and return reasons, with an emphasis on Quality Control (QC) evaluations.
Parameters
company_idpath
integer
Required
Unique identifier of a company on the platform.
application_idpath
string
Required
A unique identifier for the application on the platform
shipment_idpath
string
Required
The unique identifier for the shipment
line_numberpath
integer
Required
A unique identifier of the bag's line number.
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/orders/shipments/{shipment_id}/line_number/{line_number}/reasons
Loading...
Response
200
A successful response
Hide
reasons
array of object (BagReasons)
List of bag reasons for a shipment with a corresponding shipment status.
Show
success
boolean
Indicates whether the API call was successful (true) or not (false).
rule_id
integer
Nullable
The unique identifier for the rule that is associated with the given reasons. This ID serves as a reference to the specific rule within the RMA system that governs or influences the reasons listed.
Examples
Parameters
company_id:
1
application_id:
"5d63686df2a4f7806b76bb32"
shipment_id:
"17290285081731219531"
line_number:
1
Response
Loading...
GET

List sales channel shipments

Get shipments of a particular sales channel based on the filters provided
Parameters
company_idpath
integer
Required
Unique identifier of a company on the platform.
application_idpath
string
Required
A unique identifier for the application or system that is making the order request.
lanequery
string
Optional parameter to specify the lane for filtering results.
search_typequery
string
search_type refers to the field that will be used as the target for the search operation
Enum
search_idquery
string
Identifier used for the search operation based on the selected search type.
from_datequery
string
| date
Date time in UTC timezone as per ISO format.
to_datequery
string
| date
Date time in UTC timezone as per ISO format.
dp_idsquery
string
Comma-separated list of delivery partner IDs to filter results.
ordering_company_idquery
string
ID of the company placing the order, used for filtering results.
storesquery
string
Comma-separated list of store IDs to filter results.
sales_channelquery
string
The sales channel to filter results.
request_by_extquery
string
Identifier for external requests.
page_noquery
integer
The page number for pagination of results.
page_sizequery
integer
The number of results to return per page for pagination.
customer_idquery
string
ID of the customer to filter results related to specific customer.
is_priority_sortquery
boolean
Flag to determine if results should be sorted by priority. Defaults to true.
Default Value : true
exclude_locked_shipmentsquery
boolean
Flag to exclude shipments that are currently locked from the results.
Default Value : true
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/shipments/
Loading...
Response
200
We are processing the report!
Hide
total_count
integer
Nullable
The total number of shipments matching the query criteria. Returned as -1 when `include_count=false`.
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.
Show
lane
string
Nullable
The lane associated with the shipment.
page
object (Page)
Show
Response
Loading...
GET

Track shipment

Track shipment by shipment Id for an application
Parameters
company_idpath
string
Required
Unique identifier of a company on the platform.
application_idpath
string
Required
A unique identifier for the application on the platform
shipment_idpath
string
Required
The unique identifier for the shipment
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/orders/shipments/{shipment_id}/track
Loading...
Response
200
Successful response containing the tracking details of the specified shipment. This response includes status updates, location details, account name, AWB number, and additional metadata. The example provided below demonstrates the structure of the response payload.
Hide
meta
object
Meta data of the shipment contains additional, potentially dynamic information about the shipment.
results
array of object (PlatformTrack)
A list of tracking details at various status.
Show
Response
Loading...
GET

List shipment cancellation reasons

Get reasons to perform full or partial cancellation of a shipment
Parameters
company_idpath
integer
Required
application_idpath
string
Required
actionpath
string
Required
GET
/service/platform/order/v1.0/company/{company_id}/application/{application_id}/orders/shipments/reasons/{action}
Loading...
Response
200
Success.
Hide
reasons
array of object (ShipmentResponseReasons)
Show
message
string
success
boolean
Examples
Parameters
company_id:
1
application_id:
"value"
action:
"value"
Response
Loading...