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.
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:
La plantilla por defecto: «Aplica a» = DeCA y «¿Es la plantilla por defecto para el metagrupo?» = Sí, con fichero de plantilla subido.
Un diseño propio de tu empresa, si Yunbit lo ha preparado.
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
Variable
Qué contiene
Formato y notas
{CLIENT_NAME}
Nombre de tu empresa
No es el destinatario: ese es {packages.CLIENT_NAME}
{CLIENT_CIF}
NIF de tu empresa
{CLIENT_ADDRESS}
Calle de tu empresa
En MAYÚSCULAS. Solo la calle, sin número
{CLIENT_CP}
Código postal
{CLIENT_LOC}
Población
En castellano
{CLIENT_PROVINCE}
Provincia
En 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.
Variable
Qué contiene
Formato y notas
{CARRIER_NAME}
Nombre del transportista
{CARRIER_CIF}
NIF del transportista
{CARRIER_ADDRESS}
Calle y número
En 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
Variable
Qué contiene
Formato y notas
{DECA_QR}
QR con la dirección pública del PDF
Imagen ya preparada para <img src="{DECA_QR}">
{DECA_URL}
La dirección pública del PDF, la misma del QR
Dirección web completa. Quien la tenga descarga el DeCA sin iniciar sesión
{LOGO}
Logo de tu plataforma
Imagen 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 PDF
Para un botón «Descargar PDF»
{pdf_puppeteer} y {pdf_docraptor}
1 según el servicio con el que tu plataforma genera los PDF
1 o vacía. La plantilla estándar las usa para elegir los estilos de impresión
Totales de la recogida
Variable
Qué contiene
Formato y notas
{packages_num}
Número total de bultos
Número entero. Suma los bultos de todas las expediciones
{weight_total}
Peso total
En kg, con dos decimales y formato español: 1.234,50
{volumes_total}
Volumen total
En m³, con dos decimales y formato español
{multiple_orders}
Si en la recogida va más de un pedido o traspaso
1 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 recogida
Texto
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.
Variable
Qué contiene
Formato y notas
{pages.CREATED}
Fecha y hora de la recogida
dd/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 recogida
Texto libre. No es el transportista efectivo ({CARRIER_NAME})
{pages.VEHICLE_PLATE}
Matrícula del vehículo
{pages.TRAILER_PLATE}
Matrícula del semirremolque
Puede estar vacía
{pages.SPECIAL_PERMIT}
Autorización especial de circulación
Puede 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ón
Separados 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ón
En 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.
Variable
Qué contiene
Formato y notas
{pages.packages.EXP_NUM}
Número de expedición
{pages.packages.CLIENT_NAME}
Destinatario
En 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 contacto
El «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 contacto
El 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 entrega
En un traspaso, la del almacén de destino
{pages.packages.CP}
Código postal de entrega
{pages.packages.LOC}
Población de entrega
En castellano, o el texto escrito a mano. No hay variable con la provincia de entrega
{pages.packages.ORIGIN_NAME}
Almacén de origen
El 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 bultos
Separadas por , . Solo categorías de primer nivel que no son de menú web
{pages.packages.SHIPPING_SERVICE}
Servicio de transporte
Si 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ón
Nú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ón
En m³, con dos decimales y formato español
{pages.packages.TOTAL_VOLUMES}
Volumen de la expedición sin convertir
En cm³, sin formatear
{pages.packages.EXP_TOTAL_VOLUMES}
Volumen anotado en la propia expedición
Sin 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ón
Separados por ,
{pages.packages.DELIVERY_NOTE_NUM}
Número de albarán de la expedición
{pages.packages.PICKUP_NUM}
Número de la recogida
Igual en todas las filas
{pages.packages.CREATED}
Fecha de la recogida
Sin 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ículo
Se escribe así, con minúsculas y la P mayúscula
{pages.packages.trailerPlate}
Matrícula del semirremolque
Se escribe así
{pages.packages.specialPermit}
Autorización especial de circulación
Se 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 uses
Usa
Por 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
Utilizamos cookies para optimizar nuestro sitio web y nuestro servicio.
Técnicas o necesarias / preferencias
Siempre activo
El almacenamiento o acceso técnico es estrictamente necesario para el propósito legítimo de permitir el uso de un servicio específico explícitamente solicitado por el abonado o usuario, o con el único propósito de llevar a cabo la transmisión de una comunicación a través de una red de comunicaciones electrónicas.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Análisis o medición
The technical storage or access that is used exclusively for statistical purposes.El almacenamiento o acceso técnico que se utiliza exclusivamente con fines estadísticos anónimos. Sin un requerimiento, el cumplimiento voluntario por parte de tu Proveedor de servicios de Internet, o los registros adicionales de un tercero, la información almacenada o recuperada sólo para este propósito no se puede utilizar para identificarte.
Publicidad comportamental
El almacenamiento o acceso técnico es necesario para crear perfiles de usuario para enviar publicidad, o para rastrear al usuario en una web o en varias web con fines de marketing similares.