Internal ID |
Type |
nlapiSubmitField |
Label |
Required |
Help |
applydiscountto |
select |
false |
Apply Discount To |
false |
Choose how many times this promotion can be used by the same customer.
Select One time only to limit this promotion to one use per customer, or select Unlimited amount of times to allow a customer to use the promotion as many times as they want without limit.
The restrictions set on the Usage Limits subtab apply to multi-use coupon codes only. |
code |
text |
false |
Coupon Code |
true |
The coupon code that is entered on a sales transaction to apply the promotion. Coupon codes can be multiple-use or single-use. Multiple-use codes can be used any number of times by any number of customers. Each single-use code can only be used in one transaction by a single customer. |
codepattern |
text |
false |
Code Pattern |
false |
You enter code patterns using the following components in any order you choose:
* [A.#] – This adds a number of random letters in the code.
* [N.#] – This adds a number of random numbers in the code.
* [AN.#] – This adds a number of random alphanumeric characters to the code.
* Hard-coded alphanumeric characters. Do not enclose these in square brackets.
* Dashes (-)
Note: The following letters and numbers cannot be used in coupon codes: 1, 0, I, L, O.
For example, the code ABC-[AN.3]-[A.3]-[N.3] would generate codes like:
* ABC-J3N-FLN-647
* ABC-45F-KPM-958
* ABC-5MP-PQA-874
When creating your code pattern, make sure that the pattern you give has enough variables to provide the number of unique codes you need for your promotion. |
couponcodefile |
file |
false |
Import File |
false |
If you are entering single-use coupon codes, do one of the following:
* Select a CSV file to import.
* Enter a code pattern and the number of codes you want to generate.
For more information on single-use coupons, view the topic Single-Use Coupons in the Help Center. |
customform |
select |
false |
Custom Form |
true |
Select the custom form to use with this promotion. |
description |
textarea |
false |
Description |
false |
Enter a description of this promotion. |
discount |
select |
false |
Discount |
false |
Select the discount item you want to assign to this promotion. Any account associated with this discount item is impacted by this promotion's discount. Using discount items enables you to track discount amounts without affecting inventory valuation.
To create new discount item, go to Lists > Accounting > Items > New, and click Discount. |
discounttype |
radio |
false |
% |
false |
Select the % option if the discount rate for this promotion is a percentage.
Select the Flat option if the discount rate for this promotion is a flat rate. |
displaylinediscounts |
checkbox |
false |
Display line discounts |
false |
Check this box if you want to show the promotion discount as line items in transactions. The discount will appear as a line beneath qualifying items on the transaction.
You must check this box and select a percentage discount in order to show strikeout pricing on Web store orders. A flat rate promotion applies to the total order.
If you clear this box, the promotion discount will be shown in the transaction total.
Note: If you use line discount promotions, when you apply the promotion to a transaction, you must click Calculate to create the discount line before saving the transaction. |
enddate |
date |
false |
End Date |
false |
Enter the date this promotion can no longer be applied to transactions. |
excludeitems |
checkbox |
false |
Exclude Items |
false |
Check this box to have this promotion code apply to all items except those you add below.
If you do not check this box, the code can only be used for the items you add below. |
externalid |
text |
false |
ExternalId |
false |
|
freeshipmethod |
select |
false |
Free Shipping Method |
false |
Select a shipping method from the list that will be offered for free on eligible transactions. |
isinactive |
checkbox |
false |
Inactive |
false |
Check this box to deactivate this promotion. Inactive promotions cannot be applied to customers or transactions. |
ispublic |
checkbox |
false |
Available to all Customers |
false |
Check this box to be able to select this promotion on transactions for any customer.
If you do not check this box, only customers associated with the partners you select below are able to use this promotion. |
location |
select |
false |
Location |
false |
Enter one or more locations that are eligible for this promotion's discount here when the Specific locations option is selected.
Only transactions associated with the selected locations will be eligible for the promotion. For more information regarding locations, see the help topic Working with Locations. |
name |
text |
false |
Name |
false |
Enter the name for this promotion.
Note: This is the name used for internal and reporting use only. The coupon code you want customers to use on sales transactions is entered in the Coupon Code field on the Codes subtab. |
numbertogenerate |
integer |
false |
Codes to Generate |
false |
Enter the number of coupon codes you want to generate with your code pattern. |
rate |
rate |
false |
Rate |
false |
Enter the discount rate for this promotion. Select % if this rate is a percentage. Select flat if this rate is a flat discount. |
startdate |
date |
false |
Start Date |
false |
Enter the first date this promotion can be applied to a transaction. |
usetype |
select |
false |
Number of Uses |
false |
Choose whether you are entering a multiple-use coupon code that can be used any number of times by any number of customers, or single-use coupon codes that can only be used in one transaction by a single customer. |