Ha contado cinco cajas en el muelle. Al llegar a la casilla de la unidad, junto a la cantidad de la factura, no encuentra ninguna opción que diga "caja". Las listas de claves que circulan por internet tampoco responden: todas copian la misma tabla y se detienen donde la tabla se acaba. La respuesta que busca no está dentro de esa tabla, sino en el campo de al lado.
La tesis cabe en una frase: una caja no es una unidad de medida, es un envase. El documento electrónico hace dos preguntas distintas: "cuánta mercancía" y "en cuántos bultos". Son dos campos diferentes alimentados por dos listas diferentes. En el almacén se cuentan cajas, pero en la unidad de la cantidad no existe ninguna clave que signifique caja. Meter las dos cosas en el mismo campo es la manera de que la cifra del muelle y la del documento dejen de coincidir para siempre.
Una caja no es una unidad de medida, es un envase
Una línea de documento lleva dos cifras distintas, y las dos son correctas. La primera es la cantidad de mercancía: sesenta unidades, veintitrés kilos, cuatrocientos metros. Junto a esa cifra siempre hay una unidad de medida, y esa unidad no es texto libre: sale de una lista de claves. La segunda es la información de embalaje: ¿en cuántos bultos viaja la mercancía y de qué clase son? El número de bultos y el tipo de embalaje tienen sus propios campos, y el tipo de embalaje tiene su propia lista.
Ahí nace precisamente la confusión. El idioma que se habla en el almacén es el de los bultos: se dice "han salido cinco cajas", no "han salido sesenta unidades". Pero quien rellena el documento está sentado delante del campo de la cantidad, y en la lista que tiene delante no hay ninguna caja. Lo que ocurre a continuación es casi universal: en la casilla de la unidad se escribe lo que más se le parezca y la información de embalaje no se rellena nunca. La cifra contada en el muelle acaba no estando en ninguna parte del documento.
Por eso la forma correcta de la pregunta no es "a qué clave corresponde una caja" sino "en qué campo va una caja". Una vez encontrado el campo, la pregunta de la clave casi se responde sola. Los demás campos del documento —las partes, el número, la fecha real de salida, el transportista— los tratamos aparte: qué debe incluir un albarán.
La unidad junto a la cantidad: la lista que indica su formato
Sea cual sea el formato de factura electrónica que use, la unidad que acompaña a la cantidad es una clave tomada de una lista publicada, y el formato le dice de cuál. Peppol BIS Billing 3.0, por ejemplo, remite a la Recomendación 20 de UN/ECE. Cada administración tributaria publica además su propio catálogo. En los documentos electrónicos turcos —el caso que hemos leído en su fuente original para este artículo— el valor se toma ante todo de la lista de unidades que publica la administración, y la guía lo dice con sus palabras: el conjunto de valores se toma primero de esa lista y las unidades que no figuren en ella se buscan en dos listas concretas. La versión vigente el día en que se escribió este artículo es UBL-TR (Kod Listeleri), julio de 2026, versión 1.43 (guías de documento electrónico de la administración). La versión importa: esa guía cambia varias veces al año y una lista copiada sin fecha no vale nada.
No tiene sentido volcar aquí la lista en orden alfabético; eso ya se ha hecho ocho veces. Mírela por su función, porque la pregunta que se hace en un almacén no es "qué letras existen" sino "a qué grupo pertenece lo que yo vendo":
| ¿Qué responde la unidad? | Qué hay en la lista |
|---|---|
| Enteros contables: ¿cuántos? | La clave de una pieza suelta es C62; en la propia lista de Peppol su entrada dice "One (synonym: unit)". La misma lista incluye claves para pares, juegos, cientos y miles de piezas, de modo que vender en múltiplos ya está contemplado. |
| Magnitudes medidas: ¿cuánto? | Kilogramos, gramos, litros, metros, metros cuadrados y metros cúbicos tienen cada uno su clave en la misma lista. Lo que comparte este grupo es que sus valores pueden ser fraccionarios. |
| Envases: ¿cajas, palés? | Este grupo no está en esta lista. El tipo de envase se escribe en otro campo y sale de otra lista: es el tema del siguiente apartado. |
¿Vende en una unidad que no está en la lista?
Toneladas, mililitros, centímetros, metros lineales: algunas de las unidades que se usan a diario en un almacén sencillamente no figuran en el catálogo nacional, y ahí es donde la mayoría se atasca. Pero "no está en la lista" no es un callejón sin salida, sino el segundo paso que la propia guía prevé. La guía turca lo dice sin rodeos: las unidades que no aparezcan en su lista se toman de los códigos de unidad de UN/ECE y de una lista de unidades de medida EDI/XML publicada por el ministerio. La puerta no está cerrada; simplemente da a una segunda dirección.
Una advertencia. Las notas al pie de la guía remiten a ficheros concretos de esas listas internacionales, pero este artículo no dice cuál es la revisión vigente hoy de esos estándares: no pudimos verificarlo en la fuente, y un número de versión sin verificar hace más daño que no tener lista. La vía práctica es abrir usted mismo el fichero que indica la nota y buscar ahí su unidad. Después anote la clave junto con la fecha y el fichero del que la tomó. Dos años más tarde, la respuesta a "por qué elegimos esta clave" solo estará en esa nota.
El tipo de embalaje es otra lista: caja, cartón, jaula, saco
Aquello en lo que viaja la mercancía no se escribe donde va la unidad de la cantidad, sino en un campo propio. En UBL-TR ese campo se llama PackagingTypeCode y tiene su propia lista de claves: BX para una caja, DK para una caja de cartón, CR para una jaula, CH para un arcón, CN para un contenedor, SA para un saco, BG para una bolsa y NE para la mercancía sin embalar.
Y ahora lo importante: aquí tampoco hay una clave que signifique "caja de envío" como concepto genérico. Las dos correspondencias más cercanas son la caja y la caja de cartón, y elegir entre ellas es una decisión, no una traducción. Tome la decisión una vez y que todo el mundo use después la misma clave. La pregunta que hay que resolver es si lo que usted llama caja es concretamente un envase de cartón o su palabra genérica para cualquier embalaje exterior, sea del material que sea. Si es lo primero, la entrada de cartón es la elección más coherente; si es lo segundo, la de caja. Las dos se pueden defender; lo que no se puede defender es escribir una clave distinta en cada documento.
La lista de envases tampoco es cerrada: para los tipos que no figuran en ella, la guía remite a la lista de paquetes y envases de UNECE/CEFACT. Aquí funciona la misma lógica que en el lado de las unidades: primero la lista propia, después la internacional.
Otro aviso: esta pregunta tiene por internet una respuesta muy repetida, y la clave que da esa respuesta no aparece en ninguna de las dos listas. No la repetimos aquí, porque repetirla la difunde un paso más. El método de verificación es sencillo: cuando oiga una clave, búsquela en el PDF de la propia guía. Si no está ahí, no existe, lo diga quien lo diga.
Cuántas cajas salieron no suele figurar en el documento
Los dos apartados anteriores le han dicho dónde están los campos. Ahora llega la constatación más práctica de este artículo: rellenar esos campos no es obligatorio. En la guía de elementos comunes de UBL-TR, dentro del elemento de paquete, el número, el número de bultos y el tipo de embalaje están definidos los tres como opcionales; el total de bultos de la unidad de transporte también. Fuente: UBL-TR Ortak Elemanlar, abril de 2017, versión 0.7.
Lo que un campo opcional significa en la práctica es esto: un campo que su proveedor no rellena se queda vacío en silencio. No falla nada, no avisa nada, el documento es válido. Solo dice "sesenta unidades". Las cinco cajas contadas en el muelle no aparecen en ninguna parte: ni en el documento ni en la copia que lee la otra parte. Para que en la recepción puedan decir "esperábamos cinco cajas", esa cifra tiene que haberles llegado por otro papel.
La lista de tareas que se deriva es corta pero funciona. Una: abra la forma en bruto de uno de sus propios documentos y mire si el campo de número de bultos está relleno. Dos: si lo está, mire qué clave lleva. Tres: si está vacío, deje por escrito por qué otra vía llega esa cifra al cliente. Las tres cosas cuestan media hora y no vuelve a tener la discusión de "por qué no figuran las cajas en el documento".
La unidad con la que cuenta no tiene por qué ser la que declara
Casi todo el que ha llegado hasta aquí se pregunta lo mismo: "si en el almacén cuento cajas, ¿qué guardo en mi sistema?". La respuesta tranquiliza: no tienen por qué coincidir. La unidad del almacén y la del documento son dos realidades distintas y cada una tiene su buena razón. El muelle cuenta bultos porque bultos es lo que manipula; el documento declara mercancía porque la mercancía es lo que tiene una medida.
Lo que importa es quién hace la conversión entre ambas y cuándo. Alguien la hace tarde o temprano: o se hace una vez en la ficha del artículo y se aplica automáticamente a cada documento, o se hace mentalmente en cada envío. Lo segundo funciona los diez primeros envíos; en el undécimo entra otra persona y lo calcula de otra manera. Deje la regla por escrito: la conversión vive en la ficha del artículo, no en el documento.
Por qué la unidad es un campo codificado y no texto libre, por qué las unidades discretas y las fraccionadas van de dos en dos y cómo se configura eso en una ficha de artículo lo tratamos aparte; si va a montarlo desde cero, empiece por ahí: arreglar las unidades en la migración.
Fuera del país la regla cambia: el embalaje puede ser la unidad
¿Vale la misma separación en una factura que sale al extranjero? No, y ahí es donde más se equivocan quienes hacen integraciones. La lista de claves que Peppol BIS Billing 3.0 usa para la unidad de la cantidad se llama, literalmente: "Recommendation 20, including Recommendation 21 codes - prefixed with X (UN/ECE)" (docs.peppol.eu). Es decir: allí las claves de embalaje, con el prefijo X, pueden usarse directamente como clave de unidad.
En el lado logístico, la lista de claves de embalaje de Peppol incluye CT para un cartón, BX para una caja, PX para un palé, CR para una jaula y CS para un cajón (docs.peppol.eu). La misma palabra acaba en dos sitios distintos según el sistema: en Turquía la clave de embalaje va en un campo aparte y sin prefijo, mientras que en Peppol puede ir como unidad de la cantidad y con prefijo. Si está conectando una integración a los dos lados, anote esa diferencia: las mismas letras significan cosas distintas en cada sitio.
La lección general: no existe un único campo universal de "clave de unidad". Qué lista se aplica lo deciden el formato en el que envía y la administración a la que envía. Ver una clave en un sitio y llevársela a otro es el origen común de todas las confusiones que describe este artículo.
El ejemplo de la guía no coincide con su lista actual
Dentro del mismo paquete de guías hay una incoherencia interesante, y conocerla explica de golpe por qué a veces se ve una clave distinta. La versión actual de la guía de listas de claves da C62 para una pieza. En cambio, el XML de ejemplo de la guía del documento de expedición del mismo paquete, fechada en 2018, muestra NIU como unidad de la cantidad (UBL-TR Sevk İrsaliyesi, diciembre de 2018, versión 1.2). Dos documentos, dos claves distintas.
Aquí hay que ir con cuidado, porque es fácil sacar la conclusión equivocada. Este artículo solo informa de lo que dicen los dos documentos. No concluimos que la clave antigua haya dejado de ser válida, ni que la administración la rechazaría, ni que un proveedor daría error: nada de eso figura en las fuentes primarias que tenemos, y un veredicto sin fuente hace más daño que la propia clave.
La única lección práctica que merece la pena es esta, y ya es bastante: lo que vincula es la guía de listas de claves, no el XML de ejemplo. Antes de copiar una clave que ha visto en un ejemplo, búsquela en la lista vigente. Y recuerde que la versión de la guía cambia varias veces al año: una copia que era correcta hace tres años puede no serlo hoy. Anotar de qué versión de la guía salieron las claves de su integración evita que esta pregunta se repita.
Dónde golpea de verdad una correspondencia mal hecha
Todo esto puede parecer un detalle contable. No lo es, porque la misma cifra se usa en tres sitios más dentro del almacén. Primero, cuántas etiquetas se imprimen: sale del número de bultos, y si ese número está mal le sobrarán etiquetas o le quedarán cajas sin etiquetar. Segundo, cuántas lecturas espera una carga por código de barras: el sistema calcula cuántas esperar a partir de la misma relación. Tercero, la coherencia entre cantidad y número de cajas en el packing list. Los tres se remontan a una sola decisión, y esa decisión es el tema de este artículo.
No los desarrollamos aquí, porque cada uno tiene su propio artículo. Qué campos van en la etiqueta es un trabajo de diseño aparte: qué campos lleva la etiqueta de una caja. Y lo mismo ocurre con la forma en que cantidad y número de bultos se leen juntos en un packing list: cantidad y número de bultos en el packing list. Y si prefiere probar una etiqueta ahora mismo, tenemos una herramienta que funciona en el navegador: generador de etiquetas de caja.
Un mismo envío, tres documentos, tres cifras distintas
Mirar tres documentos de un mismo envío y encontrar tres cifras distintas es habitual, y casi siempre las tres son correctas, porque cuentan cosas diferentes: piezas de mercancía, bultos y piezas dentro de un bulto. Saber qué cifra corresponde a qué documento elimina buena parte de lo que parece una contradicción. Esa distinción, y las abreviaturas que los documentos usan para ella, se tratan aparte: qué dicen CTNS y PCS.
Qué hacemos en este lado y qué no
Cerramos este artículo con un límite y no con un argumento de venta, porque este es justamente un tema en el que la expectativa equivocada sale cara.
Lo que sí hacemos. En Smartifie Logistic la unidad no es una casilla de texto libre sino una clave canónica: unidad, kilogramo, tonelada, gramo, litro, mililitro, metro, centímetro, metro cuadrado, metro cúbico, paquete, caja, bulto, palé, rollo, juego, par y conjunto. La clave es dato; el nombre que ve en pantalla es presentación, y la clave no cambia con el idioma. Al importar desde Excel puede escribir el nombre de la unidad en cualquiera de los tres idiomas de la interfaz y todos se resuelven a la misma clave; una fila con una unidad que no se puede resolver no se adivina, se omite. En las unidades que admiten valores fraccionarios (kilogramo, litro, metro y similares) son obligatorios una segunda unidad y un factor de conversión. La pantalla de unidades en /units muestra qué claves se aceptan y marca cada una como continua o discreta.
Lo que no hacemos, y preferimos escribirlo. La aplicación no genera facturas electrónicas. En el lado de la expedición se puede descargar un fichero XML, pero no lo firmamos, no lo validamos contra el esquema de la administración y no lo enviamos; esos pasos quedan fuera del alcance de la aplicación y el propio código los deja para una fase posterior. Por eso este artículo no muestra ninguna muestra del XML que producimos ni afirma que escribamos las claves correctamente. Tampoco existe en la aplicación un campo de tipo de embalaje ni una herramienta que contraste las claves de unidad con la lista oficial. La confusión que describe este artículo está muy extendida, y la respuesta honesta es que nuestro propio lado no queda fuera de ella.
Para cerrar con la tesis inicial: una caja no es una unidad de medida, es un envase. El documento hace dos preguntas, tiene dos campos y bebe de dos listas. Sepárelos una vez y "qué clave es una caja" deja de ser una búsqueda en una lista de claves para convertirse en una elección de campo, y esa pregunta es mucho más fácil de responder.