Como enviar arquivo de conciliação bancária (OFX) via API no Postman – Superlógica Condomínios

Visão geral

A integração de conciliação bancária permite o envio de extratos OFX para o ERP por meio de requisições de API. O envio automatizado da leitura de extratos contorna bloqueios de autenticação ou retornos para a tela de login ao utilizar a rota oficial validada por tokens de segurança.

Quando usar este artigo

Utilize este procedimento quando precisar configurar, testar ou automatizar a integração de conciliação bancária no ERP, simulando o upload de arquivos OFX sem utilizar a interface web.

Sintoma ou cenário

Você está tentando imputar dados de extratos bancários automaticamente via requisição (POST), mas a operação não insere os dados no ERP, não devolve a confirmação correta ou a resposta da requisição exibe o código HTML da página de login (auth0).

Benefício para o usuário ou operação

Processamento automatizado de arquivos de extrato bancário sem depender de cookies de sessão no navegador;
Vinculação direta e estável do arquivo OFX à conta bancária alvo usando parâmetros de validação de API.

Onde acessar / contexto de uso

A configuração e os testes são realizados em ferramentas de requisição (como o Postman) e o resultado é verificado diretamente na tela de Conciliação Bancária do ERP (em Condomínio > Contas Bancárias).

Pré-requisitos (Antes de começar)

Perfil Exato: Usuário com permissão de Caixa - Alteração (1201).
Recursos Sistêmicos: Plano Enterprise I.
Insumos e Dados Técnicos: Arquivo OFX válido salvo na máquina, ID numérico da conta bancária cadastrada no ERP, e as credenciais de API oficiais (app_token e access_token) geradas no painel.

Causas prováveis

Necessidade de homologar a comunicação da API para conciliação bancária, ou ocorrência de falhas na autenticação ao tentar enviar o arquivo OFX utilizando rotas internas do painel em vez das rotas públicas oficiais exigidas.

Como fazer ou corrigir

O upload de arquivos via API exige autenticação por tokens em vez de cookies de sessão e deve obrigatoriamente apontar para a URL pública da Superlógica para validar o envio do documento à conta destino.

No Postman, defina o método da requisição como POST e insira a URL da API oficial:
https://api.superlogica.net/v2/condor/conciliacao/put
Acesse a aba Headers, adicione as chaves app_token e access_token e preencha a coluna de valores com as suas respectivas credenciais. Não utilize a chave Cookie nesta rota.
Na aba Body, selecione a opção form-data para adicionar os quatro parâmetros obrigatórios a seguir.
Na coluna Key, digite ARQUIVO. Altere o tipo de "Text" para "File" clicando no menu dentro da célula e anexe o arquivo .ofx na coluna Value.
Na coluna Key, digite ID_CONTABANCO_CB (mantenha como Text) e insira o número do ID da conta bancária na coluna Value (ex: 5).
Na coluna Key, digite MAX_FILE_SIZE e insira o limite padrão numérico de 83886080 na coluna Value.
Na coluna Key, digite salvar e insira exatamente o texto Enviar arquivo na coluna Value.
Clique em Send para disparar a requisição.

Resultado esperado

A requisição retornará um status de sucesso sem devolução de código HTML de login. Os lançamentos do extrato constarão processados na tela de conciliação bancária do ERP para a conta especificada.

Quando escalar

Acione o time de suporte técnico avançado ou de desenvolvimento da API caso o envio retorne mensagens de erro provenientes do servidor Sensedia (como falha no Client ID), mesmo após a validação de que os tokens inseridos são novos, estão ativos e não possuem espaços em branco na digitação.

Informações que devem ser reunidas antes do escalonamento

Nome da licença;
Nome do condomínio (se houver);
O arquivo .ofx utilizado no teste;
Capturas de tela das abas "Headers" e "Body" no Postman;
A mensagem exata de erro retornada na caixa de resposta da requisição (ex: Client Id in the request is invalid).

Regras importantes / Observações

URLs Internas (Atenção): Evite usar o endereço interno do sistema (https://licenca.superlogica.net/clients/...) para integrações. Estas rotas dependem exclusivamente da sessão do navegador e não validam as chaves de API, inviabilizando automações permanentes.

Problemas comuns e como resolver

Problema: A requisição devolveu 200 OK, mas no corpo da resposta veio uma página web com informações de login ("auth0"). Nada foi imputado no ERP.
Causa provável: O teste foi feito em uma URL interna do painel sem enviar a chave Cookie, fazendo o sistema barrar o Postman e exigir login.
Ação recomendada: Mude a URL para o endereço público da API (api.superlogica.net/...) e insira os parâmetros de token de aplicativo e token de acesso na aba Headers.
Problema: Retorno do erro "Client Id in the request, identified by HEADER app_token, is invalid".
Causa provável: O token utilizado está desativado ou foi copiado com caracteres invisíveis e espaços em branco.
Ação recomendada: Gere uma nova credencial no painel do ERP e cole o novo código prestando atenção aos limites exatos do texto.

Dúvidas relacionadas

P: Preciso enviar os parâmetros de data no Postman junto com o arquivo?
R: Não. O próprio arquivo OFX já contém as datas de todas as transações internamente. Quando a requisição de upload é feita, o sistema lê esse conteúdo e processa o período automaticamente. As datas passadas na URL são usadas apenas em requisições de consulta para aplicar filtros.

Palavras-chave de busca

api superlogica, postman, conciliação bancária, upload de ofx, app token, access token, id contabanco cb, erro auth0, erro sensedia, inserir extrato via api, enviar ofx postman