TclMML

[mml configure billing_address]

Documentation: Configure Billing Address

[ Home | Docs | FAQ | Download | CVS | Mailing Lists | Bug Tracker | USPS's MOL Site ]

Syntax

mml configure billing_address ?-switches? billing_address_name

Switches

-debug filename (Optional)

If specified, the XML generated and sent to the MOL system, as well as the XML reply from the MOL system, will be appended to filename.

-title title (Optional)

The title (i.e., Dr., Mr., Mrs., Ms., Miss, etc.) of the billing addressee.

-prefix prefix (Optional)

The prefix for the billing addressee.

-fullname fullname (Required Alt.)

The full name of the billing addressee. This switch must be provided unless -firstname and -lastname are specified instead.

-firstname firstname (Required Alt.)

The first name of the billing addressee. This switch must be provided, along with -lastname, unless the -fullname switch is specified instead.

-middlename middlename (Optional)

The middle name of the billing addressee. Only valid in combination with -firstname and -lastname.

-lastname lastname (Required Alt.)

The last name of the billing addressee. This switch must be provided, along with -firstname, unless the -fullname switch is specified instead.

-suffix suffix (Optional)

The suffix (i.e. Jr., Sr., Esq., III, etc.) of the billing addressee.

-company company (Optional)

The company name of the billing addressee.

-addressline1 addressline1 (Required)

The first address line of the billing address.

-address1 address1 (Synonym)

An alternate syntax for -addressline1.

-addressline2 addressline2 (Optional)

The second adress line of the billing address.

-address2 address2 (Synonym)

An alternate syntax for -addressline2.

-urbancode urbancode (Puerto Rico)

This switch is required for billing addresses located in Puerto Rico. It is not needed for other locations.

-city city (Required)

The city of the billing address.

-state state (Required)

The state (or province) of the billing address.

-postcode postcode (Required)

The postal code (Zip Code in the US) of the billing address.

-zipcode zipcode (Synonym)

An alternate syntax for -postcode.

-country country (Optional)

The country of the billing address. Defaults to the United States if not specified otherwise.

-email email (Optional)

An email address for the billing addressee. Though the MOL system currently accepts this field, it does not know how to do anything with it.

Positional Arguments

billing_address_name

This is an arbitrary text string used to name the billing address, which should be passed to upload order as the value for the -billing_address switch.

Return Value

If successful the billing_address_name is returned.

An error will be returned if the billing address was incomplete or invalid.

Notes

A billing address does not need to be specified if ACH payment is used, or if the return address matches the billing address of the credit card used to pay for the order.