Accounting API
Invoices
invoices, representing the transactional records of purchases made by customers, are automatically generated either when a customer completes an order through your checkout flows, tamio sites, automations or created manually in the tamio dashboard each invoice is paired with a corresponding data object, encapsulating an array of information this encompasses details of the payment method, customer data, applied taxes, any discounts used, and the specific products that constitute the purchase invoices support 20+ appendix docid\ kfbmx4q3dxjtduqf75yx1 20+ appendix docid\ kfbmx4q3dxjtduqf75yx1 and more than 50 appendix docid\ kfbmx4q3dxjtduqf75yx1 the prefix and numbering of your invoices can be customised at the account level inside the tamio dashboard you can create one off and recurring invoices directly inside the tamio dashboard you can execute various actions on an invoice, including processing refunds, adding tracking numbers, and marking items as shipped the available actions for each invoice depend on factors such as its type, the payment method opted by the customer, and the nature of the products purchased all invoices undergo a lifecycle commencing from the point of generation and culminating when no further action can be taken on them the progression of an invoice through this lifecycle is guided by its status invoice statuses status description awaiting payment the invoice is awaiting payment confirmation (manual or automated) pending an order has been placed and requires the merchant's attention (approve or decline) new a customer has placed a new order via checkout or a new custom invoice has been created refunded, reversed the invoice has been refunded in full partially refunded the invoice has been refunded in part authorized a payment for the invoice has been authorized, but has not been captured done the invoice has completed its lifecycle, and it can only be removed partially paid the invoice represents an instalment plan, and it is paid in part completed the invoice represents an instalment plan, and it is paid in full failed, voided all payment attempts for this invoice have failed endpoints description method url retrieve invoice docid 8rsl a2f0v tpkmx5nvky get get /v2/invoices/retrieve/\ id mark paid docid\ zfzyn8 6rvcmgk9vut9d1 post post /v2/invoices/mark paid/\ id delete invoice docid\ lum1fnn40ooxq6xyuzrml delete delete /v2/invoices/\ id mark shipped docid 8105qzwnmcsfy0un gkxt post post /v2/invoices/mark shipped/\ id refund invoice docid\ mdklcdlzthoggxkuj3p00 post post /v2/invoices/refund/\ id affiliate commission docid\ eij brd3i hr80qkpcivj post post /v2/invoices/affiliate commission/\ id bulk delete invoices docid\ jgs8kusjmdnber1eruc2y post post /v2/invoices/bulk/delete cancel invoice docid\ o52rfxxnef4h7ekhvl9r1 post post /v2/invoices/cancel/\ id list all invoices docid\ osl9ufea4xjvkums1yivf get get /v2/invoices/list upcoming subscription invoice docid\ ktodaluzjntpkjcqqtuf4 get get /v2/invoices/upcoming/\ id webhook events there are six webhook notification events associated with the invoices api invoice created invoice payment confirmed invoice refunded invoice approved invoice declined invoice updated you can see examples of notification events invoice events docid\ npa6n9frki q1e1yzvdbs permissions whether managing teammates or creating api developer keys, you can customise permissions when accessing invoices api resources the default set of invoice permissions are view , edit , create and remove pdfs & customers each invoice generated by the tamio system is accompanied by a corresponding pdf file this digital invoice copy is automatically forwarded to the customer following their purchase, as well as during any updates concerning their order for instance, when a refund is initiated, the updated invoice is promptly sent within tamio's framework, we offer three different invoice templates that you can preview directly within your dashboard interface do note that while tamio allows you the flexibility to disable the automatic sending of customer invoices, it is essential to first verify the legal stipulations in your operating jurisdiction legal requirements for invoice delivery can vary widely, and non compliance can lead to penalties reversing invoices (storno) in the field of accounting, the practice of reversing invoices, also known as "storno," is common tamio fully supports this operation, enabling you to effectively reverse an original invoice by applying negative numbers such a reversal may be necessary if the goods or services have not been provided as promised or if an invoice has inadvertently been issued to the incorrect customer