Invoices are included on both v1 and v2 B4T API's. See the table below to see what each API includes for data fields.
Available Routes
| get |
{API Key}/v1/invoices |
| get |
{API Key}/v2/invoices |
Data Format
| Invoices |
| v1 Field Name |
v2 Field Name |
Type |
Values |
Description |
| |
FirmId |
Number
|
|
Unique ID for the Firm (B4T Generated) |
| |
InvoiceID |
Number |
|
Unique ID for the invoice (B4T Generated) |
| |
InternalInvoiceID |
Number |
|
Unique ID for the invoice (custom) |
| |
InvoiceBatchId |
Number |
|
Batch Id, if the invoice is apart of a batch |
| |
ClientID |
Number |
|
id of the client for the invoice |
| |
InternalClientID |
Number |
|
id of the client for the invoice (B4T generated) |
| |
ClientName |
Text |
|
Name of client |
| |
ProjectID |
Number |
|
ID of the project for the invoice |
| |
InternalProjectID |
Number |
|
ID of the project for the invoice (B4T generated) |
| |
ProjectName |
Text |
|
Name of Project for the invoice |
| |
Status |
Text |
|
Invoice Status |
| |
CreatedDate |
Date |
|
Invoice Created Date |
| |
InvoiceDate |
Date |
|
Invoice Date |
| |
InvoiceDesc |
Text |
|
Invoice Description |
| |
InvoiceNotes |
Text |
|
Invoice Notes |
| |
InvoiceTermType |
Text |
|
Invoice Terms |
| |
InvoiceDiscountType |
Text |
Percentage
Flatfee
(blank) |
If value is present, this is the type of discount applied to the invoice. |
| |
ApplyDiscountTo |
Text |
Both Labor and Expenses
Labor Only |
Designation to apply the discount to labor only or labor and expenses |
| |
InvoiceDiscountAmount |
Number |
|
Amount of discount applied |
| |
LaborTaxRatePCT |
Number |
|
Tax rate set for labor (percentage) |
| |
ExpenseTaxRatePCT |
Number |
|
Expense Tax rate set for labor (Percentage) |
| |
SecondaryTaxLabor |
Number |
|
Secondary Tax for Labor |
| |
SecondaryTaxExpenses |
Number |
|
Secondary Tax for Expenses |
| |
InvoiceSummary |
Text |
|
Invoice Summary |
| |
ShowLaborSummary |
Text |
True
False |
|
| |
ShowExpSummary |
Text |
True
False |
|
| |
WriteUpDownAmountLabor |
Number |
|
|
| |
WriteUpDownAmountExp |
Number |
|
|
| |
InvoiceExpenseTotalPreTax |
Number |
|
|
| |
InvoiceLaborTotalPreTax |
Number |
|
|
| |
InvoiceProjectExpenseTotalPreTax |
Number |
|
|
| |
InvoiceProjectLaborTotalPreTax |
Number |
|
|
| |
InvoiceProjectTotalPreTax |
Number |
|
|
| |
InvoiceTotal |
Number |
|
|
| |
QBSyncDate |
Date |
|
|
| |
IIFExportDate |
Date |
|
|
| |
paidStatus |
Text |
- Partially Paid
- Unpaid
- Paid
|
Paid status of the invoice |
Usage Examples
Find all Invoices
gethttps://secure.bill4time.com/b4t-api/{Api Key}/v1/invoices
gethttps://secure.bill4time.com/b4t-api/{Api Key}/v2/invoices
Find invoice with id = 10012
gethttps://secure.bill4time.com/b4t-api/{Api Key}/v1/invoices?$filter=id eq 10012
gethttps://secure.bill4time.com/b4t-api/{Api Key}/v2/invoices?$filter=id eq 10012
Find invoices in a pre-bill status
gethttps://secure.bill4time.com/b4t-api/{Api Key}/v1/invoices?$filter=status eq 'prebill'
gethttps://secure.bill4time.com/b4t-api/{Api Key}/v2/invoices?$filter=status eq 'prebill'
Comments
0 comments
Please sign in to leave a comment.