Tools

1place Data Conversion Field Mapping Notes

Author: Steve Childs Reference Number: AA-02758 Created: 2020-10-05 13:30 Last Updated: 2023-06-15 15:18

0 Rating/ Voters

Data Conversion File Preparation Overview & General Notes

This article outlines the various EXCEL files that can be created to Import various types of data into the OneSource Cloud version.
If using the OneSource Import Wizard to import data the file Field/Column names do NOT need to be the same as the Field Names listed below (as they can be mapped to the names of the columns in your file). However the wizard will auto map the fields if the field names listed below are the same fields listed in your Excel files.

Customer Information

Customer List (for general customer data)

Field Name	Required	Special Instructions (to User)
CustomerNumber	Yes	(REQUIRED). This is the unique Customer ID.
AddressType	Yes	This is the Address Type of the Customer. This will be 1 of these 3 optional values: 'Both (Bill To & Ship To)' or 'Ship To' or 'Bill To'.
IsSubCustomer		This is a True or False value for the Customer. It is used to determine if the customer is sub customer or not.
ParentCustomer		This is the Parent Customer value for Customer (if applicable).
Active		This is the True or False value for if the customer record is Active or not.
Company	Yes	This is the Company Name for Customer.
Prefix		This is the Prefix value of the Customer.
FirstName		This is the First Name of the Customer.
LastName		This is the Last Name of the Customer.
Title		This is the Title of the Customer.
Street		This is the Street of the Customer.
Suite		This is the Suite of the Customer.
City		This is the City of the Customer.
State		This is the State of the Customer.
ZipCode		This is the Zip Code of the Customer.
Region		This is the Region of the Customer.
Country		This is the Country of the Customer.
Phone		This is the Phone # of the Customer.
PhoneExt		This is the Phone Ext of the Customer.
Fax		This is the Fax # of the Customer.
CustomerType		This is the Customer Type.
CustomerSubType		This is the Customer Sub Type.
Status		This is the Status value for Customer.
CompanyEmail		This is the Company Email of the Customer.
CompanyWebsite		This is the Company Website of the Customer.
ShippedVia		This is the Shipped Via of the Customer.
Warehouse		This is the Default Warehouse of the Customer.
DefaultPricing		This is the Default Pricing type for the Customer. The value will be any of the following: Discount, Markup, Multiplier, Item Price Level, or Item List Price.
DefaultPricingDiscount		This is the Default Discount % for Customer (if applicable). This is only applicable if the Default Pricing = Discount
DefaultPricingMarkup		This is the Default Markup % for the Customer (if applicable). This is only applicable if the Default Pricing = Markup
DefaultPricingMultiplier		This is the Multiplier value for Customer. This is only applicable if the Default Pricing = Multiplier
DefaultPricingCode		This is the Default Pricing Code for the Customer (if applicable). This is only applicable if the Default Pricing = Item Price Level
PaymentTerms		This is the Default Payment Terms for the Customer. This will be a string of text, such as 'Net 30'.
PaymentMethod		This is the Default Payment Method for Customer. This will be a string of text, such as 'Check'.
CreditLimit		This is the Credit Limit value for Customer.
CreditDays		This is the Credit Days for Customer.
TaxExempt		This is the Tax Exempt value for Customer. Set this to Yes, or True or 1 (if the Customer is Tax Exempt) or No, or False, or 0 (if the Customer is NOT Tax Exempt).
TaxExemptNum		This is the Tax Exempt Number for Customer.
CreatedDate		This is the date the Customer record was first created.
CreatedBy		This is the name of the person who created the Customer record a Customer.
ModifiedDate		This is the date the Customer record was last modified.
ModifiedBy		This is the name of the person who last modified the Customer record.
QBOSync		This should be a Yes (or 1) if you want the record to SYNC into QuickBooks Online, or a No (or 0) if you do NOT want the Customer to sync with QuickBooks Online. Note: If the Customer is used on any Invoices that get synced into QuickBooks online it will sync automatically.
Comments		Any notes or comments about the Customer.
SICCode		This is the SIC Code value for Customer.
LastCampaignDate		This is the Last Campaign Date for Customer.
LastCampaignMethod		This is the Last Campaign Method for Customer.
LastCampaignPiece		This is the Last Campaign Piece for Customer.
NextCampaignMethod		This is the Next Campaign Method for Customer.
NextCompaignPiece		This is the Next Campaign Piece for Customer.
LastContactDate		This is the Last Contact Date for Customer.
LastContacted		This is the Last Contacted value for Customer.
LastContactBy		This is the value who will last contact a Customer.
NextContactDate		This is the Next Contact Date value for Customer.
NextContactBy		This is the value who will next contact a Customer.

Customer List 'Contacts' (This table relates to the Customers table - 1 to many)

Field Name	Required	Special Instructions (to User)
CustomerID	Yes	This is the Customer number or Customer Company Name for the contact.
PrimaryContact		This is a boolean type data. This is used to make a contact to PrimaryContact for Customer.
FirstName		This is the First name for the contact.
LastName		This is the Last name for the contact.
ContactType		This is the Contact Type for the contact.
Email		This is the Mail address for the contact.
WorkPhoneDirLine		This is the Work Phone Directory Line for the contact.
PhoneOther		This is the Phone Number for the contact.
WorkFax		This is the Fax Number for the contact.
CellPhone		This is the Cell Phone Number for the contact.
PagerPhone		This is the Pager Number for the contact.
HomePhone		This is the Home Number for the contact.
Birthday		This is the Birthday date for the contact.
ContactNotes		This is the Notes for the contact.

Customer - Custom Pricing TEMPLATES (If you care to create 'templates' of Custom prices to apply to new or existing)

Field Name	Required	Special Instructions (to User)
GroupName	Yes	(REQUIRED). This is the Name of the Pricing Template.
Description
ItemNumber
PricingCategoryID
PriceLevel
QtyLow
QtyHigh
Discount
Markup
Multiplier
SpecificPrice

Customer - Custom Pricing (This table holds Custom prices copied from 1 or more Custom Pricing Templates and/or Custom prices manually added to various customers by users).

Field Name	Required	Special Instructions (to User)
CustomerID	Yes	This is the Customer number or Customer Company Name for the contact.
PricingTemplatesID
ItemID
PricingCategoryID
PriceLevel
QtyLow
QtyHigh
Discount
Markup
Multiplier
SpecificPrice
Lock

Vendor Information

Vendor List

Field Name	Required	Special Instructions (to User)
VendorNumber	Yes	(REQUIRED). This is the Vendor Number.
Active		This is a Active value (boolean) for Vendor.
VendorPOType		This specifies the 'type' of PO. The acceptable values are 1, 2, or 3. 1=All PO Types, 2=Local / Special Order PO's Only, 3=Long Distance / Sea Container PO's Only
VendorAccountNumber		This is the Active value (boolean) for Vendor.
VendorName	Yes	(REQUIRED). This is the Vendor Name.
Salutation		This is the Salutation for Vendor.
FirstName		This is the First Name for Vendor.
LastName		This is the First Name for Vendor.
Title		This is the Title for Vendor.
Street		This is the Street value for Vendor.
Suite		This is the Suite value for Vendor.
City		This is the City value for Vendor.
State		This is the State value for Vendor.
PostalCode		This is the Postal Code for Vendor.
Country		This is the Country for Vendor.
Phone		This is the Phone Number value for Vendor.
Fax		This is the Fax Number for Vendor.
PaymentTerms		This is the Payment Terms for Vendor.
CreditLimit		This is the Credit Limit for Vendor.
ProductsServices		This is the Products Services for Vendor.
SICCode		This is the SIC Code for Vendor.
EmailAddressCompany		This is the Email Address for Vendor.
WebSite		This is the Web Site for Vendor.
Region		This is the Region for Vendor.
CreatedDate		This is the Created Date for Vendor.
CreatedBy		This is the value to store who will create a Vendor.
ModifiedDate		This is the Modified Date for Vendor.
ModifiedBy		This is the value to store who will update a Vendor.
QBOSync		This is the QBO Sync for Vendor.
Comments		This is the Comments value for Vendor.

Vendor Contacts (This table relates to the Vendors table - 1 to many)

Field Name	Required	Special Instructions (to User)
VendorID	Yes	(REQUIRED). This is the Vendor Number or Vendor Name for the contact.
PrimaryContact		This is the boolean type data. This is used to make a contact to PrimaryContact for Vendor.
FirstName		This is the First name for the contact.
LastName		This is the Last name for the contact.
ContactType		This is the Contact Type for the contact.
Email		This is the Mail address for the contact.
WorkPhoneDirLine		This is the Work Phone Directory Line for the contact.
PhoneOther		This is the Phone Number for the contact.
WorkFax		This is the Fax Number for the contact.
CellPhone		This is the Cell Phone Number for the contact.
PagerPhone		This is the Pager Number for the contact.
HomePhone		This is the Home Phone Number for the contact.
ContactNotes		This is the Notes for the contact.

Item (Parts List) Information

Item List

Field Name	Required	Special Instructions (to User)
ItemNum	Yes	(REQUIRED). This is the Item Number.
Active		This is the Active value (Boolean) for Item.
Type		This is the Type for Item.
Description		This is the Description for Item.
Category		This is the Category for Item.
SubCategory		This is the Sub Category for Item.
SubCategory2		This is the SubCategory2 for Item. (For Auto Parts customers, this is the Year Range, such as 08-12)
SubCategory3		This is the SubCategory3 for Item. (For Auto Parts customers, this is the Make, such as Honda)
SubCategory4		This is the Model for Item. (For Auto Parts customers, this is the Model, such as Accord)
PricingCategory		This is the Pricing Category for Item.
POCategory		This is the PO Category for Item.
Manufacturer		This is the Manufacturer for Item.
OEMModelNumber		This is the OEM Model Number for Item.
AverageCost		This is the Average Cost for Item.
ListPrice		This is the List Price for Item.
SpecialNotes		This is the Special Notes for Item.
UnitofMeasure		This is the Unit of Measure for Item.
MatrixPricing		This is the Matrix Pricing for Item.
Taxable		This shows if the item is Taxable.
AmountOrdered		This is the Amount Ordered for Item.
QtyInStock		This is the Qty In Stock for Item.
QtyOnBackOrder		This is the Qty On Back Order for Item.
QtyOnPOs		This is the Qty On PO's for Item.
SpecialOrder		This shows if the item is a Special Order Item.
Assembly		This shows if the Item is an Assembly (Bundle).
BrokenCasePricingType		This shows the item Broken Case Pricing Type.
BrokenCasePriceCode		This is the Broken Case Price Code for Item.
BrokenCaseMultiplier		This is the Broken Case Multiplier for Item.
Commissionable		This shows if the item is Commissionable.
MasterItemNumber		This is the Master Item Number for Item.
YearsListing		This is the Years Listing for Item.
OrigItemNum		This is the Orig Item Number for Item.
OEMPrice		This is the OEM Price for Item.
InterchangeNumber		This is the Interchange # for Item.
LastAddedCost		This is the Last Added Cost for Item.
EcomRetailPrice		This is the Ecom Retail Price for Item.
DataConversionNotes		These are Data Conversion Notes for Item.
CreatedBy		This shows who created the Item.
CreatedDate		This shows the date the item was created.
ModifiedBy		This shows who last modified the item.
ModifiedDate		This shows the last date the item was modified.
IncomeAccountRef		This is the Income Account ID for Item.
ExpenseAccountRef		This is the Expense Account ID for Item.
AssetAccountRef		This is Asset Account ID for Item.
QBOSync		This shows if the item will be synced with QuickBooks Online. The value will be = -1 if Yes.

Item Quantity in Stock

Field Name	Required	Special Instructions (to User)
Item #	Yes	(REQUIRED). This is an Item # that is already in OneSource.
Qty in Stock	Yes	(REQUIRED). This is the TOTAL quantity in stock right now. This value needs to be a whole number, such as 1 or 3 or 20. If the number is NOT > 0 the row will NOT be imported.
Qty Received		This is the Quantity originally received into stock. For example maybe you received 10 but now have 5 left in stock (which will be illustrated in the Qty in Stock field).
Date Received		This is the date that the item was received into Stock. (Note: If no date is selected OneSource will insert Today's date).
Warehouse	Yes	This is the Warehouse CODE you have assigned to the warehouse in OneSource. If you only have 1 warehouse just leave this field blank and it will be auto filled in for you.'
Cost	Yes	(REQUIRED). This is the individual unit cost you paid for the item from your vendor. Any records where the Cost is not > $0.00 will NOT be imported. If you paid any 'additional' costs associated with shipping the item to you list those costs in the field called: Additional (Landed Costs).
Additional (Landed Cost)		This represents any additional 'landed' (shipping) costs associated with the item.
Bin		This is the Bin location of the item.' (If you have more than 1 bin location be sure to make a separate 'row' on your spreadsheet for each unique bin location. For instance, if Item X had 5 in location 101 and 2 in location 501 then you would need to have 2 rows on your spreadsheet for Item X.
Lot / Serial #		This is the Lot / Serial # of the item.' (Like the Bin field, if you have more than 1 Lot / Serial # then be sure to make a separate 'row' on your spreadsheet for each unique Lot / Serial # for the item.
(internal notes)

Item Price Levels

Field Name	Required	Special Instructions (to User)
ItemID	Yes
MatrixPriceCode	Yes
QtyLow
QtyHigh
Price	Yes
DiscountPercent

Item Bundles (Assembly) Components

Field Name	Required	Special Instructions (to User)
BundleComponentID	Yes	This is the Bundle Component ID value for Item Bundle.
ItemID	Yes	This is an Item ID value for Item Bundle.
QtyNeeded		This is the Qty Needed value for Item Bundle.
AssemblyNotes		This is the Qty Needed value for Item Bundle.

Item Search Catalog (This is where Item Alias data is saved. This allows you to find the part by various year, make, and model, or by other searching methods).

Field Name	Required	Special Instructions (to User)
ItemNumber	Yes	This is the Item Number value for Item Catalog.
Description	Yes	This is the Description value for Item Catalog.
Make	Yes	This is the Make value for Item Catalog.
Model	Yes	This is the Model value for Item Catalog.
YearsListing	Yes	This is the Years Listing value for Item Catalog. The format should like something like this: 08,09,10,11,12 (assuming that the Year Range = 08-12)
Notes		This is the Notes for Item Catalog.
YearRange		This is the Year Range value for Item Catalog.

Vendor Item Numbers (1 Vendor)

This is used for importing a List of Item Number from ONE Vendor at a time. (This is typically used AFTER the initial Vendor import)
Every ItemID must exist as an item in the Items table.

Field Name	Required	Special Instructions (to User)
ItemID	Yes	(REQUIRED). This is an Item # that is already in the OneSource.
VendorItemNum	Yes	(REQUIRED). This is the Vendor Item Number for Item Vendor.
VendorCost		This is the Vendor Cost for Item Vendor.
VendorLeadTime		This is the Vendor Lead Time(Boolean) for Item Vendor.
CasePack		This is the Case Pack(Boolean) for Item Vendor.
CostLastChangeDate		This is the Cost Last Change Date for Item Vendor.
LastOrderDate		This is the Last Order Date for Item Vendor.
QtyOnOrder		This is the Qty On Order for Item Vendor.
RoundUpQtyToCaseQtyOnPO		This is the Round Up Qty To Case Qty On PO(Boolean) for Item Vendor.
ConvertQtyToCaseQtyOnPO		This is the Convert Qty To Case Qty On PO(Boolean) for Item Vendor.
CubicSquareFt		This is the Cubic Square Ft for Item Vendor.
Notes		This is the Notes for Item Vendor.

Vendor Item Numbers (All Vendors)

This is used for importing a FULL LIST of ALL VENDORS Item numbers.
Every VendorID must exist as a Vendor in the Vendors table.
Every ItemID must exist as an Item in the Item table.

Field Name	Required	Special Instructions (to User)
ItemID	Yes	(REQUIRED). This is an Item # that is already in OneSource.
VendorID	Yes	(REQUIRED). This is the related Vendor Number in OneSource.
VendorItemNum	Yes	This is the Vendor Item Number for Item Vendor.
VendorCost		This is the Vendor Cost for Item Vendor.
VendorLeadTime		This is the Vendor Lead Time(Boolean) for Item Vendor.
CasePack		This is the Case Pack(Boolean) for Item Vendor.
CostLastChangeDate		This is the Cost Last Change Date for Item Vendor.
LastOrderDate		This is the Last Order Date for Item Vendor.
QtyOnOrder		This is the Qty On Order for Item Vendor.
RoundUpQtyToCaseQtyOnPO		This is the Round Up Qty To Case Qty On PO(Boolean) for Item Vendor.
ConvertQtyToCaseQtyOnPO		This is the Convert Qty To Case Qty On PO(Boolean) for Item Vendor.
CubicSquareFt		This is the Cubic Square Ft for Item Vendor.
VendorQIS		When you import or update Vendor Items this is the Qty in Stock the Vendor has reported to you.
QISLastUpdated		When you import or update Vendor Items this is the Date the Qty in Stock was last updated. If this column is left blank it will fill in with the current date.
Notes		This is the Notes for Item Vendor.

Invoices & Credit Memo's

Invoice & Credit Memo HEADERS (IMPORT 1st)

This is the Invoices & Credit Memo's HEADER import. (The LINE ITEMS are imported in a separate file).
The Sales Tax Code and Rate will be auto calculated by the import process.
If the QuickBooks Online syncing feature will be used then the QBOSync will be set to True if the Invoice Balance Due NOT = $0. Otherwise set the QBOSync = False.
If the Invoice has a Total Due = < 0 the negative number will be auto converted to a positive number and the Invoice Type will be set to = C.
If the Invoice Amount DUE > $0 then the Invoice Paid will auto set = False and a Payment will be auto created.

Field Name	Required	Special Instructions (to User)
InvoiceNumber	Yes	(REQUIRED). This field must be a unique alpha numeric Invoice #.
InvoiceDate	Yes	(REQUIRED). This field must contain a valid date.
BillToCustomerNumber	Yes	(REQUIRED). This must be a valid alpha numeric Bill To Customer #.
BillToContactName		This is the Customer contact name, such as John Doe.
BillToCompanyName		This is the Bill To Company Name, such as: ABC Company
BillToStreet		This is the Bill To Street address, such as: 12345 Somewhere Street
BillToCityStateZipPostalCode		This is the Bill To City, State Zip, such as: 12345 Somewhereville, UT 84092
ShipToCustomerNumber	Yes	(REQUIRED). This must be a valid alpha numeric Ship To Customer #.
ShipToContactName		This is the Ship To Contact name, such as: Jane Smith
ShipToCompanyName		This is the Ship To Company Name, such as: ABC Company
ShipToStreet		This is the Ship To Street, such as: 456 Some Ave
ShipToCityStateZipPostalCode		This is the Ship To City, State, Zip / Postal Code, such as: Happyville, CA 92806
SubTotal		This is the Invoice SubTotal field. It should represent the total of the Line Items. If this field is left blank $0 will be inserted.
FreightOrOtherChanges		This is the Invoice Freight / Other field. If this field is left blank $0 will be inserted.
TotalTax		This is the Total Tax amount for this Invoice. If this field is left blank a $0 will be inserted and NO taxes will be changed for this Invoice or Credit Memo.
GrandTotal	Yes	(REQUIRED). This is the Grand Total of the Invoice or Credit Memo.
TotalPayments		This is for the Total Payments already applied to this Invoice or Credit Memo. If this field is left blank the Balance Due will be = GrandTotal.
BalanceDue		If this field is left blank the value will be set to $0.
InvoiceType		This field will usually have an 'I' (for Invoice) or a 'C' (for Credit Memo).' If this field is left blank any transaction that is imported where the Total is a 'positive' number this field will automatically be set to 'I' (and will be imported as an Invoice). Any transaction where the Total is a 'negative' number this field will automatically be set to 'C' (and will be imported as a Credit Memo.
PaymentTerms	Yes	(REQUIRED). This is the Payment Terms. (Note: If this field is left blank the 'Net 30' will be auto inserted).
CustomerPONumber		This is the Customer PO #.
SourceOfOrder		This is the Source of the Order.
InvoiceComments		This is the Comments (customer notes) field.
EnteredBy		This is the name of the user who created the Invoice.
JobID		This is the Job ID #.

Invoice & Credit Memo LINE ITEMS (IMPORT AFTER HEADERS)

This file is to be used to create LINE ITEMS that relate to the INVOICE HEADERS file.
Every Invoice # in this file MUST exist in the HEADERS file.
Every ItemNumber in this file MUST exist in the Item list file.

Field Name	Required	Special Instructions (to User)
InvoiceNumber	Yes	(REQUIRED). This field must be a unique alpha numeric Invoice #.
ItemNumber	Yes	(REQUIRED). This is the Item Number that should already be added or imported into OneSource.
QtyOrdered	Yes	This is the Quantity Ordered by the Customer.
QtyShipped	Yes	This is the Quantity Shipped to the Customer for this Order. Set at 0 if none shipped.
BOQty		This is the Quantity that have been Back Ordered and not Shipped yet. Set this value to 0 if none.
PrevShipped		This is the Quantity that were Previously Shipped on a related Sales Order, if this is a Sales Order Back Order. Set this value to 0 if none.
PrevQtyReturned		This is the Quantity that have been returned for this item on this Sales Order. Set this value to 0 if none.
ItemDescription	Yes	This is the Item Description.
ListPrice		This is the List Price. This field is optional.
UnitPrice		This is the Unit Price. This is the Price BEFORE any Discount has been applied.
Discount		This is the Discount given off the Unit Price. Set to 0 if none.
NetPrice	Yes	This is the final Net Price, including any discount given.
Taxable		Was this line item Taxable? If so type Yes, if not type No.
LineTotal	Yes	What is the EXTENDED Line Total? (QtyOrdered x NetPrice)
DateShipped		What date was this item shipped? This field is optional.
LineItemComments		Internal line item comments not visible to the Customer.
SerialNumber		This is the Serial # of the item, if applicable. This field is optional.
UnitCost		This is the Unit Cost. The COST 'each' is $5 then you would enter $5.00.

Sales Orders

Sales Orders HEADERS (UNSHIPPED) (Do This 1st)

This is the HEADER file for Sales Order Header information.
Sales Tax Codes and Rate will be auto calculated upon import.

Field Name	Required	Special Instructions (to User)
SalesOrderNumber	Yes	(REQUIRED). This field must be a unique alpha numeric Sales Order #.
SalesOrderDate	Yes	(REQUIRED). This field must contain a valid date.
BillToCustomerNumber	Yes	(REQUIRED). This must be a valid alpha numeric Bill To Customer #.
BillToContactName		This is the Customer contact name, such as John Doe.
BillToCompanyName		This is the Bill To Company Name, such as: ABC Company
BillToStreet		This is the Bill To Street address, such as: 12345 Somewhere Street
BillToCityStateZipPostalCode		This is the Bill To City, State Zip, such as: 12345 Somewhereville, UT 84092
ShipToCustomerNumber	Yes	(REQUIRED). This must be a valid alpha numeric Ship To Customer #.
ShipToContactName		This is the Ship To Contact name, such as: Jane Smith
ShipToCompanyName		This is the Ship To Company Name, such as: ABC Company
ShipToStreet		This is the Ship To Street, such as: 456 Some Ave
ShipToCityStateZipPostalCode		This is the Ship To City, State, Zip / Postal Code, such as: Happyville, CA 92806
SubTotal		This is the Sales Order SubTotal field. It should represent the total of the Line Items. If this field is left blank $0 will be inserted.
FreightOrOtherChanges		This is the Sales Order Freight / Other field. If this field is left blank $0 will be inserted.
TotalTax		This is the Total Tax amount for this Sales Order. If this field is left blank a $0 will be inserted and NO taxes will be changed for this Sales Order.
GrandTotal	Yes	(REQUIRED). This is the Grand Total of the Sales Order.
BalanceDue		If this field is left blank the value will be set to $0.
SalesOrderStatus		Each Sales Order Status field should have ONE of these values: 'New', 'To Print & Pick', 'Picking', 'To Invoice', or 'To Load/Ship'. If this field is left blank the default value inserted will be: 'To Print & Pick'.
PaymentTerms		This is the Payment Terms. (Note: If this field is left blank the Net 30 payment term will be auto inserted).
CustomerPONumber		This is the Customer PO #.
SourceOfOrder		This is the Source of the Order.
SalesOrderComments		This is the Comments (notes to the customer) field on the footer of the Sales Orders.
EnteredBy		This is the name of the user who entered the Sales Order.
JobID		This is the Job ID #.

Sales Order LINE ITEMS (UNSHIPPED)

This file is to be used to create LINE ITEMS that relate to the SALES ORDER HEADERS file.
Every Sales Order # in this file MUST exist in the HEADERS file.
Every ItemNumber in this file MUST exist in the Item list file.
For reconciliation simplicity, it is recommended that only OPEN Sales Order by imported into OneSource.

Field Name	Required	Special Instructions (to User)
SalesOrderNumber	Yes	(REQUIRED). This field must be a unique alpha numeric Invoice #.
ItemNumber	Yes	(REQUIRED). This is the Item Number that should already be added or imported into OneSource.
QtyOrdered	Yes	This is the Quantity Ordered by the Customer.
QtyShipped	Yes	This is the Quantity Shipped to the Customer for this Order. Set to 0 if none shipped.
BOQty		This is the Quantity that have been Back Ordered and not Shipped yet. Set this value to 0 if none.
PrevShipped		This is the Quantity that were Previously Shipped on a related Sales Order, if this is a Sales Order Back Order. Set this value to 0 if none.
ItemDescription	Yes	This is the Item Description.
ListPrice		This is the List Price. This field is optional.
UnitPrice		This is the Unit Price. This is the Price BEFORE any Discount has been applied.
Discount		This is the Discount given off the Unit Price. Set to 0 if none.
NetPrice	Yes	This is the final Net Price, including any discount given.
Taxable		Was this line item Taxable? If so type Yes, if not type No.
LineTotal	Yes	What is the EXTENDED Line Total? (QtyOrdered x NetPrice)
DateShipped		What date was this item shipped? This field is optional.
LineItemComments		Internal line item comments not visible to the Customer.
SerialNumber		This is the Serial # of the item, if applicable. This field is optional.
UnitCost		This is the Unit Cost. The COST 'each' is $5 then you would enter $5.00.
Taxable		Was this line item Taxable? If so type Yes, if not type No.

Purchase Orders

List Type: Purchase Order HEADERS (Do This 1st)

This file is to be used to create PURCHASE ORDER HEADERS.
Every VendorID in this file must relate to a Vendor in the Vendors table.

Field Name	Required	Special Instructions (to User)
PurchaseOrderNum	Yes	(REQUIRED). This field must be a unique alpha numeric Invoice #.
PODate	Yes	This field contains the Date of the PO. Must be in proper Date format.
POStatus		If this field is left blank then 'Waiting For Delivery' will automatically be inserted in this field.
POReceived	Yes	This value needs to be = 'True' or 'Yes' or '1' if the PO has been received. Or 'False' or 'No' or '0' if the PO has NOT been received. If this field is left blank the field will be set to True.
DateExpected		This is the date you expect to receive the PO.
VendorID	Yes	(REQUIRED). This field must contain a valid Vendor ID from your old accounting system.
VendorStreet		This is the Vendor's street.
VendorCityStateZip		This is the Vendor's City, State Zip/Postal Code concatenated together into 1 string of data.
BillToWarehouseCode	Yes	(REQUIRED). This field must contain a valid Warehouse 'Code' (which you can get from the Warehouses entered in the settings of this OneSource app).
BillToWarehouseStreet		This is the Bill To Warehouse street.
BillToWarehouseCityStateZip		This is the Bill To Warehouse City, State, Zip/Postal Code
ShipToWarehouseCode	Yes	(REQUIRED). This field must contain a valid Warehouse 'Code' (which you can get from the Warehouses entered in the settings of this OneSource app).
ShipToWarehouseStreet		This is the Ship To Warehouse street.
ShipToWarehouseCityStateZip		This is the Ship To Warehouse City, State, Zip/Postal Code
POTotal	Yes	This is the total of all PO Line Items.
POWeight		This is the total of the weight from all of the PO Line Items.
POVolume		This is the total of the volume from all of the PO Line Items.
OrderedBy		Enter a User Name that is included in your list of OneSource users, or this field will be left blank.
Terms		Enter a Payment Term that is in OneSource or this field will be left blank.
FOB		This is the Free On Board value.
ShippedVia		This is the Shipped Via.
Comments		This is for any comments about the PO.
CreatedBy		This field must be a valid OneSource User Name. If not it will be left blank.
CountryOfOrigin		This is for the Country of Origin.
ContainerNum		This is for the Container Number, if applicable.

List Type: Purchase Order LINE ITEMS

This file is to be used to create LINE ITEMS that relate to the PURCHASE ORDER HEADERS file.
Every PurchaseOrderNum in this file MUST exist in the HEADERS file.
Every ItemNumber in this file MUST exist in the Item list file.

Field Name	Required	Special Instructions (to User)
PurchaseOrderNum	Yes	(REQUIRED). This field must be a unique alpha numeric Invoice #.
LineItemNum	Yes	(REQUIRED). This is a valid OneSource Item Number.
LineItemQtyOrdered	Yes	This is the Qty Ordered.
LineItemQtyReceived	Yes	This is the Qty Received.
LineItemReceived	Yes	This is a Yes or No value. Has the item been received?
LineItemDescription	Yes	This is the PO Line Item Description.
LineItemCost	Yes	This is the PO Line Item individual unit Cost.
LineItemAddedCost		This is the PO Line Item individual unit cost for 'extra' landed costs (which are costs not associated with the actual cost of the item).
LineItemPOLineTotal	Yes	This is the PO Line Total. This is calculated: LineItemQtyOrdered x LineItemCost.
LineItemWeight		This is the PO Line item weight of the item.
LineItemVolume		This is the PO Line Item volume.