Direct ERP integration

Complete documentation of Koncili's direct integration with Tiny — connection, configuration and automatic write-off of accounts receivable.

📄️ 1. Flow overview

When a reconciliation is analyzed in Koncili, the corresponding accounts receivable entry in Tiny is written off (marked as received) — today, triggered by the team from the Reconciliation screen.

📄️ 2. Authentication and credentials

Initial setup: create the account in Koncili, create the application in Tiny and connect both ends via OAuth. Done once per customer.

📄️ 3. Write-off configuration

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

📄️ 4. Linking receivables

Koncili needs to know which accounts receivable entry, in the ERP, corresponds to each order — today this link is not discovered automatically. You must import this relationship manually whenever there are new orders without a link.

📄️ 5. Tracking and validation

Steps 7, 8 and 9: how the team actually triggers and validates the write-off, after the account is connected and configured.

📄️ 6. Important limitations

Read carefully before enabling automatic write-off for a customer — the process is new (beta) and has specific behaviors. New features will be added in upcoming versions.

📄️ 7. Technical information

Tiny API endpoints actually consumed by Koncili in this integration — reference for anyone who will support or review the flow.