Pricing API
Retrieve current pricing on one or more ABC Supply product items in real time to easily create estimates and place orders.
Please ensure that your use of this API endpoint complies with the API Terms of Use. Using the ABC Supply API to offer price comparisons with competitive third-party services is in violation of the API Terms of Use.
The Price Items endpoint returns pricing information for products available for a given account and branch location. The price is provided as a number with a localized currency symbol, and ISO 4217 currency code for currency conversion purposes. The request must include branch number, Ship-To account number, request purpose, item number, and quantity to price. Multiple line items may be priced at one time.
This endpoint does not reflect real-time availability of the products. Please use the Product Availability endpoints to determine real-time product availability.
NOTE
The Price Items endpoint will return a 200 OK status for an item with price of $0.00 when the item is available at an ABC Supply branch but pricing has not been entered into the ABC Supply branch’s pricing system. Pricing is set by each ABC Supply branch location, and the customer will need to contact the specific branch to get pricing for the item.
PRicing API
Price Items
POST /prices
Get real-time customer-specific pricing
Sandbox
Production
Authorization
For Individuals and Businesses, use OAuth 2.0 server or user token with the pricing.read scope.
For Third-Party Aggregators, use OAuth 2.0 user token with the pricing.read scope.
Request
Name
Type
Description
requestId
string
The client-provided request ID to track the price request. Can only be returned if supplied in the request body.
shipToNumber
string
The ship-to account number for the pricing request.
branchNumber
string
The ABC Supply branch number identifying the branch location sourcing the item.
purpose
enum
The purpose of the price request. Available enum values: “estimating”, “quoting”, “ordering”.
lines
array
The list of line items being priced. NOTE: that there is a limit of 50 objects in the lines array.
lines[].id
string
The unique ID of the line.
lines[].itemNumber
string
The ABC Supply item number for the item to price.
lines[].quantity
integer
The quantity of items to be priced.
lines[].uom
string
The unit of measure for the line item. If not provided, will default to the costing unit of measure for the item.
lines[].length
object
The object containing the information about the length of the line item. This object is required for dimensional item pricing and should not be included for non-dimensional items.
lines[].length.value
float
The length of the dimensional line item. This value must match an existing length variation of the dimensional item.
lines[].length.uom
enum
The unit of measure of the dimensional line item. This value much match an existing variation of the dimensional item. Available enum values:
• “ft”, “feet”, “Feet”
• “in”, “inch”, “Inch”, “inches”, “Inches”
Example Request
Price Items request for a single dimensional item
POST /api/pricing/v2/prices HTTP/1.1
Host: partner.abcsupply.com
Authorization: Bearer <TOKEN>
{
"requestId": "Quote: 312345",
"shipToNumber": "1008710",
"branchNumber": "441",
"purpose": "ordering",
"lines": [
{
"id": "1",
"itemNumber": "02GAFSL3AS",
"quantity": 10,
"uom": "BD",
"length": {
"value": 4,
"uom": "in"
}
}
]
}Response
Example Response
Price Items response payload for a single dimensional item
{
"requestId": "Quote: 312345",
"shipToNumber": "1008710",
"branchNumber": "441",
"purpose": "ordering",
"lines": [
{
"id": "1",
"itemNumber": "02GAFSL3AS",
"quantity": 10,
"uom": "BD",
"unitPrice": 81.25,
"currency": {
"code": "USD",
"symbol": "$"
},
"length": {
"value": 4,
"uom": "in"
},
"status": {
"code": "OK",
"message": "Priced Successfully"
}
}
]
}Name
Type
Description
requestId
string
The client-provided request ID to track the price request. Can only be returned if supplied in the request body.
shipToNumber
string
The ship-to account number for the pricing request.
branchNumber
string
The ABC Supply branch number for the branch location sourcing the item
purpose
enum
The purpose of the price request (e.g., “estimating”, “quoting”, “ordering”).
lines
array
The list of line items being priced.
lines[].id
string
The unique ID of the line.
lines[].itemNumber
string
The ABC Supply item number for the item to price.
lines[].quantity
integer
The quantity of items to be priced.
lines[].uom
string
The unit of measure for the line item. Use the product API to determine the meaning of each unit of measurement code (e.g., “PC”: Pieces, “CT”: Cartons).
lines[].unitPrice
float
The price per unit of the item. Please note that 0.00 is a successful price of an item. The person requesting pricing should contact the ABC Supply branch directly to get assistance with pricing.
lines[].currency
object
The object containing the information about the currency for the item price.
lines[].currency.symbol
float
The currency symbol for the price amount (e.g., “$”).
lines[].length
object
The object containing the information about the requested length variation of a dimensional line item. Will only be returned if supplied in the request body.
lines[].length.value
float
The length variation of the dimensional line item provided in the request body.
lines[].length.uom
string
The unit of measure of the length variation (e.g., “ft”: “feet:, “Feet” “in”, “In”, “inches”, “Inches”).
lines[].status
object
The object containing the information about the status of the price request.
lines[].status.code
string
Code indicating the status of the price request (e.g., “OK”).
lines[].status.message
string
Message indicating the outcome of request (e.g., “Priced successfully”, “Error: not found”). NOTE: HTTP status code 200 will be returned regardless of errors within line items.
HTTP Status Codes
Code
Status
Description
200
OK
The request and response were successfully sent. Please check the lines[].status.code and lines[].status.message to ensure the item was priced successfully.
400
Bad Request
Confirm the request body and parameters are valid and formatted correctly.
401
Unauthorized
The user does not have access to the provided ship-to number.
403
Forbidden
The authorization scopes are not valid for the pricing request
500
Internal Server Error
The server was unable to process the request.
Additional Examples
Example Request
Price Items request for a single non-dimensional item
POST /api/pricing/v2/prices HTTP/1.1
Host: partner.abcsupply.com
Authorization: Bearer <TOKEN>
{
"requestId": "Quote: 312346",
"shipToNumber": "1008710",
"branchNumber": "441",
"purpose": "ordering",
"lines": [
{
"id": "1",
"itemNumber": "02GASTZ3WW",
"quantity": 1,
"uom": "SQ",
}
]
}Example Response
Price Items response payload for a single non-dimensional item
{
"requestId": "Quote: 312346",
"shipToNumber": "1008710",
"branchNumber": "441",
"purpose": "ordering",
"lines": [
{
"id": "1",
"itemNumber": "02GASTZ3WW",
"quantity": 1,
"uom": "SQ",
"unitPrice": 135.36,
"currency": {
"code": "USD",
"symbol": "$"
},
"length": {
"value": 4,
"uom": "in"
},
"status": {
"code": "OK",
"message": "Priced Successfully"
}
}
]
}Example Request
Response with invalid item
POST /api/pricing/v2/prices HTTP/1.1
Host: partner.abcsupply.com
Authorization: Bearer <TOKEN>
{
"requestId": "Quote: 312346",
"shipToNumber": "1008710",
"branchNumber": "441",
"purpose": "ordering",
"lines": [
{
"id": "1",
"itemNumber": "02GASTZ3WW",
"quantity": 1,
"uom": "SQ",
"length": {
"value": 4,
"uom": "in"
}
},
{
"id": "2",
"itemNumber": "AAE23AL?",
"quantity": 1,
"uom": "PC"
}
]
}Example Response
Price Items response payload for two items, with one invalid item in request
{
"requestId": "Quote: 312346",
"shipToNumber": "1008710",
"branchNumber": "441",
"purpose": "ordering",
"lines": [
{
"id": "1",
"itemNumber": "02GASTZ3WW",
"quantity": 1,
"uom": "SQ",
"unitPrice": 135.36,
"currency": {
"code": "USD",
"symbol": "$"
},
"length": {
"value": 4,
"uom": "in"
},
"status": {
"code": "OK",
"message": "Priced Successfully"
}
},
{
"id": "2",
"itemNumber": "AAE23AL?",
"quantity": 1,
"uom": "PC",
"unitPrice": 0.00,
"currency": {
"code": "USD",
"symbol": "$"
},
"status": {
"code": "Error",
"message": "Cannot price item AAE23AL?. Call for pricing."
}
}
]
}