Código de referencia
Codifica el motivo por el que un comprobante hace referencia a otro (típico en notas de crédito y notas de débito).
Dónde va
El código se acepta en referencias[].codigo o en referencias[].razon, indistintamente: se toma el primero de los dos que sea un código válido del catálogo del tenant. Estas dos referencias son equivalentes:
{ "codigo": "01", "razon": "Anulación total por error en el monto" }{ "razon": "01" }Lo que no se acepta es únicamente texto libre en ambos campos. En ese caso la emisión se rechaza con 400 y el mensaje lista los códigos disponibles:
{
"error": "La razón de la referencia no es un código válido (razon='Cargo por interés moratorio'). Envíe el código de 2 dígitos en 'codigo' o en 'razon', tomado del catálogo: 01 (Anula documento de referencia), 02 (Corrige texto del documento de referencia), …"
}Catálogo
| Código | Descripción | Uso habitual |
|---|---|---|
01 | Anula documento de referencia | NC que deja sin efecto la venta |
02 | Corrige texto del documento de referencia | Datos del receptor, descripciones |
04 | Referencia a otro documento | Vínculo genérico |
05 | Sustituye comprobante provisional por contingencia | Emisión diferida |
06 | Devolución de mercancía | NC por devolución |
07 | Sustituye comprobante electrónico | Reemplazo completo |
08 | Factura endosada | — |
09 | Nota de crédito financiera | Descuentos y bonificaciones posteriores |
10 | Nota de débito financiera | Intereses, moras, cargos adicionales |
11 | Proveedor no domiciliado | — |
12 | Crédito por exoneración posterior a la facturación | — |
99 | Otros | Acompañar con descripción en español claro |
Cada tenant puede tener habilitado un subconjunto de estos códigos. El mensaje de error del 400 devuelve siempre los que su tenant acepta.
El
03“Corrige monto” ya no existe. La versión 4.4 del esquema de Hacienda lo eliminó del catálogoCodigoReferenciaType(junto con la incorporación de06–12, que antes no se ofrecían). Está desactivado en la base de datos de todos los tenants: enviarlo devuelve400igual que cualquier otro código no vigente. Las notas de crédito y débito emitidas antes con03no se tocaron — conservan su código histórico para no dejar el comprobante sin glosa —, pero ningún comprobante nuevo puede volver a usarlo. Para el caso de uso original (“corregir un monto”), use99“Otros” acompañado de una descripción en texto libre que explique el ajuste — es el mismo tratamiento que recibieron las notas históricas al migrarlas.
Cuidado con el 01 en una nota de débito
Además de declarar que la nota anula el documento referenciado, 01 es el único código con el que una nota de débito descuenta inventario. Para el caso normal de una ND —un cargo adicional que no mueve mercadería— corresponde 10 o 04.
Ver también: tipo de referencia · FacturaApiReferenciaDto.