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/centralA URL completa em produção é https://api.contabilidadealcance.com.br/api/v1/tecnospeed/central.
Escopos necessários
tecnospeed:read- rotasGET.tecnospeed:write- rotasPOSTeDELETE.
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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
situacao | str | query | não | na_busca, aguardando_consentimento, expirado, revogado, fora_por_escolha ou inelegivel. Omitido = todas. |
busca | str | query | não | Razão social ou CNPJ/CPF (com ou sem máscara). Até 100 caracteres. |
banco | str | query | não | Código do banco com 3 dígitos (ex.: 341). |
pagina | int >= 1 | query | não | Página. Padrão 1. |
por_pagina | int 1..100 | query | não | Clientes 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
conta_id | int | path | sim | ID da conta. |
Corpo opcional NovoLinkEntrada (campos desconhecidos dão 422). Sem corpo, usa o e-mail do cadastro do cliente.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
email | str | não | E-mail digitado, até 254 caracteres. |
contato_id | int | não | Contato 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).
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
alvo | str | sim | conta ou cliente. |
conta_id | int | condicional | Obrigatório com alvo: "conta"; proibido com alvo: "cliente". |
cliente_id | int | condicional | Obrigatório com alvo: "cliente"; proibido com alvo: "conta". |
modo | str | sim | desligada ou pausada. |
pausada_ate | date | condicional | Obrigatório com modo: "pausada" (depois de hoje e até 365 dias); proibido com desligada. |
motivo | str | sim | De 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
exclusao_id | int | path | sim | ID 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
tipo_item | str | path | sim | acao, linha, protocolo ou polling. |
item_id | str | path | sim | ID do item (número, ou UUID para acao). |
acao | str | path | sim | cancelar, 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
de | date | query | não | Início do período. |
ate | date | query | não | Fim do período. Padrão: hoje. |
status | str | query | não | Repetível: pendente, processando, concluido, falha ou pulado_janela. |
categoria | str | query | não | Repetí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. |
origem | str | query | não | Repetível: fixa, extra, manual, segunda ou inicial. |
banco | str | query | não | Código do banco com 3 dígitos. |
cliente_id | int | query | não | Restringe a um cliente. |
busca | str | query | não | Texto livre, até 100 caracteres. |
incluir_arquivados | bool | query | não | Inclui os arquivados. Padrão false. |
pagina | int >= 1 | query | não | Página. Padrão 1. |
por_pagina | int 1..100 | query | não | Itens 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
protocolo_id | int | path | sim | ID 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
protocolo_id | int | path | sim | ID 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
protocolo_id | int | path | sim | ID 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
protocolo_id | int | path | sim | ID 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
tipo | str | query | não | extratos ou consentimento. Omitido = todas. |
de | date | query | não | Início do período. |
ate | date | query | não | Fim do período. Padrão: hoje. |
pagina | int >= 1 | query | não | Página. Padrão 1. |
por_pagina | int 1..100 | query | não | Itens 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
rodada_id | int | path | sim | ID da rodada. |
resultado | str | query | não | Repetível: aguardando, em_andamento, concluido, falha, pulada, ativada, segue_pendente ou erro. |
pagina | int >= 1 | query | não | Página. Padrão 1. |
por_pagina | int 1..100 | query | não | Itens 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âmetro | Tipo | Local | Obrigatório | Descrição |
|---|---|---|---|---|
rodada_id | int | path | sim | ID 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 deproxima_em.ignoradas: contas descartadas, com omotivo:Conta arquivada,Conta fora da rotina por escolha,Sem protocolo para reprocessarouJá 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
- Open Finance (TecnoSpeed) - pagador, contas, consentimento, agendamentos e financeiro por cliente.
- Open Finance: Financeiro - detalhe de protocolo e transação, consulta imediata e saldos mensais.