The following is a list and explanation of each of the fields you can include when importing vendor credits.
Important Note: If you sync with an accounting software, we don't recommend importing records via CSV into Bill.com unless they don’t exist in your accounting software at all to avoid duplicates and sync errors.
| Field Name | Required? | Key Field? | Maximum Length | Description | Accepted Values | Additional Information |
|---|---|---|---|---|---|---|
| Active? | No | No | NA | Denotes if this Vendor Credit is active or inactive | - Active - Inactive |
- Read only - Cannot Activate or Inactivate existing vendor credits via import |
| Vendor Id | No | Yes | 20 characters | The Vendor Id of the Vendor for this Vendor Credit | - Once set, this field cannot be updated via import - Requires an exact match with the desired Vendor's Vendor Id (for updating) - If Vendor Name and Vendor Id are both populated for a Vendor, both must be provided to correctly identify that Vendor |
|
| Vendor Name* | Yes | Yes | 100 characters | The Vendor Name of the Vendor for this Vendor Credit | - Once set, this field cannot be updated via import - Requires an exact match with the desired Vendor's Vendor Name (for updating) - If Vendor Name and Vendor Id are both populated for a Vendor, both must be provided to correctly identify that Vendor - The desired Vendor must be active in Bill.com |
|
| Ref #* | Yes | Yes | 100 characters | The reference number for this Vendor Credit, typically provided by the vendor | - Once set, this field cannot be updated via import - Requires an exact match with the desired vendor credit's reference # (for updating) |
|
| Credit Date* | Yes | Yes | NA | The credit date for this Vendor Credit, typically provided by the vendor | - Once set, this field cannot be updated via import - Requires an exact match with the desired Vendor Credit's Date (for updating) - Dates must be formatted MM/DD/YY, MM/DD/YYYY, MM-DD-YY, or MM-DD-YYYY - Single digits do not require a leading zero |
|
| GL Posting Date | No | No | NA | The date that this Vendor Credit is posted to your general ledger in your accounting system, if supported | - Dates must be formatted MM/DD/YY, MM/DD/YYYY, MM-DD-YY, or MM-DD-YYYY - Single digits do not require a leading zero |
|
| Description | No | No | 4000 characters | The description of this Vendor Credit | ||
| Vendor Credit Line Item Amount | No | No | NA | The amount for this line item on this Vendor Credit | - Must be in the range of -9999999 to 9999999 - Does not support fractions of cents - If this is left blank, it will appear as blank; this is treated as $0.00 - Accepts values with or without a $; negative values must omit the $ |
|
| Vendor Credit Line Item Account Number | No | No | 40 characters | The Account Number of the Account that this line item is coded to | - Requires an exact match with the desired Account's Account Number - If Name and Account Number are both populated for an Account, both must be provided to correctly identify that Account - The desired Account must be active in Bill.com |
|
| Vendor Credit Line Item Account Name | No | No | 250 characters | - The Name of the Account that this line item is coded to - This line item defaults to an Expense line item if an account is provided |
- Requires an exact match with the desired Account's Name - If Name and Account Number are both populated for an Account, both must be provided to correctly identify that Account - The desired Account must be active in Bill.com |
|
| Vendor Credit Line Item Department Short Name | No | No | 40 characters | The Short Name of the Department that this line item is coded to, if supported by your accounting system and enabled in Bill.com | ||
| Vendor Credit Line Item Department Name | No | No | 100 characters | The Name of the Department that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Requires an exact match with the desired Department's Name - If Department Name and Department Short Name are both populated for a Department, both must be provided to correctly identify that Department - The desired Department must be active in Bill.com |
|
| Vendor Credit Line Item Location ID | No | No | 40 characters | The Location ID of the Location that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Requires an exact match with the desired Location's Location ID - If Location Name and Location ID are both populated for a Location, both must be provided to correctly identify that Location - The desired Location must be active in Bill.com |
|
| Vendor Credit Line Item Location Name | No | No | 100 characters | The Location Name of the Location that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Reqires an exact match with the desired Location's Location Name - If Location Name and Location ID are both populated for a Location, both must be provided to correctly identify that Location - The desired Location must be active in Bill.com |
|
| Vendor Credit Line Item Job Name | No | No | 100 characters | The Job Name of the Job that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Reqires an exact match with the desired Job's Job Name - If Job Name and Job ID are both populated for a Job, both must be provided to correctly identify that Job - The desired Job must be active in Bill.com |
|
| Vendor Credit Line Item Job ID | No | No | 40 characters | The Job ID of the Job that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Reqires an exact match with the desired Job's Job ID - If Job Name and Job ID are both populated for a Job, both must be provided to correctly identify that Job - The desired Job must be active in Bill.com |
|
| Vendor Credit Line Item Customer ID | No | No | 40 characters | The Customer ID of the Customer that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Requires an exact match with the desired Customer's ID - If Customer Name and Customer ID are both populated for a Customer, both must be provided to correctly identify that Customer - The desired Customer must be active in Bill.com |
|
| Vendor Credit Line Item Customer Name | No | No | 100 characters | The Customer Name of the Customer that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Requires an exact match with the desired Customer's Name - If Customer Name and Customer ID are both populated for a Customer, both must be provided to correctly identify that Customer - The desired Customer must be active in Bill.com |
|
| Vendor Credit Line Item Billable? | No | No | NA | Denotes whether this line item is billable to its coded customer | - Yes - No |
Requires an exact match with the accepted values |
| Vendor Credit Line Item Description | No | No | 4000 characters | The description of this line item | ||
| Vendor Credit Line Item Item Name | No | No | 100 characters | - The Name of the Item that this line item is coded to, if supported by your accounting system and enabled in Bill.com - If provided, the Type of this line item will be Item instead of Expense |
- Requires an exact match with the desired Item's Name - The desired Item must be active in Bill.com - If Name and Item ID are both populated for an Item, both must be provided to correctly identify that Item |
|
| Vendor Credit Line Item Item ID | No | No | - The Item ID of the Item that this line item is coded to, if supported by your accounting system and enabled in Bill.com - If provided, the Type of this line item will be Item instead of Expense |
- Requires an exact match with the desired Item's Item ID - The desired Item must be active in Bill.com - If Name and Item ID are both populated for an Item, both must be provided to correctly identify that Item |
||
| Vendor Credit Line Item Qty | No | No | NA | The quantity of items purchased in this line item | - Must be a number - Up to 5 decimal places supported |
|
| Vendor Credit Line Item Unit Cost | No | No | NA | The cost of one unit of this item | - Must be in the range of -9999999 to 9999999 - Does not support fractions of cents - If this is left blank, it will appear as blank; this is treated as $0.00 - Accepts values with or without a $; negative values must omit the $ |
|
| Vendor Credit Line Item Employee ID | No | No | 40 characters | The ID of the employee that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Requires an exact match with the desired Employee ID -The desired Employee must be active in Bill.com |
|
| Vendor Credit Line Item Class Name | No | No | 40 characters | The Name of the Class that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Reqires an exact match with the desired Class's Name - If Name and Class ID are both populated for a Class, both must be provided to correctly identify that Class - The desired Class must be active in Bill.com |
|
| Vendor Credit Line Item Class ID | No | No | 40 characters | The Class ID of the Class that this line item is coded to, if supported by your accounting system and enabled in Bill.com | - Reqires an exact match with the desired Class's Class ID - If Name and Class ID are both populated for a Class, both must be provided to correctly identify that Class - The desired Class must be active in Bill.com |
