Bulk Bill Upload

Created by Travis Lander, Modified on Sat, 2 Nov at 10:39 AM by Travis Lander

Description

 

 


Important Considerations:

  1. Bulk Uploads should be xlsx format with the first tab in the file as the upload template.                               

  2. If using custom fields on any documents to be uploaded, the format for the column header should follow this logic: "customFields.<property>" (case sensitive). For example, if a custom field created with a property title of "ExternalSource", this would look like this: customFields.ExternalSource
  3. If using custom dimensions on any documents to be uploaded, the format for the column header should follow this logic: Name of Custom Dimension as it appears in UI (case sensitive), followed by ".id". For example, if a custom dimension is created named "Region", the column header would be titled: Region.id 
  4. All Bills from an Upload will be given a System Job ID value, which can be used to filter in the Bills table to find and bulk edit/delete uploaded bills.                                
  5. Uploads have a maximum file size of 5MB (generally around 15-20k rows).                                
  6. Only one of Description/Item.number should be set.
  7.  Fields headers are not case sensitive.
  8. Within the template, the fields highlighted in yellow are required.
  9. Dates in Date Fields to be entered as ISO Date Format (YYYY-MM-DD). See Sample File in above Template.


Upload Fields

 

Required Fields










These fields are always required on upload






numberThis number field is used to connect lines together within this excel file, and not the number that the Bill is created with (the system will create this automatically). See the Sample File for more context.
Vendor.idThe ID of the Vendor as assigned by SoftLedger (you may need to look in the UI or export Vendor table to excel to gather).
invoiceDateTransaction date of the Bill (this will be used for any automated foreign currency translation). Entered as ISO Date Format (YYYY-MM-DD).

postingDateThe accounting date for the financial impact that this Bill carries when hitting the general ledger (often the same as Invoice Date). Entered as ISO Date Format (YYYY-MM-DD).
dueDateWhen the Bill is due for payment. Entered as ISO Date Format (YYYY-MM-DD).





Location.idThe ID of the Location where this Invoice is meant to be received.



APAccount.numberThe AP Account Number to be used in the Journal Entry produced from this Bill.


~Item.number~If billing for a specific Item already set up in SoftLedger, include the Item Number here. If not Billing against an Item, use the Description field.
~description~If not billing against a specific Item, enter a Description for the line item(s) in the Bill.

BillAccount.numberThis is the Expense Account Number for the line item (e.g. Travel Expense, Operating Expense, etc.)
quantityThis is required as a multiplier against the Amount field. If entering Description line items, this is often set to 1.
amountThe amount for the line item. If entering multuple quantities, the total amount for the line item will be Quantity x Price.










Optional Fields










These fields are optional, but may become required depending on the type of entry you create. For example, if you want to create an InterCompany Journal Entry, then the IC fields will become required.
referenceThis is a reference field that can often times be used to match a unique identifier from an external AP system.
ICLocation.idIf this is an InterCompany Bill, enter the ID of the Intercompany Location that should ultimately carry the expense of the Bill.
CostCenter.idIf assigning a Cost Center against the line item(s) of the Bill lines, enter the ID here.

Job.numberIf this Bill line item is part of a Job, enter the Job ID here.



Product.idIf this Bill line item is to be tagged against a Product, enter the Product ID here.


TaxCode.codeEnter the Code as created under the Tax Code section under Settings. The Tax Code will drive which Ledger Account the Tax Amount is coded to.
taxAmountEnter the Tax Amount for this line item. If no Tax Code has been selected, the Tax Amount will be coded to the default tax ledger account set under Settings>Accounts>Tax.
notesAdd rich text for any additional notes in this field.




customFields.<property>If using custom fields on any documents to be uploaded, the format for the column header should follow this logic: "customFields.<property>" (case sensitive). For example, if a custom field created with a property title of "ExternalSource", this would look like this: customFields.ExternalSource
custom.IdIf using custom dimensions on any documents to be uploaded, the format for the column header should follow this logic: Name of Custom Dimension as it appears in UI (case sensitive), followed by ".id". For example, if a custom dimension is created named "Region", the column header would be titled: Region.id

 

File Upload Process

 


  1. Select the saved upload file by clicking Choose File.
  2. Select the currency to upload these Bills in (each upload can only be in one currency).
  3. The file will either upload with a 'completed' status, or return errors in a 'failed' status (Depending on the number of entries, this could take several minutes to upload).

Troubleshooting errors:

If there is one or more errors. A table of errors will appear. The first column will either read "CSV Row" or "number"

  • CSV Row - signifies the row in the uploaded file causing the error(s) in the second column
  • number - signifies the number value causing the error(s).

After resolving the errors, re-upload the file to complete the process.

 

 

Bulk Import Table

On the Bulk Bill Upload tab, there is a table to review previous completed or failed upload attempts:

 

Table Actions:

  • Filters - Filter what appears in the table based on one or more fields available in the table.
  • Saved Views - You can create a set of filters that you would like to save to be able to quickly filter a table.
  • Column Selector - Hide and reveal extra columns and the number of rows visible in the table per page.
  • To review Bills brought in from an upload, you can copy the ID value in the table, and then paste that into the 'System Job' field within the Bills tab.

 

For further reference on bulk uploads see this article: Bulk Uploads

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article