Integração e Processamento — Processamento de remessas em fila

A tela Integração e Processamento define quando as remessas do BlueMind são processadas e como o BlueMind se conecta à API de cada empresa (por exemplo, o Tasy).

Com o processamento por fila ligado, clicar em Processar não executa a remessa na hora: ela entra na fila com status Aguardando e o serviço de API do BlueMind processa automaticamente dentro da janela de horário configurada. Isso tira o volume pesado do horário de pico e evita sobrecarregar o sistema de gestão do hospital durante o expediente.

Quem configura é a equipe de TI do hospital, em Configurações. A configuração vale para a instituição (tenant) inteira.

1. Antes de começar

• Ter acesso a Configurações e ao módulo Integração e Processamento no perfil de acesso.
• Ter os dados de acesso da API de cada empresa (endpoint, usuário e senha/segredo) fornecidos pela equipe responsável pelo sistema integrado.
• O serviço de API do BlueMind precisa estar com o job de fila habilitado no servidor. Se a fila estiver ligada na tela e nada for processado, acione o suporte Kentech.

2. Abrir a tela

1. No menu do usuário (canto superior direito), clique em Configurações.
2. Clique em Integração e Processamento.

A tela tem dois blocos: Processamento em Fila e Integração API por Empresa.

Se aparecer o aviso Nenhuma configuração personalizada encontrada. Os valores exibidos são os padrões do appsettings até que você salve alterações., a instituição ainda está usando o padrão da instalação. Ao salvar pela primeira vez, a configuração passa a ser própria da instituição.

3. Como funciona o processamento por fila

1. O usuário abre Pendências e clica em Processar na remessa.
2. Com a fila ligada, a remessa muda para o status Aguardando e aparece a mensagem: Remessa (cód. N) inserida na fila de processamento. O processamento ocorrerá por fila no horário configurado: …
3. O serviço de API do BlueMind verifica a fila em intervalos regulares. Quando a hora atual está dentro da janela da instituição, ele pega as remessas Aguardando e faz a validação e o envio pela API da empresa.
4. Ao terminar, a remessa segue o fluxo normal (por exemplo Processada). A grade de Pendências se atualiza sozinha enquanto houver remessas em transição.

Passando o mouse sobre o status Aguardando, o tooltip mostra: Processamento por fila. Execução prevista no horário: …

Com a fila desligada, o Processar valida a API e processa a remessa na hora, como antes.

4. Configurar o Processamento em Fila

Intervalos que cruzam a meia-noite são suportados. Exemplo: 22 até 6 processa das 22h às 6h59 do dia seguinte. Para processar o dia inteiro, use 0 até 24.

1. Marque Processamento por fila.
2. Informe a Hora inicial e a Hora final.
3. Clique em Salvar. A mensagem Configuração de fila salva com sucesso! confirma a gravação.

Voltar retorna a Configurações sem salvar.

5. Configurar a Integração API por Empresa

A grade lista as empresas da instituição com as colunas Id., Empresa, Endpoint API, Tipo API, Usuário API e Senha API. A senha nunca é exibida: aparece como ********. Se não houver empresas, a mensagem é Não há empresas cadastradas.

1. Clique no ícone de lápis na linha da empresa.
2. No modal Integração API – [Empresa], preencha os campos abaixo.
3. Clique em Salvar. A mensagem Integração API salva com sucesso! confirma. Cancelar fecha sem gravar.

Tipos de API

As remessas processadas pela fila usam a integração da empresa configurada aqui. Se os dados estiverem errados, a remessa não é validada na API quando a janela chegar.

6. Conferir o resultado

1. Com a fila ligada, processe uma remessa de teste em Pendências e confirme o status Aguardando e a mensagem com o horário configurado.
2. Depois do início da janela, volte a Pendências e confirme que a remessa saiu de Aguardando.
3. Se precisar processar na hora, desligue a fila, salve e processe a remessa novamente — ou ajuste a janela para incluir o horário atual.

7. Dúvidas frequentes

• A remessa está parada em Aguardando. Confira se a hora atual está dentro da janela configurada. Fora da janela, ela espera o próximo início. Se a janela já passou e nada mudou, acione o suporte Kentech para verificar o serviço de API.
• Cliquei em Processar de novo e apareceu “não é possível processar remessa … aguardando processamento”. É esperado: a remessa já está na fila. Remessas Processadas, Apagadas, Aguardando, Em processamento ou em preparação de análise também não podem ser processadas novamente.
• Várias remessas na fila são processadas aos poucos. O serviço processa uma quantidade limitada de remessas por ciclo para não sobrecarregar a integração. Em janelas curtas, parte da fila pode ficar para o dia seguinte.
• Apareceu o aviso de “padrões do appsettings”. A instituição ainda não salvou configuração própria. Ajuste os campos e clique em Salvar.
• Mudar a configuração afeta outras instituições? Não. Cada instituição (tenant) tem a sua fila e a sua janela.
• Onde vejo a senha da API? Não é exibida. Para trocar, abra o lápis da empresa e informe a nova senha/segredo.

8. Relacionados

• Controle de Acesso — Layout por Perfil
• Cadastrando / administrando Perfis de Acesso