Variables para plantillas: DeCA (documento de control del transporte)

El DeCA es el documento de control del transporte de mercancías por carretera. Recoge el cargador contractual (tu empresa), el transportista efectivo, la matrícula, el origen, el destino, la naturaleza de la mercancía, el peso y los bultos de cada expedición de una recogida, y un QR para descargar el PDF.

Sale en lugar del justificante de entrega cuando el servicio de transporte de las expediciones de la recogida tiene marcado «Emitir DeCA». Se imprime al cerrar la recogida, desde la ficha de la recogida (pestaña «Vista»), al reemitirlo y desde los documentos de pedidos y traspasos. El justificante de entrega se explica en Albaranes, packing list y justificantes de entrega.

La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Antes de empezar

  • Las plantillas se dan de alta en el gestor de plantillas de documentos.
  • Solo se usa la plantilla marcada por defecto. No se puede elegir plantilla por cliente, por tipo ni en el propio documento.
  • Deja una sola plantilla por defecto con este «Aplica a» en toda la plataforma. Yunbit no mira de qué empresa (metagrupo) es la plantilla: si hay varias marcadas por defecto, sale una cualquiera.
  • La marca «Antigua» no cuenta aquí. Una plantilla antigua que siga marcada como «¿Es la plantilla por defecto para el metagrupo?» = Sí se sigue usando. Para dejar de usarla, quítale la marca de por defecto.
  • Las imágenes de la ficha de la plantilla (logo o cabecera, margen y pie) no se usan: subirlas no cambia nada.
  • Si no hay plantilla por defecto con fichero subido, se usa el diseño propio que Yunbit haya preparado para tu empresa, si lo hay, y si no, la plantilla estándar de Yunbit.
  • **Los nombres {vue} y {dic} ya están ocupados**: meten en la página los scripts de la plataforma y el diccionario completo. No escribas esas palabras entre llaves en tu plantilla.

Cómo se elige la plantilla

Se da de alta con «Aplica a» = DeCA. Yunbit usa la primera que encuentra:

  1. La plantilla por defecto: «Aplica a» = DeCA y «¿Es la plantilla por defecto para el metagrupo?» = Sí, con fichero de plantilla subido.
  2. Un diseño propio de tu empresa, si Yunbit lo ha preparado.
  3. La plantilla estándar de Yunbit.

La plantilla de justificante de entrega que tenga elegida el cliente en su ficha no se usa para el DeCA.

La primera vez que se emite un DeCA, Yunbit guarda su PDF. Desde entonces, al pedir el PDF (desde la plataforma o con el QR) se entrega ese PDF guardado, sin volver a pintar la plantilla. Un cambio de plantilla solo se ve en los DeCA nuevos o al reemitirlo.

Variables

Cargador contractual: tu empresa

VariableQué contieneFormato y notas
{CLIENT_NAME}Nombre de tu empresaNo es el destinatario: ese es {packages.CLIENT_NAME}
{CLIENT_CIF}NIF de tu empresa
{CLIENT_ADDRESS}Calle de tu empresaEn MAYÚSCULAS. Solo la calle, sin número
{CLIENT_CP}Código postal
{CLIENT_LOC}PoblaciónEn castellano
{CLIENT_PROVINCE}ProvinciaEn castellano

Transportista efectivo

Es el proveedor elegido en el campo «Proveedor» de la compañía de transporte de la recogida. Si la compañía no tiene proveedor, el DeCA no se emite y Yunbit avisa con un mensaje.

VariableQué contieneFormato y notas
{CARRIER_NAME}Nombre del transportista
{CARRIER_CIF}NIF del transportista
{CARRIER_ADDRESS}Calle y númeroEn MAYÚSCULAS. Si el proveedor tiene varias direcciones, sale una cualquiera
{CARRIER_CP}Código postal
{CARRIER_LOC}Población
{CARRIER_PROVINCE}Provincia

QR, logo y documento

VariableQué contieneFormato y notas
{DECA_QR}QR con la dirección pública del PDFImagen ya preparada para <img src="{DECA_QR}">
{DECA_URL}La dirección pública del PDF, la misma del QRDirección web completa. Quien la tenga descarga el DeCA sin iniciar sesión
{LOGO}Logo de tu plataformaImagen ya preparada para <img src="{LOGO}">. Si tu plataforma no tiene logo propio, sale el de Yunbit. No es la imagen de cabecera de la ficha de la plantilla
{downloadURL}Dirección de esta misma página para descargar el PDFPara un botón «Descargar PDF»
{pdf_puppeteer} y {pdf_docraptor}1 según el servicio con el que tu plataforma genera los PDF1 o vacía. La plantilla estándar las usa para elegir los estilos de impresión

Totales de la recogida

VariableQué contieneFormato y notas
{packages_num}Número total de bultosNúmero entero. Suma los bultos de todas las expediciones
{weight_total}Peso totalEn kg, con dos decimales y formato español: 1.234,50
{volumes_total}Volumen totalEn m³, con dos decimales y formato español
{multiple_orders}Si en la recogida va más de un pedido o traspaso1 si hay varios; 0 si solo hay uno. La plantilla estándar lo usa para poner el albarán, el pedido y los portes en la cabecera (un pedido) o en cada línea (varios)
{comment}Comentario de la recogidaTexto

Textos traducidos en el DeCA

Escribe los textos del diccionario con {ydic_clave}. En el DeCA no existe la forma {dic_clave}: sale vacía. La plantilla estándar no usa el diccionario: todos sus textos están en castellano.

Bloques

Todo el documento va dentro del bloque pages, y las expediciones dentro de pages.packages. Los dos nombres van en minúsculas:

<!-- BEGIN pages -->
  <p>Recogida {pages.PICKUP_NUM} del {pages.CREATED}. Matrícula: {pages.VEHICLE_PLATE}</p>
  <table>
  <!-- BEGIN packages -->
    <tr>
      <td>{pages.packages.EXP_NUM}</td>
      <td>{pages.packages.CLIENT_NAME}</td>
      <td>{pages.packages.WEIGHT}</td>
    </tr>
  <!-- END packages -->
  </table>
<!-- END pages -->

pages: la recogida

pages tiene siempre una sola fila. Sus datos de pedido, albarán, portes y volumen son los de la primera expedición de la recogida.

VariableQué contieneFormato y notas
{pages.CREATED}Fecha y hora de la recogidadd/mm/aaaa hh:mm:ss
{pages.STORE_USER}Usuario que entregó la mercancía (quien hizo la recogida)Nombre del usuario
{pages.CARRIER}Transportista escrito a mano en la recogidaTexto libre. No es el transportista efectivo ({CARRIER_NAME})
{pages.VEHICLE_PLATE}Matrícula del vehículo
{pages.TRAILER_PLATE}Matrícula del semirremolquePuede estar vacía
{pages.SPECIAL_PERMIT}Autorización especial de circulaciónPuede estar vacía
{pages.PICKUP_NUM}Número de la recogida
{pages.ORDER_NUMBER}Números de pedido (o del traspaso) de la primera expediciónSeparados por ,
{pages.DELIVERY_NOTE_NUM}Número de albarán de la primera expedición
{pages.SHIPPING_COMPANY}Compañía de transporte
{pages.EXP_TYPE}Portes de la primera expedición«Pagados» o «Debidos», en el idioma del usuario
{pages.TOTAL_VOLUMES}Volumen de la primera expediciónEn m³, con seis decimales y formato español. No es el total de la recogida

pages.packages: una expedición

packages se repite una vez por cada expedición de la recogida, por orden de creación.

VariableQué contieneFormato y notas
{pages.packages.EXP_NUM}Número de expedición
{pages.packages.CLIENT_NAME}DestinatarioEn MAYÚSCULAS. El «Nombre de la Empresa» de la dirección de entrega; si no tiene, el nombre del cliente del pedido; si no, --
{pages.packages.CONTACT_NAME}Persona de contactoEl «Título» de la dirección de entrega; si no tiene, nombre y apellidos del contacto del pedido; si no, --
{pages.packages.TEL}Teléfono de contactoEl de la dirección; si no tiene, el móvil del contacto; si no, su teléfono
{pages.packages.ADDRESS}Calle y número de entregaEn un traspaso, la del almacén de destino
{pages.packages.CP}Código postal de entrega
{pages.packages.LOC}Población de entregaEn castellano, o el texto escrito a mano. No hay variable con la provincia de entrega
{pages.packages.ORIGIN_NAME}Almacén de origenEl almacén de las líneas preparadas; en un traspaso, el almacén de origen
{pages.packages.ORIGIN_ADDRESS}Calle y número del almacén de origen
{pages.packages.ORIGIN_CP}Código postal de origen
{pages.packages.ORIGIN_LOC}Población de origen
{pages.packages.ORIGIN_PROVINCE}Provincia de origen
{pages.packages.CATEGORIES}Naturaleza de la mercancía: las categorías principales de los artículos de los bultosSeparadas por , . Solo categorías de primer nivel que no son de menú web
{pages.packages.SHIPPING_SERVICE}Servicio de transporteSi el servicio no está dado de alta, sale su código
{pages.packages.SHIPPING_COMPANY}Compañía de transporte
{pages.packages.NUM_PACKAGES}Número de bultos de la expediciónNúmero entero
{pages.packages.WEIGHT}Peso de la expedición (suma de sus bultos)En kg, con dos decimales y formato español
{pages.packages.VOLUMES}Volumen de la expediciónEn m³, con dos decimales y formato español
{pages.packages.TOTAL_VOLUMES}Volumen de la expedición sin convertirEn cm³, sin formatear
{pages.packages.EXP_TOTAL_VOLUMES}Volumen anotado en la propia expediciónSin formatear. Puede no coincidir con la suma de los bultos
{pages.packages.EXP_TYPE}Portes«Pagados» o «Debidos»
{pages.packages.ORDER_NUMBER}Números de pedido (o del traspaso) de la expediciónSeparados por ,
{pages.packages.DELIVERY_NOTE_NUM}Número de albarán de la expedición
{pages.packages.PICKUP_NUM}Número de la recogidaIgual en todas las filas
{pages.packages.CREATED}Fecha de la recogidaSin formatear: aaaa-mm-dd hh:mm:ss. Para mostrarla, mejor {pages.CREATED}
{pages.packages.CN}Usuario que hizo la recogida
{pages.packages.CARRIER}Transportista escrito a mano en la recogida
{pages.packages.COMMENT}Comentario de la recogida
{pages.packages.vehiclePlate}Matrícula del vehículoSe escribe así, con minúsculas y la P mayúscula
{pages.packages.trailerPlate}Matrícula del semirremolqueSe escribe así
{pages.packages.specialPermit}Autorización especial de circulaciónSe escribe así

Cuidado con

  • No confundas {CLIENT_NAME} (tu empresa, fuera de los bloques) con {pages.packages.CLIENT_NAME} (el destinatario de cada expedición).
  • Con varios pedidos en la recogida, los datos de pedido, albarán y portes de pages son solo los de la primera expedición. Usa los de packages y la condición <!-- IF multiple_orders == '1' -->, como hace la plantilla estándar.
  • Los datos de tu empresa salen vacíos si la población y la provincia de tu dirección se escribieron a mano en lugar de elegirlas de la lista. Revisa la dirección de tu empresa si {CLIENT_NAME} y las demás no salen.
  • La plantilla estándar pone «(cm3)» en el título de la columna de volumen, pero {pages.packages.VOLUMES} y {volumes_total} van en m³. Corrige ese texto en tu copia.
  • Para que Yunbit pueda guardar el PDF del DeCA, conserva las condiciones <!-- IF pdf_puppeteer == '1' --> y <!-- IF pdf_docraptor == '1' --> con sus estilos de impresión.
  • La numeración «Página X de Y» de la plantilla estándar la ponen sus estilos de impresión, no una variable.
  • No pongas la dirección del QR ({DECA_URL}) en ningún sitio que no deba ver cualquiera: con ella se descarga el documento sin iniciar sesión.

Preguntas frecuentes

¿Puedo tener una plantilla distinta para cada cliente?

No. Solo se usa la plantilla marcada por defecto.

¿Puedo poner importes, forma de pago, vencimiento, IVA, comercial o proyecto?

No. Este documento no tiene esos datos.

¿Cómo pongo el logo de mi empresa?

{LOGO} ya trae el logo de tu plataforma.

¿Puedo traducir los textos de la plantilla?

Sí, con {ydic_clave}. Las poblaciones, provincias y países salen siempre en castellano.

He cambiado la plantilla del DeCA y sigue saliendo igual

El PDF de un DeCA se guarda la primera vez que se emite, y después se entrega siempre ese. Tu plantilla nueva se verá en los DeCA nuevos o al reemitir uno.

Nombres que no debes usar

Estos nombres salen en la plantilla estándar o parecen lógicos, pero salen vacíos o con otro valor:

No usesUsaPor qué
{DELIVERY_NOTE_DATE}{pages.CREATED}Sale siempre vacía
{dic_clave}{ydic_clave}En esta plantilla sale siempre vacía
{CLIENT_NAME} como destinatario{pages.packages.CLIENT_NAME}Fuera del bloque, {CLIENT_NAME} es tu empresa
{pages.TOTAL_VOLUMES} como total{volumes_total}Es el volumen de la primera expedición, no el de toda la recogida
{pages.packages.CREATED} para mostrar{pages.CREATED}Sale sin formatear: aaaa-mm-dd hh:mm:ss
{pages.packages.VEHICLEPLATE} y otras en mayúsculas{pages.packages.vehiclePlate}, trailerPlate, specialPermitEl nombre tiene que ir con las mayúsculas exactas; si no, sale vacío

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Fecha de publicación: 13 de noviembre del 2026, 16:58h
« Volver atrás Sugerencias Imprimir

    Sugerencias

    Envíenos sus sugerencias para esta sección, ya sean mejoras en su funcionalidad, usabilidad o contenido. Valoraremos su opinión y comentarios e intentaremos mejorar en la medida de lo posible. Gracias por utilizar nuestros servicios.

    Nota: Todos los campos son obligatorios.

    Información básica sobre protección de datos

    La entidad responsable del tratamiento es YUNBIT, S.L. La finalidad para la cual se recaban los datos es recabar información para mejorar esta wiki. La legitimación para captar la información es el propio consentimiento del interesado al enviar la sugerencia. Los datos no serán cedidos a terceros, salvo obligación legal. Los usuarios disponen del derecho a acceder, rectificar y suprimir los datos, así como otros derechos, como se explica en la información adicional. Puede consultar la información adicional y detallada sobre Protección de Datos aquí: Política de privacidad

    Otros artículos de la categoría Configurar plantillas

    Out1