Skip to main content
Algunas cuentas de Tellen funcionan como plataforma: crean otras cuentas —las cuentas hijas— y pagan por su uso de Tellen. Es el modelo pensado para contadores, agencias y software que ofrecen facturación electrónica a sus propios clientes. Con un solo token de plataforma operas todas tus cuentas hijas. En cada solicitud, el identificador de la ruta (/api/v1/accounts/{account_id}/...) indica sobre qué cuenta hija estás trabajando.
Solo una cuenta con acceso de plataforma puede crear y operar cuentas hijas. Una cuenta común se administra únicamente a sí misma —para ese caso, revisa Tu propia cuenta. Si aún no tienes acceso de plataforma, escríbenos.

​
Cómo se relacionan una plataforma y sus hijas

  • Una plataforma administra tantas cuentas hijas como necesite.
  • Cada cuenta hija pertenece a una sola plataforma: la que la creó y la que paga por ella.
  • En Listar cuentas, la plataforma ve todas sus hijas, y sobre cada una lee y opera como si fuera su propia cuenta.

​
El flujo, paso a paso

1

Crea la cuenta hija con su RUC

Crea la cuenta con Crear una cuenta enviando solo lo que el SRI no conoce: el RUC, los datos de contacto (correo y teléfono) y el plan.El resto del perfil —razón social, dirección, régimen y condiciones tributarias— lo completa Tellen a partir del SRI, que es la fuente oficial; por eso no puedes sobrescribirlo. Los establecimientos activos del RUC también se crean automáticamente en la cuenta hija.
Si el RUC ya está registrado en Tellen, la cuenta no se crea: no puede haber dos cuentas con el mismo RUC.
2

Configura su firma electrónica

Una cuenta hija recién creada no tiene panel web para cargar su certificado, así que lo subes desde la API con Subir un certificado de firma sobre la ruta de esa hija. Envías el archivo .p12 en base64 junto con su contraseña.Sin un certificado activo y vigente, la cuenta hija no puede firmar comprobantes ante el SRI.
3

Crea sus puntos de emisión

Los establecimientos se crearon junto con la cuenta. Consúltalos con Listar establecimientos y agrega los puntos de emisión que necesites con Crear un punto de emisión, siempre sobre la ruta de la cuenta hija.
4

Opera la cuenta hija

De aquí en adelante el flujo es idéntico al de tu propia cuenta; solo cambia el account_id de la ruta por el de la hija. Registra sus contactos y productos, crea facturas con Crear una factura y envíalas al SRI con Enviar una factura al SRI.
En el historial de la cuenta hija, los cambios hechos por la API quedan a nombre de su usuario de servicio (“Tellen API”), no del usuario de la plataforma.
5

Ajusta el plan y los datos cuando haga falta

Como tú pagas por la cuenta hija, al editarla con Actualizar una cuenta sí puedes cambiar su plan —algo que no puedes hacer con tu propia cuenta, cuyo plan viene de Stripe.

​
Cómo funciona el cobro

Las cuentas hijas no pagan su propio uso de Tellen: lo cubre la plataforma.
  • Al crearla, la cuenta hija hereda el correo de cobro de la plataforma.
  • No tiene su propio cliente en Stripe; por eso su plan lo defines y lo cambias tú.
  • Empieza en el ambiente de pruebas del SRI, salvo que la pases a producción al crearla.
Mientras una plataforma tenga cuentas hijas, no puede renunciar a su acceso de plataforma: sus hijas quedarían fuera del alcance de la API, pero seguirían generando cobros.

​
Siguiente paso

Encuentra el detalle de cada endpoint —sus parámetros y respuestas— en la sección Endpoints de esta misma pestaña.

Tu propia cuenta

Repasa el flujo de emisión, que funciona igual en cada cuenta hija.