1. Dirección URL Web Services CONSULTA Protocolo Usuario y contraseña de la capa de transporte... 3

Transcripción

1 Fecha de Publicación: 24/11/2016

2 INDICE 1. Dirección URL Web Services CONSULTA Protocolo Usuario y contraseña de la capa de transporte Capacidades Capacidad: getmedicamentosdispensados... 4 Acción... 4 Parámetros de Entrada... 4 Parámetros de Salida Web Services VALIDACIÓN... 6 Protocolo... 6 Capacidad: actualizamedicamentodispensado... 6 Acción... 6 Ejemplo de request Validación Tipos de Datos Compuestos medicamentodispensadoliviano Componentes y estructura medicamentosdispensadosresponse Componentes y estructura webserviceerror Componentes y estructura... 10

3 1. DIRECCIÓN URL Webservice del Sistema de Agentes de Seguro de Salud Consulta: Para visualizar el WSDL: Validación o Rechazo de transacciones: Entorno Web y Webservice de Entrenamiento: Web para Pruebas: Consulta: Validación: 2. WEB SERVICES CONSULTA Nombre WebService Descripción Interfaz general del servicio web PROTOCOLO Protocolos: HTTPS/SOAP 2.2. USUARIO Y CONTRASEÑA DE LA CAPA DE TRANSPORTE Usuario : testwservice Password : testwservicepsw (Es el mismo tanto para los entornos de Entrenamiento como de Producción) 3

4 <wsse:security xmlns:wsse=' <wsse:usernametoken xmlns:wsu=' <wsse:username>testwservice</wsse:username> <wsse:password>testwservicepsw</wsse:password> </wsse:usernametoken> </wsse:security> 2.3. CAPACIDADES Nombre getmedicamentosdispensados Descripción Devuelve el listado de las dispensas que se hicieron CAPACIDAD: GETMEDICAMENTOSDISPENSADOS Acción Este método permite consultar todas las dispensas de trazabilidad correspondientes al agente de salud (obra social, prepaga, etc..) del usuario logueado. Parámetros de Entrada Elemento Tipo Descripción Obligatorio usuario String Usuario del agente de salud SI password String Contraseña SI idtransaccion Long Id de la transacción de trazabilidad NO fechaeventodesde datetime Fecha evento de inicio para filtrar movimientos NO fechaeventohasta datetime Fecha evento de fin para filtrar movimientos NO fechatransacciondesde datetime Fecha transacción de inicio para filtrar movimientos NO fechatransaccionhasta datetime Fecha transacción de fin para filtrar movimientos NO idprovincia Long ID Provincia (ver set de datos de trazabilidad). NO 4

5 Elemento Tipo Descripción Obligatorio GTIN String GTIN Producto. NO lote String Número de lote. NO numeroserial String Número de serie. NO glnorigen String GLN/CUFE Agente Origen. NO nroafiliado Long Número de afiliado del paciente. NO tipodocumento Long ID Tipo Documento (ver set de datos de trazabilidad). NO nrodocumento String Número de Documento de la persona a la que se dispensó el medicamento. listestados Long Estado de transacción NO NO 1. Pendiente (valor inicial) 2. Validado 3. Rechazado nropagina Long Número de página (por defecto 1) NO offset Long Cantidad de registros por página (por defecto 100, máximo 1000). NO Parámetros de Salida Componente Tipo Descripción cantpaginas Long Cantidad de páginas totales que tiene la consulta realizada codigotransaccion String Código único de transacción. errores Lista de WebServiceError Lista de errores. Resultado boolean Indica si la operación fue exitosa o no. 5

6 Componente Tipo Descripción medicamentosdispensados medicamentosdispensadosliviano[] Lista de Medicamentos Dispensados 3. WEB SERVICES VALIDACIÓN PROTOCOLO Protocolos: HTTPS/SOAP Capacidad: actualizamedicamentodispensado Acción Este método permite realizar la actualización del estado de una transacción previamente consultada con el método de consulta. Los siguientes son los estados posibles, representados por valores numéricos que acepta el campo id_estado: 2 (validado) o 3 (rechazado). Parámetros de Entrada Elemento Tipo Descripción Obligatorio usuario String Usuario del agente de salud SI password String Contraseña SI idtransaccion Long Id de la transacción de trazabilidad SI id_estado Integer Id del estado a modificar SI 6

7 Ejemplo de request Consulta El siguiente request de ejemplo tiene todos los parámetros completos a modo de ejemplo: <soapenv:envelope xmlns:soapenv=" xmlns:bus=" <soapenv:header> <wsse:security xmlns:wsse=" <wsse:usernametoken xmlns:wsu=" <wsse:username>testwservice</wsse:username> <wsse:password>testwservicepsw</wsse:password> </wsse:usernametoken> </wsse:security> </soapenv:header> <soapenv:body> <bus:getmedicamentosdispensados> <usuario>user</usuario> <password>pass</password> <idtransaccion> </idtransaccion> <fechaeventodesde>30/04/2014</fechaeventodesde> <fechaeventohasta>30/04/2015</fechaeventohasta> <fechatransacciondesde>20/01/2015</fechatransacciondesde> <fechatransaccionhasta>20/04/2015</fechatransaccionhasta> <idprovincia>1</idprovincia> <GTIN> </GTIN> <lote>abc123</lote> <numeroserial>1234b</numeroserial> <glnorigen> </glnorigen> <nroafiliado>455354</nroafiliado> <tipodocumento>96</tipodocumento> <nrodocumento> </nrodocumento> <listestados>1</listestados> <listestados>2</listestados> <nropagina>1</nropagina> <offset>10</offset> </bus:getmedicamentosdispensados> </soapenv:body> </soapenv:envelope> 7

8 Ejemplo de request Validación El siguiente request de ejemplo tiene todos los parámetros completos a modo de ejemplo: <soapenv:envelope xmlns:soapenv=" xmlns:ns=" <soapenv:header/> <soapenv:body> <ns:actualizamedicamentodispensadorequest> <ns:usuario>user</ns:usuario> <ns:password>pass</ns:password> <ns:id_transaccion> </ns:id_transaccion> <ns:id_estado>2</ns:id_estado> </ns:actualizamedicamentodispensadorequest> </soapenv:body> </soapenv:envelope> 4. TIPOS DE DATOS COMPUESTOS Nombre medicamentodispensadoliviano medicamentosdispensadosresponse webserviceerror Descripción Datos correspondientes a una transacción. Parámetro de retorno que contiene el estado de la operación. Parámetro de retorno que contiene el error de la operación MEDICAMENTODISPENSADOLIVIANO COMPONENTES Y ESTRUCTURA Elemento Tipo Descripción agenteorigengln String GLN del agente que dispensó.. agenteorigenncuit String Cuit del agente que dispensó. agenteorigenrazonsocial String Razón Social del agente de origen. apellido String Apellido del paciente. 8

9 Elemento Tipo Descripción descripcionmedicamento String Descripción del medicamento dispensado. fechaevento datetime Fecha en que ocurrió el evento. Formato DD/MM/YYYY fechatransaccion datetime Fecha en que se informó la transacción. Formato DD/MM/YYYY GTIN String GTIN del producto. idestado Long ID Estado. idtransaccion Long ID Transacción. id_evento Long ID Evento. lote String Número de lote. nombres String Nombre del paciente. nroafiliado Long Número de afiliado a la obra social o prepaga, etc.. nrodocumento String Número de Documento del paciente numeroserial String Número de serie. oscrenos Long Código RNOS o similar del agente de salud. osrazonsocial String Razón social del agente informador. provinciadesc String Descripción de la provincia del agente informador de la dispensa. provinciaid Long ID provincia. razonsocial String Razón social del agente informador de la dispensa. tipodocumento Long Tipo de Documento del paciente. 9

10 4.2. MEDICAMENTOSDISPENSADOSRESPONSE COMPONENTES Y ESTRUCTURA Componente Tipo Descripción return boolean Resultado de la transacción. codigotransaccion string Código único de transacción. errores anytype Detalle de errores detectados. medicamentosdispensados medicamentosdispensadosliviano[] Lista de Medicamentos Dispensados CantPaginas Long Cantidad de páginas WEBSERVICEERROR COMPONENTES Y ESTRUCTURA Componente Tipo Descripción _c_error string Código del error. _d_error string Detalle del error. 10