Notification API
Subscribe to ABC Supply updates such as order and shipment status. The Notification API allows you to configure webhooks and let ABC Supply push updates to your system in real time.
Order Invoiced Event is the payload sent to a partner webhook registered with the ABC API Notification API for invoice notifications. Events are triggered when an invoice is created for an order placed from the integration. The event payload includes invoice details, account details, order details, and shipment details.
INVOICE API
Order Invoiced Event
Order Invoiced Event
Receive invoice notifications to a registered webhook
Authorization
When a webhook is successfully registered for “ORDER_INVOICED” events, the registration response includes a “secret” value. This secret appears in the “Authorization” header of every Order Invoiced Event sent to the webhook endpoint. The secret can be used to verify that incoming webhook requests are authentic and originating from the system.
Response
Example Response
Order Invoiced Event response payload received by registered webhook
{
"event": "OrderInvoiced",
"eventType": "OrderInvoiced",
"webhookDetails": [
{
"apiKey":"ZGM0NzkwYTgtNzFiYy00YTdlLTliMjItMzFhOGEwZWY4Y2I=",
"webhookUrl": "https://www.partnerwebsite.comm",
"domain": "ORDER",
"registeredEvents": [
"ORDER_INVOICED"
]
}
],
"data": {
"storeFront": "abc",
"invoiceNumber": "2002668589-001",
"invoiceDate": "2025-10-28T00:00:00.000Z",
"orderNumber": "2002668589",
"orderName": "Test Order",
"orderDate": "2025-10-03T00:00:00.000Z",
"purchaseOrderNumber": "123445533",
"salesType": "DELIVERY",
"salesRep": {
"userId": null,
"fullName": "House - Murray"
},
"soldTo": {
"number": "2011865",
"name": "Team Dm Construction",
"addressLine1": "840 N Merno St",
"addressLine2": null,
"addressLine3": null,
"city": "Salt Lake City",
"state": "UT",
"country": "USA",
"postal": "84116-3829"
},
"billTo": {
"number": "2011865-1",
"name": "Team Dm Construction",
"addressLine1": "840 N Merno St",
"addressLine2": null,
"addressLine3": null,
"city": "Salt Lake City",
"state": "UT",
"country": "USA",
"postal": "84116"
},
"shipTo": {
"number": "2011865-2",
"name": "Team Dm Constructionshop",
"addressLine1": "840 N Merno St",
"addressLine2": null,
"addressLine3": null,
"city": "Salt Lake City",
"state": "UT",
"country": "USA",
"postal": "84116"
},
"branch": {
"number": "118",
"name": "118 Murray, UT",
"addressLine1": "5602 S 300 W",
"addressLine2": "PO Box 572545 (zip 84157)",
"city": "Murray",
"state": "UT",
"country": "USA",
"postal": "84107-5901",
"phone": "(801)241-3888"
},
"shipment": {
"shipmentDate": "2025-10-28T00:00:00.000Z",
"delivery": {
"name": "Test Order",
"addressLine1": "123 ABC Pkwy",
"addressLine2": null,
"addressLine3": null,
"city": "Beloit",
"state": "WI",
"country": "USA",
"postal": "53511-4179"
}
},
"subTotal": 137.8,
"taxAmount": 14.12,
"total": 151.92,
"lines": [
{
"id": 1,
"itemNumber": "0170030031",
"itemType": "standard",
"isDimensional": false,
"itemDescription": "0170030031 Paint ABC Roof Acces Dark Brown",
"orderedQty": {
"value": 20,
"uom": "CN"
},
"shippedQty": {
"value": 20,
"uom": "CN"
},
"priceQty": {
"value": 20,
"uom": "CN",
"priceConversionFactor": 1
},
"pricePerUnitAmount": 6.89,
"extendedPriceAmount": 137.8
}
],
"isCreditMemo": false,
"isRebill": false,
"originalInvoiceReference": null,
"creditRebillReason": ""
}
}Name
Type
Description
event
string
The event received by the webhook (e.g., “OrderInvoiced”).
eventType
string
The type of event received by the webhook (e.g., “OrderInvoiced”).
webhookDetails
array
The object describing the webhook details.
webhookDetails[].apiKey
string
The API key or “secret” for the registered webhook.
webhookDetails[].webhookUrl
string
The URL of the registered webhook.
webhookDetails[].domain
string
The event domain of the registered webhook.
webhookDetails[].registeredEvents
array
The customer-provided purchase order number of the invoiced order.
data
object
The object containing the invoice data.
data.storeFront
string
The storefront where the order was invoiced (e.g., “abc”, “lw”).
data.invoiceNumber
string
The unique invoice number for the invoice.
data.invoiceDate
string
The date the order was invoiced.
data.orderNumber
string
The order number of the invoiced order.
data.orderName
string
The order or job name of the invoiced order.
data.orderDate
string
The date the invoiced order was placed.
data.purchaseOrderNumber
string
The customer-provided purchase order number of the invoiced order.
data.salesType
string
The sales type for the order.
data.salesRep
object
The object describing the sales representative info for the order.
data.salesRep.userId
string
The unique user ID of the sales representative (null if not assigned).
data.salesRep.fullName
string
The full name of the sales representative.
data.soldTo
object
The object describing the customer Sold-To account.
data.soldTo.number
string
The Sold-To account number.
data.soldTo.name
string
The Sold-To account name.
data.soldTo.addressLine1
string
The Sold-To account address line 1.
data.soldTo.addressLine2
string
The Sold-To account address line 2.
data.soldTo.addressLine3
string
The Sold-To account address line 3.
data.soldTo.city
string
The Sold-To account city.
data.soldTo.state
string
The Sold-To account state.
data.soldTo.country
string
The Sold-To account country.
data.soldTo.postal
string
The Sold-To account postal code.
data.billTo
object
The object describing the customer Bill-To account.
data.billTo.number
string
The Bill-To account number.
data.billTo.name
string
The Bill-To account name.
data.billTo.addressLine1
string
The Bill-To account address line 1.
data.billTo.addressLine2
string
The Bill-To account address line 2.
data.billTo.addressLine3
string
The Bill-To account address line 3.
data.billTo.city
string
The Bill-To account city.
data.billTo.state
string
The Bill-To account state.
data.billTo.country
string
The Bill-To account country.
data.billTo.postal
string
The Bill-To account postal code.
data.shipTo
object
The object describing the customer Ship-To account.
data.shipTo.number
string
The Ship-To account number.
data.shipTo.name
string
The Ship-To account name.
data.shipTo.addressLine1
string
The Ship-To account address line 1.
data.shipTo.addressLine2
string
The Ship-To account address line 2.
data.shipTo.addressLine3
string
The Ship-To account address line 3.
data.shipTo.city
string
The Ship-To account city.
data.shipTo.state
string
The Ship-To account state.
data.shipTo.country
string
The Ship-To account country.
data.shipTo.postal
string
The Ship-To account postal code.
data.branch
object
The object describing the ABC Supply branch.
data.branch.number
string
The ABC Supply branch number.
data.branch.name
string
The ABC Supply branch name.
data.branch.addressLine1
string
The ABC Supply branch address line 1.
data.branch.addressLine2
string
The ABC Supply branch address line 2.
data.branch.city
string
The ABC Supply branch city.
data.branch.state
string
The ABC Supply branch state.
data.branch.country
string
The ABC Supply branch country.
data.branch.postal
string
The ABC Supply branch postal code.
data.branch.phone
string
The ABC Supply branch phone number.
data.shipment
object
The object describing the shipment details.
data.shipment.shipmentDate
string
The date the order was shipped.
data.shipment.delivery
string
The object describing the delivery details of the shipment.
data.shipment.delivery.name
string
The shipment delivery name.
data.shipment.delivery.addressLine1
string
The shipment delivery address line 1.
data.shipment.delivery.addressLine2
string
The shipment delivery address line 2.
data.shipment.delivery.addressLine3
string
The shipment delivery address line 3.
data.shipment.delivery.city
string
The shipment delivery city.
data.shipment.delivery.state
string
The shipment delivery state.
data.shipment.delivery.country
string
The shipment delivery country.
data.shipment.delivery.postal
string
The shipment delivery postal code.
data.subTotal
float
The subtotal for the invoice.
data.taxAmount
flaot
The tax amount for the invoice.
data.total
float
The total for the invoice.
data.lines
array
The list of line items included in the invoice.
data.lines[].id
number
The line item id.
data.lines[].itemNumber
string
The item number for the line item.
data.lines[].itemType
string
The item type of the line item.
data.lines[].isDimensional
boolean
A boolean stating whether or not the item is a dimensional item.
data.lines[].itemDescription
string
The item description of the line item.
data.lines[].orderedQty
object
The object containing the ordered quantity details for the line item.
data.lines[].orderedQty.value
integer
The ordered quantity value of the line item.
data.lines[].orderedQty.uom
string
The ordered quantity unit of measure of the line item.
data.lines[].shippedQty
object
The object containing the shipped quantity details for the line item.
data.lines[].shippedQty.value
integer
The shipped quantity value of the line item.
data.lines[].shippedQty.uom
string
The shipped quantity unit of measure of the line item.
data.lines[].priceQty
object
The object containing the price quantity details for the line item.
data.lines[].priceQty.value
integer
The price quantity value of the line item.
data.lines[].priceQty.uom
string
The price quantity unit of measure of the line item.
data.lines[].priceQty.priceConversionFactor
float
The price quantity price conversion factor of the line item.
data.lines[].pricePerUnitAmount
float
The price per unit amount of the line item.
data.lines[].extendedPriceAmount
float
The extended price amount of the line item.
isCreditMemo
boolean
A boolean stating whether or not the invoice is a credit memo.
isRebill
boolean
A boolean stating whether or not the invoice is a rebill for a shipment.
originalInvoiceReference
string
The original invoice number if the order is a credit memo or rebill.
creditRebillReason
string
The provided reason for a rebill invoice, if applicable.
HTTP Status Codes
Code
Status
Description
200
OK
The request and response were successfully sent.
400
Bad Request
Confirm the request body and parameters are formatted correctly.
403
Forbidden
The user account does not have access to view data based on provided request parameters.
404
Not Found
The data requested was not found. Please verify the request parameters are correct.
502
Bad Gateway
The server was unable to complete the request due to upstream errors. Try again shortly.