# Conecte a NegociarHoje ao que você já usa

Planilha, API, servidor MCP ou conector: os títulos entram do jeito mais simples para você, e os pagamentos voltam por webhook.

> **Resposta direta:** A NegociarHoje se integra por quatro caminhos: import de planilha CSV/XLSX com mapeamento assistido; API REST v1 (api.negociarhoje.com.br/v1) com OpenAPI 3.1, chaves com escopos, idempotência e webhooks assinados com HMAC-SHA256; servidor MCP remoto (mcp.negociarhoje.com.br) com OAuth 2.1 para operar a cobrança a partir de assistentes como Claude e ChatGPT; e conectores com ERPs e gateways brasileiros usando Nango como cofre de credenciais.

## API REST v1

- Endpoints de devedores, títulos (unitário e lote de até 1.000), pagamentos informados, acordos, relatórios e imports.
- Chave com escopos e prefixo visível, segredo mostrado uma vez.
- Idempotency-Key obrigatória em POST, paginação por cursor, headers de rate limit.
- Webhooks: debt.contacted, agreement.created, payment.confirmed, agreement.broken, debt.disputed, debtor.opted_out, escalation.created e eventos de negativação e protesto.

## Servidor MCP

Tools em português como cadastrar_divida, importar_dividas_em_lote, consultar_divida, suspender_cobranca, informar_pagamento, listar_acordos, resumo_da_carteira e desempenho_da_regua. Qualquer assistente compatível com MCP opera a cobrança por conversa. Guia em /docs/mcp.

## Conectores

| Sistema | Situação |
| --- | --- |
| Asaas (API key) | primeira onda |
| Omie | primeira onda |
| Bling | primeira onda |
| Conta Azul | primeira onda |
| Tiny, Vindi, Iugu, Pagar.me, Mercado Pago, Stripe | segunda onda |
| Superlógica (condomínios), IXC Soft (provedores) | segunda onda |
| TOTVS Protheus, RM e Datasul (com agente conector na rede do cliente) | plano Empresa |
| SAP S/4HANA (OData) e Business One (Service Layer) | plano Empresa |
| Bitrix24, Sankhya, Senior, NetSuite, Dynamics | plano Empresa |

_Conectores de ERP são somente leitura por padrão; a baixa no ERP só acontece com permissão explícita do cliente._

## Identificação de pagamento

Webhooks Asaas e de outros gateways, retorno CNAB 240/400, Pix por webhook do PSP, conectores de ERP, baixa manual e, opcionalmente, Open Finance. Tudo idempotente, com assinatura verificada e conciliação por identificador, txid ou nosso número.

---
Fonte: https://negociarhoje.com.br/integracoes (atualizado em 2026-09-29)