CMS - Carga CSV de Reclamaciones

Resumen

El sistema de carga de CSV para la Gestión de Reclamaciones permite subir y gestionar los datos del flujo de reclamaciones mediante dos archivos CSV: uno en inglés y otro en árabe. El sistema incluye validación, funcionalidad de vista previa y gestión de errores para garantizar la integridad de los datos.

Leyenda de códigos de referencia

Acciones

Código Definición
X Ir al siguiente nodo
Q Pregunta al cliente
QP Pedir prueba al cliente, subir foto
S Mostrar el pedido del cliente para elegir un artículo
CB Devolver llamada al cliente
R Reembolso
R30 Reembolso del 30% del artículo por defecto
T Valoración
TT Transferencia del ticket a un agente para evaluación manual
QD Cuadro de diálogo
QPD Cuadro de diálogo y subida de foto
PHONE Facilitar el teléfono del repartidor en el campo variable {%phone%}
R100P150 Reembolso del 100% del valor del pedido, hasta 150 SAR

Estado

Código Definición
CA Cerrado - Abandonado
C Cerrado
O Abierto

Condiciones

Código Definición
NOPHONE El teléfono del repartidor no está disponible
YESPHONE El teléfono del repartidor está disponible
RP Reembolso de Garantía Platinum procesado
RNP Reembolso de Garantía no procesado
GSE Suscripción Gold caducada
GSNE Suscripción Gold no caducada
GTP El cliente pasó de Gold a Platinum
PSE Suscripción Platinum caducada
PSNE Suscripción Platinum no caducada
SLABD30 Incumplimiento del SLA de entrega - Garantía Platinum de 30 min desde el inicio teórico de producción hasta la llegada al cliente
NOSLAB30 No se ha incumplido el SLA de entrega Platinum de 30 min
SLABPU15 Incumplimiento del SLA de recogida - Garantía Platinum de 15 min desde el inicio teórico hasta el fin real de producción
NOSLAB15 No se ha incumplido el SLA de recogida Platinum de 15 min
SLABD Incumplimiento del SLA de entrega (SLA = 40 min)
SLABPU Incumplimiento del SLA de recogida (SLA = 15 min)
N Sin condición
ITEMCHECKS El artículo seleccionado del pedido debe ser únicamente un acompañamiento
NOSLAB Sin incumplimiento de SLA en recogida ni en entrega
CHECKCUSTY Se han añadido personalizaciones a la pizza
CHECKCUSTN No se han añadido personalizaciones a la pizza
ORSPT El pedido es para recoger en tienda (Pickup/Takeaway)
ORSD El pedido es a domicilio (Delivery)
SLABD20 El incumplimiento del SLA está entre 1 y 20 min
SLABD2035 El incumplimiento del SLA está entre 20 y 35 min
SLABD3550 El incumplimiento del SLA está entre 35 y 50 min
SLABD50+ El incumplimiento del SLA supera los 50 min
WMP Hay saldo disponible en el monedero (wallet) de la cuenta
WMPF El saldo del monedero es 0
EXEMPT Si el reembolso se concede con Exempt en la Acción, no debe contabilizarse en el perfilado futuro del cliente

Variables

Código Inglés Árabe
{%wallet%} (%AMOUNT%) in your wallet (%AMOUNT%) في محفظتك.
{%wallet%} (%Loyalty Points%) rewards points (%Loyalty Points%) نقطة مكافأة.
{%wallet%} (%AMOUNT%) in your wallet & (%Loyalty Points%) rewards points (%AMOUNT%) في محفظتك و (%Loyalty Points%) نقطة مكافأة.
{%currency%} SAR ريال سعودي.
{%currency%} AED درهم إماراتي.

(El contenido de esta tabla corresponde a los textos exactos que el sistema inserta en inglés y árabe; no se traduce para no alterar las cadenas reales usadas en producción.)

Niveles de fidelización (Loyalty Tiers)

Código Definición
S Silver (Plata)
G Gold (Oro)
P Platinum (Platino)

Tipos de cliente

Código Definición
H Healthy (saludable / sin incidencias)
A Alert (en seguimiento)
B Abusive (abusivo)

Flujo del proceso de carga

1. Selección de archivos

2. Validación de archivos

El sistema realiza una validación exhaustiva en el siguiente orden:

  1. Validación de formato: comprueba la estructura del archivo y las columnas requeridas.
  2. Validación de datos: valida los tipos de datos y los campos obligatorios.
  3. Validación de flujo: verifica la lógica del flujo de los procesos de reclamación.

3. Ejecución de la carga

Requisitos de formato de archivo

Estructura del CSV en inglés

Columnas obligatorias (distinguen mayúsculas/minúsculas):

Separador de columnas: punto y coma (;)

Estructura del CSV en árabe

Columnas obligatorias (distinguen mayúsculas/minúsculas):

Separador de columnas: punto y coma (;)

Proceso de validación

Paso 1: Validación del formato del archivo

El sistema comprueba:

Errores de formato habituales:

Paso 2: Validación del tipo de datos

El sistema valida:

Errores de datos habituales:

Paso 3: Validación del flujo

Comprobaciones avanzadas de validación:

Indicadores de estado de la carga

Iconos de estado del archivo

Mensajes de estado de la carga

Mensajes de error y soluciones

Errores de selección de archivo

Error Solución
"Select both English and Arabic CSV files" Debe seleccionar tanto el CSV en inglés como el CSV en árabe
"Both files must be validated" Haga clic en "Validate Files" tras seleccionar ambos archivos

Errores de validación de formato

Error Causa Solución
"File must contain header and at least one data row" Archivo vacío o sin datos Asegúrese de que el archivo tiene cabecera y filas de datos
"Missing required column: [COLUMN_NAME]" No se encuentra una columna obligatoria Añada la columna que falta a la cabecera del CSV
"Row X: Column count mismatch" Número de columnas inconsistente Asegúrese de que todas las filas tienen el mismo número de columnas
"Error reading CSV file" Corrupción del archivo o problema de codificación Vuelva a guardar el archivo como CSV UTF-8 con separador de punto y coma

Errores de validación de datos

Error Causa Solución
"Row X: NODE_ID must be numeric" NODE_ID no numérico Asegúrese de que NODE_ID contiene solo números
"Row X: CUST_ID must be numeric" CUST_ID no numérico Asegúrese de que CUST_ID contiene solo números
"Row X: PARENT_NODE_ID must be numeric or NULL" Referencia de nodo padre inválida Use números o exactamente "NULL"
"Row X: Arabic description is required" Falta el texto en árabe Añada la descripción en árabe para todos los nodos

Errores de procesamiento en el servidor

Error Causa Solución
"No valid English CSV data found" Archivo en inglés vacío o inválido Revise el formato y los datos del archivo en inglés
"No valid Arabic CSV data found" Archivo en árabe vacío o inválido Revise el formato y los datos del archivo en árabe
"English CSV row X: Invalid NODE_ID" Fallo de validación en el servidor Revise el formato y la unicidad del NODE_ID
"Arabic CSV row X: Missing Description (Arabic)" Fallo de validación en el servidor Asegúrese de que todas las descripciones en árabe están presentes
"Maximum 2 files allowed" Se han subido demasiados archivos Suba exactamente 2 archivos (inglés + árabe)

Errores de validación del flujo

Error Causa Solución
"The flow of both files must be validated" No se ha realizado la validación del flujo Haga clic en el botón "Validate Flow"
"The files have flow validation errors that must be corrected" La validación del flujo encontró incidencias Revise el cuadro de diálogo de validación de flujo para ver los errores concretos

Guía de resolución de problemas

Problema: los archivos no se suben

Compruebe:

Problema: la validación falla repetidamente

Soluciones:

  1. Descargue los datos actuales para ver el formato esperado
  2. Compruebe la codificación del archivo (debe ser UTF-8)
  3. Verifique que el separador de columnas es el punto y coma (;)
  4. Asegúrese de que no hay caracteres ocultos ni formato adicional

Problema: la validación del flujo muestra errores

Acciones:

  1. Abra el cuadro de diálogo de validación de flujo
  2. Revise los mensajes de error concretos
  3. Compruebe las relaciones padre-hijo en los datos
  4. Verifique la integridad de la jerarquía de nodos
  5. Corrija los datos y vuelva a validar

Problema: la carga falla tras la validación

Investigación:

  1. Compruebe la conexión con el servidor
  2. Verifique los límites de tamaño de archivo
  3. Revise la consola del navegador en busca de errores
  4. Contacte con el administrador del sistema si el problema persiste

Notas técnicas

Comportamiento del sistema

Buenas prácticas

Preparación del archivo

  1. Use una codificación consistente: guarde los archivos CSV como UTF-8
  2. Compruebe los separadores: use el punto y coma (;) como separador de columnas
  3. Valide los NODE_ID: asegúrese de que los NODE_ID coinciden entre el archivo en inglés y el archivo en árabe
  4. Revise las descripciones: verifique que todas las descripciones sean coherentes y estén completas

Prevención de errores

  1. Uso de plantillas: use una exportación de datos existente como plantilla para nuevas cargas
  2. Validación de datos: revise los datos en una hoja de cálculo antes de exportar
  3. Estrategia de copia de seguridad: conserve los archivos originales como copia de seguridad antes de procesarlos
  4. Pruebe con un conjunto de datos pequeño: valide el proceso con un subconjunto de datos primero

Estrategia de carga

  1. Validación secuencial: complete la validación de archivos antes de la validación de flujo
  2. Revisión antes de subir: compruebe todos los mensajes de validación antes de la carga final
  3. Selección de marca: verifique que la marca correcta está seleccionada antes de subir
  4. Momento de la carga: realice las cargas en horas de bajo tráfico
Created 2026-09-09 22:36:09 UTC by Fran Sanchis
Updated 2026-09-17 17:48:22 UTC by Fran Sanchis