Starting with a list of questions that represent topics that have come up from time to time and driven support requests to confirm/clarify; the core goal of this document is to pass along information proactively to reduce Distributor integration frustration and reduce Supplier support requests.
...
| Table of Contents |
|---|
General
Its very normal for Distributors to require “clarifying information” when integrating with Suppliers. This can range from “mechanical concerns” (such as: When are established maintenance windows? How do I get notified of outages? Do I need to be whitelisted for access?) and some are more “business concerns” (such as: What might it mean when an order is on General Hold?). It is a best practice for Suppliers to take these kinds of recurring questions and proactively put their answers into an integration guide which can be made available for Distributors.
Some real-world sample integration guides from Suppliers:
Data / Business Mapping
Order Status API
It is common for suppliers to have more status codes than is enumerated in the API specification; a brief mapping should be provided so that Distributors know where to expect “known statuses” that are used in daily business practices
PromoStandards StatusID | PromoStandards Status Name | Supplier Statuses Represented |
10 | Order Received | |
11 | Order Entry Hold | |
20 | Order Confirmed | |
30 | Pre-Production | |
40 | General Hold | |
41 | Credit Hold | |
42 | Proof Hold | |
43 | Art Hold | |
44 | Back Order Hold | |
60 | In Production | |
70 | In Storage | |
75 | Partial Shipment | |
80 | Complete | |
99 | Canceled |
Allowed Date Ranges
Maximal days back supported for date-range invoice API requests?
Maximal days back supported for date-range order status API requests?
Maximal days back supported for date-range order shipment notification API requests?
...