About Invoice
An invoice represents a products and/or services purchased by a Customer from your organization. A nested InvoiceLineItem
object records details specific to products or services. Each line item can be assigned to a product or service Item along with additional Account Tracking.
Invoices can be sent by Email or can be Mailed to the customer.
The amount that the customer pays can be reduced with a CreditMemo. Any remaining Received Payment is then recorded or charged.
Invoice Line Items; Price, Percentage
For invoice line items - use either price
or percentage
(do not use both or none).
price
= dollar amount ($, i.e., $10.00)percent
= percentage (%) to apply discounts (negative, i.e., -10%) or mark ups (positive, i.e., +25%).
invoiceLineItemAmount
This parameter is calculated from price or percentage:
- If
price
not empty, line item amount = quantity *price
- If
percentage
not empty, line item amount = total of previous line items amount *percentage
serviceDate
This parameter is the date the service was provided or the date the product was sold.
- Read-only.
- Visible only if populated with a sync from QuickBooks for Windows (QBW) to Bill.com.
Create
Request
<API_URL_EndPoint>/Crud/Create/Invoice.json
data={
"obj" : {
"entity" : "Invoice",
"isActive" : "1",
"customerId" : "0cu01QRJUQPTKMMYijuo",
"invoiceNumber" : "1950",
"invoiceDate" : "2016-12-12",
"dueDate" : "2016-12-19",
"glPostingDate" : "2016-12-12",
"description" : "Purchase of musical instruments & tools",
"poNumber" : "PO1818",
"isToBePrinted" : true,
"isToBeEmailed" : true,
"itemSalesTax" : "",
"salesTaxTotal" : 0,
"terms" : "Net 15",
"salesRep" : "George",
"FOB" : "",
"shipDate" : "2016-12-20",
"shipMethod" : "",
"departmentId" : "0de01ORPHXZXIHFPazci",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"payToBankAccountId" : "bac01OOZNCHMLQNK8naj",
"payToChartOfAccountId" : "",
"invoiceLineItems" : [ {
"entity" : "InvoiceLineItem",
"itemId" : "0ii01YCDSBIDTPTJbhcb",
"quantity" : 3,
"amount" : 1800.00,
"price" : 600.00,
"ratePercent" : 1,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Back up Vocal Machines",
"taxable" : false,
"taxCode" : ""
}, {
"entity" : "InvoiceLineItem",
"itemId" : "0ii01WBHUZZJGNDTbv0o",
"quantity" : 2,
"amount" : 200.00,
"price" : 400.00,
"ratePercent" : 1,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Guitar Tune-up Tools",
"taxable" : false,
"taxCode" : ""
} ]
}
}
Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Invoice",
"id" : "00e01IQFACPCTOUGk0ko",
"isActive" : "1",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"customerId" : "0cu01QRJUQPTKMMYijuo",
"invoiceNumber" : "1950",
"invoiceDate" : "2016-12-12",
"dueDate" : "2016-12-19",
"glPostingDate" : "2016-12-12",
"amount" : 2600.00,
"amountDue" : 2600.00,
"paymentStatus" : "1",
"description" : "Purchase of musical instruments & tools",
"poNumber" : "PO1818",
"isToBePrinted" : true,
"isToBeEmailed" : true,
"lastSentTime" : null,
"itemSalesTax" : "00000000000000000000",
"salesTaxPercentage" : 0,
"salesTaxTotal" : 0.00,
"terms" : "Net 15",
"salesRep" : "George",
"FOB" : null,
"shipDate" : "2016-12-20",
"shipMethod" : null,
"departmentId" : "0de01ORPHXZXIHFPazci",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"payToBankAccountId" : "bac01OOZNCHMLQNK8naj",
"payToChartOfAccountId" : "00000000000000000000",
"invoiceLineItems" : [ {
"entity" : "InvoiceLineItem",
"id" : "00f01JXKBEMDWVD3a3s5",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01YCDSBIDTPTJbhcb",
"quantity" : 3,
"amount" : 1800.00,
"price" : 600.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Back up Vocal Machines",
"taxable" : false,
"taxCode" : "Non"
}, {
"entity" : "InvoiceLineItem",
"id" : "00f01GEZFHCJGKL3a3s6",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01WBHUZZJGNDTbv0o",
"quantity" : 2,
"amount" : 800.00,
"price" : 400.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Guitar Tune-up Tools",
"taxable" : false,
"taxCode" : "Non"
} ]
}
}
Read
Request
<API_URL_EndPoint>/Crud/Read/Invoice.json
data={
"id" : "00e01IQFACPCTOUGk0ko"
}
Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Invoice",
"id" : "00e01IQFACPCTOUGk0ko",
"isActive" : "1",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"customerId" : "0cu01QRJUQPTKMMYijuo",
"invoiceNumber" : "1950",
"invoiceDate" : "2016-12-12",
"dueDate" : "2016-12-19",
"glPostingDate" : "2016-12-12",
"amount" : 2600.00,
"amountDue" : 2600.00,
"paymentStatus" : "1",
"description" : "Purchase of musical instruments & tools",
"poNumber" : "PO1818",
"isToBePrinted" : true,
"isToBeEmailed" : true,
"lastSentTime" : null,
"itemSalesTax" : "00000000000000000000",
"salesTaxPercentage" : 0,
"salesTaxTotal" : 0.00,
"terms" : "Net 15",
"salesRep" : "George",
"FOB" : null,
"shipDate" : "2016-12-20",
"shipMethod" : null,
"departmentId" : "0de01ORPHXZXIHFPazci",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"payToBankAccountId" : "bac01OOZNCHMLQNK8naj",
"payToChartOfAccountId" : "00000000000000000000",
"invoiceLineItems" : [ {
"entity" : "InvoiceLineItem",
"id" : "00f01JXKBEMDWVD3a3s5",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01YCDSBIDTPTJbhcb",
"quantity" : 3,
"amount" : 1800.00,
"price" : 600.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Back up Vocal Machines",
"taxable" : false,
"taxCode" : "Non"
}, {
"entity" : "InvoiceLineItem",
"id" : "00f01GEZFHCJGKL3a3s6",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01WBHUZZJGNDTbv0o",
"quantity" : 2,
"amount" : 800.00,
"price" : 400.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Guitar Tune-up Tools",
"taxable" : false,
"taxCode" : "Non"
} ]
}
}
Update
Request
<API_URL_EndPoint>/Crud/Update/Invoice.json
data={
"obj" : {
"entity" : "Invoice",
"id" : "00e01IQFACPCTOUGk0ko",
"isActive" : "1",
"customerId" : "0cu01QRJUQPTKMMYijuo",
"invoiceNumber" : "1950",
"invoiceDate" : "2016-12-12",
"dueDate" : "2016-12-19",
"glPostingDate" : "2016-12-12",
"amount" : 2600.00,
"amountDue" : 2600.00,
"paymentStatus" : "1",
"description" : "Purchase of musical instruments & tools",
"poNumber" : "PO1818",
"isToBePrinted" : true,
"isToBeEmailed" : true,
"lastSentTime" : null,
"itemSalesTax" : "00000000000000000000",
"salesTaxPercentage" : 0,
"salesTaxTotal" : 0.00,
"terms" : "Net 15",
"salesRep" : "George",
"FOB" : null,
"shipDate" : "2016-12-20",
"shipMethod" : null,
"departmentId" : "0de01ORPHXZXIHFPazci",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"payToBankAccountId" : "bac01OOZNCHMLQNK8naj",
"payToChartOfAccountId" : "00000000000000000000",
"invoiceLineItems" : [ {
"entity" : "InvoiceLineItem",
"id" : "00f01JXKBEMDWVD3a3s5",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01YCDSBIDTPTJbhcb",
"quantity" : 2,
"amount" : 1800.00,
"price" : 600.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Back up Vocal Machines",
"taxable" : false,
"taxCode" : "Non"
}, {
"entity" : "InvoiceLineItem",
"id" : "00f01GEZFHCJGKL3a3s6",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01WBHUZZJGNDTbv0o",
"quantity" : 3,
"amount" : 800.00,
"price" : 400.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Guitar Tune-up Tools",
"taxable" : false,
"taxCode" : "Non"
} ]
}
}
Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Invoice",
"id" : "00e01IQFACPCTOUGk0ko",
"isActive" : "1",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:42:09.000+0000",
"customerId" : "0cu01QRJUQPTKMMYijuo",
"invoiceNumber" : "1950",
"invoiceDate" : "2016-12-12",
"dueDate" : "2016-12-19",
"glPostingDate" : "2016-12-12",
"amount" : 2400.00,
"amountDue" : 2400.00,
"paymentStatus" : "1",
"description" : "Purchase of musical instruments & tools",
"poNumber" : "PO1818",
"isToBePrinted" : true,
"isToBeEmailed" : true,
"lastSentTime" : null,
"itemSalesTax" : "00000000000000000000",
"salesTaxPercentage" : 0,
"salesTaxTotal" : 0.00,
"terms" : "Net 15",
"salesRep" : "George",
"FOB" : null,
"shipDate" : "2016-12-20",
"shipMethod" : null,
"departmentId" : "0de01ORPHXZXIHFPazci",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"payToBankAccountId" : "bac01OOZNCHMLQNK8naj",
"payToChartOfAccountId" : "00000000000000000000",
"invoiceLineItems" : [ {
"entity" : "InvoiceLineItem",
"id" : "00f01JXKBEMDWVD3a3s5",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:42:09.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01YCDSBIDTPTJbhcb",
"quantity" : 2,
"amount" : 1200.00,
"price" : 600.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Back up Vocal Machines",
"taxable" : false,
"taxCode" : "Non"
}, {
"entity" : "InvoiceLineItem",
"id" : "00f01GEZFHCJGKL3a3s6",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:42:09.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01WBHUZZJGNDTbv0o",
"quantity" : 3,
"amount" : 1200.00,
"price" : 400.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Guitar Tune-up Tools",
"taxable" : false,
"taxCode" : "Non"
} ]
}
}
Delete
Request
<API_URL_EndPoint>/Crud/Delete/Invoice.json
data={
"id" : "00e01IQFACPCTOUGk0ko"
}
Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Invoice",
"id" : "00e01IQFACPCTOUGk0ko",
"isActive" : "2",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"customerId" : "0cu01QRJUQPTKMMYijuo",
"invoiceNumber" : "1950",
"invoiceDate" : "2016-12-12",
"dueDate" : "2016-12-19",
"glPostingDate" : "2016-12-12",
"amount" : 2600.00,
"amountDue" : 2600.00,
"paymentStatus" : "1",
"description" : "Purchase of musical instruments & tools",
"poNumber" : "PO1818",
"isToBePrinted" : true,
"isToBeEmailed" : true,
"lastSentTime" : null,
"itemSalesTax" : "00000000000000000000",
"salesTaxPercentage" : 0,
"salesTaxTotal" : 0.00,
"terms" : "Net 15",
"salesRep" : "George",
"FOB" : null,
"shipDate" : "2016-12-20",
"shipMethod" : null,
"departmentId" : "0de01ORPHXZXIHFPazci",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"payToBankAccountId" : "bac01OOZNCHMLQNK8naj",
"payToChartOfAccountId" : "00000000000000000000",
"invoiceLineItems" : [ {
"entity" : "InvoiceLineItem",
"id" : "00f01JXKBEMDWVD3a3s5",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01YCDSBIDTPTJbhcb",
"quantity" : 3,
"amount" : 1800.00,
"price" : 600.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Back up Vocal Machines",
"taxable" : false,
"taxCode" : "Non"
}, {
"entity" : "InvoiceLineItem",
"id" : "00f01GEZFHCJGKL3a3s6",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01WBHUZZJGNDTbv0o",
"quantity" : 2,
"amount" : 800.00,
"price" : 400.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Guitar Tune-up Tools",
"taxable" : false,
"taxCode" : "Non"
} ]
}
}
Undelete
Request
<API_URL_EndPoint>/Crud/Undelete/Invoice.json
data={
"id" : "00e01IQFACPCTOUGk0ko"
}
Response
{
"response_status" : 0,
"response_message" : "Success",
"response_data" : {
"entity" : "Invoice",
"id" : "00e01IQFACPCTOUGk0ko",
"isActive" : "1",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"customerId" : "0cu01QRJUQPTKMMYijuo",
"invoiceNumber" : "1950",
"invoiceDate" : "2016-12-12",
"dueDate" : "2016-12-19",
"glPostingDate" : "2016-12-12",
"amount" : 2600.00,
"amountDue" : 2600.00,
"paymentStatus" : "1",
"description" : "Purchase of musical instruments & tools",
"poNumber" : "PO1818",
"isToBePrinted" : true,
"isToBeEmailed" : true,
"lastSentTime" : null,
"itemSalesTax" : "00000000000000000000",
"salesTaxPercentage" : 0,
"salesTaxTotal" : 0.00,
"terms" : "Net 15",
"salesRep" : "George",
"FOB" : null,
"shipDate" : "2016-12-20",
"shipMethod" : null,
"departmentId" : "0de01ORPHXZXIHFPazci",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"payToBankAccountId" : "bac01OOZNCHMLQNK8naj",
"payToChartOfAccountId" : "00000000000000000000",
"invoiceLineItems" : [ {
"entity" : "InvoiceLineItem",
"id" : "00f01JXKBEMDWVD3a3s5",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01YCDSBIDTPTJbhcb",
"quantity" : 3,
"amount" : 1800.00,
"price" : 600.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Back up Vocal Machines",
"taxable" : false,
"taxCode" : "Non"
}, {
"entity" : "InvoiceLineItem",
"id" : "00f01GEZFHCJGKL3a3s6",
"createdTime" : "2016-12-12T15:38:32.000+0000",
"updatedTime" : "2016-12-12T15:38:32.000+0000",
"invoiceId" : "00e01IQFACPCTOUGk0ko",
"itemId" : "0ii01WBHUZZJGNDTbv0o",
"quantity" : 2,
"amount" : 800.00,
"price" : 400.00,
"ratePercent" : null,
"chartOfAccountId" : "0ca01MWBQMGJQJVXdgns",
"departmentId" : "0de01BQOIPAFNQKUazch",
"locationId" : "loc01ZCLEVLXDQRB9z1o",
"actgClassId" : "cls01MBCYMNEBCGO8qb2",
"jobId" : "job01HCOSIFZPZBFczyc",
"description" : "Guitar Tune-up Tools",
"taxable" : false,
"taxCode" : "Non"
} ]
}
}
Resources
Parameters