Overview
eXtendPromoStandards Distributor Edition
(eXtendPS-DE) allows you to configure the
PromoStandards Purchase Order service in
NetSuite. This integration enables you
to:
- Place blank purchase orders to vendors
with purchase order service
endpoints
- Map shipping methods between NetSuite
and your vendors
- Configure field mappings for sending
order details
Prerequisites
Purchase Order Filter
Search
Create a saved search to filter which
purchase orders are available for purchase
order placement:
- Open the bundle search eXtendPS-DE
Place PO Saved
Search[B] {customsearch_extend_ps_de_place_po_ss} as
a template, then use Save As to
create your own copy.
- Add any additional filters needed for
your business requirements.
Configuration
1. Access the Setup Page
- Go to Customization → Scripting →
Scripts.
- Find the script named eXtendPS-DE
Suitelet.
- Create a new deployment with these settings:
- Name: eXtendPS-DE Purchase
Order Setup
- ID: _extend_psde_po_setup (will save as customdeploy_extend_psde_po_setup)

- Audience: Administrator
(default), or specific roles or
employees
- Status: Released
- Log Level: Audit or
Error
- Execute as role: Administrator
- Name: eXtendPS-DE Purchase
Order Setup
- Set the script parameter eXtendPS-DE Setup to promo_po_setup.

- Configure the menu location:
- Center: Classic
Center
- Section:
eXtendTech
- Category: eXtendPS-DE
- Label: Purchase Order Setup

- Center: Classic
Center
2. General Configuration
- Purchase Order Filter Search: Enter
your saved search ID from the Prerequisites section.
- Show Place PO Button: Enable to
display the Place PO button on
purchase
order records. Note that this controls the
scripted button that's added by
eXtendPS-DE. If you use a workflow to show
the button, you also need to update that
workflow. eXtendPS-DE Place
PO[B] is the base workflow
included in eXtendPS-DE.
- Place PO Button Label: Customize
the button text.
- Additional Columns: Used for
scripted hooks. Don't modify without first
consulting eXtendTech
Support.
3. Vendor Ship Method
Mapping
- Go to the Purchase Order Setup
page and select Vendor Ship Method
Mapping List.

- Click New eXtendPS-DE Vendor Ship
Method
Mapping to create a
mapping record with these fields:

- Vendor: Select the vendor
for the mapping.
- NS Ship Method: Choose the
NetSuite shipping method.
- Vendor Ship Method: Enter
the vendor's corresponding
shipping method.
- Vendor Ship Carrier: Specify
the vendor's carrier
service.

4. Field Mappings
Order Body Fields
- Order Number: Transaction field
providing the order number. Typically uses tranid.
- Order Date: Transaction field
providing the order date. Typically uses trandate.
- Order Type: Transaction field
providing the order type. Uses bundle
field eXtendPS-DE Order Type
{custbody_extend_promo_order_type}.
- Rush: Transaction field indicating
rush orders. Uses bundle field eXtendPS-DE Rush
{custbody_extend_promo_is_rush}.
- Last Modified: Transaction field
providing the last modified date.
Typically uses lastmodifieddate.
- Payment Terms: Transaction field
providing payment terms. Typically uses terms.
- Terms & Conditions: Transaction
field providing terms and conditions. Uses
bundle field eXtendPS-DE Terms &
Conditions
{custbody_extend_promo_terms_n_conditio}.
- Sales Channel: Transaction field
providing the sales channel. Uses bundle
field eXtendPS-DE Sales Channel
{custbody_extend_promo_sales_channel}.
- Promo Code: Transaction field
providing the promo code. Uses bundle
field eXtendPS-DE Promo Code
{custbody_extend_promo_code}.
- Total Amount: Transaction field
providing the total amount. Typically uses amount.
- Third Party Account Name: Transaction field providing third party
account name. Uses bundle field eXtendPS-DE Third Party Account Name
{custbody_extend_promo_thirdparty_ac_na}.
- Third Party Account Number: Transaction field providing third party
account number. Uses bundle field eXtendPS-DE Third Party Account
Number
{custbody_extend_promo_thirdparty_ac_nu}.
- Third Party Contact Details: Transaction field providing third party
contact details.
- Ship References: Transaction field
providing ship references. Uses bundle
field eXtendPS-DE Ship References
{custbody_extend_promo_ship_references}.
- Packaging List Required: Transaction field indicating if packaging
list is required. Uses bundle field eXtendPS-DE Packaging List Required
{custbody_extend_promo_packaging_list_r}.
- Blind Ship: Transaction field
indicating blind shipments. Uses bundle
field eXtendPS-DE Blind Ship
{custbody_extend_promo_blind_ship}.
- Allow Consolidation: Transaction
field indicating if consolidation is
allowed. Uses bundle field eXtendPS-DE Allow Consolidation
{custbody_extend_promo_allow_consolidat}.
- Shipment Comments: Transaction
field providing shipment comments. Uses
bundle field eXtendPS-DE Shipment
Comments
{custbody_extend_promo_shipment_comment}.
- Shipment ID: Transaction field
providing the shipment ID.
Order Line Item Fields
- Line Number: Transaction column
field providing the line number. Typically
uses linesequencenumber.
- Line Type: Transaction column field
providing the line type. Uses bundle field eXtendPS-DE Line Type
{custcol_extend_promo_line_type}.
- Item: Transaction line or item
field providing the item. Typically uses item.
- Description: Transaction line or
item field providing item description.
Typically uses memo.
- Tolerance Type: Transaction line or
body field providing tolerance type. Uses
bundle field eXtendPS-DE Tolerance
Type
{custcol_extend_promo_tolerance_type}.
- Tolerance Value: Transaction line
or body field providing tolerance value.
Uses bundle field eXtendPS-DE
Tolerance Value
{custcol_extend_promo_tolerance_value}.
- Tolerance UOM: Transaction line or
body field providing tolerance UOM. Uses
bundle field eXtendPS-DE Tolerance
UOM
{custcol_extend_promo_tolerance_uom}.
- Allow Partial Shipments: Transaction line or body field providing
partial shipments allowance.
- Requested Ship Date: Transaction
line or body field providing requested
ship date.
- Requested In Hands Date: Transaction line or body field providing
requested in hands date.
- Customer Supplied: Transaction line
or body field providing customer supplied
value.
Order Part Item Fields
- Item Part Name: Transaction line or
item field providing item part name.
Common fields include item.custitem_extend_promo_product_part_id and item.vendorname.
- Description: Transaction line or
item field providing item description.
Typically uses memo.
- Unit Price: Transaction line or
item field providing unit price. Typically
uses rate.
- Extended Price: Transaction line or
item field providing extended price.
Typically uses amount.
Additional Configuration and
Validation
After completing the setup and creating
ship method mappings, complete these steps
before using the Purchase Order service in
production.
1. Configure the Default Purchase Order
Form
Configure the default purchase order custom
transaction form so that all fields mapped
on the Purchase Order Setup page
are visible. The fields must be available
on the form so their values can be
included in the purchase order
request.
2. Test Purchase Order Placement
- Create or view a purchase order for a
configured vendor.
- Confirm that all required mapped
fields contain values.
- Click Place PO.
- Review any error messages and the
applicable script execution
logs.
- Ask the vendor to confirm that the order arrived and that all details appear as expected on their side, including items, quantities, pricing, ship method, and addresses.
3. Confirm Successful Placement
Review the resulting purchase order details
to verify that the expected field and
freight values were included.
For configured or decorated purchase
orders, contact eXtendTech Support to discuss implementation of the required
custom scripting.