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 |
03 | Corrige monto | Ajuste de importes |
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.
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.