# Tellen

## Docs

- [Consultar un certificado](https://docs.tellen.app/api-reference/certificados/consultar-un-certificado.md)
- [Eliminar un certificado](https://docs.tellen.app/api-reference/certificados/eliminar-un-certificado.md): Elimina un certificado de la cuenta. Si eliminas el certificado activo, la cuenta queda sin certificado de firma hasta que subas otro.
- [Listar certificados](https://docs.tellen.app/api-reference/certificados/listar-certificados.md): Devuelve los certificados de firma de la cuenta, del más reciente al más antiguo.
- [Subir un certificado de firma](https://docs.tellen.app/api-reference/certificados/subir-un-certificado-de-firma.md): Sube un certificado de firma electrónica (.p12 / PKCS#12) para la cuenta. Envía el archivo codificado en base64 junto con su contraseña. Si la contraseña es correcta, el certificado queda como el certificado activo de la cuenta y se usa para firmar sus documentos electrónicos.
- [Actualizar un contacto](https://docs.tellen.app/api-reference/contactos/actualizar-un-contacto.md): Envía solo los campos que quieras cambiar.
- [Consultar un contacto](https://docs.tellen.app/api-reference/contactos/consultar-un-contacto.md)
- [Crear un contacto](https://docs.tellen.app/api-reference/contactos/crear-un-contacto.md)
- [Eliminar un contacto](https://docs.tellen.app/api-reference/contactos/eliminar-un-contacto.md): Solo se pueden eliminar contactos sin documentos asociados.
- [Listar contactos](https://docs.tellen.app/api-reference/contactos/listar-contactos.md): Devuelve los clientes y proveedores de la cuenta, ordenados por razón social, con paginación.
- [Cuentas hijas (plataforma)](https://docs.tellen.app/api-reference/cuentas-hijas.md): Si tu cuenta es una plataforma, crea cuentas hijas a partir de su RUC y opéralas por completo desde la API de Tellen, bajo un modelo de reventa.
- [Actualizar una cuenta](https://docs.tellen.app/api-reference/cuentas/actualizar-una-cuenta.md): Modifica los datos de tu cuenta o de una cuenta que administras. Envía solo los campos que quieras cambiar.
- [Consultar una cuenta](https://docs.tellen.app/api-reference/cuentas/consultar-una-cuenta.md)
- [Crear una cuenta](https://docs.tellen.app/api-reference/cuentas/crear-una-cuenta.md): Provisiona una nueva cuenta bajo tu gestión a partir de su RUC. El perfil del negocio y sus establecimientos activos se obtienen del SRI; tú solo envías el RUC, los datos de contacto y el plan. Disponible solo si tu cuenta está habilitada para administrar varias cuentas; de lo contrario la API respo…
- [Listar cuentas](https://docs.tellen.app/api-reference/cuentas/listar-cuentas.md): Devuelve las cuentas a las que puedes acceder con tu token: tu propia cuenta y, si administras varias, todas las que gestionas.
- [Consultar un establecimiento](https://docs.tellen.app/api-reference/establecimientos/consultar-un-establecimiento.md): Incluye los puntos de emisión del establecimiento.
- [Listar establecimientos](https://docs.tellen.app/api-reference/establecimientos/listar-establecimientos.md): Devuelve los establecimientos de la cuenta, ordenados por código, con paginación.
- [Sincronizar establecimientos desde el SRI](https://docs.tellen.app/api-reference/establecimientos/sincronizar-establecimientos-desde-el-sri.md): Consulta los establecimientos de la cuenta en el SRI y crea uno por cada establecimiento activo (`ABIERTO`) que aún no exista. Es idempotente: los establecimientos ya registrados se omiten, así que puedes ejecutarlo las veces que quieras.
- [Anular una factura](https://docs.tellen.app/api-reference/facturas/anular-una-factura.md): Anula una factura autorizada. Solo es posible hasta el día 7 del mes siguiente a la emisión. Recuerda anular también el comprobante en el SRI.
- [Consultar una factura](https://docs.tellen.app/api-reference/facturas/consultar-una-factura.md): Devuelve la factura con sus ítems, cliente y punto de emisión.
- [Crear una factura](https://docs.tellen.app/api-reference/facturas/crear-una-factura.md): Crea una factura en borrador. Los impuestos de cada ítem se derivan automáticamente del producto referenciado; solo envías el producto, la cantidad y el descuento. Para enviarla al SRI, usa luego el endpoint de envío.
- [Editar una factura](https://docs.tellen.app/api-reference/facturas/editar-una-factura.md): Edita una factura en borrador o rechazada. Puedes cambiar el cliente y el método de pago; si envías `items`, reemplaza todos los ítems actuales.
- [Eliminar una factura](https://docs.tellen.app/api-reference/facturas/eliminar-una-factura.md): Elimina una factura en borrador. Las facturas ya enviadas al SRI no se pueden eliminar.
- [Enviar una factura al SRI](https://docs.tellen.app/api-reference/facturas/enviar-una-factura-al-sri.md): Encola una factura en borrador o rechazada para su autorización en el SRI. La cuenta debe tener un certificado de firma activo. El procesamiento ocurre en segundo plano: la factura pasa a `pending` y luego a `authorized` o `rejected`. Consulta el estado final con `GET` de la factura.
- [Listar facturas](https://docs.tellen.app/api-reference/facturas/listar-facturas.md): Devuelve las facturas de la cuenta en el ambiente activo (pruebas o producción), de la más reciente a la más antigua, con paginación.
- [Guía rápida para plataformas](https://docs.tellen.app/api-reference/plataforma-guia-rapida.md): Integra la API de Tellen para ofrecer facturación electrónica al SRI dentro de tu propio producto. Guía end-to-end con ejemplos en cURL, Node y Ruby para integradores en Ecuador.
- [Actualizar un producto](https://docs.tellen.app/api-reference/productos/actualizar-un-producto.md): Envía solo los campos que quieras cambiar. Las existencias no se editan aquí: se mueven a través del kardex, así que `stock_quantity` no es modificable e `initial_stock` se ignora.
- [Consultar un producto](https://docs.tellen.app/api-reference/productos/consultar-un-producto.md): Incluye la configuración de impuestos, las variantes con nombre y el inventario.
- [Crear un producto](https://docs.tellen.app/api-reference/productos/crear-un-producto.md): Crea un producto o servicio. Para controlar inventario, envía `track_stock: true` (se ignora en servicios) y, opcionalmente, `initial_stock` para registrar las existencias iniciales en el kardex.
- [Eliminar un producto](https://docs.tellen.app/api-reference/productos/eliminar-un-producto.md): Solo se pueden eliminar productos sin documentos asociados.
- [Listar productos](https://docs.tellen.app/api-reference/productos/listar-productos.md): Devuelve los productos y servicios de la cuenta, ordenados por nombre, con paginación.
- [Actualizar un punto de emisión](https://docs.tellen.app/api-reference/puntos-de-emisión/actualizar-un-punto-de-emisión.md): Envía solo los campos que quieras cambiar.
- [Consultar un punto de emisión](https://docs.tellen.app/api-reference/puntos-de-emisión/consultar-un-punto-de-emisión.md)
- [Crear un punto de emisión](https://docs.tellen.app/api-reference/puntos-de-emisión/crear-un-punto-de-emisión.md)
- [Eliminar un punto de emisión](https://docs.tellen.app/api-reference/puntos-de-emisión/eliminar-un-punto-de-emisión.md): Solo se pueden eliminar puntos de emisión sin documentos asociados.
- [Listar puntos de emisión](https://docs.tellen.app/api-reference/puntos-de-emisión/listar-puntos-de-emisión.md): Devuelve los puntos de emisión de la cuenta, ordenados por código, con paginación.
- [Tu propia cuenta](https://docs.tellen.app/api-reference/tu-propia-cuenta.md): Opera tu cuenta desde la API de Tellen: genera un token, sube tu certificado y emite, envía y anula comprobantes ante el SRI.
- [Tellen para pequeños negocios con múltiples locales](https://docs.tellen.app/casos-de-uso/pequenos-negocios.md): Centraliza la facturación electrónica de tu negocio con múltiples usuarios, locales y puntos de emisión. Control total desde un solo panel en la nube.
- [Facturación electrónica para software y plataformas](https://docs.tellen.app/casos-de-uso/plataforma.md): Ofrece facturación electrónica al SRI dentro de tu propio producto —ERP, POS, sistema de gestión o SaaS— sin construir la integración con el SRI desde cero. Tellen es tu motor de facturación.
- [Facturación electrónica para profesionales independientes](https://docs.tellen.app/casos-de-uso/profesional-independiente.md): Emite facturas y comprobantes electrónicos al SRI en segundos, sin formularios complejos ni software obsoleto. Guía para freelancers y consultores en Ecuador.
- [Cómo anular una factura](https://docs.tellen.app/como-anular-una-factura.md)
- [Cómo emitir una liquidación de compra](https://docs.tellen.app/como-emitir-una-liquidacion-de-compra.md)
- [Cómo gestionar y consultar el detalle de un producto o servicio](https://docs.tellen.app/como-gestionar-y-consultar-el-detalle-de-un-producto-o-servicio.md)
- [Cómo gestionar y consultar el historial de un contacto](https://docs.tellen.app/como-gestionar-y-consultar-el-historial-de-un-contacto.md)
- [Cómo crear una cotización y transformarla en factura](https://docs.tellen.app/cotizaciones.md)
- [Importación en lote (Plan Básico)](https://docs.tellen.app/importacion-en-lote-plan-basico.md)
- [Qué es Tellen: facturación electrónica para Ecuador](https://docs.tellen.app/introduccion.md): Tellen automatiza la generación de XML, la firma digital con tu certificado .p12 y el envío al SRI. Emite facturas y comprobantes autorizados en segundos.
- [Notas de crédito y débito](https://docs.tellen.app/notas-de-credito-y-debito.md)
- [¿Qué es una orden de venta y cómo crearla?](https://docs.tellen.app/ordenes-de-venta.md)
- [Configura tu cuenta de Tellen y empieza a facturar](https://docs.tellen.app/primeros-pasos/configura-tu-cuenta.md): Crea tu cuenta, revisa los datos de tu negocio, sube tu certificado digital .p12 y valida el flujo en el ambiente de pruebas del SRI.
- [Cómo invitar a tu equipo y asignar roles en Tellen](https://docs.tellen.app/primeros-pasos/invita-a-tu-equipo.md): Aprende a agregar colaboradores en Tellen, asignar roles claros y coordinar quién es responsable de cada etapa del proceso de facturación.
- [Cómo emitir una factura electrónica](https://docs.tellen.app/producto/emite-comprobantes.md)
- [Configura establecimientos y puntos de emisión SRI](https://docs.tellen.app/producto/establecimientos-y-puntos-de-emision.md): Configura correctamente tus establecimientos y puntos de emisión para cumplir con la numeración secuencial que exige el SRI y evitar rechazos de comprobantes.
- [Cómo añadir un contacto](https://docs.tellen.app/producto/organiza-tus-clientes.md)
- [Cómo añadir productos y servicios](https://docs.tellen.app/productos.md)
- [Checklist de onboarding: configura Tellen sin errores](https://docs.tellen.app/recursos/checklist-de-onboarding.md): Sigue este checklist paso a paso para configurar Tellen correctamente y comenzar a emitir comprobantes electrónicos al SRI sin contratiempos.
- [Preguntas frecuentes sobre Tellen, SRI y certificados](https://docs.tellen.app/recursos/preguntas-frecuentes.md): Respuestas a las dudas más comunes sobre facturación electrónica, cumplimiento SRI, planes, certificados digitales y el manejo de tus datos en Tellen.

## OpenAPI Specs

- [openapi](https://docs.tellen.app/api-reference/openapi.yaml)