Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Bling ERP Skill · evolution-foundation | DecimalAI

evolution-foundation/int-bling

SkillScore91Maintained

Bling ERP integration via API v3. Manage products, sales orders, contacts, fiscal invoices (NF-e), and stock. Use when users ask about ERP data, products, orders, contacts, invoices, or inventory from Bling. Integração com ERP Bling: produtos, pedidos, contatos, NF-e, estoque.

industryby evolution-foundation

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Finance & Accounting pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/evolution-foundation-int-bling/SKILL.md

decimalai skills pull evolution-foundation-int-bling --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/evolution-foundation-int-bling/SKILL.md https://app.decimal.ai/s/evolution-foundation-int-bling/SKILL.md

Raw file: /s/evolution-foundation-int-bling/SKILL.md ↗ · machine-readable summary at /s/evolution-foundation-int-bling.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

23 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 27h ago

Yes — +43% lift · at higher cost+119% tokens0% turns91% of whole cases pass with skill (21/23)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	168%	0%
case-02	✗→✓	▲ Improved	155%	0%
case-03	✗→✓	▲ Improved	185%	0%
case-07	✗→✓	▲ Improved	185%	0%
case-09	✗→✓	▲ Improved	74%	0%

Showing 5 of 23 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

evolution-foundation / evo-nexus

.claude/skills/int-bling/SKILL.md

View on GitHub ↗

License NOASSERTIONImported 8/3/2026Version v1Bundled 2 files · scripts

Skill contents

scripts/

SKILL.md

Bling ERP Skill

Integration with Bling ERP via REST API v3 (OAuth2 Bearer).

When to use

List or create products, services, or kits in Bling
Create or query sales orders
Manage contacts (customers/suppliers)
Issue or list fiscal invoices (NF-e)
Check or update stock levels

Setup

This skill uses a Python client (scripts/bling_client.py) that handles OAuth2 Bearer auth with automatic refresh on 401. You do OAuth once via the CLI, then the skill refreshes tokens transparently forever.

One-time OAuth setup

Create an app at https://developer.bling.com.br → "Meus Apps"
Set the app's redirect URI to: http://localhost:8787/callback
Copy the Client ID and Client Secret into .env:

bash BLING_CLIENT_ID=... BLING_CLIENT_SECRET=...

Run the login helper:

bash make bling-auth This opens your browser, captures the authorization code via a local callback server, exchanges it for access_token + refresh_token, and persists both to .env.

After this step, .env contains:

bash
BLING_CLIENT_ID=...
BLING_CLIENT_SECRET=...
BLING_ACCESS_TOKEN=...
BLING_REFRESH_TOKEN=...

How the auto-refresh works

scripts/bling_client.py is the single entry point for all API calls. On any HTTP 401, it:

Exchanges BLING_REFRESH_TOKEN for a new access_token + refresh_token at https://www.bling.com.br/Api/v3/oauth/token (Basic auth with Client ID/Secret)
Persists both back to .env and os.environ
Retries the original request once

Bling rotates the refresh token on every refresh, so always use this client — never call the API with raw curl unless you're debugging, otherwise you risk the .env tokens going stale.

Calling the client

bash
python3 .claude/skills/int-bling/scripts/bling_client.py GET /produtos --params page=1 limit=50
python3 .claude/skills/int-bling/scripts/bling_client.py POST /contatos --body '{"nome":"Acme","tipo":"J","numeroDocumento":"12345678000100"}'
python3 .claude/skills/int-bling/scripts/bling_client.py PUT /produtos/123 --body '{"preco":99.90}'

The client prints the JSON response to stdout and logs errors to stderr.

Base URL

https://www.bling.com.br/Api/v3

Products

List products

bash
curl -s -X GET \
  "https://www.bling.com.br/Api/v3/produtos?pagina=1&limite=100" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}"

Query params: | Param | Type | Description | |-------|------|-------------| | pagina | number | Page number (default 1) | | limite | number | Items per page (default 100, max 100) | | nome | string | Filter by product name | | codigo | string | Filter by SKU/code | | tipo | string | P=Product, S=Service, K=Kit |

Create product

bash
curl -s -X POST \
  "https://www.bling.com.br/Api/v3/produtos" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Widget Pro",
    "codigo": "WGT-001",
    "preco": 99.90,
    "precoCusto": 45.00,
    "tipo": "P",
    "formato": "S",
    "situacao": "A",
    "unidade": "UN"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | nome | string | yes | Product name | | preco | number | yes | Sale price | | tipo | string | yes | P=Product, S=Service, K=Kit | | formato | string | yes | S=Simple, E=With variations, V=Variation | | codigo | string | no | SKU/code | | precoCusto | number | no | Cost price | | situacao | string | no | A=Active, I=Inactive | | unidade | string | no | Unit (UN, KG, etc.) | | pesoLiquido | number | no | Net weight in kg | | pesoBruto | number | no | Gross weight in kg |

Sales Orders

List orders

bash
curl -s -X GET \
  "https://www.bling.com.br/Api/v3/pedidos/vendas?pagina=1&limite=100&dataInicial=2026-01-01&dataFinal=2026-04-10" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}"

Query params: | Param | Type | Description | |-------|------|-------------| | pagina | number | Page number | | limite | number | Items per page | | idsSituacoes[] | number | Filter by status ID | | dataInicial | string | Start date YYYY-MM-DD | | dataFinal | string | End date YYYY-MM-DD |

Create order

bash
curl -s -X POST \
  "https://www.bling.com.br/Api/v3/pedidos/vendas" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "contato": { "id": 123456 },
    "data": "2026-04-10",
    "observacoes": "Test order",
    "itens": [
      {
        "produto": { "id": 789 },
        "quantidade": 2,
        "valor": 99.90,
        "desconto": 0
      }
    ]
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | contato.id | number | yes | Contact (customer) ID | | itens | array | yes | Order line items | | itens[].produto.id | number | yes | Product ID | | itens[].quantidade | number | yes | Quantity | | itens[].valor | number | yes | Unit price | | itens[].desconto | number | no | Discount amount | | data | string | no | Order date YYYY-MM-DD | | observacoes | string | no | Notes |

Contacts

List contacts

bash
curl -s -X GET \
  "https://www.bling.com.br/Api/v3/contatos?pagina=1&limite=100&tipoPessoa=J" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}"

Query params: | Param | Type | Description | |-------|------|-------------| | pagina | number | Page number | | limite | number | Items per page | | nome | string | Filter by name | | tipoPessoa | string | F=Individual (CPF), J=Legal entity (CNPJ) |

Create contact

bash
curl -s -X POST \
  "https://www.bling.com.br/Api/v3/contatos" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Empresa Exemplo LTDA",
    "tipo": "J",
    "numeroDocumento": "12345678000199",
    "email": "contato@empresa.com",
    "telefone": "31999990000"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | nome | string | yes | Contact name | | tipo | string | yes | F=Individual, J=Legal entity | | numeroDocumento | string | no | CPF or CNPJ | | email | string | no | Email address | | telefone | string | no | Phone number | | celular | string | no | Mobile phone |

Fiscal Invoices (NF-e)

List invoices

bash
curl -s -X GET \
  "https://www.bling.com.br/Api/v3/nfe?pagina=1&limite=100" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}"

Query params: | Param | Type | Description | |-------|------|-------------| | pagina | number | Page number | | limite | number | Items per page | | situacao | number | Filter by status code |

Create invoice (from order)

bash
curl -s -X POST \
  "https://www.bling.com.br/Api/v3/nfe" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "pedidoVendaId": 456,
    "tipo": 1,
    "naturezaOperacao": "Venda de mercadoria"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | pedidoVendaId | number | yes | Sales order ID to generate invoice from | | tipo | number | no | Invoice type: 1=Output (Saída), 0=Input (Entrada) | | naturezaOperacao | string | no | Operation nature description |

Stock

Get stock for a product

bash
curl -s -X GET \
  "https://www.bling.com.br/Api/v3/estoques/saldos?idsProdutos[]=789" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}"

Update stock

bash
curl -s -X POST \
  "https://www.bling.com.br/Api/v3/estoques" \
  -H "Authorization: Bearer ${BLING_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "produto": { "id": 789 },
    "deposito": { "id": 1 },
    "operacao": "E",
    "quantidade": 50,
    "observacoes": "Stock received from supplier"
  }'

Body fields: | Field | Type | Required | Description | |-------|------|----------|-------------| | produto.id | number | yes | Product ID | | deposito.id | number | yes | Warehouse/deposit ID | | operacao | string | yes | B=Balance (set), E=Entry (add), S=Exit (subtract) | | quantidade | number | yes | Quantity | | observacoes | string | no | Notes |

Auth Model

Type: OAuth2 Bearer Token
Header: Authorization: Bearer <token>
Token lifetime: short-lived; must be refreshed using the OAuth2 refresh token flow
Scopes: defined per app in the Bling developer portal

Pagination

All list endpoints use:

pagina — page number (1-indexed)
limite — items per page (default 100, max 100)

Date filters use YYYY-MM-DD format.

Rate Limits

Bling API v3 does not publish a hard rate limit publicly. Observed safe throughput is ~10 requests/second. Back off on HTTP 429 responses. For detailed limits, see https://developer.bling.com.br.

Notes

This skill is based on the MCP implementation at workspace/projects/mcp-dev-brasil/packages/erp/bling/src/index.ts (mcp-dev-brasil project)
For advanced endpoints not listed here (product variations, fiscal settings, categories, etc.), consult the official docs at https://developer.bling.com.br
The OAuth2 token management (refresh flow) is not automated by this skill — ensure BLING_ACCESS_TOKEN is fresh before making calls

Want to see if evolution-foundation/int-bling would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/19/2026, 20:37 UTC · 23 cases

Lift

+43%

91% vs 48%

Agent turns

1.0 vs 1.0

Tokens

+119%

3,793.43 vs 1,731.57

fail → pass · 10pass → pass · 11fail → fail · 2

Per-case results (23)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I need to create a sales order in Bling for customer ID 54321. The order contains 3 units of item ID 1099 at 49.90 each, dated 2026-04-15 with notes 'First order discount applied'. Please output the exact terminal command using our client wrapper script to execute this creation request.	fail→pass	8,350	3,813	-54%	1	1	0%	1,528	4,092	+168%	0	0	—
case-02 We need to update our stock levels in Bling ERP to add 120 units for product ID 402 into warehouse deposit ID 2, including the note 'Batch 2026-B received'. Provide the Python client command line call needed to post this stock update.	fail→pass	7,333	3,104	-58%	1	1	0%	1,464	3,737	+155%	0	0	—
case-03 Can you give me the terminal command using our Bling API wrapper script to create a corporate customer named 'Distribuidora Norte LTDA' with CNPJ '12345678000195' and email 'financeiro@norte.com.br'?	fail→pass	7,104	2,539	-64%	1	1	0%	1,303	3,714	+185%	0	0	—
case-04 We want to retrieve page 2 of active simple products filtered by code 'SKU-99' from Bling REST API v3 using HTTP GET. Provide the query string parameter names and values that Bling expects for pagination and code filtering.	pass→pass	12,278	4,804	-61%	1	1	0%	2,258	4,012	+78%	0	0	—
case-05 We are building a JSON payload to register a new physical product named 'Cabo USB-C' with sale price 29.90 in Bling. What single-character string codes should be assigned to the required fields 'tipo' (product type) and 'formato' (simple product without variations)?	pass→pass	4,863	1,996	-59%	1	1	0%	852	3,537	+315%	0	0	—
case-06 When querying sales orders in Bling ERP API v3 for the date range April 1, 2026 through April 10, 2026, which exact query parameter keys must be used to set the initial and final dates?	pass→pass	5,134	2,847	-45%	1	1	0%	985	3,686	+274%	0	0	—
case-07 What is the endpoint path, HTTP method, and JSON request field name needed to issue an NF-e fiscal invoice in Bling API v3 linked to sales order ID 8842?	fail→pass	7,985	2,493	-69%	1	1	0%	1,267	3,616	+185%	0	0	—
case-08 Construct the full HTTP GET endpoint URL path including query parameters to fetch stock balances for product ID 1055 from Bling API v3.	pass→pass	7,829	1,906	-76%	1	1	0%	1,408	3,551	+152%	0	0	—
case-09 During the initial one-time OAuth authentication setup for Bling API v3, what exact local redirect URI host and port must be registered in the Bling developer portal?	fail→pass	11,696	1,740	-85%	1	1	0%	1,966	3,430	+74%	0	0	—
case-10 When the custom Bling Python client helper encounters an HTTP 401 Unauthorized status code during an API call, how does it handle token refresh and request retry?	fail→pass	16,727	3,256	-81%	1	1	0%	2,823	3,738	+32%	0	0	—
case-11 What exact URL endpoint is targeted by the authentication handler when performing an OAuth2 refresh token exchange for Bling ERP?	pass→pass	4,214	1,661	-61%	1	1	0%	738	3,417	+363%	0	0	—
case-12 We want to list corporate entity contacts (CNPJ) from Bling API v3. What exact query parameter key and value should be attached to GET /contatos to filter by legal entity person type?	fail→pass	13,836	2,710	-80%	1	1	0%	2,590	3,622	+40%	0	0	—
case-13 Provide the command using the workspace Python client script to update product ID 314's price to 149.90 in Bling.	fail→pass	5,872	2,540	-57%	1	1	0%	1,051	3,593	+242%	0	0	—
case-14 We need to log a stock removal of 15 units for product ID 501 in deposit ID 1 via Bling API v3. Which single-character operation code field value ('operacao') indicates stock exit/subtraction?	pass→pass	4,214	2,294	-46%	1	1	0%	802	3,538	+341%	0	0	—
case-15 When overriding stock to establish an exact physical inventory balance count rather than adding or subtracting, what character code must be passed in the 'operacao' body field for Bling POST /estoques?	pass→pass	5,175	2,406	-54%	1	1	0%	880	3,582	+307%	0	0	—
case-16 Construct a curl command or endpoint path to fetch page 1 of fiscal invoices (NF-e) with limit 50 from Bling API v3 using standard bearer auth token environment variable.	pass→pass	9,811	5,442	-45%	1	1	0%	1,409	3,733	+165%	0	0	—
case-17 In Bling ERP API v3 product creation, what single-letter character codes are assigned to the 'tipo' field to distinguish a Service and a Kit from a standard Product?	fail→pass	13,550	2,126	-84%	1	1	0%	2,609	3,514	+35%	0	0	—
case-18 When creating an individual person customer (CPF) named 'Carlos Silva' in Bling, what value must be sent for the 'tipo' field in POST /contatos?	pass→pass	5,596	1,759	-69%	1	1	0%	1,033	3,484	+237%	0	0	—
case-19 What is the standard base URL prefix for all Bling ERP REST API v3 resource endpoints?	pass→pass	6,769	1,535	-77%	1	1	0%	1,425	3,385	+138%	0	0	—
case-20 What standard HTTP header name and value format does Bling API v3 require for authenticating requests with an access token?	pass→pass	3,188	1,952	-39%	1	1	0%	506	3,441	+580%	0	0	—
case-21 Can you calculate the exact ICMS-ST ICMS substitution tax base and rate breakdown rules for issuing an interstate invoice from MG to SP for NCM 8504.40.10 in Bling?	fail→fail	22,867	13,359	-42%	1	1	0%	4,219	5,556	+32%	0	0	—
case-22 How do I configure the automated order sync channel rules and webhook mapping for a Magento 2 store inside the Bling administrative web dashboard?	fail→fail	14,704	10,313	-30%	1	1	0%	2,563	4,825	+88%	0	0	—
case-23 Please generate the raw SPED Fiscal EFD text file (Bloco 0, C, E, H) for accounting compliance directly from Bling database tables for March 2026.	fail→pass	19,733	7,305	-63%	1	1	0%	4,147	4,446	+7%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 23 cases were attempted. The headline lift of +43 percentage points is the difference between those two pass rates over the 23 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 47.8%
Pass rate with the skill: 91.3%
Cases attempted: 23
Cases counted toward lift: 23
Cases that regressed: 0
Skill version measured: v1
Run completed: 8/19/2026, 20:37 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Prompt

I need to create a sales order in Bling for customer ID 54321. The order contains 3 units of item ID 1099 at 49.90 each, dated 2026-04-15 with notes 'First order discount applied'. Please output the exact terminal command using our client wrapper script to execute this creation request.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run91

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+220% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested yesterday

Other measured skills in the registry, with their headline benchmark lift.