imported>Javier: /* _svl.3 */

2021-07-22T15:50:16Z

_svl.3

imported>Javier: /* _svl.3 */

2020-06-26T15:54:18Z

_svl.3

Página nueva

== Formato V250 de Integración para Transacciones desde Farmacia ==
Este es un formato de longitud fija orientado a permitir la comunicación entre farmacias y financiadores.

== Identificación del Usuario y de la Obra Social/Prepago ==

=== _svl.0 ===
1 registro. Este archivo permite la identificación del prestador. Seleccionando la empresa a la que SITEL se tiene que conectar, la actividad bajo la cual se va a realizar la operación y la licencia SITEL que se debe utilizar, SITEL permite realizar autorizaciones para diferentes [[Financiadores|financiadores]]. El archivo tiene el siguiente formato:

{{Plantilla:Svl.0
|versionArchivos= V250
|empresa= 10
|empresaDescripcion= OSDE (OSDE NACIONAL)
|actividad= 01
|actividadDescripcion= Farmacia
}}

== Solicitud de Autorización ==

=== _svl.1 ===
1 registro. Este archivo permite la identificación del beneficiario, su cobertura médica y del tipo de operación a realizar. El archivo tiene el siguiente formato:

{| class="wikitable"
! Nro.
! Campo
! Fuente
! Tipo
! Posición
! Descripción

|-
| 0
| Identificador Formato
| APP/SITEL
| C(5)
| 1
| Reservado "FF000"

|-
| 1
| Operación
| APP
| N(2)
| 6
| [[Transacción de Dispensa de Medicamentos|01. Alta de ticket]] 
[[Anular Transacción|02. Anulación ticket]] 
[[Transacción de Devolución Medicamentos|03. Devolución de ticket]] 
[[Transacción de Verificación para Dispensa de Medicamentos|04. Consulta de ticket (no registra la autorización en la cuenta corriente)]]
(También permite reimprimir un ticket enviando en campo ''Ticket Padre'' la transacción que desea recuperar) 
[[Transacción de Dispensa Diferida de Medicamentos|05. Alta diferida de ticket]] 
[[Transacción_de_Recupero_de_Receta_Electrónica|12. Rescatar una Prescripción Electrónica]] 
[[Transacción de Verificación de Afiliado|41. Verificar Beneficiario]] 
42. Verificar Beneficiario / Medicamento 
51. Solicitar autorización 
53. Consultar Resolución Solicitud Autorización 
 
[[#Excluir una Receta del Cierre|10. Excluir receta de un Cierre de Lote]] 
[[#Incluir una Receta|11. Incluir receta previamente excluida]] 
[[Reimpresión de Ticket|80. Reimpresión de Ticket]] (enviar en el campo ''Ticket Padre'' la transacción que desea recuperar)
|-
| 2
| Tarjeta
| APP
| C(100)
| 8
| Lectura de banda magnética o campos de carga manual de acuerdo a cada [[Financiadores|financiador]]. Algunos financiadores exigen el envío del código de seguridad de la credencial en el campo '''CSC''' (puede estar en el anverso y/o reverso de la credencial).

|-
| 3
| Tipo de Lectura
| APP
| N(1)
| 108
| '''0''' No Aplicable/ '''1''' Banda / '''2''' Manual / '''3''' Entrega a Domicilio / '''4''' (Chip/Smart Card) / '''5''' (Código de Barra) / '''6''' (Código QR) / '''7''' (NFC/Proximidad).

|-
| 4
| Farmacia
| APP
| N(11)
| 109
| CUIT de la Farmacia. Identificador de Prestador para el Financiador.

|-
| 5
| Ticket Padre
| APP
| C(12)
| 120
| Número del ticket correspondiente a la [[Anular Transacción|Anulación]], Devolución o ticket a [[#Excluir_una_Receta_del_Cierre|Excluir]] o [[#Incluir_una_Receta|Incluir]]

|-
| 6
| Tipo de Receta
| APP
| N(2)
| 132
| Tipo de recetario

|-
| 7
| Receta
| APP
| C(20)
| 134
| Número de la receta. Se utiliza para identificar una receta electrónica, digitalizada o formulario pre-impreso numerado.

|-
| 8
| Fecha de Receta
| APP
| C(8)
| 154
| Fecha en que se realizó la prescripción por el médico. En Formato AAAAMMDD.

|-
| 9
| Fecha de Emisión del Recetario
| APP
| C(8)
| 162
| Fecha correspondiente a la emisión del recetario. En Formato AAAAMMDD.

|-
| 10
| Fecha de Venta
| APP
| C(8)
| 170
| Fecha en que se realizó la venta. Formato AAAAMMDD

|-
| 11
| Hora de Venta
| APP
| C(4)
| 178
| Hora en que se realizó la venta. Formato HHMM (formato 24hs.)

|-
| 12
| Tipo Documento que retira
| APP
| N(1)
| 182
| Código tipo documento de quién retira ('''1''' DNI, '''2''' LC, '''3''' LE, '''4''' CE, '''5''' Pasaporte)

|-
| 13
| Documento Retira
| APP
| N(8)
| 183
| Número de documento de quien retira el/los medicamentos

|-
| 14
| Consulta
| APP
| C(20)
| 191
| Número correspondiente a la orden de consulta

|-
| 15
| Tipo de Matrícula Médico que Receta
| APP
| C(2)
| 211
| Tipo de matrícula del médico que receta, valor 'XY'. Donde:

X: código de origen de la matrícula (nacional, provincial, etc) (Valores: '''0''' Provincial<ref name="matricula"/>, '''1''' Nacional, [[Tabla Patentes Viejas|'''X'''= letra de patentes viejas]]) 
Y: Tipo de especialidad (Valores: '''1''' Médico Clínico, '''2''' Odontólogo)

Ejemplos: 01 - Provincial Medico Clínico<ref name="matricula">En caso de poner matrícula genérica provincial "0" se considera que el médico pertenece a la provincia desde donde se origina la transacción.</ref>, 11 - Nacional Medico Clínico, S2 - Santa Fe Odontólogo

|-
| 16
| Matrícula Médico que Receta
| APP
| N(6)
| 213
| Matrícula del médico que receta

|-
| 17
| Tipo de Matrícula Médico Auditor
| APP
| C(2)
| 219
| Tipo de matrícula del médico que audita<ref name="matricula"/>

|-
| 18
| Matrícula Médico Auditor
| APP
| N(6)
| 221
| Matrícula del médico que audita

|-
| 19
| Código Autorización / Tratamiento Prolongado
| APP/SITEL
| N(1)
| 227
| Indicador tipo de autorización: 1 - Autorización Normal, 2 - Autorizaciones por Tratamiento Prolongado

|-
| 20
| Número Autorización / Tratamiento Prolongado
| APP/SITEL
| C(12)
| 228
| Código asignado por el Financiador/Obra Social a la autorización que le otorga al afiliado para una cobertura o Número de autorización para tratamiento prolongado

|-
| 21
| Documentación Extra
| APP
| C(5)
| 240
| Indica si el afiliado presentó la documentación extra exigida por la obra social. Posiciones (izquierda a derecha):

P1: Documentación Requerida 
P2: Sin uso 
P3: Sin uso 
P4: Sin uso 
P5: Sin uso

Valores para cada posición: 0 - No presentó o sin uso, 1 - Si presentó
|-
| 22
| Descuento del Prestador
| APP/SITEL
| N(5,2)
| 245
| Descuento del prestador al afiliado

|-
| 23
| Ticket/Autorización
| SITEL
| C(12)
| 250
| Número de ticket generado por el sistema o número de autorización del medicamento o tratamiento prolongado

|-
| 24
| Orden
| SITEL
| N(6)
| 262
| Número de ticket que se inicializa con cada cierre de cada prestador.

|-
| 25
| Fecha
| SITEL
| C(8)
| 268
| Fecha en que se realizó la transacción. Formato AAAAMMDD

|-
| 26
| Hora
| SITEL
| C(4)
| 276
| Hora en que se realizó la transacción. Formato HHMM (formato 24hs.).

|-
| 27
| Plan Beneficiario
| SITEL
| C(5)
| 280
|

|-
| 28
| Tipo Beneficiario
| SITEL
| N(1)
| 285
| '''1''' - IVA Gravado, '''2''' - IVA No Gravado, '''3''' - Indefinido

|-
| 29
| Monto a abonar
| SITEL
| N(11,2)
| 286
| Importe total a cargo del Afiliado

|-
| 30
| Error
| SITEL
| N(4)
| 297
| '''0000'''-Si es normal, [[Códigos de Respuesta Farmacia|Otros - Error]]

|-
| 31
| Comentario/Display
| SITEL
| C(40)
| 301
| Comentario o descripción del error de la transacción

|-
| 32
| Número de Transacción de la Farmacia
| APP
| N(8,0)
| 341
| Es un número entero de hasta 8 posiciones, secuencial o aleatorio colocado por la farmacia y que permite identificar cada solicitud enviada. Si se repite el Número de Transacción en transacciones consecutivas, devolverá una copia del primer ticket.

|-
| 33
| CSC (Código de Seguridad de la Credencial)
| APP
| C(3)
| 349
| Código que se encuentra en el anverso y/o reverso de la credencial para verificar la presencia de la credencial. Ejemplo: ''012''. [[Archivo:Ejemplo_Lectura_CSC.jpg|Ver ejemplo en la credencial]]

|-
| 34
| Reservado
| APP
| C(19)
| 352
|

|-
|
| CRLF
| APP
| C(2)
| 371
|

|}

'''Total: 372 bytes'''

=== _svl.3 ===
Listado de medicamentos a dispensar. ''N'' registros. Este archivo contiene una descripción de cada uno de los items de la receta.

{| class="wikitable"
! Nro.
! Campo
! Fuente
! Tipo
! Posición
! Descripción

|-
| 0
| Identificador Formato
| APP/ SITEL
| C(5)
| 1
| Reservado "FF000"

|-
| 1
| Troquel
| APP
| N(7)
| 6
| Troquel del Medicamento

|-
| 2
| Código de Barras
| APP
| N(13)
| 13
| Código de barras del Medicamento

|-
| 3
| Código Proveedor
| APP
| C(7)
| 26
| Código del medicamento asignado por el proveedor del vademécum

|-
| 4
| Cantidad
| APP/ SITEL
| N(2)
| 33
| Cantidad solicitada y aprobada

|-
| 5
| Tipo Arancel
| APP
| N(1)
| 35
|

|-
| 6
| Precio
| APP/ SITEL
| N(11,2)
| 36
| Precio unitario

|-
| 7
| Diagnóstico
| APP
| C(10)
| 47
| Código de diagnóstico asociado al medicamento

|-
| 8
| Tipo Autorización
| APP/ SITEL
| N(1)
| 57
| '''1''' Normal, '''2''' Tratamiento Prolongado, '''3''' Autorización Especial, '''4''' Plan Materno Infantil, '''5''' Crónico. (Al realizar una transacción de autorización diferida tiene la oportunidad de informar aquí el motivo por el cual le otorgó una cobertura al cliente)

|-
| 9
| Autorización
| APP/ SITEL
| C(12)
| 58
| Código de Autorización asignado por el financiador a la autorización del medicamento o al tratamiento prolongado

|-
| 10
| Porcentaje Cobertura
| APP/ SITEL
| N(5,2)
| 70
| Al realizar una transacción de autorización diferida tiene la oportunidad de informar aquí el porcentaje de cobertura que le otorgó al cliente. Ejemplo: ''07000''

|-
| 11
| Precio de OS
| SITEL
| N(11,2)
| 75
| Precio unitario

|-
| 12
| Plan Cobertura
| APP/ SITEL
| C(10)
| 86
|

|-
| 13
| Nombre Medicamento
| SITEL
| C(50)
| 96
|

|-
| 14
| Presentación Medicamento
| SITEL
| C(25)
| 146
|

|-
| 15
| Error
| SITEL
| N(4)
| 171
|

|-
| 16
| Comentario
| SITEL
| C(40)
| 175
|

|-
| 17
| Tipo Prescripción
| APP/ SITEL

| C(1)
| 215
| Valores: '''1'''. Prescripción de Monodroga o Componente activo; '''2'''. Prescripción de Monodroga con Recomendación Comercial; '''3'''. Prescripción de Presentación Comercial; '''4'''. Prescripción de Presentación Comercial con Justificación Médica; '''0'''. tipo de prescripción indefinida

|-
| 18
| Cambio de la Prescripción
| APP
| C(1)
| 216
| Valores: '''0'''. NO hubo cambio de la prescripción; '''1'''. SI hubo cambio

|-
| 19
| Reservado
| SITEL
| C(28)
| 217
|

|-
|
| CRLF
| APP
| C(2)
|
|

|}

'''Total: 246 bytes'''

=== _svl.4 ===
Diagnósticos (n registros). Este archivo se utiliza para remitir todos los diagnósticos referidos a la atención del beneficiario que no están circunscritos a un medicamento determinado, si no al Rp.

{| class="wikitable"
! Nro.
! Campo
! Fuente
! Tipo
! Posición
! Descripción

|-
| 1 || Diagnóstico || APP || C(10) || 1 ||
|-
| 2 || Error || SITEL || N(4) || 11 ||
|-
| 3 || Comentario || SITEL || C(40) || 15 ||
|-
| || CRLF || APP || C(2) || 55 ||

|}

'''Total: 56 bytes'''

=== _codbar.txt [[_codbar.txt | ver]] ===
=== _codQR.txt [[_codQR.txt | ver]] ===

== Cierres de Lotes ==
Las solicitudes de cierre de lotes son solicitadas en SITEL a través del envío del archivo [[#_sal.0|_sal.0]]. Este archivo permite además solicitar consultas tanto de tickets por cerrar, como de los cierres realizados, además de permitir la solicitud de archivos de actualización de datos requeridos por los programas de gestión.

=== _sal.0 ===
Archivo para Cierres, Consultas de Lotes, Actualizaciones (1 registro)
{{:Sal.0}}

Es posible '''[[04B|excluir una receta]]''' de un cierre con el objeto de ser presentada en un cierre posterior. Esta receta puede con posterioridad ser '''[[04D|incluida en un cierre posterior]]'''. Para ello es necesario enviar el [[#_svl.1|código de operación adecuado en el archivo _svl.1]].

Como respuesta si solicitó actualizaciones, volverá un archivo llamado [[Sitel.bin|_sitel.bin]] este archivo contiene un listado con los nombres de todos los archivos devueltos.

==== Excluir una Receta del Cierre ====
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.

[[04B| Ampliar (+)]]

==== Incluir una Receta ====
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.

[[04D| Ampliar (+)]]

== Actualizaciones ==
SITEL permite el envío de archivos de actualización con la información pertinente para que el prestador pueda operar más eficientemente con el programa de aplicación. SITEL puede enviar actualizaciones parciales (todas las novedades desde la última actualización) o todos los registros disponibles. Las solicitudes de archivos de actualización son devueltos en los archivos [[#_sal.1|_sal.1]] al 4 correspondiendo cada uno de ellos a: Actualización de Planes, Médicos, Medicamentos, y Diagnósticos respectivamente.

=== _sal.1 ===
{{:Sal.1}}

=== _sal.2 ===
{{:Sal.2}}

=== _sal.3 ===
{{:Sal.3}}

=== _sal.4 ===
{{:Sal.4}}

== Campos obligatorios a enviar para cada [[Financiadores|financiador]] ==

Las operaciones mínimas a homologar son Ticket de Alta (01), [[Anular Transacción|Anulación (02)]], Consulta de Lote y Cierre de Lote. La siguiente es la lista de campos obligatorios para "Alta de Ticket" según el financiador. Los campos que no aparecen son de envío opcional.

[[OSDE]]/[[ServeSalud]]:
*[[#_svl.1|Archivo SVL.1]] 0, 1, 2, 3, 8, 10, 11, 15, 16, 22
*[[#_svl.3|Archivo SVL.3]] 0, 1, 2, 4, 6, 7, 17, 18
CAJA FORENSE/DOCTHOS/CIMESA:
*[[#_svl.1|Archivo SVL.1]] 0, 1, 2, 3, 8, 10, 11, 15, 16, 22
*[[#_svl.3|Archivo SVL.3]] 0, 1, 2, 4, 6, 7
PAMI:
*[[#_svl.1|Archivo SVL.1]] 0, 1, 2, 3, 7, 8, 10, 11, 12, 13, 15, 16, 22
*[[#_svl.3|Archivo SVL.3]] 0, 1, 2, 4, 6, 7
FEMEBA/OSETYA/OSSEG:
*[[#_svl.1|Archivo SVL.1]] 0, 1, 2, 3, 6, 7, 8, 10, 11, 15, 16, 22
*[[#_svl.3|Archivo SVL.3]] 0, 1, 2, 4, 6, 7
[[OSEP]]:
*[[#_svl.1|Archivo SVL.1]] 0,1,2,3,4,7,8,15,16,20
*[[#_svl.3|Archivo SVL.3]] 0,2,4,6,7,10,12

La siguiente es la lista de campos obligatorios para la '''[[Anular Transacción|Anulación de Ticket]]''' según el [[Financiadores|financiador]]. Los campos que no aparecen son de envío opcional.

[[OSDE]]/CAJA FORENSE/DOCTHOS/CIMESA/FEMEBA/OSETYA/[[OSEP]]/[[ServeSalud]]:
*[[#_svl.1|Archivo SVL.1]] 0,1,2,3,5
PAMI/ OSSEG:
*[[#_svl.1|Archivo SVL.1]] 0,1,2,3
*[[#_svl.3|Archivo SVL.3]] 0,9

== Relación entre transacción y los archivos de envio y respuesta ==

{| bgcolor="#CCCCFF"
|| '''Operación''' ||colspan="5"| '''Archivos de Envío necesarios''' ||colspan="8"| '''Archivos de Respuesta'''
|-
| || [[#_svl.0|_svl.0]] || [[#_svl.1|_svl.1]] || [[#_svl.3|_svl.3]] || [[#_svl.4|_svl.4]] || [[#_sal.0|_sal.0]] || [[#_svl.1|_svl.1]] || [[#_svl.3|_svl.3]] || [[#_svl.4|_svl.4]] || [[#_sal.0|_sal.0]] || [[#_sal.1|_sal.1]] || [[#_sal.2|_sal.2]] || [[#_sal.3|_sal.3]] || [[#_sal.4|_sal.4]]
|-
| Autorización / Rescate de Receta || X || X || X || X<ref>La inclusión de este archivo depende del manejo que el financiador haga de los diagnósticos presuntivos. Para la mayoría el diagnóstico va incluido dentro del archivo [[#_svl.3|_svl.3]]</ref> || || X || X || || || || || ||
|-
| [[Anular Transacción|Anulación]] || X || X || || || || X || || || || || || ||
|-
| Devolución || X || X || X || || || X || X || || || || || ||
|-
| Cierre / Consulta de Lotes || X || || || || X || || || || X || || || ||
|-
| Act. Planes || X || || || || X || || || || || X || || ||
|-
| Act. Médicos || X || || || || X || || || || || X || X || ||
|-
| Act. Medicamentos || X || || || || X || || || || || X || || X ||
|-
| Diagnósticos || X || || || || X || || || || || X || || || X

|}

== Registración y Licencias Disponibles ==
SiTEL provee dos mecanismos para mantener actualizados tanto los financiadores que requieren auditoría en línea, como las operaciones disponibles y los datos necesarios para cada una. De manera que, es recomendable realizar la homologación permitiendo la consulta del software de gestión a estas tablas de manera de evitar la necesidad de futuras modificaciones. El [[Sitel Cliente|cliente SITEL]] genera un archivo llamado [[#_sitel.emp|_sitel.emp]] cada vez que se ejecuta o se realiza una registración de licencia (desde el mismo SITEL Cliente). El objetivo del mismo es que el software homologado tenga actualizadas todas las empresas y actividades con las que está autorizada a operar cada farmacia (licencia). Este archivo queda grabado en el directorio de las terminales.

=== _sitel.emp ===
{{:Sitel.emp}}

=== _sitel.prm ===
{{:Sitel.prm}}

== Obtener un set de transacciones de ejemplo ==
*[[Media:Set Transacciones Ejemplo V250 Fcia.zip|Bajar set desde aquí]].
*[[Media:Set Transacciones Ejemplo V250 Fcia con Lectura Banda.zip|Bajar aquí ejemplo con lectura de banda magnética]].

== Impresión de un Ticket ==
Cada transacción es acompañada de un archivo [[Ticket_Medicamentos|_ticket.prn]] que contiene todos los datos de la transacción en un formato legible. Ese ticket debe firmarlo el afiliado y debe entregarse una copia al financiador para dejar constancia.

Existen tres formas de emitir un ticket:
#'''Imprimir el ticket (archivo) [[Ticket_Medicamentos|_ticket.prn]]'''. Esto puede realizarse en cualquier impresora inclusive en una impresora fiscal (saldrá con la leyendo "Comprobante no fiscal homologado"). Usualmente esta impresión la realiza la misma [[Sitel Cliente|aplicación de comunicaciones]] y puede realizarse en cualquier impresora de la red. Este ticket firmado se abrocha a la receta.
#'''Endosar la receta''': el archivo [[Ticket_Medicamentos|_ticket.prn]] 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 [[Sitel Cliente|aplicación de comunicaciones]]. Evita la pérdida del ticket.
#'''[[Ticket Medicamentos Fiscal|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 afiliado y número de transacción. Aquí se muestra un ejemplo: [[Imagen:TicketFiscalExplicado.jpg|thumb]].

== Notas ==
<references/>

[[Categoría:Estándares]]
[[Categoría:PuntoSalud]]
[[Categoría:Extranet]]
[[Categoría:Desarrolladores]]

@@ Línea 347: / Línea 347: @@
 === _svl.3 ===
 Listado de medicamentos a dispensar. ''N'' registros. Este archivo contiene una descripción de cada uno de los items de la receta.
 {| class="wikitable"
@@ Línea 513: / Línea 514: @@
 |-
 | 19
 | Reservado
 | SITEL
-| C(28)
+| C(18)
 | 217
+|

Formato V250 Farmacia - Historial de revisiones

imported>Javier: /* _svl.3 */

imported>Javier: /* _svl.3 */