> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fygaro.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# SOLUCIÓN A PROBLEMAS FRECUENTES FACTURA ELECTRONICA (CR)

## En este recurso encontrará soluciones a los problemas más frecuentes relacionados con la Factura Electrónica de Hacienda (Costa Rica).

Si requiere asistencia adicional, puede contactar a nuestro equipo en: **soporte@fygaro.com**

---

##  🧾 ¿Qué hacer después de un rechazo?

1. Corregir el error.
2. Emitir una nueva factura.
3. La factura rechazada no tiene validez fiscal.

##  💡 Recomendaciones para evitar rechazos

✅ Mantener certificado (llave criptográfica) actualizado
✅ Validar datos tributarios del cliente
✅ Configurar CABYS correctamente
✅ Revisar actividad económica

Hacienda utiliza validaciones automáticas cada vez más estrictas para detectar inconsistencias.

---

### 📌 Errores frecuentes

Haga clic sobre cada error para ver su causa y solución:

* [El consecutivo ya se encuentra registrado](#consecutivo-registrado)
* [Credenciales del API inválidas](#credenciales-api-invalidas)
* [La firma del comprobante electrónico no es válida](#firma-invalida)
* [El contribuyente que firma la factura electrónica no es el emisor](#contribuyente-no-emisor)
* [OUT_OF_BOUNDS_NO_POE](#out-of-bounds)
* [Uso incorrecto de Tiquete Electrónico](#tiquete-electronico)
* [Exoneración genera monto negativo](#not-facet-valid)
* [Producto sin código CABYS](#cabys)
* [Código CABYS faltante (v4.4)](#cabys-faltante)
* [Precio unitario debe ser mayor a cero](#precio-cero)
* [Código de actividad económica inválido](#actividad-invalida)
* [Montos no coinciden según tipo Producto/Servicio](#montos)
* [CABYS no permitido en exoneración](#cabys-exoneracion)

---

## Mensaje: El consecutivo ya se encuentra registrado
<a id="consecutivo-registrado"></a>

### Solución

Este error ocurre cuando ya existen comprobantes enviados a Hacienda con ese consecutivo desde otro sistema.

Opciones:

* **Solución 1:** Modificar el *Grupo de Facturación*  
  Ajustes → Facturación → actualizar el consecutivo al último utilizado en Hacienda.

* **Solución 2:** Crear un nuevo Grupo de Facturación.

**Nota:**  
Si nunca utilizó otro sistema, actualice los consecutivos en:

Ajustes → Factura Electrónica → Consecutivos

Luego anule el documento rechazado y emítalo nuevamente.

[⬆ Volver arriba](#Home)

---

## Mensaje: Credenciales del API inválidas
<a id="credenciales-api-invalidas"></a>

### Solución

Las credenciales de Hacienda fueron revocadas.

Genere nuevas credenciales siguiendo:

👉 https://help.fygaro.com/es/article/obtener-credenciales-de-hacienda-n2c62q/

**Importante**

1. Utilice únicamente credenciales de **Producción**.
2. No presione *Aceptar* después de visualizarlas (esto las revoca nuevamente).

Actualice las credenciales en Fygaro y reintente el envío.

[⬆ Volver arriba](#Home)

---

## Mensaje: La firma del comprobante electrónico no es válida
<a id="firma-invalida"></a>

### Solución

La llave criptográfica fue revocada o expiró.

Genere una nueva:

👉 https://help.fygaro.com/es/article/obtener-credenciales-de-hacienda-n2c62q/

Luego actualícela en Fygaro.

[⬆ Volver arriba](#Home)

---

## Mensaje: El contribuyente que firma la factura electrónica no es el emisor
<a id="contribuyente-no-emisor"></a>

### Solución

La información del certificado no coincide con el obligado tributario registrado en Hacienda.

Verifique que coincidan:

* Razón social
* Identificación
* Usuario ATV

Actualice los datos en Fygaro y reenvíe la factura.

[⬆ Volver arriba](#Home)

---

## Mensaje: OUT_OF_BOUNDS_NO_POE
<a id="out-of-bounds"></a>

### Solución

El certificado electrónico expiró.

Guía para renovarlo:

👉 https://help.fygaro.com/es/article/actualizar-credenciales-de-hacienda-1qd38pq/

[⬆ Volver arriba](#Home)

---

## Mensaje: El Tiquete Electrónico es autorizado únicamente para consumidores finales
<a id="tiquete-electronico"></a>

### Solución

Los Tiquetes Electrónicos no permiten crédito fiscal.

Debe solicitar al proveedor:

1. Anular el tiquete.
2. Emitir una Factura Electrónica.

[⬆ Volver arriba](#Home)

---

## Mensaje: Value '-XXX' is not facet-valid...
<a id="not-facet-valid"></a>

### Solución

La exoneración genera un monto negativo.

Hacienda ahora solicita indicar el **porcentaje del impuesto**, no el porcentaje de exoneración.

Ejemplos:

* IVA 13% exonerado → ingresar **13**
* IVA 4% exonerado → ingresar **4**
* 50% de IVA 4% → ingresar **2**

[⬆ Volver arriba](#Home)

---

## Mensaje: Invalid content... CodigoComercial (CABYS)
<a id="cabys"></a>

### Solución

Uno o más productos no tienen código CABYS configurado.

Desde 2020 es obligatorio.

Configúrelo una sola vez por producto:

👉 https://help.fygaro.com/es/article/codigo-cabys-iehh22/

[⬆ Volver arriba](#Home)

---

## Mensaje: El precio unitario de la línea debe ser mayor a cero
<a id="precio-cero"></a>

### Solución

Hacienda no permite líneas con monto **0**.

Debe:

* Eliminar la línea, **o**
* Asignar un precio mayor a 0.

Luego vuelva a emitir la factura.

[⬆ Volver arriba](#Home)

---

## Mensaje: Invalid content... CodigoComercial (Actividad Económica)
<a id="actividad-invalida"></a>

### Solución

El código de actividad económica del emisor no es válido.

Debe ingresar exactamente el registrado en Hacienda.

Puede consultarlo en:

👉 https://atv.hacienda.go.cr/ATV/frmConsultaSituTributaria.aspx  
(o mediante Tribu-CR)

Luego actualice en:

Ajustes → Factura Electrónica → Código de Actividad

[⬆ Volver arriba](#Home)

---

## Mensaje: CodigoCABYS esperado
<a id="cabys-faltante"></a>

### Solución

Todos los artículos deben tener código CABYS.

Actualice el producto en Fygaro agregando el CABYS correspondiente y vuelva a emitir la factura.

[⬆ Volver arriba](#Home)

---

## Mensaje: Montos no coinciden según tipo Producto/Servicio
<a id="montos"></a>

### Solución

Desde Factura Electrónica **v4.4 (Septiembre 2025)** Hacienda valida que:

* Tipo de ítem (Producto o Servicio)
* Código CABYS

coincidan correctamente.

Corrija:

1. El tipo de producto, o
2. El código CABYS asignado.

[⬆ Volver arriba](#Home)

---

## Mensaje: Código CABYS no permitido en exoneración
<a id="cabys-exoneracion"></a>

### Solución

El CABYS utilizado no forma parte de la autorización de exoneración.

Valide el documento aquí:

https://api.hacienda.go.cr/fe/ex?autorizacion=AL-00000000-25

(Reemplace el número por el correspondiente.)

[⬆ Volver arriba](#Home)