Saltar al contenido
P4 Software P4 Software / BarcoderX Español

Agrega esta documentación a Claude

Hazle preguntas a Claude sobre esta documentación. Claude lee las páginas publicadas y te enlaza a ellas. Copia esta dirección:

https://p4-software.opendocs.page/mcp

En claude.ai o Claude Desktop: abre Configuración, luego Conectores, elige Agregar conector personalizado y pega la dirección.

En Claude Code, ejecuta:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Códigos de barras

Códigos de barras

Aplica a: BarcoderX Basic y Ultimate

Estado: Planificado. Todavía no hay nada publicado y no hay nada que descargar. Esta página enumera las simbologías de códigos de barras que BarcoderX planea admitir, el grupo que llega primero y lo que BarcoderX hace con cada código de barras. La lista puede cambiar a medida que se confirme la especificación publicada de cada simbología. Algunos codificadores ya están construidos dentro del motor, y la sección "Lo que está construido hoy" los enumera.

BarcoderX escribe por su cuenta cada codificador de códigos de barras, a partir de las normas publicadas de cada simbología. No usa ninguna otra biblioteca de códigos de barras.

Lo que está construido hoy

Quince tipos de código de barras del primer grupo existen y están probados: EAN-13, EAN-8, UPC-A, UPC-E, ITF-14, GS1-128 y SSCC-18, los dos complementos solos, y EAN-13, UPC-A y UPC-E, cada uno con un complemento de dos dígitos y uno de cinco. Son bibliotecas dentro del motor, que todavía se está construyendo. No hay ningún paquete publicado, no hay una interfaz pública que usted pueda llamar para codificar un código de barras directamente, y el motor con licencia será la única vía pública para producir salida. En el registro, estas simbologías todavía tienen el estado Planned, porque un estado cambia solo cuando su evidencia está completa. ITF-14, GS1-128 y SSCC-18 se describen en Códigos de barras para envíos: ITF-14, GS1-128 y SSCC-18, y el UPC-E y los complementos en UPC-E y complementos. El motor de etiquetas los dibuja todos. Consulte El motor de etiquetas.

También están construidas y probadas dos simbologías postales del segundo grupo: la marca de identificación de frente del USPS (FIM) y el código de barras Intelligent Mail del USPS. Se describen en Códigos de barras postales: FIM y el código Intelligent Mail. Su estado en el registro sigue siendo Planned, como el de las demás, y la lista de simbologías para el editor las marca como implemented porque existe un codificador.

Lo que BarcoderX hace con cada código de barras

  • Lo ajusta a su impresora. La barra o módulo más angosto (la dimensión X) se redondea a un número entero de puntos de la impresora, y el resultado le indica la dimensión X que obtuvo realmente. Los códigos de barras y las formas se dibujan directamente en la cuadrícula de puntos de la impresora, de modo que sus bordes nunca se difuminan ni se tramean.
  • Maneja los dígitos verificadores. En cada simbología que tiene uno, BarcoderX puede calcular el dígito verificador, validar el que usted proporcione u omitirlo, según lo permitan las reglas de la simbología.
  • Coloca el texto legible. El texto puede ir arriba o abajo del código de barras, o no mostrarse. Sigue la disposición propia de la simbología, como los grupos de dígitos de EAN y UPC y los paréntesis de los identificadores GS1. También puede definir su propio texto, distinto de los datos codificados, agregar líneas de leyenda y, más adelante, colocar el texto a la izquierda o a la derecha del código de barras.
  • Respeta la zona de silencio. Si el cuadro que usted dibuja invade la zona de silencio que necesita una simbología, BarcoderX le muestra una advertencia.
  • Dimensiona el código de barras de dos maneras. Puede fijar la dimensión X, o dejar que el código de barras llene su cuadro con el módulo de puntos enteros más grande que quepa. Los códigos de barras nunca se estiran fuera de proporción.
  • Gira el código de barras. Los ángulos de 0, 90, 180 y 270 grados son nativos. Cualquier otro ángulo se dibuja como imagen.
  • Revisa sus datos sin dibujar. Puede validar datos contra una simbología por separado.
  • No falla con datos incorrectos. Los datos no válidos generan un diagnóstico. Usted elige qué muestra la etiqueta en su lugar: un cuadro de marcador, un área vacía o una etiqueta fallida.
  • Admite las opciones de cada simbología. En las simbologías 2D incluyen el nivel de corrección de errores, el tamaño o la versión, la forma, el modo de codificación, el anexo estructurado y, donde la simbología lo define, la inicialización del lector. Se acepta contenido en texto, hexadecimal y base64.
  • Maneja los juegos de caracteres. Cubre la tabla de interpretación de canal extendido (ECI) y las páginas de códigos que necesita cada simbología 2D, incluidos Shift JIS y GB 18030.
  • Da el mismo resultado en todas partes. Los codificadores no comparten estado y se pueden llamar con seguridad desde muchos subprocesos a la vez. Un código de barras creado con el generador de una sola llamada, con la API web o dentro de una plantilla da el mismo resultado.

Qué tan grande es un código de barras

Un código de barras tiene un cuadro, como todo elemento, y el código se dibuja dentro de él, arriba a la izquierda. Un código de barras nunca se estira fuera de proporción y nunca se centra. Hay dos modos de tamaño, y el miembro sizing elige uno: fixed, el predeterminado, y fit.

  • fixed. Usted indica el ancho de la barra más angosta, el módulo, en xDimension. xDimensionUnit dice si está en la unidad de la página (page, el valor predeterminado) o en puntos de impresora (dot). BarcoderX lo redondea a puntos enteros, como se describe en El motor de etiquetas. El ancho de todo el símbolo se deduce de él: los módulos de los datos y de las zonas de silencio, multiplicados por el ancho de módulo en puntos. Usted no puede escribir ese ancho. Si el símbolo, zonas de silencio incluidas, es más ancho o más alto que el cuadro, BarcoderX le avisa (BX3907) y lo dibuja de todos modos. Si usted no indica xDimension, BarcoderX dimensiona el código de barras como fit.
  • fit. BarcoderX ignora xDimension y usa el mayor número entero de puntos por módulo con el que el símbolo, zonas de silencio incluidas, cabe en el ancho del cuadro. Nunca es menos de un punto. Un cuadro más ancho da barras más grandes, en pasos de un punto por módulo.

Lo que usted fija en cualquiera de los modos: barHeight (sin él, las barras toman la altura que queda en el cuadro debajo de los dígitos y de las barras de guarda más largas), barWidthAdjust, quietZone (en módulos, sin él el mínimo de la especificación), humanReadable y el cuadro mismo. No hay un ajuste para la proporción entre barras anchas y angostas: pertenece a las reglas de cada simbología. El miembro options es para los ajustes que pertenecen a una simbología, y el motor de etiquetas todavía no lo lee (BX3902).

Las simbologías

Las simbologías se entregan en tres grupos, llamados familias. Cada familia se agrega en una versión aditiva: una familia nueva no cambia ningún formato de plantilla ni ninguna API.

Familia 1: el primer grupo

La familia 1 es el núcleo de logística y comercio minorista. La versión 1.0 incluye la familia 1, que son 50 simbologías y variantes, contando las variantes una por una. Por ejemplo, EAN-13 solo, con un complemento de 2 dígitos y con un complemento de 5 dígitos cuentan como tres. La tabla indica qué edición incluye cada simbología. Después de la versión 1.0 se planean más familias.

SimbologíaEdición
Code 128 (cambio automático de conjunto de códigos, y conjuntos A, B y C por separado)Basic
GS1-128 y SSCC-18Basic
Code 39 y Code 39 Full ASCIIBasic
Code 93 y Code 93 Full ASCIIBasic
EAN-13, EAN-8, UPC-A y UPC-E, cada uno con los complementos de 2 y de 5 dígitos (las variantes del EAN-8 no están construidas; consulte UPC-E y complementos)Basic
Interleaved 2 of 5 e ITF-14 con barras de protecciónBasic
GS1 DataBar: Omnidireccional, Truncado, Limitado, Expandido, y las variantes apiladas Apilado, Apilado omnidireccional y Expandido apiladoBasic
Data Matrix (ECC 200), GS1 Data Matrix y la extensión rectangular (DMRE) con su forma GS1Ultimate
QR Code, GS1 QR Code y Micro QR CodeUltimate
PDF417, PDF417 compacto, PDF417 macro y MicroPDF417Ultimate
Aztec Code (rango completo, compacto y Rune)Ultimate
MaxiCode, modos 2 a 6Ultimate

Códigos de barras decorados

Los códigos QR artísticos y los códigos de barras decorados están previstos para la versión 1.0, para las simbologías de esa versión. La decoración se agrega después de codificar el código de barras, como una capa aparte. Sigue la edición del código de barras: la decoración de los símbolos lineales está en Basic, y la decoración de los símbolos 2D está en Ultimate. La decoración de las simbologías de familias posteriores llega con esas familias.

Familia 2: el resto de las simbologías lineales y postales

La familia 2 llega después de la primera versión, en varias entregas. Abarca más simbologías lineales, simbologías postales y de cuatro estados, y formatos de aplicación. Ejemplos cuya especificación publicada está identificada:

  • Simbologías lineales: Codabar, Code 11, LOGMARS, VIN, EAN-14, NVE-18, ISBN, ISSN, ISMN y Channel Code.
  • Simbologías postales y de cuatro estados: POSTNET y el código de barras Intelligent Mail del USPS.
  • Formatos de aplicación: HIBC en símbolos lineales y 2D, el código QR-bill suizo, el código QR de pago EPC, y GS1 Digital Link en QR Code y en Data Matrix.

La lista completa de la familia 2 no se publica aquí. Una simbología se nombra en esta página solo cuando su especificación publicada está identificada.

Familia 3: compuestas, 2D avanzadas y apiladas

La familia 3 llega después de la familia 2. Incluye:

  • Símbolos compuestos: EAN, UPC, GS1-128 y GS1 DataBar combinados con un componente CC-A, CC-B o CC-C, y el TCIF Linked Code 39.
  • Han Xin Code, DotCode, Micro QR Code rectangular (rMQR) y su forma GS1.
  • Code 16K, Code 49 y Codablock F.

La edición de cada simbología depende de su tipo: las simbologías lineales y postales están en Basic, y las simbologías 2D, apiladas y compuestas están en Ultimate. Consulte Ediciones y licencias.

Una entrada se agrega solo cuando se tiene su especificación publicada. Algunas simbologías del plan todavía no tienen una especificación identificada. No se nombran en esta página, y permanecen planificadas hasta que se encuentre una. La lista de las familias posteriores puede cambiar.

Qué significan los estados

Cada simbología tiene un estado en el registro que lista la API web:

EstadoSignificado
Stable (estable)Publicada, con su evidencia de conformidad completa.
Preview (vista previa)Publicada, pero su evidencia todavía no está completa.
Planned (planificada)El estado de todas las simbologías hoy. No decide si una simbología se puede dibujar: eso depende de que el motor tenga un codificador para ella. Una etiqueta que use una simbología sin codificador se rechaza con BX3905 (el tipo de código de barras no está disponible). La lista de simbologías para el editor indica cuáles tienen codificador (implemented) y cuáles no (planned).

El editor muestra únicamente las simbologías que ya se publicaron.

Impresión de códigos de barras

Con frecuencia, una impresora puede dibujar un código de barras con sus propios comandos. BarcoderX usa el comando de código de barras de la impresora solo donde se ha comprobado que su resultado tiene el mismo tamaño y la misma forma que el de BarcoderX. En los demás casos, BarcoderX envía el código de barras como una imagen exactamente igual a la vista previa. Cada lenguaje de impresora publica qué simbologías residen en la impresora para cada perfil de impresora. Consulte Impresión y Lenguajes de impresora.

Una llamada para un código de barras

Puede pedir un solo código de barras sin armar una etiqueta. En el SDK, una llamada recibe una simbología, el contenido y las opciones, y devuelve bytes, escribe un flujo o un archivo, o devuelve un URI de datos en base64. La API web ofrece lo mismo mediante un endpoint de códigos de barras. El resultado es el mismo que el del mismo código de barras dentro de una plantilla. Consulte API web.

Para páginas web, se prevén dos paquetes en una versión posterior a la primera. Uno es un tag helper de ASP.NET Core que muestra un código de barras como imagen en línea, sin JavaScript. El otro es un componente de Blazor solo de salida.

Cada simbología tendrá además su propia página de referencia, con un código de barras dibujado por el motor como ejemplo, en inglés y en español.

GS1 y Digital Link

BarcoderX está diseñado para cumplir los criterios de preparación de GS1 para códigos de barras 2D. Consulte Compatibilidad con GS1. Los códigos de barras para envíos se describen en Códigos de barras para envíos: ITF-14, GS1-128 y SSCC-18, y el UPC-E y los complementos en UPC-E y complementos.


BarcoderX es un producto de P4 Software.

¿Te resultó útil esta página?