Write-off configuration

One-time configuration, done after connecting — it applies to all subsequent write-offs for that account.

Step 4

Create the write-off configuration (export via API)

In Koncili, go to Smart Report and open the Export via API tab. Click New configuration.

Fill in the fields: Marketplace, Account, ERP (Tiny), ERP account and Template.

For Tiny, the default template is Tiny - API.

Smart Report: Configure Templates, Data Extraction and Export via API — In Smart Report, open the **Export via API** tab (Step 3).

New export-via-API configuration form in Koncili — New export via API configuration: Marketplace, Account, ERP, ERP account and Template.

Step 5

Find the Target Account number in Tiny

This number does not appear directly on a functional Tiny screen. To get the value, open Tiny at Settings > Finance > Financial accounts registry.

With the screen open, use the browser DevTools (F12), go to the network tab and click the desired account to trigger the request; then filter by obter.

Open the obterContaContabil call and, in the response, copy the number from the val field (e.g. 76).

Paste this number into the Target Account field of the configuration and save.

Browser language: the DevTools tab names change with the browser language — in English they are Network and Response; in Portuguese they are Rede and Resposta. The content is the same, only the label changes.

Tiny Finance menu with Financial accounts registry option — Tiny > Settings > Finance > Financial accounts registry.

List of financial accounts registered in Tiny — Locate, in the list, the account matching the one to be written off (e.g. Mercado Pago, Itaú, Caixa...).

DevTools open on the Network tab (English browser) filtering by obterContaContabil — Browser in **English**: F12 → Network → Response — filter by "obter", open the obterContaContabil response and copy the "val" field.

DevTools open on the Rede tab (Portuguese browser) filtering by obterContaContabil — Browser in **Portuguese**: F12 → Rede → Resposta — filter by "obter", open the obterContaContabil response and copy the "val" field.

Target account field filled in the Koncili configuration — Paste the copied number into the "Target account" field and save the configuration.

Created API configuration listed in Koncili — Configuration saved — it appears in the "Registered configurations" list.

Attention: each customer/account has its own target account number. Repeat this process for each configured account.

Step 6

Adjust the export template (when needed)

In Smart Report > Templates, open the Tiny - API template. The format is fixed (no adding or removing columns), but the value mapping can be adjusted.

The default considers Sale + Commission in the paid amount. If your operation uses only the gross amount, adjust the mapping by removing the commission from the calculation.

Entry mapping screen of the Tiny API template — Editing the template mapping: removing the Commission from the paid amount.

Important: when saving changes, Koncili creates a new template (copy). The original default template is not overwritten.