SRS Integration Partner Services
HomeV1 APIsV2 APIs
HomeV1 APIsV2 APIs
  1. SRS API Guides
  • SRS Integration Partner Services (SIPS)
  • Getting Started
    • Introduction
    • Web Hooks
    • FAQs
  • SRS API Guides
    • Authentication
    • Reference Data
    • Product Data
    • Invoices
    • Orders
    • Order Details
  1. SRS API Guides

Orders

Submit Order#

The Submit Order API is a transactional API that allows users to place orders with SRS. It provides two options for submission: one for synchronous submission of orders and another for asynchronous. Using asynchronous along with the associated webhooks is preferred. This guide will help you understand how to use the Orders API effectively and handle common scenarios where an order might be rejected.

Purpose of the Orders API#

The Orders API is designed to facilitate the placement of orders with SRS. By integrating with this API, partners can automate order processing, ensuring accurate and timely order placement.

How It Should Be Used#

1.
Asynchronous Order Submission: The order will be placed in a queue and an update will be sent to your webhook on submission
2.
Synchronous Order Submission: The order will be submitted directly to our ERP. The API will return a success or failure message.

Error Codes and Actions for Orders#

Error CodeDescriptionAction to Take
400Invalid Input / ObjectVerify the request payload and ensure all required fields are present with correct data formats. Review the API documentation for business rules and adjust the request accordingly.
401Unauthorized / Authentication RequiredProvide valid authentication credentials. If using tokens, refresh them if expired and retry the request.
404Resource Not FoundVerify that the requested resource (such as entity ID or endpoint) exists and is correctly specified. Check spelling, IDs, or endpoint paths before retrying.
500System ErrorTry again later. If the issue persists, contact technical support with error details for investigation.
GeneralErrorGeneric Failure / Unexpected ErrorRetry the operation. If the error recurs, capture the error details and contact technical support, as this indicates an unknown or unexpected issue.
FieldsMissingFromRequestBodyMissing Required Fields in RequestInclude all mandatory fields in the request payload. Refer to the API documentation for the complete list of required parameters.
Orders_GeneralErrorGeneral Order Processing ErrorReview the request for order-specific inputs such as order IDs, statuses, or item details. If the error persists despite valid input, escalate to technical support for domain-specific troubleshooting.
Modified at 2025-09-29 09:55:18
Previous
Invoices
Next
Order Details
Built with