Appearance

Update Invoices ​

Endpoint ​

http
PATCH /unified/accounting/invoices/{id}
Integrations supported
  • QuickBooks

Path parameters ​

id
string
REQUIRED · The ID of the resource.
Example: 23423523

Query parameters ​

integrated_account_id
string · uuid
REQUIRED · The ID of the integrated account to use for the request.
Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d

Request Body ​

Refer Writing data using Unified APIs

type
string
The type of the invoice
All possible enum values:
  • bill
  • invoice
Required in
  • QuickBooks
currency
string
The currency of the invoice
Supported in
  • QuickBooks
contact
object
The contact for whom the invoice is raised.
Supported in
  • QuickBooks
id
string
The unique identifier for the contact
type
string
The type of the contact - vendor or customer.
line_items
object[]
The line items of the invoice
Supported in
  • QuickBooks
id
string
The unique identifier for line item
name
string
The name of the line item
description
string
The description of the line item
item
string
The ID of the item
account
string
The ID of the account
quantity
number
The quantity of the line item
unit_price
number
The unit price of the line item
tax_rate
string
The ID of the tax rate
total_line_amount
number
The total line amount of the line item.
type
string
The type of the line item
tracking_categories
object[]
Tracking categories of the line item
id
string
The ID of the tracking category
name
string
The name of the tracking category
option
string
The option of the tracking category
currency
string
The currency of the line item
exchange_rate
number
The exchange rate of the currency for the line item
memo
string
The private note of the invoice
Supported in
  • QuickBooks
id
string
REQUIRED · The unique identifier for invoices
Supported in
  • QuickBooks
total_tax_amount
number
The total tax amount of the invoice
Supported in
  • QuickBooks
balance
number
The remaining balance of the invoice
Supported in
  • QuickBooks
due_date
string
The due date of the invoice
Supported in
  • QuickBooks
number
string
The number of the invoice
Supported in
  • QuickBooks
issue_date
string
The issue date of the invoice
Supported in
  • QuickBooks
remote_data
object
Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.

Response Body ​

id
string
REQUIRED · The unique identifier for invoices
Supported in
  • QuickBooks
type
string
The type of the invoice
All possible enum values:
  • bill
  • invoice
Supported in
  • QuickBooks
contact
object
The contact for whom the invoice is raised.
Supported in
  • QuickBooks
id
string
The unique identifier for the contact
type
string
The type of the contact - vendor or customer.
number
string
The number of the invoice
Supported in
  • QuickBooks
issue_date
string
The issue date of the invoice
due_date
string
The due date of the invoice
Supported in
  • QuickBooks
paid_on_date
string
The paid on date of the invoice
memo
string
The private note of the invoice
Supported in
  • QuickBooks
company
string
The company the invoice belongs to
currency
string
The currency of the invoice
Supported in
  • QuickBooks
exchange_rate
number
The exchange rate of the invoice
total_discount
number
The total discount of the invoice
sub_total
number
The sub total of the invoice
Supported in
  • QuickBooks
total_tax_amount
number
The total tax amount of the invoice
Supported in
  • QuickBooks
balance
number
The remaining balance of the invoice
Supported in
  • QuickBooks
payments
string[]
List of payment IDs associated with the invoice
line_items
object[]
The line items of the invoice
Supported in
  • QuickBooks
id
string
The unique identifier for line item
name
string
The name of the line item
description
string
The description of the line item
item
string
The ID of the item
account
string
The ID of the account
quantity
number
The quantity of the line item
unit_price
number
The unit price of the line item
tax_rate
string
The ID of the tax rate
total_line_amount
number
The total line amount of the line item.
type
string
The type of the line item
tracking_categories
object[]
Tracking categories of the line item
id
string
The ID of the tracking category
name
string
The name of the tracking category
option
string
The option of the tracking category
currency
string
The currency of the line item
exchange_rate
number
The exchange rate of the currency for the line item
status
string
The status of the invoice
All possible enum values:
  • draft
  • submitted
  • deleted
  • authorised
  • paid
  • voided
created_at
string
This represents the date when the invoice was created
Supported in
  • QuickBooks
updated_at
string
This represents the date when the invoice was updated
Supported in
  • QuickBooks
remote_data
object
Raw data returned from the remote API call.