Open Finance: Central de buscas

Painel de acompanhamento da busca de extratos Open Finance de todos os clientes: as rodadas de busca e o resultado de cada conta, os protocolos pedidos à TecnoSpeed, as contas que estão (ou não) na busca, a fila de processamento, as exclusões manuais da rotina, o novo link de consentimento para contas expiradas e as configurações da busca. Complementa Open Finance (TecnoSpeed), que trata do cadastro por cliente.

Autorização

Todas as rotas exigem login de usuário (sessão; credenciais de integração recebem 403) e permissão adicional, sem a qual a resposta é 403. Além disso, o escopo tecnospeed:read ou tecnospeed:write é derivado do path. Veja Autenticação.

Base path

/api/v1/tecnospeed/central

A URL completa em produção é https://api.contabilidadealcance.com.br/api/v1/tecnospeed/central.

Escopos necessários

  • tecnospeed:read - rotas GET.
  • tecnospeed:write - rotas POST e DELETE.

O escopo é derivado do primeiro segmento depois de /api/v1/ (tecnospeed) e do método HTTP.

Acesso

Todas as rotas exigem login de usuário e permissão adicional. As rotas POST e DELETE são sujeitas a limite de tentativas; ao exceder, 429 com Retry-After.

Envelope de resposta

Respostas de sucesso seguem o envelope { "status": "success", "message": "...", "data": ... }. Exceções: respostas 202 de ações enfileiradas (veja Ações enfileiradas).

Os erros desta central saem em { "detail": ..., "message": ... }: detail é texto nos 404 e 422 e um objeto { "mensagem": "..." } nos 409; message repete o texto.

Ações enfileiradas

Quando a TecnoSpeed não pode atender uma ação na hora, a rota coloca a ação na fila e responde 202 fora do envelope; o resultado chega por notificação ao usuário:

{
  "enfileirado": true,
  "acao_id": "3f6c1c0e-5c6e-4f6e-9a55-0d6f6a2b9e11",
  "mensagem": "A TecnoSpeed está no limite de chamadas agora. A ação foi colocada na fila com prioridade e o resultado chega no sino."
}

Se a fila estiver indisponível, a resposta é 503; se o usuário já tiver o máximo de ações abertas aguardando, 429. Isso vale para POST /contas/{conta_id}/novo-link e para a ação consultar em POST /fila/itens/{tipo_item}/{item_id}/{acao}.

Endpoints

GET /tecnospeed/central/configuracoes

Configurações da busca de extratos (rótulo, descrição, valor em vigor e valor padrão do servidor) e os agendamentos extras de coleta. A edição não é feita aqui: use as rotas de configuração do sistema e de agendamentos, que exigem permissão adicional.

Parâmetros

Este endpoint não recebe parâmetros de rota ou query.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "chaves": [
      {
        "chave": "exemplo_chave",
        "rotulo": "Tamanho da página de consulta",
        "descricao": "Quantidade de itens por página nas consultas.",
        "tipo": "int",
        "valor_efetivo": 50,
        "valor_servidor": 50,
        "origem": "padrao",
        "minimo": 1,
        "maximo": 200,
        "perigosa": false
      }
    ],
    "agendamentos": [
      {
        "id": 3,
        "hora": 12,
        "alvo": "todos",
        "cliente_id": null,
        "empresa": null,
        "ativo": true
      }
    ],
    "pode_editar": false
  }
}

pode_editar é true só para usuários com permissão para editar as configurações.

Escopo: tecnospeed:read. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

GET /tecnospeed/central/contas

Contas Open Finance agrupadas por cliente, com a situação de cada uma na busca e contadores por situação. A paginação é por cliente.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
situacaostrquerynãona_busca, aguardando_consentimento, expirado, revogado, fora_por_escolha ou inelegivel. Omitido = todas.
buscastrquerynãoRazão social ou CNPJ/CPF (com ou sem máscara). Até 100 caracteres.
bancostrquerynãoCódigo do banco com 3 dígitos (ex.: 341).
paginaint >= 1querynãoPágina. Padrão 1.
por_paginaint 1..100querynãoClientes por página. Padrão 25.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "contadores": {
      "na_busca": 41,
      "aguardando_consentimento": 3,
      "expirado": 2,
      "revogado": 0,
      "fora_por_escolha": 1,
      "inelegivel": 0
    },
    "clientes": [
      {
        "cliente_id": 487,
        "empresa": "Empresa Exemplo Ltda",
        "cnpj": "12.345.678/0001-90",
        "exclusao_cliente": null,
        "contas": [
          {
            "conta_id": 7,
            "banco_code": "341",
            "banco_nome": "Itaú",
            "agencia": "1234",
            "conta_mascarada": "****8765",
            "consentimento": "ativo",
            "situacao": "na_busca",
            "situacao_rotulo": "Na busca de extratos",
            "exclusao": null,
            "ultima_busca": {
              "protocolo_id": 9101,
              "criado_em": "2026-10-20T14:32:10",
              "status": "concluido",
              "categoria_falha": null,
              "categoria_rotulo": null
            },
            "carga_inicial": {
              "situacao": "concluida",
              "situacao_rotulo": "Ano coberto",
              "concluida_em": "2026-10-02T14:52:00",
              "falhas": 0,
              "tentativas_maximas": 3,
              "ultimo_protocolo_id": 8800
            }
          }
        ]
      }
    ],
    "total_clientes": 1,
    "pagina": 1,
    "por_pagina": 25,
    "gerado_em": "2026-10-20T09:15:00"
  }
}

exclusao e exclusao_cliente trazem a exclusão em vigor (id, alvo, modo, pausada_ate, motivo, criado_por_nome, criado_em) ou null. carga_inicial só vem nas contas na_busca; situacao da carga: concluida, pendente, em_andamento, aguardando_janela, nao_concluida ou pausada.

Escopo: tecnospeed:read. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/contas/{conta_id}/novo-link

Gera um novo link de consentimento para uma conta com consentimento expirado e o envia por e-mail. A conta volta a pendente com o link novo. O destino é validado antes de qualquer alteração: sem e-mail válido, a conta continua expirado. Se o e-mail não puder ser enviado, a resposta é 200 com email_enviado: false (a conta já está pendente com o link novo).

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
conta_idintpathsimID da conta.

Corpo opcional NovoLinkEntrada (campos desconhecidos dão 422). Sem corpo, usa o e-mail do cadastro do cliente.

CampoTipoObrigatórioDescrição
emailstrnãoE-mail digitado, até 254 caracteres.
contato_idintnãoContato cadastrado do cliente (tem precedência sobre email).

Request

{
  "contato_id": 55
}

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "conta_id": 7,
    "consentimento": "pendente",
    "email_enviado": true,
    "destino_mascarado": "fi***@empresa-exemplo.com.br",
    "mensagem": "Link enviado para fi***@empresa-exemplo.com.br"
  }
}

Erros: 404 conta inexistente ou arquivada; 409 com code: "nao_expirada" se o consentimento não está expirado; 422 destino inválido; 502 falha vinda da TecnoSpeed; 503 integração não configurada. Pode responder 202 (veja Ações enfileiradas).

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/exclusoes

Retira uma conta ou um cliente inteiro da busca de extratos, de forma desligada (até alguém religar) ou pausada até uma data.

Parâmetros

Sem parâmetros de rota ou query. Corpo ExclusaoEntrada (campos desconhecidos dão 422).

CampoTipoObrigatórioDescrição
alvostrsimconta ou cliente.
conta_idintcondicionalObrigatório com alvo: "conta"; proibido com alvo: "cliente".
cliente_idintcondicionalObrigatório com alvo: "cliente"; proibido com alvo: "conta".
modostrsimdesligada ou pausada.
pausada_atedatecondicionalObrigatório com modo: "pausada" (depois de hoje e até 365 dias); proibido com desligada.
motivostrsimDe 5 a 500 caracteres (sem os espaços das pontas).

Request

{
  "alvo": "conta",
  "conta_id": 7,
  "modo": "pausada",
  "pausada_ate": "2026-12-01",
  "motivo": "Cliente trocou de banco, aguardando nova conta"
}

Response 201 Created

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "id": 12,
    "alvo": "conta",
    "modo": "pausada",
    "pausada_ate": "2026-12-01",
    "motivo": "Cliente trocou de banco, aguardando nova conta",
    "criado_por_nome": "Maria Exemplo",
    "criado_em": "2026-10-20T09:20:00",
    "encerrada_em": null
  }
}

Erros: 404 conta ou cliente não encontrado; 409 já existe exclusão ativa para o alvo (detail com mensagem e exclusao_id); 422 validação do corpo ou data fora da faixa permitida.

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/exclusoes/{exclusao_id}/religar

Encerra uma exclusão e devolve o alvo à busca de extratos.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
exclusao_idintpathsimID da exclusão.

Request

Sem corpo de requisição.

Response 200 OK

Envelope com a exclusão (mesmo formato do POST /exclusoes) com encerrada_em preenchido. 404 se a exclusão não existe; 409 se ela já foi encerrada.

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

GET /tecnospeed/central/fila

Panorama da fila de processamento: o que está em execução, o que espera na fila, os protocolos em andamento, a rodada em curso e as ações do Hub enfileiradas. Cada item traz tipo_item, id e acoes_disponiveis, que alimentam POST /fila/itens/{tipo_item}/{item_id}/{acao}.

Parâmetros

Este endpoint não recebe parâmetros de rota ou query.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "gerado_em": "2026-10-20T09:15:00",
    "em_execucao": [
      {
        "tipo": "importacao",
        "descricao": "Importando o extrato do protocolo #9102",
        "tipo_item": "protocolo",
        "id": 9102,
        "protocolo_id": 9102,
        "conta_id": 7,
        "cliente": "Empresa Exemplo Ltda",
        "fase": "baixando",
        "paginas_baixadas": 3,
        "total_paginas": 8,
        "atualizado_em": "2026-10-20T09:14:50",
        "parado": false,
        "acoes_disponiveis": []
      }
    ],
    "na_fila": {
      "total": 1,
      "disponivel": true,
      "itens": [
        {
          "posicao": 1,
          "tarefa": "Importar extrato",
          "descricao": "Importação do protocolo #9103",
          "protocolo_id": 9103,
          "conta_id": null,
          "prioritaria": false,
          "agendado_para": null,
          "tipo_item": "protocolo",
          "id": 9103,
          "acoes_disponiveis": []
        }
      ]
    },
    "protocolos_em_andamento": [
      {
        "tipo_item": "protocolo",
        "id": 9104,
        "protocolo_id": 9104,
        "conta_id": 9,
        "cliente_id": 502,
        "cliente": "Outra Empresa Ltda",
        "conta_mascarada": "****4321",
        "status": "processando",
        "criado_em": "2026-10-20T09:00:00",
        "proxima_consulta_em": "2026-10-20T09:20:00",
        "paginas_guardadas": 0,
        "motivo": null,
        "prioritaria": false,
        "parado": false,
        "acoes_disponiveis": ["priorizar", "consultar"]
      }
    ],
    "rodada": {
      "itens": []
    },
    "acoes_enfileiradas": [
      {
        "tipo_item": "acao",
        "id": "3f6c1c0e-5c6e-4f6e-9a55-0d6f6a2b9e11",
        "acao_id": "3f6c1c0e-5c6e-4f6e-9a55-0d6f6a2b9e11",
        "acao": "Consultar protocolo",
        "descricao": "Consultar protocolo",
        "solicitante": "Maria Exemplo",
        "status": "na_fila",
        "criado_em": "2026-10-20T09:10:00",
        "atualizado_em": "2026-10-20T09:10:00",
        "mensagem": null,
        "cliente_id": 502,
        "conta_id": 9,
        "protocolo_id": 9104,
        "acoes_disponiveis": ["priorizar", "cancelar"]
      }
    ]
  }
}

O panorama traz ainda campos informativos (situação de capacidade de atendimento e totais da rodada aberta); leia campos desconhecidos como opcionais. tipo_item é acao, linha (conta dentro de uma rodada), protocolo ou polling (consulta periódica dos protocolos).

Escopo: tecnospeed:read. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/fila/itens/{tipo_item}/{item_id}/{acao}

Age sobre um item da fila. tipo_item e item_id vêm do GET /fila.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
tipo_itemstrpathsimacao, linha, protocolo ou polling.
item_idstrpathsimID do item (número, ou UUID para acao).
acaostrpathsimcancelar, priorizar, consultar, tentar_de_novo ou liberar_travas.

Só as ações listadas em acoes_disponiveis do item valem; as demais dão 409.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "tipo_item": "protocolo",
    "id": "9104",
    "acao": "priorizar",
    "prioritaria": true
  }
}

Além de tipo_item, id e acao, data traz o novo estado do item (por exemplo status, desfecho, prioritaria, enfileirado ou liberada, conforme a ação). A ação consultar (só para tipo_item: "protocolo") responde como POST .../protocolos/{protocolo_id}/consultar, inclusive os 202. liberar_travas só atua em item parado.

Erros: 404 item inexistente; 409 ação indisponível para o estado do item (detail com mensagem).

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

GET /tecnospeed/central/protocolos

Lista paginada dos protocolos de busca de todos os clientes, com a categoria da falha (quando houver) e as ações possíveis em cada um. Protocolos arquivados ficam fora por padrão; os excluídos nunca aparecem. Sem de e ate, o período é os últimos 7 dias.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
dedatequerynãoInício do período.
atedatequerynãoFim do período. Padrão: hoje.
statusstrquerynãoRepetível: pendente, processando, concluido, falha ou pulado_janela.
categoriastrquerynãoRepetível. Categoria da falha: consentimento, limite_requisicoes, autenticacao, bloqueio_borda, nao_encontrado, dados_invalidos, erro_tecnospeed, comunicacao, tempo_esgotado, sem_retorno_24h, extrato_grande, erro_gravar, configuracao ou nao_classificado.
origemstrquerynãoRepetível: fixa, extra, manual, segunda ou inicial.
bancostrquerynãoCódigo do banco com 3 dígitos.
cliente_idintquerynãoRestringe a um cliente.
buscastrquerynãoTexto livre, até 100 caracteres.
incluir_arquivadosboolquerynãoInclui os arquivados. Padrão false.
paginaint >= 1querynãoPágina. Padrão 1.
por_paginaint 1..100querynãoItens por página. Padrão 25.

de depois de ate retorna 422.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "itens": [
      {
        "id": 9101,
        "conta_id": 7,
        "cliente_id": 487,
        "empresa": "Empresa Exemplo Ltda",
        "banco_code": "341",
        "banco_nome": "Itaú",
        "conta_mascarada": "****8765",
        "origem": "fixa",
        "origem_rotulo": "Rodada fixa",
        "status": "falha",
        "categoria_falha": "consentimento",
        "categoria_rotulo": "Consentimento",
        "status_http": 403,
        "motivo": "Consentimento expirado ou ausente",
        "data_inicio": "2026-10-19",
        "data_fim": "2026-10-19",
        "criado_em": "2026-10-20T14:32:10",
        "concluido_em": "2026-10-20T14:32:13",
        "rodada_id": 301,
        "tentativa_de_id": null,
        "segunda_tentativa_id": null,
        "total_transacoes": null,
        "transacoes_descartadas": 0,
        "arquivado_em": null,
        "pode_arquivar": true,
        "pode_desarquivar": false,
        "pode_excluir": true,
        "pode_cancelar": false
      }
    ],
    "total": 1,
    "pagina": 1,
    "por_pagina": 25
  }
}

Escopo: tecnospeed:read. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/protocolos/{protocolo_id}/arquivar

Tira o protocolo das listagens (use incluir_arquivados=true para vê-lo). Idempotente: protocolo já arquivado devolve 200. Protocolo em andamento dá 409.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
protocolo_idintpathsimID do protocolo.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "id": 9101,
    "status": "falha",
    "arquivado_em": "2026-10-20T09:30:00",
    "excluido": false,
    "pode_arquivar": false,
    "pode_desarquivar": true,
    "pode_excluir": true,
    "pode_cancelar": false
  }
}

Erros: 404 protocolo inexistente ou excluído; 409 protocolo em andamento ("Protocolo em andamento; aguarde o desfecho.").

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/protocolos/{protocolo_id}/desarquivar

Devolve um protocolo arquivado às listagens. Idempotente: protocolo que não está arquivado devolve 200.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
protocolo_idintpathsimID do protocolo.

Request

Sem corpo de requisição.

Response 200 OK

Envelope com o mesmo resumo de POST .../arquivar (arquivado_em: null). 404 se o protocolo não existe ou foi excluído.

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/protocolos/{protocolo_id}/cancelar

Tenta cancelar um protocolo. Um protocolo já gravado já foi pedido à TecnoSpeed, então a resposta é sempre 409 ("Já enviado à TecnoSpeed; não é possível cancelar." ou "Protocolo já finalizado; não há o que cancelar."). Para cancelar uma conta ainda não enviada, use a ação cancelar do item linha ou acao em POST /fila/itens/....

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
protocolo_idintpathsimID do protocolo.

Request

Sem corpo de requisição.

Response 409 Conflict

{
  "detail": {
    "mensagem": "Já enviado à TecnoSpeed; não é possível cancelar."
  },
  "message": "Já enviado à TecnoSpeed; não é possível cancelar."
}

404 se o protocolo não existe ou foi excluído.

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

DELETE /tecnospeed/central/protocolos/{protocolo_id}

Exclui o protocolo (as listagens deixam de mostrá-lo). Só vale para protocolo fora de andamento e sem transações importadas (para esses, use arquivar).

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
protocolo_idintpathsimID do protocolo.

Request

Sem corpo de requisição.

Response 200 OK

Envelope com o resumo do protocolo (mesmo formato de POST .../arquivar), com excluido: true.

Erros: 404 protocolo inexistente ou já excluído; 409 em andamento ("Protocolo em andamento; aguarde o desfecho.") ou com transações importadas ("Protocolo com transações importadas não pode ser excluído; use Arquivar.").

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

GET /tecnospeed/central/rodadas

Lista paginada das rodadas de busca no período, da mais recente para a mais antiga. Sem de e ate, o período é os últimos 7 dias.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
tipostrquerynãoextratos ou consentimento. Omitido = todas.
dedatequerynãoInício do período.
atedatequerynãoFim do período. Padrão: hoje.
paginaint >= 1querynãoPágina. Padrão 1.
por_paginaint 1..100querynãoItens por página. Padrão 25.

de depois de ate retorna 422.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "itens": [
      {
        "id": 301,
        "tipo": "extratos",
        "origem": "fixa",
        "origem_rotulo": "Rodada fixa",
        "agendamento_id": null,
        "dia": "2026-10-20",
        "iniciada_em": "2026-10-20T14:32:10",
        "finalizada_em": "2026-10-20T15:14:20",
        "duracao_s": 2530,
        "interrompida": null,
        "elegiveis": 48,
        "enfileiradas": 48,
        "solicitadas": 46,
        "concluidas": 44,
        "falhas": 2,
        "em_andamento": 0,
        "recuperadas": 1,
        "falhas_por_categoria": [
          { "categoria": "consentimento", "rotulo": "Consentimento", "quantidade": 2 }
        ],
        "puladas": {
          "janela": 1,
          "ja_feita_hoje": 0,
          "sem_periodo": 0,
          "excluida": 1,
          "inelegivel": 0,
          "cancelada": 0,
          "expirada": 0,
          "carga_inicial": 0
        },
        "consentimento": null
      }
    ],
    "total": 1,
    "pagina": 1,
    "por_pagina": 25
  }
}

Nas rodadas de tipo: "consentimento", consentimento traz os contadores selecionadas, consultadas, ativadas, seguem_pendentes e erros; nas de extratos, é null.

Escopo: tecnospeed:read. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

GET /tecnospeed/central/rodadas/{rodada_id}

Detalhe de uma rodada: o resumo dela e a página de contas com o desfecho e o resultado de cada uma.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
rodada_idintpathsimID da rodada.
resultadostrquerynãoRepetível: aguardando, em_andamento, concluido, falha, pulada, ativada, segue_pendente ou erro.
paginaint >= 1querynãoPágina. Padrão 1.
por_paginaint 1..100querynãoItens por página. Padrão 25.

Request

Sem corpo de requisição.

Response 200 OK

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "rodada": {
      "id": 301,
      "tipo": "extratos",
      "origem": "fixa",
      "origem_rotulo": "Rodada fixa",
      "dia": "2026-10-20",
      "iniciada_em": "2026-10-20T14:32:10",
      "finalizada_em": "2026-10-20T15:14:20",
      "elegiveis": 48,
      "concluidas": 44,
      "falhas": 2
    },
    "contas": {
      "itens": [
        {
          "conta_id": 7,
          "cliente_id": 487,
          "empresa": "Empresa Exemplo Ltda",
          "banco_code": "341",
          "banco_nome": "Itaú",
          "conta_mascarada": "****8765",
          "desfecho": "solicitado",
          "desfecho_rotulo": "Solicitada",
          "resultado": "falha",
          "resultado_rotulo": "Falha final",
          "categoria_falha": "consentimento",
          "categoria_rotulo": "Consentimento",
          "motivo": "Consentimento expirado ou ausente",
          "protocolo_id": 9101,
          "segunda_protocolo_id": null,
          "segunda_em": null,
          "proxima_em": null,
          "reprocessado_protocolo_id": null
        }
      ],
      "total": 1,
      "pagina": 1,
      "por_pagina": 25
    }
  }
}

O objeto rodada tem os mesmos campos de um item de GET /rodadas (a amostra acima mostra só alguns).

Escopo: tecnospeed:read. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

POST /tecnospeed/central/rodadas/{rodada_id}/reprocessar-falhas

Reprocessa as contas com falha final de uma rodada de extratos: cada uma vira um novo protocolo manual, com o período do protocolo que falhou. A busca é assíncrona; acompanhe pelo status dos protocolos.

Parâmetros

ParâmetroTipoLocalObrigatórioDescrição
rodada_idintpathsimID da rodada.

Request

Sem corpo de requisição.

Response 202 Accepted

{
  "status": "success",
  "message": "Operação realizada com sucesso",
  "data": {
    "enfileiradas": [
      { "conta_id": 7, "empresa": "Empresa Exemplo Ltda", "conta_mascarada": "****8765" }
    ],
    "barradas": [
      {
        "conta_id": 9,
        "empresa": "Outra Empresa Ltda",
        "conta_mascarada": "****4321",
        "proxima_em": "2026-10-20T15:00:00"
      }
    ],
    "ignoradas": [
      { "conta_id": 11, "motivo": "Já reprocessada" }
    ]
  }
}
  • enfileiradas: contas que entraram no reprocessamento.
  • barradas: contas cuja nova busca só pode ser pedida a partir de proxima_em.
  • ignoradas: contas descartadas, com o motivo: Conta arquivada, Conta fora da rotina por escolha, Sem protocolo para reprocessar ou Já reprocessada.

Erros: 404 rodada inexistente; 409 rodada que não é de extratos ("Só rodadas de busca de extratos podem ser reprocessadas."); 503 fila indisponível.

Escopo: tecnospeed:write. Exige login de usuário (sessão); credenciais de integração recebem 403. Restrita a usuários com permissão adicional; sem ela, a resposta é 403.

Páginas relacionadas