ETE033 - Configurar Integração Barramento AF
Como administrador quero ser capaz de configurar a integração com o Barramento Integrado da Assistência Farmacêutica para que seja possível o acesso às bases de dados compartilhadas.
Descrição
O Barramento Integrado da Assistência Farmacêutica (BIAF) detém um conjunto de bases de dados de domínio público de forma a garantir a atualização e o acesso a informações de múltiplas origens num único ponto.
O BIAF garante a atualização das bases locais a partir de uma coleção de dados compartilhados por meio de API, que compreendem CNES, CNPJ e OBM (Até o momento).
Para acessar a API, o administrador precisa fazer um cadastro previamente que lhe garantirá as credenciais necessárias para o acesso ao mesmo.
Elementos de Tela
Tela 1: Incluindo a URL no borramento
| Campo | Sugestão Tipo de Entrada | Descrição | Obrigatório | Observações |
|---|---|---|---|---|
| URL Barramento | Texto |
URL onde o barramento está incluído. | Sim | Só é possível seguir para a próxima etapa caso uma url seja fornecida. |
Tela 2: Cadastro da aplicação no Barramento
| Campo | Sugestão Tipo de Entrada | Descrição | Obrigatório | Observações |
|---|---|---|---|---|
| Tipo de Instância | Dropdown |
Seleciona o tipo da instância: Estadual (E), Municipal (M), Consórcio (C), Entidade/Instituição (I), Federal (F). | Sim | Valores fixos. |
| UF | Dropdown |
Seleciona a Unidade Federativa (UF) associada. | Não | Preenchido a partir da tabela TB_UF. |
| Município | Dropdown |
Seleciona o município associado. | Não | Preenchido com base na tabela TB_MUNICIPIO. |
| Código CNES | Texto |
Insere o código CNES do estabelecimento associado. | Não | Relacionado à tabela TB_CNES. |
| Pessoa Jurídica | Texto |
Insere o código da Pessoa Jurídica associada. | Não | Relacionado à tabela TB_PESSOA_JURIDICA. |
| Nome do Responsável | Texto |
Insere o nome do responsável pela instância. | Sim | Máximo de 120 caracteres. |
Texto (e-mail) |
Insere o endereço de e-mail do responsável. | Sim | Deve ser validado como um e-mail válido. | |
| Telefone | Texto |
Insere o número de telefone do responsável. | Não | Deve conter no máximo 11 dígitos. |
| Data de Inclusão | Texto (somente leitura) |
Exibe a data em que o registro foi incluído. | Não | Preenchido automaticamente pelo sistema. |
| Data de Alteração | Texto (somente leitura) |
Exibe a data em que o registro foi alterado pela última vez. | Não | Preenchido automaticamente pelo sistema. |
| Ativo | Checkbox |
Indica se o registro está ativo (Sim/Não). | Sim | Padrão: Sim. |
Critérios de Aceitação
- Informar a URL do barramento é condição sinequanom para que o usuário possa se cadastrar no barramento.
- A informação da URL deverá ser armazenada com chave "BARRAMENTO_URL" e valor contendo a URL informada.
- Uma chamada ao recurso "alive", deverá ser realizada ao barramento, a aplicação só seguirá para a etapa de cadastro caso o recurso retorne sucesso.
- Ao cadastrar uma instância de aplicação do e-SUS AF no Barramento Integrado da AF, poderão ser selecionados os tipos: Estadual (E), Municipal (M), Consórcio (C), Entidade/Instituição (I), Federal (F).
- Caso o tipo Federal ou Consórcio seja selecionado, será obrigatório informar um UF, Município e CNPJ.
- Caso o tipo Estadual seja selecionado, será obrigatório informar apenas a UF.
- Caso o tipo Municipal seja selecionado, será obrigatório informar apenas a UF e Município.
- Caso o tipo Instituição/Entidade seja selecionado, será obrigatório informar apenas a UF, Município e CNES.
- Os dados de nome, e-mail e telefone deverão ser informados obrigatoriamente.
- Uma vez logrando-se êxito no cadastro, a aplicação deverá retornar mensagem de sucesso ao usuário e deverá armazenar na tb_configuracao o clientId, mantido com a chave "BIAF_CLIENTID" e a APIKEY, criptografada com a chave ECC da aplicação, com a chave "BIAF_APIKEY".
- Em caso de insucesso no cadastro de integração ao Barramento, o e-SUS AF deverá apresentar mensagem de erro informando o motivo retornado no corpo da resposta http.