Especificação Técnica ACSS

Transcrição

1 Especificação Técnica ACSS ET.ACSS 20:2011 Base de Dados Nacional de Prescrições Especificação da interface para recepção de receitas médicas ICS DESCRITORES Informática médica; software; especificação técnica; sistema de saúde; serviço de saúde; Serviço Nacional de Saúde; documento electrónico; comunicação de dados; dados médicos; base de dados; registo de dados; sistema de informação Data de Aprovação pela ACSS ELABORAÇÃO UONCSTI EDIÇÃO Janeiro de 2011 PREÇO ACSS reprodução proibida

2 Índice PREÂMBULO OBJECTIVO E CAMPO DE APLICAÇÃO REFERÊNCIAS REFERÊNCIAS LEGAIS REFERÊNCIAS NORMATIVAS REFERÊNCIAS BIBLIOGRÁFICAS ACRÓNIMOS, TERMOS E DEFINIÇÕES ACRÓNIMOS ESPECIFICAÇÃO FUNCIONAL REQUISITOS DE UTILIZAÇÃO DO SERVIÇO RETORNO DO SERVIÇO FLUXO DE EXECUÇÃO MODELO DE COMUNICAÇÃO Parâmetros de Entrada ListaReceitasBody Retorno ListaReceitasBodyOutput ReceitaBodyOutput Falhas REGRAS E VALIDAÇÕES ENTIDADES FINANCEIRAS RESPONSÁVEIS, PARA EFEITOS DE COMPARTICIPAÇÃO DE MEDICAMENTOS Entidades nacionais Entidades estrangeiras EEE, Suíça e Andorra (parcialmente) Outros imigrantes ESPECIFICAÇÃO TÉCNICA OPERAÇÕES EXPOSTAS initiateasync Mensagens de Pedido (Input) Mensagens de Resposta (Output) Mensagens de Falha (Fault) initiatesync Mensagens de Pedido (Input) Mensagens de Resposta (Output) Mensagens de Falha (Fault) MENSAGENS DE RETORNO Estados e mensagens Reenvio de mensagens INFORMAÇÃO OPERACIONAL Endpoints WSDL Timeout Segurança ESTRUTURAS DE DADOS RegistoPrescricaoMedicamentosProcessRequestType Página 2 de 31

3 5.4.2 RegistoPrescricaoMedicamentosMessageBody ListaReceitasBody RegistoPrescricaoMedicamentosProcessResponseType RegistoPrescricaoMedicamentosMessageBodyOutput ListaReceitasBodyOutput ReceitaBodyOutput REPRESENTAÇÃO GRÁFICA DAS ESTRUTURAS DE DADOS RegistoPrescricaoMedicamentosProcessRequestType RegistoPrescricaoMedicamentosMessageBody ListaReceitasBody RegistoPrescricaoMedicamentosProcessResponseType RegistoPrescricaoMedicamentosMessageBodyOutput ListaReceitasBodyOutput ReceitaBodyOutput XML SCHEMA DEFINITION EXEMPLOS DE INVOCAÇÃO Anulação de receita Registo de receita Registo de receita Migrante Página 3 de 31

4 Preâmbulo Esta especificação técnica descreve o serviço de Registo de Prescrição de Medicamentos na Base de Dados Nacional de Prescrições (BDNP). Este serviço é disponibilizado pela Plataforma de Integração da ACSS e está exposto na Gateway de Serviços da referida Plataforma, sendo o respectivo acesso fornecido no âmbito do processo de certificação do software. Este documento contempla um capítulo de especificação funcional contendo informação detalhada sobre os dados expostos pelo serviço e descrição do processo de negócio e um capítulo de especificação técnica com informação de âmbito operacional. Esta especificação técnica deve ser analisada em conjunto com a ET.ACSS 19:2010 que define o Modelo de Dados da Receita Médica para que se estabeleçam os requisitos completos relativos às características do serviço. O texto do projecto de especificação técnica foi submetido à apreciação da Comissão Técnica de Normalização da ACSS e foi aprovado como ET.ACSS 20:2011, em Página 4 de 31

5 1 Objectivo e campo de aplicação Esta especificação técnica tem por objectivo documentar o Serviço de Registo de Prescrição de Medicamentos, o qual permite registar receitas médicas na Base de Dados Nacional de Prescrições (BDNP). Estas receitas deverão ter origem numa aplicação informática que disponibilize a funcionalidade de prescrição electrónica de medicamentos e tenha sido certificada pela ACSS. Página 5 de 31

6 2 Referências Esta especificação técnica contém referências, implícitas ou explícitas, a outras publicações. Essas referências serão indicadas ao longo do texto, sendo as publicações enumeradas a seguir. Só poderão ser consideradas eventuais emendas ou revisões de publicações referidas, com indicação de data, quando incorporadas em emenda ou revisão desta especificação técnica. No caso de publicações referidas sem indicação de data, considera-se a última edição da mesma, incluindo emendas. 2.1 Referências legais Despacho nº 3956/2010, de 4 de Março; Despacho n.º 7330/2003, de 15 de Abril; 2.2 Referências normativas ET.ACSS 19:2011 ACSS Plataforma de Integração. Modelo de dados canónico 2.3 Referências bibliográficas Página 6 de 31

7 3 Acrónimos, termos e definições 3.1 Acrónimos Sigla ACSS BDNP DTD WSDL XML Definição Administração Central do Sistema de Saúde, I.P. Base de Dados Nacional de Prescrições Data Type Definition Web Services Description Language extensible Markup Language Página 7 de 31

8 4 Especificação funcional 4.1 Requisitos de utilização do serviço As aplicações que disponibilizem a funcionalidade de prescrição electrónica de medicamentos deverão utilizar este serviço, de preferência on-line e no acto de prescrição médica, garantindo o envio da informação das receitas prescritas para a BDNP no momento da prescrição. Este requisito não é ainda de carácter obrigatório, no entanto sê-lo-á num futuro próximo, no âmbito do processo de desmaterialização da Receita de Medicamentos. O Sofware deverá estar preparado para garantir o envio das receitas que, por motivos técnicos ou por erro, não tenham tido sucesso no seu envio. Deverá ter a capacidade identificar as receitas que não foram enviadas com sucesso, e repetir o seu envio até ser ultrapassado o problema técnico (Problemas de comunicações, erro técnico devolvido pelo serviço, etc.). As receitas que sejam recepcionadas mas em que existe uma mensagem de aviso, deverão ser analisadas no sentido de ser realizado um diagnóstico e se apurar se estamos perante uma não conformidade da prescrição. 4.2 Retorno do serviço Sempre que o serviço devolva um erro ou esteja indisponível, é necessário reenviar a prescrição. O Software deverá assegurar esse reenvio até obter uma resposta de sucesso ou aviso. Caso a receita seja recepcionada mas o serviço retorne um aviso deverá o mesmo ser analisado para identificar a sua causa e corrigir o problema de forma a evitar avisos em situações futuras, nomeadamente: 1. Avisos relacionados com o Profissional: devem ser reportados à ACSS; significa que o profissional não é conhecido no sistema Central pelo que deverá ser notificado; 2. Avisos relacionados com o Local de Prescrição: devem ser reportados à ACSS; significa que o local de prescrição não é conhecido no sistema Central pelo que deverá ser notificado; 3. Avisos relacionados com o utente: caso a entidade financeira responsável seja o SNS, o software deve verificar se os dados do utente estão em conformidade com os disponibilizados pelo RNU (número de de utente, nome, data de nascimento), incluindo os benefícios relativos a Regime Especial de Comparticipação de Medicamentos. Nesta situação o utente deve possuir número de utente e deverá existir no RNU; 4. Avisos relacionados com o medicamento: a entidade deve verificar se a base de dados de medicamentos se encontra actualizada e se o medicamento prescrito é comercializado; 5. Avisos relacionados com a Não Conformidade com as regras de prescrição deverão ser analisados pela entidade de forma a garantir que está a cumprir as regras de prescrição e os requisitos identificados no processo de certificação para a Prescrição Electrónica de Medicamentos. Página 8 de 31

9 4.3 Fluxo de execução A figura seguinte apresenta, em alto nível, o fluxo de execução deste serviço. Receita Início Validar Entidade Entidade autorizada? Não Sim Fim AF0001 P0001 Pesquisar Utente # Registos <> 1 = 1 Receita válida? Não AF0000P0001 Receita Pendente Sim Legenda: Registar Receita Erro Aviso Fim Fim Sucesso Figura 1 Registo de Prescrição de Medicamentos O serviço de Registo de Prescrições tem 3 tipos de respostas possíveis: Sucesso, Aviso e Erro. O capítulo Especificação Técnica, deste documento, contém as «Tabelas de Referência de Mensagens de Retorno» que descrevem estas mensagens e respectivas acções a tomar. Página 9 de 31

10 4.4 Modelo de comunicação Os elementos constantes das tabelas abaixo têm cariz funcional e podem não representar a totalidade dos dados definidos nas mensagens expostas pelo serviço. O capítulo Especificação Técnica, deste documento, complementa esta informação Parâmetros de Entrada Elemento Tipo Descrição Receitas rpm:listareceitasbody Lista de Receitas ListaReceitasBody Elemento Tipo Descrição Receita er:receitatype Receita, de acordo com a ET.ACSS 19:2010 O objecto complexo MessageHeader, embora obrigatório na mensagem, nunca deverá ser preenchido. Toda a informação enviada neste objecto será ignorada pelo sistema, estando um possível preenchimento desta informação a cargo e responsabilidade da ACSS Retorno Elemento Tipo Descrição ListaResultados rpm: ListaReceitasBodyOutput Lista com os resultados do Registo de Prescrição de Medicamentos ListaReceitasBodyOutput Elemento Tipo Descrição ResultadoOperacao rpm:receitabodyoutput Resultado do Registo de Prescrição de Medicamentos ReceitaBodyOutput Elemento Tipo Descrição GenericCodeResult int:genericcodetype Código do resultado da invocação do serviço. Receita er:receitatype Receita, de acordo com a ET.ACSS 19:2010 Página 10 de 31

11 4.4.3 Falhas As mensagens de erro deste serviço são devolvidas no elemento GenericCodeResult. 4.5 Regras e validações Aplicam-se as seguintes regras e validações a este serviço: 1. A autenticação e autorização da entidade são validadas através do cabeçalho WS-Security, conforme descrito na Preferencialmente, o serviço deve ser invocado por receita, apesar de ter capacidade para receber uma lista de receitas. 3. O serviço permite inserir uma receita ou anular uma receita já existente no sistema. 4. O número de receita (NumeroReceita) é de preenchimento obrigatório. 5. A data da receita (Data) é de preenchimento obrigatório. 6. Para registar uma receita é necessário identificar o utente ao qual foi prescrita. Os dados mínimos que devem ser enviados para identificar o utente são os seguintes: a) Número do utente do Serviço Nacional de Saúde (NumeroSNS), caso o utente seja beneficiário do SNS; b) Nome do Utente (NomeCompleto); c) Data de Nascimento (DataNascimento) Notas: O nº de utente não é obrigatório se a entidade responsável não for o SNS; O nº de utente, caso esteja preenchido, é preferencial relativamente aos restantes dados, para efeitos de validação. 7. A entidade financeira responsável é de preenchimento obrigatório, de acordo com as seguintes regras: a) Utente do SNS (cidadão Português ou estrangeiro residente) que tenha número de utente atribuído e não seja beneficiário dum subsistema de saúde deve ser preenchida com o código do Serviço Nacional de Saúde, conforme descrito na 4.6, sendo igualmente obrigatório o preenchimento do número de beneficiário com o número de utente; b) Utente beneficiário de um subsistema de saúde (ex: ADSE) deve ser preenchida com o código do respectivo subsistema, conforme descrito na 4.6 e o respectivo número de beneficiário; c) Utente com doença profissional deve ser preenchida com o código do Centro Nacional de Riscos Profissionais, conforme descrito na 4.6 e o respectivo número de beneficiário; Página 11 de 31

12 d) Utente Migrante não abrangido pelo SNS (não residente) de acordo com as seguintes situações: i. Pertencentes ao EEE e Suíça (com Cartão Europeu de Seguro de Doença - CESD/EIHIC) ii. Deve ser preenchida com o código da entidade estrangeira responsável, conforme descrito na 4.6 e o respectivo número de beneficiário, bem como o número do CESD; Outros imigrantes Deve ser preenchida com o código correspondente, de acordo com o descrito na 4.6; e) Cidadão estrangeiro não abrangido pelas condições acima referidas deve ser preenchida com o código de Independente; não sendo necessário preencher o número de beneficiário. Neste caso, o utente não tem direito a comparticipação por parte do SNS. Nota: O preenchimento do número de beneficiário é obrigatório para todas as entidades financeiras responsáveis, excepto para «Independente». 8. O elemento Profissional é de preenchimento obrigatório. 9. Em todos os elementos do tipo ProfissionalType é obrigatório preencher o NumeroOrdem, de acordo com as tabelas de referência fornecidas pela ACSS. 10. O elemento LocalPrescricao é de preenchimento obrigatório. 11. O tipo de receita é de preenchimento obrigatório. Neste contexto, tipo de receita vincula o tipo de medicamentos ou produtos que podem constar nas linhas da respectiva receita, nomeadamente: a) Normal contém medicamentos de uso humano; b) Diabéticos contém produtos de auto-controlo da Diabetes Mellitus; c) Manipulados contém medicamentos manipulados; d) Dietético contém produtos dietéticos; e) Outros contém outros produtos; 12. A receita pode ser Renovável (S) ou não (N). Caso não seja renovável, o número de vias é 1, caso seja renovável, o número de vias pode variar entre 1 e Numa receita renovável, só podem ser prescritos medicamentos de uso humano da tabela 2 «Tratamentos prolongados» e produtos de auto-controlo da Diabetes Mellitus. 14. Os medicamentos manipulados, os produtos dietéticos e outros produtos não podem ser prescritos em receitas renováveis. 15. Em cada receita médica podem ser prescritos até quatro medicamentos distintos, com o limite máximo de quatro embalagens no total, sendo: a) Medicamentos que se apresentem em embalagens unitárias, até quatro embalagens; Página 12 de 31

13 b) Até duas embalagens para os restantes medicamentos. 16. É obrigatório enviar a seguinte informação relativa a custos de medicamentos: a) Valor total da receita; b) Valor total da comparticipação da receita; c) Valor total da linha da receita; d) Valor total da comparticipação da linha de receita. 17. O elemento SubstituivelGenerico deve estar preenchido do seguinte modo: a) S (Sim) o médico concorda com a substituição do medicamento por genérico; b) N (Não) o médico não concorda com a substituição do medicamento por genérico; c) Nulo (campo não preenchido) o médico não se pronunciou sobre a substituição de genérico. 18. Em todos os elementos do tipo MedicamentoType é obrigatório o preenchimento de um dos seguintes conjuntos de informação: a) Número de Registo (INFARMED) do medicamento (Codigo); b) Caso se trate de um medicamento manipulado, um produto dietético ou outro produto, o número de registo deverá ser preenchido com código e a informação desse mesmo medicamento deverá ser registada no campo descrição; c) Substância Activa (SubstanciaActiva), Forma Farmacêutica (FormaFarmaceutica), Embalagem (Embalagem), Dosagem (Dosagem) 19. Os produtos de auto-controlo da Diabetes Mellitus só podem ser prescritos por nome comercial. 20. O Regime Especial de Comparticipação de Medicamentos (RegimeComparticipacao) deve estar preenchido com S ou N, consoante o utente beneficie ou não deste regime. 21. O elemento Diploma deve ser preenchido com o Decreto-Lei que permite aceder ao regime especial de comparticipação de medicamentos. Este valor tem de estar de acordo com a informação proveniente do INFARMED (tabela DIPLOMA da base de dados de medicamentos disponibilizada pelo Infarmed - Diploma_id). 22. É possível anular uma receita, nas seguintes condições: a) Se o médico que pede a anulação for o mesmo que a prescreveu originalmente; b) Ainda não tenha sido anulada; c) Se passaram menos de 30 dias desde que foi prescrita. 23. Para anular uma receita é necessário enviar os seguintes dados: a) Número da receita a anular; Página 13 de 31

14 b) Dados do utente; c) Data de anulação; d) Motivo de anulação; e) Médico; f) Local de prescrição. 4.6 Entidades Financeiras Responsáveis, para efeitos de comparticipação de medicamentos Entidades nacionais Código Designação Abreviatura Direcção-Geral Protecção Social aos Funcionários e Agentes da Administração Pública ADSE Instituto Acção Social Forças Armadas IASFA Serviço Assistência Doença aos Militares da Guarda Nacional Republicana SAD GNR Serviço Assistência Doença - Polícia Segurança Pública SAD PSP SAD Municipal CM Lisboa SAD MUNICIPAL CM LISBOA SAD Municipal CM Porto SAD MUNICIPAL CM PORTO Serviço Assistência Doença - Serviço Estrangeiros e Fronteiras SAD SEF Serviço Assistência Médico-social Bancários Norte SAMS NORTE Serviço Assistência Médico-social Bancários Centro SAMS CENTRO Serviço Assistência Médico-social - Quadros Técnicos SAMS QUADROS TECNICOS Serviços Sociais Caixa Geral Depósitos SERVIÇOS SOCIAIS CGD Serviços Sociais Ministério Justiça SERVIÇOS SOCIAIS MJ Serviços Sociais Tap Air Portugal SERVIÇOS SOCIAIS TAP Serviços Sociais Telefones Lisboa e Porto SERVIÇOS SOCIAIS TLP Imprensa Nacional Casa Moeda INCM Radiodifusão Portuguesa RDP Administração Dos Portos Douro e Leixões APDL Administração do Porto de Lisboa APL Página 14 de 31

15 Código Designação Abreviatura Centro Nacional de Riscos Profissionais CNRP Serviço Nacional de Saúde SNS Independente Entidades estrangeiras EEE, Suíça e Andorra (parcialmente) As entidades dos países da União Europeia e Suíça (com CESD/EIHIC), e Andorra (parcialmente) encontram-se definidas em Outros imigrantes Para os migrantes dos países identificados na tabela abaixo, deverá ser utilizado o respectivo código de entidade. Código Designação Abreviatura Cidadãos evacuados dos PALOP Cidadãos evacuados de Angola Nacionais da Noruega, Dinamarca, Reino Unido, Brasil, Cabo Verde, Guiné-Bissau, província do Quebec e Andorra (neste último caso se os utentes apresentarem um atestado de direito diferente do AND/3) Outros beneficiários do Serviço Nacional de Saúde (nomeadamente cidadãos estrangeiros menores de idade não legalizados, que se encontram a residir em Portugal, DL 67/2004, de 25 de Março e as situações de excepção abrangidas pelo n.º 5 do Despacho nº 25360/2001 de 16 de Novembro) Página 15 de 31

16 5. Especificação técnica 5.1 Operações expostas Nesta secção são apresentadas as operações disponíveis no serviço initiateasync Executa o serviço de forma assíncrona Mensagens de Pedido (Input) Nome RegistoPrescricaoMedicamentosProcessRequest Tipo de Dados rpm: RegistoPrescricaoMedicamentosProcessRequest Type Mensagens de Resposta (Output) Nome RegistoPrescricaoMedicamentosProcessResponse Tipo de Dados rpm: RegistoPrescricaoMedicamentosProcessResponse Type Mensagens de Falha (Fault) errorasync Nome da Operação Tipo de Dados rpm: FaultVariableMessage initiatesync Executa o serviço de forma síncrona Mensagens de Pedido (Input) Nome RegistoPrescricaoMedicamentosProcessRequest Tipo de Dados rpm: RegistoPrescricaoMedicamentosProcessRequest Type Página 16 de 31

17 Mensagens de Resposta (Output) Nome RegistoPrescricaoMedicamentosProcessResponse Tipo de Dados rpm: RegistoPrescricaoMedicamentosProcessResponse Type Mensagens de Falha (Fault) Nome RegistoPrescricaoMedicamentosError Tipo de Dados rpm: FaultVariableMessage 5.2 Mensagens de retorno Estados e mensagens O serviço de Registo de Prescrições de Medicamentos tem 3 grandes tipos de mensagens de retorno. Identificam-se de seguida os estados possíveis para as mensagens retornadas pelo serviço: Estado Sucesso Erro Aviso Acção Receita registada/anulada com sucesso Solicita o reenvio da receita Aceita a receita e devolve código de código/informação incorrecta ou insuficiente Com o código de «Sucesso» é enviado também, na mensagem, o número da receita inserida ou anulada. Os valores possíveis para a mensagem são: Código Descrição Tipo Receita registada/anulada com sucesso Sucesso Operação não autorizada Erro Utente não encontrado Aviso Número da receita duplicado Aviso Receita renovável e número de vias inválido Aviso A entidade responsável não existe Aviso O médico não existe Aviso Página 17 de 31

18 Código Descrição Tipo O local de prescrição não existe Aviso Tipo de prescrição inválida Aviso Número de registo do medicamento não existe Aviso Substância activa não existe Aviso Forma terapêutica não existe Aviso Os dados do medicamento não estão correctos Aviso Quantidade inválida Aviso Decreto-Lei não existe Aviso A Receita não pode ser anulada - Número da receita ainda não existe Aviso A Receita não pode ser anulada - ultrapassou o prazo de 30 dias Aviso A Receita não pode ser anulada - médico diferente Aviso A Receita não pode ser anulada - disponibilizada na farmácia A Receita não pode ser anulada - motivo de anulação não existe Aviso A Receita não pode ser anulada - já se encontra anulada Aviso A Receita não pode ser anulada - o utente é diferente Aviso A Receita não pode ser anulada - não existe qualquer indicação de anulação Aviso Receita Renovável com medicamentos sem ser de longa duração Aviso Profissional não está preenchido Aviso Motivo de anulação não está preenchido Aviso Local de prescrição não está preenchido Aviso Número de Beneficiário obrigatório para esta entidade Aviso Tipo de Receita Inválido para o(s) medicamento(s) prescritos Aviso Erro de Não Conformidade com as Regras de Prescrição Aviso Erro na Informação do Profissional Aviso Erro na Informação do Local de Prescrição Aviso Erro na Informação do Medicamento Aviso Erro na Informação do Utente Aviso Erro Desconhecido Aviso Página 18 de 31

19 Código Descrição Tipo Erro Técnico Erro Com o código de erro, é enviado à entidade um número único (GUID) que deverá ser guardado para futura identificação desse mesmo pedido. Esse identificador é enviado na resposta, na seguinte localização: MessageHeader: RequestKey Reenvio de mensagens Existem apenas duas situações em que é necessário reenviar a mensagem, a saber: 1. Caso a mensagem retorne um código de erro, conforme 5.2.1; 2. Caso o serviço não responda ou responda com uma mensagem inválida. Ambas as situações requerem contacto com a ACSS para que seja possível resolver o problema e permitir o reenvio da receita a ser processada. Se o serviço retornar um aviso conforme 5.2.1, está garantido o registo de todas as mensagens enviadas, não sendo necessário o seu reenvio. Contudo, a ACSS deverá ser igualmente contactada de forma a que seja corrigido o erro que originou o aviso. 5.3 Informação operacional Endpoints Os endpoints deste serviço em ambiente de testes e produção, encontram-se nos seguintes endereços: Testes: Produção: WSDL Os WSDL deste serviço em ambiente de testes e produção encontram-se nos seguintes endereços: Testes: Produção: Página 19 de 31

20 5.3.3 Timeout O serviço estará configurado para fechar a ligação, retornando timeout ao fim de 30 segundos de tempo de invocação. Quando isto ocorre é necessário reenviar a mensagem. A autorização de reenvio está dependente de contacto prévio com a ACSS, por parte da entidade emissora, para esclarecimento da origem do timeout Segurança A ACSS fornece, à entidade, as credenciais de acesso ao serviço. Estas credenciais de acesso (login e password) devem ser incluídas no cabeçalho WS-Security ( do serviço, para que seja possível a autenticação e autorização da entidade invocadora no servidor LDAP da ACSS. 5.4 Estruturas de dados RegistoPrescricaoMedicamentosProcessRequestType Elemento Tipo Descrição MessageHeader int:messageheadertype Cabeçalho do Pedido o seu preenchimento é da responsabilidade da ACSS MessageBody rpm: RegistoPrescricaoMedicamentosMessageBody Corpo do Pedido RegistoPrescricaoMedicamentosMessageBody Elemento Tipo Descrição Receitas rpm:listareceitasbody Lista de Receitas ListaReceitasBody Elemento Tipo Descrição Receita er:receitatype Receita, de acordo com a ET.ACSS 19:2011 Página 20 de 31

21 5.4.4 RegistoPrescricaoMedicamentosProcessResponseType Elemento Tipo Descrição MessageHeader int:messageheadertype Cabeçalho do Pedido; a responsabilidade do seu preenchimento é da ACSS MessageBody rpm: RegistoPrescricaoMedicamentosMessageBodyOutput Corpo da Resposta RegistoPrescricaoMedicamentosMessageBodyOutput Elemento Tipo Descrição ListaResultados rpm: ListaReceitasBodyOutput Lista com os resultados do Registo de Prescrição de Medicamentos ListaReceitasBodyOutput Elemento Tipo Descrição ResultadoOperacao rpm:receitabodyoutput Resultado do Registo de Prescrição de Medicamentos ReceitaBodyOutput Elemento Tipo Descrição GenericCodeResult int:genericcodetype Código representativo do estado da invocação (Sucesso, Erro, etc.) Receita er:receitatype Receita, de acordo com a ET.ACSS 19:2011 Página 21 de 31

22 5.5 Representação gráfica das estruturas de dados RegistoPrescricaoMedicamentosProcessRequestType RegistoPrescricaoMedicamentosMessageBody ListaReceitasBody RegistoPrescricaoMedicamentosProcessResponseType RegistoPrescricaoMedicamentosMessageBodyOutput Página 22 de 31

23 5.5.6 ListaReceitasBodyOutput ReceitaBodyOutput 5.6 XML schema definition <?xml version="1.0" encoding="utf-8"?> <xsd:schema elementformdefault="qualified" xmlns:xsd=" xmlns:rpm=" xmlns:int=" xmlns:er=" targetnamespace=" <xsd:import schemalocation=" namespace=" <xsd:import schemalocation=" namespace=" <xsd:element name="registoprescricaomedicamentosprocessrequest" type="rpm:registoprescricaomedicamentosprocessrequesttype"/> <xsd:complextype name="registoprescricaomedicamentosprocessrequesttype"> <xsd:sequence> <xsd:element name="messageheader" type="int:messageheadertype" minoccurs="1" maxoccurs="1" nillable="true"/> <xsd:element name="messagebody" type="rpm:registoprescricaomedicamentosmessagebody" minoccurs="1" maxoccurs="1" nillable="true"/> </xsd:sequence> </xsd:complextype> Página 23 de 31

24 <xsd:complextype name="registoprescricaomedicamentosmessagebody"> <xsd:sequence> <xsd:element name="receitas" type="rpm:listareceitasbody" minoccurs="1" maxoccurs="1" nillable="false"/> </xsd:sequence> </xsd:complextype> <xsd:element name="registoprescricaomedicamentosprocessresponse" type="rpm:registoprescricaomedicamentosprocessresponsetype"/> <xsd:complextype name="registoprescricaomedicamentosprocessresponsetype"> <xsd:sequence minoccurs="1" maxoccurs="1"> <xsd:element name="messageheader" type="int:messageheadertype" minoccurs="1" maxoccurs="1" nillable="true"/> <xsd:element name="messagebody" type="rpm:registoprescricaomedicamentosmessagebodyoutput" minoccurs="1" maxoccurs="1" nillable="true"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="registoprescricaomedicamentosmessagebodyoutput"> <xsd:sequence> <xsd:element name="listaresultados" type="rpm:listareceitasbodyoutput" minoccurs="1" maxoccurs="1" nillable="false"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="listareceitasbody"> <xsd:sequence> <xsd:element name="receita" type="er:receitatype" minoccurs="0" maxoccurs="unbounded" nillable="false"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="listareceitasbodyoutput"> <xsd:sequence> <xsd:element name="resultadooperacao" type="rpm:receitabodyoutput" minoccurs="0" maxoccurs="unbounded" nillable="false"/> </xsd:sequence> </xsd:complextype> <xsd:complextype name="receitabodyoutput"> <xsd:sequence> <xsd:element name="genericcoderesult" type="int:genericcodetype" minoccurs="0" maxoccurs="1" nillable="false"/> Página 24 de 31

25 <xsd:element name="receita" type="er:receitatype" minoccurs="0" maxoccurs="1" nillable="false"/> </xsd:sequence> </xsd:complextype> <xsd:element name="resultadooperacao" type="rpm:receitabodyoutput"/> <xsd:element name="receita" type="er:receitatype"/> </xsd:schema> 5.7 Exemplos de invocação Anulação de receita <soap:envelope xmlns:soap=" <soap:header/> <soap:body> <ns2:registoprescricaomedicamentosprocessrequest xmlns:ns2=" <ns2:messageheader/> <ns2:messagebody> <ns2:receitas> <ns2:receita> <ns3:cabecalhoreceita xmlns:ns3=" <ns3:numeroreceita> </ns3:numeroreceita> <ns3:renovavel>n</ns3:renovavel> <ns3:numerovias>1</ns3:numerovias> <ns3:data> t10:49: :00</ns3:data> <ns3:valortotal>24.27</ns3:valortotal> <ns3:comparticipacao>15.1</ns3:comparticipacao> <ns3:utente> <ns4:identificacao xmlns:ns4=" <ns4:numerosns> </ns4:numerosns> <ns4:sexo>f</ns4:sexo> </ns4:identificacao> </ns3:utente> <ns3:subsistemaresponsavel> <ns4:entidade xmlns:ns4=" <ns6:codigoentidade xmlns:ns6=" <ns6:tipoentidade xmlns:ns6=" <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>enre</ns5:codigo> </ns5:tipo> Página 25 de 31

26 </ns6:tipoentidade> </ns4:entidade> <ns4:numerobeneficiario xmlns:ns4=" </ns3:subsistemaresponsavel> <ns3:regimecomparticipacao>n</ns3:regimecomparticipacao> <ns3:profissional> <ns7:listacarteiraprofissional xmlns:ns7=" <ns7:listanumeroordem> <ns7:numeroordem>20854</ns7:numeroordem> </ns7:listanumeroordem> </ns7:listacarteiraprofissional> </ns3:profissional> <ns3:localprescricao> <ns6:codigoentidade xmlns:ns6=" <ns6:tipoentidade xmlns:ns6=" <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>usau</ns5:codigo> </ns5:tipo> </ns6:tipoentidade> </ns3:localprescricao> <ns3:anulacao> <ns3:anulado>s</ns3:anulado> <ns3:dataanulacao> t00:00:00</ns3:dataanulacao> <ns3:motivoanulacao xmlns:ns7=" <ns7:codigo>4</ns7:codigo> <ns7:tipo> <ns7:codigo>arec</ns7:codigo> </ns7:tipo> </ns3:motivoanulacao> </ns3:anulacao> <ns3:tiporeceita> <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>trec</ns5:codigo> </ns5:tipo> </ns3:tiporeceita> </ns3:cabecalhoreceita> </ns2:receita> </ns2:receitas> Página 26 de 31

27 </ns2:messagebody> </ns2:registoprescricaomedicamentosprocessrequest> </soap:body> </soap:envelope> Registo de receita <soap:envelope xmlns:soap=" <soap:header/> <soap:body> <ns2:registoprescricaomedicamentosprocessrequest xmlns:ns2=" <ns2:messageheader> <ns2:messagebody> <ns2:receitas> <ns2:receita> <ns3:cabecalhoreceita xmlns:ns3=" <ns3:numeroreceita> </ns3:numeroreceita> <ns3:renovavel>n</ns3:renovavel> <ns3:numerovias>1</ns3:numerovias> <ns3:data> t10:49: :00</ns3:data> <ns3:valortotal>24.27</ns3:valortotal> <ns3:comparticipacao>15.1</ns3:comparticipacao> <ns3:utente> <ns4:identificacao xmlns:ns4=" <ns4:numerosns> </ns4:numerosns> <ns4:sexo>f</ns4:sexo> </ns4:identificacao> </ns3:utente> <ns3:subsistemaresponsavel> <ns4:entidade xmlns:ns4=" <ns6:codigoentidade xmlns:ns6=" <ns6:tipoentidade xmlns:ns6=" <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>enre</ns5:codigo> </ns5:tipo> </ns6:tipoentidade> </ns4:entidade> <ns4:numerobeneficiario xmlns:ns4=" </ns3:subsistemaresponsavel> <ns3:regimecomparticipacao>n</ns3:regimecomparticipacao> Página 27 de 31

28 <ns3:profissional> <ns7:listacarteiraprofissional xmlns:ns7=" <ns7:listanumeroordem> <ns7:numeroordem>20854</ns7:numeroordem> </ns7:listanumeroordem> </ns7:listacarteiraprofissional> </ns3:profissional> <ns3:localprescricao> <ns6:codigoentidade xmlns:ns6=" <ns6:tipoentidade xmlns:ns6=" <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>usau</ns5:codigo> </ns5:tipo> </ns6:tipoentidade> </ns3:localprescricao> <ns3:tiporeceita> <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>trec</ns5:codigo> </ns5:tipo> </ns3:tiporeceita> </ns3:cabecalhoreceita> <ns3:listalinhasreceita xmlns:ns3=" <ns3:linhareceita> <ns3:numerolinha>1</ns3:numerolinha> <ns3:medicamento> <ns3:codigo> </ns3:codigo> </ns3:medicamento> <ns3:substituivelgenerico>n</ns3:substituivelgenerico> <ns3:posologia> </ns3:posologia> <ns3:quantidade>2</ns3:quantidade> <ns3:precopvp>1.63</ns3:precopvp> <ns3:valorcomparticipacao>0.6</ns3:valorcomparticipacao> <ns3:dispensa>1</ns3:dispensa> </ns3:linhareceita> <ns3:linhareceita> <ns3:numerolinha>2</ns3:numerolinha> <ns3:medicamento> <ns3:codigo> </ns3:codigo> </ns3:medicamento> <ns3:substituivelgenerico>n</ns3:substituivelgenerico> Página 28 de 31

29 <ns3:posologia> </ns3:posologia> <ns3:quantidade>1</ns3:quantidade> <ns3:precopvp>21.01</ns3:precopvp> <ns3:valorcomparticipacao>14.5</ns3:valorcomparticipacao> <ns3:dispensa>1</ns3:dispensa> </ns3:linhareceita> </ns3:listalinhasreceita> </ns2:receita> </ns2:receitas> </ns2:messagebody> </ns2:registoprescricaomedicamentosprocessrequest> </soap:body> </soap:envelope> Registo de receita Migrante <soap:envelope xmlns:soap=" <soap:header/> <soap:body> <ns2:registoprescricaomedicamentosprocessrequest xmlns:ns2=" <ns2:messageheader> <ns2:messagebody> <ns2:receitas> <ns2:receita> <ns3:cabecalhoreceita xmlns:ns3=" <ns3:numeroreceita> </ns3:numeroreceita> <ns3:renovavel>n</ns3:renovavel> <ns3:numerovias>1</ns3:numerovias> <ns3:data> t10:49: :00</ns3:data> <ns3:valortotal>24.27</ns3:valortotal> <ns3:comparticipacao>15.1</ns3:comparticipacao> <ns3:utente> <ns4:identificacao xmlns:ns4=" <ns4:numerosns> </ns4:numerosns> <ns4:sexo>f</ns4:sexo> </ns4:identificacao> </ns3:utente> <ns3:subsistemaresponsavel xmlns:ns4=" <ns4:entidade xmlns:ns6=" <ns6:codigoantigo>43543</ns6:codigoantigo> <ns6:tipoentidade xmlns:ns7=" <ns7:codigo>entest</ns7:codigo> <ns7:tipo> <ns7:codigo>miga_insest</ns7:codigo> Página 29 de 31

30 </ns7:tipo> </ns6:tipoentidade> <ns6:endereco> <ns6:pais xmlns:ns5=" <ns5:codigo>gr</ns5:codigo> </ns6:pais> </ns6:endereco> </ns4:entidade> <ns4:numerobeneficiario>321321</ns4:numerobeneficiario> <ns4:tipocartao xmlns:ns5=" <ns5:codigo>37</ns5:codigo> </ns4:tipocartao> </ns3:subsistemaresponsavel> <ns3:regimecomparticipacao>n</ns3:regimecomparticipacao> <ns3:profissional> <ns7:listacarteiraprofissional xmlns:ns7=" <ns7:listanumeroordem> <ns7:numeroordem>20854</ns7:numeroordem> </ns7:listanumeroordem> </ns7:listacarteiraprofissional> </ns3:profissional> <ns3:localprescricao> <ns6:codigoentidade xmlns:ns6=" <ns6:tipoentidade xmlns:ns6=" <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>usau</ns5:codigo> </ns5:tipo> </ns6:tipoentidade> </ns3:localprescricao> <ns3:tiporeceita> <ns5:codigo xmlns:ns5=" <ns5:tipo xmlns:ns5=" <ns5:codigo>trec</ns5:codigo> </ns5:tipo> </ns3:tiporeceita> </ns3:cabecalhoreceita> <ns3:listalinhasreceita xmlns:ns3=" <ns3:linhareceita> <ns3:numerolinha>1</ns3:numerolinha> <ns3:medicamento> <ns3:codigo> </ns3:codigo> Página 30 de 31

31 </ns3:medicamento> <ns3:substituivelgenerico>n</ns3:substituivelgenerico> <ns3:posologia> </ns3:posologia> <ns3:quantidade>2</ns3:quantidade> <ns3:precopvp>1.63</ns3:precopvp> <ns3:valorcomparticipacao>0.6</ns3:valorcomparticipacao> <ns3:dispensa>1</ns3:dispensa> </ns3:linhareceita> <ns3:linhareceita> <ns3:numerolinha>2</ns3:numerolinha> <ns3:medicamento> <ns3:codigo> </ns3:codigo> </ns3:medicamento> <ns3:substituivelgenerico>n</ns3:substituivelgenerico> <ns3:posologia> </ns3:posologia> <ns3:quantidade>1</ns3:quantidade> <ns3:precopvp>21.01</ns3:precopvp> <ns3:valorcomparticipacao>14.5</ns3:valorcomparticipacao> <ns3:dispensa>1</ns3:dispensa> </ns3:linhareceita> </ns3:listalinhasreceita> </ns2:receita> </ns2:receitas> </ns2:messagebody> </ns2:registoprescricaomedicamentosprocessrequest> </soap:body> </soap:envelope> Página 31 de 31