SRS Integration Partner Services
HomeV1 APIsV2 APIs
HomeV1 APIsV2 APIs
  1. Orders
  • Authentication
    • Token
      POST
  • Products
    • Catalog
      GET
    • By Item Codes
      POST
    • Price
      POST
    • catalog Item Convert
      POST
    • Color Recommendations
      POST
  • Deliveries
    • Coordinates
      GET
  • Branches
    • Branch Locations
      GET
    • Active Branch Products
      GET
    • Customer Branch Locations
      GET
  • Customers
    • OrderTemplates
      GET
  • Orders
    • Submit Order
      POST
  1. Orders

Submit Order

POST
/orders/v2/Submit
Submit an order to Agility

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '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
Body

Example
{
    "message": "Order Submitted",
    "transactionID": "ANY-UNIQUE-STRING-02.19.2024.v2.4",
    "orderID": "35818786",
    "queueID": null
}
🟢201Submit Order V2 - 44083
🟢200Submit Order V2
Modified at 2025-09-25 12:58:00
Previous
OrderTemplates
Built with