Servicio de Impresion Fast

Instrucciones detalladas de uso con Postman para la integración del servicio de backend AAInterface_ImpresionCliente.

Endpoint A: Manejo de Impresoras del Cliente

Permite gestionar las impresoras físicas instaladas en las dependencias del cliente de forma remota, eliminando la necesidad de desplegar un servidor físico dedicado en su red local.

POST | fttp://127.0.0.1:8002/printfile

Requisitos Técnicos Previos

Para que la petición se procese correctamente en el entorno local del cliente, se deben cumplir tres condiciones esenciales:

Acceso a Ordenador Local (Puerto 3002): Configurar un ordenador (Windows 10, 11 o Server) en el site que permanezca preferiblemente encendido. El puerto 3002 de dicho ordenador debe estar accesible desde internet mediante Cloudflare o mediante una redirección del equipo de redes del cliente (desde un puerto público XXXX hacia el 3002 interno).
Conectividad de Hardware: El ordenador designado debe tener instaladas, encendidas y plenamente accesibles las impresoras láser y de etiquetas.
Motor de Renderizado PDF: Es obligatorio tener instalado el software SumatraX86 en dicho equipo local para gestionar las ejecuciones de impresión de archivos PDF.

Request Body (JSON)

Nota: El servicio guardará temporalmente una copia local del fichero recibido en la carpeta ./impresoWS, la cual se limpia de forma automática cada día.

{
  "filename": "vordenes_ubicacion_20261220084000.etq",
  "printer": "ZEBRA FP5",
  "labeltext": "JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0Y..."
  }

Response (JSON)

{
  "Impresión Correcta"
  }

Endpoint B: Gestión de Plantillas y Crystal Reports

Este endpoint recibe ficheros PDF o estructuras de texto codificados en Base64. Permite acceder un fichero de crystal report (*.rpt) o una plantilla *.ETQ indicada en el request, establecerle las condiciones de selección de datos y recibir un PDF o fichero de texto como response. Su gran ventaja es que evita tener que instalar Crystal Reports o almacenar plantillas físicas dentro del stack de contenedores (Docker/Kubernetes) en despliegues Cloud.

POST | fttp://127.0.0.1:8002/rpt

Request Body Completo (JSON)

Este esquema incluye los parámetros de conexión a bases de datos, criterios de filtrado, asignación de impresoras, despacho opcional por correo electrónico y salidas alternativas en formato plano:

{
  "codkey": 1234546,
  "username": "fastprocess",
  "pass": "fast..",
  "servername": "",
  "archivo_rpt": "diario_productividad.rpt",
  "condicioncr": "{vfp02_ordenes_ubicacion.fecha >=datate",
  "condicionsqlprevia": "select max(Cantidad) from vfp02_ordenes_ubicacion where fecha >=trunc(sysdate)",
  "titulo": "DIario de Productividad de ubicacion",
  "copias": "1",
  "pdf": "Diario_productividad_2605255456656.pdf",
  "databasename": "GENERADORIMRPESION",
  "printer": "HP LASERJET",
  "emailsubject": "Diario productividad 25/05/26",
  "emaildestinatarios": "Fastprocess@fastprocess.net;cloudfp@cloudfp.net",
  "emailbody": "<p>Le adjuntamos copia del Diario de produccitidad</p><p>Correo automatico generador por Cloud FP</p>",
  "emailplantilla": "Plantilla_seur.html",
  "emailsql": "select * from vfp02_ordenes_ubicacion where fecha >=trunc(sysdate)",
  "etqfile": "vfp02_ordenes_ubicacion.etq",
  "etqcondicion": "select * from vfp02_ordenes_ubicacion where fecha >=trunc(sysdate)"
  "sologuardar": ""

  }

Descripción de parámetros clave (Desde `printer` hasta el final):

printer: (Opcional) Nombre de la impresora física local si se desea forzar la salida en papel directamente. Debe ser accesible desde el entorno Windows donde corre el servicio.
emailsubject: (Opcional) Línea de asunto para el envío automatizado por correo.
emaildestinatarios: (Opcional) Cuentas de destino separadas por punto y coma (;).
emailbody: (Opcional) Cuerpo de texto formateado en HTML para el correo electrónico.
emailplantilla: (Opcional) Archivo de plantilla HTML externo para estruturar el mensaje.
emailsql: (Opcional) Consulta requerida por el motor para mapear y sustituir las variables dinámicas de la plantilla.
etqfile: (Opcional) Nombre asignado para la salida de etiquetas si se requiere forzar el retorno binario de texto plano.
etqcondicion: (Opcional) Sentencia de selección SQL específica para la generación de la etiqueta.
sologuardar: (Opcional) Dejar en Blanco o poner la ruta donde se desea colocar una copia del PDF generado.

Response Body (JSON)

{
  "CODERROR": 0,
  "DESERROR": "Fichero generado correctamente",
  "CODKEY": "0",
  "FICHEROPDF": "JVBERi0xLjQKMSAwIG9iajw8L1R5cGUvQ2F0Y..."
  }

🚀 Guía de uso rápido en Postman

Abre un nuevo tab de Request en Postman y asígnale el método POST.
Introduce la URL del endpoint correspondiente (/printfile o /rpt).
Ve a la pestaña Body, haz clic en el botón de selección raw y en el desplegable de la derecha selecciona JSON.
Copia cualquiera de las estructuras JSON limpias proporcionadas en este documento y pégalas en el editor de texto de Postman.