Documentation Index

Fetch the complete documentation index at: https://docs.unitedpetroleum.app/llms.txt

Use this file to discover all available pages before exploring further.

​

Importación de Consumos

​

Acceso al Módulo de Importación

1. Navegue a Paso Rápido > Consumos
2. Haga clic en el botón Importar en la barra superior
3. Será redirigido a la página de importación

​

Origen de los Archivos

• Autopistas del Nordeste (ANJE)
• Oficina de Ingenieros Supervisores de Obras del Estado (OISOE)
• Autoridad Metropolitana de Transporte (AMET) - peajes metropolitanos
• Otros operadores regionales

• Resúmenes mensuales: Al cierre de cada mes
• Reportes semanales: Algunos operadores ofrecen entregas más frecuentes
• Consultas en línea: Algunos sistemas permiten descarga directa

• Archivos Excel (.xlsx, .xls)
• Archivos CSV (.csv)
• Reportes PDF (requieren conversión manual)

​

Formato Requerido del Archivo

​

Estructura del Archivo Excel

​

Formatos Aceptados para Cada Campo

​

ID / Número

• Formato: Número entero
• Ejemplos válidos:
  • 45678
  • 123456
  • 9876543
• No aceptados:
  • Texto: ID-45678
  • Vacío

​

Fecha

• DD/MM/YYYY HH:MM:SS → 15/02/2026 10:30:45
• DD/MM/YYYY HH:MM → 15/02/2026 10:30
• DD/MM/YYYY → 15/02/2026 (asume 00:00:00)
• YYYY-MM-DD HH:MM:SS → 2026-02-15 10:30:45
• DD-MM-YYYY → 15-02-2026
• Fechas de Excel (número serial) → 45337.4375

15/02/2026 10:30 AM
15/02/2026 14:30
2026-02-15 10:30:00
45337.4375 (número serial de Excel)

Febrero 15, 2026
15-Feb-2026
02/15/2026 (formato MM/DD/YYYY americano)
Vacío

​

Tag / Tagín

• Formato: Número entero (sin guiones ni espacios)
• Ejemplos válidos:
  • 123456
  • 456789
  • 1234 (tags cortos son válidos)
• El sistema normalizará:
  • 000123456 → 123456
  • Espacios serán eliminados
• No aceptados:
  • Texto: TAG-123456
  • Vacío

​

Estación

• Formato: Texto
• Ejemplos válidos:
  • Las Américas
  • Juan Pablo II
  • San Cristóbal
  • Peaje Duarte Km 25
• Nota: El nombre debe coincidir con las estaciones registradas en el sistema. Variaciones menores se manejan automáticamente.

​

Monto

• Formato: Número decimal
• Ejemplos válidos:
  • 150 (asume 150.00)
  • 150.00
  • 150.50
  • RD$ 150 (el sistema elimina símbolos)
• No aceptados:
  • Texto: Ciento cincuenta pesos
  • Vacío
  • Negativo (se convertirá a valor absoluto automáticamente)

​

Tipo

• Formato: Texto
• Valor esperado: PASE (en mayúsculas o minúsculas)
• Otros valores aceptados:
  • pase
  • Pase
  • PASO
• Validación: El sistema solo importa registros tipo “PASE”. Otros tipos serán rechazados.

​

Propietario / Fleet (Opcional)

• Formato: Texto
• Ejemplos:
  • UNITED LOGISTICS
  • TRANSPORTE
  • Número de cuenta corporativa
• Si no está presente, se deja vacío

​

Ejemplo de Archivo Válido

| ID     | Fecha            | Tag    | Estación        | Monto | Tipo | Propietario |
|--------|------------------|--------|-----------------|-------|------|-------------|
| 45678  | 15/02/2026 10:30 | 123456 | Las Américas    | 150   | PASE | TRANSPORTE  |
| 45679  | 15/02/2026 11:45 | 789012 | Juan Pablo II   | 100   | PASE | LOGÍSTICA   |
| 45680  | 15/02/2026 14:20 | 345678 | San Cristóbal   | 130   | PASE | TRANSPORTE  |

​

Proceso de Importación Paso a Paso

​

Paso 1: Preparar el Archivo

• ✅ Todas las columnas obligatorias están presentes
• ✅ Los encabezados son claros (ID, Fecha, Tag, etc.)
• ✅ No hay columnas completamente vacías

• ✅ No hay filas completamente vacías en medio de los datos
• ✅ Las fechas están en formato correcto
• ✅ Los tags son números (sin texto adicional)
• ✅ Los montos son números (pueden tener RD$ pero no texto)
• ✅ El tipo dice “PASE”

• Encabezados duplicados en medio del archivo
• Filas de totales o resúmenes
• Notas al pie

• Formato recomendado: .xlsx (Excel moderno)
• También aceptado: .xls (Excel antiguo), .csv

​

Paso 2: Cargar el Archivo

1. En la página de importación, haga clic en Seleccionar Archivo o arrastre el archivo a la zona de carga
2. El sistema realizará una validación preliminar:
   • Verifica que es un archivo Excel válido
   • Detecta las columnas automáticamente
   • Cuenta las filas de datos
3. Verá un resumen:
   ✅ Archivo válido detectado
   📊 Filas encontradas: 1,234
   📋 Columnas detectadas: 7
   

​

Paso 3: Mapeo de Columnas

Campo del Sistema          Columna del Archivo
───────────────────       ─────────────────────
ID                    →   [ ID ▼ ]
Fecha                 →   [ Fecha ▼ ]
Tag                   →   [ Tagín ▼ ]
Estación              →   [ Estación ▼ ]
Monto                 →   [ Monto ▼ ]
Tipo                  →   [ Tipo ▼ ]
Propietario (opcional)→   [ Cliente ▼ ]

1. Haga clic en el menú desplegable de cada campo
2. Seleccione la columna correcta de su archivo
3. Si una columna no aplica (opcional), déjela como “No mapear”

ID       Fecha            Tag      Estación       Monto
──────   ──────────────   ──────   ────────────   ──────
45678    15/02/2026 10:30 123456   Las Américas   150.00
45679    15/02/2026 11:45 789012   Juan Pablo II  100.00
...

​

Paso 4: Validación de Datos

1. Campos requeridos completos
   • Todas las filas tienen ID, fecha, tag, estación, monto, tipo
   • Se identifican filas con campos vacíos
2. Formato de fechas correcto
   • Todas las fechas son interpretables
   • No hay fechas en el futuro (warning, no error)
   • No hay fechas excesivamente antiguas (más de 5 años, warning)
3. Números válidos
   • IDs son números enteros positivos
   • Tags son números enteros
   • Montos son números positivos
4. Tipo válido
   • El campo “Tipo” contiene “PASE”
   • Otras transacciones son rechazadas
5. Duplicados en el archivo
   • Detecta si hay IDs repetidos en el mismo archivo
   • Advierte sobre posibles duplicados por fecha/tag/monto

✅ Validación completada exitosamente
📊 Total de registros: 1,234
✅ Registros válidos: 1,234
⚠️ Advertencias: 0
❌ Errores críticos: 0

[Botón: Proceder con la Importación]

⚠️ Validación completada con advertencias
📊 Total de registros: 1,234
✅ Registros válidos: 1,230
⚠️ Advertencias: 4
   - 3 filas con fechas futuras (se importarán)
   - 1 fila con propietario vacío (se importará)
❌ Errores críticos: 0

[Botón: Proceder con la Importación]
[Botón: Ver Detalles de Advertencias]

❌ Validación fallida - errores detectados
📊 Total de registros: 1,234
✅ Registros válidos: 1,200
⚠️ Advertencias: 4
❌ Errores críticos: 30
   - 15 filas con fecha inválida
   - 10 filas con tag vacío
   - 5 filas con tipo diferente a 'PASE'

[Botón: Ver Detalles de Errores]
[Botón: Descargar Reporte de Errores]

1. Haga clic en Ver Detalles de Errores
2. Descargue el Reporte de Errores (archivo Excel)
3. El reporte mostrará exactamente qué filas tienen problemas y por qué
4. Corrija el archivo original
5. Vuelva a cargar el archivo corregido

​

Paso 5: Confirmar e Importar

1. Revise el resumen final
2. Haga clic en Importar Datos
3. El sistema creará un nuevo lote de importación
4. Verá una barra de progreso

⏳ Importando consumos...
Progreso: [████████░░] 80% (1,000 / 1,234)
Tiempo estimado: 30 segundos

✅ Importación completada exitosamente

📊 Resumen:
   - Total procesado: 1,234 registros
   - Importados: 1,234
   - Duplicados omitidos: 0
   - Lote ID: #5678

⏭️ Próximo paso: Ejecutar validaciones sobre los consumos importados

[Botón: Ir a Consumos]
[Botón: Validar Ahora]

​

Paso 6: Verificación Post-Importación

• Navegue a Consumos
• Use el filtro “Lote de Importación”
• Seleccione el lote más reciente
• Verifique que la cantidad de registros es correcta

• Abra algunos consumos al azar
• Confirme que los datos se importaron correctamente
• Verifique fechas, montos, tags

• Sume el total de montos en el sistema
• Compare contra el total del archivo original
• Deben coincidir (o tener diferencias explicables por duplicados omitidos)

• No olvide ejecutar el proceso de validación
• Los consumos recién importados no están validados automáticamente

​

Manejo de Casos Especiales

​

Importar Datos Históricos

• Asegúrese de tener las asignaciones de tags correspondientes a esas fechas
• Las validaciones GPS solo funcionarán si hay datos de telemetría de ese período
• Puede tardar más tiempo debido al volumen

• Importe períodos históricos en orden cronológico
• Divida archivos muy grandes (más de 50,000 registros) en lotes mensuales

​

Importar Actualizaciones o Correcciones

• El sistema detecta duplicados por ID
• Si un ID ya existe, NO lo importará nuevamente
• Esto previene duplicación accidental

1. Elimine los consumos incorrectos primero (requiere permisos de administrador)
2. Luego importe el archivo corregido

​

Importar de Múltiples Operadores

• Cada importación crea un lote independiente
• Facilita rastrear el origen de los datos
• Permite manejar formatos diferentes de cada operador

• Use el campo de notas del lote para indicar el operador
• Ejemplo: “Datos de OISOE - Febrero 2026”

​

Archivos CSV

• Separador: Coma (,) o punto y coma (;)
• Codificación: UTF-8 (recomendado) o ISO-8859-1
• Primera fila: Encabezados de columnas

1. Abra el archivo en Excel
2. Archivo > Guardar Como
3. Seleccione “CSV (delimitado por comas)”
4. Guarde

• Archivos más ligeros
• Importación más rápida
• Menor probabilidad de errores de formato

• No soporta múltiples hojas
• Formato de fecha menos flexible

​

Errores Comunes y Soluciones

​

Error: “Columna de fecha no detectada”

1. Abra el archivo en Excel
2. Seleccione la columna de fecha
3. Formato > Celdas > Fecha
4. Seleccione formato DD/MM/YYYY
5. Guarde y vuelva a importar

​

Error: “Tag debe ser un número”

1. En Excel, use la función =DERECHA() o =VALOR() para extraer solo el número
2. O use Buscar y Reemplazar para eliminar el prefijo “TAG-”

​

Error: “Tipo debe ser ‘PASE’”

1. Filtre en Excel solo las filas con Tipo = “PASE”
2. Copie esas filas a un nuevo archivo
3. Importe el archivo filtrado

​

Error: “ID duplicado detectado”

• Si es un archivo nuevo, verifique que no haya duplicados en el archivo mismo
• Si es una re-importación, los duplicados se omitirán automáticamente

​

Advertencia: “Fecha en el futuro”

• Verifique si es un error de formato (DD/MM vs MM/DD)
• Si son legítimos (cargos programados), puede ignorar la advertencia e importar

​

Mejores Prácticas

​

1. Nomenclatura de Archivos

Formato recomendado:
[Operador]_[Periodo]_[FechaDescarga].xlsx

Ejemplos:
OISOE_Feb2026_20260305.xlsx
Autopistas_Sem06_20260210.xlsx
ANJE_Ene-Feb2026_20260301.xlsx

• Fácil identificación del contenido
• Orden cronológico en el explorador de archivos
• Previene confusión entre archivos similares

​

2. Carpeta Organizada

Documentos/
└── PasoRapido/
    ├── 2026/
    │   ├── Enero/
    │   │   ├── OISOE_Ene2026_Original.xlsx
    │   │   ├── OISOE_Ene2026_Importado.xlsx ✅
    │   │   └── Autopistas_Ene2026_Importado.xlsx ✅
    │   └── Febrero/
    │       ├── OISOE_Feb2026_Original.xlsx
    │       └── OISOE_Feb2026_Procesado.xlsx
    └── Plantillas/
        └── Plantilla_Importacion.xlsx

​

3. Validación Pre-Importación

1. Seleccione la columna de ID
2. Formato condicional > Reglas de celdas > Duplicar valores
3. Revise si hay IDs repetidos

1. Note la última fila con datos
2. Reste fila de encabezado
3. Este es su total esperado

1. Seleccione columna de fecha
2. Use MIN() y MAX() para ver el rango
3. Confirme que es el período esperado

​

4. Documentación de Importaciones

• Rastrear qué se ha importado
• Evitar importaciones duplicadas
• Documentar discrepancias

​

5. Respaldo de Archivos

• Archivo original sin modificar (recibido del operador)
• Archivo procesado (listo para importar)
• Reporte de validación (si hubo errores)

​

6. Importación Periódica

• Importe al recibir el cierre mensual del operador
• Típicamente primera semana del mes siguiente

• Solicite reportes semanales a los operadores
• Permite detección más temprana de problemas
• Facilita la gestión de reclamos oportunos

• Si hay acceso a portal en línea del operador
• Monitoreo en tiempo casi real
• Máximo control

​

Permisos y Acceso

​

Roles que Pueden Importar

• OrgAdmin: Acceso completo a importación
• User: Puede ver importaciones pero no ejecutarlas
• SuperAdmin: Acceso completo a todas las organizaciones

​

Auditoría de Importaciones

• Quién realizó cada importación
• Cuándo se realizó
• Archivo original (nombre)
• Cantidad de registros importados
• Resultado de validaciones

​

Resumen

• ✅ Preparación cuidadosa del archivo Excel
• ✅ Verificación de formato antes de cargar
• ✅ Mapeo correcto de columnas
• ✅ Atención a errores de validación
• ✅ Verificación post-importación de datos
• ✅ Documentación de cada importación
• ✅ Respaldo de archivos originales
• ✅ Importación regular según calendario establecido