ShipRush ADO: Fields Reference

 

Quick Links:

 

Fields Reference

Merge Codes

 

Fields

 

Read Fields (aka Contact Info)

SQL Field Name

 

Description

RecordID

Optional

Order number, Contact ID, Account ID or any identifier. Not used by ShipRush, but crucial for passing into the INSERT/UPDATE statement when writing history.

CompanyName

See Desc

Ship-To Company Name  (optional if ContactName is supplied)

ContactName

See Desc

Ship-To Contact Name (optional if CompanyName is supplied)

ContactType

Optional

Contact type, currently not used

Address1-Address3

See Desc

Ship-To Address info. Only pull data into Address1 and Address2 (pulling into Address3 causes the data to be fed into 1 and 2).

At least Address1 must be returned

City

Required

Ship-To City

State

Required for countries that have states

Ship-To State

ZIP

Required

Ship-To Postal Code

Country

Optional

Ship-To Country  Defaults to USA

Phone

Required

Ship-To Phone   Some shipping services require a phone number. It is advised to return a static value (perhaps the shipper's phone number) if the Ship To phone number is not available.

Fax

Optional

Ship-To Fax

EMail

Optional

Ship-To Email

Notes

Optional

Contact notes, currently not used

ShippingTemplate

Optional

Full path to the ShipRush shipping template file (XML with full shipment/package info).

Notes: You need to use shipping template if you want to control more details of the new shipment. Package weight, shipping service, payment type, COD, packaging, etc. Refer to the ShipRush documentation on how to create shipping templates.

CarrierType

Optional

Shipping Carrier Type, as a string. If not specified then default carrier used. Options:

 

  • UPS
  • FEDEX
  • Endicia
  • USPS
 

The value is case-insensitive. Any other value returned in this field  will be ignored.

Reference

Optional

Package reference for Package1

PackageWeight

Optional

Package weight for Package1

 


Write Fields (aka History)

SQL Field Name

Description

RecordID            

RecordID from incoming XML file. Empty if incoming XML did not exist.

FromCity            

Ship-From Conact/Address info

FromCompanyName     

 

FromCountry         

 

FromName            

 

FromStateOrProvince 

 

FromStreet1         

 

FromZip             

 

ToCity              

Ship-To Conact/Address info

ToCountry           

 

ToName              

 

ToStateOrProvince   

 

ToStreet1           

 

ToZip               

 

ShippingCarrier     

Shipping Carrier that was used. “USP”, “FEDEX”, “ENDICIA” or “USPS”

ShippingService     

Shipping service that was used “Next Day”, “2 Day”, etc

TrackingNumber      

Carrier tracking number

ShippingCharges      

Total Shipping Charges

ShippingWeight      

Total Shipment Weight

HistoryNotes        

Full shipment details in human-readable format. Multiline CRLF separated.

SmallHistoryNotes   

Short shipment details in human-readable format. Multiline CRLF separated

HistoryReference    

Very short shipment details. Single line.

 

 

Merge Codes

Merge Codes

%GUID%

Causes ShipRush to generate a new GUID

%RecordID%

Available only when writing history

%EnvVar(<varname>)%

Reads environment variables from the local PC. For example, if the user's login name, or PC name needs to be merged into a SQL statement, this merge code can be used.

 

Example:

 

%EnvVar(ComputerName)%

%Today(format)%

Current date formatted as specified.

 

Example:

 

%Today(mmddyy)%

 

See below for available format options.

%SEARCHPARAM%

The element searched for or scanned with a bar code scanner

 

 

Date Formatting:

 

c              Displays the short date, followed by the long time.

d              Displays the day as a number without a leading zero (1-31).

dd             Displays the day as a number with a leading zero (01-31).

ddd           Displays the day as an abbreviation (Sun-Sat).

dddd         Displays the day as a full name (Sunday-Saturday).

m             Displays the month as a number without a leading zero (1-12).

mm          Displays the month as a number with a leading zero (01-12).

mmm       Displays the month as an abbreviation (Jan-Dec).

mmmm    Displays the month as a full name (January-December).

yy            Displays the year as a two-digit number (00-99).

yyyy        Displays the year as a four-digit number (0000-9999).

h              Displays the hour without a leading zero (0-23).

hh            Displays the hour with a leading zero (00-23).

n              Displays the minute without a leading zero (0-59).

nn            Displays the minute with a leading zero (00-59).

s               Displays the second without a leading zero (0-59).

ss             Displays the second with a leading zero (00-59).

z              Displays the millisecond without a leading zero (0-999).

zzz           Displays the millisecond with a leading zero (000-999).

t               Displays the time using short format.

tt             Displays the time using long format.

am/pm     Uses the 12-hour clock for the preceding h or hh specifier, and displays 'am' for any hour before noon, and 'pm' for any hour after noon.

a/p           Uses the 12-hour clock for the preceding h or hh specifier, and displays 'a' for any hour before noon, and 'p' for any hour after noon.

ampm      Uses the 12-hour clock for the preceding h or hh specifier.

/               Displays the date separator.

:               Displays the time separator.

'xx'/"xx"  Characters enclosed in single or double quotes are displayed as-is, and do not affect formatting.

 

 

Next: ShipRush ADO Example Scripts