API Doc
Space shortcuts
Page tree
Skip to end of metadata
Go to start of metadata

Instrucciones para realizar una importación por Base Pública

A continuación, detallamos los pasos a seguir para realizar una importación de datos de pagos mediante la API de base pública.

1. Preparación del archivo

Antes de realizar la importación, es necesario preparar el archivo con los datos:

  • Crear un archivo en formato CSV, utilizando coma (,) como separador de columnas.

  • Comprimir el archivo en formato .zip (por ejemplo, nombreDelArchivo.zip).

  • El archivo debe respetar la estructura requerida para los datos de pago.

2. Ejecución de la importación

Realizar la importación utilizando el siguiente comando curl:

curl --location 'https://prd.peypertic.com/public-base-payments-api/importaciones' \
--header 'source: backoffice' \
--header 'Authorization: Bearer TOKEN' \
--header 'Content-Type: multipart/form-data' \
--form 'file=@"nombreDelArchivo.zip"' \
--form 'collector_id="6309"' \
--form 'form publication_date="2025-04-25T18:00:00-0300"'

Consideraciones importantes:

  • Reemplazar TOKEN por el token de autorización correspondiente.

  • Adjuntar correctamente el archivo .zip generado.

  • Actualizar siempre el valor de form publication_date con la fecha y hora actuales al momento de realizar cada importación.

  • No realizar múltiples envíos del mismo archivo para evitar duplicaciones.

Resultado de la importación:

Si la importación se inicia correctamente, recibirás una respuesta similar a esta:

{
    "id": "ad85ef35-37ec-4b40-9267-cb0d65bbb639",
    "status": "building_fragments",
    "type": "apiv2-simplificado",
    "strategy": "common",
    "collector_id": "6309",
    "request_date": "2025-04-25T21:09:29+0000",
    "file_name": "nombreDelArchivo.zip",
    "publication_date": "2025-04-25T21:09:29+0000"
}

3. Verificación del estado de la importación

Una vez enviada la importación, podrás consultar el estado utilizando el ID recibido:

curl --location 'https://prd.peypertic.com/public-base-payments-api/importaciones/ID_IMPORTACION' \
--header 'source: backoffice' \
--header 'Authorization: Bearer TOKEN' \
--header 'Content-Type: application/json'

Reemplazar ID_IMPORTACION por el ID obtenido en la respuesta inicial.

Resultado esperado:

El estado debe ser "finished" y la respuesta contendrá detalles como:

  • Nombre del archivo.

  • Cantidad de pagos procesados.

  • Fecha de publicación.

Ejemplo de respuesta exitosa:

{
    "id": "ad85ef35-37ec-4b40-9267-cb0d65bbb639",
    "status": "finished",
    "type": "apiv2-simplificado",
    "strategy": "common",
    "fragments": 1,
    "header": {
        "header": "Planilla de Importación,,,,,,,,,,,\nDatos del pago,,,,,,Datos del pagador,,,,,Servicios avanzados\n\"Referencia del concepto\n\n\n\n\n\n\n*Puede contener números y letras*  \n\n*Ejemplo: N° de remito o de factura*\n\n\nRequerido\",\"Identificador del concepto\n\n\n\n\n\n\n*Puede contener números y letras*\n\n\n\n\n\nRequerido\",\"Descripción del concepto \n\n\n\n\n\n\n\n\n\n*Puede contener números y letras*\n\n\nRequerido\",\"Monto\n\n\n\n\n\n\n\n\n\n*Sólo números \ncon punto decimal, \nsin comas ni símbolos*\n\n*Ejemplo: 1000.00*\n\nRequerido\",\"Fecha ideal de pago\n\n\n*En pagos online: cobranzas disponibles desde la fecha de importación* \n*Ejemplo:\ndd/mm/aaaa hh:mm:ss (día/mes/año hs/min/seg)*\n\n\n\n\n\nOpcional\",\"Fecha límite de pago\n\n\n\n\n\n*Última fecha para aceptar el pago* \n(se sugiere el día 25 de cada mes)\n*Ejemplo:\ndd/mm/aaaa hh:mm:ss \n(día/mes/año hs/min/seg)*\n\n\n\n\nOpcional\",\"\"\"Nombre del pagador \n\n\n\n\n\n\n\n*Nombre y Apellido \n(en caso de informar DNI) \no Razón Social \n(en caso de informar CUIT)*\n\n\n\nOpcional\",\"Número \nde documento\n\n\n\n\n\n\n*Sólo números, sin puntos \nni guiones*\n\n*N° de DNI o N° de CUIT*\n\n\nOpcional\",\"Identificador \ndel pagador\n\n\n\n\n*Puede contener números \ny letras*\n\n*Ejemplo: \nN° de cliente, N° de legajo, \nCUIT, DNI*\n\n\n\nOpcional\",\"Email del pagador \n\n\n\n\n\n\n\n*En letra minúscula*\n\n*Puede contener\n números o letras*\n\n\n\nOpcional\",\"Teléfono \ndel pagador\n\n\n\n\n\n\n\n\n*Sólo números,\n sin guiones ni \nparéntesis*\n\n\nOpcional\",\"\nCharge Delay\n\n\n\n\n\n*Recargo fijo aplicable a partir de la fecha ideal hasta la fecha limite\n*Ejemplo: 100.00\n\n\n\nOpcional\""
    },
    "collector_id": "6309",
    "request_date": "2025-04-25T21:09:29+0000",
    "file_length": 17,
    "file_name": "nombreDelArchivo.zip",
    "publication_date": "2025-04-25T21:09:29+0000"
}
  • No labels