Purchase & Transfer Orders

This interface provides newly recommended purchase orders (PO's) and transfer orders (TO's)

Buyers and planners using GAINS Replnenishment Optimization capabilities typically use Order Builder functionality to act on new order recommendations. The approved and submitted purchase orders generated via Order Builder are captured through this API.

Purchase Order recommendations can be retrieved in two ways.

Purchase Orders via webhook subscription

This option requires the use of webhooks where we will post newly generated PO's to your desginated URL in real-time. We expect you to receive this data and process it into your ERP or other system of record. Webhook notifications will be generated throughout the course of the day as planners/buyers use the platform.

Webhook notifications for purchase orders are all-inclusive. We do not filter orders for specific vendors or locations. This is to be done on the client side if desired.

Please review the detailed guide on setting up webhooks if you choose this path.

Purchase Orders via GET endpoint

This option allows you to capture PO's that are approved and submitted, and the scope of the data is limited to orders generated that day. For instance, if you use the GET endpoint at 4pm, you will receive orders generated up until 4pm. Thereafter, if you hit the GET method at 6pm, you will receive all data for the day through 6pm.

Generally, GAINS will run some batch maintenance tasks on data during off-hours and this means that from the start of this maintenance period, the data for the current data is no longer available and this endpoint should now be used the next business day to retrieve orders submitted on that day.

The GET method allows you to filter the data to capture specific vendors or receiving locations.

Transfer Orders

Transfer Orders follow the same integration patterns as described above for Purchase Orders. However, the data attributes for TO's map to internal shipping locations rather an external vendor code.