Generar un archivo de pago (REQ)

El archivo de solicitudes de pago estará compuesto de una serie de registros.

Se llama “registro” a una lista de parámetros separados por el carácter “;” y terminados por un retorno de carro. Es decir, hay un registro por línea.

Este tipo de formato, conocido como “CSV” (del inglés Comma Separated Values) es compatible con MS Excel, entre otros.

El archivo presentará la siguiente estructura:

  • Un registro de encabezado que proporciona información sobre la transmisión.
  • Un número variable de registros que contienen la información de los pagos por realizar.
  • Un registro de fin que garantiza la coherencia del archivo transmitido.

El número de registros presentes en el archivo afecta directamente el tiempo de procesamiento del archivo, así como la puesta a disposición del archivo de respuesta.

Por encima de los 2000 registros, se recomienda generar varios archivos de pago.

Ejemplo:

Cargamos un archivo de prueba el 30/11/2018 para la tienda 12345678. Contiene dos solicitudes de pago con los siguientes parámetros:

Primer pago por alias:

  • ID: ‘ALIAS-TEST-1
  • Número de transacción: 000001
  • Monto: 935,99 USD

Segundo pago por identificador :

  • ID: ‘ALIAS-TEST-2
  • Número de transacción: 000002
  • Monto: 75,90 USD

  1. Cambie el nombre del archivo respetando el formato <AAAAMMDD>.<siteID>.PAY.REQ.<z>.<xx>.

    O:

    • <AAAAMMDD> corresponde a la fecha de generación del archivo.
    • <siteID> corresponde al número de tienda que se le ha asignado (vads_site_id).
    • <z> puede tener el valor “T’ si se trata de un archivo en modo TEST o el valor “P” si se trata de un archivo en modo PRODUCTION.
    • <xx> corresponde al número secuencial del archivo en el día, expresado en dos caracteres numéricos.

    El archivo de ejemplo se denomina 20181130.12345678.PAY.REQ.T.01

  2. Rellene el registro de encabezado con los siguientes valores:
    Pos. Descripción Formato Valores Equivalencia
    01 Código de registro n2 00  
    02 Tipo de archivo   PAY  
    03 Versión del archivo n2 02  
    04 Identificador de la tienda n8 12345678 vads_site_id
    05 Entorno (TEST o PRODUCTION)   TEST vads_ctx_mode
    06 Fecha de creación n8 En formato AAAAMMDD  
    07 Hora de creación n6 En formato HHMMSS  
    08 Fecha solicitada de ejecución. n8

    Reservado para su uso futuro.

    Dejar en blanco
     
  3. Rellene cada registro de detalles respetando el siguiente formato:
    Pos. Descripción Formato Valores Equivalencia
    01 Código de registro n2 02  
    02 Número de secuencia del registro de detalles en el archivo. n..6 Comienza en 1  
    03 Fecha de la transacción n8 En formato AAAAMMDD vads_trans_date
    04 Hora de la transacción n6 En formato HHMMSS vads_trans_date
    05 Identificador de la transacción n..6 Único en el día y compartido con otros modos de pago. vads_trans_id
    06 Tipo de transacción a2 CD  
    07 Monto n..12 En su unidad monetaria más pequeña. vads_amount
    08 Código de la moneda n3 Ejemplo: 840 para el dólar norteamericano (USD) vads_currency
    09 Fecha solicitada de captura n8 En formato AAAAMMDD.

    En blanco para indicar la fecha del día

     
    10 Modo de validación n..1

    0: para una validación automática

    1: para una validación manual

    En blanco: para utilizar el modo de validación predeterminado
    vads_validation_mode
    11 Alias de tarjeta ans..50 Alias de la tarjeta que se utilizará para su débito vads_identifier
    12 Contrato comercial a utilizar. ans..250 Dejar en blanco para utilizar el contrato predeterminado. vads_contract_used
    13 Referencia del pedido ans..32 Dejar en blanco si no se utiliza vads_order_id
    14 Información sobre el pedido 1 ans..255 Dejar en blanco si no se utiliza vads_order_info
    15 Información sobre el pedido 2 ans..255 Dejar en blanco si no se utiliza vads_order_info2
    16 Información sobre el pedido 3 ans..255 Dejar en blanco si no se utiliza vads_order_info3

  4. Rellene cada registro de fin respetando el siguiente formato:
    Pos. Descripción Formato Valores
    01 Código de registro n2 01
    02 Número de registros de detalles transmitidos n..6 P. ej.:2.

    Se recomienda no superar los 2000 registros por archivo.

Ejemplo de archivo:

Nombre de archivo: 20181130.12345678.PAY.REQ.T.01

00;PAY;02;12345678;TEST;20181130;102008;
02;1;20181130;102008;000001;CD;93599;840;;;ALIAS-TEST-1;;;;;
02;2;20181130;102008;000002;CD;7590;840;;;ALIAS-TEST-1;;;;;
01;2

Para ayudarle durante su fase de integración, puede acceder a una interfaz de validación Back Office Vendedor desde el menú: Gestión > Recurrencias de PRUEBA > Solicitud de pago.

Desde ella podrá:

  • verificar la estructura de un archivo antes de cargarlo
  • importar un archivo de pago en modo TEST
  • crear pagos en modo TEST a partir del archivo importado