OneSource API: OneSource Hosted Suppliers

OneSource is an API solution designed to help suppliers, distributors, and service providers achieve PromoStandards compliance. As a OneSource Hosted Supplier, you'll host your PromoStandards endpoints through OneSource and use the OneSource Management API to send product data updates. These updates are then automatically distributed to all data consumers relying on the supplier's product data.

Getting Started with OneSource

Follow these steps to use the OneSource Management API:

1. Create an API Key & Password
   Log in to your OneSource account to create an API Key & Password
   
   
2. Create FOB points
   FOB point(s) define your ship-from location(s) or warehouses. The FOB points you create are used in different functions throughout the OneSource Management API.
   Learn how to add a FOB point using our API or learn how to delete FOB points
   
   
3. Add products
   Add and update products in OneSource using the Upsert Product function.
   How to add/update products or learn How to delete products
   
   
4. Add Related Products
   Related products can serve as substitutes, companion sells, or a common groupings of the original product. Learn how to add or update related products
   
   
5. Add inventory
   With inventory, data consumers know how much of each product is available to buy.
   Please note: Data consumers prioritize and seek out inventory data within product information. 
   Learn how to add or update inventory or learn How to delete inventory
   
   
6. Provide order status updates
   Provide order status updates to your customers.
   Learn how to add or update the status or learn how to delete a status
   
   
7. Provide shipment information
   • Step 1:
     • Add sales order shipment
     • Update shipment isComplete value
     • Add package to shipment
       Learn how to add or update order shipments and package
   • Step 2:
     • Update information on an existing sales order shipment
       Learn how to update existing sales order shipment 
       
       
8. Retrieve purchase orders sent to your OneSource Purchase Order endpoint
   By default, when we receive an order, we send an email to your order entry team.
   Information on our human-readable email
   • Next steps are to request the purchase order details and push it into your ERP:
     • Get purchase orders, optionally filtered by date range, customerNumber, accountNumber, and/or purchaseOrderNumber
     • Get Purchase Order Details by reference number

View all docs for the OneSource Management API >>