Browse
 
Tools
Categories

 Featured
1place Data Conversion How To's (To Export and Transfer Files)

Author: Steve Childs Reference Number: AA-02758 Created: 2020-10-05 13:30 Last Updated: 2024-12-07 21:33 0 Rating/ Voters


Data Conversion File Preparation Overview & General Notes

  • This KB article outlines the various EXPORT files that can be created to IMPORT various types of data into 1place.
  • How to prep the files with the proper data and columns headers.  
  • How to Zip and Transfer Files.   

Exporting and Transferring Your Data Files 

Selecting the Proper EXPORT File Format

Depending on the accounting application you are using, you can usually find a tool inside of the application that will allow you to EXPORT your data to FILES that can be imported into another application.  The following are few file formats that are easiest to work with:

  • .xlsx (Excel 2007 or newer, which allows for over 2 billion lines in the excel file).
  • .xls (Excel 2003 or older, which allows for up to 64,000 lines in the excel file).
  • .mdb (Access 1997 or newer, which allows for up to 2 Gigabytes of data, and stores data in 'tables' of data)
  • .csv (text file, tab delimited format, which allows for virtually unlimited amount of lines, and usually DOES NOT get mis-formated by comma's in Company Names or Item Descriptions)
  • .csv (text file, comma separated format, which allows for virtually unlimited amount of lines, and SOMETIMES DOES get mis-formated by comma's in Company Names or Item Descriptions
  • .txt (text file, and could be tab delimited or comma separated or fixed width, which allows for virtually unlimited amount of lines, and SOMETIMES DOES get mis-formated by comma's in Company Names or Item Description)
  • Other file formats?  (Please contact your OneSource customer service rep for additional help if you cannot export your data into 1 of the file formats above).  

For more information on what types of data can be imported into 1place please see the sections below under the heading sdf

Preparing the Files to be Emailed or Uploaded

Depending on the SIZE of your files you may want to compress (ZIP up) your files following these steps:

  • Right click on the file, then select Compress To > Zip file 
  • Or, if using an older PC, Right click on the file, then select Send To > Compress (Zipped) File 

Emailing Your Files (if the file(s) are < 25 megabytes)

If none of your files are greater than 25MB in size you can group them together and send emails (with the files attached) so long as the file(s) does not exceed 25mb in size.

If the file(s) are too big see the next section.

Uploading Your Files to Google Drive (if the file(s) are 25 megabytes are larger)


If your file(s) are larger than 25MB you may want to upload them to an FTP site of your choice (if you have one).  Alternatively, you may want to just upload them to Google Drive.  (If you have a Gmail account you have a free Google Drive).  Just follow these steps to upload them to Google Drive:

1—Log into your GOOGLE DRIVE account, using: drive.google.com/  (Enter your gmail email and password to login).

2—Make a new Google folder to store the files in. (Click + New > New Folder, then enter a new Folder name).

3—Locate the new folder (in the list of files and folders) and double-click on the new folder to open the folder.  After resizing the browser window (so you can see the Google Drive folder AND your files)…drag and drop all of the files you want to send us into that folder.  (You will see them upload into the folder).

4—Next, go back to your list of files and folders.  (You can move up a level if you click on My Drive).  When you see the new folder click on the 3 dots ... > Share > Copy Link.

5--Paste the email link into email and send it to your dedicated OneSource Software customer service rep.  (This will allow him or her to click on the link and download the files).

Overview of Main Data Types 1place Can Currently Support (If the data exists in your system).

NOTE: Export ALL of the records of each time, except where noted otherwise.

*Key data types required for most imports.

  • Customer & Sales Information
    • * Customers (Customer ID, Company Name, Street, City, State, Zip, Primary Contact First Name, Primary Contact Last Name, Phone #, Etc)  
    • Customer Contacts (Contact ID, Contact First Name, Contact Last Name, Contact Email Address, Contact Phone#, Contact Extension, etc).
    • Customer Pricing (Default pricing information related to each specific Customer, by Pricing Type (x Discount, etc), and/or by Item #, and/or by Item Type.
    • Customer Payment Methods (Payment Method ID, Payment Method Description (Net 7 days, Net 15 days, Net 30 Days, Credit Card, etc)
    • Customer Tasks (Task ID, Task date, task type (call, email, etc), Task Description, Task Scheduled For, Task Completed By, Task Completion Status, etc)
    • Customer Jobs & Projects (Job ID, Job Date, Job Entered By, Job Short Description, Job Long Description, Job Status, etc)
    • Quotation Headers (Quote #, Bill To Customer ID, Ship To Customer ID, Quote Dat, Quote Entered By, Quote Payment Terms, etc...)  (For Auto Body Supply companies we recommend 1 month worth of Quotes)
    • Quotation Line Items (Quote Line ID, Quote #, Item ID, Qty, Item Description, List Price, Unit Price, Discount, Net Price, Line Total, etc) 
    • Sales Order Headers (Sales Order #, Bill To Customer ID, Ship To Customer ID, Sales Order Date, Sales Order Entered By, Sales Order Payment Terms, etc...)  (For Auto Body Supply companies we recommend only OPEN, NONE INVOICED Sales Orders)
    • Sales Order Line Items (Sales Order Line ID, Sales Order #, Item ID, Qty Ordered, Qty Shipped, Item Description, List Price, Unit Price, Discount, Net Price, Line Total, etc)
    • * Invoice / Credit Memo Headers (Invoice #, Bill To Customer ID, Ship To Customer ID, Invoice Date, Invoice Entered By, Invoice Payment Terms, Total Paid, Balance Due, etc...) (For most industries, to keep the database fast, we recommend the most recent 3-5 years worth.)
    • * Invoice / Credit Memo Line Items (Invoice Line ID, Invoice #, Item ID, Qty Ordered, Qty Shipped, Item Description, List Price, Unit Price, Discount, Net Price, Line Total, etc)
    • * Sales Tax Rates (Sales Tax Rate ID, Sales Tax Rate Name, Sales Tax Rate %, etc)
    • Shipping Methods (Shipping Method ID, Shipping Method Name (Truck 1, Truck 2, UPS, FedEx, etc)
  • Vendor, Inventory & Purchasing Information.  
    • * Vendors (Company Name, Street, City, State, Zip, Primary Contact First Name, Primary Contact Last Name, Phone #, Etc)
    • Vendor Contacts (Contact First Name, Contact Last Name, Contact Email Address, Contact Phone#, Contact Extension, etc).
    • Items (Item Number, Item Description, Item Qty in Stock, Item Category, Item SubCategory, Item Default Bin Location, etc) 
    • Item Vendors (Item Number, Vendor Number, Vendor Item #, Vendor Item Cost, etc). 
    • Item Prices (PriceID, Item Number, Discount (if applicable), Markup (if applicable), PriceLevelName (if applicable), QtyLow (if applicable), QtyHigh (if applicable), etc)
    • Item Pricing Templates.  (These may be easier/faster to re-create by hand?)
    • Item Stock (Receipt ID, Item Number, Qty Received, Qty in Stock, Cost, Additional (Landed) Cost, PO #, Warehouse, Bin Location, etc) 
    • Item Catalog (Item Number, Year Range (like 08-12), YearsListing (like 08,09,10,11,12), Make, Model, etc)
    • Item Assemblies (Item Number, Component Item Number, Qty Needed, Assembly Notes, etc) 
    • Item Pictures (Item Number, Picture Path, PictureName, etc)
    • Purchase Order Headers  (PO#, Vendor Number, Ship To Warehouse, Bill To Warehouse, PO Date, PO Entered By, Received (Yes or No), Date Received, etc)   (For most industries, to keep the database fast, we recommend 2-3 years worth)
    • Purchase Order Line Items  (PO Line ID, PO #, Qty Item ID, Qty Ordered, Qty Received, Received (Yes or No), Item Description, Cost, Added Cost, Line Total, etc)
    • Warehouses (Warehouse ID, Warehouse Name, Warehouse Address, etc)
  • Other Info
    • Users (UserID, User Name, User Email, 
    • User Object Security (Which screens can the user VIEW, ADD records on, EDIT records on, PRINT records on, or DELETE records on?  This is probably easier to recreate by hand). 

Table and Field Explanations

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 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 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 1place.
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 1place will insert Today's date).
Warehouse Yes This is the Warehouse CODE you have assigned to the warehouse in 1place.  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 1place.
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 1place.
VendorID  Yes (REQUIRED). This is the related Vendor Number in 1place.
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.


Invoice & Credit Memo Headers (IMPORT Before Line Items)  

  • 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 1place.
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 HEADERS (UNSHIPPED) (Import Before Line Items) 

  • 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) (Import After Headers)

  • 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 1place.
 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 1place.
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 Order HEADERS (Import Before Line Items)

  • 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 1place). 
    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 1place).
    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 1place users, or this field will be left blank.
    Terms
    Enter a Payment Term that is in 1place 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 1place 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. 



    Purchase Order LINE ITEMS (Imort After Headers)

    • 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 1place 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.