Introduction

Welcome to the SRS Integration Partner System (SIPS)! This guide is designed to help software partners integrate with SRS Distribution and leverage our API services to enhance your business operations.

API Overview

Step 1: Get Client ID & Secret

The first step would be requesting a client ID and secret. This needs to be requested from SRS at APISupportTeam@srsdistribution.com.

Step 2: Authentication

This API allows you to retrieve a token, using your Client ID and Secret by calling the Authentication API /authentication/token. Once the token is generated, with that token you will be able to call the rest of our endpoints. The token expires after 24 hours.

Step 3: Branch Location

The next step would be to call the Branch Locations API /branches/v2/branchLocations, which provides a comprehensive list of all branches within SRS, locations and shipping methods.

Step 4: Customer Branch Locations

After gathering information from the Branch Locations API, you would be calling the Customer Branch Location API /branches/v2/customerBranchLocations/{customerCode}, which provides a comprehensive list of the nearest branch locations, from here you need to get the nearest branch location and the job account number.

Step 5: Active Branch Products

Now you need to call the Active Branch Products V2 API /branches/v2/activeBranchProducts/{branchCode} to get a list of the active products under the nearest branch you've gathered previously.

Step 6: Get Price

Then you would call the Get Price V2 API to get a list of product prices within SRS /products/v2/price.

Step 7: Submit Order

Finally, once you have all the information gathered previously (Branch Location, Shipping Method, Products Information and Job Account Number), you can submit an order at SRS by calling the Submit Order V2 API /orders/v2/submit.

Submitting an Order

There are two ways to submit orders, asynchronously (recommended) or synchronously.

Synchronous Order SubmissionIf you submit an order synchronously, you will receive an order ID and API response immediately.

Asynchronous Order SubmissionThis method is suggested as it is more reliable. We would be submitting the order, even if our ERP goes down. The order would stay in the queue until our ERP goes back online. This method uses webhooks for communication.

We hope this guide will assist you in integrating our APIs into your applications effectively. Happy coding!

API Server

https://services-qa.roofhub.pro

Authentication

No API key applied

API Overview#

Submitting an Order#

API Server#

Authentication#

API Overview

Submitting an Order

API Server

Authentication