Through this endpoint you can indicate that the underlying tax calculation resulted in payment, meaning that Fonoa can increment revenue. The tax calculation will then become "committed".
If you would like to increment your revenue or the revenue of a supplier on your platform/marketplace you will need to provide the relevant external_supplier_reference in the tax calculation API call. Fonoa will then increment revenue for that supplier when you use the commit tax calculation endpoint.
All transactions that are not committed are marked as "not_commited" in our system.
You can commit revenue using either the uuid provided in the response of the tax calculation API call or by using the external_order_reference assuming you provided it during the tax calculation API call. In either case, you need to send the external_supplier_reference in the tax calculation request in order for Fonoa to be able to match revenue to the relevant supplier.
The sum of all the "commits" is available in the tracked_amount field in the GET Revenue endpoint.
Example use case: If you are calculating the tax rate during a checkout process, you can use the commit endpoint in order to increment revenue after the consumer completed the payment.
On the other hand, if you know that revenue will be made for a certain tax calculation upfront, then you can specify this directly in the tax calculation request (see parameter “commit” in the Request a calculation endpoint). This would automatically commit the revenue for the relevant supplier resulting from the transaction for which you are calculating the tax rate. This could be the case with calculating tax rates on the commission that is due with certainty.