ETE042 - Transmitir dados SI Bnafar

Histórico de Revisões

História de Usuário

Como usuário quero que o sistema envie os dados de saída e posição de estoque para o SI Bnafar, e consulte o processamento e as inconsistências no serviço federal.

Critérios de Aceitação

1. As configurações de credenciais e transmissão de dados para o SI Bnafar será realizada a nível estadual, e será aplicada para todos os entes vinculados a instância estadual. #RGN001.
2. A transmissão deve ocorrer conforme a configuração do SI Bnafar para a instância. #RGN072.
3. A persistência dos dados para auditoria deve ocorrer somente no caso do campo “Tempo guarda envios (dias)” da ESPECIFICAÇÃO TÉCNICA 041: Configurar transmissão SI Bnafar estar preenchido com “Sim”. Somente deverão ser auditados as requisições referentes ao envio de dados (consultas não serão incluídas).
4. Para realizar a auditoria dos envios, o sistema deve persistir a requisição e resposta completa realizada para o SI Bnafar:
   • Para requisições com status 2xx, 4xx ou 5xx: Deverá ser persistido o header, body, URL, método, status HTTP, timestamp envio, timestamp resposta. Para status 2xx também deverá ser persistido o número de protocolo relativo ao envio.
   • Para os casos de insucesso devido a problemas de conexão (ex: API indisponível ou timeout): Deverá ser persistido somente os dados da requisição (header, body, URL, método, timestamp envio), e o motivo do erro. Se o motivo for timeout do serviço, deverá ser persistido o valor do timeout utilizado na transmissão.
5. O sistema deve possuir uma rotina para excluir os registros de auditoria com o tempo maior de persistência do que especificado no “Auditar transmissões” -> “Dias” no #ESPECIFICAÇÃO TÉCNICA 041: Configurar transmissão SI Bnafar. Exclusão deverá ser física. #RGN070.
6. A relação dos itens a serem transmitidos devem obedecer a configuração da integração. #RGN069.
7. O sistema deverá transmitir os dados de saída e posição de estoque para o SI Bnafar. As saídas do tipo “Saída por Estorno de Entrada” e “Saída por Dispensação” não deverão ser transmitidas. #RGN073.
8. Se o campo “Configurações Avançadas” da #ETE041 estiver preenchido com “Sim”, deverão ser observados os campos “Limite registros por lote” e “Timeout (ms)” para realizar as transmissões. Se o campo estiver preenchido com “Não”, deverá ser utilizado o timeout de 45000 ms e o limite de 1000 registros por lote.
9. Municípios informados como excluídos na #ETE041 não deverão ter os seus dados de saída e estoque transmitidos para o SI Bnafar, para a referida instância e UF. #RGN071.
10. A transmissão para o SI Bnafar deverá ser realizada diariamente, a partir da 00h. A nível federal, cada UF terá uma rotina própria para envio e consulta dos dados.
11. Os envios devem iniciar com os dados da posição de estoque e posteriormente com as saídas.
12. Deverão ser utilizados os endpoints de envio em lote do SI Bnafar para realizar a transmissão das saídas e posição de estoque. Os lotes devem conter os dados de apenas um munícipio e de uma data, para que se tenha maior controle posterior.
13. Os envios e consultas ao SI Bnafar deverão seguir a documentação e o padrão do serviço, disponível no site do Ministério da Saúde (https://servicos-datasus.saude.gov.br/detalhe/DxRPsAn2mh)
14. Para o envio dos dados de saída deverão ser contabilizadas as saídas que foram registradas no dia anterior (00:00:00 até as 23:59:59), bem como as saídas dos dias anteriores que ainda não foram enviadas. #RGN074.
15. Para o envio dos dados de posição de estoque, deverá ser considerado a posição de estoque da meia-noite (início da rotina de transmissão), bem como as posições de estoque dos dias anteriores que não tiveram sucesso no envio. RGN xx8. #RGN075.

16. Sistema deverá possuir tabelas próprias para controlar as transmissões para o SI Bnafar. Essas tabelas deverão persistir:

    • Vínculo do sistema com os parâmetros retornados do SI Bnafar (protocolo e código do registro*):
      • Entre os IDs da saída;
      • Entre a data da posição de estoque.
    • Status de processamento do SI Bnafar;
    • Inconsistências geradas;
    • Auditoria das requisições;
    • Tentativas de transmissão.

    Importante

    • O protocolo é gerado no momento da transmissão para o SI Bnafar.
    • O código do registro é retornado pelo serviço na consulta do processamento do lote. Ele é gerado apenas caso o protocolo tenha sido processado, e o registro não contenha inconsistência.

17. As saídas com registro de estorno não deverão ser transmitidas para o SI Bnafar. #RGN076.

18. Caso uma saída seja estornada no sistema após o envio do registro para o SI Bnafar, o sistema deverá identificar o protocolo e código do registro relativo a saída e transmitir a exclusão desse registro para o SI Bnafar. Isso somente deve ocorrer caso o estorno ocorra até o último dia do mês subsequente da saída (ex: saída realizada em 05/11 somente poderá ser excluída no SI Bnafar até 31/12). #RGN077.
19. Caso um lote de posição de estoque tenha problema de transmissão em sua primeira tentativa, o sistema deverá gravar o mesmo em banco de dados para o envio posterior. Isso é necessário para que não seja calculado a posição de estoque retroativa para cada tentativa de reenvio. Após o sucesso no envio, o lote poderá ser excluído do banco.
20. Caso ocorra algum erro na transmissão por (ex: 5xx, timeout ou indisponibilidade do serviço), o sistema deve tentar realizar três reenvios em tempo de execução. Caso a transmissão não ocorra, novas tentativas posteriores serão realizadas (rotina segregada).
21. Além da transmissão dos dados, o sistema deverá possuir outra rotina com horários distintos para consultar o processamento e as inconsistências dos registros.
22. Para cada envio realizado o sistema deverá consultar o processamento do mesmo, utilizando o número do protocolo. A consulta do processamento deve ocorrer somente para os protocolos que não tiveram o seu processamento finalizado pelo SI Bnafar. Para cada protocolo o sistema deverá manter o status de processamento atualizado.
23. Para os protocolos que foram processados e que apresentaram inconsistências, o sistema deverá consultar as inconsistências e salvar em banco o código, mensagem, campo com erro e valor informado. O sistema deverá persistir as inconsistências vinculadas aos registros de origem no sistema.
24. A consulta das inconsistências deve ocorrer logo após a consulta do status de processamento do protocolo. A consulta da inconsistência deve ocorrer apenas para os protocolos com status “4” (processamento finalizado, com ao menos um registro inconsistente) no SI Bnafar.
25. O sistema deverá persistir para cada registro o número de tentativas de envio.
26. Além das rotinas de envio, o sistema deverá possuir os seguintes agendamentos:
    • Consultar processamento e inconsistência: 8h e 15h.
    • Retentiva envio de itens com erro: 11h e 20h.
27. Para gerar a autenticação no SI Bnafar devem ser utilizadas as credenciais informadas nos campos “Usuário” e “Senha” da #ETE041.
28. Para o envio da posição de estoque:
    • Transmissão deve abranger todos os lotes e localizações físicas por unidade de saúde (deve ser obedecido esse grão e os dados não devem ser consolidados);
    • Itens com valores zerados no estoque não deverão ser transmitidos;
    • Estoque de produtos vencidos deverão ser transmitidos.
29. Deve ser realizado um de/para entre os tipos de saída do sistema com as opções disponíveis no SI Bnafar, conforme abaixo:

Elementos de Tela

Não se aplica.

Protótipo

Não se aplica.

Modelo de Dados

Conjunto de dados 1: Dados de envio SI BNAFAR

Conjunto de dados 2: Auditoria de envios SI BNAFAR

Conjunto de dados 3: Registro de retorno de consultas

Domínio Status protocolo de processamento