SRS Integration Partner Services
HomeV1 APIsV2 APIs
HomeV1 APIsV2 APIs
  1. Orders
  • Authentication
    • Token
      POST
  • Orders
    • Delivery Details
      GET
    • Deliveries list
      POST
    • Proof of Delivery
      GET
    • Order Details
      GET
    • Order list
      POST
    • Submit Order
      POST
  • Invoices
    • Invoice Details
      GET
    • Invoices List
      POST
    • Invoice PDF
      GET
  • Customers
    • Customer Details
      GET
    • Validate Customer
      GET
    • Nearest Eligible Branch
      GET
    • Ship to Address
      GET
    • Order Templates
      GET
  • Products
    • Pricing
      POST
  • Branches
    • Branch Details
      GET
    • Branch Active Items
      GET
  1. Orders

Submit Order

Deprecated
POST
/orders/submit
Submits a new order with the specified items, quantities, and customer details for processing.

Request

Header Params

Body Params application/json

Example
{
    "sourceSystem": "CutterCroix",
    "customerCode": "SPR276",
    "branchId": "247",
    "shipToSequenceNumber": 1,
    "shipTo": {
        "addressLine1": "1234 COUNTY LINE ROAD",
        "addressLine2": "",
        "addressLine3": "",
        "city": "ONTARIO",
        "state": "NY",
        "zipCode": "14519"
    },
    "accountNumber": "SPR276",
    "transactionID": "3932cdd6-38e7-4d19-a05c-cd866473bdea",
    "transactionDate": "2021-04-12T03:49:06",
    "notes": "Order Notes demo: Driveway<br /><br />BERGER PREMIUM F5 ALUMINUM DRIP EDGE 10' .019 - New Roof Metal<br/><b>Attachments were sent with this order:</b>",
    "billTo": {
        "addressLine1": "ROOFING INC.",
        "addressLine2": "620 Main St ",
        "addressLine3": "",
        "city": "ROCHESTER",
        "state": "NY",
        "zipCode": "14620"
    },
    "poDetails": {
        "poNumber": "5641-8",
        "reference": "",
        "jobNumber": "5641: 7GP",
        "orderDate": "2021-04-12",
        "expectedDeliveryDate": "2021-04-15",
        "expectedDeliveryTime": "Anytime",
        "orderType": "WHSE",
        "shippingMethod": "Ground Drop"
    },
    "orderLineItemDetails": [
        {
            "itemDescription": "GAF TIMBERLINE HDZ SG 3 BD/SQ",
            "customerItem": "GAF Timberline HDZ - Charcoal (Metric)",
            "option": "Charcoal",
            "itemCode": "GAF TIMBERLINE HDZ SG 3 BD/SQ",
            "quantity": 72,
            "UOM": "BD"
        },
        {
            "itemDescription": "GAF SEAL-A-RIDGE 12\" 25 LF/BD",
            "customerItem": "GAF Seal-A-Ridge - Charcoal (25')",
            "option": "Charcoal",
            "itemCode": "GAF SEAL-A-RIDGE 12\" 25 LF/BD",
            "quantity": 4,
            "UOM": "BD"
        },
        {
            "itemDescription": "GAF STORMGUARD 2 SQ/RL",
            "customerItem": "GAF StormGuard Ice & Water Shield (2 SQ)",
            "option": "",
            "itemCode": "GAF STORMGUARD 2 SQ/RL",
            "quantity": 6,
            "UOM": "RL"
        }
    ],
    "customerContactInfo": {
        "customerContactName": "John Dough",
        "customerContactAddress": {
            "addressLine1": "620 Main St",
            "addressLine2": "",
            "addressLine3": "",
            "city": "Rochester",
            "state": "NY",
            "zipCode": "14620"
        },
        "customerContactPhone": "5857274059",
        "customerContactEmail": "mike@example.net",
        "additionalContactEmails": []
    },
    "RoofHubPitch": "Testing Roof Pitch 3"
}

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/submit' \
--header 'Authorization: Bearer' \
--header 'Content-Type: application/json' \
--data-raw '{
    "sourceSystem": "CutterCroix",
    "customerCode": "SPR276",
    "branchId": "247",
    "shipToSequenceNumber": 1,
    "shipTo": {
        "addressLine1": "1234 COUNTY LINE ROAD",
        "addressLine2": "",
        "addressLine3": "",
        "city": "ONTARIO",
        "state": "NY",
        "zipCode": "14519"
    },
    "accountNumber": "SPR276",
    "transactionID": "3932cdd6-38e7-4d19-a05c-cd866473bdea",
    "transactionDate": "2021-04-12T03:49:06",
    "notes": "Order Notes demo: Driveway<br /><br />BERGER PREMIUM F5 ALUMINUM DRIP EDGE 10'\'' .019 - New Roof Metal<br/><b>Attachments were sent with this order:</b>",
    "billTo": {
        "addressLine1": "ROOFING INC.",
        "addressLine2": "620 Main St ",
        "addressLine3": "",
        "city": "ROCHESTER",
        "state": "NY",
        "zipCode": "14620"
    },
    "poDetails": {
        "poNumber": "5641-8",
        "reference": "",
        "jobNumber": "5641: 7GP",
        "orderDate": "2021-04-12",
        "expectedDeliveryDate": "2021-04-15",
        "expectedDeliveryTime": "Anytime",
        "orderType": "WHSE",
        "shippingMethod": "Ground Drop"
    },
    "orderLineItemDetails": [
        {
            "itemDescription": "GAF TIMBERLINE HDZ SG 3 BD/SQ",
            "customerItem": "GAF Timberline HDZ - Charcoal (Metric)",
            "option": "Charcoal",
            "itemCode": "GAF TIMBERLINE HDZ SG 3 BD/SQ",
            "quantity": 72,
            "UOM": "BD"
        },
        {
            "itemDescription": "GAF SEAL-A-RIDGE 12\" 25 LF/BD",
            "customerItem": "GAF Seal-A-Ridge - Charcoal (25'\'')",
            "option": "Charcoal",
            "itemCode": "GAF SEAL-A-RIDGE 12\" 25 LF/BD",
            "quantity": 4,
            "UOM": "BD"
        },
        {
            "itemDescription": "GAF STORMGUARD 2 SQ/RL",
            "customerItem": "GAF StormGuard Ice & Water Shield (2 SQ)",
            "option": "",
            "itemCode": "GAF STORMGUARD 2 SQ/RL",
            "quantity": 6,
            "UOM": "RL"
        }
    ],
    "customerContactInfo": {
        "customerContactName": "John Dough",
        "customerContactAddress": {
            "addressLine1": "620 Main St",
            "addressLine2": "",
            "addressLine3": "",
            "city": "Rochester",
            "state": "NY",
            "zipCode": "14620"
        },
        "customerContactPhone": "5857274059",
        "customerContactEmail": "mike@example.net",
        "additionalContactEmails": []
    },
    "RoofHubPitch": "Testing Roof Pitch 3"
}'

Responses

🟢200SubmitOrder SRS
application/json
Body

Example
{
    "message": "Order Submitted",
    "transactionID": "23423-346435634-B00012",
    "orderID": "33525021",
    "queueID": null
}
🟢200SubmitOrder SRS
Modified at 2025-09-25 13:16:38
Previous
Order list
Next
Invoice Details
Built with