Price Items

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

POST /prices

Get real-time customer-specific pricing

Sandbox

Resource:

POST

https://partners-sb.abcsupply.com/api/pricing/v2/prices

Production

Resource:

POST

https://partners.abcsupply.com/api/pricing/v2/prices

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"
            }
        }
    ]
}

Expand

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"
            }
        }
    ]
}

Expand

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.code

string

ISO 4217 currency code of the price amount.

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

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",
        }
    ]
}

Expand

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"
            }
        }
    ]
}

Expand

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"
        }
    ]
}

Expand

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."
            }
        }
    ]
}

Expand