Importación del sistema de carga GNV

Para qué sirve

El sistema de carga GNV (INFOGAS) registra cada carga del surtidor. Si algunas cargas no se digitaron en el POS, puedes importar su reporte de ventas (archivo CSV) y MDSYS Grifos crea las ventas que faltan, cada una en su turno, con su playero y su comprobante, más el recaudo de terceros si la fila lo trae.

La importación va en dos pasos: primero una vista previa sin crear nada; después confirmas y se crean las ventas.

Dónde está

Menú:Operación›GNV/gnv

Pestaña Importaciones (y pestaña Formato para configurar cómo se lee el archivo; ver Formato de importación).

Quién puede

Acción	Permiso
Ver el historial y abrir la vista previa de un lote	Permisognv.ver
Subir archivos, Confirmar e importar y Descartar	Permisognv.importar
Ver y guardar el Formato	Permisognv.importar

Antes de empezar

1. Configura el formato del archivo de tu sistema de carga en la pestaña Formato (ver Formato de importación, más abajo). Mientras no lo guardes, la estación usa un formato de ejemplo.
2. Verifica que las mangueras GNV de la playa tengan la posición (o el id del controlador) que usa el sistema de carga.
3. Que los turnos de esas horas estén abiertos o en cierre (no cerrados ni con el cierre Aprobado) y que cada manguera tuviera playero asignado a esa hora.
4. Importa antes de cambiar el precio del GNV: la fila se valida con el precio de lista vigente.

Paso a paso

Subir el archivo y ver la vista previa

1. Elige el archivo

   En Importar reporte del sistema de carga ("CSV de máx. 2 MB. Verás una vista previa antes de crear las ventas."), arrastra el archivo a Arrastra aquí el CSV del sistema de carga o haz clic para elegirlo.

2. Pulsa «Previsualizar»

   El sistema lee el archivo con el formato de la estación y valida cada fila. Si el mismo archivo ya se subió en esta estación verás "Ese archivo ya se subió: se muestra la importación existente."

3. Revisa la vista previa

   Aparece el nombre del archivo, su estado Vista previa, el resumen (N ok · N error · N dup.), las tarjetas Totales por manguera (Cargas, Volumen, Importe) y la tabla de filas.

Revisar las filas

Filtra con los botones Todas, OK, Error, Duplicado POS, Ya importada e Importada (cada uno con su cantidad). Columnas:

Columna	Qué muestra
Fila	Número de línea en el archivo
Estado	Estado de la fila y, debajo, los mensajes (por qué tiene error o por qué se omite)
Fecha y hora	Momento de la carga
Manguera · turno	Manguera (y el código de la venta creada, tras confirmar); debajo el turno y el playero
Volumen / importe	m³ y soles de la fila
Placa / recaudo	Placa y, si la fila trae cuota, la entidad y el monto

Estados de una fila:

Estado	Significado	Al confirmar
OK	Válida	Se crea la venta
Error	No cumple una regla (ver mensajes)	Se omite
Duplicado POS	Ya se digitó en el POS ("Ya registrada en el POS (venta X).")	Se omite
Ya importada	Ya se importó antes o está repetida en el archivo	Se omite
Importada	Tras confirmar: creó su venta	—

Confirmar

1. Pulsa «Confirmar e importar»

   El botón se activa si el lote está en Vista previa y tiene al menos una fila OK. Mientras procesa dice Confirmando… (un segundo toque se ignora).

2. Revisa el resultado

   Verás "Importación confirmada: N venta(s) creadas.". El lote pasa a Confirmada y las filas creadas muestran Importada con el código de su venta.

Al confirmar, el sistema vuelve a validar cada fila OK (pudo cambiar algo desde la vista previa): si una ya no es válida, se marca con su error y se omite; las demás se crean. Todo el lote se procesa en una sola operación: si ocurre un error inesperado, no se crea ninguna venta y puedes reintentar sin duplicar.

Descartar

Pulsa Descartar y confirma ("Se descartará la vista previa sin crear ventas."). El lote pasa a Descartada y puedes volver a subir el mismo archivo (por ejemplo, después de corregir el formato o los turnos).

Pulsa Cerrar para ocultar la vista previa.

Historial de importaciones

Filtros Estado (Todos los estados / Vista previa / Confirmada / Descartada), Desde y Hasta (fecha de subida). Columnas:

Columna	Qué muestra
Archivo	Nombre del archivo; debajo, fecha de subida y usuario
Estado	Vista previa Confirmada Descartada
Filas	N ok · N error · N dup.
Ventas creadas	Número de ventas creadas (solo en confirmadas)

Acción Ver: abre la vista previa del lote. Si no hay: "Aún no hay importaciones en la estación."

Cómo se arma cada venta importada

• Manguera: la del archivo, buscada por posición o id del controlador según el formato.
• Turno: el turno de la estación que estaba abierto a la hora de la carga.
• Playero (vendedor): el responsable asignado a esa manguera a esa hora.
• Fecha de la venta: la hora real de la carga.
• Precio: el que aplicaría hoy la venta (lista + reglas de cliente/medio de pago), que debe coincidir con el precio de lista que regía a la hora de la carga.
• Importe: m³ × precio debe coincidir con los soles del archivo con una tolerancia de S/ 0.05.
• Medio de pago: según el mapa Formas de pago del formato; si el archivo no trae forma de pago, el efectivo de la empresa.
• Documento: factura si la fila trae un RUC de un cliente registrado y placa; si no, el Comprobante por defecto (cargas sin documento del cliente) del formato (Boleta o Ticket (nota de venta); por defecto Boleta) al cliente genérico.
• Recaudo: si la fila trae cuota, con su entidad (debe estar configurada; si no trae entidad y hay una sola configurada, se usa esa).
• No duplicar: cada fila se identifica por su Nro. de transacción (si el formato lo trae) o por una huella de sus datos. Además, se busca en el POS una venta de la misma manguera, con ±0.005 m³ y dentro de la ventana de duplicado (por defecto 5 minutos).

Reglas del archivo

• Solo archivos CSV de texto (.csv o .txt), de hasta 2 MB y 5,000 filas.
• Si el formato dice que la primera fila es encabezado, ese encabezado debe tener las columnas obligatorias (fecha y hora, manguera, volumen e importe).
• Una fila mala no invalida el archivo: solo esa fila queda con error.
• Para confirmar, tu estación activa debe ser la del lote.

Mensajes de error frecuentes y qué hacer

Al subir el archivo

Mensaje	Por qué pasa	Qué hacer
"Elige el archivo CSV."	Pulsaste Previsualizar sin archivo	Elige el archivo
"Adjunta el archivo CSV del sistema de carga."	El archivo no llegó bien	Vuelve a elegirlo
"El archivo supera 2 MB." / "El archivo supera 5000 filas."	Archivo muy grande	Divídelo por días
"Solo se aceptan archivos CSV de texto."	Subiste un Excel u otro tipo	Exporta como CSV
"El archivo no tiene filas."	Archivo vacío	Revisa el archivo
"Faltan columnas en el encabezado: …"	El encabezado no coincide con el Formato	Corrige el formato o el archivo

En las filas (columna Estado)

Mensaje	Qué hacer
"Falta la fecha y hora." / "Fecha inválida: «…» (formato …)."	Revisa el Formato de fecha
"Falta la manguera." / "Manguera «X» no existe en la estación."	Revisa la posición o el id del controlador de la manguera
"La manguera «X» no despacha GNV." / "La manguera «X» está inoperativa."	Revisa la playa
"Valor inválido en m3: «…» (máx. 3 decimales)." / "Valor inválido en soles: …" / "m3 debe ser mayor que cero."	Revisa el Separador decimal
"Monto de recaudo inválido: «…»."	Revisa la columna de cuota
"La fecha de la carga es posterior a la hora actual."	Revisa la fecha del archivo
"No hay un turno de la estación a esa hora."	Abre o registra el turno correspondiente
"El turno X está cerrado: reabre su cierre para importar esta carga."	Reabre el cierre del turno (ver Turnos)
"El turno X está liquidado (inmutable)."	El cierre del turno ya está Aprobado: esa carga ya no se puede importar; regulariza a mano
"Supera el máximo por carga (X m³)."	Revisa el dato o el ajuste de máximo por carga
"La manguera no tenía playero asignado a esa hora."	Corrige la asignación del turno
"Medio de pago «X» sin mapear en el formato."	Agrega la forma de pago en Formas de pago
"La empresa no tiene un medio de pago en efectivo activo."	Activa un medio de pago de efectivo
"El GNV no tiene precio vigente en la estación."	Registra el precio del GNV
"El precio cambió después de la carga (S/ X a esa hora, hoy S/ Y): importa antes del cambio o regulariza a mano."	Importa antes de cambiar precios o registra el despacho a mano
"El importe S/ X no coincide con el precio vigente (m³ × precio = S/ Y)."	Revisa el precio o el archivo
"Sin serie para emitir boleta desde la estación: …"	Configura la serie del documento
"La entidad del recaudo «X» no está configurada."	Agrégala en Entidades de recaudo GNV
"El recaudo supera el máximo por carga (S/ X)."	Revisa el monto o el ajuste
"Fila repetida en el archivo." / "La carga ya fue importada antes."	Nada: se omite para no duplicar
"Ya registrada en el POS (venta X)."	Nada: el playero ya la digitó

Al confirmar o descartar

Mensaje	Por qué pasa	Qué hacer
"La importación ya no está previsualizada." / "Solo se descarta un lote previsualizado."	Ya se confirmó o descartó	Recarga el historial
"Cambia a la estación del lote para confirmarlo."	Tu estación activa es otra	Cambia de estación
"Bajo impersonación no se registran ventas."	Estás impersonando	Lo debe hacer un usuario real
"No se pudo confirmar. Reintenta: no se duplicarán ventas."	Falló la conexión	Pulsa de nuevo Confirmar e importar

Formato de importación

Pestaña Formato del mismo módulo (

Menú:Operación›GNV/gnv

). Solo la ve quien tiene Permisognv.importar. Arriba verás "Mapea las columnas del CSV del sistema de carga. Obligatorias: fecha y hora, manguera, volumen e importe."; si la estación aún no guardó el suyo, añade "(la estación usa el formato por defecto)".

Cada sistema de carga exporta su reporte de ventas con columnas, separadores y formatos de fecha distintos. En esta pestaña le dices a MDSYS Grifos cómo leer el archivo de tu estación: qué columna es la fecha, cuál la manguera, el volumen, el importe, etc. El formato se guarda por estación.

Formato por defecto

Mientras no guardes uno propio, la estación usa este formato de ejemplo (el formato real del proveedor del sistema de carga debe confirmarse con tu archivo):

Opción	Valor por defecto
Separador de columnas	Punto y coma (;)
Separador decimal	Coma (1,50)
Codificación	UTF-8
Formato de fecha	dd/mm/aaaa hh:mm:ss
La primera fila es encabezado	Sí
Columnas	FECHA, PICO, VOLUMEN, IMPORTE, NRO_TRX, PLACA, FORMA_PAGO, CUOTA, ENTIDAD, RUC_DNI
Identificar la manguera	Por posición de la manguera
Ventana de duplicado con el POS	5 minutos
Comprobante por defecto (cargas sin documento del cliente)	Boleta

Un archivo con ese formato se vería así:

FECHA;PICO;VOLUMEN;IMPORTE;NRO_TRX;PLACA;FORMA_PAGO;CUOTA;ENTIDAD;RUC_DNI
05/10/2026 14:20:31;5;10,582;20,00;884512;ABC123;EFECTIVO;15,00;COFIDE;
05/10/2026 14:31:02;6;8,466;16,00;884513;;VISA;;;

Configurar el formato paso a paso

1. Abre un archivo real

   Abre un CSV de tu sistema de carga con el Bloc de notas para ver el separador, el formato de la fecha y los nombres del encabezado.

2. Configura la sección «Archivo»

   Elige Separador de columnas, Separador decimal, Codificación, Formato de fecha y si La primera fila es encabezado.

3. Mapea las columnas

   En Columnas del CSV (nombre del encabezado o número de columna) escribe, para cada dato, el nombre de la columna tal como aparece en el encabezado (o su número, 1 = primera columna, si el archivo no tiene encabezado).

4. Configura las reglas

   Identificar la manguera, Ventana de duplicado con el POS (min), Comprobante por defecto (cargas sin documento del cliente) y Formas de pago.

5. Guarda

   Pulsa Guardar formato. Verás "Formato de importación guardado.". El cambio queda en la auditoría.

:::tip Prueba con una vista previa Después de guardar, sube un archivo en la pestaña Importaciones y revisa la vista previa: no se crea nada hasta que confirmes. Si sale mal, Descarta, corrige el formato y vuelve a subirlo. :::

Campos del formato

Archivo

Campo	¿Obligatorio?	Descripción
Separador de columnasLista	Sí	Punto y coma (;) · Coma (,) · Tabulador · Barra vertical (|).
Separador decimalLista	Sí	Coma (1,50) · Punto (1.50). Debe ser distinto del separador de columnas.
CodificaciónLista	Sí	UTF-8 · ISO-8859-1 (Latin-1). Si las tildes salen mal, prueba la otra.
Formato de fechaLista	Sí	dd/mm/aaaa hh:mm:ss · dd/mm/aaaa hh:mm · aaaa-mm-dd hh:mm:ss.
La primera fila es encabezadoInterruptor	No	Actívalo si la primera línea trae los nombres de las columnas.

Columnas del CSV

Campo	¿Obligatorio?	Descripción
Fecha y horaTexto	Sí	Columna con la fecha y hora de la carga.
Manguera / picoTexto	Sí	Columna con la posición o el id del controlador de la manguera.
Volumen (m³)Texto	Sí	Columna con los m³ (hasta 3 decimales).
Importe (S/)Texto	Sí	Columna con el importe en soles (hasta 2 decimales).
Nro. de transacción (opcional)Texto	No	Identificador único de la carga. Recomendado: evita importar dos veces la misma carga aunque cambie otro dato.
Placa (opcional)Texto	No	Placa del vehículo.
Forma de pago (opcional)Texto	No	Texto de la forma de pago (se traduce con Formas de pago). Sin esta columna, todo entra como efectivo.
Cuota de financiamiento (opcional)Texto	No	Monto del recaudo de terceros de la carga.
Entidad del recaudo (opcional)Texto	No	Entidad de la cuota (debe estar en Entidades de recaudo GNV).
RUC / DNI del cliente (opcional)Texto	No	Con un RUC de cliente registrado y placa, la venta se emite como factura.

Cada nombre de columna admite hasta 60 caracteres. Se comparan sin distinguir mayúsculas.

Reglas

Campo	¿Obligatorio?	Descripción
Identificar la mangueraLista	Sí	Por posición de la manguera o Por id del controlador (tal como están en la playa).
Ventana de duplicado con el POS (min)Número	Sí	Entre 0 y 60. Una fila se marca Duplicado POS si en el POS hay una venta de la misma manguera, ±0.005 m³, dentro de esos minutos.
Comprobante por defecto (cargas sin documento del cliente)Lista	Sí	Boleta o Ticket (nota de venta). Por defecto Boleta. Es el documento con el que se emiten las cargas importadas que no traen RUC/DNI de un cliente registrado. Las cargas con RUC de cliente registrado y placa se emiten como factura.
Formas de pago (una por línea: TEXTO=id de medio de pago)Texto	No	Traduce el texto del archivo al medio de pago del sistema. Ejemplo: EFECTIVO=1 y VISA=3 (el número es el id del medio de pago, ver Configuración). Solo medios activos y de contado.

Mensajes de error del formato

Mensaje	Por qué pasa	Qué hacer
"Indica la columna de "Fecha y hora"." (y las demás obligatorias)	Falta una columna obligatoria	Escribe el nombre o número de la columna
"Columna obligatoria."	El servidor no recibió la columna	Complétala
"Entre 0 y 60 minutos."	Ventana fuera de rango	Corrige el número
"Línea N: usa el formato TEXTO=id_de_medio_de_pago."	Una línea de Formas de pago está mal escrita	Escribe TEXTO=número
"El separador decimal debe ser distinto del separador de columnas."	Elegiste coma en ambos	Cambia uno de los dos
"El medio de pago debe estar activo y ser de contado."	En el mapa pusiste un medio inactivo o de crédito	Usa un medio activo de contado
"Medio de pago no encontrado."	El id no existe en tu empresa	Revisa el id
"Valor no permitido."	Una opción no es válida	Elige una opción de la lista; si persiste, avisa a soporte

Relación con otros módulos

• Despachos manuales y cuadre: el cuadre separa lo importado de lo digitado en el POS y lo manual.
• Recaudo y rendición.
• Configuración: posición e id del controlador de las mangueras.
• Configuración: medios de pago y entidades de recaudo.
• Turnos y Comprobantes.

Ejemplo

Archivo ventas_gnv_05-10-2026.csv con 120 filas. Vista previa: 112 ok · 3 error · 5 dup. Los 3 errores son de la manguera 7, que figura como inoperativa; los 5 duplicados ya los digitó el playero en el POS. Confirmas: se crean 112 ventas, cada una en su turno y con su boleta; 40 de ellas traían cuota de S/ 15.00 de COFIDE, así que quedan S/ 600.00 por rendir.