Especificaciones del Archivo de Entrada
Este documento define la estructura técnica y los requisitos de formato para los archivos de cobro de Débito Automático.
Convención de Nomenclatura de Archivos
Los archivos deben seguir un patrón de nomenclatura estricto para que el motor pueda identificar y enrutar correctamente cada lote:
*SellerCode*_YYYYMMDD_IN.txt
Ejemplo: 65059_20250528_IN.txt
Restricciones Técnicas
La siguiente tabla resume los límites generales y los requisitos de formato que se aplican a cada archivo de entrada:
| Requisito | Especificación |
|---|---|
| Formato de Archivo | Texto plano (.txt) ancho fijo o delimitado (según hoja de integración) |
| Codificación | UTF-8 (sin BOM) |
| Máximo de Registros | 1.000.000 de líneas |
| Tamaño Máximo | 250 MB |
Especificaciones de los Campos
Cada registro en el archivo de entrada debe contener los siguientes campos, utilizando los tipos de datos y reglas descritos en esta tabla:
| Nombre del Campo | Tipo (Tamaño) | Obligatorio | Descripción |
|---|---|---|---|
| Card PAN | Numérico (19) | Sí | Número de tarjeta. Envíe siempre exactamente 19 dígitos, completando con ceros a la izquierda si es necesario (p. ej., 5123 debe enviarse como 00000000000000005123). |
| Order ID | String (36) | Sí | ID único utilizado para rastrear el débito desde el alta hasta la cancelación. |
| Charge Date | Fecha (YYYYMMDD) | Sí | La fecha en la que debe ejecutarse la transacción. |
| Amount | Numérico (25) | Sí | Valor en la unidad mínima de la moneda local (p. ej., 102,25 EUR se envía como 0000000000000000000010225 para alcanzar 25 dígitos). Rellene siempre con ceros a la izquierda hasta que la longitud sea de 25 caracteres. |
| Customer Reference Code | String (36) | No | Identificador interno del comercio para el cliente. |
| Operation | String (6) | Sí | CREDIT, DEBIT o CANCEL. |
| Soft Descriptor | String (22) | No | Texto que aparece en el extracto del titular de la tarjeta (p. ej., DETALLE*TIENDA). |
Lógica de Formato
Al construir cada línea del archivo, aplique estas reglas de formato de manera consistente en todos los registros:
- Gestión de Decimales: No incluya puntos ni comas. Multiplique el importe por 100 para enviar el valor en céntimos.
- Relleno (Padding): Los campos numéricos deben rellenarse con ceros a la izquierda hasta alcanzar la longitud especificada.
- Devoluciones: Para procesar una devolución, utilice el tipo de operación CANCEL y proporcione el Payment ID de la transacción original.
Próximos Pasos
Utilice estas guías relacionadas para aplicar esta especificación en su operativa diaria.
- Cuando su archivo esté listo, continúe con Carga y Gestión de Archivos de Cobro para enviar el lote y verificar los estados de validación iniciales.
- Para entender qué se devuelve tras la ejecución, revise el Diccionario de Datos del Archivo de Salida para que su lógica de conciliación mapee correctamente cada campo de resultado.
- Si necesita conocer restricciones operativas más amplias, consulte Reglas de Procesamiento y Plazos antes de programar ejecuciones de gran volumen.
En esta página