Sales invoices are the invoices you send to your customers for products or services you have delivered.
Get an invoice by invoice_id
Get a sales invoice by the invoice_id field of the sales invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
invoice_id
string · requiredUnique invoice identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
A sales invoice
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Get an invoice by reference
Get a sales invoice by the reference field of the sales invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
reference
string · requiredformat
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
A sales invoice
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Sends a reminder
This endpoint sends a reminder to a contact. A reminder can contain multiple sales invoices. Reminders are grouped by workflow, identity and document style, so a contact with sales invoices with different workflows, will receive multiple reminders. Only by grouping reminders like this, we can assure the right content and layout of a reminder.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Status code
List all ids and versions
Returns all sales invoices in the administration. The list contains the invoice id and the version of the invoice.
Check if the version of the invoice is newer than the version you have stored locally, use the POST
variant for fetching invoices with the given ids.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
filter
string
Responses
IDs and versions of records
id
integer | stringversion
integer | string
Fetch sales invoices with given ids
Given a list of sales invoice ids, returns the sales invoice information belonging to the invoices. Returns a maximum of 100 invoice, even if more ids are provided.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
A list of sales invoices
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Add attachment to sales invoice
Add an attachment to a sales invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Status code
Download sales invoice packing slip PDF by id
Redirects to the download URL of the sales invoice as packing slip PDF. The link is valid for 30 seconds.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
media
stringIn case you want to hide sender address and logo you can set this to 'stationery'.
Responses
Found
Download sales invoice PDF by id
Redirects to the download URL of the sales invoice as PDF. The link is valid for 30 seconds.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
media
stringIn case you want to hide sender address and logo you can set this to 'stationery'.
Responses
Found
Download sales invoice UBL by id
Download the sales invoice as UBL.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
A sales invoice
Duplicate to credit invoice
Duplicate a sales invoice to a new credit invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice updated
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Mark as dubious
This endpoint marks a sales invoice as dubious.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice updated
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Mark as uncollectible
This endpoint marks a sales invoice as uncollectible.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice updated
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Pause sales invoice
This endpoint pauses a sales invoice. The automatic workflow steps will not be executed while the sales invoice is paused.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice paused
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Register a payment
This endpoint is deprecated and should no longer be used. It has been replaced by Create a payment.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Register a payment for a creditinvoice
Register a payment for a creditinvoice. Requires that the invoice is a credit invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice updated
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Resume sales invoice
This endpoint resumes the sales invoice. The automatic workflow steps will execute again after resuming.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice resumed
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Sends an invoice
This endpoint provides two options: sending the invoice and scheduling sending in the future. When sending now, you can provide a send method, email address and message. If you don't provide any arguments, the defaults from the contact and workflow will be used.
When scheduling sending, set the boolean sending_scheduled
to true and provide an invoice_date
.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice updated
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Get an invoice by id
Returns a sales invoices in the administration.
Note that the link in the url
attribute will only work if viewing invoices online has been enabled and the invoice is not a draft.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
A sales invoice
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Delete a sales invoice
Delete a sales invoice. Requires that the sales invoice has no pending payments and is not in a locked bookkeeping period.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice deleted
Update a sales invoice
When updating a sales invoice, provide only the attributes you want to update. The other attributes will not be changed.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice updated
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Download attachment
Download the attachment. The response will be a redirect to a temporarily available URL
where the attachment can be downloaded. Use the Location
header in the response
to download the attachment.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
sales_invoice_id
string | integer · pattern:^\d+$
· requiredA unique record identifier
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Found
Delete an attachment
Deletes an attachment of an attachable.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
sales_invoice_id
string | integer · pattern:^\d+$
· requiredA unique record identifier
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Attachment deleted
Destroys note from entity
Deletes a note from the sales invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
sales_invoice_id
string | integer · pattern:^\d+$
· requiredA unique record identifier
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Note deleted
Adds note to entity
Adds a note to the sales invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
sales_invoice_id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Note created
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
entity_id
string | integer | null · pattern:^\d+$
A unique record identifier
entity_type
stringuser_id
string | integer · pattern:^\d+$
A unique record identifier
assignee_id
string | integer | null · pattern:^\d+$
A unique record identifier
todo
boolean | string | nullDefault: falsenote
string | nullcompleted_at
string | null · date-timecompleted_by_id
string | integer | null · pattern:^\d+$
A unique record identifier
todo_type
string | null · enumEnum values:sales_invoice_duepurchase_invoice_duegeneral_document_remindergeneral_document_duenew_document_awaiting_processingnew_financial_mutation_awaiting_processingfinancial_mutations_not_updatedsales_invoice_payment_not_linked_to_financial_mutationdata
object | nullcreated_at
string · date-timeupdated_at
string · date-time
Delete a payment
Delete a payment from a sales invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
sales_invoice_id
string | integer · pattern:^\d+$
· requiredA unique record identifier
id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Payment deleted
Create a payment
Registers a payment for a sales invoice.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
sales_invoice_id
string | integer · pattern:^\d+$
· requiredA unique record identifier
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Payment created
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
invoice_type
string · enumEnum values:SalesInvoiceDocumentExternalSalesInvoiceVatDocumentinvoice_id
string | integer · pattern:^\d+$
A unique record identifier
financial_account_id
string | integer | null · pattern:^\d+$
A unique record identifier
user_id
string | integer · pattern:^\d+$
A unique record identifier
payment_transaction_id
string | integer | null · pattern:^\d+$
A unique record identifier
transaction_identifier
string | nullprice
price_base
payment_date
string · datecredit_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
financial_mutation_id
string | integer | null · pattern:^\d+$
A unique record identifier
ledger_account_id
string | integer | null · pattern:^\d+$
A unique record identifier
linked_payment_id
string | integer | null · pattern:^\d+$
A unique record identifier
manual_payment_action
string | nullcreated_at
string · date-timeupdated_at
string · date-time
List all invoices
Returns a paginated list of all sales invoices in the administration.
The filter
argument allows you to filter the list of invoices. Filters are a combination of keys and values,
separated by a comma: period:this_year,state:all
. The available options for filtering are:
Filter | Type | Default | Description |
---|---|---|---|
state | String | all | all , draft , open , scheduled , pending_payment , late , reminded , paid or uncollectible |
period | String | this_year | This can either be the description of a period (this_month , prev_month , next_month , this_quarter , prev_quarter , next_quarter , this_year , prev_year , next_year ) or a custom period (201301..201302 , 20130101..20130131 ) |
reference | String | Select invoices with a certain reference | |
contact_id | Integer | Select invoices belonging to a certain contact | |
recurring_sales_invoice_id | Integer | Select invoices created by a certain recurring invoice | |
workflow_id | Integer | Select invoices that use a certain workflow | |
created_after | String | Select invoices created after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone | |
updated_after | String | Select invoices updated after the given time (exclusive). ISO 8601 formatted string. The time to compare with is in UTC timezone |
You can filter by multiple states at the same time as well. To do this, separate the state values by a pipe: state:draft|scheduled
. This also holds for the reference.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
query Parameters
filter
stringper_page
integer | string · min: 1 · max: 100 · pattern:^\d+$
Responses
A list of sales invoices
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]
Create a sales invoice
Create a sales invoice with the parameters defined in the request body.
path Parameters
administration_id
string | integer · pattern:^\d+$
· requiredThe unique identifier of the administration
A unique record identifier of an administration
format
string · pattern:^(.(json|xml))?$
· requiredThe format in which the response is given, can be empty to use the default format
Default: .json
Responses
Sales invoice created
id
string | integer · pattern:^\d+$
A unique record identifier
administration_id
string | integer · pattern:^\d+$
A unique record identifier of an administration
contact_id
string | integer · pattern:^\d+$
A unique record identifier
contact
objectcontact_person_id
string | integer | null · pattern:^\d+$
A unique record identifier
contact_person
invoice_id
string | nullrecurring_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
subscription_id
string | integer | null · pattern:^\d+$
A unique record identifier
workflow_id
string | integer · pattern:^\d+$
A unique record identifier
document_style_id
string | integer · pattern:^\d+$
A unique record identifier
identity_id
string | integer · pattern:^\d+$
A unique record identifier
draft_id
integer | nullstate
string · enumEnum values:draftscheduledopenpending_paymentremindedlatepaiduncollectibleinvoice_date
string | null · datedue_date
string · datepayment_conditions
string | nullpayment_reference
string | nullshort_payment_reference
string | nullreference
string | nulllanguage
string | nullcurrency
stringdiscount
string | nulloriginal_sales_invoice_id
string | integer | null · pattern:^\d+$
A unique record identifier
paused
booleanpaid_at
string | null · datesent_at
string | null · datecreated_at
string · date-timeupdated_at
string · date-timepublic_view_code
string | nullpublic_view_code_expires_at
string | null · date-timeversion
integerdetails
object[]payments
object[]total_paid
stringtotal_unpaid
stringtotal_unpaid_base
stringprices_are_incl_tax
booleantotal_price_excl_tax
stringtotal_price_excl_tax_base
stringtotal_price_incl_tax
stringtotal_price_incl_tax_base
stringtotal_discount
stringmarked_dubious_on
string | null · datemarked_uncollectible_on
string | null · datereminder_count
integer | nullnext_reminder
string | null · dateoriginal_estimate_id
string | integer | null · pattern:^\d+$
A unique record identifier
url
stringpayment_url
stringcustom_fields
object[]notes
object[]attachments
object[]events
object[]tax_totals
object[]time_entries
object[]