Authentication and credentials

Initial setup: create the account in Koncili, create the application in Bling (in the Extensions Center) and connect both ends via OAuth. Done once per customer.

Step 1

Create the Bling ERP account in Koncili

In Koncili, go to Integrations in the side menu and choose the Bling card.

Koncili Integrations screen with the Bling ERP card

Click Create new account.

Bling ERP screen in Koncili with the Create new account button

On the creation screen, copy the redirect URL shown (read-only, Copy button) — this link will be pasted into the Bling app registration (Step 6).

Bling ERP screen in Koncili with the redirect URL and Copy button — Bling ERP account creation screen in Koncili — copy the **redirect URL** (Copy button).

Step 2

Open the Bling Extensions Center

In Bling, click the grid icon (⊞) in the top-right corner of the header, next to the notifications bell — it opens the Extensions Center.

Bling dashboard with the grid icon highlighted in the top-right corner — In the Bling header, click the grid icon (⊞) — it opens the Extensions Center.

Step 3

Go to the Integrator Area

In the Extensions Center, on the Discover tab, click Integrator Area, in the top-right corner of the screen.

Bling Extensions Center on the Discover tab with the Integrator Area button highlighted — Extensions Center > Discover > **Integrator Area** (top-right corner).

Step 4

Create the application

In the Integrator Area, under Application registration, click + Create application.

Bling Application registration screen with the Create application button highlighted — Application registration — click **+ Create application**.

Step 5

Choose the application type

Select the API type ("Get access to Bling's API v3!") and, under Select the application usage, choose Private — to use the API only in the customer's own account.

The Public type (operating on third-party accounts and publishing to the Extensions Center) does not apply to this integration.

Bling application type selection with API and Private usage selected — Application type: **API** + **Private** usage.

Step 6

Fill in basic data, redirect and scopes

Under Basic data, fill in name, category (ERP), description and short description. In the Redirect link field, paste the URL copied in Step 1.

Bling application Basic data form with name, ERP category and redirect link — Basic data — name, **ERP** category and the **Redirect link** copied in Step 1.

Under Scope list, add the permissions the integration uses:

Categories — Income and Expenses
Accounts Receivable
Accounts Receivable: Write off accounts receivable
Invoices (NF-e)
Sales Orders

Bling application scope list with the five permissions selected — Scope list — the integration's five permissions selected.

Step 7

Copy the Client ID and Client Secret

Once saved, Bling generates the Client ID and Client Secret on the App information tab. Copy both values (copy icon next to each field) — they will be pasted into Koncili in the next step.

Bling App information tab with Client ID and Client Secret — App information — copy the **Client ID** and **Client Secret** (values hidden in this image).

Step 8

Connect the account in Koncili

Go back to the account creation screen in Koncili. Paste the Client ID and Client Secret into the matching fields (both required on creation; the secret is optional to resend in a future edit) and name the account.

Also fill in the Accounts receivable sync start date — the date from which Koncili starts fetching the receivables in Bling (at most 1 year back and not editable afterwards; see Important limitations).

Click Connect with Bling to open the OAuth authorization and, after completing authentication, click Save.

Deleting the application: Bling warns, on the App information screen, that deleting the application automatically revokes the access tokens — connected users lose access and the integration stops working until the app is recreated and reconnected.

Invalid connection: if the access sits unused for about 30 days, the authorization is rejected and the connection becomes invalid — reconnect the account with the Reconnect button (see Important limitations).