Skip to main content
Algumas fontes só respondem a uma pessoa com sessão iniciada. A SUNARP exige um DNI peruano, e a DIAN a conta DIAN do próprio contribuinte. Para essas fontes você registra sua própria conta uma vez como conexão, e cada consulta dessa fonte roda com ela.
Você faz isso uma vez por conta. Depois consulta a fonte como qualquer outro endpoint: nada a mais na solicitação.

​
Como se encaixa

A API que recebe suas credenciais pode guardá-las, mas não lê-las. Só o serviço isolado que faz login na fonte pode abri-las, e só para a consulta que precisa delas.

​
1. Registre uma conexão

authorized: true registra que você é o titular da conta ou tem a autorização do titular. A resposta nunca inclui as credenciais, só um nome mascarado.

​
2. Consulte

  • Escolha. A Croma prefere a conexão cuja sessão já está aberta e depois a que tem mais cota. Envie connection_id para usar uma específica.
  • Uma consulta por conta de cada vez. Consultas em contas diferentes rodam em paralelo; as de uma mesma conta esperam a vez, então nunca fazem login uma sobre a outra.
  • Rodízio. Quando uma conta atinge sua cota diária, a mesma consulta passa para a sua próxima conexão. Registre mais de uma para ter mais capacidade.

​
Estados de uma conexão

GET /pe/sunarp/connections/v1 mostra o estado de cada conexão, os logins usados hoje e quando reinicia.

​
Segurança

  • As credenciais são criptografadas assim que chegam à Croma e ficam vinculadas à sua organização: ninguém mais pode usá-las.
  • Só o serviço isolado que faz login na fonte pode abri-las.
  • A API nunca as devolve nem as mostra a ninguém, e elas nunca são gravadas em logs.
  • Excluir uma conexão a destrói permanentemente.

​
A partir do console

platform.usecroma.com/connections lista as conexões da sua organização com o estado e os logins usados hoje, conecta novas e as exclui. O que você digita ali vai do seu navegador direto para a API da Croma e é criptografado ao chegar.

​
A partir de um agente (MCP)

Os mesmos verbos são ferramentas do servidor MCP, um conjunto por fonte: sunarp_connect, sunarp_list_connections e sunarp_delete_connection, e o mesmo para dian_muisca. As credenciais nunca passam pela conversa: a ferramenta de conexão não recebe dados da conta e responde com um link seguro para o console, válido por 30 minutos. A partir daí o agente consulta a fonte como qualquer outra.

SUNARP

Os Registros Públicos do Peru, com sessão iniciada com um DNI.

DIAN

As faturas eletrônicas e a informação exógena de um contribuinte, com a sua conta DIAN em nome próprio ou de uma empresa que representa.

Bancolombia

As contas, saldos e movimentos de um cliente, com o seu acesso à Sucursal Virtual Personas do Bancolombia.