--- title: "Connecting Conta Azul to Qualy" description: "How the Qualy–Conta Azul integration works—contas a receber for your payments, contas a pagar for commissions, two-way \"paid\" sync by polling, matching by email or código, rateio by cost centre, and how to fix common issues." lastModified: "2026-08-07" lang: "en" wordCount: 1039 url: https://qualyhq.com/training/integrations/conta-azul --- ## Site navigation - [For schools](/international-education/for-schools.md) — For international education schools - [For agents](/international-education/for-education-agents.md) — For international education agents - [Explore](/training.md) — Watch videos on how to use Qualy - [About](/about.md) — Learn about Qualy's mission and values - [Pricing](/pricing) - [5-min demo](/demo.md) - [Login](https://dashboard.qualyhq.com) # Connecting Conta Azul to Qualy > Keep your Conta Azul receivables and payables in step with Qualy. ## At a glance - **Intended for:** Admins & accountants - **Category:** Accounting (Brazil) - **Reading time:** 5 minutes - **Last updated:** 12th July 2026 ## Quick summary Connect Conta Azul in Settings → Add-ons & integrations. Qualy then creates a conta a receber (receivable) for each payment and a conta a pagar (payable) for each commission split, matched to a pessoa by email or código. The sync is two-way: Qualy pushes changes instantly, and because Conta Azul has no webhooks, Qualy checks Conta Azul every few minutes and marks a Qualy payment paid once its parcela is settled (baixa). Multi-category payments are split across cost centres as a rateio. One thing to remember: Conta Azul has no delete for a financial record, so cancelling in Qualy stops future syncing but won't remove a parcela that's already settled. ## Overview The Conta Azul integration keeps your Brazilian accounting in step with Qualy. Once connected, Qualy will: - Create a **conta a receber** (receivable) for each payment you take - Create a **conta a pagar** (payable) for each commission split you owe a partner - Register each person as a **pessoa** (Cliente) so your records line up - Keep the **"paid" status in step both ways** Qualy syncs with a **single Conta Azul organisation**, matched to people by **email** (or by **código**, which Qualy sets to the customer's Qualy number). ## Connecting Conta Azul Open **Settings → Add-ons & integrations**. Find **Conta Azul** and choose **Connect**, then authorise Qualy in Conta Azul. Choose the **organisation** to sync with. Map your **accounts, cost centres (centros de custo) and taxes**, and choose **when payments sync**. ## How the two-way sync works The direction matters here, because Conta Azul works a little differently from Xero or QuickBooks: - **Qualy → Conta Azul is instant.** As you create and update payments and splits, Qualy pushes them straight across as receivables and payables. - **Conta Azul → Qualy is by polling.** Conta Azul doesn't send webhooks, so Qualy **checks it every few minutes**. When a parcela has been settled (a **baixa**) in Conta Azul, Qualy marks the matching payment **paid** in Qualy. Because the return trip is a periodic check rather than an instant push, a payment you reconcile in Conta Azul shows as paid in Qualy **within a few minutes**, not immediately. That's expected. ## What syncs - **Payments → conta a receber** (or **conta a pagar** if you post them as bills), carrying a `QLY-PYMT-…` reference so they're easy to find. - **Commission splits → conta a pagar** for the partner. - **Multi-fee payments → a rateio**, split across the **categorias** and **centros de custo** you've mapped. - **People → pessoas** (Cliente), matched by email or código. ## Accounts, cost centres and taxes ### Accounts and cost centres Map Qualy fee categories to Conta Azul accounts, with a default for anything unmapped, and map to **centros de custo** so revenue and commissions are tagged to the right cost centre. Payments are registered against your chosen **conta financeira**. ### Taxes and the reference Map your Qualy taxes to Conta Azul, and choose what goes in the record's reference (the contact number, or the supplier and due date) so receivables and payables are easy to reconcile. ## Deleting and cancelling This is the one behaviour to keep in mind. **Conta Azul has no way for an app to delete a financial record.** So when you cancel a payment or split in Qualy: - Qualy **stops syncing** it, but - it **can't remove** the receivable or payable from Conta Azul, and - it will **never touch** a parcela that's already been settled (baixa). If you need a cancelled record gone from Conta Azul, remove or write it off **in Conta Azul directly**. Qualy won't delete it for you. ## Troubleshooting ### A sync looks delayed Conta Azul limits how fast any app may call it. In busy periods Qualy paces itself and retries automatically, catching up without losing data. The Conta Azul → Qualy "paid" check also runs on a few-minute cycle by design. ### A person was created as a duplicate If a name or código already exists, Qualy retries with a "(DUPLICATE)" marker (or without the código) so the sync isn't blocked. It usually means the same person exists twice—merge them in Conta Azul and keep the email unique. You can always export the same data as CSV from **Reports** and import it into Conta Azul manually instead. ## Frequently asked questions ### Is the sync two-way? Yes. Qualy pushes changes to Conta Azul as they happen. Because Conta Azul doesn't send webhooks, Qualy also checks it every few minutes and, when a parcela has been settled (baixa) there, marks the matching Qualy payment paid. So a payment reconciled in Conta Azul is reflected in Qualy within a few minutes. ### I cancelled a payment in Qualy but it''s still in Conta Azul. Why? Conta Azul has no API to delete a financial record, so Qualy can only stop syncing it—it can't remove a parcela for you, and it won't touch one that's already been settled (baixa). Remove or write it off in Conta Azul directly if you need to. ### How does Qualy match records to Conta Azul? People (pessoas) match by email address first, then by código—which Qualy sets to the customer's Qualy number. The receivable or payable itself is found by the QLY-PYMT-… reference Qualy writes into it. Keep emails consistent so people line up. ### Can I connect more than one Conta Azul organisation? No—Qualy syncs with a single Conta Azul organisation. Choose the one you want kept in step. ### My payment has several fee types. How does that post? As a rateio—Qualy splits the receivable across the categorias and centros de custo you've mapped, so each fee type lands in the right place in your accounts. ### A sync seems delayed. Is something wrong? Probably not. Conta Azul limits how fast apps may call it, so during busy periods Qualy paces itself and retries. It catches up on its own without losing data. ## Prefer doing this via the Qualy API? Head over to our developer docs for everything you need—endpoints, examples, and simple how-tos. [View API Docs](https://docs.qualyhq.com/docs) ## More on Qualy **Industries** - [For schools](/international-education/for-schools.md) — For international education schools - [For agents](/international-education/for-education-agents.md) — For international education agents **Support** - [Training](/training.md) - [System status](https://qualyhq.statuspage.io/) — Qualy system status - [Product updates](https://changelog.qualyhq.com) — As we work on Qualy, here we spotlight what we’ve learned and updated across our products - [Contact](/contact-us.md) **Product** - [Demo](/demo.md) - [Enterprise](/enterprise.md) - [Testimonials](/testimonials.md) — Learn what some customers have to say about Qualy - [About](/about.md) — Learn about Qualy's mission and values - [Blog](/blog) — International education payments blog by Qualy - [Trust center](/trust.md) - [API](/api.md) — Qualy API for international education payments - [Zapier](/zapier.md) — Connect Qualy to 7,000+ apps with Zapier - [NexPay](/nexpay.md) — Qualy + NexPay — automate everything around the payment **Legal** - [General terms](/terms-and-conditions.md) - [Payer terms](/terms-for-payers.md) - [Privacy policy](/privacy-policy.md) - [BECS DDR](/becs-dd-service-agreement.md)