Formato Farmacias XML
Sumario
- 1 Formato de Archivos
- 2 Recetas Electrónicas
- 3 Procedimiento de Envío de una Transacción
- 4 Presentación de Recetas para Liquidación de la Obra Social
- 5 Formato XML para Liquidación
- 6 Testing
- 7 Mensajes de Prueba
- 7.1 Solicitud de Autorización de Receta para el afiliado de prueba y Prestador de Prueba
- 7.2 Consulta de Cierre para una Farmacia de Prueba
- 7.3 Transacción de exclusión de Ticket 50179
- 7.4 Transacción de inclusión Ticket 50179
- 7.5 Cerrar Lote FarmaSur Sucursal 6
- 7.6 Solicitud de Anulación de Receta 999999
- 7.7 Consulta o Reimpresión de Ticket 50179
- 8 Impresión de un Ticket
Formato de Archivos
El formato descripto a continuación corresponde a una versión ajustada del mensaje ADESFA. El mismo permite la realización de dos tipos de transacciones u operación, la Autorización o Solicitud de Autorización para la dispensa de un medicamento y la Anulación de una autorización otorgada. Los campos están identificados por requeridos para cada una de estas dos operaciones de la siguiente manera. El campo Mensaje, dice AMB en el caso de que sea necesario para ambos mensajes, AUT en el caso de una Autorización o CAN en el caso de una anulación.
Nro | Nivel | Mensaje | Dirección | Tag | Descripción | Valor/es | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 0 | AMB | AMB | MensajeADESFA | MensajeADESFA Version=2.0 | |||||||||||||||||||||||||
2 | 1 | AMB | AMB | EncabezadoMensaje | ||||||||||||||||||||||||||
3 | 2 | AMB | IDA | Telefono | Número telefónico desde el cual se realiza la transacción. | |||||||||||||||||||||||||
4 | 2 | AMB | IDA | Latitud | ||||||||||||||||||||||||||
5 | 2 | AMB | IDA | Longitud | ||||||||||||||||||||||||||
6 | 2 | AMB | VUE | Rta | Respuesta | |||||||||||||||||||||||||
7 | 3 | AMB | VUE | CodRtaGeneral | Código de rechazo, cualquier valor distinto de cero es un "rechazo" | Valores: 00 (Aprobado) (Ver códigos de rechazo) | ||||||||||||||||||||||||
8 | 3 | AMB | VUE | Descripcion | Descripción | |||||||||||||||||||||||||
9 | 3 | AMB | VUE | Mensaje | Mensaje | |||||||||||||||||||||||||
10 | 3 | AMB | VUE | CodigoBarras | Información sobre la respuesta emitida por el Financiador para imprimir en el ticket en un código de barras de tipo Code 128 o Code 39 full ASCII. Ejemplo: 20150510IT4433550 (ver más). | |||||||||||||||||||||||||
11 | 3 | AMB | VUE | CodigoQR | Información sobre la respuesta emitida por el Financiador para imprimir en el ticket en un código QR (de dos dimensiones). - Nota: Por el momento se envía sin información. - Ejemplo: T2393939222931119922292929292922222112134342320000000004232 (ver más). | |||||||||||||||||||||||||
12 | 2 | AMB | VUE/IDA | NroReferencia | Número de transacción o referencia, que acompaña a esta solicitud (por ejemplo en la IDA debe ir aquí el número de transacción que quiere anular). | |||||||||||||||||||||||||
13 | 2 | CAN | VUE/IDA | FechaReferencia | Fecha correspondiente al Número de transacción o referencia, que acompaña a esta solicitud. (por ejemplo en la IDA debe ir aquí la fecha correspondiente al número de transacción que quiere anular). | |||||||||||||||||||||||||
14 | 2 | AMB | VUE | NroReferenciaCancel | Se devuelve aquí el número de la transacción que se solicitó anular. En la ida se envía el número a anular en <NroReferencia> | |||||||||||||||||||||||||
15 | 2 | AMB | AMB | TipoMsj | Directa o reversa (MESSAGE TYPE PROCESSING CODE iso8583) | Transacción normal: 200 (para la ida) y 210 (vendrá en la respuesta) Reversa o roll-back: 400/410 (ida/respuesta) (es distinta a una transacción de anulación) | ||||||||||||||||||||||||
16 | 2 | AMB | AMB | CodAccion | Código de acción o función del mensaje o tipo de transacción | 290020 (Solicitud de autorización) 020010 (Cancelación) 400000 (Verificación afiliado (únicamente)) 30000 (Consulta de Receta ya Autorizada o Reimpresión de Ticket. Si no envía <NroReferencia> esa una nueva consulta de ticket que no quedará registrada en la cuenta corriente) 290021 (Solicitud de autorización diferida. Debe enviar nodo <Dispensa> donde consta fecha y hora de dispensa) 490120 (Consulta de Receta Electrónica. Debe enviar nodo <Formulario> identificando la receta) | ||||||||||||||||||||||||
17 | 2 | AMB | AMB | IdMsj | Identificación del mensaje, número secuencial colocado por la farmacia | Entero de 8 posiciones, luego reinicia. | ||||||||||||||||||||||||
18 | 2 | AMB | AMB | InicioTrx | Fecha de generación del mensaje | |||||||||||||||||||||||||
19 | 3 | AMB | AMB | Fecha | AAAAMMDD | |||||||||||||||||||||||||
20 | 3 | AMB | AMB | Hora | HHMMSS | |||||||||||||||||||||||||
21 | 2 | AMB | AMB | Terminal | Terminal que genera el mensaje | |||||||||||||||||||||||||
22 | 3 | AMB | AMB | Tipo | Tipos de terminal: PC, IVR ó POS | PC | ||||||||||||||||||||||||
23 | 3 | AMB | AMB | Numero | Número de terminal, identificación propia que utilice el sistema de gestión | |||||||||||||||||||||||||
24 | 2 | AMB | IDA | Software | ||||||||||||||||||||||||||
25 | 3 | AMB | IDA | Nombre | Nombre del sistema de gestión. Es descriptivo lo establece el sistema de gestión. Algunas parametrizaciones especiales para cada sistema, por ejemplo la posibilidad de enviar un ticket corto en <MensajePrinter> depende del valor de este campo. | |||||||||||||||||||||||||
26 | 3 | AMB | IDA | Version | Versión del sistema de gestión. Es descriptivo lo establece el sistema de gestión. | |||||||||||||||||||||||||
27 | 2 | AMB | AMB | Prestador | Identificación de la farmacia | |||||||||||||||||||||||||
28 | 3 | AMB | AMB | Cuit | Sin guiones, corresponde al CUIT habilitado utilizado para facturarle a la Obra Social/Prepaga/Mandataria | |||||||||||||||||||||||||
29 | 3 | AMB | AMB | Sucursal | Identificación propia utilizada por la cadena. Lo define cada cadena pero es imprescindible que nos lo comunique puesto que usando el Web Service se utiliza para determinar la licencia que finalmente se asocia a la transacción | ENTERO(4) | ||||||||||||||||||||||||
30 | 3 | AMB | VUE | RazonSocial | Razón social | VARCHAR(100) | ||||||||||||||||||||||||
31 | 3 | AMB | VUE | Direccion | Dirección donde se encuentra la sucursal | |||||||||||||||||||||||||
32 | 3 | AMB | VUE | CodParaFinanciador | Código que el Financiador le asigna a la farmacia, es el código de proveedor. | |||||||||||||||||||||||||
33 | 1 | AMB | AMB | EncabezadoReceta | ||||||||||||||||||||||||||
34 | 2 | AMB | VUE | Marcada | Marca de inclusión/exclusión. | S (Si), N (No). Determina si la transacción (receta) está incluida en un lote (S) o no (N). | ||||||||||||||||||||||||
35 | 2 | AUT | AMB | Prescriptor | Profesional (Médico; Odontólogo) | |||||||||||||||||||||||||
36 | 3 | AUT | AMB | Apellido | Apellido del médico | |||||||||||||||||||||||||
37 | 3 | AUT | AMB | Nombre | Nombre del médico | |||||||||||||||||||||||||
38 | 3 | AUT | AMB | TipoMatricula | Tipo de Matrícula: Nacional; Provincial | N(Nacional), P (Provincial) | ||||||||||||||||||||||||
39 | 3 | AUT | AMB | Provincia | Provincia | Se utilizará los códigos de patentes viejas | ||||||||||||||||||||||||
40 | 3 | AUT | AMB | NroMatricula | Número de Matrícula | |||||||||||||||||||||||||
41 | 3 | AUT | AMB | TipoPrescriptor | Tipo Prescriptor | M (Médico), O (Odontólogo) | ||||||||||||||||||||||||
42 | 3 | AUT | AMB | Cuit | CUIT del médico prescriptor | |||||||||||||||||||||||||
43 | 3 | AUT | AMB | Especialidad | Especialidad del médico | |||||||||||||||||||||||||
44 | 2 | AMB | AMB | Beneficiario | Beneficiario | |||||||||||||||||||||||||
45 | 3 | AMB | VUE | Apellido | Apellido del afiliado | |||||||||||||||||||||||||
46 | 3 | AMB | VUE | Nombre | Nombre del afiliado | |||||||||||||||||||||||||
47 | 3 | AMB | VUE | Sexo | Sexo | M (Másculino), F (Femenino) | ||||||||||||||||||||||||
48 | 3 | AMB | VUE | FechaNacimiento | Fecha de Nacimiento | AAAAMMDD | ||||||||||||||||||||||||
49 | 3 | AMB | VUE | Tipo | Devuelve la condición frente al IVA del beneficiario | Valores: IVA Exento, IVA Gravado | ||||||||||||||||||||||||
50 | 3 | AMB | IDA | TipoDocumento | Tipo de Documento del Afiliado | Ver tabla Tipos de Documento | ||||||||||||||||||||||||
51 | 3 | AMB | IDA | NroDocumento | Numero de Documento del Afiliado | |||||||||||||||||||||||||
52 | 2 | AMB | AMB | Financiador | Financiador | |||||||||||||||||||||||||
53 | 3 | AMB | AMB | Cuit | (sin guiones). Ver valores. | |||||||||||||||||||||||||
54 | 3 | AMB | AMB | Codigo | Corresponde al Código del Financiador para el Prestador. Actualmente se utiliza para indicar los Planes Especiales. Ver el modo de Funcionamiento | |||||||||||||||||||||||||
55 | 2 | AMB | AMB | Credencial | ||||||||||||||||||||||||||
56 | 3 | AMB | AMB | Numero | Para mandar la credencial cuando el ingreso es solo manual es preferible utilizar el tag Track para el cual es indistinto como haya sido el ingreso. En este campo siempre es devuelta la credencial parseada. | |||||||||||||||||||||||||
57 | 3 | AMB | IDA | Track | Es necesario enviar todo lo que informa el lector (1 a “n” Tracks ). Es posible utilizar el TAG <Numero> para mandar la credencial cuando el ingreso es sólo manual, pero con <Track> es indistinto como haya sido el ingreso. Es detectado automáticamente. | Es necesario sustituir los caracteres especiales, que son propietarios de la definición del XML y que pueden venir magnétizados en la banda, por una letra o espacio, estos son:
| ||||||||||||||||||||||||
58 | 3 | AMB | IDA | CSC | Código de Seguridad de la Credencial | Para el caso de OSDE, se exige el envío del Código de Seguridad de la Credencial, que se encuentra en el anverso y/o reverso de la misma para verificar su presencia. Ejemplo: 012. | ||||||||||||||||||||||||
59 | 3 | AMB | VUE | Vencimiento | Vencimiento | AAAAMMDD | ||||||||||||||||||||||||
60 | 3 | AMB | IDA | ModoIngreso | Indica como fue ingresada la credencial | A (Manual), B (Banda Magnética), C (Chip/Smart Card), R (Código de Barra), Q (Código QR) o N (NFC/Proximidad) | ||||||||||||||||||||||||
61 | 3 | AMB | VUE | Plan | Plan | |||||||||||||||||||||||||
62 | 2 | AUT | AMB | CoberturaEspecial | Indica si el afiliado tiene alguna cobertura especial que afecte la dispensa de medicamentos. | Valores: PMI, CRONICO | ||||||||||||||||||||||||
63 | 2 | AUT | AMB | FechaReceta | Fecha de prescripción de la receta | AAAAMMDD | ||||||||||||||||||||||||
64 | 2 | AUT | IDA | Dispensa | Fecha en la que se realizó la venta | |||||||||||||||||||||||||
65 | 3 | AUT | IDA | Fecha | Fecha | AAAAMMDD | ||||||||||||||||||||||||
66 | 3 | AUT | IDA | Hora | Hora | HHMMSS | ||||||||||||||||||||||||
67 | 2 | AUT | IDA | Formulario | Formulario/recetario | |||||||||||||||||||||||||
68 | 3 | AUT | IDA | Fecha | Fecha de emisión | AAAAMMDD | ||||||||||||||||||||||||
69 | 3 | AUT | IDA | Tipo | Tipo de formulario/recetario | Recetario: 1 Normal, 2 Tratamiento Prolongado, 3 Autorización Especial, 4 Plan Materno Infantil, 5 Crónico, 6 Plan Materno Infantil y Crónico | ||||||||||||||||||||||||
70 | 3 | AUT | IDA | Numero | Número de formulario/recetario | Enviar el número de la receta o prescripción electrónica. | ||||||||||||||||||||||||
71 | 3 | AUT | IDA | Serie | Serie del formulario/recetario | |||||||||||||||||||||||||
72 | 2 | AUT | IDA | Diagnostico | Se envía el diagnóstico que venga descripto en la receta. Para ADESFA el diagnóstico es texto libre. Aquí puede enviar la descripción o el código de nomenclador ya sea ICD-9/CIE-9, CIE-10 o DSM-IV para psicopatología. | VARCHAR(50) | ||||||||||||||||||||||||
73 | 2 | AMB | VUE | RtaAdicional | Indica respuestas adicionales para enviar varias en el mismo mensaje | |||||||||||||||||||||||||
74 | 3 | AMB | VUE | Linea | En el caso de que haya más de uno | |||||||||||||||||||||||||
75 | 4 | AMB | VUE | Codigo | ||||||||||||||||||||||||||
76 | 4 | AMB | VUE | Mensaje | ||||||||||||||||||||||||||
77 | 1 | AMB | AMB | DetalleReceta | ||||||||||||||||||||||||||
78 | 2 | AMB | AMB | Item | ||||||||||||||||||||||||||
79 | 3 | AMB | AMB | NroItem | Número de línea del detalle. Se van enumerando secuencialmente. | Ejemplo: 1 | ||||||||||||||||||||||||
80 | 3 | AMB | IDA | NroGTIN | Numero GTIN para Trazabilidad | |||||||||||||||||||||||||
81 | 3 | AMB | IDA | NroSerie | Numero de serie para Trazabilidad | |||||||||||||||||||||||||
82 | 3 | AMB | IDA | FechaVencimiento | Fecha de Vencimiento de Trazabilidad | |||||||||||||||||||||||||
83 | 3 | AMB | IDA | Lote | Lote de Trazabilidad | |||||||||||||||||||||||||
84 | 3 | CAN | AMB | CodAutOri | Código de autorización de Origen. Para la cancelación debe enviarse en NroReferencia la transacción a ANULAR. Los financiadores actuales no manejan Cancelación Parcial y la transacción de devolución de medicamentos no está planteada en el formato ADESFA. | |||||||||||||||||||||||||
85 | 3 | AMB | AMB | CodBarras | Código de Barras del medicamento solicitado | |||||||||||||||||||||||||
86 | 3 | AMB | AMB | CodTroquel | Código de Troquel | |||||||||||||||||||||||||
87 | 3 | AMB | AMB | Alfabeta | Código AlfaBeta o Número de Registro. | |||||||||||||||||||||||||
88 | 3 | AMB | AMB | Kairos | Código Kairos | |||||||||||||||||||||||||
89 | 3 | AMB | AMB | Codigo | Código Alternativo a los anteriores | |||||||||||||||||||||||||
90 | 3 | AUT | VUE | Descripcion | Nombre de la presentación comercial del medicamento | |||||||||||||||||||||||||
91 | 3 | AMB | VUE | CodRta | Código de Respuesta | |||||||||||||||||||||||||
92 | 3 | AMB | VUE | MensajeRta | Mensaje de Respuesta | |||||||||||||||||||||||||
93 | 3 | AMB | VUE | CodAutorizacion | Código de Autorización asignado por el financiador. Es el número de ticket. | |||||||||||||||||||||||||
94 | 3 | AUT | AMB | CantidadSolicitada | Cantidad Solicitada | Entero (3). Ejemplo: 01 | ||||||||||||||||||||||||
95 | 3 | AUT | VUE | CantidadAprobada | Cantidad aprobada por el financiador. | Entero (3). Ejemplo: 01 | ||||||||||||||||||||||||
96 | 3 | AUT | AMB | PorcentajeCobertura | Porcentaje de Cobertura. Dos valores decimales. | Numérico (5). Por ejemplo para 100%: 100.00 | ||||||||||||||||||||||||
97 | 3 | AUT | IDA | CodPreautorizacion | Código de PreAutorización Item. Es una autorización que puede llevar el afiliado a la farmacia. No lo usamos en la validación en línea todas las autorizaciones las emite el financiador, son rescatadas automáticamente del sistema en línea. | |||||||||||||||||||||||||
98 | 3 | AMB | VUE | ImporteUnitario | Importe Unitario sin descuento. Se usa punto decimal y dos lugares decimales. | Numérico (10). Ej: 4.00 | ||||||||||||||||||||||||
99 | 3 | AUT | VUE | ImporteACargoAfiliado | Importe unitario a cargo del Afiliado. Cuanto debe pagar. | Numérico (10). Ej: 2.60 | ||||||||||||||||||||||||
100 | 3 | AUT | AMB | ImporteCobertura | Importe unitario cubierto por el financiador. | Numérico (10). Ej: 1.40 | ||||||||||||||||||||||||
101 | 3 | AUT | IDA | Diagnostico | Se envía el diagnóstico que venga descripto para el medicamento señalado en la receta. Para ADESFA el diagnóstico es texto libre. Aquí puede enviar la descripción o el código de nomenclador ya sea ICD-9/CIE-9, CIE-10 o DSM-IV para psicopatología. | VARCHAR(50) | ||||||||||||||||||||||||
102 | 3 | AUT | AMB | Generico | Si se prescribió: genérico, genérico con recomendación, marca o marca con justificación médica. | G (Genérico), R (Genérico con Recomendación), M (Marca), J (Marca con Justificación) |
Tipo Documento
DNI | Documento Nacional de Identidad |
CI | Cédula de Identidad (Policía Federal) |
LE | Libreta de Enrolamiento |
LC | Libreta Cívica |
PAS | Pasaporte |
DNE | Documento Nacional de Extranjería |
CE | Cédula de Extranjería |
SD | Sin Documento |
Recetas Electrónicas
La siguiente transacción permite rescatar los datos de una prescripción electrónica o digital existente en el repositorio del financiador al que se le hace el requerimiento, indicando los datos del paciente (<Credencial> y se aconseja enviar <NroDoc>) y el localizador de receta provisto por este (<Formulario> y <Numero>).
Consulta de Receta Electrónica Envío
Identificada con el CodAccion:490120
Tag | Descripción Consulta de Receta Electrónica | Tipo | Detalles | Tag Req. | Valor Req. | Modif. |
---|---|---|---|---|---|---|
<?xml version="1.0" encoding="ISO-8859-1"?> | Transcribir textualmente, enuncia documento XML. | R | ||||
<MensajeADESFA version="3.1.0"> | Transcribir textualmente | R | ||||
<EncabezadoMensaje> | Datos del Encabezado del Mensaje | R | ||||
<TipoMsj> | Directa (MESSAGE TYPE PROCESSING CODE) | NUM(3) | Transcribir textualmente: 200 (Ida) | R | R | |
<CodAccion> | Código de Acción del Mensaje | NUM(6) | Transcribir textualmente : 490120 (Consulta de Receta Electrónica) | R | R | |
<IdMsj> | Identificación del Mensaje | NUM(8) | Número secuencial y ascendente de hasta 8 dígitos | R | R | |
<InicioTrx> | Datos de Inicio de la Transacción | R | ||||
<Fecha> | Fecha de Generación del Mensaje | DATE | aaaammdd | R | R | |
<Hora> | Hora de Generación del Mensaje | TIME | hhmmss | R | R | |
</InicioTrx> | R | |||||
<Software> | Datos del Software que genera el Mensaje | R | ||||
<CodigoADESFA> | Código según ADESFA | NUM(20) | Según Tabla Softwares | R | R | |
<Nombre> | Nombre del Software | VARCHAR(20) | N | |||
<Version> | Versión del Software | VARCHAR(30) | N | |||
</Software> | R | |||||
<Validador> | Datos del Validador que procesa el Mensaje | R | ||||
<CodigoADESFA> | Código según ADESFA | NUM(20) | Código del Validador que debe dar respuesta a esta Transacción. Según Tabla Validadores | R | R | |
<Nombre> | Nombre del Validador | VARCHAR(20) | N | |||
</Validador> | R | |||||
<Prestador> | Datos del Prestador | Ej.: Farmacia, Hospital, etc. | R | |||
<CodigoADESFA> | Código según ADESFA | NUM(20) | Según Tabla Prestadores | N | ||
<Cuit> | CUIT del Prestador | NUM(11) | R | R | ||
<Sucursal> | Sucursal del Prestador | NUM(4) | N | |||
<RazonSocial> | Razón Social del Prestador | VARCHAR(100) | N | |||
<Codigo> | Código del Prestador | VARCHAR(20) | Código del Prestador según el Validador | R | R | |
<Vendedor> | Operador de la Venta | VARCHAR(10) | N | |||
</Prestador> | R | |||||
</EncabezadoMensaje> | R | |||||
<EncabezadoReceta> | Datos del Encabezado de la Receta | R | ||||
<Financiador> | Datos del Financiador de la Cobertura | R | ||||
<CodigoADESFA> | Código según ADESFA | NUM(20) | Según Tabla Financiadores | N | ||
<Codigo> | Código de Identificación del Financiador | VARCHAR(15) | Según el Validador | R | R | |
<Cuit> | CUIT del Financiador | NUM(11) | N | |||
<Sucursal> | Sucursal del Financiador | NUM(4) | N | |||
</Financiador> | R | |||||
<Credencial> | Datos de la Credencial del Beneficiario | R | ||||
<Numero> | Número de Beneficiario | VARCHAR(20) | R | N | ||
<Track> | Track de la Credencial | VARCHAR(200) | Todo lo informado por el lector (1 a n Tracks) embebidos dentro de una sección CDATA | N | ||
<Version> | Versión de la Credencial | VARCHAR(2) | N | |||
<Vencimiento> | Vencimiento de la Credencial | DATE | aaaammdd | N | ||
<ModoIngreso> | Modo de Ingreso de la Credencial | CHAR() | A = Manual / B = Banda Magnética / L = Laser | N | ||
<EsProvisorio> | Indica si la Credencial es Provisoria | CHAR() | N = Normal / P = Provisoria | N | ||
<Plan> | Plan asociado a la Credencial | VARCHAR(20) | Depende de la Cobertura | N | ||
<cvc2> | Dígitos de Validación ingresados manualmente | VARCHAR(10) | N | |||
</Credencial> | R | |||||
<Formulario> | Datos del Formulario / Recetario | R | ||||
<Fecha> | Fecha de Emisión / Vencimiento | DATE | aaaammdd | N | ||
<Tipo> | Tipo de Formulario / Recetario | VARCHAR(3) | N | |||
<Numero> | Número de Formulario / Recetario | NUM(15) | R | R | ||
<Serie> | Serie del Formulario / Recetario | VARCHAR(3) | N | |||
<NroAutEspecial> | Código otorgado por la Entidad | VARCHAR(20) | N | |||
<NroFormulario> | Código otorgado por la Entidad | VARCHAR(20) | N | |||
</Formulario> | R | |||||
</EncabezadoReceta> | R | |||||
</MensajeADESFA> | R |
Respuesta a Consulta de Receta Electrónica
Tag | Descripción Respuesta a Consulta de Receta Electrónica | Tipo | Detalles | Tag Req. | Valor Req. | Modif |
---|---|---|---|---|---|---|
<?xml version="1.0" encoding="ISO-8859-1"?> | Transcribir textualmente, enuncia documento XML. | R | ||||
<MensajeADESFA version="3.1.0"> | Transcribir textualmente | R | ||||
<EncabezadoMensaje> | Datos del Encabezado del Mensaje | R | ||||
<Rta> | Datos de la Respuesta al Mensaje | R | ||||
<CodRtaGeneral> | Código de Respuesta General | VARCHAR(10) | 0 indica Transacción Aprobada Cualquier Valor distinto de 0 indica Transacción No Aprobada | R | R | |
<Descripcion> | Descripción asociada al Código de Respuesta General | VARCHAR(32) | R | R | ||
<Mensaje> | Mensaje asociado al Código de Respuesta General | VARCHAR(255) | N | |||
</Rta> | Datos de la Respuesta al Mensaje | R | ||||
<NroReferencia> | Número de Referencia en Respuesta a la Solicitud de Autorización | VARCHAR(20) | R | N | ||
<TipoMsj> | Directa (MESSAGE TYPE PROCESSING CODE) | NUM(3) | Transcribir textualmente: 210 (Rta) | R | R | |
<CodAccion> | Código de Acción del Mensaje | NUM(6) | Transcribir textualmente : 490120 (Consulta de Receta Electrónica) | R | R | |
<IdMsj> | Identificación del Mensaje | NUM(8) | Número secuencial y ascendente de hasta 8 dígitos | R | R | |
<InicioTrx> | Datos de Inicio de la Transacción | R | ||||
<Fecha> | Fecha de Generación del Mensaje | DATE | aaaammdd | R | R | |
<Hora> | Hora de Generación del Mensaje | TIME | hhmmss | R | R | |
</InicioTrx> | R | |||||
<Prestador> | Datos del Prestador | R | ||||
<CodigoADESFA> | Código según ADESFA | NUM(20) | Según Tabla Prestadores | N | ||
<Cuit> | CUIT del Prestador | NUM(11) | R | R | ||
<Sucursal> | Sucursal del Prestador | NUM(4) | N | |||
<RazonSocial> | Razón Social del Prestador | VARCHAR(100) | N | |||
<Codigo> | Código del Prestador | VARCHAR(20) | Código del Prestador según el Validador | R | R | |
</Prestador> | R | |||||
</EncabezadoMensaje> | R | |||||
<EncabezadoReceta> | Datos del Encabezado de la Receta | R | ||||
<Prescriptor> | Datos del Prescriptor | N | ||||
<Apellido> | Apellido del Prescriptor | VARCHAR(100) | N | |||
<Nombre> | Nombre del Prescriptor | VARCHAR(100) | N | |||
<TipoMatricula> | Tipo de Matrícula del Prescriptor | CHAR() | N = Nacional / P = Provincial | R | N | |
<Provincia> | Código de Provincia de la Matrícula del Prescriptor | CHAR() | Según Tabla Códigos de Provincias | R | N | |
<NroMatricula> | Número de Matrícula del Prescriptor | NUM(8) | R | N | ||
<TipoPrescriptor> | Tipo de Prescriptor | CHAR() | M = Médico / O = Odontólogo / P = Psiquiatra | R | N | |
<Cuit> | CUIT del Prescriptor | NUM(11) | N | |||
<Especialidad> | Especialidad del Prescriptor | VARCHAR(100) | N | |||
</Prescriptor> | N | |||||
<Beneficiario> | Datos del Beneficiario | N | ||||
<TipoDoc> | Tipo de Documento del Beneficiario | VARCHAR(4) | Según Tabla Códigos de Documentos | N | ||
<NroDoc> | Número de Documento del Beneficiario | NUM(15) | N | |||
<Apellido> | Apellido del Beneficiario | VARCHAR(100) | N | |||
<Nombre> | Nombre del Beneficiario | VARCHAR(100) | N | |||
<Sexo> | Sexo del Beneficiario | CHAR() | M = Masculino / F = Femenino | N | ||
<FechaNacimiento> | Fecha de Nacimiento del Beneficiario | DATE | aaaammdd | N | ||
<Parentesco> | Relación con el Titular de la Cobertura (Hijo, Cónyuge, etc.) | VARCHAR(2) | Según Tabla Códigos de Parentescos | N | ||
<EdadUnidad> | Unidad en la que se expresa la Edad del Beneficiario | CHAR() | D = Días / M = Meses / A = Años | N | ||
<Edad> | Edad del Beneficiario | NUM(3) | Días[1..365] – Meses[1..11] – Años[1..999] | N | ||
</Beneficiario> | N | |||||
<Financiador> | Datos del Financiador de la Cobertura | R | ||||
<CodigoADESFA> | Código según ADESFA | NUM(20) | Según Tabla Financiadores | N | ||
<Codigo> | Código de Identificación del Financiador | VARCHAR(15) | Según el Validador | R | R | |
<Cuit> | CUIT del Financiador | NUM(11) | N | |||
<Sucursal> | Sucursal del Financiador | NUM(4) | N | |||
</Financiador> | R | |||||
<Credencial> | Datos de la Credencial del Beneficiario | R | ||||
<Numero> | Número de Beneficiario | VARCHAR(20) | R | N | ||
<Version> | Versión de la Credencial | VARCHAR(2) | N | |||
<Vencimiento> | Vencimiento de la Credencial | DATE | aaaammdd | N | ||
<ModoIngreso> | Modo de Ingreso de la Credencial | CHAR() | A = Manual / B = Banda Magnética / L = Laser | N | ||
<EsProvisorio> | Indica si la Credencial es Provisoria | CHAR() | N = Normal / P = Provisoria | N | ||
<Plan> | Plan asociado a la Credencial | VARCHAR(20) | Depende de la Cobertura | N | ||
</Credencial> | R | |||||
<Preautorizacion> | Datos de la Preautorización | N | ||||
<Codigo> | Código de Preautorización | VARCHAR(50) | R | R | ||
<Fecha> | Fecha en que se realizó la Preautorización | DATE | aaaammdd | R | R | |
</Preautorizacion> | N | |||||
<FechaReceta> | Fecha de Prescripción de la Receta | DATE | aaaammdd | R | N | |
<Formulario> | Datos del Formulario / Recetario | R | ||||
<Fecha> | Fecha de Emisión / Vencimiento | DATE | aaaammdd | N | ||
<Tipo> | Tipo de Formulario / Recetario | VARCHAR(3) | N | |||
<Numero> | Número de Formulario / Recetario | NUM(15) | R | R | ||
<Serie> | Serie del Formulario / Recetario | VARCHAR(3) | N | |||
</Formulario> | R | |||||
<TipoTratamiento> | Tipo de Tratamiento | CHAR() | N = Normal / P = Prolongado / O = Otro | R | N | |
<Diagnostico> | Diagnóstico | VARCHAR(100) | Indicar tal como está expresado en la Receta | N | ||
<Institucion> | Datos de la Institución | N | ||||
<CodigoADESFA> | Código según ADESFA | NUM(20) | Según Tabla Instituciones | N | ||
<Codigo> | Código de Institución | VARCHAR(30) | N | |||
<Cuit> | CUIT de Institución | NUM(11) | N | |||
<Sucursal> | Sucursal de Institución | NUM(4) | N | |||
</Institucion> | N | |||||
<RtaAdicional> | Respuestas Adicionales a la Respuesta General | N | ||||
<Linea> | Línea de Respuesta Adicional | N | ||||
<Codigo> | Código de Respuesta Adicional | VARCHAR(10) | N | |||
<Mensaje> | Mensaje asociado al Código de Respuesta Adicional | VARCHAR(255) | N | |||
</Linea> | N | |||||
</RtaAdicional> | N | |||||
</EncabezadoReceta> | R | |||||
<DetalleReceta> | Datos del Detalle de Ítems de la Receta | R | ||||
<ReferenciaRx> | Datos del Ítem | R | ||||
<NroLinea> | Número de Línea del Ítem | NUM(2) | R | R | ||
<GenericoPresentacion> | Genérico Presentación | VARCHAR(100) | R | R | ||
<Droga> | Droga Prescripta | R | ||||
<Codigo> | Código de Droga | VARCHAR(50) | R | N | ||
<Descripcion> | Descripción de Droga | VARCHAR(100) | R | N | ||
</Droga> | R | |||||
<CantidadPrescripta> | Cantidad Prescripta | NUM(3) | R | R | ||
<Item> | Datos del Ítem | R | ||||
<NroItem> | Número del Ítem | NUM(2) | R | R | ||
<CodBarras> | Código de Barras | NUM(13) | Se debe retornar el mismo Código enviado por el Prestador | R | N | |
<CodTroquel> | Código de Troquel | NUM(7) | Se debe retornar el mismo Código enviado por el Prestador | R | N | |
<Alfabeta> | Código Alfabeta | NUM(5) | Se debe retornar el mismo Código enviado por el Prestador | N | ||
<Kairos> | Código Kairos | NUM(7) | Se debe retornar el mismo Código enviado por el Prestador | N | ||
<Codigo> | Código Alternativo | VARCHAR(50) | Se debe retornar el mismo Código enviado por el Prestador | N | ||
<ImporteUnitario> | Importe Unitario | NUM(10.2) | Precio Unitario sin descuento | R | N | |
<Descripcion> | Nombre y Presentación completos | VARCHAR (100) | R | R | ||
<TipoCobertura> | Tipo de Cobertura | CHAR() | M = Cobertura por Monto Fijo P = Cobertura por Porcentaje | R | N | |
<PorcentajeCobertura> | Porcentaje de Cobertura | NUM(6.2) | Informativo | R | N | |
<ImporteACargoAfiliado> | Importe Unitario a Cargo del Afiliado | NUM(10.2) | La precisión de ImporteACargoAfiliado e ImporteCobertura predomina sobre la de PorcentajeCobertura | R | N | |
<ImporteCobertura> | Importe Unitario de Cobertura | NUM(10.2) | La precisión de ImporteACargoAfiliado e ImporteCobertura predomina sobre la de PorcentajeCobertura | R | N | |
<Estado> | Estado del Ítem | CHAR() | 1 = Sugerido 0 = No sugerido | R | N | |
</Item> | R | |||||
</ReferenciaRx> | R | |||||
</DetalleReceta> | R | |||||
</MensajeADESFA> | R |
Procedimiento de Envío de una Transacción
Hay dos mecanismos para enviar la transacción desde la farmacia.
Utilización del Web Service
Para utilizar este mecanismo Web service SOAP para la intercomunicación entre su servidor y el de transacciones.
URL: http://ws.itcsoluciones.com/sitelgateway/gw.asmx
Método a invocar se llama ProcesarXML.
Operation | Notes |
Public | Parameters: |
InformarPrestacion( | |
string version, | in string version (para XML enviar: V251) |
string empresa, | in string empresa (para OSDE enviar: 10, ver otros valores) |
string actividad, | in string actividad (para Farmacia enviar: 1) |
string licencia, | in string licencia (solicitar valor) |
string mensaje ):string | in string mensaje devuelve un mensaje xml como string conteniendo los atributos mencionados anteriormente. |
Para evitar la impresión de un ticket o comprobante adicional, el sistema de gestión debe colocar en el ticket fiscal que emite, los siguientes datos:
- Número de Afiliado <Track>
- Matrícula del médico prescriptor <NroMatricula>
- Nro de Autorización de la solicitud <NroReferencia>
Implementación
Para implementar la comunicación con el Webservice puede utilizar las siguientes librerías dependiendo del lenguaje de programación que esté utilizando:
Lenguage | Librería | URL |
---|---|---|
PHP | NuSOAP | http://nusoap.sourceforge.net/ |
Librería Nativa de PHP | http://ar.php.net/soap | |
Java | CXF | http://cxf.apache.org/ |
Axis | http://ws.apache.org/axis/ | |
.Net | Web Services Enhancements (WSE) | http://www.microsoft.com/downloads/ |
Python | Librería Nativa | http://www.python.org/ |
Ejemplo de implementación del Web Service
- Implementación para Java: SitelGatewayTest.zip
- Implementación para Visual Basic 6: EjemploImplementacionWSVB6.zip
Intercambio de Archivos de Texto plano en un Directorio Local en la Farmacia
Una vez que ha sido creado el archivo este debe dominarse XXXXX.xml donde XXXXX es el idMsj contenido en el mensaje. El valor de idMsj debe ser secuencial para la farmacia de lo contrario la aplicación de comunicaciones asume que el sistema de gestión está reenviando una transacción anterior, y como consecuencia podría llegar a devolver la respuesta de esa transacción anterior (sin generar un nuevo requerimiento).
Este archivo debe copiarse en un directorio donde se encuentre pooleando la aplicación PiAdesfa - HL7 que permite utilizar el mecanismo de comunicación definido por Adesfa y Sitel Cliente. El nombre y ubicación del directorio es configurable, los subdirectorios deben llamarse como se muestra aquí (en sistemas operativos, case sensitive utilizar minúsculas). Se recomienda la siguiente nomenclatura:
| +--itc | +--bkp +--ida +--rta
Donde "bkp" es un directorio de backup que puede utilizar SiTEL, "ida" es el directorio donde se colocan las solicitudes de la farmacia y "rta" es el directorio donde se obtienen las respuestas.
La transacción se dispara automáticamente al colocar el archivo XXXXX.xml en el directorio "ida" y se responde con el mismo nombre en el directorio "rta".
El directorio raiz puede llamarse "itc" o de cualquier otra manera.
Presentación de Recetas para Liquidación de la Obra Social
Inicialmente el formato XML no contemplaba la posibilidad de solicitud de liquidación ni las consultas de autorizaciones por rangos de fechas, estas opciones si están disponibles en SiTEL.
Para realizar la liquidación de las recetas autorizadas, se dispone de cinco mensajes:
- a) Consultas de Cierre (<CodAccion> 3000): emite un listado de todas las recetas autorizadas, donde aparecerán detallados el número de transacción, el afiliado al cual se le dispensó el medicamento, la cantidad de medicamentos dispensados, el importe total y la cobertura de la obra social, este listado se encuentra totalizado. Los tickets anulados también se encontrarán incluidos en él, y se señalará esta condición. El objeto de esta transacción es el de permitirle a la farmacia revisar las recetas que se encuentran acreditas en su cuenta corriente y de realizar las correcciones necesarias antes del envío de la solicitud de pago.
- b) Cierre de Lote (<CodAccion> 3001): una vez revisados los totales, y anuladas las recetas incorrectas e incluidas las faltantes si las hubiese, la farmacia procederá a la realización de un Cierre de Lote, con esto le está dando al financiador el aviso de que ese conjunto de recetas se presentarán para su cobro. Una vez realizado el Cierre, las recetas incluidas en él no se pueden modificar. Una vez realizado el cierre la farmacia presentará las recetas, y la tira de cierre (ArchivoCierre), no es necesaria la confección de un medio magnético.
- c) Adicionalmente la farmacia tiene la posibilidad de consultar todos los cierres anteriormente realizados (<CodAccion> 3004 y enviando el número de cierre en <NroReferencia>).
- d) Exclusión Receta (<CodAccion> 3003): existen ciertos casos donde la farmacia después de realizar una consulta puede determinar que precisa excluir una receta del lote a presentar al financiador. Un motivo puede ser por ejemplo que no encuentra la receta que originó la transacción. Ante esta situación para evitar que la farmacia anule el ticket (cosa que se haría solo cuando la exclusión sea permanente), puede excluir la transacción del lote. La farmacia envía la transacción indicando la receta a excluir y luego realiza el cierre de lote.
- e) Inclusión Receta (<CodAccion> 3002): derivado del caso anterior, se da la necesidad de incluir una receta previamente excluida (las recetas excluidas no son tenidas en cuenta hasta tanta se realice esta transacción). Así la farmacia indicará la receta y quedará disponible/aparecerá en la siguiente consulta o cierre de lote.
Procedimiento,
- 1) La farmacia enviará una Consulta de Cierre ( <CodAccion> 3000 </CodAccion> ), que podrá realizarse entre cualquier rango de fechas ( <FechaDesde> y <FechaHasta> ), si no es incluido un rango se considera que la consulta es sobre todas las recetas pendientes de pago. Solo se mostrarán (y totalizarán) las recetas pendientes de pago, es decir que no hubiesen sido cerradas. Existe un parámetro que permite que el resultado sea obtenido más rápidamente ( <IncluirDetalleTickets>) ya que excluye el overhead de todos los TAGs para cada uno de los items autorizados. Como resultado la farmacia obtendrá siempre una respuesta imprimible para la verificación ( <ArchivoCierre> ) .
- 2) Posteriormente, la farmacia enviará un Cierre de Lote, ( < CodAccion> 3001 </CodAccion> ), pudiendo también seleccionar los rangos de fecha ( <FechaDesde> y <FechaHasta> ), y el nivel de detalle de la respuesta ( <IncluirDetalleTickets>).
La respuesta imprimible ( <ArchivoCierre> ) tendrá el siguiente formato:
-------------------------------------- FINANSUR FILIAL MAR DEL PLATA Servicios Medicos -------------------------------------- CIERRE Lote Nro:38718 Nro de Tramite: 5013564 -------------------------------------- Prestador Nro : 000000331 DEL PLATA XII -------------------------------------- Estado de Proceso Desde el 22/08 a las 20:24 Hasta el 27/08 a las 22:38 DETALLE SOCIOS OBLIGATORIOS / IVA EXENTO DETALLE Nro.Tic Afiliado Med Total % Cob -------------------------------------- 2074944 61152624601 1 $ 14.56 40 2076154 11216593701 2 $ 24.32 40 2076847 11216863403 1 $ 48.99 40 2078846 11221770805 1 $ 42.30 An 2078848 11221770805 2 $ 99.24 An 2079120 11221770805 2 $ 99.24 40 2079121 11221770805 1 $ 42.30 40 RESUMEN Subtotales Transac. Socios Oblig. -------------------------------------- Total Tickets : 7 Total Tickets Anulados: 2 Total Tickets Devoluc.: 0 Subtotales de Cobranza (en Pesos) Socio Obligatorio -------------------------------------- Total Tickets : $ 229.41 Total a cargo Afiliado: $ 137.65 Bonif. Especial a FINA: $ 0.00 Bonif. a OSDE : $ 45.88 ---------- Subtotal a pagar por FINA:$ 45.88 DETALLE SOCIOS DIRECTOS / GRAVADO DETALLE Nro.Tic Afiliado Med Total % Cob -------------------------------------- 2077862 11213216801 2 $ 44.96 40 2077872 11213216801 1 $ 46.89 40 2077879 11213216801 2 $ 41.25 40 2078334 11211063601 1 $ 12.47 40 2078856 11209897101 3 $ 241.08 40 2078858 11209897101 3 $ 116.08 40 2078860 11209897101 3 $ 80.95 40 RESUMEN Subtotales Transac. Socios Directos -------------------------------------- Total Tickets : 7 Total Tickets Anulados: 0 Total Tickets Devoluc.: 0 Subtotales de Cobranza (en Pesos) Socio Directo -------------------------------------- Total Tickets : $ 583.68 Total a cargo Afiliado: $ 350.21 Bonif. Especial a FINA: $ 0.00 Bonif. a FINA : $ 116.74 ---------- Subtotal a pagar por FINA:$ 116.73 -------------------------------------- RESUMEN TOTALES TRANSACCIONES -------------------------------------- Total Tickets : 14 Total Tickets Anulados: 2 Total Tickets Devoluc.: 0 TOTALES DE COBRANZA (en Pesos) -------------------------------------- Total Tickets : $ 813.09 Total a cargo Afiliado: $ 487.86 Bonif. Especial a FINA: $ 0.00 Bonif. a FINA 20.00% : $ 162.62 ---------- Total a pagar por FINA:$ 162.61 -------------------------------------- |
- 3) Finalmente podría consultar Cierres anteriores, ( <CodAccion> 3004 </CodAccion> ), enviando el número del cierre deseado ( <NroReferencia> ).
Formato XML para Liquidación
Es exáctamente el mismo formato al presentado anteriormente, aquí solo se han incluido algunos TAGS específicos al proceso de cierre y se han excluido otros que serán ignorados en caso de ser enviados.
Nro | Nivel | Mensaje | Dirección | Tag | Descripción | Valor |
---|---|---|---|---|---|---|
1 | 0 | AMB | AMB | MensajeADESFA | MensajeADESFA Version=2.0 | |
2 | 1 | AMB | AMB | EncabezadoMensaje | ||
3 | 2 | AMB | VUE | Rta | Respuesta | |
4 | 3 | AMB | VUE | CodRtaGeneral | Código de rechazo, cualquier valor distinto de cero es un "rechazo" | |
5 | 3 | AMB | VUE | Descripcion | Descripción | |
6 | 3 | AMB | VUE | Mensaje | Mensaje | |
7 | 2 | CIE | VUE | NroReferencia | Número de transacción o referencia, que acompaña a esta solicitud (por ejemplo el nro. de la transacción que se quiere anular) | |
8 | 2 | AMB | AMB | TipoMsj | Directa o reversa (MESSAGE TYPE PROCESSING CODE iso8583) | Transacción normal:200/210 (ida/respuesta) Reversa o roll-back:400/410 (es distinta a una anulación) |
9 | 2 | AMB | AMB | CodAccion | Código de acción o función del mensaje o tipo de transacción | Además de las transacciones: 290020 (Solicitud de autorización) 020010 (Cancelación) 400000 (Verificación afiliado) 30000 (Consulta de Receta ya Autorizada). Existen operaciones específicas para facturación: 3000 (Consulta de Cierre) 3001 (Cierre de Lote) 3002 (Incluir Receta en un Cierre) 3003 (Excluir Receta de un Cierre) 3004 (Reimpresión Cierre de Lote) |
10 | 2 | CIE | AMB | FechaDesde | (AAAAMMDD) Fecha a partir de la cual desea incluirse tickets en la consulta o cierre de lote. De no colocarse ninguna fecha se consideran todas las recetas pendientes de pago. | |
11 | 2 | CIE | AMB | FechaHasta | (AAAAMMDD) Fecha hasta la cual desea incluirse tickets en la consulta o cierre de lote. De no colocarse ninguna fecha se consideran todas las recetas pendientes de pago. | |
12 | 2 | CIE | AMB | AlcanceCierre | Indica si la consulta o el cierre debe realizarse para el punto de venta que hace la transacción (valor por omisión) o si debe realizar para toda la cadena de farmacias (para el prestador). | V o vacío: indica Punto de Venta, P: indica el prestador o cadena. |
13 | 2 | CIE | AMB | TipoConsulta | Indica el tipo de consulta que desea realizarse. Este parámetro solo se tiene en cuenta para el <CodAccion> 3000, Consulta de Cierre. | P o (vacío): incluye lo pendiente de pago/cierre, esta es la opción por omisión, devuelve las transacciones facturables pendientes de pago en el perído, son los registros que vendrán luego incluidos en el Cierre de Lote. A: solicita solo transacciones aprobadas y no cerradas. R: solo transacciones rechazadas en el período pendiente de cierre. N: Transacciones Anuladas, correspoden a registros facturables que han sido anulados en el período pendiente de cierre. B: Transacciones Bloqueadas, listado de transacciones excluidas que se encuentran separadas del lote de recetas pendientes de pago. Esta exclusión la realiza la farmacia a través de la transacción Excluir cupón del Cierre, y puede ser incorporada al lote de transacciones utilizan la transacción Incluir cupón. T: todas las transacciones registradas transacciones ya sean facturables o no, ya sea que se encuentren autorizadas o rechazadas en el período pendiente de cierre. |
14 | 2 | CIE | AMB | IncluirDetalleTickets | Permite incluir o excluir el detalle de cada ticket en el XML (Detalle Cierre) | S: Incluye detalle, N ó 0: Excluye detalle. Este permite evitar el envío de mucha información que si no se utiliza permite reducir el overhead de la transacción considerablemente. C: Excluye detalle pero la publicación por parte del Financiador (en caso de existir) es en Formato CSV. |
15 | 2 | AMB | AMB | IdMsj | Identificación del mensaje, número secuencial | Entero de 8 posiciones, luego reinicia. |
16 | 2 | AMB | AMB | InicioTrx | Fecha de generación del mensaje | |
17 | 3 | AMB | AMB | Fecha | AAAAMMDD | |
18 | 3 | AMB | AMB | Hora | HHMMSS | |
19 | 2 | AMB | AMB | Terminal | Terminal que genera el mensaje | |
20 | 3 | AMB | AMB | Tipo | Tipos de terminal: PC, IVR, o POS | PC |
21 | 3 | AMB | AMB | Numero | Número de terminal, identificación propia que utilice el sistema de gestión | |
22 | 2 | AMB | IDA | Software | ||
23 | 3 | AMB | IDA | Nombre | Nombre | |
24 | 3 | AMB | IDA | Version | Versión | |
25 | 2 | AMB | AMB | Prestador | Identificación de la farmacia | |
26 | 3 | AMB | AMB | Cuit | Sin guiones, corresponde al CUIT utilizado para facturarle al financiador | |
27 | 3 | AMB | AMB | Sucursal | Identificación propia utilizada por la cadena | ENTERO(4) |
28 | 3 | AMB | VUE | RazonSocial | Razón social | VARCHAR(100) |
29 | 3 | AMB | VUE | Direccion | Dirección | |
30 | 3 | AMB | VUE | CodParaFinanciador | Código Para El Financiador | |
31 | 1 | CIE | VUE | Cierre | ||
32 | 2 | CIE | VUE | NroReferencia | Es la identificación que tendrá el cierre en el sistema en línea para futuras referencias. | |
33 | 2 | CIE | VUE | Lotes | ||
34 | 3 | CIE | VUE | Lote | ||
35 | 4 | CIE | VUE | NroTramite | Es la identificación interna del financiador. | |
36 | 4 | CIE | VUE | NombreFinanciador | ||
37 | 4 | CIE | VUE | CantidadRecetas | Cantidad total de recetas autorizadas. | |
38 | 4 | CIE | VUE | CantidadRecetasAnuladas | Cantidad de recetas que han sido anuladas. | |
39 | 4 | CIE | VUE | ImporteTotal | Importe total facturado por las recetas incluidas en el lote. Formato del importe lleva punto decimal, no se hace separador en la parte entera del importe. No se utiliza símbolo pesos. Ej: 568.10 | |
40 | 4 | CIE | VUE | CargoAfiliado | Importe total pagado por los afiliados. | |
41 | 4 | CIE | VUE | BonificacionEspecial | Importe de cualquier tipo de bonificación extraordinaria que pudiese haberse aplicado. | |
42 | 4 | CIE | VUE | Bonificacion | Importe de la bonificación pactada con el financiador. | |
43 | 4 | CIE | VUE | TotalAPagar | Es el importe total que el financiador debe liquidarle a la farmacia por las recetas autorizadas. | |
44 | 2 | CIE | VUE | DetalleCierre | ||
45 | 3 | CIE | VUE | Item | ||
46 | 4 | CIE | VUE | NroTramite | ||
47 | 4 | CIE | VUE | CodAutorizacion | Nro. de autorización recibido para la solicitud aprobada. | |
48 | 4 | CIE | VUE | Fecha | Fecha de transacción. | |
49 | 4 | CIE | VUE | NumeroAfiliado | Número de la credencial. | |
50 | 4 | CIE | VUE | CantidadAprobada | Cantidad total aprobada menos las devoluciones que pudiesen haberse solicitado. | |
51 | 4 | CIE | VUE | ImporteTotal | Monto total de la transacción aprobada. | |
52 | 4 | CIE | VUE | CargoAfiliado | Importe de la transacción pagada por el afiliado. | |
53 | 4 | CIE | VUE | Tipo | Atributo que permitiría agrupar las recetas de acuerdo a algún criterio. Aquí se indica si los items incluidos en la receta fueron autorizados con: (vacio) Cobertura Normal, M en Plan Materno, C como afiliado Crónico, o X como Plan Materno y Crónico. | |
54 | 4 | CIE | VUE | Bonificacion | Monto de la bonificación otorgada al financiador para esta receta (transacción). | |
55 | 4 | CIE | VUE | FechaReceta | Fecha en que se realizó la transacción de esta receta. | |
56 | 4 | CIE | VUE | NroReceta | Número secuencial que indica el orden en que deben presentarse las recetas al financiador para su liquidación. | |
57 | 4 | CIE | VUE | TipoTransaccion | Indica la forma en que se realizó la transacción, separando aquellas hechas en línea, O, de la realizadas en diferido D. | |
58 | 4 | CIE | VUE | CargoFinanciador | Monto que debe pagar el financiador por la receta (transacción). | |
59 | 2 | CIE | VUE | ArchivoCierre | Corresponde al nombre del archivo imprimible con el listado de recetas y los totales, para la presentación en el financiador. |
Testing
Para obtener números de afiliados de pruebas consultar en cada financiador aquí.
Prueba a través de intercambio de archivos planos con en el directorio de pooleo tipo ADESFA
- Crear el árbol de directorios ( ver).
- Instalar Sitel Cliente.
- Solicitar una licencia de prueba (Reclamos).
- Configurar el directorio de pooleo en Sitel Cliente para que busque en el directorio ADESFA que ha creado.
- Copiar archivo en directorio ida.
Prueba a través de Web Service
- Abrir un browser
- Probar si se ve el Web Service: http://200.47.62.201/sitelgateway/gw.asmx
- (respuesta xml) Copiar el método y tomar un mensaje de prueba, debe ir todo junto sin retornos de carro: http://200.47.62.201/sitelgateway/gw.asmx/ProcesarXml?version=V251&empresa=10&actividad=01&licencia=PRUEBA05&mensaje=
- (respuesta string) Copiar el método y tomar un mensaje de prueba, debe ir todo junto sin retornos de carro: http://200.47.62.201/sitelgateway/gw.asmx/ProcesarString?version=V251&empresa=10&actividad=01&licencia=PRUEBA05&mensaje=
Prueba a través de archivos planos
- Generar un archivo que contenga el mensaje XML puede llamarse de cualquier manera, por ejemplo _svl.xml o 123.xml
- Editar el archivo anterior copiando un mensaje. Ver más abajo mensajes de ejemplo.
- Generar un archivo _svl.0 con versión V2511001. Donde V251 es la versión XML de farmacia, 10 por ej el financiador: OSDE (ver otros), 01 la actividad: farmacia.
- Instalar y configurar Sitel Cliente, para tener una aplicación de comunicaciones.
- Copiar los archivos, _svl.0 y 123.xml en el directorio Upload, y verificar que sean procesados (debería tomarlos automáticamente)
- Revisar la respuesta.
Mensajes de Prueba
Solicitud de Autorización de Receta para el afiliado de prueba y Prestador de Prueba
Aquí vía Web Service, será necesario ajustar la fecha de receta para que sea aprobada
Ejemplo para el financiador OSDE
Aquí sin la invocación vía Web Service
<MensajeADESFA> <EncabezadoMensaje> <NroReferencia></NroReferencia> <TipoMsj>200</TipoMsj> <CodAccion>290020</CodAccion> <IdMsj>32</IdMsj> <InicioTrx> <Fecha>20110207</Fecha> <Hora>111824</Hora> </InicioTrx> <Terminal> <Tipo>PC</Tipo> <Numero>01</Numero> </Terminal> <Software> <Nombre>FarmaSur</Nombre> <Version>5.5</Version> </Software> <Prestador> <Cuit>30526250644</Cuit> <Sucursal>6</Sucursal> <RazonSocial>FARMASUR%2058</RazonSocial> </Prestador> </EncabezadoMensaje> <EncabezadoReceta> <Prescriptor> <Apellido/> <Nombre/> <TipoMatricula>N</TipoMatricula> <Provincia>C</Provincia> <NroMatricula>1234</NroMatricula> <TipoPrescriptor>M</TipoPrescriptor> <Cuit/> </Prescriptor> <Beneficiario> <TipoDocumento>DNI</TipoDocumento> <NroDocumento>12345678</NroDocumento> </Beneficiario> <Financiador> <Cuit>30546741253</Cuit> </Financiador> <Credencial> <Track>60671956202</Track> <CSC>981</CSC> <ModoIngreso>A</ModoIngreso> </Credencial> <FechaReceta>20110207</FechaReceta> <Dispensa> <Fecha>20110207</Fecha> <Hora>110202</Hora> </Dispensa> </EncabezadoReceta> <DetalleReceta> <Item> <NroItem>1</NroItem> <CodTroquel>0013223</CodTroquel> <CantidadSolicitada>1</CantidadSolicitada> <Generico>M</Generico> </Item> </DetalleReceta> </MensajeADESFA>
Ejemplo para el financiador ServeSalud
Aquí sin la invocación vía Web Service
<MensajeADESFA> <EncabezadoMensaje> <NroReferencia></NroReferencia> <TipoMsj>200</TipoMsj> <CodAccion>290020</CodAccion> <IdMsj>32</IdMsj> <InicioTrx> <Fecha>20110207</Fecha> <Hora>111824</Hora> </InicioTrx> <Terminal> <Tipo>PC</Tipo> <Numero>01</Numero> </Terminal> <Software> <Nombre>FarmaSur</Nombre> <Version>5.5</Version> </Software> <Prestador> <Cuit>30526250644</Cuit> <Sucursal>6</Sucursal> <RazonSocial>FARMASUR%2058</RazonSocial> </Prestador> </EncabezadoMensaje> <EncabezadoReceta> <Prescriptor> <Apellido/> <Nombre/> <TipoMatricula>N</TipoMatricula> <Provincia>C</Provincia> <NroMatricula>1234</NroMatricula> <TipoPrescriptor>M</TipoPrescriptor> <Cuit/> </Prescriptor> <Beneficiario></Beneficiario> <Financiador> <Cuit>30550194283</Cuit> </Financiador> <Credencial> <Track>00000400</Track> <ModoIngreso>A</ModoIngreso> </Credencial> <FechaReceta>20110207</FechaReceta> <Dispensa> <Fecha>20110207</Fecha> <Hora>110202</Hora> </Dispensa> </EncabezadoReceta> <DetalleReceta> <Item> <NroItem>1</NroItem> <CodTroquel>0013223</CodTroquel> <CantidadSolicitada>1</CantidadSolicitada> <Generico>M</Generico> </Item> </DetalleReceta> </MensajeADESFA>
Consulta de Cierre para una Farmacia de Prueba
Ejemplo OSDE rango de fechas entre 05/Ene/2007 y el 28/Feb/2011
Ejemplo ServeSalud sin rango de fecha
Transacción de exclusión de Ticket 50179
Ejemplo OSDE
Ejemplo ServeSalud
Transacción de inclusión Ticket 50179
Cerrar Lote FarmaSur Sucursal 6
Solicitud de Anulación de Receta 999999
Nota: 999999 corresponde a la receta que se desea anular, la cual pertenece al prestador y no está cerrada.
Aquí vía Web Service, será necesario ajustar el número de receta (NroReferencia) para que sea aprobada
Ejemplo anulación ticket en ServeSalud
Aquí sin la invocación vía Web Service
<MensajeADESFA> <EncabezadoMensaje> <NroReferencia>999999</NroReferencia> <TipoMsj>200</TipoMsj> <CodAccion>020010</CodAccion> <IdMsj>34</IdMsj> <InicioTrx> <Fecha>20090316</Fecha> <Hora>111824</Hora> </InicioTrx> <Terminal> <Tipo>PC</Tipo> <Numero>01</Numero> </Terminal> <Software> <Nombre>FarmaSur</Nombre> <Version>5.5</Version> </Software> <Prestador> <Cuit>30526250644</Cuit> <Sucursal>6</Sucursal> <RazonSocial>FARMASUR%2058</RazonSocial> </Prestador> </EncabezadoMensaje> <EncabezadoReceta> <Prescriptor> <Apellido/> <Nombre/> <TipoMatricula>N</TipoMatricula> <Provincia>C</Provincia> <NroMatricula>1234</NroMatricula> <TipoPrescriptor>M</TipoPrescriptor> <Cuit/> </Prescriptor> <Beneficiario></Beneficiario> <Financiador> <Cuit>30550194283</Cuit> </Financiador> <Credencial> <Track>00000400</Track> <ModoIngreso>M</ModoIngreso> </Credencial> <FechaReceta>20090315</FechaReceta> <Dispensa> <Fecha>20090315</Fecha> <Hora>110202</Hora> </Dispensa> </EncabezadoReceta> </MensajeADESFA>
Consulta o Reimpresión de Ticket 50179
Aquí vía Web Service, será necesario que exista el ticket para esa farmacia para que pueda ser devuelto
Aquí sin la invocación vía Web Service
<MensajeADESFA> <EncabezadoMensaje> <NroReferencia>50179</NroReferencia> <TipoMsj>200</TipoMsj> <CodAccion>30000</CodAccion> <IdMsj>11</IdMsj> <InicioTrx> <Fecha>20090219</Fecha> <Hora>111824</Hora> </InicioTrx> <Terminal> <Tipo>PC</Tipo> <Numero>01</Numero> </Terminal> <Software> <Nombre>FarmaSur</Nombre> <Version>5.5</Version> </Software> <Prestador> <Cuit>30526250644</Cuit> <Sucursal>6</Sucursal> <RazonSocial>FARMASUR%2058</RazonSocial> </Prestador> </EncabezadoMensaje> </MensajeADESFA>
Impresión de un Ticket
Usualmente el financiador le exigirá un ticket donde quede constancia de la recepción de los medicamentos autorizados por parte del afiliado.
Existen cuatro formas de emitir un comprobante:
- Imprimir el ticket (archivo) _ticket.prm. Si realiza la transacción utilizando una aplicación provista por ITC, en el directorio \itc\rta encontrará un archivo _ticket.prm con todos los datos de la transacción en formato legible. Este ticket puede imprimirse en cualquier impresora inclusive en una impresora fiscal (saldrá con la leyendo "Comprobante no fiscal homologado"). Usualmente esta impresión la realiza la misma aplicación de comunicaciones y puede realizarse en cualquier impresora de la red. Este ticket firmado se abrocha a la receta.
- Endosar la receta: Al igual que en el caso anterior, solo si no utiliza el web service el archivo _ticket.prm puede imprimirse en la receta misma, esta operación se llama usualmente endosar. Para ello requiere una impresora de tipo financiera (como una Epson TM-950). Usualmente esta impresión la realiza la misma aplicación de comunicaciones. Evita la pérdida del ticket.
- Confeccionar un ticket. Si utiliza el web service no tendrá disponible el archivo _ticket.prm, pero todos los datos del mismo vienen en líneas de 20 caracteres en el campo <Mensaje>. Con lo cual es posible imprimir fácilmente un ticket no fiscal siguiendo el ejemplo que aparece abajo.
- Incorporar en el ticket fiscal algunos datos: imprimir los datos de la transacción en el ticket fiscal usual de la farmacia permite eliminar la necesidad del manejo de otro ticket (no fiscal). El ticket fiscal ya posee la mayoría de los datos necesarios, solo debe asegurarse de incorporar algunas datos faltantes como ser el número de transacción. Aquí se muestra un ejemplo de un ticket fiscal:
Ejemplo de ticket (no fiscal):
-------------------------------------- "Nombre Financiador" -------------------------------------- "Tipo de Transacción" -------------------------------------- Cupón N°: <NroReferencia> -------------------------------------- Prestador: <CodParaFinanciador> <RazonSocial> Afiliado: <Numero> Plan: <Plan> Tipo: <Tipo> Médico Receta : <NroMatricula> Fecha Receta : <FechaReceta> Fecha Prestación: <Fecha><Hora> -------------------------------------- Medicamentos Can Troquel P.Unit. %Cob. P.Final -------------------------------------- <CantidadAprobada> <CodTroquel> <ImporteUnitario> <ImporteCobertura>/<ImporteUnitario> <ImporteUnitario>-<ImporteCobertura> <Descripcion> Tipo Prescripción: <Generico > -------------------------------------- TOTAL: <CantidadAprobada> * <ImporteUnitario> A cargo O.S. <CantidadAprobada> * <ImporteCobertura> A cargo Afil. <CantidadAprobada> * (<ImporteUnitario>-<ImporteCobertura>) -------------------------------------- TOTAL A CARGO AFIL.: <CantidadAprobada> * (<ImporteUnitario>-<ImporteCobertura>) -------------------------------------- Firma del Titular -------------------------------------- Aclaración Firma Documento Nro: Telf.y Direc.: -------------------------------------- <Fecha> <Hora> PuntoSalud.com |
- Ver ejemplo de implementación en un Ticket de Autorización de Medicamentos para un prepago.
- Ver ejemplo colocando datos de la autorización en un Ticket Fiscal.