Initial Page Load
POST /sellers/v3/returns/tasks/initial-load
The Initial Page Load API is specifically designed to execute only when the system detects shipments scheduled for delivery today. This API serves a foundational purpose by fetching essential core identifiers, such as feId and taskId, along with other necessary details. Crucially, the API also retrieves configuration data that is subsequently utilised in the workflow to determine if the Generate Start OTC button should be visible or hidden on the dashboard, based on the enabled configuration settings. This API only returns FEs that are currently on the Start OTC page, End OTC page, or Scanning. It does NOT return FEs that haven't arrived yet or have completed their task.
- application/json
Request Body required
Request body for initial page load
- sellerLocationId string required
Seller location identifier
- taskType string required
Possible values: [
RETURN]Task type - must be RETURN
- 200
- 400
- 401
- 500
- 502
- 503
- 504
successful operation
- application/json
- Schema
- Example (from schema)
Schema
sellerConfig object
enabledFor stringPossible values: [
OldStatic,NewStatic,DynamicStartEnd,DynamicEnd]OTC flow configuration
feDetails object
Field Executive details mapped by feId
property name* object (FeDetail)
feName stringField Executive name
logisticPartner stringLogistics partner name
lob stringPossible values: [
LARGE,NONLARGE]Line of Business
task object
id stringTask identifier
status stringTask status
createdAt int64Task creation timestamp
{
"sellerConfig": {
"enabledFor": "OldStatic | NewStatic | DynamicStartEnd | DynamicEnd"
},
"feDetails": {
"fe12303": {
"feName": "Ram",
"logisticPartner": "eKart",
"lob": "LARGE | NONLARGE",
"task": {
"id": "123",
"status": "Scanning",
"createdAt": 1873193801
}
}
}
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
- errorCode string
Possible values: [
TRIPSHEET_TASK_NOT_FOUND,INVALID_TASK_TYPE_ERROR,UNAUTHORIZED_ERROR,INTERNAL_SERVER_ERROR,BAD_GATEWAY_ERROR,SERVICE_UNAVAILABLE_ERROR,GATEWAY_TIMEOUT_ERROR]Error code
- message string
Error message
{
"errorCode": "TRIPSHEET_TASK_NOT_FOUND",
"message": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
- errorCode string
Possible values: [
TRIPSHEET_TASK_NOT_FOUND,INVALID_TASK_TYPE_ERROR,UNAUTHORIZED_ERROR,INTERNAL_SERVER_ERROR,BAD_GATEWAY_ERROR,SERVICE_UNAVAILABLE_ERROR,GATEWAY_TIMEOUT_ERROR]Error code
- message string
Error message
{
"errorCode": "TRIPSHEET_TASK_NOT_FOUND",
"message": "string"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
- errorCode string
Possible values: [
TRIPSHEET_TASK_NOT_FOUND,INVALID_TASK_TYPE_ERROR,UNAUTHORIZED_ERROR,INTERNAL_SERVER_ERROR,BAD_GATEWAY_ERROR,SERVICE_UNAVAILABLE_ERROR,GATEWAY_TIMEOUT_ERROR]Error code
- message string
Error message
{
"errorCode": "TRIPSHEET_TASK_NOT_FOUND",
"message": "string"
}
Bad Gateway
- application/json
- Schema
- Example (from schema)
Schema
- errorCode string
Possible values: [
TRIPSHEET_TASK_NOT_FOUND,INVALID_TASK_TYPE_ERROR,UNAUTHORIZED_ERROR,INTERNAL_SERVER_ERROR,BAD_GATEWAY_ERROR,SERVICE_UNAVAILABLE_ERROR,GATEWAY_TIMEOUT_ERROR]Error code
- message string
Error message
{
"errorCode": "TRIPSHEET_TASK_NOT_FOUND",
"message": "string"
}
Service Unavailable
- application/json
- Schema
- Example (from schema)
Schema
- errorCode string
Possible values: [
TRIPSHEET_TASK_NOT_FOUND,INVALID_TASK_TYPE_ERROR,UNAUTHORIZED_ERROR,INTERNAL_SERVER_ERROR,BAD_GATEWAY_ERROR,SERVICE_UNAVAILABLE_ERROR,GATEWAY_TIMEOUT_ERROR]Error code
- message string
Error message
{
"errorCode": "TRIPSHEET_TASK_NOT_FOUND",
"message": "string"
}
Gateway Timeout
- application/json
- Schema
- Example (from schema)
Schema
- errorCode string
Possible values: [
TRIPSHEET_TASK_NOT_FOUND,INVALID_TASK_TYPE_ERROR,UNAUTHORIZED_ERROR,INTERNAL_SERVER_ERROR,BAD_GATEWAY_ERROR,SERVICE_UNAVAILABLE_ERROR,GATEWAY_TIMEOUT_ERROR]Error code
- message string
Error message
{
"errorCode": "TRIPSHEET_TASK_NOT_FOUND",
"message": "string"
}