CodRef: códigos 1, 2 y 3

Qué significa CodRef en una nota de crédito o débito, cuándo usar 1, 2 o 3 y por qué el SII repara una referencia incoherente.

Dónde va: DTE / Documento / Referencia / CodRef
Zona: Referencia

Qué es <CodRef>

CodRef declara el efecto que una nota tiene sobre el documento referenciado. Es una instrucción tributaria, no una categoría interna ni un comentario libre. El valor 1 dice que la nota anula, el 2 que corrige texto y el 3 que corrige montos. RazonRef explica el motivo, pero no cambia el significado del código.

La coherencia se comprueba mirando el documento completo. Una corrección de texto no debe comportarse como una corrección de precio. Una anulación no es lo mismo que rebajar parcialmente una factura. Si el código y los montos expresan efectos distintos, el XML puede cumplir el esquema y aun así quedar con reparos.

El tipo y régimen del documento original también importan. Una nota sobre factura exenta debe conservar esa condición. CodRef 3 no habilita a agregar IVA a una operación exenta, y CodRef 2 no sirve para esconder un cambio de monto dentro de una supuesta corrección de texto.

¿Es obligatorio?

Es opcional en el XSD general, pero el formato lo exige en los casos de notas de crédito y débito que anulan o corrigen un documento. La obligatoriedad depende del efecto de la nota y del documento referenciado. No todas las referencias informativas usan CodRef.

Formato que espera el SII

Es un entero de un dígito. El valor 1 anula el documento de referencia, el 2 corrige texto y el 3 corrige montos. El código debe ser coherente con TipoDTE, TpoDocRef, FolioRef, FchRef, RazonRef y con los montos de la nota. Escribir un valor permitido por el XSD no basta si su significado no coincide con el documento.

Qué pasa cuando está mal

REF-2-780 aparece cuando el código de referencia no calza con el efecto real. Un caso observado es declarar anulación mientras la nota lleva montos propios de una corrección. REF L[1] -3-764 apunta a la referencia de una nota que incorpora IVA sobre un documento exento.

STATUS 7 puede aparecer antes si CodRef tiene texto, un valor fuera de la enumeración o una ubicación incorrecta. Una vez superado el esquema, la revisión debe concentrarse en la relación entre el código, la referencia y los montos. Reenviar sin cambiar esa incoherencia repite el reparo y consume un folio nuevo.

Qué revisar antes de volver a emitir

Define si la nota anula, corrige texto o corrige montos antes de construir sus líneas.
Compara el código con TipoDTE, TpoDocRef, FolioRef, FchRef y el régimen afecto o exento del original.
Comprueba que MontoItem y Totales expresen el mismo efecto que declaraste en CodRef.
Usa RazonRef para explicar la corrección en lenguaje claro, sin intentar reemplazar el código.

Errores del SII relacionados

REF-2-780
El código declara un efecto diferente del que muestran las líneas y montos de la nota.
REF L[1] -3-764
La nota referencia un documento exento, pero su contenido incorpora IVA.
STATUS 7
Puede aparecer cuando el XML no cumple el esquema, por ejemplo por un tag fuera de orden, un valor con formato inválido o un campo obligatorio ausente.

Preguntas frecuentes sobre <CodRef>

¿Qué valor de CodRef corrige un monto?

El formato del SII usa el valor 3 para corregir montos. El documento completo debe ser coherente con ese efecto y con el DTE referenciado.

¿CodRef 2 permite cambiar el precio?

No. El valor 2 es para corregir texto. Un cambio que modifica montos corresponde a otro efecto y debe representarse de forma coherente en toda la nota.

quién escribe esto

Somos expertos en facturación electrónica. Y se puede comprobar.

Simplo es un facturador electrónico. Emitimos documentos tributarios ante el SII, recibimos las respuestas y las clasificamos una por una. Esta herramienta y estas fichas salen de esa operación, no de un manual.

Certificación cerrada ante el SII
Pasamos el set de pruebas completo. Los reparos que nos observaron en el camino están publicados acá, con la corrección exacta que los destrabó. El SII no publica esos códigos: los tiene quien pasó por el proceso.
REF-2-780 REF L[1] -3-764 HED-2-220 HED-3-834 DTE-3-101
50 códigos del SII catalogados, cada uno con su fuente
No es la lista que publica el SII, porque el SII no publica una lista consolidada. Son los códigos con los que operamos: unos salen de la respuesta que nos llega, otros del esquema oficial, y cada ficha dice cuál es el suyo. 37 tienen ficha completa.
32 controles que corren antes del SII
folios que se acaban, certificado por vencer o mal configurado, referencias mal codificadas, montos que no cuadran, exportaciones incompletas. Nuestro facturador los detecta por su cuenta y te los dice en castellano, la mayoría antes de que el documento salga hacia el SII. Si quieres saber si cubrimos tu caso, pregúntanos.
Emisión y recepción por API
Factura afecta y exenta, boleta, nota de crédito y de débito, guía de despacho, liquidación factura y los tres documentos de exportación. Se emite desde tu propio sistema, sin que nadie entre a una pantalla a tipear. Y los documentos que te emiten a ti también entran por ahí, con sus plazos de respuesta corriendo.

¿Y si este rechazo simplemente no ocurriera?

Un rechazo del SII llega cuando ya mandaste el documento, o sea cuando ya es tarde. Los 32 controles de arriba existen justamente para eso: la mayoría alcanza a reventar el problema antes de que el documento salga, en tu ambiente, con el mensaje en castellano y sin quemar folio.

Cuéntanos con qué sistema trabajas hoy y qué estás emitiendo. Te responde el mismo equipo que escribió estas fichas.

Cuéntanos con qué sistema trabajas →Ver la tabla de los 50 códigos

las fichas, el decodificador y la tabla son gratis, sin cuenta y sin muro · qué hacemos exactamente en facturación electrónica

Otros elementos relacionados

Fuente pública: Formato XML de documentos electrónicos del SII y Formato DTE versión 2.5, febrero de 2026. Esta ficha explica el formato público del SII. No describe la implementación interna de Simplo.

Volver al explorador del esquema del DTE