admin serve.
Motores
Registre cada motor uma vez, pela API de motores. Um motor tem um ID, um nome de exibição, os ISPBs participantes e, para o Pix, o endereço em que recebe as chamadas Pix. Não existe exclusão. Para parar um motor, desabilite-o com um motivo. Um motor desabilitado não recebe novas entregas nem novas chaves. Ele mantém as chaves de que é dono, então as novas mensagens dessas chaves ficam retidas até você habilitar o motor de novo ou mover as chaves.
O mapa de titularidade
Atribua cada conta ao seu motor antes de o Courier receber mensagens para ela. Uma mensagem para uma conta sem dono fica retida. No Pix Automático, atribua também o CNPJ de cada cobrador que a sua instituição atende. Cada motor reivindica as próprias recorrências. Para encontrar o dono de uma chave, liste as atribuições com o tipo e o valor da chave. Para ler as mudanças de uma chave, use o histórico de auditoria dela. Quando você remove uma chave, as mensagens dessa chave ficam retidas. O Courier não as credita e não as devolve ao BACEN.
Mover contas entre motores
Uma onda de migração move contas de um motor para outro. Mova cada chave com um motivo. O Courier registra o dono anterior e o motivo no histórico de auditoria. Depois da movimentação, a próxima consulta responde o novo dono. Algumas mensagens não seguem a movimentação:
- No SPB, a resposta a um envio vai para o motor que fez o envio.
- No Pix, uma mensagem que uma tentativa anterior enviou ao dono anterior fica retida. O Courier não a envia ao novo dono.
- No Pix Automático, um débito, o estorno dele e um status de cancelamento do agendamento ficam com o motor que tem o bloqueio ou o agendamento.
Mensagens retidas
Verifique as mensagens retidas todos os dias. Para estes motivos, corrija a causa:
Quando a causa deixa de existir, a mensagem sai por conta própria na próxima verificação. Para verificá-la primeiro, peça uma reavaliação com um motivo. Você não escolhe o motor: as regras de roteamento o escolhem.
Parada do canal SPB
O papel
spb-consumer para o canal SPB quando uma leitura da JD pode ter removido uma mensagem que o Courier não recebeu. Por exemplo, a JD responde com um status 5xx diferente de 503, ou a leitura dá timeout depois de a requisição sair. A parada interrompe as mensagens SPB de entrada para cada motor.
Enquanto o canal está parado, o Courier não lê da JD, não roteia e não verifica de novo as mensagens SPB retidas. Um reinício não levanta a parada.
- Leia o motivo da parada na lista de canais.
- Verifique com a JD se a leitura removeu uma mensagem que o Courier não recebeu.
- Levante a parada com uma nota de 10 a 500 caracteres sobre o que você verificou.
Envios indeterminados
Um envio indeterminado é um envio SPB que saiu do Courier sem um veredito da JD. Uma consulta do motor com
ConsultaNumCtrlIF pode resolvê-lo. Para ver os envios que continuam abertos, liste o registro de envios com open=true.
Quando você encontra o resultado fora do Courier, por exemplo pelo motor ou pelo suporte da JD, feche o envio manualmente. Informe uma referência à evidência e uma nota.
O fechamento é apenas um registro:
- O resultado continua
INDETERMINATE. - O número de controle continua bloqueado para um novo envio.
- Uma consulta posterior do motor ainda vai para a JD.
- O envio não conta mais como um envio aberto.
NOT_SENT. Se um operador errasse sobre um envio que “nunca saiu”, um segundo envio do mesmo número de controle poderia chegar ao BACEN.
Conciliação
O papel
admin roda um ciclo de conciliação para cada trilho a cada minuto. Um ciclo verifica uma janela de tempo passada. O relatório de conciliação mostra estas contagens:
- Esperadas: os resultados que as mensagens da janela esperam.
- Concluídas: as entregas aos motores, para cada motor.
- Retidas: as mensagens que continuam retidas.
- Recusadas: as mensagens recusadas por um modo de entrega.
409 JDC-0601.