Download OpenAPI specification:
Every API request should be sent with a valid token. The token can be fetched by registering
a remote application in your account's Settings -> Users & Groups -> Remote applications.
The token of the remote application should be passed along with the header X-Auth-Token
and also make sure the remote application is authorized with necessary permissions.
Combines multiple trips into a single trip.
The trip IDs to be combined are provided as comma-separated
values in the trip_ids path parameter. A delivery person
must be assigned to create the combined trip.
trip_ids contains comma-separated IDs of the trips to be
combined.delivery_by specifies the delivery person to be assigned
to the combined trip.Any of the following permissions are needed
Trip/manageTrip/deliveryTrip/update-details| trip_ids required | string Comma-separated IDs of the trips to be combined. At least two trip IDs must be provided. |
| delivery_by required | string Delivery person to be assigned to the combined trip. |
{- "id": "_t:9395-1786953693"
}This endpoint removes a trip
Any of the following permissions are needed
Trip/deleteTrip/manageTrip/update-details| trip_id required | integer Identifier of the trip. |
{- "message": "string"
}Retrieves the complete details of an existing trip.
The response contains trip dates, team members, inventory, delivery logs, route information, delivery order, tracking information, mileage, and item details.
trip_id identifies the trip to retrieve.begin_inventory contains the inventory available at the
beginning of the trip.end_inventory contains the inventory recorded at the end
of the trip.delivery_logs contains customer-wise delivery information.item_id_map contains details of items used in the trip.delivery_order maps delivery log IDs to their delivery order.route_id and route_name identify the route associated
with the trip.track contains the delivery and sales tracking order.track_ended indicates whether sales and delivery tracking
has ended.Any of the following permissions are needed
Trip/accessTrip/deliveryTrip/manageTrip/sales| trip_id required | integer ID of the trip to retrieve. |
{- "begin_inventory": [
- {
- "id": 0,
- "quantity": 0
}
], - "close_mileage_del": 0,
- "close_mileage_sales": 0,
- "delivered_by": {
- "email_id": "string",
- "id": 0,
- "name": "string"
}, - "delivery_logs": [
- {
- "accnt_balance": 0,
- "amount": 0,
- "delivery_time": "string",
- "geopos": {
- "lat": 0,
- "lng": 0
}, - "id": 0,
- "items": {
- "in": [
- {
- "discount": 0,
- "id": 0,
- "price": 0,
- "quantity": 0
}
], - "ind": [
- {
- "discount": 0,
- "id": 0,
- "price": 0,
- "quantity": 0
}
], - "out": [
- {
- "discount": 0,
- "id": 0,
- "price": 0,
- "quantity": 0
}
], - "outd": [
- {
- "discount": 0,
- "id": 0,
- "price": 0,
- "quantity": 0
}
]
}, - "name": "string",
- "nick": "string",
- "payment": [
- {
- "amount": 0,
- "collected_by": "string",
- "collected_by_id": 0,
- "date": "string",
- "deposited_date": "string",
- "id": 0,
- "instr_bank": "string",
- "instr_date": "string",
- "instr_num": "string",
- "invoices": [
- {
- "amount": 0,
- "bill_id": 0,
- "bill_number": "string",
- "bill_type": "string",
- "date": "string",
- "settled": 0,
- "total": 0
}
], - "mode": "string"
}
], - "txn_type": "string"
}
], - "delivery_order": {
- "property1": 0,
- "property2": 0
}, - "end_date": "string",
- "end_inventory": [
- {
- "id": 0,
- "quantity": 0
}
], - "item_id_map": {
- "property1": {
- "code": "string",
- "name": "string",
- "num_variants": 0,
- "type": "string",
- "uom": "string",
- "uom_type": "string"
}, - "property2": {
- "code": "string",
- "name": "string",
- "num_variants": 0,
- "type": "string",
- "uom": "string",
- "uom_type": "string"
}
}, - "open_mileage_del": 0,
- "open_mileage_sales": 0,
- "order_taken_by": {
- "email_id": "string",
- "id": 0,
- "mobile_isd_code": "string",
- "mobile_number": "string",
- "name": "string"
}, - "props": { },
- "route_id": 0,
- "route_name": "string",
- "sales_acusts": 0,
- "sales_end_date": "string",
- "sales_ncusts": 0,
- "start_date": "string",
- "tokens": [
- { }
], - "track": {
- "del": [ ],
- "sales": [
- 0
]
}, - "track_ended": {
- "del": true,
- "sales": true
}
}Updates one or more properties of an existing trip.
This endpoint supports modifying trip information such as the start date, end date, delivery person, order taken by open mileage sales, open mileage delivery, close mileage sales, close mileage delivery.
Any of the following permissions are needed
Trip/manageTrip/salesTrip/update-details| open_mileage_del | number Update starting mileage of delivery. |
| open_mileage_sales | number Update starting mileage of sales. |
| close_mileage_del | number Update closing mileage of delivery. |
| close_mileage_sales | number Update closing mileage of sales. |
| start_date | string <date-time> Update trip started date. |
| end_date | string <date-time> Update trip ended date. |
| delivered_by | integer Update assigned delivery person for a trip. |
| order_taken_by | integer Update assigned sales person for a trip. |
{- "message": "string"
}Completely concludes a trip.
This endpoint marks the entire trip as completed and records the remaining inventory items at the end of the trip.
trip_id identifies the trip to be completely concluded.leftovers contains the items remaining when the trip is
concluded.conclude_orders endpoint.Any of the following permissions are needed
Trip/deliveryTrip/manageTrip/update-details| trip_id required | integer ID of the trip to completely conclude. |
Array of objects Items remaining when the trip is concluded. |
{- "leftovers": [
- {
- "id": 7,
- "quantity": 1
}, - {
- "id": 12,
- "quantity": 1
}, - {
- "id": 15,
- "quantity": 1
}, - {
- "id": 16,
- "quantity": 1
}, - {
- "id": 186,
- "quantity": 1
}, - {
- "id": 2033,
- "quantity": 4
}
]
}{- "message": "string"
}Concludes the sales orders for a trip and marks the sales process as completed.
The sales closing mileage and delivery person are recorded when concluding the trip orders.
trip_id identifies the trip for which sales orders are concluded.delivery_by identifies the delivery person associated with the
trip.close_mileage_sales specifies the closing mileage recorded when
concluding the sales orders.Any of the following permissions are needed
Trip/salesTrip/manageTrip/update-details| trip_id required | integer ID of the trip for which sales orders are concluded. |
| delivery_by required | integer ID of the delivery person associated with the trip. |
| close_mileage_sales required | number Closing mileage recorded for sales. |
{- "message": "string"
}Updates delivery details for customers in a trip.
Delivery details can be updated with delivered items, payments, delivery time, and inventory calculation information.
The same endpoint can be used to update item delivery details, record customer payments, or update the delivery time.
When applicable, invoice details and newly created payment details are returned in the response.
trip_id identifies the trip for which delivery details are
updated.deliveries contains the delivery details to be updated.id identifies the customer associated with the delivery.payment can be used to record payments against invoices.items can be used to record items delivered to the customer.delivery_time specifies the date and time of the delivery.calc_inventory to true to calculate inventory based on
the updated delivery details.new_payments when a new payment is
created.Any of the following permissions are needed
Trip/deliveryTrip/manageTrip/sales| trip_id required | integer ID of the trip for which delivery details are updated. |
| calc_inventory | boolean Calculate inventory based on the updated delivery details. |
Array of objects List of delivery details to update. |
{- "calc_inventory": true,
- "deliveries": [
- {
- "delivery_time": "10-06-2026T17:49:48",
- "id": 126,
- "items": [ ],
- "payment": [
- {
- "action": "new",
- "amount": 12,
- "invoices": [
- {
- "amount": 12,
- "bill_id": 2409
}
], - "mode": "CASH",
- "trip_id": "636"
}
]
}, - {
- "delivery_time": "11-06-2026T17:49:48",
- "id": 126,
- "items": [
- {
- "direction": "out",
- "discount": 29.75,
- "id": 2014,
- "orig_discount": 30,
- "orig_price": 43.71,
- "price": 43.7,
- "quantity": 2
}
], - "payment": [ ]
}
]
}{- "cnote_addons": null,
- "creditnote_id": null,
- "inv_addons": {
- "addon_total": -367.4,
- "bill_number": "1206",
- "bill_type": "sale",
- "contact_id": 126,
- "date": "10-06-2026T17:49:48"
}, - "invoice_id": 2409,
- "new_payments": [
- {
- "action": "new",
- "amount": 11,
- "collected_by_id": null,
- "customer_id": 126,
- "id": 666,
- "invoices": [
- {
- "amount": 11,
- "bill_id": 2409
}
], - "mode": "CASH",
- "trip_id": "636"
}
]
}Downloads trip details as an Excel file.
The downloaded file contains the details of the requested trip.
Item summary can optionally be included using the
items_summary query parameter.
.xls) file.items_summary is optional.items_summary to 1 to include item summary information
in the downloaded file.Any of the following permissions are needed
Trip/accessTrip/deliveryTrip/manageTrip/sales| items_summary | boolean Include item summary information in the downloaded file. |
{- "message": "string"
}Downloads the invoices generated for customers in a specific trip.
Only customers for whom an invoice has been generated are included in the downloaded file. Customers in the trip without a generated invoice are not included.
If invoices have been generated for multiple customers in the trip, all of those generated invoices are included in the download.
Any of the following permissions are needed
Trip/manageTrip/salesTrip/update-detailsTrip/delivery| trip_id required | integer ID of the trip for which generated invoices are downloaded. |
{- "message": "string"
}Generates an invoice for a customer associated with a trip.
The invoice is generated for the specified customer based on the customer's transactions and items in the specified trip.
invoice parameter controls invoice generation.Any of the following permissions are needed
Trip/manageGeneral/customer-invoice| trip_id required | integer ID of the trip for which the invoice is generated. |
| customer_id required | integer ID of the customer for whom the invoice is generated. |
| invoice required | boolean Generate the invoice. |
{- "cnote_addons": null,
- "creditnote_id": null,
- "inv_addons": {
- "addon_total": -848.36,
- "bill_number": "1204",
- "bill_type": "sale",
- "contact_id": 21,
- "date": "17-08-2026T10:30:08"
}, - "invoice_id": 2407
}Updates one or more properties of an existing trip.
This endpoint supports modifying trip information such as customers, inventory, item quantities, prices, discounts, returned items, and payments collected during the trip.
payment field.Any of the following permissions are needed
Trip/manageTrip/accessTrip/deliveryTrip/sales| trip_id required | integer ID of the trip to replan. |
Array of objects Customers and their trip delivery updates. | |
Array of objects Inventory updates for the trip. |
{- "customers": [
- {
- "id": 85,
- "payment": [
- {
- "action": "new",
- "amount": 12,
- "deposited_date": "14-08-2026",
- "instr_bank": "avc",
- "instr_date": "13-08-2026",
- "instr_num": "123",
- "invoices": [
- {
- "amount": 12,
- "bill_id": 425
}
], - "mode": "CIN",
- "trip_id": "650"
}
]
}
], - "inventory": [
- {
- "id": 14,
- "quantity": 2
}, - {
- "id": 16,
- "quantity": 3
}, - {
- "id": 26,
- "quantity": 1
}, - {
- "id": 33,
- "quantity": 12
}, - {
- "id": 34,
- "quantity": 2
}, - {
- "id": 35,
- "quantity": 8
}
]
}{- "new_payments": [
- {
- "action": "new",
- "amount": 8,
- "collected_by_id": null,
- "customer_id": 85,
- "id": 663,
- "invoices": [
- {
- "amount": -12,
- "bill_id": 477
}, - {
- "amount": 20,
- "bill_id": 578
}
], - "mode": "CASH",
- "trip_id": "650"
}
]
}Retrieves the tracking information for a trip based on the specified tracking nature.
The response contains the trip tracking data as a GeoJSON FeatureCollection, including route segments and tracking points.
trip_id identifies the trip for which tracking information
is requested.nature specifies the tracking type:
sales for sales person tracking and del for delivery
person tracking.since is optional and can be used to retrieve tracking data
starting from a specified Unix timestamp.FeatureCollection.LineString, Point, or
Polygon geometries.Any of the following permissions are needed
Trip/manageTrip/update-details| trip_id required | integer ID of the trip for which tracking information is requested. |
| nature required | string Enum: "sales" "del" Type of tracking information to retrieve.
|
| since | number <double> Unix timestamp from which tracking information should be retrieved. |
{- "geojson": {
- "features": [
- {
- "geometry": {
- "coordinates": [
- [
- 76.98037727133897,
- 11.028460025756182
], - [
- 76.98039027133896,
- 11.028556025756181
]
], - "type": "LineString"
}, - "properties": {
- "avg_spd": 27.36,
- "dis": 25,
- "etim": 1590113051.9999998,
- "idx": 3,
- "stim": 1590113048.7105262,
- "tim": 3.289473533630371
}, - "type": "Feature"
}, - {
- "geometry": {
- "coordinates": [
- 76.981753,
- 11.0286627
], - "type": "Point"
}, - "type": "Feature"
}, - {
- "geometry": {
- "coordinates": [
- [
- [
- 76.9817474,
- 11.0286627
], - [
- 76.9817474,
- 11.0286675
], - [
- 76.981753,
- 11.0286675
], - [
- 76.981753,
- 11.0286627
], - [
- 76.9817474,
- 11.0286627
]
]
], - "type": "Polygon"
}, - "properties": {
- "avg_spd": 0.33,
- "center": [
- 76.9817502,
- 11.0286651
], - "dis": 1,
- "etim": 1590113095,
- "isatt": true,
- "stim": 1590113084,
- "tim": 11
}, - "type": "Feature"
}
], - "type": "FeatureCollection"
}
}Stops tracking for the specified trip tracking nature.
The tracking can be stopped separately for the sales person
or delivery person using the nature path parameter.
trip_id identifies the trip for which tracking is stopped.nature specifies whose tracking should be stopped:
sales for sales person tracking and del for delivery
person tracking.stop to 1 to stop tracking for the specified nature.sales tracking stops tracking for the sales person.del tracking stops tracking for the delivery person.Any of the following permissions are needed
Trip/salesTrip/delivery| trip_id required | integer ID of the trip for which tracking should be stopped. |
| nature required | string Enum: "sales" "del" Type of tracking to stop.
|
| stop required | boolean Stops tracking for the specified nature when set to |
{- "stopped": true
}Retrieves trips matching the supplied filters.
The response contains trip dates, assigned sales and delivery persons, inventory mileage, route information, and customer counts.
max limits the number of trips returned.sort supports id and date fields with asc or desc
ordering.assigned_to filters trips by the assigned sales or delivery
person.route_id filters trips by the associated route.inv_id filters trips by invoice ID.inv_num filters trips by invoice number.null when
the corresponding information is not available.Any of the following permissions are needed
Trip/accessTrip/manageTrip/salesTrip/delivery| status | string Enum: "open" "close" Filter trips by their status. |
| max | integer Maximum number of records to return. |
| sort | string^(id|date)\.(asc|desc)$ Sorting expression in the format
Allowed fields:
|
| assigned_to | integer Filter trips by the sales person or delivery person assigned to the trip. |
| route_id | integer Filter trips by the route associated with the trip. |
| inv_id | integer Filter trips by invoice ID. |
| inv_num | integer Filter trips by invoice number. |
[- {
- "close_mileage_del": null,
- "close_mileage_sales": null,
- "delivered_by": "Mahesh",
- "end_date": null,
- "id": 648,
- "open_mileage_del": 12500.5,
- "open_mileage_sales": 12500.5,
- "order_taken_by": "Prem",
- "route_id": 14,
- "route_name": "Morning Route",
- "sales_acusts": 12,
- "sales_ncusts": 15,
- "start_date": "19-08-2026T08:15:00"
}, - {
- "close_mileage_del": null,
- "close_mileage_sales": 8265.4,
- "delivered_by": null,
- "end_date": "18-08-2026T18:30:00",
- "id": 649,
- "open_mileage_del": null,
- "open_mileage_sales": 8200,
- "order_taken_by": "Ramesh",
- "route_id": null,
- "route_name": null,
- "sales_acusts": 8,
- "sales_ncusts": 10,
- "start_date": "18-08-2026T09:00:00"
}
]Creates a new trip.
A trip can be created for an existing route or without a route. Customers, inventory, assigned sales and delivery persons, starting mileage, trip start date, and delivery order can be provided during creation.
customers contains the customers and items included in
the trip.inventory contains the total quantity of items required
for the trip.delivery_by specifies the delivery person assigned to
the trip.order_taken_by specifies the sales person assigned to
the trip.route_id specifies the route associated with the trip.trip_delivery_order maps customer IDs to their delivery
order.merged_orders can be used to include orders from other
trips.Any of the following permissions are needed
Trip/manageTrip/salesArray of objects Customers and their required product details. | |
| delivery_by | integer Delivery person ID. |
Array of objects Total quantity of each item required for the trip. | |
Array of objects Orders from other trips to be merged into this trip. | |
| open_mileage_del | number Starting mileage for delivery. |
| open_mileage_sales | number Starting mileage for sales. |
| order_taken_by | integer Sales person ID. |
| route_id | integer Route ID associated with the trip. |
| start_date | string <date-time> Trip start date and time. |
object Maps customer IDs to their delivery order. |
{- "customers": [
- {
- "id": 77,
- "items": [
- {
- "discount": 10,
- "id": 13,
- "price": 4014,
- "quantity": 12
}, - {
- "discount": 0,
- "id": 31,
- "price": 67,
- "quantity": 11
}
]
}, - {
- "id": 789,
- "items": [
- {
- "id": 1,
- "quantity": 4
}, - {
- "id": 44,
- "quantity": 0
}, - {
- "id": 57,
- "quantity": 1
}
]
}
], - "delivery_by": 9395,
- "inventory": [
- {
- "id": 13,
- "quantity": 12
}, - {
- "id": 18,
- "quantity": 1
}, - {
- "id": 31,
- "quantity": 11
}, - {
- "id": 57,
- "quantity": 1
}
], - "open_mileage_del": 123.98,
- "open_mileage_sales": 123.98,
- "order_taken_by": 9395,
- "route_id": 14,
- "start_date": "19-08-2026T17:28:35",
- "trip_delivery_order": { }
}{- "id": 2451
}Onboards the authenticated customer to a route with the specified items.
The customer is identified from the authenticated request. A customer can be onboarded only if the customer has not already been onboarded.
route_id is required and identifies the route to which
the customer is onboarded.items is required and specifies the items for the
onboarding.| route_id required | integer ID of the route to onboard the customer to. |
| items required | string Items to be assigned to the customer during onboarding. |
{- "message": "string"
}Deletes an existing route.
A route can be deleted only when it has no customers assigned to it.
route_id identifies the route to be deleted.Routes/manage is needed
| route_id required | integer ID of the route to delete. |
{- "message": "string"
}Retrieves detailed information for a specific route.
The response includes the route name, customers assigned to the route, customer items, delivery order, account information, customer delivery details, exceptions, route locations, tags, cancellation settings, and store order information.
Future customer exceptions can optionally be loaded using the
load_future_exc query parameter.
route_id identifies the route to retrieve.load_future_exc controls whether future customer exceptions
are loaded.items contain the item ID, quantity, frequency,
weekdays, and last supplied date.delivery_order specifies the customer's delivery order
within the route.geopos contains the customer's geographical coordinates.start_location and end_location contain the route's
geographical coordinates.Any of the following permissions are needed
Routes/manageRoutes/access| route_id required | integer ID of the route to retrieve. |
| load_future_exc | boolean Load future customer exceptions when set to |
{- "cancellation_time": "0;14:0",
- "customers": [
- {
- "accnt_balance": -1250.5,
- "delivery_order": 1,
- "exceptions": [ ],
- "geopos": {
- "lat": 13.0827,
- "lng": 80.2707
}, - "id": 501,
- "items": [
- {
- "frequency": 1,
- "id": 101,
- "last_supplied": null,
- "quantity": 2,
- "weekdays": null
}, - {
- "frequency": 2,
- "id": 205,
- "last_supplied": "15-08-2026T10:30:00",
- "quantity": 1,
- "weekdays": [
- "mon",
- "wed"
]
}
], - "last_del": "15-08-2026T10:30:00",
- "last_pay": "12-08-2026T09:15:00",
- "name": "Customer One",
- "nick": null,
- "txn_type": "C"
}, - {
- "accnt_balance": 850,
- "delivery_order": 2,
- "exceptions": [ ],
- "geopos": {
- "lat": 13.085,
- "lng": 80.275
}, - "id": 502,
- "items": [
- {
- "frequency": 1.5,
- "id": 110,
- "last_supplied": "14-08-2026T11:20:00",
- "quantity": 3,
- "weekdays": [
- "tue",
- "thu"
]
}
], - "last_del": "14-08-2026T11:20:00",
- "last_pay": null,
- "name": "Customer Two",
- "nick": "Customer 2",
- "txn_type": "C"
}
], - "end_location": {
- "lat": 13.06,
- "lng": 80.29
}, - "name": "Chennai Central",
- "start_location": {
- "lat": 13.0827,
- "lng": 80.2707
}, - "store_order_timing": {
- "end": null,
- "start": null
}, - "store_orders": null,
- "tag": "Morning - Chennai Central"
}Updates the details of an existing route.
The route can be updated by changing its name, tag, cancellation time, assigned customers, start location, end location, or store order timing.
At least one valid field must be provided in the request.
route_id identifies the route to be updated.customers can be used to update customers assigned to the
route and their item details.customers[].delete to true to remove the specified
customer from the route.start_location must contain both lng and lat when provided.end_location must contain both lng and lat when provided.Any of the following permissions are needed
Routes/manageTrip/manage| route_id required | integer ID of the route to update. |
| cancellation_time | string Route cancellation time configuration. |
Array of objects Customers to update in the route. Customers can be updated or removed from the route. | |
object Ending location of the route. | |
| name | string Name of the route. |
object Starting location of the route. | |
object Store order timing configuration. | |
| tag | string Tag associated with the route. |
{- "customers": [
- {
- "delete": true,
- "id": 502
}
]
}{- "message": "string"
}Retrieves the customers associated with a specific route.
The response includes customer details, account balance, last invoiced date, other routes associated with the customer, and the customer's geographical location.
route_id identifies the route for which customers are requested.last_invoiced_date can be null when the customer has not
been invoiced.other_routes contains other routes associated with the customer.geopos contains the customer's geographical coordinates.Any of the following permissions are needed
Routes/manageTrip/manageGeneral/customer-invoice| route_id required | integer ID of the route for which customers are requested. |
[- {
- "accnt_balance": 12500.75,
- "geopos": {
- "lat": 11.0168,
- "lng": 76.9558
}, - "id": 501,
- "last_invoiced_date": "12-08-2026T10:30:00",
- "name": "Prem",
- "nick_name": "prem",
- "other_routes": "Coimbatore North, Coimbatore South"
}, - {
- "accnt_balance": -2450.5,
- "geopos": {
- "lat": 11.0215,
- "lng": 76.9621
}, - "id": 502,
- "last_invoiced_date": null,
- "name": "Ramesh",
- "nick_name": "ramesh",
- "other_routes": "Chennai Central"
}, - {
- "accnt_balance": 8300,
- "geopos": {
- "lat": 11.0283,
- "lng": 76.9704
}, - "id": 503,
- "last_invoiced_date": "05-08-2026T14:20:00",
- "name": "Gopi",
- "nick_name": "gopi",
- "other_routes": "Madurai City, Trichy Main"
}, - {
- "accnt_balance": -1250.25,
- "geopos": {
- "lat": 11.0317,
- "lng": 76.9742
}, - "id": 504,
- "last_invoiced_date": "09-08-2026T11:45:00",
- "name": "Arun",
- "nick_name": "arun",
- "other_routes": "Salem East"
}
]Deletes an existing item exception for a customer assigned to a route.
The exception is identified using the route, customer, item, and exception date.
route_id identifies the route containing the exception.customer_id identifies the customer associated with the
exception.item_id identifies the item associated with the exception.date identifies the start date of the exception.| route_id required | integer ID of the route containing the exception. |
| customer_id required | integer ID of the customer associated with the exception. |
| item_id required | integer ID of the item associated with the exception. |
| date required | string <date-time> Start date and time of the exception. |
{- "message": "string"
}Updates an existing exception for a customer item assigned to a route.
The exception is identified using the route, customer, item, and exception date. The exception details can then be updated using the supported query parameters.
route_id identifies the route containing the exception.customer_id identifies the customer associated with the
exception.item_id identifies the item associated with the exception.date identifies the start date of the exception.quantity can be used to update the exception quantity.notes can be used to update the exception notes.till can be used to update the exception end date.start_date cannot be greater than the
end_date.| route_id required | integer ID of the route containing the exception. |
| customer_id required | integer ID of the customer associated with the exception. |
| item_id required | integer ID of the item associated with the exception. |
| date required | string <date-time> Start date and time of the exception. |
| quantity | number Updated quantity for the exception. |
| notes | string Updated notes for the exception. |
| till | string <date-time> Updated end date and time of the exception. |
{- "message": "string"
}Retrieves the exceptions associated with the customers of a specific route.
The response groups exceptions by customer. Each exception contains the affected item, exception period, quantity, notes, the user who logged the exception, and route details.
route_id identifies the route for which exceptions are
requested.items contains the exceptions associated with the customer.from and till define the period for which the exception
is applicable.quantity specifies the quantity affected by the exception.logged_by identifies who logged the exception.notes can be null when no notes are provided.Routes/manage is needed
| route_id required | integer ID of the route for which exceptions are requested. |
[- {
- "id": 501,
- "items": [
- {
- "cancellation_time": "0;14:0",
- "from": "15-08-2026T00:00:00",
- "id": 101,
- "logged_by": "Arun - Delivery",
- "notes": null,
- "quantity": 2,
- "route_id": 22,
- "tag": "Evening - Chennai Central",
- "till": "17-08-2026T23:59:59"
}, - {
- "cancellation_time": "0;14:0",
- "from": "20-08-2026T00:00:00",
- "id": 205,
- "logged_by": "Ramesh - Delivery",
- "notes": "Customer requested temporary change",
- "quantity": 1,
- "route_id": 22,
- "tag": "Evening - Chennai Central",
- "till": "20-08-2026T23:59:59"
}
], - "name": "Prem"
}, - {
- "id": 502,
- "items": [
- {
- "cancellation_time": "0;14:0",
- "from": "18-08-2026T00:00:00",
- "id": 110,
- "logged_by": "Gopi - Delivery",
- "notes": null,
- "quantity": 3,
- "route_id": 22,
- "tag": "Evening - Chennai Central",
- "till": "19-08-2026T23:59:59"
}
], - "name": "Ramesh"
}, - {
- "id": 503,
- "items": [
- {
- "cancellation_time": "0;14:0",
- "from": "22-08-2026T00:00:00",
- "id": 125,
- "logged_by": "Arun - Delivery",
- "notes": "Temporary exception",
- "quantity": 1,
- "route_id": 22,
- "tag": "Evening - Chennai Central",
- "till": "22-08-2026T23:59:59"
}
], - "name": "Gopi"
}
]Creates new exceptions for customers assigned to a route.
Exceptions can be created for specific items by specifying the affected quantity and the period for which the exception applies.
route_id identifies the route for which exceptions are created.exceptions[].id identifies the customer.exceptions[].items[].id identifies the item for which the
exception is created.quantity specifies the quantity affected by the exception.from specifies when the exception starts.till can be provided to specify when the exception ends.| route_id required | integer ID of the route for which exceptions are created. |
Array of objects Customers and their item exceptions. |
{- "exceptions": [
- {
- "id": 501,
- "items": [
- {
- "from": "18-08-2026",
- "id": 101,
- "quantity": 4
}
]
}
]
}{- "message": "string"
}Generates and downloads an outstanding report for one or more routes.
The report can be generated for a specific route, multiple routes, or all routes accessible to the authenticated user.
route_id can contain a single route ID, multiple comma-separated
route IDs, or * to generate the report for all accessible routes.ignore_noinvs is optional and can be used to ignore customers
without invoices in the report..xls) file.Any of the following permissions are needed
Routes/manageTrip/manageGeneral/customer-invoice| route_id required | string Route ID or comma-separated route IDs for which the outstanding
report should be generated. Use |
| ignore_noinvs | boolean Ignore customers without invoices when generating the outstanding report. |
{- "message": "string"
}Retrieves the list of available routes.
Each route contains its unique ID and name.
id and a name.Any of the following permissions are needed
Routes/accessRoutes/manageTrips/manage[- {
- "id": 101,
- "name": "Chennai Central"
}, - {
- "id": 102,
- "name": "Coimbatore North"
}, - {
- "id": 103,
- "name": "Madurai City"
}, - {
- "id": 104,
- "name": "Trichy Main"
}, - {
- "id": 105,
- "name": "Salem East"
}
]Creates a new route using the provided route name.
name is required to create a route.Routes/manage is needed
| name required | string Name of the new route. |
{- "name": "Chennai Central"
}{- "id": 106
}Deletes an existing customer.
customer_id identifies the customer to be deleted.General/customer-delete is needed
| customer_id required | integer ID of the customer to delete. |
{- "message": "string"
}Retrieves the transaction and account details of a customer for the specified date range.
next_from value.customer_id identifies the customer.from and to parameters are mandatory.opening_balance=1 includes the customer's opening balance
in the response.has_more indicates whether additional records are available.next_from contains the value to use for retrieving the next
set of records when more records are available.| customer_id required | integer ID of the customer. |
| from required | string Start date and time for the customer transaction details. |
| to required | string End date and time for the customer transaction details. |
| opening_balance | integer Value: 1 Set to |
{- "has_more": true,
- "invoice_charges": [
- { }
], - "next_from": "string",
- "opening_balance": {
- "credit": 0,
- "debit": 0,
- "empties": [
- {
- "empty": {
- "count": 0,
- "id": 0
}, - "full": {
- "count": 0,
- "id": 0
}
}
], - "txn_type": "C"
}, - "payments": [
- { }
], - "trips": [
- { }
], - "txn_type": "C"
}Updates the details of an existing customer.
The customer can be updated by changing supported customer details such as the customer name, item-wise received quantities, or invoice generation type.
customer_id identifies the customer to be updated.recv_count.<item_id> specifies the received quantity for
the corresponding item.recv_count.<item_id> parameters can be provided
for different items.invoice_gen_type can be used to set the invoice generation
type to postpaid or prepaid-1.Any of the following permissions are needed
General/customer-deleteGeneral/customer-logsGeneral/customer-invoice| customer_id required | integer ID of the customer to update. |
| name | string Updated name of the customer. |
| recv_count.<item_id> | number Received quantity for the specified item. Replace
|
| invoice_gen_type | string Enum: "postpaid" "prepaid-1" Invoice generation type for the customer.
|
{- "message": "string"
}Retrieves the authenticated customer's route alterations for a specific month and year.
customer_id must be self.month specifies the month to retrieve.year specifies the year to retrieve.till can be null when the alteration has no end date.quantity specifies the alteration quantity.logged_by identifies the team member who logged the
alteration.route_id identifies the associated route.tag contains the route tag.cancellation_time contains the route cancellation time.| customer_id required | string Value: "self" Must be |
| month required | integer [ 1 .. 12 ] Month for which alterations are requested. |
| year required | integer Year for which alterations are requested. |
[- {
- "cancellation_time": "string",
- "from": "string",
- "id": 0,
- "logged_by": "string",
- "notes": "string",
- "quantity": 0,
- "route_id": 0,
- "tag": "string",
- "till": "string"
}
]Retrieves the details of a specific customer.
Specific fields can optionally be requested using the fields
query parameter. When fields is not provided, the response
contains the available customer details.
customer_id identifies the customer whose details are requested.fields is optional.fields is provided, only the requested fields are
returned.| customer_id required | integer ID of the customer whose details are requested. |
| fields | string Example: fields=id,last_pay_date,last_del_date,added_on Comma-separated list of customer fields to return. Example fields:
|
{- "accnt_balance": 9300.25,
- "added_on": "20-04-2026T10:20:35",
- "credit_amount": 12500.5,
- "debit_amount": 3200.25,
- "empties": 2,
- "id": 501,
- "last_invoiced_date": "12-08-2026T10:30:00",
- "name": "Prem",
- "nick_name": "prem",
- "opening_balance": 500,
- "pricings": 4,
- "total_empty": 2,
- "total_full": 10,
- "txn_type": "C"
}Updates the geographical location of an existing customer.
The customer location is updated using the provided latitude and longitude coordinates.
customer_id identifies the customer whose location is updated.lat and lng query parameters are mandatory.| customer_id required | integer ID of the customer whose location is updated. |
| lat required | number <double> Latitude of the customer's new location. |
| lng required | number <double> Longitude of the customer's new location. |
{- "message": "string"
}Retrieves the price history for a specific item associated with a customer.
customer_id identifies the customer.history_item must be item_prices.item_id is mandatory.max can be used to limit the number of records returned.Any of the following permissions are needed
Trip/manageTrip/salesRoutes/manage| customer_id required | integer ID of the customer. |
| history_item required | string Value: "item_prices" Type of customer history to retrieve. |
| item_id required | integer ID of the item whose price history is requested. |
| max | integer Maximum number of history records to return. |
[- {
- "delivery_time": "19-11-2026T08:00:30",
- "discount": 0,
- "price": 3400,
- "quantity": 3
}
]Generates an invoice for a specific customer for the specified month and year.
Additional charges can be provided in the request body.
customer_id identifies the customer for whom the invoice
is generated.month specifies the invoice month.year specifies the invoice year.name specifies the customer name.charges contains additional charges to be applied to the
invoice.General/customer-invoice is needed
| customer_id required | integer ID of the customer for whom the invoice is generated. |
| name required | string Name of the customer. |
| month required | integer Month for which the invoice is generated. |
| year required | integer Year for which the invoice is generated. |
Array of objects Additional charges to be applied to the invoice. |
{- "charges": [ ]
}{- "creditnote_id": null,
- "invoice_id": 2412
}Retrieves the opening balance details of a specific customer for the specified date.
The response contains the customer's credit and debit amounts, transaction type, and item-wise full and empty quantities.
customer_id identifies the customer whose opening balance
is requested.date is mandatory.General/customer-logs or General/customer-invoice
permission.empties array contains the full and empty item details
with their respective counts.| customer_id required | integer ID of the customer whose opening balance is requested. |
| date required | string <date> Example: date=18-08-2026 Date for which the customer's opening balance is requested. |
{- "credit": 12500.5,
- "debit": 3200.25,
- "empties": [
- {
- "empty": {
- "count": -2,
- "id": 102
}, - "full": {
- "count": 4,
- "id": 101
}
}, - {
- "empty": {
- "count": 1,
- "id": 104
}, - "full": {
- "count": 0,
- "id": 103
}
}
], - "txn_type": "C"
}Creates a new payment for a customer.
The payment can be associated with one or more invoices by
providing invoice payment amounts using bill_id.<bill_id>
parameters.
customer_id identifies the customer making the payment.amount is mandatory.date is required for the payment.bill_id.<bill_id>.amount.bill_id.<bill_id> parameters can be provided.General/customer-invoice is needed
| customer_id required | integer ID of the customer making the payment. |
| mode | string Payment mode. |
| name | string Name of the customer. |
| amount required | number Total payment amount. |
| date required | string <date-time> Date and time of the payment. |
| bill_id.<bill_id> | number Amount of the payment allocated to the specified invoice.
Replace |
{- "id": 668
}Deletes an existing payment associated with a customer.
customer_id identifies the customer associated with the payment.payment_id identifies the payment to be deleted.General/customer-delete is needed
| customer_id required | integer ID of the customer associated with the payment. |
| payment_id required | integer ID of the payment to be deleted. |
{- "message": "string"
}Updates an existing payment for a customer.
The payment amount, payment mode, and invoice-wise payment allocations can be updated.
customer_id identifies the customer associated with the payment.payment_id identifies the payment to be updated.amount specifies the updated total payment amount.mode specifies the updated payment mode.bill_id.<bill_id> specifies the payment amount allocated to
the corresponding invoice.bill_id.<bill_id> parameters can be provided.General/customer-delete is needed
| customer_id required | integer ID of the customer associated with the payment. |
| payment_id required | integer ID of the payment to update. |
| amount | number Updated total payment amount. |
| mode | string Updated payment mode. |
| bill_id.<bill_id> | number Updated payment amount allocated to the specified invoice.
Replace |
{- "message": "string"
}Retrieves the payment history of a specific customer.
The response can be sorted by payment date or payment ID and limited to a maximum number of records.
customer_id identifies the customer whose payments are
requested.sort supports multiple comma-separated sorting expressions.date and id.asc or desc.max limits the number of records returned.General/customer-invoice is needed
| customer_id required | integer ID of the customer whose payments are requested. |
| sort | string Example: sort=date.desc,id.desc Sorting expression in the format
Multiple sorting expressions can be provided as comma-separated values. Supported fields:
|
| max | integer Maximum number of payment records to return. |
[- {
- "amount": 2500,
- "collected_by": "Arjun",
- "collected_by_email_id": "arjun@example.com",
- "date": "12-08-2026T10:30:00",
- "deposited_date": null,
- "id": 601,
- "instr_bank": null,
- "instr_date": null,
- "instr_num": null,
- "mode": "CASH",
- "notes": null
}, - {
- "amount": 1500,
- "collected_by": "Karthik",
- "collected_by_email_id": "karthik@example.com",
- "date": "15-08-2026T14:20:00",
- "deposited_date": "16-08-2026T09:00:00",
- "id": 602,
- "instr_bank": "Sample Bank",
- "instr_date": "15-08-2026T14:20:00",
- "instr_num": "TRX12345",
- "mode": "BANK_TRANSFER",
- "notes": "Payment received"
}
]Updates the special pricing configuration for a customer.
Pricing can be configured for a specific item, item type, or as a general pricing rule for the customer.
customer_id identifies the customer whose pricing is updated.pricings contains the pricing rules to be applied.id_type specifies what the pricing rule applies to.id_type=item applies pricing to a specific item.id_type=type applies pricing to a specific item type.id_type=* applies pricing generally to the customer.id is required when id_type is item or type.val_type specifies the pricing value type.value specifies the pricing value.Any of the following permissions are needed
General/customer-invoiceTrip/salesTrip/manage| customer_id required | integer ID of the customer whose pricing is updated. |
Array of objects Special pricing rules for the customer. |
{- "pricings": [
- {
- "id": 15,
- "id_type": "item",
- "val_type": "p",
- "value": -10
}, - {
- "id_type": "*",
- "val_type": "f",
- "value": 200
}
]
}[- {
- "id": 15,
- "id_type": "item",
- "val_type": "p",
- "value": -10
}, - {
- "id": 0,
- "id_type": "*",
- "val_type": "f",
- "value": 200
}
]Retrieves the special pricing configuration for one or more customers.
customer_id is mandatory.Any of the following permissions are needed
General/customer-invoiceGeneral/customer-logsTrip/manageTrip/accessTrip/deliveryTrip/sales| customer_id required | string Example: customer_id=61,62 Customer ID or comma-separated customer IDs whose pricing information should be retrieved. |
[- {
- "customer_id": 61,
- "pricings": [
- {
- "id": 15,
- "id_type": "item",
- "val_type": "d",
- "value": -90
}
]
}, - {
- "customer_id": 62,
- "pricings": [
- {
- "id": 0,
- "id_type": "*",
- "val_type": "p",
- "value": 100
}
]
}
]Retrieves customers matching the supplied filters.
The response can be customized using filters, sorting, and result limits. Customers can also be filtered by transaction type to retrieve either customers or vendors.
txn_type=C returns only customers.txn_type=V returns only vendors.max limits the number of records returned and defaults to
30.id is provided, the result limit is not applied.dues and advances cannot be used together.sort supports multiple comma-separated sorting expressions.name, id, advance_amnt,
receivable_amnt, empties, and accnt_balance.asc or desc.Any of the following permissions are needed
General/customer-logsGeneral/customer-invoice| sort | string Example: sort=id.desc Sorting expression in the format
Multiple sorting expressions can be provided as comma-separated values. Supported fields:
|
| max | integer Default: 30 Maximum number of records to return. |
| txn_type | string Enum: "C" "V" Filter customers by transaction type.
|
| dues | string Filter customers based on dues. |
| advances | string Filter customers based on advances. |
[- {
- "accnt_balance": 9300.25,
- "added_on": "20-04-2026T10:20:35",
- "credit_amount": 12500.5,
- "debit_amount": 3200.25,
- "empties": 2,
- "id": 501,
- "last_invoiced_date": "12-08-2026T10:30:00",
- "name": "Prem",
- "nick_name": "prem",
- "opening_balance": 500,
- "pricings": 4,
- "total_empty": 2,
- "total_full": 10,
- "txn_type": "C"
}, - {
- "accnt_balance": -4500,
- "added_on": null,
- "credit_amount": 0,
- "debit_amount": 4500,
- "empties": 1,
- "id": 502,
- "last_invoiced_date": null,
- "name": "Ramesh",
- "nick_name": null,
- "opening_balance": 0,
- "pricings": null,
- "total_empty": 1,
- "total_full": 5,
- "txn_type": "C"
}, - {
- "accnt_balance": 16500,
- "added_on": "21-04-2026T13:22:37",
- "credit_amount": 25000,
- "debit_amount": 8500,
- "empties": 3,
- "id": 503,
- "last_invoiced_date": null,
- "name": "Gopi",
- "nick_name": "gopi",
- "opening_balance": 1000,
- "pricings": 2,
- "total_empty": 3,
- "total_full": 8,
- "txn_type": "V"
}, - {
- "accnt_balance": -2000,
- "added_on": "22-04-2026T09:15:00",
- "credit_amount": 10000,
- "debit_amount": 12000,
- "empties": 1,
- "id": 504,
- "last_invoiced_date": "10-08-2026T14:20:00",
- "name": "Arun",
- "nick_name": null,
- "opening_balance": 500,
- "pricings": null,
- "total_empty": 1,
- "total_full": 4,
- "txn_type": "V"
}
]Creates a new customer using the provided contact information and goods-specific details.
txn_type is V.base_data is mandatory.base_data contains the customer's personal and contact details.goods_data contains goods-specific customer details.route_id identifies the route assigned to the customer.opening_balance specifies the customer's opening balance.txn_type is optional.txn_type is V, the contact is created as a vendor.txn_type is not provided, the contact is created as a
customer by default.txn_type supports C for customer and V for vendor.Any of the following permissions are needed
General/customer-logsGeneral/customer-invoiceTrip/manageTrip/salesobject Customer contact and personal information. | |
object Goods-specific customer information. |
{- "base_data": {
- "details": [
- {
- "key": "Mobile",
- "value": "9876543210"
}, - {
- "key": "Email",
- "value": "arjun@example.com"
}, - {
- "key": "GSTIN",
- "value": "GST12345"
}, - {
- "key": "Address",
- "value": {
- "city": "Chennai",
- "country": "India",
- "line1": "12",
- "line2": "Main Road",
- "line3": "North Street",
- "line4": "Central",
- "postal_code": "600001",
- "state": "Tamil Nadu"
}
}
], - "first_name": "Arjun",
- "last_name": "Raj",
- "other_info": "Arjun Raj"
}, - "goods_data": {
- "name": "Arjun Raj",
- "opening_balance": 500,
- "route_id": 10,
- "txn_type": "V"
}
}{- "id": 836
}Retrieves the team members available to the authenticated user.
The response includes team member details, user type, notification settings, access restrictions, and permitted routes.
user_type identifies the type of team member.permitted_routes contains the routes accessible to the
team member.[- {
- "block_edits_post_invc": false,
- "block_edits_wo_loc": false,
- "block_loc_upd": false,
- "block_oos": false,
- "block_orders": false,
- "block_payment_upd": false,
- "block_payments": false,
- "block_pricing": false,
- "block_returns": false,
- "deny_cross_route_replan": false,
- "email_id": "arjun@example.com",
- "id": 501,
- "mobile_isd_code": null,
- "mobile_number": null,
- "name": "Arjun",
- "notify_trips": true,
- "permitted_routes": [
- 4,
- 7
], - "user_type": "sales"
}, - {
- "block_edits_post_invc": false,
- "block_edits_wo_loc": false,
- "block_loc_upd": false,
- "block_oos": false,
- "block_orders": false,
- "block_payment_upd": false,
- "block_payments": false,
- "block_pricing": false,
- "block_returns": false,
- "deny_cross_route_replan": false,
- "email_id": null,
- "id": 502,
- "mobile_isd_code": null,
- "mobile_number": null,
- "name": "Karthik",
- "notify_trips": false,
- "permitted_routes": [ ],
- "user_type": "del"
}
]Creates a new team member with the specified details.
name specifies the team member name.email_id specifies the team member email address.user_type must be one of del, sales, or snd.notify_trips specifies whether trip notifications are enabled.Any of the following permissions are needed
Trip/manageRoutes/manage| email_id | string <email> Email address of the team member. |
| name | string Name of the team member. |
| notify_trips | boolean Whether trip notifications are enabled. |
| user_type | string Enum: "del" "sales" "snd" Type of the team member. |
{- "email_id": "aravind@example.com",
- "name": "Aravind Kumar",
- "notify_trips": true,
- "user_type": "sales"
}{- "id": 9410
}Deletes an existing team member.
tid identifies the team member to be deleted.Any of the following permissions are needed
Trip/manageGeneral/customer-delete| tid required | integer ID of the team member to delete. |
{- "message": "string"
}Updates the details of an existing team member.
Only the fields provided in the request are updated.
tid identifies the team member to be updated.user_type must be one of snd, sales, or del.permitted_routes can be used to update the routes permitted
for the team member.Any of the following permissions are needed
Trip/manageRoutes/manage| tid required | integer ID of the team member to update. |
| name | string Updated name of the team member. |
| email_id | string <email> Updated email address of the team member. |
| mobile_isd_code | string Updated mobile ISD code. |
| mobile_number | string Updated mobile number. |
| user_type | string Enum: "snd" "sales" "del" Updated type of the team member. |
| notify_trips | boolean Enable or disable trip notifications. |
| block_pricing | boolean Enable or disable pricing restrictions. |
| block_orders | boolean Enable or disable order restrictions. |
| block_edits_post_invc | boolean Enable or disable edits after invoicing. |
| block_returns | boolean Enable or disable return restrictions. |
| block_payments | boolean Enable or disable payment restrictions. |
| block_payment_upd | boolean Enable or disable payment update restrictions. |
| block_loc_upd | boolean Enable or disable location update restrictions. |
| block_oos | boolean Enable or disable out-of-stock restrictions. |
| block_edits_wo_loc | boolean Enable or disable edits without location. |
| deny_cross_route_replan | boolean Enable or disable cross-route replanning. |
| permitted_routes | string Routes permitted for the team member. |
{- "message": "string"
}Retrieves quick summary reports based on the requested QSR type.
Supported QSR types include customer-wise and product-wise summary reports.
qsr_type identifies the type of quick summary report.customers returns customer-wise transaction quantities and
prices grouped by transaction direction.products returns product-wise transaction information
grouped by customer.max limits the number of returned records.siids and nsiids item filters.sdate_ge, sdate_le, nsdate_ge,
and nsdate_le date filters.riids,
rdate_ge, rdate_le, nriids, nrdate_ge, and nrdate_le.type_id, outq_g, inq_g,
route_id, sales_person, date_ge, and date_le.out contains outgoing transactions.outd contains outgoing discounted transactions.in contains incoming transactions.ind contains incoming discounted transactions.Any of the following permissions are needed
Trip/manageGeneral/manage-settings| qsr_type required | string Type of quick summary report. Supported values are
|
| max | integer Maximum number of records to return. |
| siids | string Pipe-separated item IDs used to filter customer sales. |
| sdate_ge | string Start date for the customer sales item filter. |
| sdate_le | string End date for the customer sales item filter. |
| nsiids | string Pipe-separated item IDs used for the additional customer item filter. |
| nsdate_ge | string Start date for the additional customer item filter. |
| nsdate_le | string End date for the additional customer item filter. |
| riids | string Route filter. Use |
| rdate_ge | string Start date for the route filter. |
| rdate_le | string End date for the route filter. |
| nriids | string Comma-separated route IDs used for the additional route filter. |
| nrdate_ge | string Start date for the additional route filter. |
| nrdate_le | string End date for the additional route filter. |
| type_id | string Comma-separated item type IDs used to filter products. |
| outq_g | number Minimum outgoing quantity filter. |
| inq_g | number Minimum incoming quantity filter. |
| route_id | string Comma-separated route IDs used to filter product results. |
| sales_person | string Comma-separated sales person IDs used to filter product results. |
| date_ge | string Start date for product statistics. |
| date_le | string End date for product statistics. |
[- {
- "id": 0,
- "in": [
- {
- "id": 0,
- "name": "string",
- "nick": "string",
- "pr": 0,
- "qty": 0
}
], - "ind": [
- {
- "id": 0,
- "name": "string",
- "nick": "string",
- "pr": 0,
- "qty": 0
}
], - "name": "string",
- "nick": "string",
- "out": [
- {
- "id": 0,
- "name": "string",
- "nick": "string",
- "pr": 0,
- "qty": 0
}
], - "outd": [
- {
- "id": 0,
- "name": "string",
- "nick": "string",
- "pr": 0,
- "qty": 0
}
]
}
]Retrieves a summary of customer and vendor balance statistics.
The response provides separate statistics for advances and receivables, grouped by transaction type.
txn_type identifies whether the statistics belong to customers
(C) or vendors (V).min represents the minimum balance in the group.max represents the maximum balance in the group.total represents the total balance in the group.num represents the number of records in the group.Any of the following permissions are needed
Trip/manageGeneral/manage-settings{- "advances": [
- {
- "max": 250000,
- "min": 25,
- "num": 12,
- "total": 780000,
- "txn_type": "C"
}, - {
- "max": 50000,
- "min": 50,
- "num": 5,
- "total": 125000,
- "txn_type": "V"
}
], - "receivables": [
- {
- "max": 2500000,
- "min": 100,
- "num": 32,
- "total": 8500000,
- "txn_type": "C"
}, - {
- "max": 25000,
- "min": 5000,
- "num": 3,
- "total": 40000,
- "txn_type": "V"
}
]
}Retrieves route-related summary information including items, customers assigned to routes, customers not assigned to routes, and customers assigned to multiple routes.
The same endpoint also supports downloading route summary information.
download=1 enables automatic download of the requested
route summary data.download=1 is provided, one of notinroutes,
multipleroutes, or inroute must also be provided.notinroutes downloads customers that are not assigned to
any route.multipleroutes downloads customers assigned to multiple
routes.inroute downloads customers assigned to routes.inroute=* includes customers from all routes.Any of the following permissions are needed
Trip/manageGeneral/manage-settings| download | integer Value: 1 Set to |
| notinroutes | string Downloads customers that are not assigned to any route. |
| multipleroutes | string Downloads customers that are assigned to multiple routes. |
| inroute | string Downloads customers assigned to routes. Use |
{- "customers_in_multiple_routes": [
- { }
], - "customers_not_in_route": [
- { }
], - "items": [
- {
- "freq": {
- "property1": 0,
- "property2": 0
}, - "id": 0,
- "name": "string",
- "properties": {
- "property1": "string",
- "property2": "string"
}, - "type": "string",
- "weekdays": {
- "property1": 0,
- "property2": 0
}
}
], - "num_customers_in_route": 0
}Retrieves statistics based on the requested statistics type.
The stats_type path parameter determines the type of statistics
to retrieve.
Supported statistics types include:
sales - Sales, item, payment, and item details statistics.route - Route-wise sales and cancellation statistics.team - Team member-wise sales and delivery statistics.sales uses date_ge and date_le for the date range.route and team use from and to for the date range.item_types can be used with sales to filter statistics
by item type.stats_type.| stats_type required | string Enum: "sales" "route" "team" Type of statistics to retrieve. |
| date_ge | string Start date and time for sales statistics. |
| date_le | string End date and time for sales statistics. |
| item_types | string Item type filter for sales statistics. |
| from | string Start date and time for route or team statistics. |
| to | string End date and time for route or team statistics. |
{- "delivery": [
- { }
], - "item_map": {
- "property1": { },
- "property2": { }
}, - "new_customers": [
- { }
], - "sales": [
- { }
], - "sales_date_wise": [ ]
}Deletes an existing payment mode.
mode identifies the payment mode to be deleted.Any of the following permissions are needed
Trip/manageGeneral/manage-settings| mode required | string Payment mode to delete. |
{- "message": "string"
}Updates an existing payment mode.
mode in the path identifies the payment mode to update.mode query parameter specifies the new payment mode name.mode query parameter is mandatory.Any of the following permissions are needed
Trip/manageGeneral/manage-settings| mode required | string Existing payment mode to update. |
| mode required | string New name for the payment mode. |
{- "message": "string"
}Retrieves the payment modes supported by the application.
The response can optionally include the number of payments made using each payment mode.
detailed=1 is provided, the response includes the
payment mode and its usage count.count represents the number of payments that use the
corresponding payment mode.| detailed | integer Value: 1 When set to |
[- "CASH",
- "CHEQUE",
- "CIN",
- "CURRENCY NOTES",
- "GPAY",
- "NETBANKING",
- "ONLINE PAYMENT"
]Creates a new payment mode.
mode specifies the name of the new payment mode.Any of the following permissions are needed
Trip/manageGeneral/manage-settings| mode | string Name of the payment mode. |
{- "mode": "DIGITAL WALLET"
}{- "message": "string"
}Updates or removes the mapping between full products and their corresponding empty products.
A full product can be mapped to one or more empty products. Providing an empty value removes the mapping for the specified full product.
map.<full_product_id> is the only supported parameter format.<full_product_id> identifies the full product.map.<full_product_id> must be a comma-separated
list of empty product IDs.General/manage-settings is needed
| map.<full_product_id> | string Examples:
Comma-separated empty product IDs to be mapped to the
specified full product. Replace If the value is empty, the mapping for the specified full product is deleted. |
{- "message": "string"
}Retrieves or updates the optimized customer order for a route or trip.
The endpoint can be used with either a route_id or a
trip_id. The same endpoint supports both GET and POST
requests.
route_id or trip_id must be provided.route_id identifies the route to reorder.trip_id identifies the trip to reorder.new_order when a new customer
order is available.in_progress indicates whether route reordering is in progress.completed indicates whether route reordering is completed.err and desc may be returned when the reorder operation
encounters an error.Any of the following permissions are needed
Routes/manageTrip/manageTrip/delivery| route_id | integer ID of the route to reorder. |
| trip_id | integer ID of the trip to reorder. |
{- "completed": "1",
- "in_progress": "0"
}Generates a route map based on the geographical locations of the specified customers.
cids is mandatory.cids accepts multiple customer IDs as comma-separated values.FeatureCollection with the
generated route represented as a LineString.Any of the following permissions are needed
Trip/accessRoutes/accessRoutes/manageTrip/manageTrip/salesTrip/delivery| cids required | string Example: cids=21,15,72,164 Comma-separated customer IDs used to generate the route. |
{- "features": [
- {
- "geometry": {
- "coordinates": [
- [
- 77.915698,
- 11.149117
], - [
- 77.900529,
- 11.151302
], - [
- 77.907939,
- 11.157621
], - [
- 77.918282,
- 11.149673
], - [
- 77.891693,
- 11.151341
], - [
- 77.880633,
- 11.169019
], - [
- 77.839801,
- 11.223714
], - [
- 77.770126,
- 11.266074
], - [
- 77.66667,
- 11.313746
], - [
- 77.569378,
- 11.281856
], - [
- 77.506656,
- 11.237183
], - [
- 77.418971,
- 11.198731
], - [
- 77.350665,
- 11.216323
], - [
- 77.294112,
- 11.195096
], - [
- 77.240469,
- 11.175968
], - [
- 77.197257,
- 11.12678
], - [
- 77.130793,
- 11.087921
], - [
- 77.079166,
- 11.051299
], - [
- 77.021743,
- 11.026689
], - [
- 76.995939,
- 11.024838
]
], - "type": "LineString"
}, - "type": "Feature"
}
], - "type": "FeatureCollection"
}