Volver al blog
facturacion-electronicacedula-juridicacedula-juridica-alfanumericahaciendacosta-ricaintegracioneserp

Cédula jurídica con letras: Hacienda está lista, ¿y tu ERP?

Andrés Ramírez4 de noviembre de 20268 min de lectura

El Registro Nacional va a emitir cédulas jurídicas con letras cuando se agote el consecutivo numérico. Hacienda, en la estructura v4.4, ya acepta esas letras en el número de identificación y en la clave de 50 posiciones del comprobante. El riesgo no está en el XSD oficial: está en tu ERP y en las integraciones que todavía arman la clave como si fuera solo dígitos, limpian letras o validan contra una copia vieja del esquema.

Imaginá la primera factura

Imaginá la primera factura de una sociedad inscrita con el formato nuevo. La cédula entra en el formulario, el cliente queda registrado, el documento se genera. Unos días después, el sistema de cuentas por pagar del receptor rechaza el archivo. No era el proveedor del ERP, ni la firma, ni el monto. Era que el comprobante llevaba, dentro de su identificador de cincuenta posiciones, una cédula con una letra.

Esa letra no tiene por qué romper en Hacienda. Puede romper un paso antes: en el código que arma la clave, en la columna donde se guarda la cédula, o en la validación local que todavía cree que la clave es solo numérica.

¿Qué cambia con la cédula jurídica alfanumérica?

El Decreto Ejecutivo N.º 44648-MJP, Reglamento del Registro de Personas Jurídicas, fija en el artículo 137 que la cédula tiene diez caracteres: tipo, tres dígitos de clase y seis caracteres alfanuméricos de consecutivo.

El formato conserva el largo. Cambia el consecutivo: donde antes salía un número como 3-101-981657, puede salir uno como 3-101-A00001.

Las sociedades que ya tienen cédula numérica la conservan. No hay trámite de canje. El formato nuevo aplica a personas jurídicas nuevas (y a quienes pidan asignación después de la fecha que fije el Registro).

¿Cuándo empieza: 1 de noviembre de 2026 o después?

Son dos calendarios distintos. No los mezcles.

El comunicado oficial de la Dirección General del Registro Nacional prevé implementar el cambio al inicio del cuarto trimestre de 2026. La fecha exacta se comunicará con al menos dos meses de antelación. La circular MH-DGA-CIR-0005-2026 del Ministerio de Hacienda recoge ese aviso para el Servicio Nacional de Aduanas y el público en general.

El 1 de noviembre de 2026 es otra cosa: es la fecha a partir de la cual Hacienda hace obligatorios ajustes de la versión 4.4 de comprobantes electrónicos (códigos de referencia nuevos y tipos de documento referenciado, entre otros), según el comunicado de actualización de Anexos y Estructuras. No es la fecha de arranque de la cédula alfanumérica.

Mientras el Registro no publique el día concreto, no hay cédulas nuevas con letra en circulación. Sí hay tiempo, y sí hay sistemas que todavía no están listos para cuando lleguen.

¿Hacienda ya acepta letras en la identificación y en la clave?

Sí. En ambos campos.

Los Anexos y Estructuras v4.4 (bitácora del 22 de abril de 2026) aclaran que se permiten caracteres alfanuméricos para personas jurídicas. El campo Clave queda descrito como fijo de cincuenta posiciones y permite ingresar números y letras para personas jurídicas. La cédula jurídica del emisor o receptor debe contener 10 caracteres, sin guiones. Para armar la clave, la Nota 4.1 pide rellenar la cédula jurídica con dos ceros al inicio hasta completar 12 caracteres (posiciones 10 a 21 de la clave).

El XSD oficial lo confirma. En FacturaElectronica_V4.4.xsd (Last-Modified del 22 de abril de 2026) el tipo ClaveType usa el patrón [a-zA-Z0-9]{50,50}: exactamente cincuenta caracteres, letras o dígitos. El número de identificación (Identificacion/Numero) admite hasta 20 caracteres, sin patrón de solo dígitos. El consecutivo del comprobante sigue siendo solo numérico: \d{20,20}.

Ojo con las copias. Espejos desactualizados (hay copias públicas fechadas en 2025) todavía muestran \d{50,50} en la clave. Si tu sistema valida contra esa copia, va a rechazar lo que el XSD de hacienda.go.cr/docs ya acepta. La documentación interna del XSD todavía dice en un comentario que ClaveType “solo permite el uso de números”; manda el pattern, no el texto viejo.

¿A qué empresas afecta: a la que cobra o a la que paga?

A las dos, por caminos distintos.

Tu sociedad, si ya está inscrita, no recibe cédula nueva. Lo que empieza a llegar son facturas de proveedores recién inscritos, algunas con cédula alfanumérica. El que emite puede armar mal la clave. El que recibe puede rechazar un archivo válido, o aceptar uno con la letra borrada.

El sistema que valida del lado del receptor es tuyo: el tramo entre tu ERP y Hacienda, el que parsea el XML, guarda la cédula, arma o verifica la clave y procesa respuestas. La regla que todavía asume solo dígitos la escribió alguien de tu lado hace años, cuando era correcta.

El riesgo de negocio es concreto. Factura rechazada es cobro atrasado. Cédula borrada en silencio es un documento que “pasa” con un identificador que no corresponde: un gasto o un crédito que puede no sostenerse ante Hacienda.

¿Dónde se rompe el ERP o la integración?

Hay cinco puntos donde la cédula viaja, y en todos se puede quedar atascada:

  1. La captura. Si el formulario restringe el teclado a números, la letra no se puede escribir.
  2. La columna de la base de datos. Si el campo es numérico, la letra no cabe. Eso duele más cuando ya hay datos.
  3. La función que arma la clave. Rellena a 12 caracteres (dos ceros delante en jurídica) y los pone en las posiciones 10 a 21. Si limpia todo lo que no sea dígito, la letra desaparece y el documento queda con otra cédula.
  4. El esquema contra el que se valida. Una copia local con \d{50} rechaza claves válidas según el XSD oficial.
  5. La recepción de facturas de proveedores. Suele estar escrita por otra persona, en otro momento, y es la primera que va a ver una letra en producción.

Ninguno de esos cinco se arregla solo con una actualización del proveedor del ERP. Están de tu lado. Es el mismo patrón que SAP ECC 2027 está destapando en las integraciones de la región.

La pregunta que los cubre es una sola, y se contesta mirando el código: qué hace hoy la función que arma (o valida) la clave cuando le llega un carácter que no es dígito. Si lo borra, si lo rechaza, o si valida contra un XSD que no es el de hacienda.go.cr/docs, hay trabajo. Si no lo saben, también.

¿Qué hace hoy el código público con una cédula con letra?

Revisamos el código publicado de cuatro implementaciones costarricenses de acceso público, al 4 de noviembre de 2026, y probamos la función que arma la clave con una cédula que lleva una letra. No es un censo del mercado: las herramientas comerciales no están incluidas. El comportamiento puede cambiar después de esa fecha. Como el Registro todavía no emite cédulas con letras, esto no afirma que alguien haya emitido un comprobante inválido en producción.

ImplementaciónQué hace con una cédula con letra
Librería ALa deja y la mete en la clave (alineado al XSD oficial actual)
Librería BDevuelve un error de texto; la cédula no forma la clave
Librería CBorra la letra en silencio y arma la clave igual
Librería DAcepta la letra y valida contra su propia copia del esquema

La que borra la letra es la que hay que buscar primero: produce un documento bien formado con un identificador que no corresponde. La que rechaza con mensaje va a bloquear cobros legítimos cuando lleguen cédulas nuevas. La que mete la letra en la clave encaja con el patrón oficial de hoy; el riesgo ahí es otro (captura, base de datos, recepción). La que trae copia propia del XSD puede estar alineada hoy y desfasada mañana: el punto no es el nombre del repo, es de dónde sale la regla que estás usando.

Una de estas implementaciones documentó el problema en su propia lista de casos antes de corregirlo. Lo que importa para tu empresa no es cuál librería usás: es qué hace tu función con un carácter que no es dígito. Y si esa función está copiada en cada conexión, el arreglo se multiplica: es el costo de mantener integraciones point-to-point.

Referencia rápida: qué pide Hacienda hoy

CampoQué exige el esquema / anexo vigente
Número de identificaciónTexto de hasta 20 posiciones; jurídica: 10 caracteres sin guiones
Clave50 posiciones, letras y números ([a-zA-Z0-9]{50})
Consecutivo20 posiciones, solo dígitos (\d{20})
Segmento de cédula en la clavePosiciones 10 a 21; jurídica con dos ceros de relleno (12 caracteres)

Preguntas frecuentes

¿Mi empresa tiene que cambiar de cédula?
No. Las cédulas ya asignadas siguen activas. El formato alfanumérico aplica a asignaciones nuevas después de la fecha que comunique el Registro.

¿El 1 de noviembre de 2026 es el día de la cédula con letras?
No. Esa fecha es de obligatoriedad de ajustes de la factura electrónica v4.4. El Registro prevé el cambio de cédula en el cuarto trimestre de 2026 y avisará con al menos dos meses de anticipación.

¿La clave del comprobante sigue siendo solo numérica?
No. El XSD v4.4 publicado en hacienda.go.cr/docs acepta letras y números en las 50 posiciones. El consecutivo del comprobante sí sigue siendo solo numérico (20 dígitos).

¿Qué es lo primero que debería revisar mi equipo?
La función que arma o valida la clave cuando recibe un carácter no numérico, la columna donde se guarda la cédula, y si la validación XSD apunta al archivo oficial o a una copia local.

Si tu facturación depende de un servicio de terceros, sumá también las dependencias ocultas que aparecen cuando se cae un SaaS.

En una Auditoría Express de 5 días, desde US$3.000, revisamos con tu equipo el código del tramo entre tu ERP y Hacienda: captura, base de datos, la función que arma la clave y la recepción de facturas de proveedores. Escribinos por WhatsApp.