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

De UniWiki
Ir para: navegação, pesquisa
 
(22 revisões intermediárias por 8 usuários não estão sendo mostradas)
Linha 1: Linha 1:
 +
[[Categoria:Unilab]]
 
==Contato no Laboratório Solução==
 
==Contato no Laboratório Solução==
 
'''Jean Sorbara'''<br>
 
'''Jean Sorbara'''<br>
Linha 8: Linha 9:
 
== Pré-requisitos ==
 
== Pré-requisitos ==
 
*O interfaceamento será liberado no Unilab pela Uniware mediante pagamento.
 
*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.
 
*Solicitar ao Solução o arquivo de exames.
  
 
==Configurações no Unilab==
 
==Configurações no Unilab==
 
===Etiqueta de MTBI===
 
===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===
 
===Cadastro do laboratório===
Linha 33: Linha 36:
 
No campo Laboratório de apoio, informar o laboratório Soluçã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" e "DT. Vigência" .
+
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.
 
Estes códigos obrigatoriamente deverão ser códigos constantes no arquivo de modelo de exames que foi importado.
Linha 43: Linha 46:
 
No Soluçã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 Soluçã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====
 
====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.”
 
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.”
Linha 62: Linha 65:
 
*Dados do paciente: Código, Nome, sexo, data de nascimento, peso, altura, data da ultima menstruação
 
*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  
 
*Mnemônico do exame no Solução, código do material biológico e data e hora da coleta  
 
 
  
 
====Retorno====
 
====Retorno====
Linha 70: Linha 71:
  
 
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.
 
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:
 +
[[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==
 +
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!

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

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!