
Finanzas y pagos
Conta Azul en tu producto y en tus agentes de IA, con una API
El toolkit de Conta Azul cubre personas (clientes, proveedores y transportistas), cuentas por cobrar, cuentas por pagar, cuotas, ventas, categorías financieras y cuentas financieras. Tu cliente conecta Conta Azul una vez con OAuth, y tu producto o agente de IA ejecuta cada operación a través de Connect, que guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/conta_azul_create_person/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"nome": "<nome>",
"tipo_pessoa": "Física"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Conta Azul.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Conta Azul. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Conta Azul.
Envía cobros al ERP
Crea un cliente con Crear persona y una cuenta por cobrar dividida por categoría y cuotas, para que lo que factura tu producto aparezca en las finanzas del cliente.
Paneles de flujo de caja
Lista las cuentas por cobrar y por pagar con vencimiento en un período, con sus totales, para mostrar montos vencidos y por vencer dentro de tu app.
Agente concilia cuotas
Un agente de IA lee una cuota, toma su versao y actualiza el vencimiento o el valor cuando cambia un acuerdo de pago.
Tools
13 tools de Conta Azul
- Listar personasGETLista las personas de la empresa, que son sus clientes, proveedores y transportistas, con filtro opcional por texto, perfil o tipo. La respuesta trae items y totalItems; pagina con pagina, y una página menor que tamanho_pagina es la última.
- Obtener personaGETDevuelve una persona, con tipo, documento, email, teléfonos, direcciones, perfiles y los montos vencidos por pagar y por cobrar.
- Crear personaPOSTCrea una persona, que es cliente, proveedor o transportista según perfis. nome y tipo_pessoa son obligatorios; envía cpf para persona física y cnpj para empresa. La respuesta trae el id de la persona.
- Actualizar personaPATCHActualiza parte de una persona: solo cambian los campos enviados. Para cambiar una dirección existente, envía su id obtenido en Obtener persona.
- Listar cuentas por cobrarGETLista las cuotas por cobrar (contas a receber) con vencimiento en un período, con cliente, categorías, montos pagados y abiertos y estado, además de los totales del período en totais. La respuesta trae itens e itens_totais; pagina con pagina, y una página menor que tamanho_pagina es la última.
- Listar cuentas por pagarGETLista las cuotas por pagar (contas a pagar) con vencimiento en un período, con proveedor, categorías, montos pagados y abiertos y estado, además de los totales del período en totais. La respuesta trae itens e itens_totais; pagina con pagina, y una página menor que tamanho_pagina es la última.
- Obtener cuotaGETDevuelve una cuota de una cuenta por cobrar o por pagar, con vencimiento, composición del valor, pagos (baixas), cobros y versao, que Actualizar cuota exige.
- Actualizar cuotaPATCHActualiza parte de una cuota de cuenta por cobrar o por pagar, como el vencimiento, el valor o la forma de pago. Envía la versao devuelta por Obtener cuota: la actualización se rechaza si falta o está desactualizada.
- Crear cuenta por cobrarPOSTCrea una cuenta por cobrar para un cliente: valor se divide entre categorías en rateio y entre vencimientos en condicao_pagamento.parcelas. La respuesta trae el id del evento financiero, y sus cuotas aparecen en Listar cuentas por cobrar.
- Crear cuenta por pagarPOSTCrea una cuenta por pagar a un proveedor: valor se divide entre categorías en rateio y entre vencimientos en condicao_pagamento.parcelas. La respuesta trae el id del evento financiero, y sus cuotas aparecen en Listar cuentas por pagar.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/conta_azul, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Conta Azul
¿Necesito implementar la API de Conta Azul?
No. Connect ya trae 13 tools de Conta Azul descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Conta Azul?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
