CartManager uses several set fields in the "Add To Cart" action. Each of the variables are separated by a | character (pronounced "or" and is found on the keyboard above the back-slash key) and allows information to be compiled into a single variable, reducing data entry time.

The field separators (the first 4 are required) must be used in proper order. If a certain field is not applicable to you, leave it empty as a placeholder to prevent the field count from being thrown.

If your product entry requires a quotemark you must use the code &quot; or data will be lost.

Field 1: cartid (required) -- Usernames (cart ID's) are assigned to you upon sign-up. This username identifies you to the CartManager system and is used for your cart configuration.

Only alpha-numeric characters are permitted and it is important to remember that usernames are case sensitive.

SAMPLE CARTID USERNAMES

laneyentCart4You443john

Field 2: itemname (required) -- The product description. A short text description should be used to remind the customer what the item is when they review their cart contents. A larger description should be placed on your Web Page.

Remember, if you need to use reserved characters (e.g. quotation marks) use &quot; etc.

The field is also expandable and may contain entries for additional costs and/or used to include the cost of accessory items. This is accomplished by referencing "VARcost" or "AppendItem" and inserting additional code as shown.

Field 4: itemquantity (required) -- This variable contains the default number of items a customer may purchase at one time. The entry generally is 1 (one) but could be any number (i.e. a hand-knit sock is sold in sets of 2). You should indicate these quantities in your Web Page description to assist the customer when ordering.

The field is also expandable and may contain entries to either select from a predefined list of values or input the exact number of items desired. This is accomplished by referencing "VARquanitity" in the field and inserting additional lines before the </form> closing tag.

QUANTITY

VARIABLE CODE

Quantity Single Selection(customer has no choice, x items automatically placed in shopping cart)

Even if you do not use part numbers, it is recommended that you assign a part number code for each item you are selling. They are very useful if you ever decide to use the cart features "Coupons" or "Inventory Control".

SAMPLE ITEMNO CODES

XR4501XR-4501XR4_501

Field 6: itemhandling (optional) -- The price to ship and/or process (handle) the product. This amount can be applied in addition to the rate calculated using the Approved Shipping Methods or Shipping By Table used within CartManager. The variable allows you to adjust your fees on a per product basis and possibly create a higher profit margin on items that may be popular, cheaper/more expensive, or easier to deliver. All entries MUST include a currency symbol ( $ ) or a percent symbol ( % ).

This variable is expandable and can accommodate a custom handling scale. To build your price structure, simply start with the first value, insert a colon, and indicate its price. Add additional quantities and their prices separated by another colon until all desired fees are inserted.

ITEMHANDLINGCODE

Description

$x

Each item adds $x to handling.

x%

Each item adds x% of the items price to handling.

1:$x:10:$y:20:$z

Quantities of 9 or less charge $x each.Quantities of 10-19 or less charge $y each.Quantities of 20 or more charge $z each.

>1:$x:2:0

Only charge $x for shipping, no matter how many they purchase

#12:$x

Charge $x for every dozen purchased

Note: If the "PerHandling" option is used in Field 9: itemexempt (optional) then the amount will not be calculated per product, but only once per order.

The "PerHandling" option is only intended to be used with the "$x", and "x%" Item Handling codes. To use it with the other, more complex codes may result in an error.

Shipping/Handling charges may still come from other sources such as UPS or FedEx. Or from other products having their own handling fee.

Field 7: itemshipmethod (optional) -- You may designate a preferred shipping method for each product. During the checkout procedure, the shopping cart program will automatically calculate the exact price to ship the product via the indicated method, this is in addition to any charges created by itemhandling. Please insert the code into this field exactly as it appears below.

The field is also expandable and may contain selectable entries. This is accomplished by referencing "VARshipping" in the field and inserting additional lines before the </form> closing tag.

Note: "Prompt" allows your customers to choose a shipping method from your Approved Shipping Methods list using a drop-down menu on the top of the "Shipping/Billing" page.

So if you have the original box above as well as a 3 pound box measuring 5 inches by 3 inches by 1 inch you enter

6:10:8:4=3:5:3:1

Note: If you do not specify a length, width, and height then the shopping cart will use an internal algorithm to guess the dimensions. If you require extremely accurate shipping charges then you MUST enter box dimensions.

Creates a special product. This product will automatically create a gift certificate for later use within the cart. Gift certificates should also be labeled TAX and SHIPPING exempt.(eg. TAX:SHIPPING:GIFTCERTIFICATE)

GiftCertificate

Quantity cannot be modified in any way.

Quantity

The quantity cannot be set higher than X.

Max=X

The quantity cannot be set lower than X.

Min=X

Changes how handling is charged.It will now only charge the handling fee once, and NOT per item.

PerHandling

Tax and Shipping exempt.

Tax:Shipping

If a shopper has a valid Tax ID, and you still need to charge that person tax for this item, enter this into your add button code.

Allows BuyDRM as your ESD DRM provider. BuyDRM must have the product part number on file so the cart can retrieve a "coupon" from BuyDRM.

BuyDRM

Allows you to process your eBay auction payments automatically.

AID is your eBay auction ID.
TID is your eBay transaction ID.

eBay=AID=TID

The ability to group items together so that their quantity is adjusted at the same time.

In this example all products with the matching "abc" tag will be grouped together so that their quantities match.

groupquantity=abc

Field 10: itemdiscount (optional) -- This variable allows either a dollar-discount or a percentage-discount. If you desire the product to offer a dollar reduction, simply include the code: $x dollar discount for product. If you want to give a savings percentage for the product, use the code: x% percentage of discount for product. All entries MUST be numeric and may include the currency ( $ ) or percentage ( % ) symbols.

Discounts are expandable by using the ( @ ), ( # ), or ( > ) symbols. To build a discount structure based on a price or quantity range use the ( @ ) or ( > ) symbols your range, a colon, then the discount amount. To give a discount on every Nth item use the ( # ) symbol the Nth item, a colon, followed by the discount amount.

Discounts that begin with #, @, or > can be made global. To do this simply end the discount code with the global identifier. If a product is not made global than the discount can only apply to the 1 specific cart entry.

DISCOUNT CODE

Description

$4.95

Each item is reduced in price by $4.95Note: For discounts less than $1.00, include the 0 (zero) before the decimal point (e.g. $0.10).

#2:100%

Buy one get one free

50%

Wow this item is 50% off

>10:5%:20:10%:50:15%

Quantities 1-9 regular priceQuantities 10-19 are 5% offQuantities 20-49 are 10% offQuantities 50+ are 15% offNote: For example if they purchase 20 products that are normally $100 each, the total price for all 20 would come out to $1930.00. Notice that the first 9 products are regular price, then 10-19 are 5% off, and finally the 20th is 10% off.

@10:5%:20:10%:50:15%

Quantities 1-9 regular priceQuantities 10-19 are 5% offQuantities 20-49 are 10% offQuantities 50+ are 15% offNote: For example if they purchase 20 products that are normally $100 each, the total price for all 20 would come out to $1800.00. Notice that all 20 products got the 10% discount.

@$1000:5%:$2000:10%

Dollar amounts 0-999 are regular priceDollar amounts 1000-1999 are 5% offDollar amounts 2000+ are 10% offNote: For an order amount of $999 or below there is no discount. For order amounts from $1000 to $1999 customers receive a 5% discount. Orders $2000 and above receive 10% off.

>$100:$10:global

Give an instant $10 rebate if $100 or more is purchased (one time only)

>1:$10:2:$0:global

Give an instant $10 rebate if 1 or more products are purchased (one time only)

#$100:$10

Give an instant $10 rebate for every $100 purchased

#2:100%

Buy one get one free

#3:50%

Buy two get the third one at half price

#3:50%:half_off

This is a global discount. All items with this discount code will be used for calculating the quantities

@10:5%:shirts

You could create a discount like this to allow customers to get a discount if they buy 10 or more or any shirt with this code

Field 11: itemsilentpost (optional) -- Occasionally you may need extra processing done on your website when a product is purchased. To accommodate you the cart has the ability to send data back to the URL you specify in the "ItemSilentPost" field. The cart will do a silent post to the URL using the POST method once the product has been purchased.

If you choose, you can setup verification of the silent post, simply enter the ItemSilentPost Verification Text into step #8 Advanced Settings. The cart will verify that this text exists in the data that your URL returns. If it does not, we will send you email notification that it failed to verify.

Note: ItemSilentPost can only to connect to destination port 80 or port 443. Please make sure your developers use these ports for communication. All connections will come from 192.41.22.30, please adjust your firewalls accordingly.

Here is the extra information that will be sent with each post.

ItemNo

the part number of the product

ItemQuantity

how many were purchased

UnitPrice

The unit price of the product purchased

OrderNumber

which order this post is for

OrderShipping

the total shipping charges for the order

OrderTax

the total tax amount for the order

OrderGiftCertificates

how much of the order, if any, was paid for by gift certificates.

OrderCoupons

A comma delimited list of coupons and how much the coupon was valid for.

e.x.coupA,4.95,coupB,12.81

OrderCOD

the additional COD charge applied to this order, if any.

OrderRushOrder

the rush order charge for this order, if any.

OrderTotal

The grand total for this order.

Name

the customers name

EMail

the customers email address

Phone

the customers day phone number

PayMethod

What method of payment did the customer use (VISA, AMEX, etc...)

CustomerID

This is your customer ID that can be sent to us using a CustomerID hidden tag in any cart button.

GatewayID

If the order was processed through a payment gateway then this is the transaction number for your payment gateway.

Please enter the postal code, and the 2 digit state code of this product's warehouse here.

Examples:
84604:UT
or
84604:UT:US

Note the full "84604:UT:US" format is highly recommended as the other more brief formats may cause shipping errors if your business is not located in the same state as the drop ship zip code.

Field 13: itemESD (optional) -- This variable allows the merchant to create products that are shipped electronically. Instead of shipping a package to the customer, the customer will be able to download your file(s) immediately upon purchase.

Valid values can be:

yourfile.exe - the file name in our ESD system. Uploaded files are only available to the customer that purchased them.

http://www.yourserver.com/somewhere/yourfile.exe - URL of the file your customer will be allowed to download upon purchase. URLs entered in this manner are not protected, it is the merchants responsibility to ensure that the download is allowed only to paying customers.

If you are using a file name then the file must be uploaded to your cart admin area (see Upload ESD File).

An email address may be sent (eg FILENAME=EMAIL) to the cart, this will cause the cart to not allow the purchaser to download the product. But, rather it will send an email to the specified address with a link to download. You can use this to allow your customers to send an ESD file as a gift to another person.

Note: ESD files uploaded to us are only available for download for 3 days after the first attempt to download the file. After this time, the customer will need to contact the place of purchase for any assistance in getting the file.

Note: Use the email system with care. Many mail servers will refuse delivery if the file is to large. For example, many will reject files larger then one megabyte.

Field 14: itemRecurring (optional) -- This variable allows the merchant to create products that have an ongoing charge. Possible options for the frequency are Weekly, Bi-Weekly, Semi-Monthly, Monthly, Quarterly, Semi-Yearly, Yearly, or X-Daily (where X is any number of days)

When a customer selects an option from special product properties, the selection is saved in one of these fields. Merchants can have up to 10 special product properties to be recorded; any properties after 10 will be omitted.

The answers are limited to 255 characters, anything after that will be lost.

CartManager does not use the answers, it only display them here:
1) The receipt
2) In a CSV file they can download

A merchant can download the CSV file here
1) Login
2) Order History
3) Download My Orders
4) You can then open the downloaded file
5) Open the file in Excel or any other program that can open a CSV file