Clave de acceso del SRI explicada: los 49 dígitos, el dígito verificador módulo 11 y las causas comunes de rechazo (Ecuador)
Por Zain Abbas, Kodenova · Actualizado el
Cada comprobante electrónico en Ecuador lleva una clave de acceso: un número de 49 dígitos que genera el emisor, no el SRI. Si está mal, el documento se rechaza o no aparece cuando consulta su autorización. Esta guía recorre cada dígito, el dígito verificador módulo 11 y las causas de rechazo que más vemos en proyectos con SAP Business One.
Mientras lee, puede generar o revisar una clave en nuestro generador y validador gratuito de clave de acceso del SRI.
Los 49 dígitos, campo por campo
La estructura viene de la Ficha técnica de comprobantes electrónicos, esquema offline del SRI (versión 2.26, marzo de 2024). La clave va en la etiqueta <claveAcceso> del XML.
| Posición | Campo | Longitud | Notas |
|---|---|---|---|
| 1–8 | Fecha de emisión | 8 | Formato ddmmaaaa |
| 9–10 | Tipo de comprobante | 2 | Vea la tabla siguiente |
| 11–23 | RUC del emisor | 13 | RUC del emisor |
| 24 | Tipo de ambiente | 1 | 1 = pruebas, 2 = producción |
| 25–30 | Serie | 6 | Establecimiento (3) + punto de emisión (3), por ejemplo 001001 |
| 31–39 | Secuencial | 9 | Completado con ceros a la izquierda |
| 40–47 | Código numérico | 8 | Lo elige el emisor |
| 48 | Tipo de emisión | 1 | 1 = emisión normal |
| 49 | Dígito verificador | 1 | Módulo 11 |
Códigos de tipo de comprobante
| Código | Documento |
|---|---|
| 01 | Factura |
| 03 | Liquidación de compra de bienes y prestación de servicios |
| 04 | Nota de crédito |
| 05 | Nota de débito |
| 06 | Guía de remisión |
| 07 | Comprobante de retención |
Algunos detalles importan más de lo que parece:
- Serie. La ficha muestra la serie como un solo campo de 6 dígitos. El XML lleva el establecimiento y el punto de emisión como dos códigos separados de 3 dígitos, así que deben coincidir con la clave.
- Secuencial. Debe tener 9 dígitos. Un secuencial más corto produce una clave mal formada y un rechazo.
- Código numérico. El SRI lo llama un mecanismo de seguridad y deja el algoritmo totalmente en manos del emisor. Aleatorio o derivado, la decisión es suya, pero debe tener 8 dígitos.
- Tipo de emisión. En el esquema offline solo existe el
1. Las claves de contingencia se eliminaron en la versión 2.0 de la ficha.
El dígito verificador módulo 11
El dígito 49 se calcula sobre los primeros 48 dígitos con módulo 11 y pesos del 2 al 7.
- Tome los 48 dígitos.
- Empezando por la derecha, multiplique cada dígito por 2, 3, 4, 5, 6, 7, y luego vuelva a empezar en 2.
- Sume todos los productos.
- Divida la suma entre 11 y quédese con el residuo.
- Reste el residuo de 11.
- Si el resultado es 11, el dígito es 0. Si es 10, el dígito es 1. En cualquier otro caso, use el resultado.
Mini ejemplo resuelto
La ficha del SRI usa la cadena 41261533:
| Dígito | 4 | 1 | 2 | 6 | 1 | 5 | 3 | 3 |
|---|---|---|---|---|---|---|---|---|
| Peso | 3 | 2 | 7 | 6 | 5 | 4 | 3 | 2 |
| Producto | 12 | 2 | 14 | 36 | 5 | 20 | 9 | 6 |
Suma = 104. 104 mod 11 = 5. 11 − 5 = 6. El dígito verificador es 6.
Una clave completa
Tome una factura (01) emitida el 16 de octubre de 2026 en producción (2), del establecimiento 001, punto de emisión 001, secuencial 123, código numérico 12345678, para el RUC ficticio 1790012345001:
16102026 01 1790012345001 2 001001 000000123 12345678 1Con los pesos, los 48 dígitos suman 468. 468 mod 11 = 6, y 11 − 6 = 5. La clave de acceso completa es:
1610202601179001234500120010010000001231234567815Péguela en la herramienta de clave de acceso para ver cada campo por separado.
Cómo usa la clave el esquema offline
En el esquema offline, el emisor hace la mayor parte del trabajo:
- Generar el XML según el XSD del SRI para el tipo de documento.
- Generar la clave de acceso de 49 dígitos.
- Firmar el XML con XAdES-BES, usando el certificado .p12 de su firma electrónica.
- Enviarlo al web service de recepción. La respuesta es RECIBIDA o DEVUELTA.
- Esperar y luego consultar el web service de autorización con la clave de acceso.
- Entregar el comprobante (XML y RIDE) al comprador.
Dos puntos vienen directamente de la ficha. Primero, la clave de acceso se convierte en el número de autorización. Segundo, el SRI indica que procesar un comprobante puede tardar hasta 24 horas, así que su sistema debe manejar un estado pendiente en lugar de suponer una respuesta inmediata.
El ambiente de pruebas (celcer.sri.gob.ec) y el de producción (cel.sri.gob.ec) tienen endpoints separados. El dígito de ambiente de la clave debe coincidir con el ambiente al que envía.
Causas comunes de rechazo
Estos son los mensajes y situaciones del SRI que encontramos con más frecuencia. Los códigos son de la sección 10 de la ficha técnica.
| Problema | Mensaje del SRI | Causa habitual |
|---|---|---|
| Clave duplicada | 43 “Clave acceso registrada” | La misma clave enviada dos veces, a menudo después de un timeout y un reenvío manual desde un segundo documento |
| Secuencial repetido | 45 “Secuencial registrado” | Dos documentos de SAP B1 asignados a la misma serie y secuencial |
| La clave no coincide con el XML | 58 “Error en la estructura de clave acceso” | La fecha, el RUC, la serie o el secuencial de la clave difieren del XML |
| Clave aún en procesamiento | 70 “Clave de acceso en procesamiento” | Un reenvío mientras el SRI todavía está procesando. No genere una clave ni un secuencial nuevos; espere hasta 24 horas |
| Firma electrónica | 39 “Firma inválida”, 40 “Error en el certificado”, 42 “Certificado revocado” | .p12 equivocado, contraseña incorrecta o un certificado vencido que no se renovó |
| Documento tardío | 65 “Fecha de emisión extemporánea” | Documentos retenidos en una cola y enviados demasiado tarde |
| Identificación del comprador | Advertencias 59 “Identificación no existe”, 62 “Identificación incorrecta” | Una cédula o RUC con dígito verificador incorrecto, o el tipo de identificación equivocado |
Algunas notas sobre los que más tiempo cuestan:
- Clave duplicada. La mayoría de los duplicados vienen de la lógica de reintentos, no de la fórmula. Después de un timeout, consulte primero la autorización con la misma clave.
- RUC o cédula del comprador. Los códigos de tipo de identificación son 04 RUC, 05 cédula, 06 pasaporte, 07 consumidor final (13 nueves) y 08 identificación del exterior. Consumidor final no se permite en liquidaciones de compra, y las notas de crédito, notas de débito y retenciones siempre necesitan un receptor válido. Revise los números antes de que lleguen a SAP B1 con nuestro validador de cédula y RUC de Ecuador.
- Saltos en el secuencial. La ficha pide a los emisores emitir en orden cronológico y secuencial, sin secuenciales ni claves duplicados. Los saltos suelen aparecer cuando un documento se cancela en SAP B1 después de haber tomado el número, o cuando dos usuarios contabilizan al mismo tiempo. Después son difíciles de explicar, así que mantenga el contador en un solo lugar.
- Firma electrónica vencida. Los certificados vencen en una fecha fija. Anote esa fecha en un calendario y renueve antes, porque todos los documentos fallan hasta que se carga el nuevo .p12.
Cómo genera SAP Business One la clave de acceso
En la mayoría de las configuraciones, SAP B1 no trae de fábrica un campo llamado clave de acceso. Una integración la genera. En nuestros proyectos SRI el patrón es este:
- Asignar las series de numeración a la serie. Cada serie de documentos de SAP B1 se vincula a un establecimiento y un punto de emisión.
- Mantener un secuencial aparte. No dependemos solo del DocNum. Un contador dedicado por serie y tipo de comprobante evita colisiones entre usuarios y empresas.
- Generar la clave al contabilizar. La fecha viene de la fecha del documento, el RUC de los datos de la empresa y el ambiente de una configuración que es distinta entre las bases de datos de pruebas y de producción.
- Guardarla en el documento. La clave, el estado y la fecha de autorización se guardan en campos definidos por el usuario de la factura de clientes, la nota de crédito, la entrega o la factura de proveedores que lleva una retención, para que los usuarios los vean sin salir de SAP B1.
- Imprimirla en el RIDE. El formato de Crystal Reports muestra la clave de acceso y su código de barras.
- Manejar los estados pendiente y rechazado. Una pantalla de monitoreo lista los documentos RECIBIDA, DEVUELTA o no autorizados, con el mensaje del SRI, para que alguien los corrija el mismo día.
La fórmula es sencilla. Lo difícil es no reutilizar nunca un secuencial y reenviar siempre con la clave original. Para el alcance completo de la integración, vea nuestra página de facturación electrónica SRI Ecuador.
Kodenova ha entregado integraciones SRI para SAP Business One. Si sus documentos están siendo rechazados o está iniciando una nueva implementación, contáctenos con su versión de SAP B1 y los tipos de documento que emite.
Fuentes
- SRI: Ficha técnica comprobantes electrónicos esquema offline, versión 2.26 (marzo 2024)
- SRI: Facturación electrónica
Servicios relacionados
Preguntas frecuentes
¿Cuántos dígitos tiene la clave de acceso del SRI?
49. Cuarenta y ocho dígitos vienen de los datos del documento (fecha, tipo de comprobante, RUC, ambiente, serie, secuencial, código numérico y tipo de emisión) y el último dígito es el dígito verificador módulo 11.
¿Cómo se calcula el dígito verificador?
Multiplique los primeros 48 dígitos, de derecha a izquierda, por los pesos 2, 3, 4, 5, 6, 7, repitiendo la serie. Sume los productos, obtenga el residuo de dividir entre 11 y réstelo de 11. Un resultado de 11 se convierte en 0 y un resultado de 10 se convierte en 1.
¿La clave de acceso es lo mismo que el número de autorización?
Sí, en el esquema offline. La ficha técnica del SRI indica que la clave de acceso generada por el emisor se convierte en el número de autorización del comprobante.
¿Puedo reenviar un comprobante rechazado con una clave de acceso nueva?
Si el SRI rechaza un comprobante, la ficha técnica indica corregirlo y reenviarlo con la misma clave de acceso y el mismo secuencial. Si recibe el error 70 (clave de acceso en procesamiento), no reenvíe ni genere una clave nueva; espere la respuesta, que puede tardar hasta 24 horas.
¿Existe una clave de contingencia en el esquema offline?
No. Las claves de contingencia se eliminaron en la versión 2.0 de la ficha técnica offline, y solo existe el tipo de emisión 1 (emisión normal).
¿Listo para empezar?
Cuéntenos lo que necesita. Recibirá una respuesta técnica clara, un alcance definido y un precio fijo, normalmente en 24 horas.
