Refresh the eInvoices that belong to this invoice and get the invoice itself

Requires the INVOICE.E_INVOICE.REFRESH permission.

Authentication

X-API-KEYstring
API Key authentication via header
OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1
version
resourceIdstringRequiredDefaults to
The ID of the resource for which the action is posted.

Headers

x-platform-idstringOptional
Platform ID.

Response

OK
object_typestring or nullOptionalRead-only
idstring or nullOptionalRead-only
invoice_numberstring or nullOptionalRead-only
purchase_order_numberstring or nullOptional
platform_idstring or nullOptionalRead-only
customer_idstring or nullOptional

id of the customer, can only be provided when creating a one-off invoice, and either id or reference is mandatory in that case

customer_referencestring or nullOptionalformat: "^\S+$"0-256 characters

reference of the customer, can only be provided when creating a one-off invoice, and either id or reference is mandatory in that case

sales_tax_percentagestring or nullOptional

Sales tax percentage. Needs to be present if both customer and billing entity are US-based. Optional if one of them is US-based

customerobject or nullOptional
billing_entityobject or nullOptional
statusstringOptional
on_holdbooleanOptional
typeenumOptional
created_atstring or nullOptionalRead-only
updated_atstring or nullOptionalRead-only
invoice_datedatetimeOptional
delivery_datestring or nullOptionalRead-only
due_datedatetime or nullOptional
billing_period_datestring or nullOptionalRead-only
billing_currencystring or nullOptionalRead-only
invoice_amount_including_taxobject or nullOptional
open_invoice_amountobject or nullOptional
closed_invoice_amountobject or nullOptional
paid_invoice_amountobject or nullOptional
timezonestring or nullOptionalRead-only
billing_periodobject or nullOptional
pricing_plan_subscription_idslist of strings or nullOptionalRead-only
pricing_plan_schedule_idslist of strings or nullOptionalRead-only
The pricing plan schedules this invoice bills for.
pricing_amount_typeenumOptional
Indicates whether the amounts provided, e.g. from the pricing plan, are including or excluding tax.
periodslist of objectsOptional
Periods that are applicable for this invoice, use either periods or groups for summation, groups will be removed in later version
closed_periodslist of objects or nullOptionalRead-only
tax_categorieslist of objects or nullOptionalRead-only
tax_summaryobject or nullOptional
dunning_actionslist of objects or nullOptionalRead-only
payment_acceptor_idslist of stringsOptional
payment_actionslist of objects or nullOptionalRead-only
noteslist of strings or nullOptional
linked_invoiceslist of objects or nullOptionalRead-only
custom_fieldslist of objects or nullOptional
other_custom_fieldslist of objects or nullOptionalRead-only
creditobject or nullOptional
e_invoiceslist of objects or nullOptionalRead-only
used_exchange_rateslist of objects or nullOptionalRead-only
processing_only_customerslist of objects or nullOptionalRead-only
meter_valueslist of objects or nullOptionalRead-only
credit_typeslist of objects or nullOptionalRead-only
display_invoice_sub_lines_per_processing_only_customerboolean or nullOptionalRead-only
show_tax_per_line_itemboolean or nullOptionalRead-only
forwarded_from_customerslist of objects or nullOptionalRead-only
validation_resultlist of objects or nullOptionalRead-only
reprocessobjectOptional
used_tax_registrationobject or nullOptional
The tax registrations that are used to calculate the tax for this invoice. If empty, the billing entity was used
footnotestring or nullOptionalRead-only
Footnote to be shown on the invoice
approval_statusenum or nullOptionalRead-only
Approval status for invoices that are associated with an approval request
updated_to_final_atstring or nullOptionalRead-only
The invoice finalization date
has_usage_based_pricingboolean or nullOptionalRead-only
couponslist of objects or nullOptionalRead-only
Coupons applied to this invoice
promotion_codeslist of objects or nullOptionalRead-only
Promotion codes applied to this invoice
linked_integrationslist of objects or nullOptional
billing_typeenum or nullOptional
payment_statusenum or nullOptionalRead-only
paidboolean or nullOptionalDeprecated
auto_rescueslist of objects or nullOptionalRead-onlyDeprecated
linked_invoices_idslist of stringsOptionalDeprecated

Can currently only be used for ‘ONE_OFF_CREDIT’ invoices, indicates original invoices that this invoice links to

to_be_reprocessedboolean or nullOptionalRead-onlyDeprecated
to_be_reprocessed_atstring or nullOptionalRead-onlyDeprecated

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error