accounting
invoice

Update an invoice

Changed on
put/accounting/{connection_id}/invoice/{id}

Request

  • Base URL: https://api.unified.to
  • URL: https://api.unified.to/accounting/{connection_id}/invoice/{id}
  • Auth: API key in header authorization

Path parameters

connection_idstring required

ID of the connection

idstring required

ID of the Invoice

Query parameters

fieldsstring[]

Fields to return

rawstring

Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar

Request body

idstring
created_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

due_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

paid_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

refunded_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

cancelled_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

posted_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

total_amountnumber
paid_amountnumber
refund_amountnumber
tax_amountnumber
discount_amountnumber
balance_amountnumber
invoice_numberstring

External identifier (ie. reference) for this invoice

referencestring
contact_idstring

(reference to AccountingContact)

currencystring
notesstring
refund_reasonstring
term'ON_RECEIPT' | 'NET_7' | 'NET_10' | 'NET_15' | 'NET_20' | 'NET_25' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90' | 'OTHER'

@deprecated use payment_terms instead

payment_terms'ON_RECEIPT' | 'NET_7' | 'NET_10' | 'NET_15' | 'NET_20' | 'NET_25' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90' | 'OTHER'
paymentterm_idstring
status'DRAFT' | 'VOIDED' | 'AUTHORIZED' | 'PAID' | 'PARTIALLY_PAID' | 'PARTIALLY_REFUNDED' | 'REFUNDED' | 'SUBMITTED' | 'DELETED' | 'OVERDUE'
urlstring

The public URL for the invoice to send to a customer to view or pay.

payment_collection_method'send_invoice' | 'charge_automatically'

When set to charging_automatically, an automated attempt will occur to pay this invoice using the default payment source attached to the contactcustomer. When set to send_invoice, an will email will be sent with this invoice to the contact/customer with payment instructions.

type'INVOICE' | 'CREDITMEMO'

BILL removed (use AccountingBill); remaining values: INVOICE, CREDITMEMO

sendboolean
organization_idstring
category_idsstring[]
project_idstring

(reference to TaskProject)

sub_total_amountnumber

Total before tax

exchange_ratenumber

Exchange rate to the base/home currency at the document date

is_inclusive_of_taxboolean

True when the document amounts already include tax

salesorder_idsstring[]

refs -> AccountingSalesorder; the sales orders this invoice was raised from

rawobject

Response

Successful

idstring
created_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

updated_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

due_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

paid_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

refunded_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

cancelled_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

posted_atstring date-time

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

total_amountnumber
paid_amountnumber
refund_amountnumber
tax_amountnumber
discount_amountnumber
balance_amountnumber
invoice_numberstring

External identifier (ie. reference) for this invoice

referencestring
contact_idstring

(reference to AccountingContact)

currencystring
notesstring
refund_reasonstring
term'ON_RECEIPT' | 'NET_7' | 'NET_10' | 'NET_15' | 'NET_20' | 'NET_25' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90' | 'OTHER'

@deprecated use payment_terms instead

payment_terms'ON_RECEIPT' | 'NET_7' | 'NET_10' | 'NET_15' | 'NET_20' | 'NET_25' | 'NET_30' | 'NET_45' | 'NET_60' | 'NET_90' | 'OTHER'
paymentterm_idstring
status'DRAFT' | 'VOIDED' | 'AUTHORIZED' | 'PAID' | 'PARTIALLY_PAID' | 'PARTIALLY_REFUNDED' | 'REFUNDED' | 'SUBMITTED' | 'DELETED' | 'OVERDUE'
urlstring

The public URL for the invoice to send to a customer to view or pay.

payment_collection_method'send_invoice' | 'charge_automatically'

When set to charging_automatically, an automated attempt will occur to pay this invoice using the default payment source attached to the contactcustomer. When set to send_invoice, an will email will be sent with this invoice to the contact/customer with payment instructions.

type'INVOICE' | 'CREDITMEMO'

BILL removed (use AccountingBill); remaining values: INVOICE, CREDITMEMO

sendboolean
organization_idstring
category_idsstring[]
project_idstring

(reference to TaskProject)

sub_total_amountnumber

Total before tax

exchange_ratenumber

Exchange rate to the base/home currency at the document date

is_inclusive_of_taxboolean

True when the document amounts already include tax

salesorder_idsstring[]

refs -> AccountingSalesorder; the sales orders this invoice was raised from

rawobject

Changes

  • 669f9277e173Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the enum value exchange_rate to the property items/ of the query request parameter fields

    • info

      added the enum value is_inclusive_of_tax to the property items/ of the query request parameter fields

    • info

      added the enum value salesorder_ids to the property items/ of the query request parameter fields

    • info

      added the enum value sub_total_amount to the property items/ of the query request parameter fields

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • b837b009e30dRevision changes
    • breaking

      removed the enum value BILL of the request property

    • info

      removed the BILL enum value from the response property for the response status