Promotion

Internal ID: promotioncode

Supports Custom Fields

Fields

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.

Tabs

Name Label
campaign Campaigns
code Codes
item Items
minimumorderamount Minimum Order Amount
partner Partners
workflow Workflow

Search Filters

Internal ID Type Label
applydiscountto select Apply Discount To
code text Code
description text Description
discount select Discount
discountamount currency Discount Amount
enddate date End Date
externalid select External ID
externalidstring text External ID (Text)
formuladate date Formula (Date)
formulanumeric float Formula (Numeric)
formulatext text Formula (Text)
freeshipitem select Free Shipping Method
internalid select Internal ID
internalidnumber integer Internal ID (Number)
isinactive checkbox Inactive
ispublic checkbox Public
item select Item
location select Location
name text Promotion Name
partner select Partner
startdate date Start Date

Search Columns

Internal ID Type Label
code text Code
description text Description
discount text Discount
discountamount currency Discount Amount
enddate date End Date
externalid select External ID
formulacurrency currency Formula (Currency)
formuladate date Formula (Date)
formuladatetime datetime Formula (Date/Time)
formulanumeric float Formula (Numeric)
formulapercent percent Formula (Percent)
formulatext text Formula (Text)
internalid select Internal ID
isinactive checkbox Inactive
ispublic checkbox Available to all Customers
location multiselect Locations
name text Name
startdate date Start Date