Codes, constraints & allowed values.

One row per field. Required means the request will be rejected without it; all other fields are optional and fall back to server-side defaults when omitted. Max is the server-side storage width — values longer than this are either silently truncated (on the truncating fields listed in § 04) or stored up to the listed limit. Field names are case-sensitive.

Top-level order fields

Field	Type	Required	Max	Notes
JOB_NAME	string	optional	20	Job / project name. Prints on packing slip and order documents. Silently truncated to 20 chars server-side.
SHIP_TO_FNAME	string	optional	—	First name of ship-to contact. Combined with SHIP_TO_LNAME. Combined contact name is stored up to ~30 chars.
SHIP_TO_LNAME	string	optional	—	Last name of ship-to contact.
SHIP_TO_COMPANY	string	optional	30	Ship-to company / business name. Silently truncated to 30 chars.
SHIP_TO_ADDRESS	string	optional	30	Single-line street address. Include suite / unit in this field. Silently truncated to 30 chars.
SHIP_TO_CITY	string	optional	—	Composed with state, ZIP, country into a single display line server-side.
SHIP_TO_STATE	string	optional	2	Two-letter US state / province code.
SHIP_TO_ZIP	string	optional	10	NNNNN or NNNNN-NNNN.
SHIP_TO_COUNTRY	string	optional	2	ISO 3166-1 alpha-2 code. Defaults to US.
SHIP_TO_PHONE	string	optional	—	Any format. Server strips non-digits, drops leading 1 if 11 digits, reformats as NNN/NNN-NNNN.
SHIP_VIA	string, enum	optional	2	Carrier code. See § 03. If omitted, FHC default carrier used. Server may substitute based on customer & destination.
PURCHASE_ORDER	string	optional	15	Your internal PO reference. Silently truncated to 15 chars.
ORDER_COMMENTS	string	optional	unlimited	Free text. Split server-side at 30-char word boundaries and stored as a multi-value list.
ORDR_EMAIL	string, email	optional	~40	Contact email. Note attribute spelling (ORDR_EMAIL, not ORDER_EMAIL).
LOC	string, enum	optional	2	Warehouse code. See § 02.
REQUESTED_BY	string	optional	~15	Name of the person requesting the order.
ORDER_LINES	array	required	—	At least one line item.

ORDER_LINES item fields

Field	Type	Required	Max	Notes
PRODUCT_CODE	string	required	15	FHC product SKU. Uppercase required — pattern ^[A-Z0-9-]+$.
ORDER_QUANTITY	integer	required	6-digit	Positive integer, minimum 1.

Injected server-side (do not send)

Field	Type	Source	Max	Notes
CUSTOMER_NUMBER	integer	token	—	Force-injected from the authenticated token. Any value in request body is ignored.

The LOC field specifies the FHC warehouse the order should ship from. Only these five integer-valued codes are accepted. If omitted, FHC routes based on the customer's default and the ship-to address.

The SHIP_VIA field specifies carrier and service level. Two-character codes, case-sensitive. If omitted, FHC default carrier for the region is used. Carrier substitution rules may override the submitted code based on customer preferences and destination state.

UPS

Code	Service
04	UPS (default)
UG	UPS Ground
U1	UPS Next Day Air
UE	UPS Next Day Early AM
U4	UPS Next Day Saver
U2	UPS 2-Day
U5	UPS 2nd Day AM
U3	UPS 3-Day Select
US	UPS Saturday Delivery

FedEx

Code	Service
FG	FedEx Ground
FA	FedEx Air
FF	FedEx Freight

USPS

Code	Service
05	USPS
UP	USPS Priority

Freight & other

Code	Service
03	Common Carrier
TC	Trump Card
WC	Will Call (customer pickup)
07	No ship (hold on account)

Several fields receive server-side transformations. These are documented here so you can anticipate what shows up on the final order record.

Silent length truncation

Field	Width	Notes
JOB_NAME	20	Longer values silently truncated; original preserved in order audit
SHIP_TO_COMPANY	30	Longer values silently truncated
SHIP_TO_ADDRESS	30	Single line; include suite / unit in this field
PURCHASE_ORDER	15	Longer values silently truncated

Transformations

Field	Behavior
SHIP_TO_PHONE	Non-digits stripped. If 11 digits, leading 1 dropped. Reformatted as NNN/NNN-NNNN.
ORDER_COMMENTS	Split at 30-character word boundaries (break chars: space - _ , ; : . ! ?) and stored as multi-value list.
PRODUCT_CODE	Case-sensitive lookup; must be uppercase.
SHIP_TO_CITY / STATE / ZIP / COUNTRY	Composed into a single display line: City, ST ZIP (US) or City ST COUNTRY ZIP (non-US).
All text fields have characters below ASCII 32 or above 126 stripped before storage.

Defaults (when omitted)

Field	Default
SHIP_TO_COUNTRY	US
SHIP_VIA	FHC's default carrier for the ship-to region
LOC	Customer's default warehouse / region routing
CUSTOMER_NUMBER	Force-injected from the authenticated token