fix: tune offline zpl label rendering

2026-05-22 01:59:49 -03:00
parent ddc81d482e
commit 936f8b6868
2 changed files with 132 additions and 18 deletions
@@ -33,3 +33,24 @@ C:\Users\Dorado\Desktop\Pampero\Proyectos\zpl-pdf-microservice\node-v24.15.0\nod
 ```

 El default sigue siendo `127.0.0.1:3040` para uso local. También se puede configurar con variables de entorno `HOST` y `PORT`.
+
+## Parámetros de Render
+
+El endpoint `POST /convert` acepta, además de `zpl`, los parámetros `width`, `height`, `dpi`, `sourceDpi`, `fontWidthScale`, `code128WidthScale` y `qrSizeScale`.
+
+Para etiquetas Mercado Libre 4x6 con coordenadas Zebra a 203 DPI y PDF de salida a 300 DPI, usar como base:
+
+```json
+{
+  "width": 4,
+  "height": 6,
+  "dpi": 300,
+  "sourceDpi": 203,
+  "fontWidthScale": 0.82,
+  "code128WidthScale": 1.42,
+  "qrSizeScale": 0.5
+}
+```
+
+`code128WidthScale` ajusta el ancho visual de `^BC` porque `bwip-js` genera Code128 más angosto que Labelary/Zebra para algunas etiquetas ML con `^BY3`.
+`qrSizeScale` ajusta el tamaño visual de `^BQ` porque `bwip-js` incluye una matriz QR más grande que la salida observada en etiquetas ML/Zebra para `^BQN`.