Developer Guide

Use the Developer Guide to find the onboarding process steps, information about authentication methods, and a comprehensive list of the available ABC API endpoints.

Developer Guide

Release Notes

  • 2025.05.12 Release

    Now Available

    Order API

    Place Order – Validation for Unique requestId in Multi-Order Requests

    The Place Order endpoint has improved validation of duplicate requestId values.

    New error message for duplicate requestId values:

    202 ACCEPTED
    ---
    {
        "request": {
            "batchId": "B11403496",
            "recievedTime": "2025-05-13T12:35:53.447",
            "ordersReceived": 2,
            "ordersFailed": 1,
            "ordersSucceded": 1
        },
        "orders": [
            {
                "requestId": "123",
                "confirmationNumber": "C10-12768726",
                "message": "Ordered successfully"
            },
            {
                "requestId": "123",
                "confirmationNumber": null,
                "message": "Error: requestId must be unique"
            }
        ]
    }

    Account API

    Get Ship-To – homeBranch flag for Ship-To Account Branches

    The flag “homeBranch” is now available on each branch in the “branches” array of the Get Ship-To response.

    "branches": [
        {
            "homeBranch": false,
            "number": "300",
            "name": "ABC Supply - Bryan, TX",
            "storefront": "abc",
            "status": "active",
            "type": "Branch",
            "links": {
                "self": "https://api3-sb.abcsupply.com/int-partners-location/api/location/v1/branches/300"
            }
        },
    ...
    ]

    Product API

    Get All Items / Get Item / Search Items – Removed Extra UOM Types

    Product API endpoints now return a limited set of UOM types: “stocking”, “costing”, and “estimate”. The most commonly used UOM type for pricing and ordering is “stocking”; however, “costing” and “estimate” will provide additional UOMs that some customers may find valuable.

    Get All Items / Get Item / Search Items – Enhanced “status” Field

    The “status” field in the Product API endpoints has been enhanced to combine several additional flags that determine whether or not an item should be offered to customers via the APIs. If an item has a status of “Inactive”, it should not be made available to customers as these items are not sellable via the APIs. If the item has a status of “Active”, it is sellable and can be included in your integration’s product offerings. All items should return as “status”: “Active” for these endpoints except the case noted in the Upcoming Release notes below (Get All Items – Enhanced Delta Load Functionality).

    Get All Items – Improved Ordering of Items in Response

    Get All Items responses are now ordered by a new key that allows for more reliable item ordering and better performance.

    Upcoming Release2025.05.19

    Product API

    Get All Items – New Field “marketingDescription” Now Available

    We’ve added a new field called “marketingDescription” to the item schema that returns the marketing copy used on our customer platform. This is available for most items, but may return as an empty string when not available from our item management system. Currently, this text contains new line characters (“\n”) but we will be removing those in another upcoming release.

    Get All Items – Enhanced Delta Load Functionality

    Get All Items will be able to return only items that have been updated since the datetime provided in an optional query parameter called “sinceLastModifiedDateTime” with ISO 8601 value format of “YYYY-MM-DDThh:mm:ssZ”. The request will return all updated items regardless of “status” value of “Active” or “Inactive”. This allows integrators to account for any items that may have changed from “Active” to “Inactive”. The “Inactive” items should be filtered out of the items shown to customers in your integration.

  • 2025.05.07 Release

    Now Available

    Order API

    Place Order – “Double” Type for Item Quantities

    The Place Order endpoint now accepts the “double” type for item quantities.

    Place Order – Validation for Non-Sellable Accounts

    We now validate orders to ensure the ship-to account for the order is in a sellable status. If the ship-to account is non-sellable, the Place Order endpoint will return the following error message:

    {
        "request": {
            "batchId": "B12345",
            "recievedTime": "2025-05-07T15:54:28.26",
            "ordersReceived": 1,
            "ordersFailed": 1,
            "ordersSucceded": 0
        },
        "orders": [
            {
                "requestId": "12345",
                "confirmationNumber": null,
                "message": "Error: Order Unsuccessful - Ship-To account number  is non-sellable due to credit hold. Please contact your ABC Supply Branch to resolve the issue."
            }
        ]
    }

    Pricing API

    Price Items – 50 Item Limit

    In order to improve performance on the Price Items endpoint, we have limited the number of items that can be priced in one request to 50 items.

    Account API

    Search Accounts – “isSellable” Flag

    We now filter inactive accounts from the Search Accounts results and expose a new flag called “isSellable”. This flag indicates if an account is on credit hold. Users with accounts on credit hold may view accounts, orders, and products, and pricing, but will not be able to place orders against their non-sellable account(s).

    Upcoming Release2025.05.12

    Product API

    Get All Items – Delta Loading Feature and “Status” Flag

    We are currently working on enhancements to improve the delta loading feature of our Get All Items endpoint. This will allow integrators to request only items that have been updated since a specified date-time. The “status” flag on each item will indicate whether or not the item is available for purchase through the APIs.

    In order to take advantage of this feature, integrators will want to allow access to each item conditionally based on the value of he “status” flag for all items, as discontinued items or those no longer available for sale via the APIs will have an “Inactive” status.

    Pricing API

    Price Items – “Double” Type for Item Quantities

    The Price Items endpoint will soon accept “double” type for item quantities.