Procesamiento por lotes
En la Procesamiento por lotes sección, puede ejecutar operaciones masivas para:
- Reembolsos: Devolver el importe total o parcial de una transacción.
- Captura de transacciones: Confirmar la retención de fondos previamente autorizados.
- Anulación de transacciones: Cancelar una transacción autorizada antes de que se capture el importe.
Esta herramienta facilita la carga de un gran volumen de transacciones mediante la subida de un archivo CSV.
1. Descargar el modelo#
Para asegurar que los datos cargados son correctos y cumplen con el formato requerido, el sistema ofrece un archivo CSV de ejemplo para cada operación (modelo). Este modelo contiene los campos necesarios para cada operación soportada.
- Acceder a la sección de Procesamiento por lotes.
- Descargar el modelo CSV correspondiente a la operación que desea ejecutar (reembolso, captura o anulación).
- Completar el modelo con los datos de las transacciones que desea procesar. Asegúrese de que los valores introducidos respeten el formato de cada columna.
Reembolsos
La siguiente tabla muestra el modelo para reembolsos:
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| batch_id | Encabezado | Identificador único asignado por el usuario, no puede repetirse por lote. (Numérico) |
| transaction_type | Encabezado | En el caso del modelo de reembolso, el valor debe ser refund |
| razón | Encabezado | El usuario puede especificar, por lote, una razón para la operación (por ejemplo, cancelación de vuelo). |
| transaction_id | Fila | Identificador único de la transacción a reembolsar. |
| moneda | Fila | Moneda de la transacción (por ejemplo, USD, MXN). |
| amount_to_refund | Fila | Importe a reembolsar (parcial o total). El valor de centavos debe incluirse, sin comas ni puntos. (por ejemplo, 1226.00 USD, el importe 122600 debe introducirse) |
Capturas
La siguiente tabla define el modelo para capturas de pago:
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| batch_id | Encabezado | Identificador único asignado por el usuario, no puede repetirse por lote. (Numérico) |
| transaction_type | Encabezado | En el caso del modelo de captura, el valor debe ser capture |
| transaction_id | Fila | Identificador único de la transacción a reembolsar. |
| moneda | Fila | Moneda de la transacción (por ejemplo, USD, MXN). |
| amount_to_refund | Fila | Importe a reembolsar (parcial o total). El valor de centavos debe incluirse, sin comas ni puntos. (por ejemplo, 1226.00 USD, el importe 122600 debe introducirse) |
Anulaciones
La siguiente tabla define el modelo para anulaciones de pagos:
| Nombre del campo | Tipo | Descripción |
|---|---|---|
| batch_id | Encabezado | Identificador único asignado por el usuario, no puede repetirse por lote. (Numérico) |
| transaction_type | Encabezado | En el caso del modelo de anulación, el valor debe ser void |
| transaction_id | Fila | Identificador único de la transacción a reembolsar. |
2. Subir el archivo#
Subir el archivo CSV completado en DEUNA Admin:
- Ir a Procesamiento por lotes.
- Hacer clic en Subir lote
- Asignar un nombre a la subida de archivos.
- Subir el archivo CSV
- Hacer clic en Validar.
3. Revisar los resultados del lote#
Los posibles estados del archivo son los siguientes:
| Estado | Descripción | Acción requerida |
|---|---|---|
| Validando | El archivo ha sido subido y está siendo validado. | Wait. |
| Para resolver | El archivo tiene errores que requieren intervención manual. | Corregir los errores y volver a subir el archivo. |
| Rechazado | El archivo ha fallado en la validación. | Revisar y corregir los errores indicados y volver a subir el archivo. |
| En proceso | El archivo ha pasado la validación y está siendo procesado. | Esperar a que finalice el procesamiento. |
| Completado | El procesamiento del archivo ha finalizado. | Revisar los resultados en el archivo de respuesta. |
Errores en el archivo
Descargar un archivo con los detalles de error por archivo o por transacción si el archivo contiene errores.
La siguiente tabla documenta los posibles errores y sus categorías:
| Categoría | Nombre del error | Descripción | Código de error |
|---|---|---|---|
| Formato de archivo incorrecto | fila vacía | Campo requerido para ejecutar la operación. | BT1 |
| Argumentos de archivo incorrectos | fila vacía | Campo requerido para ejecutar la operación. | BT2 |
| Formato de archivo incorrecto | Formato de fila incorrecto | Formato incorrecto en una columna. | BT3 |
| Formato de archivo incorrecto | MissingBatchIDHeader | El ID de lote debe incluirse en el encabezado. | BT4 |
| Formato de archivo incorrecto | MissingTransactionTypeHeader | El tipo de transacción debe incluirse en el encabezado. | BT5 |
| Formato de archivo incorrecto | FaltaFila Vacía | La segunda línea del archivo debe estar vacía. Se recomienda descargar el modelo. | BT6 |
| Formato de archivo incorrecto | MissingDataRowsHeader | Los encabezados requeridos deben incluirse. | BT7 |
| Formato de archivo incorrecto | MissingOrderTokenHeader | El ID de transacción debe incluirse en el encabezado. Se recomienda descargar el modelo. | BT8 |
| Formato de archivo incorrecto | MissingCurrencyHeader | La moneda debe incluirse en el encabezado. Se recomienda descargar el modelo. | BT9 |
| Formato de archivo incorrecto | MissingAmountToCaptureHeader | amount_to_capture debe incluirse en el encabezado. Se recomienda descargar el modelo. | BT10 |
| Formato de archivo incorrecto | MissingAmountToRefundHeader | amount_to_refund debe incluirse en el encabezado. Se recomienda descargar el modelo. | BT11 |
| Argumentos de archivo incorrectos | ID de lote no válido | El ID de lote es inválido. | BT12 |
| Argumentos de archivo incorrectos | InvalidTransactionType | El tipo de transacción introducido es inválido. | BT13 |
| Formato de archivo incorrecto | Token de pedido no válido | El ID de transacción introducido es inválido. | BT14 |
| Formato de archivo incorrecto | Moneda no válida | La moneda introducida es inválida. | BT15 |
| Formato de archivo incorrecto | Cantidad no válida | El importe introducido es inválido. | BT16 |
| Formato de archivo incorrecto | CurrencyHeaderShouldBeEmpty | El archivo del modelo de anulación no debe contener moneda en el encabezado. Se recomienda descargar el modelo. | BT17 |
| Formato de archivo incorrecto | CurrencyShouldBeEmpty | El archivo del modelo de anulación no debe contener un valor de moneda en el encabezado. Se recomienda descargar el modelo. | BT18 |
| Formato de archivo incorrecto | AmountHeaderShouldBeEmpty | El archivo del modelo de anulación no debe contener un importe en el encabezado. Se recomienda descargar el modelo. | BT19 |
| Formato de archivo incorrecto | La cantidad debería estar vacía | El archivo del modelo de anulación no debe contener un valor de importe en el encabezado. Se recomienda descargar el modelo. | BT20 |