Mudanças entre as edições de "SOC"

De UniWiki
Ir para: navegação, pesquisa
(Inclusão de Pedidos)
 
(18 revisões intermediárias por 8 usuários não estão sendo mostradas)
Linha 1: Linha 1:
 +
[[Arquivo:WebService_.png|direita]]
 
[[Categoria:Suporte]]
 
[[Categoria:Suporte]]
 +
'''ATENÇÃO! PÁGINA MIGRADA PARA WIKI NOVA, NÃO SERÁ MAIS ATUALIZADA AQUI!, LINK PARA A NOVA: http://10.1.3.171:3000/e/pt-br/unilab/interfaceamentos/SOC'''
 +
 
O SOC é uma interface do tipo convênio, onde os laboratórios enviam os laudos para o SOC via WebService.
 
O SOC é uma interface do tipo convênio, onde os laboratórios enviam os laudos para o SOC via WebService.
  
 
Esta interface depende completamente do envio de laudos para internet, neste caso é necessário que para um pedido ser enviado este não tenha bloqueio algum (pendencias, autorização, etc.) para envio.
 
Esta interface depende completamente do envio de laudos para internet, neste caso é necessário que para um pedido ser enviado este não tenha bloqueio algum (pendencias, autorização, etc.) para envio.
  
==Configuração==
+
'''''Esta interface utiliza chave de liberação.'''''
No cadastro do Convênio clicar no botão '''Interface''':
 
[[Arquivo:CadConvenio.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
 
  
Na tela de configuração de Interfaceamento, marcar o Check '''Envia resultado SOC''':
+
== Contato ==
[[Arquivo:ConfInterface.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
'''Douglas Jhonatan - Suporte SOC'''
  
Irá mostrar os campos do SOC, é necessário preencher todas as informações de acordo com os dados dos clientes:
+
'''Skype:''' <u>douglas.jhonatan</u>
[[Arquivo:ConfSOC.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
 
O endereço da URL do web service é: '''''https://www.soc.com.br/WSSoc/services/ResultadoExamesWs'''''
 
  
 +
===NOTA===
 +
Existem duas maneiras de configurar o SOC, um modo para exames normais (resultado com variável do tipo: Nenhum, Multi resultado e Unico resultado) e personalizado, este ultimo será para envio de exames específicos que são:
 +
:508 - Billirrubinas
 +
:512 - Glicose Hr após 75 gramas
 +
:515 - Grupo sanguíneo
 +
:514 - HIV1 + HIV
 +
:511 - Colesterol total e frações
 +
:509 - Proteínas totais e frações
 +
:510 - Teste tolerância à glicose
 +
:513 - VDRL
  
No cadastro de exames deve ser preenchido o Código do exame de acordo com a tabela de exames do SOC, na aba Geral:
+
Para ambos os casos deverá ser realizado a configuração até o passo 3 abaixo.
[[Arquivo:examSOC.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
==Configuração==
 +
: Para configurações de exames personalizados deverá ser utilizado os arquivos encontrados no seguinte diretório:
 +
:<span style="color:#ff0000">'''\\svw-uniware2\SUPORTE\SOC'''</span>
 +
:Onde os arquivos cujo nome inicia-se com PERSONALIZAÇÃO será o formato em PDF dos laudos demonstrando como é a configuração do respectivo exame no SOC represantando os campos que recebem resultados e valores de referências.
 +
:Já os exames com o nome próprio de extensão .html carrega uma tabela com os dados de configuração da personalização, exemplo.
 +
[[Arquivo:ColTFSOC.jpg|800px|thumb|center|Interface SOC]]<br style="clear:both;">
 +
Na tela representada no exame Colesterol Total e Frações pelo SOC haverá entrada de resultados nos campos:
 +
:Colesterol Total
 +
:Colesterol HDL
 +
:Colesterol LDL
 +
:Colesterol VLDL
 +
:Trigliceridoes
  
 +
[[Arquivo:VariaveisSOC.jpg|1899px|thumb|center|Interface SOC]]<br style="clear:both;">
 +
Na tabela é possível encontrar os mesmos campos através da coluna '''PERGUNTA''' e suas respectivas variáveis através da coluna '''CODIGOITEMPERGUNTA'''.
 +
Campos obrigatórios serão representados pelo valor 0 na coluna '''OBRIGATORIO'''.
  
Na aba configuração, editar os resultados e clicar no botão SOC:
 
[[Arquivo:ConfExamSOC.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
 
  
Irá então aparecer a tela SOC - variáveis, nesta deverá ser configurado o tipo do resultado, se é único ou Multi Resultado:
+
:1 - No cadastro do Convênio clicar no botão '''Interface''':
[[Arquivo:ConfExamSOC2.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
[[Arquivo:CadConvenio.JPG|800px|thumb|center|Cadastro de convênio]]<br style="clear:both;">
 +
:2 - Na tela de configuração de Interfaceamento, marcar o Check '''Envia resultado SOC''':
 +
[[Arquivo:ConfInterface.JPG|800px|thumb|center|interface]]<br style="clear:both;">
 +
:3 - Irá mostrar os campos do SOC, é necessário preencher todas as informações de acordo com os dados dos clientes:
 +
[[Arquivo:ConfSOC.JPG|800px|thumb|center|Interface SOC]]<br style="clear:both;">
 +
O endereço da URL do web service é: '''''https://www.soc.com.br/WSSoc/services/ResultadoExamesWs'''''
  
Se o resultado for único, deverá ser selecionado no campo Variável o tipo dele, se é Resultado ou Comentário:
+
<span style="color:#ff0000">'''EXAMES NORMAIS'''</span>
[[Arquivo:ConfExamSOC3.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
:4 - No cadastro de exames deve ser preenchido o Código do exame de acordo com a tabela de exames do SOC, na aba Geral:
 +
[[Arquivo:examSOC.JPG|800px|thumb|center|Cadastro de exame]]<br style="clear:both;">
 +
:5 - Na aba configuração, editar os resultados e clicar no botão SOC:
 +
[[Arquivo:ConfExamSOC.JPG|800px|thumb|center|Configuração de exame]]<br style="clear:both;">
 +
:6 - Irá então aparecer a tela SOC - variáveis, nesta deverá ser configurado o tipo do resultado, se é único ou Multi Resultado:
 +
[[Arquivo:ConfExamSOC2.JPG|800px|thumb|center|Configurações SOC]]<br style="clear:both;">
 +
:7 - Se o resultado for único, deverá ser selecionado no campo Variável o tipo dele, se é Resultado ou Comentário:
 +
[[Arquivo:ConfExamSOC3.JPG|800px|thumb|center|Configurações SOC]]<br style="clear:both;">
 +
:8 - Se o resultado for Multi Resultado, ou seja, faz parte de um grupo de resultados, deverá marcar o Exame:
 +
[[Arquivo:ConfExamSOC4.JPG|800px|thumb|center|Configurações SOC]]<br style="clear:both;">
 +
Os exames multi resultados suportados pelo SOC são os listados na tela, quando seleciona um deles no campo Variável é carregado as variáveis dos mesmos.
  
Se o resultado for Multi Resultado, ou seja, faz parte de um grupo de resultados, deverá marcar o Exame:
+
<span style="color:#ff0000">'''EXAMES PERSONALIZADOS'''</span>
[[Arquivo:ConfExamSOC4.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
:4 - No cadastro de exames deve ser preenchido o checkbox "Exame de personalização SOC", "Código do exame" e Cód. de personalização SOC de acordo com a tabela de exames do SOC, na aba Geral:
Os exames multi resultados suportados pelo SOC são os listados na tela, quando seleciona um deles no campo Variável é carregado as variáveis dos mesmos.
+
[[Arquivo:examSOCPerso.JPG|800px|thumb|center|Cadastro de exame]]<br style="clear:both;">
 +
:5 - Na aba configuração, editar os resultados e clicar no botão SOC:
 +
[[Arquivo:ConfExamSOC.JPG|800px|thumb|center|Configuração de exame]]<br style="clear:both;">
 +
:6 - Irá então aparecer a tela SOC - variáveis, nesta deverá ser configurado a variável do resultado:
 +
[[Arquivo:ConfExamSOC2Perso.JPG|800px|thumb|center|Configurações SOC]]<br style="clear:both;">
  
 
==Inclusão de Pedidos==
 
==Inclusão de Pedidos==
  
 
Para incluir um pedido para o SOC e envia-lo, é necessário preenchimento dos campos que aparecem ao pressionar o botão SOC na tela de pedidos:
 
Para incluir um pedido para o SOC e envia-lo, é necessário preenchimento dos campos que aparecem ao pressionar o botão SOC na tela de pedidos:
[[Arquivo:pedidoSOC.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
[[Arquivo:pedidoSOC.JPG|800px|thumb|center|Pedido de exame]]<br style="clear:both;">
  
 
Os campos deverão ser preenchidos de acordo com a guia que o SOC enviará:
 
Os campos deverão ser preenchidos de acordo com a guia que o SOC enviará:
[[Arquivo:GuiaSOC.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
[[Arquivo:GuiaSOC.JPG|800px|thumb|center|Guia enviada pelo SOC]]<br style="clear:both;">
  
 
O envio é feito através do envio para internet, bastando liberar o exame se o cliente utiliza o Unilaudos, caso contrário, deverá clicar no botão Reenvia internet na tela de pedidos.
 
O envio é feito através do envio para internet, bastando liberar o exame se o cliente utiliza o Unilaudos, caso contrário, deverá clicar no botão Reenvia internet na tela de pedidos.
  
 
Para verificar se os laudos foram enviados para o SOC, basta verificar na rastreabilidade do pedido:
 
Para verificar se os laudos foram enviados para o SOC, basta verificar na rastreabilidade do pedido:
[[Arquivo:RastreaSOC.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
[[Arquivo:RastreaSOC.JPG|800px|thumb|center|Rastrealidade]]<br style="clear:both;">
  
 
Ou através do relatório de envio ao SOC web service:
 
Ou através do relatório de envio ao SOC web service:
[[Arquivo:RelSOC.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
[[Arquivo:RelSOC.JPG|800px|thumb|center|Relatórios › Interfaces › SOC Web Service ]]<br style="clear:both;">
 +
 
 +
[[Arquivo:RelSOCFiltro.JPG|800px|thumb|center| Relatório de exames enviado ao SOC web service]]<br style="clear:both;">
 +
 
 +
[[Arquivo:RelSOC2.JPG|800px|thumb|center|Relatório de exames enviado ao SOC web service]]
 +
 
 +
== '''Erros SOC''' ==
 +
'''Funcionário não cadastrado:''' código do funcionário errado no cadastro do pedido. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”.
 +
 
 +
[[Arquivo:Funcionario.jpg|centro|miniaturadaimagem|632x632px]]
 +
 
 +
'''Código da empresa inválido:''' mesma situação do item acima, só que desta vez é o código da empresa que estaria errado. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”.
 +
 
 +
[[Arquivo:Empresa.jpg|centro|miniaturadaimagem|661x661px]]
 +
 
 +
'''Ficha/Resultado de exame não encontrado, parâmetro do XML não setado para criação:''' Data da ficha errada. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”. Em alguns casos foi necessário ajustar o código do exame em CADASTROS > EXAMES > EXAME > ALTERAR > CAMPO CÓDIGO DO EXAME SOC.
 +
 
 +
[[Arquivo:Exame.jpg|centro|miniaturadaimagem|665x665px]]
 +
[[Arquivo:Codigo.jpg|centro|miniaturadaimagem|666x666px]]
  
[[Arquivo:RelSOC2.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
'''Java.lang.NullPointerException:''' código da empresa digitado errado, com muitos caracteres além do necessário, verifiquei casos, que o código correto tinha 4 ou 5 dígitos, mas no Unilab tinha 9 ou 10 caracteres digitados. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”. Para este erro também seria interessante verificar o campo código de terceiros, é possível encontrá-lo no canto superior direito da tela de cadastro do pedido.
 +
[[Arquivo:Java.jpg|centro|miniaturadaimagem|670x670px]]
  
[[Arquivo:RelSOC2.JPG|600px|thumb|center|Envio de Laudos]]<br style="clear:both;">
+
'''Problems creating SAAJ object model:''' caracteres especiais ( >, <, & e “ ) na tag de resultado.
 +
[[Arquivo:Tag.png|centro|miniaturadaimagem|692x692px]]'''Horário do windows errado:''' the message has expired no relatório
 +
[[Categoria:Interfaceamentos]]
 +
[[Categoria:Sites]]

Edição atual tal como às 16h17min de 13 de setembro de 2023

WebService .png

ATENÇÃO! PÁGINA MIGRADA PARA WIKI NOVA, NÃO SERÁ MAIS ATUALIZADA AQUI!, LINK PARA A NOVA: http://10.1.3.171:3000/e/pt-br/unilab/interfaceamentos/SOC

O SOC é uma interface do tipo convênio, onde os laboratórios enviam os laudos para o SOC via WebService.

Esta interface depende completamente do envio de laudos para internet, neste caso é necessário que para um pedido ser enviado este não tenha bloqueio algum (pendencias, autorização, etc.) para envio.

Esta interface utiliza chave de liberação.

Contato

Douglas Jhonatan - Suporte SOC

Skype: douglas.jhonatan

NOTA

Existem duas maneiras de configurar o SOC, um modo para exames normais (resultado com variável do tipo: Nenhum, Multi resultado e Unico resultado) e personalizado, este ultimo será para envio de exames específicos que são:

508 - Billirrubinas
512 - Glicose Hr após 75 gramas
515 - Grupo sanguíneo
514 - HIV1 + HIV
511 - Colesterol total e frações
509 - Proteínas totais e frações
510 - Teste tolerância à glicose
513 - VDRL

Para ambos os casos deverá ser realizado a configuração até o passo 3 abaixo.

Configuração

Para configurações de exames personalizados deverá ser utilizado os arquivos encontrados no seguinte diretório:
\\svw-uniware2\SUPORTE\SOC
Onde os arquivos cujo nome inicia-se com PERSONALIZAÇÃO será o formato em PDF dos laudos demonstrando como é a configuração do respectivo exame no SOC represantando os campos que recebem resultados e valores de referências.
Já os exames com o nome próprio de extensão .html carrega uma tabela com os dados de configuração da personalização, exemplo.
Interface SOC

Na tela representada no exame Colesterol Total e Frações pelo SOC haverá entrada de resultados nos campos:

Colesterol Total
Colesterol HDL
Colesterol LDL
Colesterol VLDL
Trigliceridoes
Interface SOC

Na tabela é possível encontrar os mesmos campos através da coluna PERGUNTA e suas respectivas variáveis através da coluna CODIGOITEMPERGUNTA. Campos obrigatórios serão representados pelo valor 0 na coluna OBRIGATORIO.


1 - No cadastro do Convênio clicar no botão Interface:
Cadastro de convênio

2 - Na tela de configuração de Interfaceamento, marcar o Check Envia resultado SOC:
interface

3 - Irá mostrar os campos do SOC, é necessário preencher todas as informações de acordo com os dados dos clientes:
Interface SOC

O endereço da URL do web service é: https://www.soc.com.br/WSSoc/services/ResultadoExamesWs

EXAMES NORMAIS

4 - No cadastro de exames deve ser preenchido o Código do exame de acordo com a tabela de exames do SOC, na aba Geral:
Cadastro de exame

5 - Na aba configuração, editar os resultados e clicar no botão SOC:
Configuração de exame

6 - Irá então aparecer a tela SOC - variáveis, nesta deverá ser configurado o tipo do resultado, se é único ou Multi Resultado:
Configurações SOC

7 - Se o resultado for único, deverá ser selecionado no campo Variável o tipo dele, se é Resultado ou Comentário:
Configurações SOC

8 - Se o resultado for Multi Resultado, ou seja, faz parte de um grupo de resultados, deverá marcar o Exame:
Configurações SOC

Os exames multi resultados suportados pelo SOC são os listados na tela, quando seleciona um deles no campo Variável é carregado as variáveis dos mesmos.

EXAMES PERSONALIZADOS

4 - No cadastro de exames deve ser preenchido o checkbox "Exame de personalização SOC", "Código do exame" e Cód. de personalização SOC de acordo com a tabela de exames do SOC, na aba Geral:
Cadastro de exame

5 - Na aba configuração, editar os resultados e clicar no botão SOC:
Configuração de exame

6 - Irá então aparecer a tela SOC - variáveis, nesta deverá ser configurado a variável do resultado:
Configurações SOC

Inclusão de Pedidos

Para incluir um pedido para o SOC e envia-lo, é necessário preenchimento dos campos que aparecem ao pressionar o botão SOC na tela de pedidos:

Pedido de exame

Os campos deverão ser preenchidos de acordo com a guia que o SOC enviará:

Guia enviada pelo SOC

O envio é feito através do envio para internet, bastando liberar o exame se o cliente utiliza o Unilaudos, caso contrário, deverá clicar no botão Reenvia internet na tela de pedidos.

Para verificar se os laudos foram enviados para o SOC, basta verificar na rastreabilidade do pedido:

Rastrealidade

Ou através do relatório de envio ao SOC web service:

Relatórios › Interfaces › SOC Web Service

Relatório de exames enviado ao SOC web service

Relatório de exames enviado ao SOC web service

Erros SOC

Funcionário não cadastrado: código do funcionário errado no cadastro do pedido. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”.

Funcionario.jpg

Código da empresa inválido: mesma situação do item acima, só que desta vez é o código da empresa que estaria errado. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”.

Empresa.jpg

Ficha/Resultado de exame não encontrado, parâmetro do XML não setado para criação: Data da ficha errada. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”. Em alguns casos foi necessário ajustar o código do exame em CADASTROS > EXAMES > EXAME > ALTERAR > CAMPO CÓDIGO DO EXAME SOC.

Exame.jpg
Codigo.jpg

Java.lang.NullPointerException: código da empresa digitado errado, com muitos caracteres além do necessário, verifiquei casos, que o código correto tinha 4 ou 5 dígitos, mas no Unilab tinha 9 ou 10 caracteres digitados. É possível encontrar este campo no cadastro do pedido, clicando no botão “SOC”, presente ao lado do campo “Observação do pedido”. Para este erro também seria interessante verificar o campo código de terceiros, é possível encontrá-lo no canto superior direito da tela de cadastro do pedido.

Java.jpg

Problems creating SAAJ object model: caracteres especiais ( >, <, & e “ ) na tag de resultado.

Tag.png
Horário do windows errado: the message has expired no relatório