> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Länderspezifische Compliance-Anforderungen

> Länderspezifische und kanalspezifische Sender-Regeln auf Orbit, einschließlich akzeptierter Sender-Typen, Sender-ID-Registrierung, erforderlicher Dokumente und Inhaltsbeschränkungen.

# Länderspezifische Compliance-Anforderungen

Messaging- und Voice-Regeln werden Land für Land festgelegt. Bevor Sie in
einen neuen Markt senden, müssen Sie vier Dinge wissen: **welche Sender-Typen
das jeweilige Land akzeptiert** (einen Long Code? eine alphanumerische
Sender-ID? einen Short Code?), **ob eine Registrierung erforderlich ist**,
**welche Dokumente Sie einreichen müssen** und **welche Inhalte eingeschränkt
sind**. Ein Fehler hier ist der häufigste Grund dafür, dass erste Sendungen in
ein neues Land still nicht zugestellt werden.

Orbit pflegt eine kuratierte, länderspezifische regulatorische Referenz,
sodass Sie diese nicht selbst zusammentragen müssen. Diese Seite erklärt, wie
Sie sie lesen.

<Note>
  Diese Referenz dient als Orientierung für Ihre Planung, nicht als
  Zustellungsgarantie oder Rechtsberatung. Die endgültige Genehmigung einer
  Sender-ID oder Registrierung wird von der Regulierungsbehörde oder dem
  Netzbetreiber des jeweiligen Landes erteilt, nicht von Orbit. Die Abdeckung
  wird pro Mandant aktiviert — dass ein Land hier aufgeführt ist, bedeutet
  nicht, dass es für Ihr Konto aktiviert ist.
</Note>

***

## Länderregeln nachschlagen

`GET /compliance/country-rules` ist die schreibgeschützte regulatorische
Referenz hinter Orbits Sendezeit-Gates. Jeder authentifizierte Benutzer kann
sie aufrufen. Filtern Sie nach `channel` (Standard: `sms`) und optional nach
`region`:

```bash theme={null}
curl "https://api.orbit.devotel.io/api/v1/compliance/country-rules?channel=sms&region=EU" \
  -H "Authorization: Bearer $ORBIT_API_KEY"
```

Jede Zeile beschreibt ein Land × Kanal:

```json theme={null}
{
  "data": {
    "rows": [
      {
        "country_code": "FR",
        "channel": "sms",
        "country_name": "France",
        "calling_code": "33",
        "region": "EU",
        "sender_types": ["alphanumeric", "long_code"],
        "registration": "recommended",
        "sender_rules": "Alphanumeric sender IDs are dynamic; no pre-registration required but recommended for consistency.",
        "content_restrictions": "Marketing SMS requires prior opt-in (GDPR). No sends 20:00–08:00 or Sundays/holidays.",
        "stop_requirement": "STOP keyword mandatory in French (STOP au 36111).",
        "two_way": true,
        "dlr_support": "full",
        "default_tps": "10",
        "notes": ""
      }
    ],
    "channel": "sms",
    "last_synced_at": "2026-06-20T00:00:00.000Z",
    "total": 1
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-20T12:00:00.000Z" }
}
```

Der `channel`-Filter akzeptiert `sms`, `whatsapp`, `rcs`, `voice`, `email`
und `viber`. Dasselbe Land hat **separate Zeilen pro Kanal**, weil
unterschiedliche Kanäle unterschiedlichen Regulierungsbehörden unterliegen —
beispielsweise regeln Metas WABA-Regeln WhatsApp in Brasilien, während
Anatels Regeln SMS regeln.

***

## Jedes Feld lesen

| Feld                   | Was es Ihnen sagt                                                                                                                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sender_types`         | Welche Absenderidentitäten das Land akzeptiert — siehe die Tabelle unten.                                                                                                                  |
| `registration`         | `none`, `recommended` oder `required` — ob Sie eine Sender-ID vor dem Senden registrieren müssen.                                                                                          |
| `sender_rules`         | Hinweise in Klartext, wie sich Sender-IDs in diesem Land verhalten (dynamisch vs. vorregistriert, Nummernformat usw.).                                                                     |
| `content_restrictions` | Kategorie- und Einwilligungsbeschränkungen — z. B. „Marketing erfordert Opt-in", Verbote für Werbeinhalte. Siehe [Eingeschränkte & verbotene Branchen](/compliance/restricted-industries). |
| `stop_requirement`     | Ob ein Abmelde-Schlüsselwort vorgeschrieben ist und in welcher Sprache.                                                                                                                    |
| `two_way`              | Ob eingehende Antworten unterstützt werden.                                                                                                                                                |
| `dlr_support`          | Genauigkeit der Zustellbestätigungen: `full`, `partial`, `submitted_only` oder `none`.                                                                                                     |
| `default_tps`          | Die standardmäßige Durchsatzobergrenze (Nachrichten pro Sekunde).                                                                                                                          |

### Sender-Typen

| Wert           | Bedeutung                                                             |
| -------------- | --------------------------------------------------------------------- |
| `alphanumeric` | Eine markenbezogene Text-Sender-ID (z. B. `MyBrand`).                 |
| `numeric`      | Ein numerischer Absender, der kein路由barer Long Code ist.              |
| `long_code`    | Eine standardmäßige lokale/mobile lange Nummer.                       |
| `short_code`   | Ein dedizierter 4–6-stelliger Short Code.                             |
| `ten_dlc`      | Ein US-amerikanischer 10-stelliger Long Code, registriert über 10DLC. |
| `waba`         | Ein WhatsApp-Business-Account-Absender.                               |
| `rcs_agent`    | Ein verifizierter RCS-Business-Messaging-Agent.                       |
| `from_address` | Eine E-Mail-`from`-Adresse (E-Mail-Kanal).                            |

***

## Die `registration`-Stufen

Das `registration`-Feld ist der wichtigste Einzelwert, den Sie vor dem Start
lesen sollten. Es steuert Orbits Sendezeit-Gate:

<AccordionGroup>
  <Accordion title="none — frei senden">
    Es ist keine Sender-ID-Registrierung erforderlich. Sie können mit dem
    Senden beginnen, sobald der Kanal und das Land für Ihr Konto aktiviert
    sind.
  </Accordion>

  <Accordion title="recommended — jetzt senden, für Zuverlässigkeit registrieren">
    Das Senden ist ohne Registrierung erlaubt, unregistrierter Verkehr wird
    jedoch häufiger gefiltert oder umbeschriftet. Registrieren Sie die
    Sender-ID, um die Zustellung stabil zu halten.
  </Accordion>

  <Accordion title="required — vor dem Senden registrieren">
    Verkehr wird **blockiert**, bis Sie eine genehmigte
    Sender-ID-Registrierung für das Land haben. A2P-SMS in ein
    `required`-Land ohne genehmigten Eintrag wird vom Sendezeit-Gate
    zurückgehalten. Registrieren Sie sich und lassen Sie sich vor dem Start
    genehmigen — siehe
    [Sender-ID-Registrierung](/compliance/sender-id-registration).
  </Accordion>
</AccordionGroup>

***

## Dokumente, die jedes Land erwartet

Wo ein Land eine Registrierung verlangt (oder empfiehlt), reichen Sie
unterstützende Dokumente einmal ein und verweisen dann über ihre `doc_…`-IDs
darauf, wenn Sie eine Sender-ID registrieren. Der genaue Umfang variiert je
nach Markt, aber die meisten Regulierungsbehörden verlangen eine Kombination
aus:

* **Nachweis der Unternehmensregistrierung** — Gründungsurkunde,
  Gewerbeanmeldung oder gleichwertiges.
* **Eine Anwendungsfall-Beschreibung** — was Sie senden (transaktional, OTP,
  Marketing) und an wen.
* **Markeninhaberschaft / Berechtigung** — Nachweis, dass Sie zur Verwendung
  der Sender-ID / des Markennamens berechtigt sind, den Sie registrieren.
* **Lokale Steuer- oder Regulierungs-ID** — für Märkte, die die Registrierung
  an einen nationalen Identifikator binden.

Lesen Sie die `sender_rules` und `content_restrictions` des Ziellandes in der
Country-Rules-Antwort für die Einzelheiten und fügen Sie dann die passenden
Dokumente bei, wenn Sie die Registrierung einreichen.

Einige Märkte betreiben ein eigenes, dediziertes Registrierungsverfahren
anstelle des generischen Sender-ID-Ablaufs:

* **Indien** — Sender-IDs („Headers"), Inhaltsvorlagen und
  Einwilligungsvorlagen werden über das TRAI-DLT-Portal registriert. Siehe
  [DLT-India-Onboarding](/compliance/dlt-india).
* **Vereinigte Staaten** — A2P-SMS-Absender registrieren Brand und Kampagne
  über 10DLC. Siehe den [10DLC-Registrierungsleitfaden](/guides/10dlc-registration).

***

## Eine Start-Checkliste für ein neues Land

<Steps>
  <Step title="Regeln nachschlagen">
    Rufen Sie `GET /compliance/country-rules?channel=<channel>` für das Ziel
    auf und lesen Sie `sender_types`, `registration` und
    `content_restrictions`.
  </Step>

  <Step title="Einen akzeptierten Sender-Typ wählen">
    Wählen Sie eine Absenderidentität aus den `sender_types` des Landes —
    eine alphanumerische Sender-ID, einen Long Code, einen Short Code oder
    einen kanalnativen Absender (WABA / RCS-Agent).
  </Step>

  <Step title="Falls erforderlich registrieren">
    Wenn `registration` `required` (oder `recommended`) ist, laden Sie Ihre
    Dokumente hoch und reichen die Sender-ID zur Genehmigung ein. Planen Sie
    Vorlaufzeit ein — manche Märkte benötigen Tage bis Wochen.
  </Step>

  <Step title="Inhaltsbeschränkungen prüfen">
    Vergewissern Sie sich, dass Ihr Anwendungsfall gegen
    `content_restrictions` und [Eingeschränkte & verbotene
    Branchen](/compliance/restricted-industries) zulässig ist, und fügen Sie
    das erforderliche Abmelde-Schlüsselwort hinzu, wenn `stop_requirement`
    eines verlangt.
  </Step>

  <Step title="Starten">
    Sobald das Land aktiviert, der Sender-Typ akzeptiert und eine etwaige
    erforderliche Registrierung genehmigt ist, beginnen Sie mit dem Senden.
  </Step>
</Steps>

***

## Pflege der Regelquelle (Plattformbetreiber)

<Note>
  Dieser Abschnitt richtet sich an **Plattformbetreiber und
  Self-Hosted-Deployments**. SaaS-Kunden auf `api.orbit.devotel.io` können
  hier aufhören — Devotel hält die Länderregeln für Sie aktuell, und die
  folgenden Endpunkte sind auf Plattformadministratoren beschränkt.
</Note>

Die Country-Rules-Referenz wird durch geplante Upstream-Synchronisierungen
plus manuelle Operator-Bearbeitungen gespeist. Dieser Abschnitt behandelt,
wie Sie sie aktuell halten und wie Sie ein einzelnes Land sicher bearbeiten.
Die Endpunkte, die in die Regeltabelle schreiben, sind **nur für
Plattformadministratoren** — Mandanteninhaber und Administratoren erhalten
einen `403`, weil die Regeltabelle global über alle Mandanten hinweg gilt und
keine mandantenspezifischen Daten enthält.

### Feed-Quellen

Der `sync_source` jeder Zeile verzeichnet, welcher Feed sie zuletzt
aktualisiert hat. Sechs Anbieter binden an den Sync-Endpunkt an:

| Anbieter    | Was er liefert                                                                                         | Zugang                                                                                                                                           |
| ----------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `mef`       | MEF SenderID Protection Registry — MNO-signierte Sender-ID-Regeln (die maßgeblichste Sender-ID-Quelle) | Kostenpflichtige Aggregator-Tier-Mitgliedschaft; `DEVOTEL_MEF_API_KEY` setzen                                                                    |
| `gsma`      | GSMA-SMS-Hub-Sender-ID-Schutzregeln                                                                    | Mitgliederportal; `DEVOTEL_GSMA_API_KEY` setzen                                                                                                  |
| `telnyx`    | Länderabdeckung über den Telnyx-Coverage-Feed                                                          | Kostenlos mit `DEVOTEL_TELNYX_API_KEY`; greift bei Nichtsetzen auf Telnyx' öffentliche Abdeckungsliste zurück                                    |
| `iconectiv` | iconectiv-TCR-Partner-Feed — das kanonische US-10DLC-Regelwerk                                         | `DEVOTEL_TCR_API_KEY` + `DEVOTEL_TCR_PARTNER_ID` setzen; siehe den [10DLC-Leitfaden](/guides/10dlc-registration#country-rule-feed-configuration) |
| `meta`      | Meta Business API — länderspezifische WhatsApp-Verfügbarkeit (WABA)                                    | Kostenlos mit einem WABA-Systembenutzer-Token                                                                                                    |
| `itu`       | ITU WTID — Referenz-URLs nationaler Regulierungsbehörden                                               | Kostenlos (Namensnennung erforderlich)                                                                                                           |

Zwei benachbarte Feeds speisen ihre eigenen Tabellen:

* **Telnyx-Coverage für die Legacy-Sender-ID-Matrix** — die Lese-Endpunkte
  hinter der Sender-ID-Compliance-Matrix beziehen sich aus einer separaten
  Legacy-Tabelle. Aktualisieren Sie sie mit
  `POST /api/v1/compliance/admin/sync` (nur Admin; derselbe wöchentliche
  Scheduler aktualisiert sie auch automatisch).
* **Reassigned Numbers Database (RND)** — das US-Gate für stillgelegte
  Rufnummern, dokumentiert unter
  [Deactivation-Scrubbing](/compliance/deactivation-scrub). Mandanten
  aktivieren es mandantenspezifisch über
  `PUT /api/v1/compliance/rnd/settings` mit `{ "enabled": true }`; der
  Schalter verweigert das Einschalten, bis ein Operator einen RND-Snapshot in
  das Deployment geladen hat, sodass Mandanten sich nicht in ein leeres Gate
  opt-in können.

### Eine Upstream-Synchronisierung ausführen

`POST /api/v1/compliance/country-rules/sync` aktualisiert aus einem Anbieter.
Wählen Sie den Feed mit `?provider=` (Standard: `telnyx`) und begrenzen Sie
optional auf einen `?channel=`.

```bash theme={null}
curl -X POST "https://api.orbit.devotel.io/api/v1/compliance/country-rules/sync?provider=mef&channel=sms" \
  -H "Authorization: Bearer $ORBIT_PLATFORM_ADMIN_KEY"
```

Die Antwort meldet `upstreamCount`, `updated`, `createdNew` und ein
`errors`-Array. **Eine Synchronisierung überschreibt niemals von Operatoren
kuratierte Prosa** — nur strukturelle Felder (Ländername, Vorwahl, Region,
Sender-Typen, Registrierungsstufe) werden aktualisiert; die Freitextfelder
(`sender_rules`, `content_restrictions`, `notes`) behalten, was ein Operator
zuletzt geschrieben hat.

### Feed-Takt

Zwei Pfade halten die Tabelle aktuell:

* **Wöchentlicher Scheduler** — der Compliance-Sync-Tick des Webhook-Workers
  führt die Telnyx-, MEF- und GSMA-Feeds automatisch aus. Er läuft außerdem
  einmal beim Worker-Start, sodass sich ein frisches Deployment beim ersten
  Start selbst befüllt.
* **On-Demand** — die Admin-Aktion „Aus Upstream aktualisieren" ruft den
  obigen Sync-Endpunkt für einen sofortigen Abruf auf (nützlich direkt nach
  dem Bereitstellen neuer Feed-Zugangsdaten).

Die Veraltung wird anhand von `last_synced_at` geprüft, das der Lese-Endpunkt
neben den Zeilen zurückgibt. Manuelle Bearbeitungen stempeln stattdessen
`last_reviewed_at`, sodass das Dashboard die Herkunft anzeigen kann („Vor 3
Tagen von MEF synchronisiert; gestern von Ops geprüft") statt eines einzigen
mehrdeutigen Zeitstempels.

### Fehlerbehandlung

Jeder Konnektor ist **optional und fail-open**: Wenn seine
Credential-Umgebungsvariable nicht gesetzt ist, protokolliert die
Synchronisierung eine Skip-Meldung und liefert einen Eintrag in `errors`, und
bestehende Zeilen bleiben an Ort und Stelle. Dasselbe gilt bei einem
Upstream-Ausfall — die Antwort trägt den Fehlertext, während zuvor
synchronisierte Daten lesbar bleiben. Dies sind schreibgeschützte
Metadaten-Feeds auf einem Nachschlagepfad; ausgehendes Messaging läuft
weiterhin über Ihren normalen Absender, während ein Feed ausgefallen ist.

<Warning>
  Sync-Anbieter berühren nur Abdeckungsmetadaten. Sie sind niemals ein
  Transportpfad — versuchen Sie nicht, ausgehendes Messaging über einen der
  hier aufgeführten Coverage-Feeds zu leiten.
</Warning>

### Ein einzelnes Land bearbeiten

`PUT /api/v1/compliance/country-rules/:channel/:country_code` upsertet eine
Land-×-Kanal-Zeile. Verwenden Sie ihn, um Details zu liefern, die kein Feed
mitbringt — zum Beispiel STOP-Schlüsselwort-Formulierungen oder
Durchsatzgrenzen aus Regulierungstexten. Plattform-Admin-Zugangsdaten sind
erforderlich; Mandantenadministratoren erhalten einen `403`.

```bash theme={null}
curl -X PUT "https://api.orbit.devotel.io/api/v1/compliance/country-rules/sms/FR" \
  -H "Authorization: Bearer $ORBIT_PLATFORM_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country_name": "France",
    "calling_code": "33",
    "region": "EU",
    "sender_types": ["alphanumeric", "long_code"],
    "registration": "recommended",
    "sender_rules": "Alphanumeric sender IDs are dynamic.",
    "content_restrictions": "Marketing SMS requires prior opt-in.",
    "stop_requirement": "STOP keyword mandatory in French.",
    "two_way": true,
    "dlr_support": "full",
    "default_tps": "10",
    "notes": ""
  }'
```

Bearbeitbare Felder: `sender_types`, `registration` (`none` / `recommended` /
`required`), `sender_rules`, `content_restrictions`, `stop_requirement`,
`two_way`, `dlr_support`, `default_tps`, `notes` und `sources` (eine
`[{ label, url }]`-Liste von Quellenangaben-Links). Das Upsert stempelt
`last_reviewed_at` und markiert die Zeile als `sync_source: manual`, sodass
eine spätere automatische Synchronisierung nur die strukturellen Felder
aktualisiert und Ihre Prosa unberührt lässt.

### Validierungs-Checkliste, bevor Sie ein Land live schalten

Bevor Sie ein Land für den Versand aktivieren, bestätigen Sie:

<Steps>
  <Step title="Frischer Sync-Stempel">
    `last_synced_at` (oder, für die Legacy-Matrix, `last_verified_at`) ist
    aktuell — andernfalls führen Sie vor der Aktivierung die On-Demand-Sync
    für den relevanten Anbieter aus.
  </Step>

  <Step title="Korrekte Registrierungsstufe">
    `registration` ist gesetzt (`none` / `recommended` / `required`). Ein
    `required`-Land blockiert unregistrierten Verkehr zur Sendezeit, sodass
    eine verpasste Registrierungsprüfung fehlgeschlagene Sendungen bedeutet,
    nicht verzögerte.
  </Step>

  <Step title="Prosa-Felder geprüft">
    `stop_requirement` und `content_restrictions` sagen, was sie sagen
    sollen — Feeds aktualisieren nur Struktur, Prosa muss von einem Operator
    gesetzt werden.
  </Step>

  <Step title="Sender-Typ akzeptiert">
    Mindestens einer der `sender_types` des Landes passt zu dem, von dem Sie
    senden möchten.
  </Step>

  <Step title="Zugehörige Gates geladen">
    Wenn das Ziel ein RND- oder DLT-Gate hat (US-RND, Indien-DLT),
    vergewissern Sie sich, dass dieser Feed ebenfalls geladen ist — siehe
    [Deactivation-Scrubbing](/compliance/deactivation-scrub) und
    [DLT-India-Onboarding](/compliance/dlt-india).
  </Step>
</Steps>

***

## Verwandte Referenzen

* [Eingeschränkte & verbotene Branchen](/compliance/restricted-industries) —
  welche Branchen und Inhalte eingeschränkt oder verboten sind.
* [Sender-ID-Registrierung](/compliance/sender-id-registration) —
  Sender-ID-Registrierungen pro Land einreichen und verfolgen.
* [DLT-India-Onboarding](/compliance/dlt-india) — Indiens TRAI-DLT-Verfahren.
* [10DLC-Registrierung](/guides/10dlc-registration) — US-A2P-Brand- und
  Kampagnenprüfung (enthält die Country-Rule-Feed-Konfiguration für
  Betreiber).
* [Send Gates](/compliance/send-gates) — die Gates, die diese Regeln zur
  Sendezeit durchsetzen.
* [Netzwerksignale vor dem Senden](/guides/network-signals-open-gateway) —
  Empfänger vor dem ersten Versand an ein neues Ziel mit
  netzbetreiberbasierten SIM-Swap-, Roaming- und Risikosignalen prüfen.
* [API-Referenz → Compliance](/api-reference/endpoints/compliance) —
  vollständige Anfrage-/Antwortschemata.
