FastReport: genera informes PDF personalizados en A3ERP

Los endpoints de FastReport te permiten renderizar plantillas de informe .fr3 personalizadas almacenadas en el servidor, inyectando datos de forma dinámica mediante sentencias SQL. El resultado es el PDF generado devuelto como una cadena en Base64, listo para mostrarlo en el navegador, guardarlo en disco o adjuntarlo a un correo electrónico.

Los archivos de informe .fr3 deben estar ubicados en la carpeta configurada como CarpetaInformesExternos en CfgAPI.exe. Informes ubicados en otras rutas no serán accesibles.

POST — Generar informe FastReport

Renderiza el informe FastReport indicado inyectando los datasets SQL proporcionados y devuelve el PDF resultante codificado en Base64.

POST https://servidor:<puerto>/api/rptdescarga/{formato}

Ejemplo de URL:

https://servidor:5555/api/rptdescarga/descargaprueba.fr3

Parámetros

string

required

El nombre del archivo de informe FastReport, incluyendo la extensión .fr3. Por ejemplo: descargaprueba.fr3.

string

required

Token de autenticación en formato Bearer <JWT_token>.

object

required

Objeto JSON que contiene la clave SQL con un array de datasets a inyectar en el informe.

Show Propiedades de SQL[]

string

required

El nombre del dataset tal como está definido en el archivo .fr3. Debe coincidir exactamente con el nombre del componente TfrxDBDataSet en el informe.

string

required

La sentencia SQL que proveerá los datos al dataset. Se ejecuta en la base de datos de A3ERP.

Respuesta

{
  "documento": "<contenido del PDF en Base64>"
}

string

El PDF generado codificado en Base64.

Para decodificar la respuesta Base64 y obtener el archivo PDF:

JavaScript (navegador): atob(response.documento)
Bash / terminal: echo "<base64>" | base64 -d > informe.pdf

Ejemplo con un único dataset

{
  "json": {
    "SQL": [
      {
        "nombre": "frxClientes",
        "sentencia": "select codcli, nomcli, nifcli from clientes order by codcli"
      }
    ]
  }
}

Ejemplo con múltiples datasets

Puedes pasar tantos datasets como necesite el informe. Cada elemento del array SQL se corresponde con un dataset diferente definido en el .fr3.

{
  "json": {
    "SQL": [
      {
        "nombre": "frxClientes",
        "sentencia": "select codcli, nomcli, nifcli from clientes order by codcli"
      },
      {
        "nombre": "frxFacturas",
        "sentencia": "select tipocont, serie, numdoc, fecha, codcli, nomcli, totdoc from cabefacv where month(fecha) = 1"
      }
    ]
  }
}

Ejemplo completo de petición HTTP

POST https://servidor:5555/api/rptdescarga/descargaprueba.fr3
Authorization: Bearer <JWT_token>
Content-Type: application/json

{
  "json": {
    "SQL": [
      {
        "nombre": "frxClientes",
        "sentencia": "select codcli, nomcli, nifcli from clientes order by codcli"
      },
      {
        "nombre": "frxFacturas",
        "sentencia": "select tipocont, serie, numdoc, fecha, codcli, nomcli, totdoc from cabefacv where month(fecha) = 1"
      }
    ]
  }
}

Fundamentos

Maestros y Documentos

Stock e Inventario

Informes y Datos

Producción

Módulos Adicionales

FastReport: genera informes PDF personalizados en A3ERP

POST — Generar informe FastReport

Parámetros

Respuesta

Ejemplo con un único dataset

Ejemplo con múltiples datasets

Ejemplo completo de petición HTTP

​POST — Generar informe FastReport

​Parámetros

​Respuesta

​Ejemplo con un único dataset

​Ejemplo con múltiples datasets

​Ejemplo completo de petición HTTP

POST — Generar informe FastReport

Parámetros

Respuesta

Ejemplo con un único dataset

Ejemplo con múltiples datasets

Ejemplo completo de petición HTTP