Faro Logistics Solutions, Inc.
HOME  |   CLIENTS  |   C-TPAT   |   ITSG  |   TRANSPORTATION  |   EMPLOYMENT OPPORTUNITIES  |   CLIENT LOGIN
Whatever It Takes...for YOU! (614)497-1700
 
  • FTP Requirements
  • Date Requirements
  • The CSV File
  • Common Errors
  • Shipping Codes
  • Back..

FTP Setup

Faro only accepts FTP from static IP addresses. We at Faro filter who can access our site and who cannot. If you are using a company site utilizing a T1 or better connection you can check your IP address using What is my IP . You can check this value from day to day and if it does not change then you probably do have a static IP. But if it does change then you are not using static IP and must find a static IP site to send your data from for all data transmissions.

Please understand, Faro Logistics want to protect your data and this helps unwanted users from accessing our site. If you are trying to send CSV files from home then you probably should check with your local Internet Provider about aquiring a static ip address if you do not already have one.

Date Formatting

Date formatting is very important. Failure to send properly formatted dates can result in customers not receiving packages on time. Faro uses ASCII date formatting. The date is formatted as 20111225 where we see YYYYMMDD. The YYYY equals the year, MM represents a two digit month and DD is the two digit day of the month.

To format January 5, 2012 we would expect 20120105. Note we did not use any backslashes. The months and day of the month are always sent as two digit numbers.

Failure to follow proper date syntax will place date liability on you, our customers. Faro will not be responsible for any dates not sent using ASCI formatting.

What is an Acceptable CSV File?

A CSV file is actually a delimited file. This file is dropped onto our FTP site and automatically transfered to Radio Beacon (C).

The requirements are as followed:

It must have a file extension of ".CSV". 20120107.csv works fine but the name should not have any spaces. 2012 0101.csv would not be acceptable.

Faro will only accept one copy of the file per hour or the file will fail to import. Duplicate data is not accepted and will cause the file to fail. Under normal circumstances the scheduler picks up your file every 1/2 hour and processes it through our system.

If a scheduler is busy or the on occasion, the scheduler is "hung-up", it will require the IT department to investigate and push your file through.

Now we must keep a one for one header to detail correspondence. For each header column there must be a corresponding detail column record. It is very important to maintain this one for one relationship or your file will be rejected. This means if the field is blank, it must still be sent or your file will error out.

Each file begins with the row with the column names. These names are written in stone and are agreed upon by both Faro and our clients. The column names can be altered over time but they must be in our list of "agreed upon" headers names. Names of headers would be like ORDER_NO, Shipto1, Shipto2, SHIP_POSTAL_CODE, ShipVia. The header names are only inserted into the CSV file once and must be the top row.

ORDER_NO|ORDER_DATE|CUSTOMER_NO|SHIP_ADDRESS_1|SHIP_ADDRESS_2|SHIP_CITY|SHIP_STATE|SHIP_POSTAL_CODE|SKU|QTY_TO_SHIP

Lets examine what we are looking at in this header row and the implications of it. First we note the delimiter is a pipe sign (|). We must agree on the delimiter and it must never change. Examples of delimiters are ^$!~ and we ask you do not use the ampersand &. We will not accept a comma as the delimiter. Commas are used often in name and addresses and will unbalance the header record to detail record column count. The last column will not have a delimiter at the end of it. Now lets add a detail order to match our header

ORDER_NO|ORDER_DATE|CUSTOMER_NO|SHIP_ADDRESS_1|SHIP_ADDRESS_2|SHIP_CITY|SHIP_STATE|SHIP_POSTAL_CODE|SKU|QTY_TO_SHIP
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|45100GR|24

We see that SHIP_ADDRESS_2 is blank but the pipe delimiter holds a place for it. This will be explained below. The SHIP_STATE is always two characters. No delimiter is after the QTY_TO_SHIP. We have a one for one correspondence between header and detail line SKUs. Now lets add another SKU to the sales order.

ORDER_NO|ORDER_DATE|CUSTOMER_NO|SHIP_ADDRESS_1|SHIP_ADDRESS_2|SHIP_CITY|SHIP_STATE|SHIP_POSTAL_CODE|SKU|QTY_TO_SHIP
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|45100GR|24
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|65100LR|36

Now we see where we duplicated the ORDER_NO and the address as well as added the second SKU. Note that spaces are not an issue and all fields are trimmed during processing.

Now lets add a second sales order to this same file. This time we used the SHIP_ADDRESS_2 field and see why it was necessary to leave a blank in the first sales orders but carry the place holder.

ORDER_NO|ORDER_DATE|CUSTOMER_NO|SHIP_ADDRESS_1|SHIP_ADDRESS_2|SHIP_CITY|SHIP_STATE|SHIP_POSTAL_CODE|SKU|QTY_TO_SHIP
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|45100GR|24
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|65100LR|36
1234002|20121109|Widget Corp|989 SkyView Dr|Suite D|Tionesta|PA|16353|45100GR|18
1234002|20121109|Widget Corp|989 SkyView Dr|Suite D|Tionesta|PA|16353|65100LR|12
1234002|20121109|Widget Corp|989 SkyView Dr|Suite D|Tionesta|PA|16353|43200LR|36

These are the standard Faro CSV Fields we would like you to use.

Preferred Column Names for CSV files
Column Header NameDescriptionMin/Max SizeRequired
Order Information (Manditory)
BATCH_IDThis is your batch number and can
be used to group orders together
0 / 10N
ORDER_NOYour Order Number used to track in
Radio Beacon
1 / 15Y
CUSTOMER_NOUsed to group customer orders together in Radio Beacon0 /15N
CUST_ORD_NOThe Customer Order Number similiar to ORDER_NO0 /15N
ORDER_DATEThe date used to track this order 8/8 Y
CANCEL_DATEIf not shipped by this date then cancel order 0/8 N
DONT_SHIP_BEFORE_DATEFuture Ship Date, hold till this day0/8 N
DATE_REQRDDate SKU must be delivered by0/8N
Shipping Information (Manditory)
RECIPIENT_NAMEShipto Name 1/35 Y
SHIP_ADDRESS_1Shipto Addr 1 2/35 Y
SHIP_ADDRESS_2Shipto Addr 2 2/35 N
SHIP_SHIP_CITYShipto SHIP_CITY 2/35Y
SHIP_SHIP_STATEShipto SHIP_STATE 2/2Y
SHIP_POSTAL_CODEShipto SHIP_POSTAL_CODEcode 5/10Y
SHIP_COUNTRYShipto Country Code 2/2Y
MARK_FOR_NAME3RD PARTY BILLING Name 1/35 N
MARK_FOR_ADDRESS_13RD PARTY BILLING Addr 1 2/35 N
MARK_FOR_ADDRESS_23RD PARTY BILLING Addr 2 2/35 N
MARK_FOR_SHIP_CITY3RD PARTY BILLING CITY 2/35N
MARK_FOR_SHIP_STATE3RD PARTY BILLING STATE 2/2N
MARK_FOR_POSTAL_CODES3RD PARTY BILLING POSTAL CODE 5/10N
MARK_FOR_COUNTRY3RD PARTY BILLING Country Code 2/2N
MARK_FOR_ACCOUNT3RD PARTY BILLING ACCOUNT NUMBER 0/20N
SHIP_EMAIL_ADDRShipto Email Address0/40 N
SHIP_VIAShip Using this carrier ie UPS FEDX 1/15 Y
SHIP_METHODPreferred Shipping method ie GRND, OVERNIGHT,3DAY1/15 Y
STORE_NOShipto Store Number0/12N
MESSAGE1Custom Message 1 0/100 N
MESSAGE2Custom Message 2 0/100 N
EXTRA1Optional Information 1 0/100 N
EXTRA2Optional Information 2 0/100 N
Buyer Information (Optional)
BUYER_NAMEPurchaser0/35 N
BUYER_ADDRESS_1Purchaser Addr 10/35N
BUYER_ADDRESS_2Purchaser Addr 20/35N
BUYER_SHIP_CITYPurchaser SHIP_CITY0/35N
BUYER_SHIP_STATEPurchaser SHIP_STATE0/2N
BUYER_POSTAL_CODEPurchaser SHIP_POSTAL_CODE 0/10 N
BUYER_EMAILPurchaser Email Address0/40N
BUYER_PHONE_NUMBERPurchaser Phone #0/25N
SKU and Prices (Manditory)
SKUSKU Sku used in Radio Beacon Inventory 1/20Y
LINE_NOOrder Line Number 12N
CUST_PROD_NAMECustomer Product Number
Can be printed on Packslips
0/15N
DESCRIPTIONSKU Description0/42N
UPCUPC Code 0/20N
STYLESKU Style Number0/80 N
PACKSIZESKU Pack Size0/5 N
QTY_TO_SHIPTotal QTY_TO_SHIP to ship
Must be a multiple of PACKSIZE if PACKSIZE is greater than 1
1/11 Y
SKU_PRICESelling Price0/8.2 N
SKU_COSTCost Price 0/8.2 N
GIFT_WRAPGift Wrapping Description0/80 N
To download an example csv file for your review click here

Common Errors

Spelling and consistancy is important for headers. Address 1 does not equal SHIP_ADDRESS_1. SHIP_ADDRESS_1 does not equal Addr 1. SHIP_STATE does not equal ST. Header fields may not change without consulting Faro first.

You may not add a field at your convenience. If you need to add Customer_PO as a field then call or write us first. The computer is not smart enough to understand that you need this new field. The field won't magically appear in the right place. It will force an error.

Sending your data twice within the same hour and invalidating your data. Simply put, do not resend data without consulting Faro first.

A product SKU may not have a backslash or forward slash "/"     "\" in it and may only be 20 chararacters in length. There is not a dash "-" on the hand held scanners. Please avoid the "-" character in all data. We can setup a translation table but this creates additional work. Your product must conform to Radio Beacon (C) and we did not write the software.

SHIP_STATEs and Country Codes are two characters in length

Po Numbers are only 15 characters in length

You may not re-use Sales Order Numbers. If the order is active and currently is not allocated, if you re-sent it, will overwrite the existing order. Otherwise, the order is rejected by Radio Beacon(c) by default.

Sending improper dates not in ASCII format might cause delays. Please be careful on dates!.

Mixing PO Line SKUs is the same as sending the data twice in the world of computers. Do not allow the following to happen! PO 1234001 is split with PO 1234002 and invalidates itself. It will never make it to Radio Beacon.

ORDER_NO|ORDER_DATE|CUSTOMER_NO|SHIP_ADDRESS_1|SHIP_ADDRESS_2|SHIP_CITY|SHIP_STATE|SHIP_POSTAL_CODE|SKU|QTY_TO_SHIP
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|45100GR|24
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|65100LR|36
1234002|20121109|Widget Corp|989 SkyView Dr|Suite D|Tionesta|PA|16353|45100GR|18
1234002|20121109|Widget Corp|989 SkyView Dr|Suite D|Tionesta|PA|16353|65100LR|12
1234002|20121109|Widget Corp|989 SkyView Dr|Suite D|Tionesta|PA|16353|43200LR|36
1234001|20121109|AJAX Corp|33 Pleasant Ave||Niles|Oh|44446|43200LR|72

Shipping Codes

We must agree on shipping terms. UPS is not the same United Parcel. Sometimes we need UPS1 sometimes it will ship LVLA, spelling is very important to be understood at our shipping department. Unless the shipping terms are predermined from a list we both acknowledge, the "Ship Via" will default to "UPS" and ship method will be "UNKNOWN".

Imagine your customer had a desire for overnight shipping and was missed due to improper ship methods being sent. That would not be good for either of us. So the rule is, it must be agreeded upon and acknowledged by our system.

Shipping Codes are case sensitive. "UPS" does not equal "ups" in code translation.

 

Whatever it Takes... for YOU!

Faro will help you each step of the way to ensure your products get shipped. We both rely on your data and following these instructions is very important. If you have questions please call the Faro ITSG department during normal business hours.

Normal business hours are from 8 AM to 5 PM EST

Air Ship Truck
Site Map   |   Privacy Policy  
Corporate Office: 6450 LaSalle Drive  • Lockbourne, OH 43137  •  (614) 497-1700