Item Availability

ABC Supply uses availability for item management instead of stock or inventory. Inventory at ABC Supply branches is dynamic, as branches can source from multiple locations to fulfill an order. However, not all ABC Supply branches have the same product offering, and each item is set up in their system locally if they choose to carry it. Item availability determines whether or not a given branch offers the item.

If the preferred branch does not offer an item, they can be contacted directly to discuss offering the item in the future.

Product Families

Product families are the lowest level of categorization of items and are a subcategory of brand line. Every item belongs to a product family, often with items of the same type but different colors, dimensions, or finishes.

When items are initially brought into our catalog, or as items are discontinued, they are moved into temporary “parking lot” families that have a product family ID beginning with “PLot_”. The items in these families can be retrieved, priced, and ordered, but searching on “parking lot” family items is limited. You cannot search for items by family ID in our Search Items endpoint if the family ID begins with “PLot_”. “Parking lot” families also do not have a product family name, as they are a miscellaneous collection of items. It is important to note this if you plan to design functionality around family items.

If an integration design includes displaying related family items when an item is selected, it is important to note that the family items returned in the Product API endpoints are not verified for availability at the user’s branches. The integration should filter any family item results by availability of those items at the users branches before display the results to the user.

Units of Measure

Units of measure used for pricing and ordering are costing and stocking. For example, shingles will return the following units of measure:

• Costing: Square (SQ)
• Stocking: Bundle (BD)

Additional unit of measure descriptions are provided in the Product API response if your integration calls for different UOM types.

Proposition 65 Requirements and Display

During the ABC Supply item intake process, items go through attribute enrichment. During the process, items may be made available for sale before all attributes are added to the items (see “parking lot” items in Product Families above). One of the attributes that is added to items during this process is Proposition 65 information that satisfies the California state law’s requirements for hazardous materials. If this information has not yet been added to an item’s attributes, ABC Supply is prohibited from selling these items through California branches or to delivery locations in California. Our Order API Place Orders endpoint will verify that items, branches, and delivery addresses meet these requirements prior to submitting an order; if the verification fails, the endpoint will return an error with information about the product in question.

$0 Price For Items

ABC Supply branches decide which items to offer at their stores and the price of those items. Occasionally, items are added to a branch’s offering before pricing is set up in their price system. This results in a successful response from the ABC Supply Pricing API endpoint with a $0 price for the item. When this occurs, integrators should direct users who are attempting to price the item to reach out to the branch location directly to request pricing for the item. The $0 price for the item does not prevent them from ordering the item, but pricing will be adjusted by the branch before the order is fulfilled, and it is customary for the branch to contact the customer prior to accepting the order with the updated price.

Units of Measure

For pricing, the request can optionally include a unit of measure for the item(s) in the request. If a unit of measure is not provided, the request will default to the stocking unit of measure.

Pricing Dimensional Items

As mentioned in the Products section, dimensional items must have a valid variation specified in the pricing call in order to price the item successfully. Variation information included with a non-dimensional item will not affect pricing.

Ship-To Object

The Ship-To object in Order API Place Orders endpoint combines two concepts:

• Ship-To number, which is the Ship-To account number for which the order is placed
• Ship-To name, address, and contacts, which are the delivery-related fields for the order

Please ensure that the name, address, and contacts correspond to the delivery information for the order and not the Ship-To account information, unless the order is being delivered to the Ship-To account.

Order Comments

Comments can be added to an order as either order-level comments or line-level comments. These will be available for the branch associates to review and will stay with the order as it moves through fulfillment.

Custom Items

Invalid item numbers are allowed to pass through to our order management system, because sometimes customers would like to request an item without knowing the item number. Information can be shared with the branch using the “itemNumber” or “description” fields in the line item section of the order. The branch associate will contact the order submitter if they have any additional questions about the request.

Delivery Methods

Each branch determines their available delivery methods and additional services they provide. In order to offer the most up-to-date options, please check the “services” array in Locations API Get Branch by Branch Number. Services such as “Express Pickup”, “Rooftop Delivery”, and “Covered Ground Drops” will be listed in this section if available.

Incorrect Pricing in Orders

If pricing provided in the order submitted via the Order API does not match the pricing in our system at the time the order was placed, the price of the item is updated automatically in our order management system. To provide the best user experience, it is imperative to validate real-time pricing prior to placing an order. The branch associates can view the price from the original order request within the order management system.

Dimensional Items

Dimensional items must include desired item variation in the line items section of the order. If an order is placed for a dimension item without variation or a non-dimensional item with variation, the order will return an error with information about the item that failed verification.

Items Missing Proposition 65 Attribution

If an order is placed at a California branch or with a California delivery address for an item that has not yet been attributed with Proposition 65 information, the order will return an error with information about the item that failed verification.

Retrieving Order Details

The Order API Get Order History endpoint will return a summary of all orders placed for a given account, regardless of the source system under which the order was placed. For Third-Party integrations, the Get Order endpoints will only return order details for orders that were placed through that integration.