API DE LEYENDAS FISCALES

¿Qué son las leyendas fiscales?

Son textos que una ley o una regla te obliga a incluir en el comprobante. No son observaciones libres ni notas al cliente: cada leyenda va acompañada de la disposición que la exige, para que quede claro por qué está ahí.

La diferencia con una nota normal es esa trazabilidad. Un "gracias por su compra" va en las observaciones del PDF; una leyenda de exportador o de donataria autorizada va aquí, con su fundamento.

El nodo

"Complemento": {
    "TaxLegends": {
        "Legends": [
            {
                "TaxProvision": "F0000001",
                "Norm": "F2654",
                "Text": "EXPORTADOR #####"
            }
        ]
    }
}

Tres campos por leyenda:

• TaxProvision — la disposición fiscal que la exige. Opcional.
• Norm — el artículo o regla concreta. Opcional.
• Text — el texto de la leyenda. Este sí es obligatorio.

Quién las necesita

Este complemento tiene una particularidad: casi nadie lo necesita, y quien lo necesita lo necesita en todas sus facturas. No hay término medio.

Los casos habituales son exportadores con obligaciones específicas de su programa, donatarias autorizadas, y contribuyentes con regímenes o estímulos que exigen dejar constancia en el comprobante. Si es tu caso, tu contador ya te habrá dicho qué texto exacto debes incluir y bajo qué fundamento.

Y si nadie te lo ha pedido, probablemente no aplica. Añadir leyendas por si acaso no aporta nada — y ensucia el comprobante.

Cómo integrarlo sin repetirte

Como la leyenda suele ser la misma en todas tus facturas, no tiene sentido pasarla desde el código de cada llamada. El patrón sensato es guardarla en configuración —una tabla, un archivo de settings— y que la capa que arma el payload la inyecte siempre.

Así, el día que cambie la norma que la fundamenta, se toca un registro y no cada punto del sistema donde se emite una factura. Que es exactamente lo que pasa cuando alguien la hardcodea en tres sitios distintos.

Ciclo de vida y SDKs

Al viajar dentro de una factura normal, aplican las operaciones de siempre: consultar por Id, descargar XML y PDF, enviar por correo y cancelar. Librerías oficiales en PHP, Python, JavaScript, Java, Ruby y .NET (4.5+).

Preguntas frecuentes

¿Puedo poner varias leyendas en una factura?

Sí. Legends es un arreglo y cada elemento lleva su propio texto y fundamento.

¿Es lo mismo que las observaciones del PDF?

No. Las observaciones son texto libre sin efecto fiscal. Una leyenda responde a una disposición concreta y viaja dentro del XML.

¿Qué campos son obligatorios?

Solo Text. La disposición fiscal y la norma son opcionales, aunque conviene incluirlas cuando se conocen.