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

De UniWiki
Ir para: navegação, pesquisa
(Etiqueta: visualeditor)
 
(19 revisões intermediárias por 7 usuários não estão sendo mostradas)
Linha 9: 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 44: 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 63: 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 71: 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.
[[Categoria:Interfaceamento Laboratório de Apoio]]
+
 
 +
== 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!