Submit Order

Submit a new sales order to the SRS Distribution ERP system. Supports automatic branch assignment, Ship-To address resolution, and UOM conversion. Orders are processed directly to ERP or through a queue-based workflow based on customer configuration.

Order Submission Disclaimer

⚠️ Checkout Conditions (IMPORTANT)

The following conditions apply when submitting an order through the SubmitOrder API:

Condition	Description
Additional Charges	Additional charges may apply beyond the quoted line item prices
Sales Tax	Sales tax will be calculated at checkout based on delivery location
Pricing Variability	Pricing is subject to change between quote and order submission
Unit Conversion	Unit conversion may affect order totals (e.g., SQ to BD conversions)

Partners should:

Display these conditions to end users before order confirmation

Clearly communicate that final totals may differ from estimates

Provide a confirmation step acknowledging these conditions

Note: These conditions reflect standard business practices and ensure transparency in the ordering process.

Request

Header Params

Body Params application/json

Example

{
   "sourceSystem": "SOURCENAME",
   "customerCode": "DEMO001",
   "jobAccountNumber": 1,
   "branchCode": "BRRIV",
   "accountNumber": "DEMO001",
   "transactionID": "3932cdd6-38e7-4d19-a05c-cd866473bdea",
   "transactionDate": "2023-05-11T10:49:34.187",
   "notes": "",
   "shipTo": {
      "name": "John",
      "addressLine1": "1234 COUNTY LINE ROAD",
      "addressLine2": "",
      "addressLine3": "",
      "city": "ONTARIO",
      "state": "NY",
      "zipCode": "14519"
   },
   "poDetails": {
      "poNumber": "5641-8Test",
      "reference": "5641: 7GP",
      "jobNumber": "",
      "orderDate": "2021-04-12",
      "expectedDeliveryDate": "2021-04-15",
      "expectedDeliveryTime": "Anytime",
      "orderType": "WHSE",
      "shippingMethod": "Ground Drop"
   },
   "orderLineItemDetails": [
      {
         "productId": 75664,
         "productName": "CertainTeed Presidential Solaris Shingles",
         "option": "Country Gray",
         "quantity": 1,
         "price": 12,
         "customerItem": "XXXX",
         "uom": "SQ"
      },
      {
         "productId": 1443,
         "productName": "CertainTeed Landmark Solaris Non-AR Shingles",
         "option": "Burnt Sienna",
         "quantity": 1,
         "price": 12,
         "customerItem": "XXXX",
         "uom": "SQ"
      },
      {
         "productId": 75621,
         "productName": "CertainTeed SwiftStart Starter",
         "option": "N/A",
         "quantity": 1,
         "price": 12,
         "customerItem": "XXXX",
         "uom": "BD"
      }
   ],
   "customerContactInfo": {
      "customerContactName": "John Dough",
      "customerContactPhone": "9876543210",
      "customerContactEmail": "jdough@example.com",
      "customerContactAddress": {
         "addressLine1": "123 Main St",
         "city": "Salt Lake City",
         "state": "Utah",
         "zipCode": "84121"
      },
      "additionalContactEmails": [
         "test@example.com"
      ]
   }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://services-qa.roofhub.pro/orders/v2/Submit' \
--header 'Authorization: Bearer' \
--header 'Content-Type: application/json' \
--data-raw '{
   "sourceSystem": "SOURCENAME",
   "customerCode": "DEMO001",
   "jobAccountNumber": 1,
   "branchCode": "BRRIV",
   "accountNumber": "DEMO001",
   "transactionID": "3932cdd6-38e7-4d19-a05c-cd866473bdea",
   "transactionDate": "2023-05-11T10:49:34.187",
   "notes": "",
   "shipTo": {
      "name": "John",
      "addressLine1": "1234 COUNTY LINE ROAD",
      "addressLine2": "",
      "addressLine3": "",
      "city": "ONTARIO",
      "state": "NY",
      "zipCode": "14519"
   },
   "poDetails": {
      "poNumber": "5641-8Test",
      "reference": "5641: 7GP",
      "jobNumber": "",
      "orderDate": "2021-04-12",
      "expectedDeliveryDate": "2021-04-15",
      "expectedDeliveryTime": "Anytime",
      "orderType": "WHSE",
      "shippingMethod": "Ground Drop"
   },
   "orderLineItemDetails": [
      {
         "productId": 75664,
         "productName": "CertainTeed Presidential Solaris Shingles",
         "option": "Country Gray",
         "quantity": 1,
         "price": 12,
         "customerItem": "XXXX",
         "uom": "SQ"
      },
      {
         "productId": 1443,
         "productName": "CertainTeed Landmark Solaris Non-AR Shingles",
         "option": "Burnt Sienna",
         "quantity": 1,
         "price": 12,
         "customerItem": "XXXX",
         "uom": "SQ"
      },
      {
         "productId": 75621,
         "productName": "CertainTeed SwiftStart Starter",
         "option": "N/A",
         "quantity": 1,
         "price": 12,
         "customerItem": "XXXX",
         "uom": "BD"
      }
   ],
   "customerContactInfo": {
      "customerContactName": "John Dough",
      "customerContactPhone": "9876543210",
      "customerContactEmail": "jdough@example.com",
      "customerContactAddress": {
         "addressLine1": "123 Main St",
         "city": "Salt Lake City",
         "state": "Utah",
         "zipCode": "84121"
      },
      "additionalContactEmails": [
         "test@example.com"
      ]
   }
}'

Responses

🟢200Submit Order v2

application/json

Bodyapplication/json

Examples

Submit Order v2Submit Order V2 - 44083

{
    "message": "Order Submitted",
    "transactionID": "ANY-UNIQUE-STRING-02.19.2024.v2.4",
    "orderID": "35818786",
    "queueID": null
}

🟢201Submit Order V2 - 44083

🟢200Submit Order V2

Order Submission Disclaimer#

Request

Request Code Samples

Responses

Order Submission Disclaimer