Rechazos de Hacienda más comunes: qué significa cada código y cómo resolverlo

Respuesta corta: los rechazos más frecuentes de Hacienda en la v4.4 son -1 (el XML viola el esquema, casi siempre una línea sin impuesto), -400 (CABYS inexistente), -45 (impuesto de la línea mal calculado), -509 (nota con un CABYS que no está en el original) y -493 (la suma del pago mixto no da el total). El -37 de ubicación aparece mucho pero casi nunca es el motivo real: buscá el otro código del mensaje.

Un rechazo de Hacienda llega como un texto con uno o varios códigos negativos. Esta referencia explica los que más se ven, qué los provoca y cómo se arreglan, a partir de comprobantes emitidos de verdad contra Hacienda.

Cómo se lee un rechazo

El mensaje de Hacienda trae una lista: código, descripción y la línea donde ocurrió.

El comprobante electrónico tiene los siguientes errores:
-400, "En la línea (1) el código indicado en el campo 'Código de Producto/Servicio'
no se encuentra en el Catálogo de Bienes y Servicios CAByS", 0, 0

Un rechazo suele traer varios códigos y no todos son la causa. El caso más claro es el -37: en una medición sobre 426 rechazos de 30 días apareció en 306, pero nunca solo; siempre venía con el código que de verdad rechazaba. Antes de perseguir un código, mirá si aparece solo en el documento.

Los códigos, por familia

Estructura del XML

Código	Qué pasó	Cómo se arregla
-1	Violación del esquema XSD	Casi siempre una línea sin impuesto o un valor fuera de catálogo. Toda línea declara IVA, aunque sea exenta
-513	Línea sin impuesto de la familia IVA	Declará el IVA (códigos 01, 07 u 08) incluso si es exento: codigoTarifa 10
-131	Referencia sin Codigo o sin Razon	El XSD los marca opcionales, pero Hacienda los exige
-58	Plazo de crédito mal estructurado	Con condición de venta 02 (crédito), el plazo es obligatorio

Productos y cálculo

Código	Qué pasó	Cómo se arregla
-400	El CABYS no existe	Validá el código contra el catálogo antes de emitir. Un CABYS copiado de un ejemplo produce este rechazo
-45	Monto de impuesto de la línea mal calculado	El impuesto es base × tarifa por línea. Calcularlo sobre el total y repartirlo deja diferencias
-454	Base imponible mal armada	Revisá qué impuestos engrosan la base del IVA
-111	Clasificación bien/servicio inconsistente	Hacienda la deduce del CABYS
-41	Descuento sin código de descuento	Agregá el código de descuento
-505	Tarifa transitoria en factura o tiquete	Esas tarifas solo valen en notas de crédito y débito

Notas de crédito, débito y referencias

Código	Qué pasó	Cómo se arregla
-509	Un CABYS de la nota no está en el documento referenciado	Usá los mismos CABYS de la factura; algo nuevo va en otro comprobante
-508	El receptor no coincide con el del documento referenciado	En un recibo de pago, todas las referencias deben ser del mismo cliente
-29	«La clave numérica de referencia no existe»	Pasa al sustituir un rechazado con tipo de documento 01: tiene que ser 10

Pagos

Código	Qué pasó	Cómo se arregla
-493	La suma de los medios de pago no da el total	Hacienda tolera ₡1 de diferencia. Cuadrá cada monto
-496	IVA devuelto (salud privada) sin pago con tarjeta, o monto distinto al que Hacienda recalcula	Incluí el medio de pago 02 y dejá que el monto se calcule

Exoneraciones

Código	Qué pasó	Cómo se arregla
-125	Exoneración inválida	Revisá documento y montos. En el sandbox de Hacienda, las de tipo 04 y 11 se rechazan siempre
-190	El monto exonerado no cuadra con la tarifa exonerada	La tarifa exonerada son los puntos de IVA que se exoneran, no un porcentaje del impuesto
-478	Exoneración sin artículo	Los tipos 02, 03, 06, 07 y 08 lo exigen
-479	Exoneración con artículo pero sin inciso	El inciso es 0 si el artículo no tiene incisos; no se omite

Identificación

Código	Qué pasó	Cómo se arregla
-38	DIMEX, NITE o cédula del receptor que no existe en el padrón	Verificá la identificación del cliente antes de emitir
-37	Ubicación del emisor distinta a la del padrón	No bloquea: buscá el otro código. Para limpiarlo, poné provincia, cantón y distrito exactamente como en Tributación
-37 (otro texto)	«El emisor tiene condición diferente a Inscrito»	Este sí rechaza solo. Revisá la situación del contribuyente en Hacienda; en sandbox puede ser un padrón desfasado

Lo que más rechazos evita

Casi todo lo de arriba se puede cortar antes de firmar, que es donde conviene: un error que detecta tu sistema no gasta consecutivo; uno que detecta Hacienda, sí. Las tres reglas con más impacto:

1. Ninguna línea sin IVA. Ni impuesto vacío ni ausente.
2. Ningún CABYS sin verificar. Validá todo tu catálogo de productos una vez.
3. Ningún total calculado a mano. Que lo calcule el motor de impuestos, línea por línea.

En la API de Facturaencr las tres ya vienen resueltas: un impuesto sin IVA, un pago mixto que no cuadra o una referencia mal armada se cortan con un 400 antes de firmar, sin gastar el consecutivo. Y cuando Hacienda rechaza, GET /documents/{id} trae un objeto rechazo con el código que de verdad bloqueó, su explicación y cómo arreglarlo, con los acompañantes como el -37 marcados aparte.

Después del rechazo

Un comprobante rechazado no se corrige ni se reenvía: el consecutivo ya se consumió. Se emite uno nuevo con los datos arreglados que indique cuál sustituye, y no se hace nota de crédito sobre el rechazado. El procedimiento está en qué hacer si Hacienda rechaza una factura.

Preguntas frecuentes

¿Por qué me sale el -37 si mi dirección está bien?

Porque casi siempre es un acompañante: en nuestra medición nunca fue el único motivo. Mirá el otro código del mensaje.

¿Un rechazo me cuenta como emitido?

El consecutivo se consume y queda registrado como rechazado. El comprobante no tiene validez fiscal.

¿Dónde veo la lista completa de errores de Hacienda?

Los códigos que documentamos están verificados emitiendo. La tabla completa, con los de la API, está en la documentación.

¿El código -1 qué campo es?

El texto del mensaje trae el nodo del esquema que falló. Lo más común es una línea sin impuesto o un valor fuera de catálogo.

Facturaencr valida contra las reglas reales de Hacienda antes de firmar y, si igual hay rechazo, te lo explica en español junto al documento. Funciona igual en el portal, en el punto de venta y en la API. Para las tarifas de IVA, mirá los códigos de tarifa vigentes.