INTEGRAÇÃO COM A S_LINE Como Configurar o seu Sistema

Transcrição

1 1. Introdução O Serviço de Resultado de Exames via Internet da S_Line implementa características de INTEGRIDADE e GERENCIAMENTO, tornando eficiente, seguro e ágil o processo de entrega de Resultado de Exames via Internet ao Paciente, Médico e qualquer outro destinatário (empresa, hospital, clínica, posto de coleta, operadora de plano de saúde, etc.). A consulta ao resultado pode ser feita no site do cliente (Clínica, Laboratório ou Operadora de Plano de Saúde) ou no Banco de Resultados ( através de uma Chave e Senha, podendo esta Chave ser Permanente ou Temporária. Apresentaremos o que deve ser implementado no sistema de informática do cliente, para uso da Solução S_Line. 2. Formato de Documentos S_Line O sistema deve gerar um documento em formato XML com as características abaixo: Cada documento deve corresponder a um arquivo gerado e pode ter qualquer nome; Os arquivos podem estar armazenados em qualquer diretório em um drive disponível para o acesso pelo Sistema da S_Line, desde que este diretório seja EXCLUSIVO e esteja liberado para leitura, escrita e exclusão dos arquivos ali existentes; As tags devem ser escritas sempre em letras MAIÚSCULAS, incluindo no início: Constante <?xml version="1.0" encoding="iso "?> Tag <S_LINE> Campo Tam Tag Conteúdo Obrig. Obrig. Descrição SL_TIPO 3 Sim Sim Tipo de documento a enviar (item 2.1); SL_TITULO 70 Sim Não Título do documento (item 2.2); SL_SN 1 Sim Não Indica o destinatário principal (item 2.3); SL_CHAVE 20 Sim Não Chave de acesso ao documento (item 2.4); SL_SENHA 8 Sim Não Senha de acesso ao documento (item 2.5); SL_COD_DOC 20 Sim Não Identificação do documento (item 2.6); SL_FORMATO 5 Sim Não Formato do arquivo gerado (item 2.7); SL_CHAVE_ ADICIONAL SL_DATA_ REALIZACAO Não Não Chave de outros destinatários (item 2.8); 19 Não Sim Data que os exames foram realizados (item 2.9); SL_SMS Não Não Envio de SMS (item 2.10); SL_OPER Não Não Envio à Operadora Plano Saúde (item 2.11); SL_EXAMES Não Não Informa os Exames (partes) existentes no Documento (item 2.12); SL_TEXTO Sim Não Preencher conforme item SL_TIPO: Tipo de Documento O sistema pode gerar documento para envio à S_Line, em formato Texto ou PDF, mas aqui só trataremos de resultado em Texto, então preencher com RE, e gerar um só arquivo XML para cada documento, onde conterá as informações de envio e o conteúdo do documento, que será incluído na tag SL_TEXTO. 1 de 16

2 Nota: NÃO PODE possuir na tag SL_TEXTO referência a imagens que estejam localizadas em outros servidores, pois ocasionará violação de segurança. Exemplo de um XML RE (Texto), sem envio de SMS ou para Operadora (As tags estão em negrito somente para destaque): <?xml version="1.0" encoding="iso "?> <S_LINE> <SL_TIPO>RE</SL_TIPO> <SL_TITULO>Maria Dois da Silva - 13/07/1985</SL_TITULO> <SL_SN>N</SL_SN> <SL_CHAVE>300177</SL_CHAVE> <SL_SENHA>abcd2222</SL_SENHA> <SL_COD_DOC> </SL_COD_DOC> <SL_FORMATO>HTML</SL_FORMATO> <SL_CHAVE_ADICIONAL></SL_CHAVE_ADICIONAL> <SL_DATA_REALIZACAO> T07:25:00</SL_DATA_REALIZACAO> <SL_EXAMES> <EXAME NOME="HÔMONIO TIREOESTIMULANTE" PENDENTE="N"/> <EXAME NOME="HÔMONIO FÓLICO ESTIMULANTE" PENDENTE="N"/> <EXAME NOME="GLICOSE" PENDENTE="N"/> <EXAME NOME="TOXOPLAMOSE IGG" PENDENTE="S"/> <EXAME NOME="TOXOPLAMOSE IGN" PENDENTE="S"/> </SL_EXAMES> <SL_TEXTO><![CDATA[<pre>TOXOPLASMOSE IgG...: SORO NAO REAGENTE Valores de Referência.: Soro não reagente IgM...: SORO NAO REAGENTE Valores de Referência.: Soro não reagente Material: Soro Método..: Imunofluorescencia Indireta GLICOSE RESULTADO...: 78 mg/dl VR: Em jejum: 75 a 115 mg/dl Material: Plasma Método..: GOD - PAP - Automatizado Observações Gerais: Coleta: JEJUM - Horário da coleta:7:52 Assinado eletronicamente por: Dr. Nono Neto (CRM: 999-ES) </pre>]]> </SL_TEXTO> </S_LINE> 2.2. SL_TITULO: Título do Documento É usado para identificar o conteúdo do documento, sendo normalmente preenchido com a Identificação do Documento (SL_COD_DOC), Nome do Paciente e data de Nascimento, porém quando não é documento relativo a exames em pessoas, informar um nome/código que identifica este documento. Recomenda-se que o sistema permita configurar se o título vai conter: Identificação, Nome do Paciente e Data de Nascimento (Ex.: xxxxxxxx - Nome-do-Paciente - dd/mm/aa); Nome do Paciente e Data de Nascimento (Ex.: Nome-do-Paciente - dd/mm/aa); Identificação e Nome do Paciente (Ex.: xxxxxxxx - Nome-do-Paciente); Nome e Identificação (Ex.: Nome-do-Paciente - xxxxxxxx); Só o Nome (Ex.: Nome-do-Paciente); Só a Identificação (Ex.: xxxxxxxx). 2 de 16

3 2.3. SL_SN: Indica o tipo de Destinatário Principal Define qual o tipo de destinatário principal irá receber o documento: SL_SN = N : Quando a SL_CHAVE é Temporária (item 2.4.1). Nesta opção, o documento também pode ser enviado para Chave Permanente, usando o SL_CHAVE_ADICIONAL, e à Operadora, preenchendo a SL_OPER. SL_SN = S : Quando a SL_CHAVE é Permanente (item 2.4.2). Nesta opção, o documento também pode ser enviado à Operadora, preenchendo SL_OPER. SL_SN = O : Quando o documento será enviado SOMENTE á Operadora (item 2.11), sendo que neste caso NÃO precisa preencher a SL_CHAVE SL_CHAVE: Chave do Destinatário Principal Chave do destinatário principal que irá receber o documento e deve ter de 3 a 20 caracteres alfanuméricos, sendo letra, número, traço (-), travessão (_) e/ou ponto (.). Este campo é obrigatório se o SL_SN for S ou N, pois é ignorado se for O e, logicamente, não deve ser preenchido. A Chave gerada automaticamente pelo sistema deve ser composta com um Identificador de Instalação para diferenciar as Chaves, que é um campo de 2 caracteres alfanuméricos, configurado nos parâmetros do sistema Chave Temporária Será considerada Temporária se o SL_SN = N e é utilizada pelo paciente para consultar os resultados de exames de uma requisição. Esta chave só existirá por um período de tempo, mas caso o paciente queira guardar seus resultados, ele poderá mover esta requisição para uma Chave Permanente que ele criará informando apenas seu e nome, guardando assim todos documentos sob um única Chave. É ideal que use o SL_COD_DOC (item 2.6) como Chave Temporária, precedido do Identificador de Instalação para diferenciar as Chaves, isto evitará que diferentes clientes utilizem a mesma Chave para diferentes pacientes. Ex.: Para SL_COD_DOC= e Id.Instalação=BX, será BX Chave Permanente Será considerada Permanente se o SL_SN = S e é utilizada por Médico, Convênio (Empresa, Hospital, Clínica, etc.), Posto de Coleta ou pelo Paciente. Não pode ser repetida, exceto quando mais de um médico ou convênio, utilizam a mesma chave para acessar os resultados de vários pacientes (normalmente em casos de envio para lugar que atende em plantão, vários médicos em um mesmo ambiente). A Chave Permanente NUNCA deve ser igual a uma Temporária. Nota: Se o Sistema utilizar como Chave Permanente um campo pré-definido (Ex.: Código interno do paciente, convênio ou médico), é necessário utilizar o Identificador de Instalação para diferenciar as Chaves. Ex. 1: Se o Código interno do paciente for e o Identificador de Instalação for LB, a Chave LB78674; Ex. 2: Se o Código interno do convênio for 047 e o Identificador de Instalação for LB, a Chave LB047. Para criar Chave Permanente para Paciente, recomenda-se criar um campo no Cadastro de Paciente, que ao gerar o arquivo para S_Line, se este campo Chave estiver preenchido, gerar o SL_SN = S, caso contrário gerar o SL_SN = N, indicando que é Chave Temporária. 3 de 16

4 2.5. SL_SENHA: Senha de Acesso Utilizada em conjunto com a Chave e deve ter de 6 a 8 caracteres alfanuméricos. É obrigatório se o SL_SN = N e recomenda-se que seja criada a partir de um algoritmo tendo como base a Chave Temporária. É opcional se o SL_SN = S. Será ignorado se o SL_SN = O e, logicamente, não deve ser preenchido. Nota: Evite usar na Senha os números 1 (um) e 0 (zero), e as letras L (ele) e O (ó), pois estes caracteres são semelhantes em alguns tipos de fontes SL_COD_DOC: Código do Documento Número da Requisição, Protocolo, Ordem de Serviço, Amostra, Atendimento, etc., enfim, um código que identifica como único o documento e deve ter de 3 a 20 caracteres alfanuméricos, sendo letra, número, traço (-), travessão (_) e/ou ponto (.). Nota: Este código deve ser único por documento, pois se enviar um novo documento com o mesmo código este irá sobrepor o anterior SL_FORMATO: Formato do Arquivo Formato do arquivo gerado, composto com: TEXTO para arquivo gerado no formato DOS e/ou em TEXTO; HTML para arquivo gerado em HTML; 2.8. SL_CHAVE_ADICIONAL: Chave de outros Destinatários É utilizada para enviar a outros destinatários, além do especificado na SL_CHAVE, porém esta só pode ser usada para Chave Permanente. É muito usada quando um mesmo documento tem que ser encaminhado ao Paciente e ao seu Médico, neste caso a chave do Médico deve ser preenchida na SL_CHAVE_ADICIONAL. Para mais de uma SL_CHAVE_ADICIONAL, separe-as com ; (ponto e vírgula) SL_DATA_REALIZACAO: Data de Realização Data que os exames foram realizados, no formato aaaa-mm-ddthh:mm:ss (aaaa: Ano; mm: Mês; dd: Dia; T: Constante; hh: Hora; mm: Minuto; ss: Segundo). Deve usar SOMENTE se: Envio de um novo documento: A data de inclusão será diferente da data de realização; Re-envio por solicitação de usuário: Informe a data de realização, pois assim aparecerá na data correta para quem não tem este documento e para quem tem não mostrará que chegou uma atualização (se já foi consultado, a carta continuará aberta) NÃO deve ser usada quando: Re-envio com Resultado Parcial: Se informar a data de realização, não mostrará a quem já tem este documento que chegou uma atualização (se já foi consultado, a carta continuará aberta); Re-envio para corrigir erro: Isto acontece quando o resultado foi enviado com algum erro e necessita enviar uma correção, então NÃO informe a data de realização, pois se informar, não mostrará a quem já tem este documento que chegou uma atualização (se já foi consultado, a carta continuará aberta) 4 de 16

5 2.10. SL_SMS: Envio de SMS (Torpedo) Recurso para avisar aos clientes sobre determinadas situações, tais como: Confirmação de Agendamento; Aviso que o Resultado de Exames ficou pronto; Aniversário; etc. O SMS pode ser enviado de duas maneiras: Junto com o Documento (RE/RP), sendo que neste caso deve existir a tag SL_SMS no xml gerado para o RE/RP; Sem estar ligado a um Documento, onde cada xml deve conter apenas um SMS a enviar, e o arquivo gerado pode ter qualquer nome; Campo Tam Tag Obrig. Conteúdo Obrig. SL_SMS Não Sim Envio de SMS; Descrição SMS_NUM 11 Sim Sim Número do telefone (item ); SMS_MSG 150 Sim Sim Mensagem do SMS (item ); SMS_TIPO 1 Não Sim Tipo do SMS (item ); SMS_DATAHORA 19 Não Sim Hora de envio do SMS (item ); SMS_COD1 50 Não Não Código de uso aleatório utilizado em SMS com retorno, facilitando a identificação do mesmo; SMS_COD2 50 Não Não Código de uso aleatório, idem SMS_COD1; Tag <SMS_NUM>: Número do Telefone a receber o SMS Preenchido com ddnnnnnnnn, sendo: dd = código de área e nnnnnnnnn = Número do Celular, que pode ter 8 ou 9 dígitos Tag <SMS_MSG>: Mensagem do SMS Mensagem SMS a ser enviada, que: Deve ter tamanho máximo de 150 caracteres ou 128 se SMS_TIPO = A ou L ; Para SMS_TIPO = A ou L, o cliente deve configurar no Conecta S_Line, onde envia SMS, o remetente (tamanho 20 caracteres) com o nome reduzido do cliente ou o número do telefone. Ex.: Lab XXXXXXXXXX ou ; Deve inserir os caracteres <![CDATA[ logo após a tag <MSG> e ]]> imediatamente antes da tag </MSG>; Não pode ter acentuação; Pode ter somente Letras (Maiúsculas ou minúsculas), Números e os caracteres - _. :, # $ % + = * / < > ( ) Tag <SMS_TIPO>: Tipo do SMS Define o tipo de SMS a ser enviado, podendo ser: A : Gerado no Atendimento do Paciente; L : Gerado ao Liberar o Resultado do Paciente para enviar à internet; P : Gerado para Pesquisa de Opinião; R : Gerado para Confirmação de Agenda permitindo Resposta do Paciente; O : Gerado em Outro momento, não previsto acima, tal como: Aviso de Confirmação ou Cancelamento de Agenda (NÃO permitindo Resposta), Aniversário, Campanhas de Marketing, etc. 5 de 16

6 Tag <SMS_DATAHORA>: Data e Hora que o SMS deve ser enviado Esta tag somente deve ser constar no xml, se for preenchida, sendo: Se existir no xml: Data e Hora que deseja enviar o SMS ao paciente no formato aaaa-mmddthh:mm:ss, sendo que o SMS somente será enviado ao paciente nesta data/hora; Se o xml não conter esta tag: Será considerada a data e hora corrente, ou limitada à configuração de horários de envio, que o cliente pode configurar, evitando transtornos de o paciente receber SMS em horários inconvenientes (madrugada). Ex.: Enviar SMS somente das 08:00 às 21:00 horas Exemplo de um xml tipo L A mensagens com SMS_TIPO = A e L serão acrescentadas do nome configurado no Conecta S_Line. <?xml version="1.0" encoding="iso "?> <S_LINE> <SL_TIPO>SMS</SL_TIPO> <SL_TITULO></SL_TITULO> <SL_SN></SL_SN> <SL_CHAVE></SL_CHAVE> <SL_SENHA></SL_SENHA> <SL_COD_DOC></SL_COD_DOC> <SL_FORMATO></SL_FORMATO> <SL_SMS> <SMS_NUM> </SMS_NUM> <SMS_MSG><![CDATA[Maria Dois da Silva - Resultado pronto! Consulte em <SMS_TIPO>L</SMS_TIPO> </SL_SMS> <SL_TEXTO/> </S_LINE> Exemplo de um xml tipo R Este tipo de SMS permitirá ao usuário responder, que irá retornar um xml com a resposta. <?xml version="1.0" encoding="iso "?> <S_LINE> <SL_TIPO>SMS</SL_TIPO> <SL_TITULO></SL_TITULO> <SL_SN></SL_SN> <SL_CHAVE></SL_CHAVE> <SL_SENHA></SL_SENHA> <SL_COD_DOC></SL_COD_DOC> <SL_FORMATO></SL_FORMATO> <SL_SMS> <SMS_NUM> </SMS_NUM> <SMS_MSG><![CDATA[Maria, confirme agenda de 10/01/16 as 10:30 de TC - Articulação. Resposta GRATIS (uma letra): C=Confirmar, N=Nao confirmar, R=Remarcar]]></SMS_MSG> <SMS_TIPO>R</SMS_TIPO> <SMS_COD1>90873</SMS_COD1> <SMS_COD2> </SMS_COD2> </SL_SMS> <SL_TEXTO/> </S_LINE> 6 de 16

7 2.11. SL_OPER Operadora de Plano de Saúde Permite que as operadoras de saúde acessem os resultados de exames, gerados nos Prestadores de Serviço que a autorizem, via o número da autorização de realização de procedimentos, sendo: OPER_REGANS = Registro da Operadora de Saúde na ANS (tamanho 6 caracteres); OPER_NUMCARTEIRA = Número do Cartão do Beneficiário na Operadora com tamanho máximo 20 caracteres (veja Nota 2); OPER_NUMGUIA =Número da Autorização da Guia TISS com tamanho máximo 20 caracteres (veja Nota 2), sendo que pode existir mais de uma autorização por documento. OPER_EXAME = Código de cada exame contido na Guia, conforme codificação da Operadora, que faz parte do documento enviado, sendo que se for envio parcial, deve conter aqui somente os exames que estão no resultado gerado, isto é, a cada novo reenvio deve listar somente os exames que tem resultado. Nota 1: Compor os campos somente com letras e/ou números. Não incluir formatação nos campos (traço, travessão, ponto, etc.); Nota 2:A Operadora define o tipo de caractere usado (Só Números, Só Letras ou Números e Letras) e o tamanho mínimo e máximo. Caso seja gerado arquivo fora da formatação definida pela Operadora, este não será enviado; Nota 3:O sistema deve ter a opção, no Cadastro de Convênio, do usuário cadastrar o Número do Registro da Operadora (OPER_REGANS) e definir qual é o campo que cada Operadora utiliza para compor o OPER_NUMGUIA, que pode ser o Número da: Guia Principal; Guia do Prestador ou Guia da Operadora. Exemplo de um XML gerado somente para Operadora: <?xml version="1.0" encoding="iso "?> <S_LINE> <SL_TIPO>RE</SL_TIPO> <SL_TITULO>Maria Dois da Silva - 13/07/1985</SL_TITULO> <SL_SN>O</SL_SN> <SL_CHAVE></SL_CHAVE> <SL_SENHA></SL_SENHA> <SL_COD_DOC> </SL_COD_DOC> <SL_FORMATO>HTML</SL_FORMATO> <SL_OPER> <OPER_REGANS>999888</OPER_REGANS> <OPER_NUMCARTEIRA> </OPER_NUMCARTEIRA> <OPER_NUMGUIA> <OPER_EXAME> </OPER_EXAME> <OPER_EXAME> </OPER_EXAME> </OPER_NUMGUIA> </SL_OPER> <SL_TEXTO><![CDATA[<pre>TOXOPLASMOSE IgG...: SORO NAO REAGENTE Valores de Referência.: Soro não reagente IgM...: SORO NAO REAGENTE Valores de Referência.: Soro não reagente Material: Soro Método..: Imunofluorescencia Indireta GLICOSE RESULTADO...: 78 mg/dl VR: Em jejum: 75 a 115 mg/dl Material: Plasma 7 de 16

8 Método..: GOD - PAP - Automatizado Observações Gerais: Coleta: JEJUM - Horário da coleta:7:52 Assinado eletronicamente por: Dr. Nono Neto (CRM: 999-ES) </pre>]]> </SL_TEXTO> </S_LINE> SL_EXAMES: Exames existentes no Documento ou Pendentes de Envio Recurso para avisar aos clientes quais exames estão contidos no documento e se já foi concluído ou está pendente. Campo Tam Tag Obrig. Conteúdo Obrig. SL_EXAMES Não Sim Exames do Documento; EXAME Sim Sim Cada exame existente; NOME 50 Sim Sim Nome do Exame; PENDENTE 1 Sim Sim Descrição Indica se o exame já está pronto = N ou ainda está pendente = S ; SL_TEXTO Conteúdo do Documento Campo é obrigatório se o SL_TIPO for RE, pois é ignorado se for RP, e é o conteúdo do documento, normalmente é o Laudo dos Exames, que pode ser gerado em texto comum ou HTML e devem ser inseridos os caracteres <![CDATA[ logo após a tag <SL_TEXTO> e ]]> imediatamente antes da tag </SL_TEXTO>. 3. Destinatários possíveis para os Documentos O mesmo documento pode ser gerado no sistema para enviar a um ou mais destinatários. Ex.1: Um documento pode ser enviado somente ao paciente, que conterá apenas dados de Chave/Senha do paciente; Ex.2: Um documento pode ser enviado ao paciente e ao seu médico, bastando conter os dados da Chave destes dois diferentes destinatários. Ex.3: Um documento pode ser enviado ao paciente e à Operadora de Plano de Saúde, bastando conter os dados da Chave do paciente e da Operadora. Ex.4: Um documento pode ser enviado somente à Operadora de Plano de Saúde, que conterá apenas os dados da Operadora Enviar Resultados para Médico No sistema, o cadastro de Médicos Solicitantes deve ter o campo Chave S_Line, então assim que o resultado for liberado para Internet, se a Chave S_Line estiver preenchida e o Paciente NÃO incluiu uma restrição de envio de seu resultado ao Médico, o resultado será encaminhado à mesma Enviar Resultados para Posto de Coleta No sistema, o cadastro de Postos de Coleta deve ter o campo Chave S_Line, então assim que o resultado for liberado para Internet, se a Chave S_Line estiver preenchida, o resultado será encaminhado à mesma Enviar Resultados para Convênio No sistema, o cadastro de Convênio deve ter o campo Chave S_Line, então assim que o resultado for liberado para Internet, se a Chave S_Line estiver preenchida e o Paciente NÃO incluiu uma restrição de envio de seu resultado ao Convênio, o resultado será encaminhado à mesma. 8 de 16

9 3.4. Enviar Resultados para Operadora de Plano de Saúde No sistema, o cadastro da Operadora de Plano de Saúde, que normalmente é o mesmo de Convênio, deve ter a indicação se envia resultados para esta operadora via S_Line, então assim que o resultado for liberado para Internet, se existir esta indicação, o resultado será encaminhado com as informações do Registro da Operadora na ANS, Número do Cartão do Beneficiário na Operadora e Número da Autorização da Guia TISS Enviar Resultados para o Paciente No sistema, ao cadastrar a requisição dos exames, na recepção do paciente, a S_Line recomenda que o sistema permita o seguinte fluxo: Atendimento particular que for pago parcialmente, NÃO poderá ser enviado para a Internet, mas esta deve ser uma opção que a recepção pode incluir para qualquer requisição em função de critérios individuais de cada cliente Caso o Médico Solicitante tenha Chave S_Line, a recepção deve questionar ao paciente se o mesmo concorda com o envio ao Médico e caso ele não concordar, deve-se permitir marcar não enviar o Resultado via Internet ao Médico Caso o Convênio tenha Chave S_Line, a recepção deve questionar ao paciente se o mesmo concorda com o envio ao Convênio e caso ele não concordar, deve-se permitir marcar não enviar o Resultado via Internet ao Convênio Caso crie uma Chave Permanente para o Paciente, o sistema deve ter no cadastro de Paciente um campo Chave S_Line, que se NÃO estiver preenchida, a recepção deverá questionar se o Paciente já é cadastrado no Banco de Resultados e se for, preencher no sistema a sua chave, caso contrário, deve-se criar uma Chave para ele Impressão do Comprovante de Coleta O sistema deve incluir as seguintes informações no comprovante de Coleta: Chave: Pode ser a Chave Temporária ou Permanente; Senha: Só será preenchida caso seja uma Chave Temporária; Endereço Internet: Site onde o paciente irá consultar o resultado. É interessante que seja um parâmetro no sistema, pois cada cliente pode configurar o seu site; Data/Hora prevista para entrega: Data/Hora prevista para o resultado ficar disponível para consulta na internet Após preencher a requisição dos exames, o sistema deverá gerar um arquivo com um aviso de Exames em Processamento para envio ao Paciente, isto é importante para evitar que o paciente logo após receber um comprovante de coleta, entre no site e digite a chave e senha, recebendo uma mensagem O resultado NÃO está pronto. Este arquivo deve ser gerado com o formato definido no item 2, porém o conteúdo terá a relação dos exames realizados e as respectivas datas de previsão de entrega. Ex.: Obrigado por ter vindo ao Laboratório de Demonstração! Seus exames estão em processamento, sendo: Hemograma: Previsto para dd/mm/aa hh:mm Glicose: Previsto para dd/mm/aa hh:mm No Cadastro de Exames, deve existir a opção de marcar exame que NÃO poderá ser enviado para a Internet, em função de ética médica ou em função de qualquer outra decisão do Cliente. Um exemplo típico é o resultado de HIV, que normalmente não é enviado pela internet, pois requer entrega pessoal. 9 de 16

10 4. Quando gerar o Documento no sistema O sistema deve gerar um arquivo padrão S_Line (XML com Html ou PDF) em diretórios definidos pelo próprio sistema, conforme item 2, com os Resultados de Exames já liberados e marcados para envio, no diretório definido para Envio, quando: For liberado o resultado, após a digitação, seja parcial ou total; Executar uma função específica que irá gerar arquivo para todos os resultados já liberados e que ainda não foram gerados. O sistema deve identificar situações específicas ao gerar um arquivo, sendo: 4.1. Resultado Parcial Quando um ou mais exames estiverem com o resultado concluído, mas ainda tiver exame pendente, deve-se gerar o arquivo de Resultado Parcial com os resultados já concluídos, e nos demais manter a informação de data prevista. A cada nova conclusão dos exames parciais, será gerado novo arquivo contendo todos os exames já concluídos. Na Central S_Line, o resultado será substituído, pois se trata do mesmo resultado (tag SL_COD_DOC). Nota: NÃO informe a SL_DATA_REALIZACAO nos reenvios para Resultados Parciais, pois se informar NÃO atualizará o conteúdo e a data de inclusão do resultado Mais de um Médico Solicitante Para requisição com mais de um médico solicitante, deve-se gerar um arquivo com os resultados de todos os exames para o PACIENTE e/ou CONVÊNIO e, para os MÉDICOS, cada arquivo deve ter somente os exames solicitados por ele, mudando a identificação do documento, acrescentando à tag SL_COD_DOC um sequencial de 1 a n Mais de um Convênio Para requisição paga por mais de um convênio deve-se gerar um arquivo com os resultados de todos os exames para o PACIENTE e/ou MÉDICO e, para os CONVÊNIOS, cada arquivo deve ter somente os exames ligados a ele, mudando a identificação do documento, acrescentando à tag SL_COD_DOC um sequencial de 1 a n. Ex.: Dois convênios serão incluídos numa mesma requisição se um ou mais exames forem pagos pelo paciente, devido o convênio não cobrir todos os exames da requisição (Convênio XXX e Particular) Mais de uma Guia de Autorização numa mesma Requisição O ideal é que o sistema gere uma requisição (SL_COD_DOC) para cada Autorização da Guia da Operadora, mas se este permitir existir mais de uma autorização por documento, deve-se indicar todas Guias no documento, conforme o item Envio do Resultado para Central S_Line O envio dos Resultados é feito via CONECTA S_Line, que pode funcionar de forma Manual ou Automática (veja documentação do CONECTA). Os arquivos que o cliente envia para Internet (Central S_Line), tem o seguinte fluxo de execução: Validar os arquivos a enviar e caso tenha erro de preenchimento do arquivo, não será enviado para S_Line, e sim movido para o diretório de erro, sendo registrado todo erro ocorrido; Fazer a conexão com a Internet, conforme configurado; Transferir os documentos para a Central S_Line, registrando o ocorrido. 10 de 16

11 6. Retorno de Rastreabilidade O sistema pode receber a rastreabilidade de cada documento enviado para Internet, isto é, saber quando um resultado foi enviado, consultado, excluído, etc., sendo por usuário (Chave) e, também, se o resultado não foi enviado e por qual motivo. O sistema deve ter uma função de importar os arquivos gerados pelo Conecta S_Line, que pode ser dois tipos diferentes de arquivos: 6.1. Arquivo com os Resultados de Exames disponibilizados para Envio É registrado numa Base de Dados Local todo envio de resultado para Internet e mesmo que dê algum erro, é gerado esta informação com o motivo do erro, e o arquivo origem é movido para um diretório onde está instalado o Conecta S_Line e S_Line\Conecta S_Line\Arquivos_Errados\chave-cliente. De forma manual ou automatizada, a partir desta Base de Dados, gera-se um arquivo para cada dia com nome Log_Envio_aaaammdd.xml, no diretório onde está instalado o Conecta S_Line ( S_Line\Conecta S_Line\Log\chave-cliente ), sendo: aaaa: Ano corrente; mm: Mês corrente e dd: Dia corrente. Geração Manual: Na opção Rotinas Gerar Log de Envio do Conecta S_Line pode-se gerar o Log de um dia específico. Geração Automática: Na 1ª execução do dia é gerado o arquivo de Log e este é incrementado a cada envio ou tentativa de envio (se der erro) para o dia. O Conecta S_Line gera, no arquivo local, uma linha para cada documento disponibilizado para envio, então se o Conecta S_Line for instalado em mais de um computador, existirá mais de um arquivo, com envios realizados em cada um. Campo Tam Obrig. Descrição OPERACAO 1 Sim Pode ser: I: Inclusão (foi enviado à Central S_Line); R: Recusado o documento por algum motivo; SERVICO 3 Sim O mesmo que Tipo de documento (item 2.1); CHAVE 20 Sim Chave de acesso ao documento (item 2.4); SENHA 8 Não Senha de acesso ao documento (item 2.5); NUMDOC 20 Sim Identificação do documento (item 2.6); DATA Sim Data que a operação aconteceu; CARTEIRA 20 Não Número Cartão do Beneficiário na Operadora (item 2.11); REGANS 6 Não Registro da Operadora de Saúde na ANS (item 2.11); ARQUIVO Não Nome do arquivo gerado para envio, no sistema; NUMGUIA 20 Não Número da Autorização da Guia TISS (item 2.11); CODERRO 5 Não Código de erro gerado (veja tabela abaixo); DESCRICAO Não Descrição utilizada quando o documento foi Recusado. 11 de 16

12 Código Mensagem de Erro O Laudo foi enviado sem imagem, mas foi gravado com sucesso na Central S_Line Tipo de dado inválido no arquivo Erro Inclusão Chave Permanente ou Alteração Chave Permanente Tamanho do arquivo inválido Erro de estrutura do XML A imagem/pdf não pôde ser lida(o). Erros não tratados no envio de PDF A imagem/pdf não pôde ser gravada(o). Erros não tratados no envio de PDF Tamanho do arquivo inválido PDF Formatação do nome do arquivo PDF inválido Serviço inválido para esse XML no envio do PDF Não existe o arquivo xxxxx.pdf referente ao XML WEBEXCEPTION Campo(s) requerido(s) não informado. + Informações complementares Ocorreu um erro no envio do Torpedo SMS. Verifique o log de erro para saber detalhes Ocorreu algum problema na validação do arquivo SMS. Verifique o log de erro para saber detalhes Erro ao autenticar. Execute o procedimento de autenticação, por favor Conteúdo do Laudo (SL_TEXTO) Inválido Os dados da Operadora devem ser preenchidos para tipo usuário 'Operadora' Serviço 'SRE' não cadastrado para o Cliente Erro recuperando serviços da operadora + "Mensagem de sistema" O Registro ANS está vazio O Registro ANS possui mais que 6 caracteres Erro recuperando dados Operadora + "Mensagem de sistema" Operadora de Saúde não cadastrada Erro recuperando cliente operadora + Mensagem de sistema A Carteira está vazia A Carteira deve possuir entre "mínimo" e "máximo" caracteres A Carteira deve ser "Numérica/Alfabética/Alfanumérica" A Guia TISS não foi informada A Guia TISS está vazia A Guia TISS não deve estar zerada A Guia TISS deve possuir entre "mínimo" e "máximo" caracteres A Guia TISS deve ser "Numérica/Alfabética/Alfanumérica" A Guia do Exame está vazio O Exame da Guia TISS está vazio Cliente não relacionado na Operadora de Saúde Cliente INATIVO na Operadora de Saúde Tipo de Serviço inválido. 12 de 16

13 04002 O tipo do serviço possui mais que 3 caracteres Erro ValidaTipoServico "Mensagem de sistema" O Cliente não possui o serviço "SL_TIPO" habilitado O serviço "SL_TIPO" não está disponível para uso A chave de usuário "SL_CHAVE" possui menos que 3 caracteres A chave de usuário "SL_CHAVE" possui mais que 20 caracteres A chave de usuário "SL_CHAVE" possui caracteres que não são alfanuméricos ou diferentes de traço (-), sublinhado (_) e ponto (.) Erro Valida Chave "Mensagem de sistema" Arquivo de Imagem/PDF acima do tamanho máximo (3MB) Arquivo de Imagem/PDF acima do tamanho máximo (1MB) O diretório a ser gravado não existe no servidor ou não pôde ser criado Erro ValidaImagemRIRP + "Mensagem de sistema" Erro ValidaImagemRIRP + "Mensagem de sistema" A senha do usuário "SL_CHAVE" possui menos que 4 caracteres A senha do usuário "SL_CHAVE" possui mais que 8 caracteres A senha do usuário "SL_CHAVE" possui caracteres que não são alfanuméricos Título Inválido O titulo possui mais que 70 caracteres A formatação informada só pode ser do tipo 'HTML' ou 'TEXTO' O código do laudo possui menos que 1 caractere O código do laudo possui mais que 20 caracteres O código do laudo possui mais que 20 caracteres O código do laudo possui caracteres que não são alfanuméricos ou diferentes de traço (-), sublinhado (_) e ponto (.). O tipo da chave deve ser definido como 'S' (chave permanente) ou 'N' (chave temporária) ou 'O' (envio operadora) O campo chave deve ser preenchido O campo chave deve ser preenchido A senha deve ser informada quando o usuário for temporário Imagem(ns) acima do tamanho máximo permitido (1MB) ou não puderam ser validados. Por favor, reenvie-os Arquivo PDF não encontrado na Central S_Line, favor enviar primeiro o arquivo Arquivo PDF possui tamanho ZERO na Central S_Line, favor enviar novamente o arquivo Arquivo PDF não pôde ser validado ou acima do tamanho máximo permitido (3MB) "Mensagem de sistema" Não existem transações na data informada "Mensagem de sistema". Código do erro na base de dados: "nnn" "Mensagem de sistema". Código do erro na base de dados: "nnn" "Mensagem de sistema" "Mensagem de sistema" 13 de 16

14 O XML é definido com base no arquivo XSD Log_Envio.xsd, conforme mostrado abaixo (As tags estão em negrito somente para destaque): <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" elementformdefault="qualified" xmlns:xsi=" <xs:element name="log_envio"> <xs:complextype> <xs:sequence> <xs:element ref="documento"/> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="documento"> <xs:complextype> <xs:attribute name="operacao" use="required" type="xs:ncname"/> <xs:attribute name="servico" use="required" type="xs:ncname"/> <xs:attribute name="chave" use="required" type="xs:string"/> <xs:attribute name="senha" use="required" type="xs:string"/> <xs:attribute name="numdoc" use="required" type="xs:string"/> <xs:attribute name="data" use="required"/> <xs:attribute name="carteira" use="optional" type="xs:string"/> <xs:attribute name="regans" use="optional" type="xs:string"/> <xs:sequence> <xs:element ref="arquivo" minoccurs="1"/> <xs:element ref="numguia" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="coderro" minoccurs="0"/> <xs:element ref="descricao" minoccurs="0"/> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="arquivo" type="xs:ncname"/> <xs:element name="numguia" type="xs:string"/> <xs:element name="coderro" type="xs:integer"/> <xs:element name="descricao" type="xs:string"/> </xs:schema> Exemplo de um XML gerado (As tags estão em negrito somente para destaque): <?xml version="1.0" encoding="utf-8"?> <LOG_ENVIO> <DOCUMENTO OPERACAO="I" SERVICO="RE" CHAVE=" " SENHA="345698" NUMDOC=" " DATA="05/12/ :29" REGANS="988858" CARTEIRA=" "> <NUMGUIA> </NUMGUIA> <ARQUIVO><![CDATA[ XML]]></ARQUIVO> <CODERRO>00006</CODERRO> <DESCRICAO><![CDATA[O campo deve ser criptografado. O(s) arquivo(s) foi(ram) movido(s) para o diretório 'Arquivos_Errados' localizado na instalação do Conecta S_Line.]]></DESCRICAO> </DOCUMENTO> </LOG_ENVIO> 14 de 16

15 6.2. Registro de Transações dos Resultados de Exames Toda transação que é realizada no Resultado enviado para Internet é registrada na Central S_Line, gerando assim a rastreabilidade. Esta rastreabilidade pode ser visualizada diretamente na seção Gerência do Cliente no site da S_Line ou através de um arquivo que pode ser gerado pelo programa Conecta S_Line. O arquivo pode ser gerado de forma manual ou automatizada, mas sempre só é possível obter a rastreabilidade dos dias anteriores ao atual. Para cada dia é gerado um novo arquivo Log_Transacao_aaaammdd.xml, no diretório onde está instalado o Conecta S_Line e S_Line\Conecta S_Line\Log\chave-cliente, sendo: aaaa: Ano corrente; mm: Mês corrente e dd: Dia corrente. Geração Manual: Na opção Rotinas Buscar Log Transações, do Conecta S_Line. Geração Automática: Na opção Configurar Horário de Execução, do Conecta S_Line, podese marcar a opção Buscar Transações, que em cada 1ª execução do dia irá gerar um arquivo para cada dia que falta desde a última execução. Campo Tam Obrig. Descrição OPERACAO 1 Sim Pode ser: I: Inclusão do documento; A: Alteração do documento; B: consulta do documento via Browser Internet; F: consulta via Front-End (Captura S_Line); M: Moveu o documento para outra chave; X: exclusão do documento da chave do usuário; E: Exclusão do documento do Banco de Resultados; SERVICO 3 Sim O mesmo que Tipo de documento (item 2.1); CHAVE 20 Sim Chave de acesso ao documento (item 2.4); NUMDOC 20 Sim Identificação do documento (item 2.6); DATA Sim Data que a operação aconteceu. Exemplo de um XML gerado (As tags estão em negrito somente para destaque): <?xml version="1.0" encoding="utf-8"?> <LOG_TRANSACAO> <TRADOC OPERACAO="I" SERVICO="RE" CHAVE=" " NUMDOC=" " DATA="05/12/ :29:00" /> <TRADOC OPERACAO="B" SERVICO="RE" CHAVE=" " NUMDOC=" " DATA="05/12/ :08:00" /> <TRADOC OPERACAO="X" SERVICO="RP" CHAVE=" " NUMDOC=" " DATA="05/12/ :32:00" /> </LOG_TRANSACAO> 7. Certificação Digital do Resultado O sistema pode já gerar o PDF assinado digitalmente, isto é, utilizar de Certificação Digital para gerar o PDF, mas para isso entre em contato com a S_Line, que irá disponibilizar um manual de como isto pode ser feito. 15 de 16

16 8. Recursos Adicionais para formatar o Documento em Texto ( RE ) Existem alguns recursos que podem melhorar a formatação dos documentos, sendo: 8.1. Quebra de Página Promover uma quebra de página conforme critérios definidos no sistema Controlada pelo sistema Incluir a tag onde deseja a quebra de página. Nota: Esta tag deve estar numa linha exclusiva para ela Controlada pela S_Line Neste caso o sistema irá incluir tag s de controle que a S_Line usará para incluir a quebra de página em função da configuração de linhas por página (LPP) que o cliente especificar no programa CONECTA S_Line. O sistema deve incluir antes de cada início de exame a tag ; Para definir o conteúdo em cada página, deve-se descontar o tamanho das imagens de cabeçalho e rodapé; A quantidade de LPP poderá variar de acordo com: Tipo de Letra, Tamanho do Cabeçalho e Rodapé e Tipo de Página (Ex.: A4); Caso o sistema use cabeçalho e/ou rodapé dentro do laudo, deve-se usar as tags: *  antes do início do cabeçalho e  ao final *  antes do início do rodapé e  ao final (o rodapé deve ficar ao final do resultado, ou seja, depois de todos os exames) Nota: A impressão no browser (IE, Firefox) é proporcional, ou seja, mesmo sendo o arquivo do tipo DOS, quando impresso no browser se torna WINDOWS Assinatura Digitalizada No Resultado de Exames, ao fim de cada página ou somente na última página, incluir a tag <img src='ass/cliente-nome.gif'> com a assinatura variando em função do responsável pelo Resultado. Todos os Resultados podem ter a mesma assinatura ou todas as assinaturas, neste caso basta fazer um arquivo contendo todas, onde: ASS = Constante que indica o diretório que armazena as assinaturas; CLIENTE = Chave do Cliente cadastrado na S_Line; NOME = Nome da Assinatura, normalmente o nome do responsável; Extensão = Recomenda-se "gif". É possível posicionar a assinatura na linha, sendo: Direita: <div align='right'> <img src='ass/cliente-nome.gif'> </div> Esquerda: <div align='left'> <img src='ass/cliente-nome.gif'> </div> Centro: <div align='center'> <img src='ass/cliente-nome.gif'> </div> Nota: Copiar as assinaturas (escanear) e enviar para a S_Line em formato "gif". 16 de 16