Por qué tu archivo ZPL no se convirtió
Las tres causas más comunes de que una etiqueta no llegue al PDF, dos de ellas sin ningún error en pantalla. Cómo reconocer cada una mirando el archivo, probadas contra el renderizador que usa EasyZPL.
Falta el ^XZ que cierra la etiqueta
Una etiqueta ZPL abre con ^XA y cierra con ^XZ. El renderizador no trata un bloque sin cerrar como "una etiqueta incompleta que se puede aprovechar": sencillamente no encuentra ninguna etiqueta.
^XA
^FO50,50^A0N,30,30^FDPedido 1234^FS
Un archivo que solo tenga esa etiqueta no se convierte: el conversor avisa de que no encontró ninguna etiqueta.
El otro caso es el que más sorprende, y es peor. Si el archivo tiene diez etiquetas correctas y una sin su ^XZ, se convierte, y recibes diez páginas. La etiqueta rota desaparece sin ningún aviso. Medido contra el renderizador que usa EasyZPL: tres etiquetas buenas más una rota devuelven exactamente tres.
Si la rota está en medio del archivo, se lleva por delante la siguiente. El bloque abierto sigue leyendo hasta encontrar el próximo ^XZ, que es el de la etiqueta de abajo, y las dos se juntan en una.
Nada te avisa de esto, y por eso la comprobación vale el doble. Cuenta los ^XA y los ^XZ del archivo, porque los dos números tienen que coincidir. Después de convertir, comprueba que el PDF tenga una página por etiqueta.
Falta el ^FS que cierra un campo
Cada campo dibujado termina con ^FS. Es fácil olvidarlo en el último campo antes del ^XZ, porque parece que el ^XZ ya lo cierra todo.
^XA
^FO50,50^A0N,30,30^FDPedido 1234
^XZEsta etiqueta también se pierde, por el mismo motivo que el caso anterior: el ^FD abierto se traga el ^XZ como si fuera texto a imprimir, así que la etiqueta nunca llega a cerrarse. Las demás del archivo salen con normalidad, y solo esta desaparece.
Corregido:
^XA
^FO50,50^A0N,30,30^FDPedido 1234^FS
^XZEl contenido queda fuera del área de la etiqueta
Este caso es distinto de los dos anteriores: el archivo se convierte sin problemas y el PDF sale con el número de páginas correcto, solo que en blanco o con partes faltando.
^FO posiciona en puntos, no en milímetros. Cuántos puntos caben depende de la densidad: a 8 puntos por milímetro, una etiqueta de 101,6 mm de ancho tiene 813 puntos. Un ^FO900,50 en esa etiqueta dibuja fuera del papel, y nada se queja.
El síntoma clásico es convertir la misma etiqueta con densidades distintas y ver que el contenido aparece en una y desaparece en otra, porque el archivo se escribió para una impresora de 300 dpi y se está convirtiendo a 203.
Lo que no es el problema
Un comando desconocido no rompe el archivo. Si tu ZPL usa un comando que este renderizador no implementa, se omite y el resto de la etiqueta se dibuja con normalidad. Si falta algo en el resultado pero la conversión sí ocurrió, esta es la causa probable, no un error de sintaxis.