Variables para plantillas: RMA (devoluciones)

El justificante de una devolución (RMA), de venta o de compra. Se imprime desde la ficha del RMA con el botón «Vista previa», que tiene «Imprimir» y «Generar PDF». En el TPV, al devolver una venta, el enlace al RMA abre la misma vista previa. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Cómo se elige la plantilla

La plantilla se da de alta en el gestor de plantillas de documentos. Solo cuenta una: la marcada por defecto con «Aplica a» = RMA de tu metagrupo. No se puede elegir una plantilla para un RMA, un cliente o un tipo. Si no hay ninguna, o no tiene fichero, sale la plantilla estándar de Yunbit.

De las imágenes de la plantilla solo se usa la de logo o cabecera, con {LOGO}. La imagen de margen y la de pie no llegan.

Variables generales

En un RMA de compra, «pedido» es el pedido de compra y «cliente» es el proveedor.

VariableQué contieneFormato y notas
{RMA_ID}Número del RMATexto.
{RMA_DATE}Fecha de creación del RMAdd/mm/aaaa.
{INITIAL_ORDER_NUMBER}Número del pedido de origen, de venta o de compraTexto.
{ORDER_CLIENT_REF}Referencia del cliente en el pedido de ventaTexto. Vacía en un RMA de compra.
{CLIENT_NAME}Descripción de la dirección de envío del pedido; si no tiene, nombre del clienteTexto.
{CLIENT_CIF}CIF del clienteTexto.
{CLIENT_REF}Código del clienteTexto.
{CLIENT_TELS}Teléfonos de la ficha del clienteTexto. No son los de la dirección de envío.
{DELIVERY_ADDRESS}Dirección de envío del pedidoTexto.
{DELIVERY_LOC}Localidad de la dirección de envíoTexto, en castellano.
{DELIVERY_PROVINCE}Provincia de la dirección de envíoTexto, en castellano.
{LOGO}Dirección de la imagen de logo o cabecera de la plantilla, lista para <img src="{LOGO}">Vacía si la plantilla no tiene imagen.

Bloque PRODUCTS

Repite una vez por línea del RMA, también las que ya se han procesado.

<!-- BEGIN PRODUCTS -->
  <tr>
    <td>{PRODUCTS.PART_NUMBER}</td><td>{PRODUCTS.NAME}</td><td>{PRODUCTS.SERIALNUMBER}</td>
    <td>{PRODUCTS.QUANTITY} {PRODUCTS.MU_REF}</td><td>{PRODUCTS.REQUEST_TYPE_TEXT}</td><td>{PRODUCTS.REASON_TEXT}</td>
  </tr>
<!-- END PRODUCTS -->
VariableQué contieneFormato y notas
{PRODUCTS.PART_NUMBER}Part numberTexto.
{PRODUCTS.NAME}Nombre del artículoTexto.
{PRODUCTS.CUSTOM_DESC}Descripción personalizada de la línea del pedidoTexto.
{PRODUCTS.CUSTOM_LONG_DESC}Descripción larga de la línea del pedido; si no tiene, la del artículoPuede llevar HTML.
{PRODUCTS.DESCRIPTION_ART_RMA}Descripción escrita en la línea del RMATexto.
{PRODUCTS.QUANTITY}Unidades devueltasNúmero sin formato.
{PRODUCTS.ACCEPTED_QUANTITY}Unidades aceptadasNúmero.
{PRODUCTS.PROCESS}Unidades ya procesadas: aceptadas, rechazadas y desechadasNúmero.
{PRODUCTS.NOTVALIDATE}Unidades pendientes de procesarNúmero.
{PRODUCTS.QUANTITY_TO_PROCESS}Unidades devueltas menos las aceptadas y las desechadasNúmero.
{PRODUCTS.REQUEST_TYPE}Tipo de peticiónCódigo: R reposición, A abono, D devolución.
{PRODUCTS.REQUEST_TYPE_TEXT}Tipo de petición en textoTexto, en el idioma del documento.
{PRODUCTS.REASON_TEXT}Motivo de la devoluciónTexto.
{PRODUCTS.REASON_ID}ID interno del motivoTexto.
{PRODUCTS.SERIALNUMBER}Número de serieTexto.
{PRODUCTS.ARTICLE_BARCODE}Código de barras del número de serieTexto.
{PRODUCTS.TPV_NEW_SERIALNUMBER}Número de serie nuevo, en una devolución del TPVTexto.
{PRODUCTS.CONTAINER_NUM}Número del contenedorTexto.
{PRODUCTS.CONTAINER_BARCODE}Código de barras del contenedorTexto.
{PRODUCTS.MULTIPLIER}Multiplicador de la preparaciónNúmero.
{PRODUCTS.MU_REF}Unidad de medidaTexto.
{PRODUCTS.MU_CODISO}Código ISO de la unidad de medidaTexto.
{PRODUCTS.MU_COD_INTEGRATION_1}Código de integración de la unidad de medidaTexto.
{PRODUCTS.WEIGHT}Peso del artículoNúmero sin formato.
{PRODUCTS.A_COD_INTEGRATION_1}Código de integración 1 del artículoTexto.
{PRODUCTS.WARRANTY}Garantía de la línea del pedidoTexto.
{PRODUCTS.UNIT_PRICE}Precio unitario de la línea del pedidoSin IVA. Número sin formato, con 4 decimales y punto decimal, sin símbolo de moneda.
{PRODUCTS.GROSS_STOCK_UNIT_PRICE}, {PRODUCTS.RATED_STOCK_PRICE}, {PRODUCTS.GROSS_NO_STOCK_UNIT_PRICE}, {PRODUCTS.RATED_NO_STOCK_PRICE}Precios bruto y de tarifa, con stock y sin stockSin IVA. Número sin formato, sin símbolo de moneda.
{PRODUCTS.COST}Coste del número de serieNúmero sin formato.
{PRODUCTS.COSTUD}Coste unitario de la línea del pedido de compraNúmero sin formato.
{PRODUCTS.POC_POSITION}Posición de la línea en el pedido de compraNúmero.
{PRODUCTS.STORE_REFERENCE}Referencia del almacén donde está el número de serieTexto.
{PRODUCTS.ISDEPOSIT}Si el pedido es de depósito0 o 1.
{PRODUCTS.IDPROJECT}, {PRODUCTS.PROJ_TYPE_NAME}Proyecto y tipo de proyectoTexto. Solo con la solución de Proyectos.

La plantilla estándar

La plantilla estándar del RMA tiene los textos («Nº RMA», «Pedido», «Petición»…) escritos en castellano, sin {ydic_…}. Si partes de ella para hacer la tuya, cambia esos textos por {ydic_…} si necesitas otros idiomas, y quita las variables que no existen en el RMA (las tienes en Nombres que no debes usar).

Textos traducidos y otras variables

  • **Textos traducidos: solo {ydic_clave}.** En la plantilla del RMA {dic_clave} sale vacía. Escribe {ydic_clave}, o {ydics_clave} para el plural, como explica la portada.
  • Cómo se genera el PDF. Además de las variables de arriba, la plantilla recibe dos más:
VariableQué contieneFormato y notas
{pdf_puppeteer}1 si la plataforma genera el PDF con Puppeteer; si no, vacíaPara cargar un CSS de impresión u otro.
{pdf_docraptor}1 si la plataforma genera el PDF con DocRaptor; si no, vacíaIgual que la anterior.

Preguntas frecuentes

¿El RMA tiene variables para el código postal, el país o el contacto?

No. El RMA no pasa a la plantilla el código postal, el país, la persona de contacto, el teléfono de la dirección, el estado, el tipo ni el almacén de destino.

¿Dónde queda guardado el PDF?

En los documentos del propio RMA, al pulsar «Generar PDF» en la vista previa.

Con {LOGO}, que trae la imagen de logo o cabecera subida en la plantilla. La imagen de margen y la de pie no llegan a la plantilla.

Nombres que no debes usar

No usesUsaPor qué
{dic_clave}{ydic_clave}En esta plantilla sale siempre vacía.
{FINAL_ORDER_NUMBER}, {DELIVERY_CP}, {DELIVERYNOTE_OBS}, {footer}, {invoice_bottom}, {invoice_margin}—La plantilla estándar del RMA las incluye, pero salen siempre vacías.
{PRODUCTS.MEASUREMENT_UNIT}{PRODUCTS.MU_REF}Sale siempre vacía.

Cuidado con

  • Precios a cero. Si el número de serie devuelto es de otro artículo distinto del de la línea del pedido, todos los precios y el coste de esa línea salen a 0. Los importes del RMA llegan sin formato (4 decimales con punto) y sin símbolo de moneda.
  • Direcciones de CSS e imágenes. Al generar el PDF, una dirección relativa (css/rma.css) puede no encontrarse. Escribe direcciones que empiecen por / o direcciones completas.
  • Llaves en CSS y JavaScript. Una palabra sola entre llaves ({detail}, {}) se toma como variable y desaparece. Deja espacios dentro de las llaves o lleva el JavaScript a un fichero aparte; lo explica la portada de la serie.
  • Comentarios HTML. Un comentario que empieza por IF, ELSE, BEGIN, END, INCLUDE o DEFINE se toma como una orden de la plantilla. Escribe los comentarios con otra palabra delante.

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Fecha de publicación: 13 de noviembre del 2026, 19:56h
« 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