Mudanças entre as edições de "Interfaceamento Solução"

Edição atual tal como às 11h28min de 27 de julho de 2020

Índice

1 Contato no Laboratório Solução
2 Pré-requisitos
3 Configurações no Unilab
- 3.1 Etiqueta de MTBI
4 OBS: TAMANHO DA ETIQUETA WEB SERVICE SOLUÇÃO: 50mm X 25mm.
5 Interfaceamento via web service
6 Possíveis erros
7 Tratamento de arquivos

Contato no Laboratório Solução

Jean Sorbara

jean.sorbara@solucaolab.com.br

(47)3248-2880
(47)9934-0017
http://www.solucaolab.com.br

Pré-requisitos

O interfaceamento será liberado no Unilab pela Uniware mediante pagamento.
O laboratório apoiado deve ter negociado com o Solução quais exames serão interfaceados e seus valores.(Se o Solução não ativar o web service apresenta o erro - ERRO NA COMUNICAÇÃO COM WEB SERVICE DO SOLUÇÃO ERRO RETORNADO PELA COMUNICAÇÃO: NÃO HÁ VALOR PADRÃO CONFIGURADO NA INTEGRAÇÃO X SERVIÇO SOLICITANTE)
Solicitar ao Solução seu código.
Solicitar ao Solução o arquivo de exames.

Configurações no Unilab

Etiqueta de MTBI

O Apoiado vai usar mesmo o contador de número de amostra do unilab, imprimir etiqueta do Unilab e quando enviar o arquivo de solicitação de exames para o apoio, o site do apoio irá emitir as etiquetas deles para reetiquetar as amostras.

O Agrupamento de amostra será feito manualmente, quando existir, utilizando o campo agrupamento do exame.

OBS: TAMANHO DA ETIQUETA WEB SERVICE SOLUÇÃO: 50mm X 25mm.

Cadastro do laboratório

Em cadastros > Laboratórios, incluir um novo laboratório ou alterar o cadastro do Solução se já existir, configurando os seguintes parâmetros:

Interfaceado: SIM
Padrão de Interface: Lab. Solução
Código no Lab. Apoio: Informar o seu código no Solução. (fornecido pelo Solução)

Para maior segurança o apoiado pode usar a opção “Liberar resultados importados pela interface.” Desmarcando-a os exames serão importados do Solução com status de digitado ficando sob a responsabilidade do apoiado conferir e liberar os resultados.
Ao confirmar o cadastro será necessário solicitar à Uniware a chave de liberação do interfaceamento, que será liberada pelo financeiro da Uniware mediante pagamento.

Cadastro de exames

Em cadastros > exames > exames, selecionar o exame que se quer interfacear e alterá-lo, ou se o exame não está cadastrado, cadastrá-lo.

No campo Laboratório de apoio, informar o laboratório Solução.

No cadastro de exames, nos campos “Cód. Exam. (F2)” - com F2, selecionar o exame no Solução, ele já vai preencher automaticamente os campos "Mat. Padrão" e "DT. Vigência" .

Estes códigos obrigatoriamente deverão ser códigos constantes no arquivo de modelo de exames que foi importado.

Quando são informados o mnemônico do exame, o Mat. Padrão e “Sim” no campo “Int. Ativo”, então, o exame ficará marcado como ativado no dia de hoje e por segurança, só serão incluídos em lotes de interfaceamento os exames que forem incluídos em um pedido um dia depois do dia em que o interfaceamento do exame foi ativado.

O Laboratório Solução NÃO executa exames configurados como amostra adicional. Caso seja necessário deverá ser configurado um exame para cada amostra.

No Solução não é aceito um exame repetido em um mesmo pedido.

Na aba configuração

Os exames devem ser configurados conforme a configuração do exame no Solução. O botão “Lista de Variáveis (F3)” pode ser utilizado para auxiliar a configuração.

Interfaceamento Manual

Envio

Depois de tudo configurado, e os pedidos com exames para interfacear cadastrados, o lote de exames para envio ao Solução deve ser gerado em Movimentação > Interfaceamento > Laboratório. Selecione o Lab. Solução e clique em incluir, desmarque os exames que não deseja enviar, confirme e depois clique em “Gerar Arq.”

Observações:

O arquivo só poderá ser gerado se a interface estiver autorizada pela uniware.

As informações que são enviadas para o Solução no arquivo de envio são:

Código do laboratório no apoio
Numero do lote
Data e hora da geração do lote
Número do pedido no Unilab.
Observação do pedido e Observação do Paciente
Dados do paciente: Código, Nome, sexo, data de nascimento, peso, altura, data da ultima menstruação
Mnemônico do exame no Solução, código do material biológico e data e hora da coleta

Retorno

Com o arquivo em mãos, em Movimentação > Interfaceamento > Laboratório. Selecione o Lab. Solução e clique em “Resultado”, selecionar o arquivo de retorno e clicar em OK.

Na importação do retorno do Solução várias verificações são feitas para garantir a integridade do resultado importado pela interface. Se algum resultado enviado pelo Solução tem alguma divergência com as informações configuradas no Unilab, o resultado divergente não é importado e a causa é relatada no final da importação.

Interfaceamento via web service

Configuração

Para configurar o web service do Solução, basta seguir os mesmos passos para os outros laboratórios

Cadastros > Laboratorios
E entao preencher os dados conforme a imagem:

Cadastro de laboratório

Código no Lab. Apoio
- Código do usuário no Solução
Chave
- Senha do usuário no Solução
URL WS
- URL utilizado no web service

Etiquetas no Envio via webservice

É necessário configurar um modelo de etiqueta em branco com o mesmo tamanho da etiqueta que está na etiquetadora.

Defini-la como padrão para o Solução em Cadastros > Configurações > Etiqueta MTBI

Se o modelo do Solução não constar na listagem, alterar o laboratório e marcar a opção "Utiliza etiqueta específica".

Envio via Web Service:

O envio do pedido via web service acontece ao incluir pedido com data de coleta, alterar um pedido com exames pendentes do apoio e coletá-los ou realizar uma coleta através da coleta informatizada.
- Coleta: Ao coletar um exame, apenas os coletados serão enviados para o web service
- Pedido: Ao confirmar um pedido, aparecerá um texto na tela dizendo que a comunicação com o web service está sendo realizada. Caso ocorra qualquer erro retornado pelo web service, aparecerá na tela.
  - Se o exame exigir preenchimento de informação adicional, será solicitado ao confirmar o pedido
Um exame pode ser recoletado depois de já ter sido enviado via web service, porém exames recoletados não são reenviados e também não entram em lotes, para esses casos, é preciso que o cliente realize os ajustes manualmente direto no sistema do apoio, consequentemente, a digitação dos resultados destes exames também deverá ser manual.

Inclusão de pedido

Após enviar o exame, a impressão de suas devidas etiquetas ja estarâo disponíveis na tela de impressão de etiquetas
- Lembrando que as etiquetas impressas serão as que o próprio Solução disponibiliza via web service, não sendo configuráveis

Retorno via Web Service:

O retorno dos resultados via web service acontece no menu: Movimentação > Interfaceamento > Laboratório de Apoio.
A janela de retorno pode ser aberta selecionando o laboratório do Solução e clicando no botão "Resultados"
Na tela será exibida 3 formas de importação de resultados:
- Pedido: Será importados todos os resultados disponíveis para o pedido selecionado
- Período de envio para o Solução: Será importados todos os resultados de qualquer pedido disponível no período selecionado.
  - O período é referente à data que os exames foram enviados ao Solução via web service
- Importação manual: Importação padrão via arquivo, como é relizado sem web service

Retorno de resultados Solução via web service

Relatório

Para saber o status dos exames enviados para o Solução, é necessário ir no menu: Relatórios > Interfaces > Solução web service

Filtros do relatório

Relatório impresso

Possíveis erros

Erros gerados no cadastro do pedido

Verifique se as configurações do laboratório e exame estão corretas.
- URL WS no cadastro do laboratório de apoio, incorreta.

Erro retornado pela comunicação: Pedido de retorno divergente do pedido de envio.
Não foi possível processar o Pedido/Atendimento recebido da Integração: HSF. Serviço Solicitante: 1411.
Erro: Falha no login: Serviço solicitante não localizado com o código '1411'
- Usuário e/ou Senha (Chave) inválido no cadastro do laboratório de apoio.
Erro: Não há valor padrão configurado na Integração x Serviço Solicitante (Integração 'HSF', Serviço Solicitante '141', Entidade 'TipoRegistroExterno')
- Erro de configuração no solução.
Erro: Não foi possível processar os Pedidos recebidos da Integração: HSF. Serviço Solicitante: 141. Erro: Foi forçado o cancelamento de uma conexão existente pelo host remoto
- Houve queda do webservice ou de conexão.

Tratamento de arquivos

1 - Abra o arquivo com bloco de notas.

2 - Dê um Ctrl + F para abrir a opção de localizar e substituir.

3 - Execute o comando para substituir as seguintes tags: <Exame> por <EXAME> e </Exame> por </EXAME>

4 - Pronto!

@@ Linha 1: / Linha 1: @@
+[[Categoria:Unilab]]
 ==Contato no Laboratório Solução==
 '''Jean Sorbara'''<br>
   jean.sorbara@solucaolab.com.br
-(47)3248-2880
+(47)3248-2880 <br>
-(47)9934-0017
+(47)9934-0017 <br>
 http://www.solucaolab.com.br
 == Pré-requisitos ==
 *O interfaceamento será liberado no Unilab pela Uniware mediante pagamento.
-*O laboratório apoiado deve ter negociado com o Solução quais exames serão interfaceados e seus valores.
+*O laboratório apoiado deve ter negociado com o Solução quais exames serão interfaceados e seus valores.(''Se o Solução não ativar  o web service apresenta o erro -''  '''ERRO NA COMUNICAÇÃO COM WEB SERVICE DO SOLUÇÃO ERRO RETORNADO PELA COMUNICAÇÃO: NÃO HÁ VALOR PADRÃO CONFIGURADO NA INTEGRAÇÃO X SERVIÇO SOLICITANTE''')
-*Solicitar ao Solução seu código no Solução.
+*Solicitar ao Solução seu código.
 *Solicitar ao Solução o arquivo de exames.
 ==Configurações no Unilab==
 ===Etiqueta de MTBI===
-O Apoiado vai usar mesmo contador de número de amostra do unilab, imprimir etiqueta do Unilab e quando enviar arquivo de solicitação de exames para apoio, o site do apoio vai emitir etiquetas deles para reetiquetar as amostras.
+O Apoiado vai usar mesmo o contador de número de amostra do unilab, imprimir etiqueta do Unilab e quando enviar o arquivo de solicitação de exames para o apoio, o site do apoio irá emitir as etiquetas deles para reetiquetar as amostras.
-O Agrupamento de amostra será feito manualmente quando existir utilizando o campo agrupamento do exame.
+O Agrupamento de amostra será feito manualmente, quando existir, utilizando o campo agrupamento do exame.
+== '''OBS: TAMANHO DA ETIQUETA WEB SERVICE SOLUÇÃO: 50mm X 25mm.''' ==
 ===Cadastro do laboratório===
@@ Linha 22: / Linha 25: @@
 *Interfaceado: SIM
 *Padrão de Interface: Lab. Solução
-*Código no Lab. Apoio: Informar o seu código no Reação. (fornecido pelo Reação)
+*Código no Lab. Apoio: Informar o seu código no Solução. (fornecido pelo Solução)
-*Convênio: Informar o convênio do apoiado no Reação.(fornecido pelo Reação)
-*Para maior segurança o apoiado pode usar a opção “Liberar resultados importados pela interface.” Desmarcando-a os exames serão importados do Reação com status de digitado ficando sob a responsabilidade do apoiado conferir e liberar os resultados.
+*Para maior segurança o apoiado pode usar a opção “Liberar resultados importados pela interface.” Desmarcando-a os exames serão importados do Solução com status de digitado ficando sob a responsabilidade do apoiado conferir e liberar os resultados.
 *Ao confirmar o cadastro será necessário solicitar à Uniware a chave de liberação do interfaceamento, que será liberada pelo financeiro da Uniware mediante pagamento.
@@ Linha 31: / Linha 34: @@
 Em cadastros > exames > exames, selecionar o exame que se quer interfacear e alterá-lo, ou se o exame não está cadastrado, cadastrá-lo.
-No campo Laboratório de apoio, informar o laboratório Reação.
+No campo Laboratório de apoio, informar o laboratório Solução.
-No cadastro de exames, nos campos “Cód. Exam. (F2)” - com F2, selecionar o exame no reação, ele já vai preencher automaticamente os campos "Mat. Padrão", "vigência" e "agrupamento de amostra".
+No cadastro de exames, nos campos “Cód. Exam. (F2)” - com F2, selecionar o exame no Solução, ele já vai preencher automaticamente os campos "Mat. Padrão" e "DT. Vigência" .
 Estes códigos obrigatoriamente deverão ser códigos constantes no arquivo de modelo de exames que foi importado.
@@ Linha 39: / Linha 42: @@
 Quando são informados o mnemônico do exame, o Mat. Padrão e “Sim” no campo “Int. Ativo”, então, o exame ficará marcado como ativado no dia de hoje e por segurança, só serão incluídos em lotes de interfaceamento os exames que forem incluídos em um pedido um dia depois do dia em que o interfaceamento do exame foi ativado.
-O Laboratório Reação NÃO executa exames configurados como amostra adicional. Caso seja necessário deverá ser configurado um exame para cada amostra.
+O Laboratório Solução NÃO executa exames configurados como amostra adicional. Caso seja necessário deverá ser configurado um exame para cada amostra.
-No Reação não é aceito um exame repetido em um mesmo pedido.
+No Solução não é aceito um exame repetido em um mesmo pedido.
-===Na aba configuração:===
+===Na aba configuração===
-Os exames devem ser configurados conforme a configuração do exame no Reação. O botão “Lista de Variáveis (F3)” pode ser utilizado para auxiliar a configuração.
+Os exames devem ser configurados conforme a configuração do exame no Solução. O botão “Lista de Variáveis (F3)” pode ser utilizado para auxiliar a configuração.
-===Interfaceamento===
+===Interfaceamento Manual===
 ====Envio====
-Depois de tudo configurado, e os pedidos com exames para interfacear cadastrados, o lote de exames para envio ao Reação deve ser gerado em Movimentação > Interfaceamento > Laboratório. Selecione o Lab. Reação e clique em incluir, desmarque os exames que não deseja enviar, confirme e depois clique em “Gerar Arq.”
+Depois de tudo configurado, e os pedidos com exames para interfacear cadastrados, o lote de exames para envio ao Solução deve ser gerado em Movimentação > Interfaceamento > Laboratório. Selecione o Lab. Solução e clique em incluir, desmarque os exames que não deseja enviar, confirme e depois clique em “Gerar Arq.”
 Observações:
 *O arquivo só poderá ser gerado se a interface estiver autorizada pela uniware.
-As informações que são enviadas para o Reação no arquivo de envio são:
+As informações que são enviadas para o Solução no arquivo de envio são:
 *Código do laboratório no apoio
-*Código do convênio no apoio
 *Numero do lote
-*Data da geração do lote
+*Data e hora da geração do lote
 *Número do pedido no Unilab.
-*Data do pedido
+*Observação do pedido e Observação do Paciente
-*Observação do pedido e Observação Técnica
+*Dados do paciente: Código, Nome, sexo, data de nascimento, peso, altura, data da ultima menstruação
-*Dados do paciente: Código, Nome, sexo, idade, data de nascimento
+*Mnemônico do exame no Solução, código do material biológico e data e hora da coleta
-*Dados do médico solicitante: Código, CRC, Nome
-*Mnemônico do exame no Reação, código do e nome do material biológico e número da amostra
-No site http://www.laboratorioreacao.com.br/ clique em “Requisições de exames”  utilize-se de seu login e senha fornecidos pelo Reação para acessar a área. Posteriormente clique em importar requisições>escolher arquivo selecionando o arquivo gerado pelo Unilab e clique em “Importar”.
+====Retorno====
+Com o arquivo em mãos, em Movimentação > Interfaceamento > Laboratório. Selecione o Lab. Solução e clique em  “Resultado”, selecionar o arquivo de retorno e clicar em OK.
-====Retorno====
+Na importação do retorno do Solução várias verificações são feitas para garantir a integridade do resultado importado pela interface. Se algum resultado enviado pelo Solução tem alguma divergência com as informações configuradas no Unilab, o resultado divergente não é importado e a causa é relatada no final da importação.
-No site http://www.laboratorioreacao.com.br/ clique em “Requisições de exames” clique em “Arquivos de resultados” ali se encontra os arquivos de resultados fornecidos pelo apoio clique sobre o arquivo desejado iniciando assim o download do arquivo.
+== Interfaceamento via web service ==
+=== Configuração ===
+Para configurar o web service do Solução, basta seguir os mesmos passos para os outros laboratórios
+* Cadastros > Laboratorios
+* E entao preencher os dados conforme a imagem:
+[[Arquivo:LaboCadSolucao.jpg|centro|miniaturadaimagem|700x700px|Cadastro de laboratório]]
+* Código no Lab. Apoio
+** Código do usuário no Solução
+* Chave
+** Senha do usuário no Solução
+* URL WS
+** URL utilizado no web service
+=== '''Etiquetas no Envio via webservice''' ===
+* É necessário configurar um modelo de etiqueta em branco com o mesmo tamanho da etiqueta que está na etiquetadora.
+* Defini-la como padrão para o Solução em '''Cadastros > Configurações > Etiqueta MTBI'''
+* Se o modelo do Solução não constar na listagem, alterar o laboratório e marcar a opção "Utiliza etiqueta específica".
+=== '''Envio via Web Service:''' ===
+*O envio do pedido via web service acontece ao incluir pedido com data de coleta, alterar um pedido com exames pendentes do apoio e coletá-los ou realizar uma coleta através da coleta informatizada.
+**Coleta: Ao coletar um exame, apenas os coletados serão enviados para o web service
+**Pedido: Ao confirmar um pedido, aparecerá um texto na tela dizendo que a comunicação com o web service está sendo realizada. Caso ocorra qualquer erro retornado pelo web service, aparecerá na tela.
+***Se o exame exigir preenchimento de informação adicional, será solicitado ao confirmar o pedido
+*Um exame pode ser recoletado depois de já ter sido enviado via web service, porém exames recoletados não são reenviados e também não entram em lotes, para esses casos, é preciso que o cliente realize os ajustes manualmente direto no sistema do apoio, consequentemente, a digitação dos resultados destes exames também deverá ser manual.
+[[Arquivo:02PediCad.JPG|centro|miniaturadaimagem|800x800px|Inclusão de pedido]]
+* Após enviar o exame, a impressão de suas devidas etiquetas ja estarâo disponíveis na tela de impressão de etiquetas
+** Lembrando que as etiquetas impressas serão as que o próprio Solução disponibiliza via web service, não sendo configuráveis
+=== '''Retorno via Web Service:''' ===
+*O retorno dos resultados via web service acontece no menu: Movimentação > Interfaceamento > Laboratório de Apoio.
+*A janela de retorno pode ser aberta selecionando o laboratório do Solução e clicando no botão "Resultados"
+*Na tela será exibida 3 formas de importação de resultados:
+** Pedido: Será importados todos os resultados disponíveis para o pedido selecionado
+** Período de envio para o Solução: Será importados todos os resultados de qualquer pedido disponível no período selecionado.
+*** O período é referente à data que os exames foram enviados ao Solução via web service
+**Importação manual: Importação padrão via arquivo, como é relizado sem web service
+[[Arquivo:RetornoSolucao.jpg|centro|miniaturadaimagem|700x700px|Retorno de resultados Solução via web service]]
+=== Relatório ===
+* Para saber o status dos exames enviados para o Solução, é necessário ir no menu: Relatórios > Interfaces > Solução web service
+:[[Arquivo:RelatorioSolucao.jpg|centro|miniaturadaimagem|400x400px|Filtros do relatório]]
+:[[Arquivo:RelatorioSolucao2.jpg|centro|miniaturadaimagem|700x700px|Relatório impresso]]      [[Categoria:Interfaceamentos]]
+==Possíveis erros==
+Erros gerados no cadastro do pedido
+*Verifique se as configurações do laboratório e exame estão corretas.
+**URL WS no cadastro do laboratório de apoio, incorreta.
+*Erro retornado pela comunicação: Pedido de retorno divergente do pedido de envio.
+*Não foi possível processar o Pedido/Atendimento recebido da Integração: HSF. Serviço Solicitante: 1411.
+*Erro: Falha no login: Serviço solicitante não localizado com o código '1411'
+**Usuário e/ou Senha (Chave) inválido no cadastro do laboratório de apoio.
+*Erro: Não há valor padrão configurado na Integração x Serviço Solicitante  (Integração 'HSF', Serviço Solicitante '141', Entidade 'TipoRegistroExterno')
+**Erro de configuração no solução.
+*Erro: Não foi possível processar os Pedidos recebidos da Integração: HSF. Serviço Solicitante: 141.  Erro: Foi forçado o cancelamento de uma conexão existente pelo host remoto
+**Houve queda do webservice ou de conexão.
+==Tratamento de arquivos==
+- Abra o arquivo com bloco de notas.
+- Dê um Ctrl + F para abrir a opção de localizar e substituir.
-Com o arquivo em mãos, em Movimentação > Interfaceamento > Laboratório. Selecione o Lab. Reação e clique em  “Resultado”, selecionar o arquivo de retorno e clicar em OK.
+- Execute o comando para substituir as seguintes tags:
+<Exame> por <EXAME>
+e
+</Exame> por </EXAME>
-Na importação do retorno do Reação várias verificações são feitas para garantir a integridade do resultado importado pela interface. Se algum resultado enviado pelo Reação tem alguma divergência com as informações configuradas no Unilab, o resultado divergente não é importado e a causa é relatada no final da importação.
+- Pronto!