Knowledge Base

The Order Status Notification (OSN) Service must be configured before it can be made available to Distributors. The configuration maps fields from the NetSuite purchase order or sales order object to the corresponding fields in the PromoStandards Order Status Notification API response.

1. Sales Order ID
   Sales Order number field in NetSuite. The recommended field is {tranid}.
   
   
   Note:
1. The field id can optionally be specified in the format below:
   
1. {fieldIdA},{fieldIdB},{fieldIdC}…Use this if you want to include the first non-null field in the response.
   
2. A record join of createdfrom will be auto-applied for this field.
   
2. Purchase Order ID*
   Purchase Order number field in NetSuite. The recommended field is {otherrefnum}.
   
   Note: 
1. The field id can optionally be specified in the format below:
   
1. {fieldIdA},{fieldIdB},{fieldIdC}…Use this if you want to include the first non-null field in the response.
   
2. A record join of createdfrom will be auto-applied for this field.
   
3. If there is no value present in this field when searching for order shipment notification details using a Sales Order number or timestamp, the response will include the Sales Order number and a "Not Specified" value for the Purchase Order number. This functionality is supported in version 1.3.8 and above. 
   
3. Shipment Date*
   Shipment date field in NetSuite. The recommended field is {shipdate}.
   
   Note:
1. The field id can be specified in the format below as well:
   
1. {fieldIdA},{fieldIdB},{fieldIdC}…Use this if you want to include the first non-null field in the response.
   
2. If you want to source a value from any other field joined to the item fulfillment record, you can do so by specifying the field's record reference followed by a period and the desired record's field. For example, "createdfrom.datecreated".
   
4. Supplier Part ID
   Supplier part id field in NetSuite. The recommended field is {vendorname}.
   
   
5. Supplier Product ID
   Supplier product id field in NetSuite. The recommended field is {vendorname}.
   
   
6. Distributor Part ID
   Distributor part id field in NetSuite. The recommended field is {itemid}.
   
   
7. Distributor Product ID
   Distributor product id field in NetSuite. The recommended field is {itemid}.
   
   
8. Ship Method
   Ship method field in NetSuite. The recommended field is {shipmethod}.
   
   
9. Shipping Carrier
   Shipping carrier field in NetSuite. The recommended field is {shipcarrier}.
   

1. Saved Search ID*
   This is the internal ID of the item fulfillment saved search that will be used to query orders within NetSuite for which you want an OSN response. For instance, if you have multiple business lines but want to list only one on PromoStandards, configure your saved search to display only item fulfillment records applicable to the PromoStandards business line.
   
   
2. Package for Each Tracking Number
   This checkbox determines whether to send tracking details for item fulfillments separately based on unique tracking numbers or consolidate them under a single package where all the tracking numbers are separated by commas.
   
   
3. Validate Response
   This checkbox determines whether to validate the data type of the fields before returning the response.
   
   
4. In the "ShipMethod-Account Number Map" section, provide mappings for your Ship Methods based on their respective shipping account numbers and their corresponding locations. This information will be included in the PromoStandards API response, along with the shipment method.
   
   Note: If the Location field for the Ship Method is left blank, then the mapping will return the same account number for all locations associated with that Ship Method.