> ## 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.

# Registro de identificadores de remitente

> Registre identificadores de remitente alfanuméricos por país en Orbit, siga el estado de aprobación y comprenda por qué algunos destinos bloquean a los remitentes no registrados.

# Registro de identificadores de remitente

Un **identificador de remitente alfanumérico** es un nombre de marca corto
(por ejemplo `MyBrand`) que aparece como el "de" en un SMS en lugar de un
número de teléfono. Muchos países exigen **registrar** un identificador de
remitente ante el regulador local o los operadores antes de que el tráfico
que lo use sea entregado — y algunos bloquean directamente a los remitentes
alfanuméricos no registrados.

Orbit le permite registrar sus identificadores de remitente por país,
adjuntar los documentos KYC de respaldo y seguir el estado de aprobación de
cada país. Las puertas en el momento del envío hacen cumplir luego que el
tráfico solo fluya donde un identificador de remitente esté aprobado.

Todos los endpoints a continuación están enraizados en
`https://api.orbit.devotel.io/api/v1/compliance`.

<Note>
  Registrar un identificador de remitente en Orbit lo envía a nuestro flujo
  de trabajo de cumplimiento; **la aprobación final la otorga el
  regulador/operador de cada país**, no instantáneamente la plataforma.
  Planifique con antelación — algunos mercados tardan de días a semanas.
</Note>

***

## Reglas de formato del identificador de remitente

| Regla                 | Valor                                                   |
| --------------------- | ------------------------------------------------------- |
| Longitud              | 3–11 caracteres                                         |
| Caracteres permitidos | letras, dígitos, espacio, guion (`-`), guion bajo (`_`) |

El techo de 11 caracteres es el límite estricto de GSM 7 bits; reguladores
como ANATEL (Brasil), OFCOM (Reino Unido), AGCOM (Italia) y BTRC (Bangladés)
rechazan identificadores de remitente de menos de 3 caracteres.

***

## Registrar o actualizar un identificador de remitente

`POST /compliance/sender-id-registrations` (administrador/propietario) envía
un identificador de remitente para uno o más países. Cada entrada de país
hace referencia a documentos de cumplimiento previamente cargados mediante
sus ID `doc_…` — no se cargan archivos aquí.

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/compliance/sender-id-registrations \
  -H "Authorization: Bearer $ORBIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "document_refs": ["doc_abc123def456"],
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  }'
```

| Campo                                  | Tipo      | Notas                                                                            |
| -------------------------------------- | --------- | -------------------------------------------------------------------------------- |
| `sender_id`                            | string    | 3–11 caracteres; vea las reglas de formato arriba.                               |
| `countries`                            | array     | 1–20 entradas.                                                                   |
| `countries[].country`                  | string    | ISO-3166-1 alfa-2 (mayúsculas).                                                  |
| `countries[].document_refs`            | string\[] | 1–20 ID de la forma `doc_…` que referencian documentos KYC cargados previamente. |
| `countries[].registration_provider_id` | string    | Referencia opcional del proveedor/descendente (≤ 200).                           |
| `countries[].notes`                    | string    | Texto libre opcional, p. ej. caso de uso (≤ 2000).                               |

Devuelve la vista del registro con el `status` de cada país:

```json theme={null}
{
  "data": {
    "id": "sidreg_xyz",
    "sender_id": "MyBrand",
    "countries": [
      {
        "country": "BR",
        "status": "pending",
        "document_refs": ["doc_abc123def456"],
        "registered_at": null,
        "expires_at": null,
        "registration_provider_id": null,
        "notes": "Retail brand, transactional + OTP use case"
      }
    ]
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}
```

El envío es un **upsert idempotente** claveado en
`(organization, sender_id)`. Al reenviar:

* agrega países nuevos con `status: pending`;
* para un país ya `approved`, **mantiene la aprobación** mientras actualiza
  sus documentos, referencia de proveedor y notas;
* para un país que estaba `rejected` o `expired`, **lo restablece a
  `pending`** para que se revise de nuevo.

Esto le permite agregar países a un identificador de remitente existente de
forma segura sin perder las aprobaciones que ya tiene.

***

## Listar sus registros

`GET /compliance/sender-id-registrations` devuelve cada identificador de
remitente y su estado por país. Disponible para cualquier usuario
autenticado.

```json theme={null}
{
  "data": {
    "entries": [
      {
        "id": "sidreg_xyz",
        "sender_id": "MyBrand",
        "countries": [
          {
            "country": "BR",
            "status": "approved",
            "document_refs": ["doc_abc123def456"],
            "registered_at": "2026-06-05T00:00:00.000Z",
            "expires_at": "2027-06-05T00:00:00.000Z"
          }
        ]
      }
    ],
    "total": 1
  },
  "meta": { "request_id": "…", "timestamp": "2026-06-08T12:00:00.000Z" }
}
```

***

## Ciclo de vida del estado

| Estado     | Significado                                                                              |
| ---------- | ---------------------------------------------------------------------------------------- |
| `pending`  | Enviado, en espera de revisión/aprobación.                                               |
| `approved` | Autorizado — el tráfico con este identificador de remitente está permitido para el país. |
| `rejected` | Rechazado; corrija el problema y reenvíe para restablecer a `pending`.                   |
| `expired`  | La ventana de validez del registro se cerró; reenvíe para renovar.                       |

Cuando una entrada de país está `approved` lleva `registered_at` y
`expires_at`. Renueve antes de `expires_at` para evitar un lapso.

<Warning>
  Las puertas en el momento del envío hacen cumplir el registro: el SMS A2P
  hacia un país que exige un identificador de remitente registrado se
  **bloquea** a menos que la entrada de ese país esté `approved`. Registre y
  obtenga la aprobación antes de lanzar tráfico hacia un mercado nuevo.
</Warning>

<Note>
  En inquilinos creados antes de la migración de identificadores de
  remitente, el endpoint de lista devuelve un conjunto vacío y `POST`
  devuelve `409 TENANT_NOT_MIGRATED` — contacte a soporte para habilitar la
  función.
</Note>

***

## India es diferente

India **no** usa este flujo genérico de identificadores de remitente. Los
identificadores de remitente de SMS indios ("Headers") se registran a través
del sistema DLT/TRAI — vea [Onboarding de DLT-India](/compliance/dlt-india).

***

## Referencias relacionadas

* [Documentos KYC y el ciclo de vida del perfil de cumplimiento](/compliance/documents-kyc) —
  cómo cargar los ID `doc_…` que referencia aquí, reutilizarlos entre
  perfiles y renovarlos antes de que expiren.
* [Requisitos de cumplimiento por país](/compliance/country-requirements) —
  qué tipos de remitente acepta cada país y si el registro es obligatorio,
  además de los documentos a suministrar.
* [Solucionar rechazos del modo estricto de identificador de remitente](/troubleshooting/strict-sender-id-invalid-destination) —
  la puerta opcional de formato de remitente y los códigos de regla que
  devuelve ante un remitente infractor.
* [Onboarding de DLT-India](/compliance/dlt-india) — registro de
  identificadores de remitente ("Header") para India.
* [Send Gates](/compliance/send-gates) — las reglas por país y las puertas
  que hacen cumplir el registro en el momento del envío.
* [Gestión del consentimiento](/compliance/consent-management) — la capa de
  consentimiento que se complementa con el cumplimiento de identificadores
  de remitente.
* [Referencia de la API → Cumplimiento](/api-reference/endpoints/compliance) —
  esquemas completos de solicitud/respuesta (regenerados desde la API en
  vivo).