SRI-Clave-de-acceso erklärt: die 49 Ziffern, die Prüfziffer nach Modulo 11 und typische Ablehnungsgründe (Ecuador)
Von Zain Abbas, Kodenova · Aktualisiert am
Jeder elektronische Beleg (comprobante electrónico) in Ecuador trägt eine Clave de acceso: eine 49-stellige Nummer, die der Aussteller bildet, nicht der SRI. Ist sie falsch, wird der Beleg abgelehnt oder bei der Abfrage seiner Autorisierung nicht gefunden. Dieser Leitfaden geht jede Ziffer durch, erklärt die Prüfziffer nach Modulo 11 und die Ablehnungsgründe, denen wir in SAP-Business-One-Projekten am häufigsten begegnen.
Während Sie lesen, können Sie einen Schlüssel in unserem kostenlosen Generator und Validator für die SRI-Clave-de-acceso erzeugen oder prüfen.
Die 49 Ziffern, Feld für Feld
Die Struktur stammt aus der Ficha técnica de comprobantes electrónicos, esquema offline des SRI (Version 2.26, März 2024). Der Schlüssel steht im XML im Tag <claveAcceso>.
| Position | Feld | Länge | Hinweise |
|---|---|---|---|
| 1–8 | Fecha de emisión (Ausstellungsdatum) | 8 | Format ddmmaaaa (TTMMJJJJ) |
| 9–10 | Tipo de comprobante (Belegart) | 2 | Siehe Tabelle unten |
| 11–23 | RUC del emisor | 13 | RUC des Ausstellers |
| 24 | Tipo de ambiente (Umgebung) | 1 | 1 = pruebas (Test), 2 = producción (Produktiv) |
| 25–30 | Serie | 6 | Establecimiento (3) + punto de emisión (3), zum Beispiel 001001 |
| 31–39 | Secuencial (laufende Nummer) | 9 | Links mit Nullen aufgefüllt |
| 40–47 | Código numérico | 8 | Vom Aussteller gewählt |
| 48 | Tipo de emisión (Ausstellungsart) | 1 | 1 = emisión normal |
| 49 | Dígito verificador (Prüfziffer) | 1 | Modulo 11 |
Codes für den tipo de comprobante
| Code | Beleg |
|---|---|
| 01 | Factura (Rechnung) |
| 03 | Liquidación de compra de bienes y prestación de servicios (Einkaufsabrechnung) |
| 04 | Nota de crédito (Gutschrift) |
| 05 | Nota de débito (Belastungsanzeige) |
| 06 | Guía de remisión (Lieferschein) |
| 07 | Comprobante de retención (Quellensteuerbeleg) |
Einige Details sind wichtiger, als sie aussehen:
- Serie. Die ficha zeigt die Serie als ein 6-stelliges Feld. Im XML stehen establecimiento und punto de emisión als zwei getrennte 3-stellige Codes, und beide müssen zum Schlüssel passen.
- Secuencial. Er muss 9 Ziffern haben. Ein zu kurzer secuencial ergibt einen fehlerhaften Schlüssel und eine Ablehnung.
- Código numérico. Der SRI bezeichnet ihn als Sicherheitsmechanismus und überlässt den Algorithmus vollständig dem Aussteller. Zufällig oder abgeleitet – das entscheiden Sie, aber er muss 8 Ziffern haben.
- Tipo de emisión. Im Offline-Verfahren gibt es nur
1. Notfallschlüssel wurden mit Version 2.0 der ficha abgeschafft.
Die Prüfziffer nach Modulo 11
Die 49. Ziffer wird über die ersten 48 Ziffern nach Modulo 11 mit den Gewichten 2 bis 7 berechnet.
- Nehmen Sie die 48 Ziffern.
- Multiplizieren Sie von rechts beginnend jede Ziffer mit 2, 3, 4, 5, 6, 7 und beginnen Sie dann wieder bei 2.
- Addieren Sie alle Produkte.
- Teilen Sie die Summe durch 11 und behalten Sie den Rest.
- Ziehen Sie den Rest von 11 ab.
- Ist das Ergebnis 11, lautet die Ziffer 0. Ist es 10, lautet sie 1. Andernfalls verwenden Sie das Ergebnis.
Kleines Rechenbeispiel
Die ficha des SRI verwendet die Zeichenfolge 41261533:
| Ziffer | 4 | 1 | 2 | 6 | 1 | 5 | 3 | 3 |
|---|---|---|---|---|---|---|---|---|
| Gewicht | 3 | 2 | 7 | 6 | 5 | 4 | 3 | 2 |
| Produkt | 12 | 2 | 14 | 36 | 5 | 20 | 9 | 6 |
Summe = 104. 104 mod 11 = 5. 11 − 5 = 6. Die Prüfziffer ist 6.
Ein vollständiger Schlüssel
Nehmen wir eine Rechnung (01), ausgestellt am 16. Oktober 2026 in der Produktivumgebung (2), aus establecimiento 001, punto de emisión 001, secuencial 123, código numérico 12345678, für den fiktiven RUC 1790012345001:
16102026 01 1790012345001 2 001001 000000123 12345678 1Die gewichteten 48 Ziffern ergeben die Summe 468. 468 mod 11 = 6, und 11 − 6 = 5. Die vollständige Clave de acceso lautet:
1610202601179001234500120010010000001231234567815Fügen Sie sie in das Clave-de-acceso-Tool ein, um jedes Feld einzeln zu sehen.
Wie das Offline-Verfahren den Schlüssel nutzt
Im esquema offline erledigt der Aussteller den Großteil der Arbeit:
- Erzeugen Sie das XML nach der XSD des SRI für die jeweilige Belegart.
- Erzeugen Sie die 49-stellige Clave de acceso.
- Signieren Sie das XML mit XAdES-BES und dem .p12-Zertifikat Ihrer firma electrónica (elektronische Signatur).
- Senden Sie es an den Webservice recepción (Empfang). Die Antwort lautet RECIBIDA oder DEVUELTA.
- Warten Sie und fragen Sie dann den Webservice autorización mit der Clave de acceso ab.
- Übergeben Sie den Beleg (XML und RIDE) an den Käufer.
Zwei Punkte stammen direkt aus der ficha. Erstens wird die Clave de acceso zur número de autorización. Zweitens kann die Verarbeitung eines Belegs laut SRI bis zu 24 Stunden dauern; Ihr System muss also einen Schwebezustand abbilden, statt von einer sofortigen Antwort auszugehen.
Testumgebung (celcer.sri.gob.ec) und Produktivumgebung (cel.sri.gob.ec) haben getrennte Endpunkte. Die Ziffer für die Umgebung im Schlüssel muss zu dem Endpunkt passen, an den Sie senden.
Häufige Ablehnungsgründe
Diese Meldungen und Situationen des SRI begegnen uns am häufigsten. Die Codes stammen aus Abschnitt 10 der ficha técnica.
| Problem | Meldung des SRI | Übliche Ursache |
|---|---|---|
| Doppelter Schlüssel | 43 “Clave acceso registrada” | Derselbe Schlüssel wurde zweimal gesendet, oft nach einem Timeout und einem manuellen erneuten Senden aus einem zweiten Beleg |
| Secuencial wiederholt | 45 “Secuencial registrado” | Zwei SAP-B1-Belege wurden derselben Serie und demselben secuencial zugeordnet |
| Schlüssel passt nicht zum XML | 58 “Error en la estructura de clave acceso” | Datum, RUC, Serie oder secuencial im Schlüssel weichen vom XML ab |
| Schlüssel noch in Bearbeitung | 70 “Clave de acceso en procesamiento” | Erneutes Senden, während der SRI noch verarbeitet. Erzeugen Sie keinen neuen Schlüssel oder secuencial; warten Sie bis zu 24 Stunden |
| Firma electrónica | 39 “Firma inválida”, 40 “Error en el certificado”, 42 “Certificado revocado” | Falsche .p12-Datei, falsches Passwort oder ein abgelaufenes, nicht erneuertes Zertifikat |
| Verspäteter Beleg | 65 “Fecha de emisión extemporánea” | Belege, die in einer Warteschlange lagen und zu spät gesendet wurden |
| Identifikation des Käufers | Warnungen 59 “Identificación no existe”, 62 “Identificación incorrecta” | Eine cédula oder ein RUC mit falscher Prüfziffer oder der falsche tipo de identificación |
Einige Hinweise zu den Fällen, die am meisten Zeit kosten:
- Doppelter Schlüssel. Die meisten Dubletten entstehen durch die Wiederholungslogik, nicht durch die Formel. Fragen Sie nach einem Timeout zuerst autorización mit demselben Schlüssel ab.
- RUC oder cédula des Käufers. Die Codes für den tipo de identificación sind 04 RUC, 05 cédula, 06 pasaporte, 07 consumidor final (13 Neunen) und 08 identificación del exterior. Consumidor final (Endverbraucher) ist auf liquidaciones de compra nicht zulässig, und notas de crédito, notas de débito und retenciones brauchen immer einen gültigen Empfänger. Prüfen Sie Nummern, bevor sie in SAP B1 landen, mit unserem Validator für cédula und RUC aus Ecuador.
- Lücken im secuencial. Die ficha verlangt, dass Aussteller chronologisch und fortlaufend ausstellen, ohne doppelte secuenciales oder Schlüssel. Lücken entstehen meist, wenn ein Beleg in SAP B1 storniert wird, nachdem die Nummer bereits vergeben war, oder wenn zwei Benutzer gleichzeitig buchen. Sie lassen sich später schwer erklären, führen Sie den Zähler also an genau einer Stelle.
- Abgelaufene firma electrónica. Zertifikate laufen an einem festen Datum ab. Tragen Sie dieses Datum in einen Kalender ein und erneuern Sie rechtzeitig, denn bis die neue .p12-Datei geladen ist, scheitert jeder Beleg.
Wie SAP Business One die Clave de acceso erzeugt
In den meisten Installationen hat SAP B1 standardmäßig kein Feld namens Clave de acceso. Eine Integration baut den Schlüssel. In unseren SRI-Projekten sieht das Muster so aus:
- Nummernkreise der Serie zuordnen. Jeder Belegnummernkreis in SAP B1 ist mit genau einem establecimiento und punto de emisión verknüpft.
- Einen eigenen secuencial führen. Wir verlassen uns nicht allein auf die DocNum. Ein eigener Zähler pro Serie und tipo de comprobante verhindert Kollisionen zwischen Benutzern und Mandanten.
- Den Schlüssel beim Buchen bilden. Das Datum kommt aus dem Belegdatum, der RUC aus den Firmendaten und die Umgebung aus einer Einstellung, die sich zwischen Test- und Produktivdatenbank unterscheidet.
- Ihn am Beleg speichern. Schlüssel, Status und Autorisierungsdatum werden in benutzerdefinierten Feldern an der Ausgangsrechnung, Ausgangsgutschrift, Lieferung oder an der Eingangsrechnung mit retención gespeichert, sodass Benutzer sie sehen, ohne SAP B1 zu verlassen.
- Ihn auf dem RIDE drucken. Das Crystal-Reports-Layout zeigt die Clave de acceso und ihren Barcode.
- Schwebende und abgelehnte Zustände behandeln. Eine Monitormaske listet Belege mit Status RECIBIDA, DEVUELTA oder nicht autorisiert mit der Meldung des SRI auf, damit jemand sie noch am selben Tag korrigiert.
Die Formel ist einfach. Schwierig ist, nie einen secuencial wiederzuverwenden und immer mit dem ursprünglichen Schlüssel erneut zu senden. Den vollständigen Integrationsumfang finden Sie auf unserer Seite zur SRI-E-Rechnung in Ecuador.
Kodenova hat SRI-Integrationen für SAP Business One umgesetzt. Werden Ihre Belege abgelehnt oder starten Sie einen neuen Rollout, kontaktieren Sie uns mit Ihrer SAP-B1-Version und den Belegarten, die Sie ausstellen.
Quellen
- SRI: Ficha técnica comprobantes electrónicos esquema offline, versión 2.26 (March 2024)
- SRI: Facturación electrónica
Passende Leistungen
Häufige Fragen
Wie viele Ziffern hat die SRI-Clave-de-acceso?
49. Achtundvierzig Ziffern stammen aus den Belegdaten (Datum, tipo de comprobante, RUC, ambiente, serie, secuencial, código numérico und tipo de emisión), die letzte Ziffer ist die Prüfziffer (dígito verificador) nach Modulo 11.
Wie wird der dígito verificador berechnet?
Multiplizieren Sie die ersten 48 Ziffern von rechts nach links mit den Gewichten 2, 3, 4, 5, 6, 7 und beginnen Sie dann wieder bei 2. Addieren Sie die Produkte, bilden Sie den Rest der Division durch 11 und ziehen Sie ihn von 11 ab. Ein Ergebnis von 11 wird zu 0, ein Ergebnis von 10 wird zu 1.
Ist die Clave de acceso dasselbe wie die número de autorización?
Ja, im Offline-Verfahren. Laut ficha técnica des SRI wird die vom Aussteller erzeugte Clave de acceso zur Autorisierungsnummer des Belegs.
Darf ich einen abgelehnten Beleg mit einer neuen Clave de acceso erneut senden?
Lehnt der SRI einen Beleg ab, ist er laut ficha técnica zu korrigieren und mit derselben Clave de acceso und demselben secuencial erneut zu senden. Erhalten Sie Fehler 70 (clave de acceso en procesamiento), senden Sie nicht erneut und erzeugen Sie keinen neuen Schlüssel; warten Sie auf die Antwort, was bis zu 24 Stunden dauern kann.
Gibt es im Offline-Verfahren einen Notfallschlüssel?
Nein. Notfallschlüssel (claves de contingencia) wurden mit Version 2.0 der Offline-ficha-técnica abgeschafft; es gibt nur noch tipo de emisión 1 (emisión normal).
Bereit für den Start?
Sagen Sie uns, was Sie brauchen. Sie erhalten eine klare technische Antwort, einen festen Leistungsumfang und einen Preis, in der Regel innerhalb von 24 Stunden.
