Extract Files de embozado
Recibe todos los días un detalle confiable de tus tarjetas embozadas, listo para conciliar contra tus propios sistemas.
Introducción
Cada día emitimos y embozamos tarjetas para tu programa. Sin un detalle de ese proceso, conciliarlo contra tus sistemas depende de reportes manuales.
Desde Pomelo, generamos automáticamente un extract file con el detalle de las tarjetas embozadas del día anterior y lo dejamos en tu carpeta SFTP, similar a donde recibes el archivo de transacciones.
Así puedes conciliar el embosado sin pedir reportes manuales.
Alcance
Disponible para los clientes con Printing contratado que lo activen con nuestro equipo. El formato es el mismo para todos los programas: no varía según país, tipo de tarjeta, marca ni configuración particular.
Funcionamiento
El proceso se inicia todos los días a las 8:00 AM (hora Argentina) y sigue estos pasos:
- Generamos el extract file con el detalle de las tarjetas embozadas del día anterior.
- Armamos un archivo CSV con una fila por tarjeta, sin duplicados.
- Subimos el archivo a tu carpeta SFTP.
- Te notificamos el resultado (éxito o error) por correo.
Consideraciones
- El archivo incluye los procesos de embosado finalizados al momento de la generación. Si algún proceso del día anterior no terminó a tiempo, sus tarjetas no figuran en ese archivo. Si crees que falta alguna, contacta a nuestro equipo vía Dashboard.
- El proceso se inicia a las 8:00 AM (hora Argentina), pero el momento exacto en que el archivo queda disponible puede variar según la cantidad de archivos de embosado a procesar y la latencia de los servicios involucrados. Si no recibes el archivo y la notificación después de ese horario, contacta a nuestro equipo.
- Si no hubo procesos de embosado finalizados el día anterior, no generamos ningún archivo y te notificamos el error por correo. No recibes un archivo vacío.
- Si ya generamos correctamente el archivo de una fecha, las re-ejecuciones del día no lo sobrescriben. Si el proceso falla, te avisamos por correo: contacta a nuestro equipo y lo reintentaremos manualmente. No reintentamos de forma automática.
Recepción por SFTP
Recibes el extract file en tu carpeta SFTP, la misma donde recibes tus reportes y el archivo de transacciones. No necesitas hacer nada más para obtenerlo: cada día encontrarás ahí el nuevo archivo.
El archivo queda en la subcarpeta extract_files/v2/ de tu carpeta SFTP. Cada archivo lleva el nombre de la fecha en que se genera (el día en que corre el proceso):
extract_file_{fecha_de_generacion}.csv
Por ejemplo, el archivo generado el 16 de octubre de 2026, con datos del 15 de octubre, se llama extract_file_2026-10-16.csv.
Recibirás el primer extract file el día siguiente a que la configuración esté activa. No entregamos datos de fechas anteriores a la activación.
Contenido y formato del archivo
El archivo es un CSV separado por ; (no por coma), codificado en UTF-8, con encabezados y una fila por tarjeta:
| Campo | Descripción | Ejemplo |
|---|---|---|
| client_id | Identificador de tu programa. | cli-2AbCdEfGhIjKlMnOpQrStUvWxYz |
| user_id | Identificador del usuario titular de la tarjeta. | usr-3ZyXwVuTsRqPoNmLkJiHgFeDcBa |
| card_id | Identificador de la tarjeta embozada. | crd-4AaBbCcDdEeFfGgHhIiJjKkLlMm |
| card_created_at | Fecha de creación de la tarjeta. | 2026-10-14 |
| card_status | Estado de la tarjeta al momento de generar el archivo. | EMBOSSED |
| shipment_id | Identificador del envío asociado a la tarjeta. | shi-5NnOoPpQqRrSsTtUuVvWwXxYyZz |
| file_name | Nombre del archivo de embosado del que proviene la tarjeta (sin extensión ni ruta). | PRD_GID_MEX_cli-2AbCdEfGhIjKlMnOpQrStUvWxYz_000002_20261015200559\00003101 |
| file_status | Estado del proceso de embosado de ese archivo. | FINISHED |
| file_date | Fecha del proceso de embosado (el día anterior al de generación). | 2026-10-15 |
Los nombres y el orden de las columnas son parte del contrato de integración con Pomelo y no cambian.
Notificaciones
Te notificamos por correo ante dos eventos:
- Éxito: generamos el archivo y ya está disponible en tu carpeta SFTP.
- Error: el proceso falló para tu programa (por ejemplo, por una falla al obtener los datos o al subir el archivo). Si esto ocurre, contacta a nuestro equipo vía Dashboard para que lo reintentemos manualmente.
Los destinatarios de estas notificaciones son los que definiste al activar la función junto a nuestro equipo.
Preguntas frecuentes
¿Dónde recibo el extract file?
En la subcarpeta extract_files/v2/ de tu carpeta SFTP, la misma donde recibes tus reportes y el archivo de transacciones.
¿Necesito configurar algo para recibirlo?
No, si ya tienes acceso a tu carpeta SFTP. Solo necesitas que activemos la función para tu programa.
¿Puedo descargar el archivo por API?
No. El canal de entrega del extract file es tu carpeta SFTP.
¿A qué hora recibo el archivo?
Iniciamos la generación todos los días a las 8:00 AM (hora Argentina), con los datos del día anterior. El archivo puede tardar unos minutos en estar disponible, según la cantidad de archivos a procesar. Si no lo recibes después de ese horario, contacta a nuestro equipo.
¿Qué pasa si no hubo tarjetas embozadas el día anterior?
No recibes archivo. Registramos la generación como error y te notificamos por correo. No enviamos archivos vacíos.
¿Qué pasa si falta alguna tarjeta en el archivo?
El archivo incluye solo los procesos de embosado finalizados al momento de la generación. Si un proceso del día anterior no terminó a tiempo, sus tarjetas no figuran. Contacta a nuestro equipo si crees que falta alguna.
¿El archivo incluye datos de antes de mi activación?
No. La generación comienza el día siguiente a que tu configuración esté activa.
¿El formato del archivo cambia según mi programa?
No. El formato y el orden de las columnas son los mismos para todos los programas.
¿Qué pasa si el proceso se ejecuta más de una vez el mismo día?
Si ya generamos correctamente el archivo de esa fecha, las re-ejecuciones no lo modifican. Si el proceso falla, no reintentamos automáticamente: contacta a nuestro equipo y lo reintentaremos manualmente.
¿Puedo dejar de recibir notificaciones por correo?
Sí. Si no defines destinatarios al activar la función (o los quitas después), no se envían notificaciones, pero el archivo se sigue generando y quedando disponible en tu carpeta SFTP.