> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Operação diária

> O trabalho diário do operador do JD Courier: motores, o mapa de titularidade, movimentações de contas, mensagens retidas, a parada do canal SPB, envios indeterminados e conciliação.

Esta página é para o operador da sua instituição que opera o Courier. Cada tarefa usa a API do operador que o papel `admin` serve.

## Motores

***

Registre cada motor uma vez, pela [API de motores](/pt/reference/interfaces/jd-courier/register-an-engine). 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](/pt/reference/interfaces/jd-courier/enable-disable-or-rename-an-engine) 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](/pt/reference/interfaces/jd-courier/assign-a-key-to-an-engine) 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](/pt/reference/interfaces/jd-courier/list-ownership-assignments) com o tipo e o valor da chave. Para ler as mudanças de uma chave, use o [histórico de auditoria](/pt/reference/interfaces/jd-courier/ownership-history-for-one-key) dela.

Quando você [remove uma chave](/pt/reference/interfaces/jd-courier/unassign-a-key), 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](/pt/reference/interfaces/jd-courier/move-a-key-to-another-engine) 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](/pt/reference/interfaces/jd-courier/list-retained-messages) todos os dias. Para estes motivos, corrija a causa:

| Motivo | O que fazer |
| - | - |
| `ACCOUNT_UNASSIGNED` | Atribua a chave ao motor dela. No Pix Automático, peça ao motor para reivindicar a recorrência ou declarar a etapa anterior. |
| `DELIVERY_FAILED` | Verifique o motor, o endereço Pix dele e a credencial dele. |
| `UNRECOGNIZED_TYPE` | Para um código que não é de dinheiro, declare um [modo de entrega](/pt/interfaces/jd-courier/jd-courier-routing#delivery-modes) para o código. |
| `OWNERSHIP_DECISION_UNAVAILABLE` | Confirme que o banco de dados do Courier está disponível e que os motores declaram os ISPBs participantes. |

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](/pt/reference/interfaces/jd-courier/run-a-retained-message-s-routing-decision-again) 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.

1. Leia o motivo da parada na [lista de canais](/pt/reference/interfaces/jd-courier/list-the-registered-rails-their-declared-properties-and-their-state).
2. Verifique com a JD se a leitura removeu uma mensagem que o Courier não recebeu.
3. [Levante a parada](/pt/reference/interfaces/jd-courier/lift-a-durable-channel-halt) 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](/pt/reference/interfaces/jd-courier/list-spb-sends) com `open=true`.

Quando você encontra o resultado fora do Courier, por exemplo pelo motor ou pelo suporte da JD, [feche o envio manualmente](/pt/reference/interfaces/jd-courier/close-an-indeterminate-send-by-hand). 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.

O Courier não tem fechamento como `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](/pt/reference/interfaces/jd-courier/reconciliation-report-for-a-rail) 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.

A divergência é a contagem esperada menos as outras três. Uma divergência diferente de zero é uma possível mensagem perdida: investigue-a. O relatório também lista os envios SPB que a JD aceitou e cuja resposta não chegou dentro da janela de retorno. Para rodar um ciclo agora, [dispare um](/pt/reference/interfaces/jd-courier/trigger-a-reconciliation-cycle-for-a-rail). Um trilho que já roda um ciclo responde `409 JDC-0601`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.