Spurtcommerce
DocumentAPI ReferenceAdd-ons
API Reference
API Reference
  • About Spurtcommerce APIs
  • Spurtcommerce
    • Admin API
      • Admin
        • Authentication
        • My Profile
        • Support
      • Buyers
        • Manage Buyer
      • Chat
      • CMS
        • Manage Banner
        • Manage Blogs
        • Manage Pages
        • Manage SEO
      • Dashboard
      • Marketing
        • Manage Cross Selling
          • Related Products
        • Manage Promotions
          • Coupon
      • Marketplace
        • Manage Products
        • Manage Sales
        • Manage Settlements
        • Product Configuration
        • Reports
      • Sellers
        • Seller
        • Seller Group
        • Seller KYC Request
      • Settings
        • Add-ons
        • Add-ons Product Attributes
        • Localization
        • Order Fulfilment Status
        • Personalise
        • Site Settings
        • Store Settings
        • System
        • User and Permission
        • Support-Category
    • Store API
      • Account Settings
        • Customer
        • My Order
        • My Quotation
        • My Wishlist
        • Profile
        • Support
      • Checkouts
      • Store
        • Admin Contact
        • Categories
        • Home
        • Product Detail Page
    • Vendor API
      • Page 1
      • Catalogue
        • Bulk Product Imports
          • Custom
          • Standard
        • Common Product
        • Data Export
        • Pricing
        • Product Localisation
        • Product List
        • Product Variants
        • Related Products
      • CRM
        • Customer
        • Customer Group
        • Question and Answer
        • Rating and Review
      • Dashboard
      • Marketing
      • Payments
        • Archeived Payments
        • Earnings
        • Settlements
      • Profile
        • Account Settings
          • My Business
          • My KYC
          • My Profile
          • My Shop
          • Personalised Setting
        • Chat
        • Vendor
        • Support
      • Reports
      • Sales
        • Archeive Orders
        • Back Orders
        • Failed Orders
        • Orders
        • Quotation Request
        • Stock Update
        • Variant Stock Update
      • Supplier
        • Contact
        • Supplier
Powered by GitBook
On this page
  1. Spurtcommerce
  2. Admin API
  3. Marketplace

Manage Sales

PreviousManage ProductsNextManage Settlements

Last updated 3 months ago

Get vendor orders

get

Retrieve a list of vendor orders with optional query parameters.

Query parameters
limitintegerOptional

The number of orders to retrieve

offsetintegerOptional

The number of orders to skip before starting to collect the result set

countintegerOptional

Include the count of total records (1 for true, 0 for false)

keyUpbooleanOptional

Boolean flag to filter orders

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the vendor order list
400
Invalid query parameters
500
Internal server error
get
GET /backend/api/admin-vendor-order HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully got the complete order list</message>
</object>

Get order detail

get

Retrieve detailed information for a specific vendor order using the provided orderId.

Query parameters
orderIdintegerRequired

The ID of the order to retrieve details for

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved order details
400
Invalid `orderId` parameter
404
Order not found
500
Internal server error
get
GET /backend/api/admin-vendor-order/order-detail HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully shown the order detail</message>
	<orderDetail>
		<orderId>1628</orderId>
		<vendorName>Vendor A</vendorName>
		<orderStatus>Completed</orderStatus>
		<orderDate>2024-01-01T12:00:00Z</orderDate>
		<totalAmount>200.5</totalAmount>
		<items>
			<itemId>101</itemId>
			<itemName>Product A</itemName>
			<quantity>2</quantity>
			<price>50.25</price>
		</items>
	</orderDetail>
</object>

Get vendor order status log list

get

Retrieve the order status log for a specific vendor order using the provided vendorOrderId.

Query parameters
vendorOrderIdintegerRequired

The ID of the vendor order to retrieve the log list for

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the vendor order log list
400
Invalid `vendorOrderId` parameter
404
Vendor order not found
500
Internal server error
get
GET /backend/api/admin-vendor-order/vendor-order-log-list HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully got the complete seller order status log list</message>
	<logList>
		<logId>5001</logId>
		<status>Shipped</status>
		<date>2024-01-15T14:00:00Z</date>
		<description>Order has been shipped to the vendor</description>
	</logList>
</object>

Get order status list

get

Retrieve a complete list of order statuses.

Responses
200
Successfully retrieved the order status list
500
Internal server error
get
GET /backend/api/order-status/order-status-list HTTP/1.1
Host: 139.59.67.17
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully got the complete order status list</message>
	<orderStatusList>
		<statusId>1</statusId>
		<statusName>Pending</statusName>
		<description>The order is pending</description>
	</orderStatusList>
</object>

Export vendor order details as PDF

get

Exports the details of a specific vendor order as a PDF file using the orderId, vendorId, and orderPrefixId.

Query parameters
orderIdintegerRequired

The ID of the order to be exported

vendorIdintegerRequired

The ID of the vendor associated with the order

orderPrefixIdstringRequired

The prefix ID of the order, typically for identifying the order uniquely

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully exported the order details as a PDF
400
Invalid query parameters
404
Order not found
500
Internal server error
get
GET /backend/api/admin-vendor-order/order-export-pdf HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully exported the order as a PDF</message>
	<pdfUrl>http://139.59.67.17/backend/api/downloads/order-1628.pdf</pdfUrl>
</object>

Get back order list

get

Retrieves the list of back orders, with options for pagination.

Query parameters
limitintegerOptional

The number of items to return per page

Default: 10
offsetintegerOptional

The offset for pagination

Default: 0
countintegerOptional

A flag to count the total number of back orders

Default: 0
Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the back order list
400
Invalid query parameter
500
Internal server error
get
GET /backend/api/order/back-order-list HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully shown the Back Order list</message>
</object>

Get failed order list

get

Retrieves the list of failed orders, with options for pagination.

Query parameters
limitintegerOptional

The number of items to return per page

Default: 10
offsetintegerOptional

The offset for pagination

Default: 0
countintegerOptional

A flag to count the total number of failed orders

Default: 0
Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the failed order list
400
Invalid query parameter
500
Internal server error
get
GET /backend/api/order/failed-order-list HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully got the failed order list</message>
</object>

Get order details

get

Retrieves the details of a specific order by its ID.

Query parameters
orderIdintegerRequired

The ID of the order to retrieve details for

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the order details
400
Invalid order ID
500
Internal server error
get
GET /backend/api/order/order-detail HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully shown the order detail</message>
</object>

Get payment list

get

Retrieves a list of payments based on optional filters such as customer name, keyword, and date range.

Query parameters
limitintegerOptional

The number of results to return

offsetintegerOptional

The offset from which to start retrieving the results

countintegerOptional

Whether to return the total count of items (0 or 1)

customerNamestringOptional

The name of the customer to filter the payments by

keywordstringOptional

A keyword to filter the payments by (e.g., order ID, payment reference)

startDatestring · dateOptional

The start date for filtering payments

endDatestring · dateOptional

The end date for filtering payments

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the payment list
400
Invalid parameters
500
Internal server error
get
GET /backend/api/admin-vendor-payment/payment-list HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>text</message>
</object>

Get live cart list or count

get

Retrieves the list of live carts or the count based on the provided filters.

Query parameters
limitintegerOptional

The number of results to return

offsetintegerOptional

The offset from which to start retrieving the results

countintegerOptional

Whether to return the total count of items (0 or 1)

typestringOptional

The type of cart (e.g., 'live')

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the live cart list or count
400
Invalid parameters
500
Internal server error
get
GET /backend/api/admin-cart HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>text</message>
</object>

Get cart details by ID

get

Retrieves the details of a specific cart by ID.

Path parameters
cartIdintegerRequired

The ID of the cart to retrieve

Query parameters
typestringOptional

The type of cart (e.g., 'live')

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully retrieved the cart details
400
Invalid cart ID or parameters
500
Internal server error
get
GET /backend/api/admin-cart/{cartId} HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>text</message>
</object>

Delete abandoned cart list

put

Deletes abandoned cart entries for specific customers based on customerId and guestIp.

Query parameters
actionstringRequired

The action to be performed (e.g., delete).

customerIdstringRequired

Comma-separated list of customer IDs for whom the abandoned cart details should be deleted.

guestIpstringRequired

Comma-separated list of guest IP addresses for whom the abandoned cart details should be deleted.

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Responses
200
Successfully deleted cart list
400
Invalid request parameters
500
Internal server error
put
PUT /backend/api/admin-cart/abandoned HTTP/1.1
Host: 139.59.67.17
Authorization: text
Accept: */*
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully Deleted Cart List...!</message>
</object>
  • GETGet vendor orders
  • GETGet order detail
  • GETGet vendor order status log list
  • GETGet order status list
  • GETExport vendor order details as PDF
  • POSTUpdate payment status of an order
  • GETGet back order list
  • GETGet failed order list
  • GETGet order details
  • POSTUpdate main order payment details
  • GETGet payment list
  • GETGet live cart list or count
  • GETGet cart details by ID
  • POSTSend email for abandoned cart
  • POSTExport cart data
  • PUTDelete abandoned cart list

Update payment status of an order

post

Updates the payment status for a specific order using the orderId and paymentStatusId.

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Body
orderIdstringOptionalExample: 1628
paymentStatusIdintegerOptionalExample: 1
Responses
200
Successfully updated the payment status
400
Invalid request payload
404
Order not found
500
Internal server error
post
POST /backend/api/order/update-payment-status HTTP/1.1
Host: 139.59.67.17
Authorization: text
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 38

"orderId='1628'&paymentStatusId=1"
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully updated the Payment Status</message>
</object>

Update main order payment details

post

This API updates the main order's payment status and related details.

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Body
orderIdintegerRequiredExample: 1619
paymentStatusintegerRequiredExample: 2
paymentMethodintegerRequiredExample: 1
paymentRefIdstringRequiredExample: 2432345
paymentDetailstringRequiredExample: ds
Responses
200
Successfully updated the order
400
Invalid request data
500
Internal server error
post
POST /backend/api/order/update-main-order HTTP/1.1
Host: 139.59.67.17
Authorization: text
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 98

"orderId=1619&paymentStatus=2&paymentMethod=1&paymentRefId='2432345'&paymentDetail='ds'"
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>Successfully updated your order</message>
</object>

Send email for abandoned cart

post

Sends an email notification to the customer regarding their abandoned cart.

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Body
idintegerRequired

The ID of the abandoned cart

messagestringRequired

The custom message to be sent with the email

Responses
200
Successfully sent the email
400
Invalid request parameters
500
Internal server error
post
POST /backend/api/admin-cart/abandoned-cart-email HTTP/1.1
Host: 139.59.67.17
Authorization: text
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 25

"id=1&message='text'"
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>text</message>
</object>

Export cart data

post

Exports the cart details for a given customer.

Header parameters
AuthorizationstringRequired

Bearer token for authentication.

Body
customerIdstringRequired

The ID of the customer whose cart needs to be exported.

Responses
200
Successfully exported cart data
400
Invalid request parameters
500
Internal server error
post
POST /backend/api/admin-cart/cart-export HTTP/1.1
Host: 139.59.67.17
Authorization: text
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 21

"customerId='text'"
<?xml version="1.0"?>
<object>
	<status>1</status>
	<message>text</message>
</object>