Order API

Place Orders – PO Number limited to 16 characters

To ensure the full PO Number is retained throughout order processing, limit PO Number values to 16 characters or fewer when submitting orders through the Place Order endpoint. Validate and restrict PO Number length to 16 characters within your application before submitting orders.

NOTE: Orders containing PO Numbers longer than 16 characters will still be accepted by the API. However, downstream systems will automatically truncate the PO Number to 16 characters, which may result in loss of information.

Now Available

Order API

Place Orders – Delivery Instructions increased to 255 characters

The Place Orders endpoint now allows up to 255 characters to be sent for the deliveryAppointment.instructions field.

NOTE: Once the order is sent to the branch, the branch will need to reduce the delivery message to 25 characters to store in our ERP. They will shorten and abbreviate as needed to convey the message to their delivery personnel. Please expect possible changes to the original delivery instructions by the branch associates after the order is submitted.

Now Available

Product API

Get Frequent Items – FamilyId Added to Response

The familyId is now returned for each item in the Get Frequent Items response. Please see the example below.

{
    "pagination": {
        "pageNumber": 1,
        "pageCount": 100,
        "pageSize": 1,
        "totalCount": 100
    },
    "items": [
        {
            "itemNumber": "58FSIS3048",
            "branchNumber": 28,
            "familyId": "PFam_3475276",
            "isAvailableForBranch": true,
            "isFavorite": false,
            "count": 29,
            "itemDescription": "Elevate 3.0 Iso 4' X 8'",
            "uom": "SH  -  Sheet",
            "dimensions": [
                {
                    "width": {
                        "value": 0,
                        "uom": null,
                        "description": "Width"
                    },
                    "thickness": {
                        "value": 0,
                        "uom": null,
                        "description": "Thickness"
                    }
                }
            ]
        }
    ]
}

Order API

Place Orders – Validation for Orders with More Than 99 Items

ABC Supply does not currently accept orders with more than 99 items on our old ERP system. For accounts limited by this situation, the following error will be returned in our Place Orders endpoint:

202 ACCEPTED

{
    "request": {
        "batchId": "B11558177",
        "recievedTime": "2025-08-13T16:17:07.797",
        "ordersReceived": 1,
        "ordersFailed": 1,
        "ordersSucceded": 0
    },
    "orders": [
        {
            "requestId": "1755119826424",
            "confirmationNumber": null,
            "message": "\"Orders are limited to less than 100 line items for this account. Please reduce the number of line items and resubmit your order.\""
        }
    ]
}

Now Available

Order API

Place Order – Validation for Accounts and Branches on Same ERP System

ABC Supply is currently migrating to a new ERP system. As branches migrate, new customer account numbers are created for existing customers since the new ERP system cannot recognize legacy account numbers. To prevent order failures, we’ve enhanced the Place Orders endpoint with validation that ensures both the branch and customer account numbers originate from the same ERP system before processing your order.

If an order is submitted with an ERP mismatch, the Place Order response will have a status code of 202 Accepted but the “ordersFailed” field will have a count of 1 for every order from the request that failed. The error message returned will be the following:

"The branch <branchNumber> and shipTo number <shipToNumber> do not match the same ERP System. Please try a different shipTo number and branch."

Product API

Get All Items – Delta Load Functionality

We’ve added a product catalog delta load feature that significantly reduces catalog processing time by retrieving only items that have been updated since a provided date. Use the “sinceLastModifiedDateTime” query parameter with ISO 8601 value format of “YYYY-MM-DDThh:mm:ss.000Z” to specify the datetime from which you would like to receive the most recent product catalog updates.

The delta load feature uses the item “status” field to track changes, including items that may have been marked as “Inactive” since your last catalog sync. While the full catalog ingest only returns “Active” items, the delta load feature will return both “Active” and “Inactive” items to account for any items that have been removed from the catalog.

Important: You must filter out “Inactive” items before displaying results to your users.

Get All Items – “marketingDescription” Now Available

Get All Items now returns an extended description of select items in the new “marketingDescription” field. If a description is not available for an item, the value returned will be null.

Due to some exciting changes in our development group, we will not be releasing any new features this week. The next planned production release will be 2025.05.27 after business hours.