1Cómo viene el error en la respuesta

Además de los campos de siempre (code, message, description, infoDetails, que no cambian), cada respuesta con error incluye 3 campos nuevos:

CampoQué contiene
codeErrorCódigo de error global (ej. IDE-004). Si el documento tuvo más de un error, se listan todos separados por " | " (no por coma: varios mensajes del catálogo ya traen comas adentro).
messageGlobalMensaje del error global, legible y estable entre países. Si hay más de un error, se listan todos separados por " | " (no por coma), en el mismo orden que codeError.
descriptionGlobalDetalle de cada error específico de Costa Rica, uno por línea (separadas por salto de línea), con el formato [codeError][código original de Costa Rica] mensaje.
ℹ️

Nota: Estos 3 campos son adicionales y no reemplazan nada de la respuesta actual: code, message, description e infoDetails se mantienen exactamente igual. Cuando la operación es exitosa, los 3 campos no se incluyen.

Ejemplo con un solo error

json
{
  "code": "9026",
  "message": "Falló la validación de algunos escenarios.",
  "infoDetails": [
    { "evento": "R", "dCodRes": "A", "dMsgRes": "El número de identificación del receptor no corresponde a un registro válido, Favor verificar" }
  ],
  "codeError": "IDE-004",
  "messageGlobal": "El identificador fiscal del receptor no está registrado en Ministerio de Hacienda. Verifique el dato.",
  "descriptionGlobal": "[IDE-004][A] El número de identificación del receptor no corresponde a un registro válido, Favor verificar"
}

Ejemplo con varios errores

json
{
  "code": "9026",
  "codeError": "IDE-004 | PAG-001",
  "messageGlobal": "El identificador fiscal del receptor no está registrado en Ministerio de Hacienda. Verifique el dato. | Falta la forma de pago o los datos del pago están incompletos.",
  "descriptionGlobal": "[IDE-004][A] El número de identificación del receptor no corresponde a un registro válido, Favor verificar\n[PAG-001][C] MedioPago: El Monto Total por Medio de Pago (TotalMedioPago) debe ser mayor a cero"
}

Ejemplo con un error de plataforma

json
{
  "code": 3064,
  "message": "El XML está mal formado.",
  "codeError": "FMT-001",
  "messageGlobal": "El XML enviado tiene errores de estructura y no se pudo leer. Revise que esté bien formado.",
  "descriptionGlobal": "[FMT-001][3064] El XML está mal formado."
}

2Validaciones de consistencia (código 9026) en Costa Rica

Cuando un documento no cumple las reglas de consistencia de Hacienda, la respuesta trae code = 9026 y una lista de eventos en infoDetails. En Costa Rica, el campo dCodRes de cada evento indica la sección del comprobante donde está el error, no la regla:

dCodResSección
AEncabezado / Información de referencia
BDetalle (líneas)
CResumen / Totales

Cada evento se clasifica por su mensaje y recibe su propio código global. Por eso, en descriptionGlobal, el código original que aparece entre corchetes es la sección (por ejemplo [IDE-004][A]).

3Severidad

SeveridadSignificado
CRITICAL (Crítica)Falla grave, generalmente del lado de Digifact. Se recomienda reintentar y, si persiste, contactar soporte.
HIGH (Alta)Impide la certificación del documento. Requiere corregir el documento o los datos enviados.
MEDIUM (Media)Impide la certificación del documento. Generalmente un dato puntual a corregir.
LOW (Baja)Situación de baja severidad o informativa.

4¿Se puede reintentar?

Cada código indica si tiene sentido reintentar el mismo envío sin cambiar nada (errores transitorios, de infraestructura o de disponibilidad de la autoridad tributaria) o si primero hay que corregir el documento o los datos (la mayoría de los casos).

5Credenciales inválidas o token vencido

Si el token de autenticación no se envía, es inválido o venció, el API responde HTTP 401 o HTTP 403 con el cuerpo {"message":"Forbidden"}, antes de procesar la solicitud y sin los campos del catálogo. Trátelo como ACC-002 y solicite un token nuevo en /api/login/get_token.

6Códigos que reemplaza cada concepto

Cada código global trae además los códigos originales de Costa Rica que reemplaza, con ejemplos de mensajes reales observados en producción. El código 9026 aparece en varios conceptos porque agrupa las validaciones de consistencia: el concepto concreto depende del mensaje de cada evento.

7Categorías

CódigoCategoríaCantidad de errores
ACCAcceso y Credenciales5
FIRFirma Electrónica3
INTErrores Internos4
GOVAutoridad Tributaria2
FMTFormato del Documento5
IDEIdentificación de Emisor y Receptor6
EMIDatos del Emisor4
RECDatos del Receptor3
DOCDocumento5
CTGContingencia2
FECFechas5
REFDocumento Referenciado5
ANUAnulación / Invalidación2
ITEÍtems / Detalle5
IMPImpuestos6
TOTTotales4
PAGForma de Pago3
EXPExportación3
EXTDatos Complementarios2
CATCatálogos de la Autoridad2
COMComercial / Servicio Contratado2
BUSReglas de Negocio3
DISDistribución1
PENSin Clasificar2

8Catálogo completo

ACC - Acceso y Credenciales

Autenticación, autorización y credenciales de integración con Digifact.

`ACC-001` — Acceso denegado a la operación · Severidad: HIGH · Reintentable: No

ℹ️

Acceso denegado a la operación. Casos reales observados en Costa Rica: Acceso denegado.

Códigos de Costa Rica que reemplaza: 3056

`ACC-002` — Credenciales o sesión de usuario inválidas, expiradas o bloqueadas · Severidad: MEDIUM · Reintentable: No

ℹ️

Credenciales o sesión de usuario inválidas, expiradas o bloqueadas. Casos reales observados en Costa Rica: La contraseña nueva no cumple con las reglas de complejidad; La contraseña no es correcta; El usuario ha sido bloqueado.

Códigos de Costa Rica que reemplaza: 3108, 3110, 3111

`ACC-003` — Token de autorización fiscal inválido o no obtenible · Severidad: HIGH · Reintentable: No

ℹ️

Token de autorización fiscal inválido o no obtenible. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`ACC-004` — Credencial de integración mal formada · Severidad: HIGH · Reintentable: No

ℹ️

Credencial de integración mal formada. Casos reales observados en Costa Rica: El número o tipo de parámetros es incorrecto; El dato contenido en el parámetro Requestor no es un GUID válido.

Códigos de Costa Rica que reemplaza: 3002, 3050

`ACC-005` — Credencial de integración no registrada o rechazada · Severidad: HIGH · Reintentable: No

ℹ️

Credencial de integración no registrada o rechazada. Casos reales observados en Costa Rica: Disculpe las molestias; No se encontró un Requestor solicitado.

Códigos de Costa Rica que reemplaza: 3003, 3018

9`FIR` - Firma Electrónica

Validación de la firma digital del documento.

`FIR-001` — Firma electrónica ausente o no compartida · Severidad: HIGH · Reintentable: No

ℹ️

Firma electrónica ausente o no compartida. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`FIR-002` — Firma electrónica inválida o alterada · Severidad: HIGH · Reintentable: No

ℹ️

Firma electrónica inválida o alterada. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`FIR-003` — Firma electrónica vencida · Severidad: HIGH · Reintentable: No

ℹ️

Firma electrónica vencida. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

10`INT` - Errores Internos

Fallas internas de Digifact (infraestructura, base de datos, componentes). No dependen del documento enviado; en general conviene reintentar o contactar soporte.

`INT-001` — Error interno no controlado · Severidad: CRITICAL · Reintentable: Sí

ℹ️

Error interno no controlado. Casos reales observados en Costa Rica: Ha fallado la recreación de un objeto a partir de su representación XML.

Códigos de Costa Rica que reemplaza: 400, 500, 3000

`INT-002` — Fallo de base de datos o de persistencia · Severidad: CRITICAL · Reintentable: Sí

ℹ️

Fallo de base de datos o de persistencia. Casos reales observados en Costa Rica: No fue posible ejecutar un procedimiento almacenado; No fue posible comunicarse con la base de datos; Falló la operación de la base de datos.

Códigos de Costa Rica que reemplaza: 5003, 5008, 5013, 5024

`INT-003` — Recurso, archivo o configuración no disponible · Severidad: HIGH · Reintentable: Sí

ℹ️

Recurso, archivo o configuración no disponible. Casos reales observados en Costa Rica: El objeto solicitado no se encuentra en la base de datos; El archivo no fue encontrado o no pudo ser abierto para lectura; No se ha encontrado una sección o un parámetro de la configuración.

Códigos de Costa Rica que reemplaza: 3085, 5002, 5004, 5025

`INT-004` — Componente u operación no disponible · Severidad: HIGH · Reintentable: Sí

ℹ️

Componente u operación no disponible. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 4005

11`GOV` - Autoridad Tributaria

La autoridad fiscal del país (SAT, MH, DGI, DGII, según corresponda) no respondió a tiempo o tuvo un problema de su lado.

`GOV-001` — La autoridad tributaria no respondió a tiempo · Severidad: MEDIUM · Reintentable: Sí

ℹ️

La autoridad tributaria no respondió a tiempo. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`GOV-002` — Error interno o indisponibilidad del servicio de la autoridad tributaria · Severidad: HIGH · Reintentable: Sí

ℹ️

Error interno o indisponibilidad del servicio de la autoridad tributaria. Casos reales observados en Costa Rica: En ésta oportunidad se ha rechazado el envió de la FE, con el siguiente mensaje: ...

Códigos de Costa Rica que reemplaza: 9031

12`FMT` - Formato del Documento

El documento enviado no cumple el formato, versión o esquema esperado.

`FMT-001` — XML mal formado · Severidad: HIGH · Reintentable: No

ℹ️

XML mal formado. Casos reales observados en Costa Rica: El XML está mal formado.

Códigos de Costa Rica que reemplaza: 3064

`FMT-002` — XML no cumple el esquema de la autoridad · Severidad: HIGH · Reintentable: No

ℹ️

XML no cumple el esquema de la autoridad. Casos reales observados en Costa Rica: Falló la validación de XML contra su esquema; El dato en cuestión se encuentra fuera del rango esperado.

Códigos de Costa Rica que reemplaza: 3010, 3038

`FMT-003` — JSON no cumple el esquema · Severidad: HIGH · Reintentable: No

ℹ️

JSON no cumple el esquema. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 4

`FMT-004` — Versión de formato no soportada · Severidad: HIGH · Reintentable: No

ℹ️

Versión de formato no soportada. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`FMT-005` — Prefijo de namespace no aceptado por la autoridad · Severidad: MEDIUM · Reintentable: No

ℹ️

Prefijo de namespace no aceptado por la autoridad. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

13`IDE` - Identificación de Emisor y Receptor

Validación de la identificación tributaria del emisor o receptor ante la autoridad.

`IDE-001` — Identificación del emisor no existe ante la autoridad · Severidad: HIGH · Reintentable: No

ℹ️

Identificación del emisor no existe ante la autoridad. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`IDE-002` — Identificación del emisor mal formada · Severidad: HIGH · Reintentable: No

ℹ️

Identificación del emisor mal formada. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`IDE-003` — Emisor no habilitado para la operación o el régimen · Severidad: HIGH · Reintentable: No

ℹ️

Emisor no habilitado para la operación o el régimen. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`IDE-004` — Identificación del receptor no existe ante la autoridad · Severidad: HIGH · Reintentable: No

ℹ️

Identificación del receptor no existe ante la autoridad. Casos reales observados en Costa Rica: El número de identificación del receptor no corresponde a un registro válido, Favor verificar.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`IDE-005` — Identificación del receptor mal formada · Severidad: MEDIUM · Reintentable: No

ℹ️

Identificación del receptor mal formada. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`IDE-006` — Tipo de contribuyente del receptor inconsistente · Severidad: MEDIUM · Reintentable: No

ℹ️

Tipo de contribuyente del receptor inconsistente. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

14`EMI` - Datos del Emisor

Información registral, régimen o ubicación del emisor del documento.

`EMI-001` — Datos de registro del emisor faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos de registro del emisor faltantes. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`EMI-002` — Datos de registro del emisor inválidos o no soportados · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos de registro del emisor inválidos o no soportados. Casos reales observados en Costa Rica: NumTelefono: El valor numérico no puede ser cero ni menor a ...

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`EMI-003` — Ubicación del emisor inválida o inconsistente · Severidad: MEDIUM · Reintentable: No

ℹ️

Ubicación del emisor inválida o inconsistente. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`EMI-004` — Establecimiento o punto de venta no registrado o mal formado · Severidad: HIGH · Reintentable: No

ℹ️

Establecimiento o punto de venta no registrado o mal formado. Casos reales observados en Costa Rica: Verifique que la numeración del establecimiento existe.

Códigos de Costa Rica que reemplaza: 9033

15`REC` - Datos del Receptor

Información del receptor del documento.

`REC-001` — Datos obligatorios del receptor faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos obligatorios del receptor faltantes. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`REC-002` — Datos del receptor no soportados por el tipo de documento · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos del receptor no soportados por el tipo de documento. Casos reales observados en Costa Rica: Tipo de Identificación del Receptor no permitido para este documento: El código ... (No Contribuyente) no está permitido en Tiquete Electrónico. Solo es válido en.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`REC-003` — Ubicación o país del receptor inválido · Severidad: MEDIUM · Reintentable: No

ℹ️

Ubicación o país del receptor inválido. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

16`DOC` - Documento

Tipo, numeración, duplicidad o identificadores propios del documento.

`DOC-001` — Tipo de documento no soportado · Severidad: HIGH · Reintentable: No

ℹ️

Tipo de documento no soportado. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`DOC-002` — Numeración o secuencia mal formada, no autorizada o agotada · Severidad: HIGH · Reintentable: No

ℹ️

Numeración o secuencia mal formada, no autorizada o agotada. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`DOC-003` — Documento duplicado · Severidad: HIGH · Reintentable: No

ℹ️

Documento duplicado. Casos reales observados en Costa Rica: Verifique la información.

Códigos de Costa Rica que reemplaza: 3078, 9032, 9043

`DOC-004` — Identificador único del documento o su código de verificación inválido · Severidad: HIGH · Reintentable: No

ℹ️

Identificador único del documento o su código de verificación inválido. Casos reales observados en Costa Rica: Verifique la información de la clave.

Códigos de Costa Rica que reemplaza: 9042

`DOC-005` — Modelo, tipo de transmisión o ambiente de destino inválido · Severidad: MEDIUM · Reintentable: No

ℹ️

Modelo, tipo de transmisión o ambiente de destino inválido. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

17`CTG` - Contingencia

Datos del evento de contingencia (emisión fuera de línea).

`CTG-001` — Datos de contingencia faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos de contingencia faltantes. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`CTG-002` — Datos de contingencia inválidos o fuera de rango · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos de contingencia inválidos o fuera de rango. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

18`FEC` - Fechas

Fechas de emisión del documento o de documentos relacionados.

`FEC-001` — Fecha de emisión demasiado antigua · Severidad: MEDIUM · Reintentable: No

ℹ️

Fecha de emisión demasiado antigua. Casos reales observados en Costa Rica: La casilla Fecha y hora de emisión tiene una antigüedad mayor a (valor dinámico).

Códigos de Costa Rica que reemplaza: 3022

`FEC-002` — Fecha de emisión en el futuro · Severidad: MEDIUM · Reintentable: No

ℹ️

Fecha de emisión en el futuro. Casos reales observados en Costa Rica: Se solicita una operación con una fecha que está en el futuro.

Códigos de Costa Rica que reemplaza: 3029

`FEC-003` — Fecha declarada inconsistente, mal formada o fuera de rango · Severidad: MEDIUM · Reintentable: No

ℹ️

Fecha declarada inconsistente, mal formada o fuera de rango. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`FEC-004` — Fecha del documento referenciado inválida o posterior · Severidad: MEDIUM · Reintentable: No

ℹ️

Fecha del documento referenciado inválida o posterior. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`FEC-005` — Fecha requerida por la condición de la operación faltante · Severidad: MEDIUM · Reintentable: No

ℹ️

Fecha requerida por la condición de la operación faltante. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

19`REF` - Documento Referenciado

Validación del documento al que hace referencia (ej. el documento que una nota de crédito o débito corrige).

`REF-001` — Documento referenciado no existe ante la autoridad · Severidad: HIGH · Reintentable: No

ℹ️

Documento referenciado no existe ante la autoridad. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`REF-002` — Datos del documento referenciado faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos del documento referenciado faltantes. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`REF-003` — Datos del documento referenciado inválidos o no coinciden · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos del documento referenciado inválidos o no coinciden. Casos reales observados en Costa Rica: Verifique la información fiscal; Verifique la información de referencia.

Códigos de Costa Rica que reemplaza: 9044, 9045, 9046

`REF-004` — Relación entre documento y referenciado no permitida · Severidad: HIGH · Reintentable: No

ℹ️

Relación entre documento y referenciado no permitida. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`REF-005` — Monto de la nota de crédito/débito inconsistente con el referenciado · Severidad: HIGH · Reintentable: No

ℹ️

Monto de la nota de crédito/débito inconsistente con el referenciado. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

20`ANU` - Anulación / Invalidación

Reglas para anular o invalidar un documento ya certificado.

`ANU-001` — Documento ya anulado o invalidado · Severidad: MEDIUM · Reintentable: No

ℹ️

Documento ya anulado o invalidado. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 3025

`ANU-002` — Anulación rechazada por condiciones, plazo o formato · Severidad: MEDIUM · Reintentable: No

ℹ️

Anulación rechazada por condiciones, plazo o formato. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 3098, 3129

21`ITE` - Ítems / Detalle

Datos de cada línea o ítem del documento.

`ITE-001` — Datos obligatorios del ítem faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos obligatorios del ítem faltantes. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`ITE-002` — Datos del ítem no soportados por el tipo de documento u operación · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos del ítem no soportados por el tipo de documento u operación. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`ITE-003` — Cantidad, unidad de medida o precio unitario del ítem inválido · Severidad: MEDIUM · Reintentable: No

ℹ️

Cantidad, unidad de medida o precio unitario del ítem inválido. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`ITE-004` — Total del ítem mal calculado o paginación inconsistente · Severidad: HIGH · Reintentable: No

ℹ️

Total del ítem mal calculado o paginación inconsistente. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`ITE-005` — Tipo de dato del ítem inválido (se esperaba numérico) · Severidad: MEDIUM · Reintentable: No

ℹ️

Tipo de dato del ítem inválido (se esperaba numérico). Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

22`IMP` - Impuestos

Tributos, tasas, retenciones y exoneraciones del documento.

`IMP-001` — Código de tributo o tasa inválido, repetido o no permitido · Severidad: HIGH · Reintentable: No

ℹ️

Código de tributo o tasa inválido, repetido o no permitido. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`IMP-002` — Monto de impuesto del ítem mal calculado · Severidad: HIGH · Reintentable: No

ℹ️

Monto de impuesto del ítem mal calculado. Casos reales observados en Costa Rica: Linea [n] Monto: En caso de utilizar el campo "Baseimponible", este campo se obtiene de la multiplicación "Baseimponible" por la tarifa.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`IMP-003` — Impuestos no permitidos para el tipo de operación · Severidad: MEDIUM · Reintentable: No

ℹ️

Impuestos no permitidos para el tipo de operación. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`IMP-004` — Impuesto específico o adicional inválido · Severidad: MEDIUM · Reintentable: No

ℹ️

Impuesto específico o adicional inválido. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`IMP-005` — Retención o percepción inválida o inconsistente · Severidad: MEDIUM · Reintentable: No

ℹ️

Retención o percepción inválida o inconsistente. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`IMP-006` — Documento o dato de exoneración fiscal faltante o inválido · Severidad: MEDIUM · Reintentable: No

ℹ️

Documento o dato de exoneración fiscal faltante o inválido. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

23`TOT` - Totales

Consistencia entre el detalle del documento y sus totales.

`TOT-001` — Total del documento no coincide con la suma del detalle · Severidad: HIGH · Reintentable: No

ℹ️

Total del documento no coincide con la suma del detalle. Casos reales observados en Costa Rica: Total Mercancias Gravadas: Total invalido; Total Servicios Gravados: Total invalido; Total Mercancias Exentas: Total invalido. Hay 7 variantes adicionales registradas.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`TOT-002` — Descuentos o recargos inconsistentes · Severidad: MEDIUM · Reintentable: No

ℹ️

Descuentos o recargos inconsistentes. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`TOT-003` — Totales obligatorios faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Totales obligatorios faltantes. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`TOT-004` — Totales no soportados por el tipo de documento, negativos o fuera de rango · Severidad: MEDIUM · Reintentable: No

ℹ️

Totales no soportados por el tipo de documento, negativos o fuera de rango. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

24`PAG` - Forma de Pago

Condiciones y medios de pago declarados.

`PAG-001` — Forma de pago faltante o incompleta · Severidad: MEDIUM · Reintentable: No

ℹ️

Forma de pago faltante o incompleta. Casos reales observados en Costa Rica: MedioPago: El Tipo Medio Pago OTRO es obligatorio cuando se utilice el Tipo de Medio Pago ...

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`PAG-002` — Forma de pago inválida o no soportada · Severidad: MEDIUM · Reintentable: No

ℹ️

Forma de pago inválida o no soportada. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 9026 (consistencia)

`PAG-003` — Condición de la operación o montos de pago inconsistentes · Severidad: MEDIUM · Reintentable: No

ℹ️

Condición de la operación o montos de pago inconsistentes. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

25`EXP` - Exportación

Datos específicos de operaciones de exportación.

`EXP-001` — Datos de exportación faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos de exportación faltantes. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`EXP-002` — Datos de exportación inválidos o no soportados · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos de exportación inválidos o no soportados. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`EXP-003` — Destino de la operación inconsistente con el tipo de documento · Severidad: HIGH · Reintentable: No

ℹ️

Destino de la operación inconsistente con el tipo de documento. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

26`EXT` - Datos Complementarios

Información adicional requerida por el tipo de operación.

`EXT-001` — Datos complementarios requeridos por el tipo de operación, faltantes · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos complementarios requeridos por el tipo de operación, faltantes. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`EXT-002` — Datos complementarios no soportados por el tipo de documento u operación · Severidad: MEDIUM · Reintentable: No

ℹ️

Datos complementarios no soportados por el tipo de documento u operación. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

27`CAT` - Catálogos de la Autoridad

Códigos que deben existir en los catálogos oficiales de la autoridad tributaria (ej. actividad económica).

`CAT-001` — Código no existe en el catálogo de la autoridad · Severidad: MEDIUM · Reintentable: No

ℹ️

Código no existe en el catálogo de la autoridad. Casos reales observados en Costa Rica: Por favor verifique la codificación utilizada para el producto o servicio facturado.

Códigos de Costa Rica que reemplaza: 9047

`CAT-002` — Actividad económica inválida o mal formada · Severidad: MEDIUM · Reintentable: No

ℹ️

Actividad económica inválida o mal formada. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

28`COM` - Comercial / Servicio Contratado

Estado de la cuota o afiliación contratada con el proveedor autorizado.

`COM-001` — Cuota contratada agotada o vencida · Severidad: HIGH · Reintentable: No

ℹ️

Cuota contratada agotada o vencida. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 3097

`COM-002` — Emisor no afiliado o no habilitado con el proveedor autorizado · Severidad: HIGH · Reintentable: No

ℹ️

Emisor no afiliado o no habilitado con el proveedor autorizado. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

29`BUS` - Reglas de Negocio

Reglas específicas del régimen fiscal o cláusulas legales requeridas.

`BUS-001` — Regla específica del régimen fiscal no cumplida · Severidad: MEDIUM · Reintentable: No

ℹ️

Regla específica del régimen fiscal no cumplida. Sin casos observados en Costa Rica todavía; aplica a los códigos listados.

Códigos de Costa Rica que reemplaza: 3016

`BUS-002` — Frases o cláusulas legales requeridas, ausentes o no permitidas · Severidad: MEDIUM · Reintentable: No

ℹ️

Frases o cláusulas legales requeridas, ausentes o no permitidas. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`BUS-003` — Referencia interna ya enviada a certificar · Severidad: MEDIUM · Reintentable: No

ℹ️

Referencia interna ya enviada a certificar. Casos reales observados en Costa Rica: La referencia INTERNA, ya ha sido enviada a certificar.

Códigos de Costa Rica que reemplaza: 9022

30`DIS` - Distribución

El documento se certificó, pero falló su envío posterior (por ejemplo, por correo).

`DIS-001` — Documento certificado, pero falló su envío o distribución · Severidad: HIGH · Reintentable: No

ℹ️

Documento certificado, pero falló su envío o distribución. Casos reales observados en Costa Rica: Por lo menos uno de los métodos de distribución solicitados falló.

Códigos de Costa Rica que reemplaza: 3060

31`PEN` - Sin Clasificar

Error que todavía no tiene asignada una clasificación global.

`PEN-001` — Código de error ausente o no reconocido · Severidad: LOW · Reintentable: No

ℹ️

Código de error ausente o no reconocido. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_

`PEN-002` — Validación fiscal específica de un país, pendiente de que la autoridad tributaria correspondiente defina su clasificación · Severidad: LOW · Reintentable: No

ℹ️

Validación fiscal específica de un país, pendiente de que la autoridad tributaria correspondiente defina su clasificación. Sin casos de Costa Rica registrados todavía en el catálogo.

Códigos de Costa Rica que reemplaza: _sin casos de CR registrados_