Conta Azul MCP

REMOTE · API.MCP.AI · SCANNED AUG 3

Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.

Available components

+5 this week 56 56 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security46

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (contaazul_person_delete). See how to fix → View diagnostics → Fail
HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability57

AI-judged instruction clarity (fair).Partial
Context-footprint check failed: tool/resource definitions use about 5628 tokens (~102/item across 55 items; 55 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage67

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
0% of tool parameters carry a description.Fail

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · api.mcp.ai

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add --transport http douglac-contaazul-mcp https://api.mcp.ai/contaazul

# ~/.codex/config.toml

[mcp_servers.douglac-contaazul-mcp]
url = "https://api.mcp.ai/contaazul"

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "douglac-contaazul-mcp": {
      "type": "remote",
      "url": "https://api.mcp.ai/contaazul",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add douglac-contaazul-mcp --url https://api.mcp.ai/contaazul --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  douglac-contaazul-mcp:
    url: "https://api.mcp.ai/contaazul"

// mcp.json

{
  "mcpServers": {
    "douglac-contaazul-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/contaazul"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.200 → 0.9.201 functional
2 Aug 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.197 → 0.9.200 functional
1 Aug 26 +2
- The server rewrote its instructions, which are the text every model session reads security
- Tool “marketplace” rewrote its description, which is the text the model reads security
- Server version: 0.9.196 → 0.9.197 functional
31 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.184 → 0.9.194 functional
28 Jul 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Server version: 0.9.182 → 0.9.184 functional
27 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://api.mcp.ai/contaazul

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=mcp.ai	CN=WE1,O=Google Trust Services,C=US	31 Jul 2026	29 Oct 2026	ECDSA 256	ECDSA-SHA256	796a3b1f576e3f2e133c5d19d8f7be3b
SANs: mcp.ai, *.mcp.ai
CN=WE1,O=Google Trust Services,C=US (CA)	CN=GTS Root R4,O=Google Trust Services LLC,C=US	13 Dec 2023	20 Feb 2029	ECDSA 256	ECDSA-SHA384	7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA)	CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE	15 Nov 2023	28 Jan 2028	ECDSA 384	SHA256-RSA	7fe530bf331343bedd821610493d8a1b

DNSSEC insecure

Validation of api.mcp.ai. — Not signed

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
ai.	present	3799	8	Verified
mcp.ai.	absent			Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://api.mcp.ai/contaazul	Verified	200
http (plaintext)	http://api.mcp.ai/contaazul	Inconclusive	406

MCP tools — 55 exposed · ~5,498 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

authenticate ~99

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

Input Output Examples

Name	Type	Req	Description
token	string	—	—

No output schema declared.

No examples provided.

connect ~42

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

contaazul_contract_next_number ~28

Retorna o próximo número de contrato disponível.

Input Output Examples

Name	Type	Req	Description
account	string	—	—

No output schema declared.

No examples provided.

contaazul_contract_write ~39

Cria um contrato. `data` é o payload em JSON.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—

No output schema declared.

No examples provided.

contaazul_create_budget ~104

Cria um orçamento. `data` é o JSON com id_cliente (obrigatório, UUID de uma pessoa com perfil Cliente), data_orcamento (obrigatório, YYYY-MM-DD), itens[] (cada item exige id do produto/serviço + tipo/quantidade/valor), data_validade, id_vendedor e composicao_de_valor (frete, desconto).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—

No output schema declared.

No examples provided.

contaazul_delete_budgets ~71

Exclui orçamentos em lote por id. Operação destrutiva, confirme antes. `ids` é a lista de UUIDs de orçamento (a API v2 não tem exclusão por id única).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
ids	array	yes	—

No output schema declared.

No examples provided.

contaazul_delete_contract ~57

Remove um contrato por id. Operação destrutiva, confirme antes. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_delete_settlement ~71

Estorna (remove) uma baixa por id. Operação destrutiva, confirme antes. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_generate_charge ~107

Gera uma cobrança (boleto, pix ou link de pagamento) a partir de uma conta a receber. `data` é o JSON da geração: tipo da cobrança (BANKING_BILLET, PIX_CHARGE, CREDIT_CARD), referência da(s) parcela(s) e maximo_parcelas (opcional). Requer que a integração tenha sido criada após março/2025 no Conta Azul.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—

No output schema declared.

No examples provided.

contaazul_get_account_balance ~74

Saldo atual de uma conta financeira por id (banco/caixa/cartão). Pegue o id em contaazul_list_financial_accounts. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_get_budget ~60

Detalhe de um orçamento por id (itens, cliente, composição de valor). Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_get_company ~35

Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).

Input Output Examples

Name	Type	Req	Description
account	string	—	—

No output schema declared.

No examples provided.

contaazul_get_contract ~63

Detalhe de um contrato por id (cliente, termos, condição de pagamento, composição de valor). Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_get_initial_balance ~77

Saldos iniciais das contas financeiras por período. data_inicio e data_fim (YYYY-MM-DD ou ISO date-time; datas simples são normalizadas). Se omitidas, usa uma janela ampla.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data_fim	string	—	—
data_inicio	string	—	—

No output schema declared.

No examples provided.

contaazul_get_installment ~52

Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_get_invoice_nfe ~54

Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_get_person ~51

Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_get_sale ~51

Detalhe de uma venda por id. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_get_settlement ~61

Detalhe de uma baixa por id. `id` é o UUID da baixa. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_list_accounts ~34

Lista as empresas Conta Azul vinculadas a este install (company_id, label).

Input Output Examples

Name	Type	Req	Description
account	string	—	—

No output schema declared.

No examples provided.

contaazul_list_budgets ~55

Lista orçamentos (cliente, número, total, situação, versão). Paginado.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_categories ~48

Lista categorias financeiras (DRE).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—
tipo	string	—	—

No output schema declared.

No examples provided.

contaazul_list_changed_events ~107

Lista os IDs de eventos financeiros alterados num período (para sync incremental / conciliação). data_inicio e data_fim (YYYY-MM-DD ou ISO date-time). Paginado. Retorna só os IDs; use contaazul_get_installment para o detalhe.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data_fim	string	—	—
data_inicio	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_contracts ~160

Lista contratos no intervalo de data de início (data_inicio/data_fim, YYYY-MM-DD — obrigatórios na API; se omitidos, usa janela ampla = listar todos). Filtros: pagina, tamanho_pagina (máx 50), cliente_id, busca_textual. A API v2 não tem GET contrato por id nem cancelar/excluir. Bulk support: accepts cliente_ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
busca_textual	string	—	—
cliente_id	string	—	—
cliente_ids	array	—	—
data_fim	string	—	—
data_inicio	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_cost_centers ~41

Lista centros de custo.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_financial_accounts ~47

Lista contas financeiras (banco, caixa, cartão).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_installments ~82

Lista as parcelas de UM evento financeiro (passe `id_evento`). A API v2 não tem listagem chapada de todas as parcelas — pra varrer contas a receber/pagar use contaazul_list_receivables / contaazul_list_payables.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id_evento	string	yes	—

No output schema declared.

No examples provided.

contaazul_list_invoices_nfe ~97

Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data_emissao_fim	string	—	—
data_emissao_inicio	string	—	—
pagina	number	—	—
status	string	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_invoices_nfse ~250

Lista NFS-e (notas fiscais de serviço) por filtro. Exige data_competencia_de e data_competencia_ate (YYYY-MM-DD), com janela máxima de 15 dias (se omitidas, usa os últimos 15 dias). Outros filtros: id_cliente, numero_venda, status (PENDENTE, PRONTA_ENVIO, EMITIDA, CANCELADA…), tipo_negociacao (VENDA, CONTRATO), numero_nfse_inicial, numero_nfse_final, numero_rps_inicial, numero_rps_final.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data_competencia_ate	string	—	—
data_competencia_de	string	—	—
id_cliente	string	—	—
numero_nfse_final	number	—	—
numero_nfse_inicial	number	—	—
numero_rps_final	number	—	—
numero_rps_inicial	number	—	—
numero_venda	string	—	—
pagina	number	—	—
status	string	—	—
tamanho_pagina	number	—	—
tipo_negociacao	string	—	—

No output schema declared.

No examples provided.

contaazul_list_payables ~141

Lista contas a pagar (parcelas de despesa). Filtros: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD; se omitidas, lista todas), status (PERDIDO, RECEBIDO, EM_ABERTO, RENEGOCIADO, RECEBIDO_PARCIAL, ATRASADO).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data_vencimento_ate	string	—	—
data_vencimento_de	string	—	—
pagina	number	—	—
status	string	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_people ~96

Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo_perfil, ativo.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
ativo	boolean	—	—
busca	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—
tipo_perfil	string	—	—

No output schema declared.

No examples provided.

contaazul_list_products ~67

Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
ativo	boolean	—	—
busca	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_receivables ~158

Lista contas a receber (parcelas de receita). Filtros: tamanho_pagina, pagina, data_vencimento_de, data_vencimento_ate (YYYY-MM-DD; se omitidas, lista todas), status (PERDIDO, RECEBIDO, EM_ABERTO, RENEGOCIADO, RECEBIDO_PARCIAL, ATRASADO), ids_clientes (UUID do cliente).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data_vencimento_ate	string	—	—
data_vencimento_de	string	—	—
ids_clientes	string	—	—
pagina	number	—	—
status	string	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_sales ~118

Lista vendas. Filtros: tamanho_pagina, pagina, data_inicio, data_fim (YYYY-MM-DD), cliente_id, status_venda. Bulk support: accepts cliente_ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
cliente_id	string	—	—
cliente_ids	array	—	—
data_fim	string	—	—
data_inicio	string	—	—
pagina	number	—	—
status_venda	string	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_services ~46

Lista serviços cadastrados.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
busca	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_list_settlements ~61

Lista as baixas de uma parcela. `id` é o UUID da parcela. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_list_transfers ~99

Lista transferências entre contas financeiras por período (conciliação). data_inicio e data_fim (YYYY-MM-DD) com janela máxima de 1 ano (se omitidas, usa os últimos 365 dias). Paginado.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data_fim	string	—	—
data_inicio	string	—	—
pagina	number	—	—
tamanho_pagina	number	—	—

No output schema declared.

No examples provided.

contaazul_payable_create ~222

Cria um evento financeiro de conta a pagar. `data` é o JSON do EventoFinanceiroRequest (mesma estrutura do contaazul_receivable_create: data_competencia, valor, observacao, descricao, contato (UUID do fornecedor), conta_financeira (UUID), condicao_pagamento.parcelas[] (cada parcela leva detalhe_valor:{valor_bruto obrigatório; valor_liquido derivado se omitido} — os aliases valor_composicao e composicao_valor são normalizados automaticamente), rateio[] opcional. metodo_pagamento da parcela usa o enum EXATO da API (PIX_PAGAMENTO_INSTANTANEO, BOLETO_BANCARIO, TRANSFERENCIA_BANCARIA, CARTAO_CREDITO, CARTAO_DEBITO, DINHEIRO etc — formas curtas como PIX/BOLETO/TED são normalizadas). Retorna 202 + {protocolId,status} (assíncrono).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—

No output schema declared.

No examples provided.

contaazul_person_delete ~57

Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_person_write_create ~236

Cria ou atualiza uma pessoa. action=create: requer nome, tipo_pessoa e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e APENAS os campos a alterar em `data` (JSON) — a tool lê o cadastro atual e mescla (update parcial; campo com valor null limpa). Enums de escrita: tipo_pessoa = Física|Jurídica|Estrangeira; perfis = [{"tipo_perfil":"Cliente"|"Fornecedor"|"Transportadora"}] (variações de caixa/acento são normalizadas). No update, o Conta Azul valida o cadastro INTEIRO e pode exigir campos que o registro ainda não tem (ex.: codigo, rg, data_nascimento e inscricoes para pessoa Física) — o erro retornado diz qual falta; inclua-o no `data`. [Flattened action: create] Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—
id	string	—	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_person_write_update ~236

Cria ou atualiza uma pessoa. action=create: requer nome, tipo_pessoa e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e APENAS os campos a alterar em `data` (JSON) — a tool lê o cadastro atual e mescla (update parcial; campo com valor null limpa). Enums de escrita: tipo_pessoa = Física|Jurídica|Estrangeira; perfis = [{"tipo_perfil":"Cliente"|"Fornecedor"|"Transportadora"}] (variações de caixa/acento são normalizadas). No update, o Conta Azul valida o cadastro INTEIRO e pode exigir campos que o registro ainda não tem (ex.: codigo, rg, data_nascimento e inscricoes para pessoa Física) — o erro retornado diz qual falta; inclua-o no `data`. [Flattened action: update] Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—
id	string	—	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_product_write ~79

Cria um produto (nome + valor_venda obrigatórios em `data` JSON). A API v2 do Conta Azul não expõe atualização nem GET de produto por id — para consultar, use contaazul_list_products (/produto/busca) com filtro.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—

No output schema declared.

No examples provided.

contaazul_receivable_create ~317

Cria um evento financeiro de conta a receber. `data` é o JSON do EventoFinanceiroRequest. OBRIGATÓRIOS: data_competencia (YYYY-MM-DD), valor (number), observacao, descricao, contato (UUID do cliente — via contaazul_list_people), conta_financeira (UUID — via contaazul_list_financial_accounts), condicao_pagamento.parcelas[] (cada: descricao, data_vencimento YYYY-MM-DD, nota, conta_financeira UUID, detalhe_valor:{valor_bruto obrigatório; valor_liquido derivado se omitido} — os aliases de leitura valor_composicao (o que contaazul_get_installment devolve) e de baixa composicao_valor são normalizados automaticamente pro detalhe_valor, metodo_pagamento com o enum EXATO da API: PIX_PAGAMENTO_INSTANTANEO, BOLETO_BANCARIO, TRANSFERENCIA_BANCARIA, CARTAO_CREDITO, CARTAO_DEBITO, DINHEIRO, DEPOSITO_BANCARIO, DEBITO_AUTOMATICO etc — formas curtas comuns como PIX/BOLETO/TED são normalizadas). OPCIONAL: rateio[] (cada: id_categoria UUID via contaazul_list_categories, valor, rateio_centro_custo[]). Retorna 202 + {protocolId,status} (processamento assíncrono).

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—

No output schema declared.

No examples provided.

contaazul_sale_cancel ~56

Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_sale_write_create ~94

Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON. [Flattened action: create] Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—
id	string	—	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_sale_write_update ~94

Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON. [Flattened action: update] Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—
id	string	—	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_service_write ~42

Cria um serviço. `data` é JSON com nome, valor, etc.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—

No output schema declared.

No examples provided.

contaazul_settle_installment ~301

Registra a baixa (recebimento/pagamento) de uma parcela. `id` é o UUID da PARCELA (via contaazul_list_receivables / _list_payables / _get_installment). `data` é o JSON da baixa: data_pagamento (YYYY-MM-DD), composicao_valor {valor_bruto, multa, juros, desconto, taxa, valor_liquido}, conta_financeira (UUID em string, via contaazul_list_financial_accounts) e metodo_pagamento, enum EXATO da API: DINHEIRO, PIX_PAGAMENTO_INSTANTANEO, BOLETO_BANCARIO, TRANSFERENCIA_BANCARIA, CARTAO_CREDITO, CARTAO_DEBITO, CARTAO_CREDITO_VIA_LINK, CHEQUE, DEPOSITO_BANCARIO, CARTEIRA_DIGITAL, CASHBACK, CREDITO_LOJA, CREDITO_VIRTUAL, OUTRO (formas curtas como PIX, BOLETO, CARTAO ou TRANSFERENCIA dão 400); observacao é opcional. O campo `versao` (controle de concorrência) é buscado automaticamente. Retorna a baixa com id_reconciliacao. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_terminate_contract ~59

Encerra um contrato por id. Operação sensível, confirme antes. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

contaazul_update_installment ~178

Atualiza campos de uma parcela (PATCH). Campos editáveis em `data` JSON: nota, descricao, vencimento (YYYY-MM-DD), composicao_valor:{valor_bruto,multa,juros,desconto,taxa,valor_liquido}, data_pagamento_esperado, metodo_pagamento, perda, nsu, pagamento_agendado, id_conta_financeira. O campo `versao` (controle de concorrência) é buscado automaticamente — não precisa passar. Para registrar pagamento/baixa use contaazul_settle_installment e para estornar use contaazul_delete_settlement. Bulk support: accepts ids for batched execution.

Input Output Examples

Name	Type	Req	Description
account	string	—	—
data	string	yes	—
id	string	yes	—
ids	array	—	—

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	50
27 Jul	51
28 Jul	51
29 Jul	52
30 Jul	53
31 Jul	53
1 Aug	55
2 Aug	55
3 Aug	56