API de Conversão Detonix Tech

Integre conversões de arquivos bancários (OFX, XLSX, PDF) em seu sistema de forma simples, segura e escalável

🚀 v0.1.0 ⚡ 99.9% Uptime 💬 Suporte 24/7

Sem Integração?

Disponibilizamos este sistema para facilitar conversões manuais. Ideal para testes ou uso esporádico sem necessidade de desenvolvimento.

Segurança em Camadas

Chave de criptografia de 32 bits armazenada em nosso sistema. Autenticação Bearer gerada automaticamente após ativação da conta.

Múltiplos Layouts

Suporte aos principais layouts bancários: 001, 001.1, 104.3, 240, 400 e personalizados conforme necessidade.

📡 Endpoint de Conversão

Realize conversões de arquivos financeiros enviando uma requisição POST com multipart/form-data

POST https://contas.detonix.com.br/api/apiExtractFileDetoFinc

📋 Parâmetros da Requisição

Parâmetro Tipo Obrigatório Descrição
layout string Sim Número do layout para conversão. Exemplos: 001, 001.1, 104.3, 240, 400
senha string Opcional Senha do documento (caso o arquivo PDF ou OFX seja protegido)
banco_id integer Sim Código do banco (ex: 001 = Banco do Brasil, 104 = Caixa Econômica, 237 = Bradesco, 341 = Itaú)
pdf_file file (upload) Sim Arquivo PDF enviado via upload. Representa o arquivo binário enviado no corpo da requisição (multipart/form-data) com o campo nomeado como "pdf_file".
Formato aceito: .pdf

🚀 Exemplos de Implementação

c
cURL 
curl -X POST https://contas.detonix.com.br/api/apiExtractFileDetoFinc \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -F 'layout=001' \
  -F 'senha=minha_senha' \
  -F 'banco_id=001' \
  -F 'file=@/caminho/do/arquivo.ofx'
PHP
PHP (Guzzle) 
$client = new \GuzzleHttp\Client();
$response = $client->post('https://contas.detonix.com.br/api/apiExtractFileDetoFinc', [
    'headers' => [
        'Authorization' => 'Bearer SEU_TOKEN_AQUI'
    ],
    'multipart' => [
        ['name' => 'layout', 'contents' => '001'],
        ['name' => 'senha', 'contents' => 'minha_senha'],
        ['name' => 'banco_id', 'contents' => '001'],
        ['name' => 'file', 'contents' => fopen('/caminho/arquivo.ofx', 'r')]
    ]
]);
JS
JavaScript (Fetch) 
const formData = new FormData();
formData.append('layout', '001');
formData.append('senha', 'minha_senha');
formData.append('banco_id', '001');
formData.append('file', fileInput.files[0]);

fetch('https://contas.detonix.com.br/api/apiExtractFileDetoFinc', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer SEU_TOKEN_AQUI'
    },
    body: formData
});
Py
Python (Requests) 
import requests

url = 'https://contas.detonix.com.br/api/apiExtractFileDetoFinc'
headers = {
    'Authorization': 'Bearer SEU_TOKEN_AQUI'
}
files = {
    'file': open('arquivo.ofx', 'rb')
}
data = {
    'layout': '001',
    'senha': 'minha_senha',
    'banco_id': '001'
}

response = requests.post(url, headers=headers, files=files, data=data)

📤 Exemplo de Resposta da API

✅ Sucesso - Status 7 
{
    "status": 7,
    "data": {
        "num_conta": "XXXXXX",
        "saldo_anterior": "0.00",
        "saldo": "0.00",
        "total_somado": "0.00",
        "start_date": "00010109",
        "end_date": "20260131",
        "data": [
            {
                "valor": "0.00",
                "detalhes": "Saldo Anterior",
                "data": "20251231",
                "FITID": "",
                "alert": false
            },
            {
                "valor": "1267.03",
                "detalhes": "Recebimento Fornecedor XXXXXX",
                "data": "20260102",
                "FITID": "",
                "alert": false
            }
        ],
        "message": "Algumas informações neste documento podem conter inconsistências. Por isso, destacamos os lançamentos  (63, 124, 240, 300) que possivelmente estão incorretos. Pedimos, por gentileza, que revise cuidadosamente os lançamentos para garantir que tudo esteja correto."
    },
    "bankid": "001"
}
📊 Descrição dos Campos

Campos Principais:

  • status: 7 - Sucesso
  • bankid: Código do banco processado

Objeto data:

  • num_conta: Número da conta (mascarado)
  • saldo_anterior: Saldo do período anterior
  • saldo: Saldo atual
  • total_somado: Total de movimentações
  • start_date/end_date: Período do extrato (AAAAMMDD)

Array data (transações):

  • valor: Valor da transação
  • detalhes: Descrição do lançamento
  • data: Data da transação (AAAAMMDD)
  • alert: Indica se há inconsistência no lançamento
⚠️ Importante:

O campo "message" contém alertas sobre possíveis inconsistências nos lançamentos destacados.

🔐 Autenticação e Segurança

Todas as requisições devem ser autenticadas utilizando o padrão Bearer Token. Seu token é gerado automaticamente após a ativação da conta.

🔑 Bearer Token

Inclua no header Authorization de todas as requisições

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Gerado na ativação

🔒 Chave de Criptografia (32 bits)

Armazenada internamente em nosso sistema para segurança dos seus dados

••••••••••••••••••••••••••••••••
Registrada em sua conta

📊 Rate Limits

Limitações por plano para garantir performance

  • ✓ Básico: 100 req/dia
  • ✓ Profissional: 1.000 req/dia
  • ✓ Enterprise: 10.000 req/dia
📌 Importante: O token Bearer é pessoal e intransferível. Não compartilhe suas credenciais. Em caso de suspeita de vazamento, solicite imediatamente a regeneração do token através do painel do cliente.