Programa OEM de Contadeo™

Factura al SRI por tus clientes, desde tu propia plataforma. Con el programa OEM, tu empresa integra la facturación electrónica de Contadeo dentro de tu software y aprovisiona una cuenta por cliente, sin que ellos tengan que abrir nada a mano ni salir de tu producto.

Qué es

El OEM es la forma en que un integrador (tu ERP, tu punto de venta, tu software de talleres…) opera Contadeo "desde dentro": tú creas y administras una cuenta de facturación —un tenant— por cada uno de tus clientes, y emites sus comprobantes al SRI en su nombre. Nosotros validamos, firmamos con el certificado del cliente y transmitimos al SRI; tú recibes el comprobante autorizado con su RIDE (PDF) y XML.

A diferencia de una API key normal, que nunca puede administrar una cuenta, tu partner key OEM (cdop_) sí puede aprovisionar tenants y operar como administrador — pero solo sobre los clientes que tú gestionas. El aislamiento entre clientes está garantizado a nivel de base de datos.

Para quién es

El programa OEM está pensado para empresas que ya tienen clientes que necesitan facturar y quieren ofrecerlo sin construir el conector al SRI desde cero:

• Software de talleres, POS y puntos de venta que quieren emitir la factura al cerrar la venta.
• ERP y sistemas de gestión que facturan a nombre de varias empresas.
• Plataformas de e-commerce y marketplaces que emiten por cada vendedor.
• Estudios contables y BPO que llevan la facturación de una cartera de clientes y quieren un flujo white-label.

Si tu producto atiende a muchos contribuyentes distintos y cada uno necesita su propia numeración, su certificado y su historial, el OEM es para ti.

Cómo funciona

Tres pasos para pasar de la evaluación a facturar en producción:

1. Te registras

Dejas los datos de tu empresa en /solicitar-oem (razón social, RUC, email y teléfono de contacto). Validamos el RUC y tu solicitud queda en revisión. No necesitas crear un usuario ni una cuenta previa.

2. Te aprobamos y recibes tu credencial

Nuestro equipo aprueba tu empresa, te asigna un cupo de clientes y emite tu primera partner key cdop_. La key se muestra una sola vez: guárdala en tu gestor de secretos. Te la entregamos directamente o mediante un enlace de canje de un solo uso, con el que tu equipo la genera de forma segura.

Sin mínimos de volumen. No exigimos un número mínimo de facturas al mes para aprobarte: el programa está pensado también para plataformas que recién arrancan. El único filtro es la solicitud y una conversación de arranque.

3. Integras

Con una única credencial operas en dos planos, según envíes o no el header X-Cuenta:

• Plano partner (Authorization: Bearer cdop_…, sin X-Cuenta): aprovisionas y gestionas tu portafolio de clientes y configuras tus webhooks.
• Plano tenant (misma key + X-Cuenta: <tenantId>): operas un cliente con rol administrador — subes su certificado, emites sus comprobantes y descargas RIDE/XML— reutilizando los endpoints normales de la API.

Aprovisionas al cliente, subes su firma, emites y recibes el estado final por webhook. Todo desde tu plataforma.

Qué incluye

• Aislamiento por cliente. Cada cliente vive en su propio tenant, con su numeración, sus certificados y sus datos separados. Una partner key solo alcanza a los tenants que tú aprovisionaste; nunca a los de otro integrador.
• Webhooks firmados. Cuando un comprobante llega a estado final, te avisamos con un POST firmado (HMAC SHA-256, esquema anti-replay) — sin datos personales del comprador. Olvídate del polling. Incluye reintentos con backoff, historial de entregas y reenvío manual.
• Facturación mayorista. Tú pagas a Contadeo por cortes mensuales consolidados (tenants gestionados + comprobantes autorizados); tus clientes no le pagan a Contadeo. El consumo se cuenta por fecha de emisión, igual que el reporte de ventas, para que puedas reconciliar.
• Ambiente de pruebas. Cada tenant nace en el ambiente de Pruebas del SRI (certificación, sin validez tributaria). Pruebas el flujo completo antes de pasar a Producción.

Cómo empezar

1. Solicita acceso en /solicitar-oem. Toma un par de minutos.
2. Al aprobarte, recibes tu partner key cdop_ y tu cupo inicial.
3. Integra siguiendo la documentación para integradores y la referencia OpenAPI, donde están todos los endpoints con sus esquemas, parámetros y errores (incluidos los del plano /partner/*).
4. Prueba en ambiente de Pruebas y, cuando estés listo, pasa cada cliente a Producción.

Tu portal

Al aprobarte, tu persona de contacto recibe una invitación para fijar su contraseña y entrar al portal OEM con su correo. Ahí ves tu consumo del mes en vivo, tus cortes de facturación y el estado de tu webhook, y configuras la marca con la que salen los correos a los compradores de tus clientes (nombre, color y logo).

Desde el portal puedes invitar al resto de tu equipo, con rol de administrador (gestiona) o de solo lectura (consulta), y cada persona puede activar la verificación en dos pasos sobre su propia cuenta. La partner key no se usa para entrar: es la credencial de tu servidor, y se revoca por separado de las personas.

Preguntas frecuentes

¿Necesito una cuenta por cada cliente?

Sí. El modelo es un tenant por cliente: así cada uno mantiene su numeración, sus certificados y su historial aislados, y tú puedes darle plan, cupo y facturación por separado. Los creas tú, en segundos, desde tu plataforma.

¿Cómo recibo el aviso de autorización?

Con webhooks firmados. Registras una URL https y, cuando un comprobante de un cliente tuyo queda AUTORIZADO, RECHAZADO o DEVUELTA, te enviamos un POST con la clave de acceso, el número de autorización y el estado, firmado con tu secreto (verificación en tiempo constante + anti-replay). Si prefieres, también puedes consultar el comprobante por API.

¿Cómo se factura?

Al por mayor, a ti. Contadeo genera un corte mensual con tu consumo (clientes gestionados y comprobantes autorizados del período) y tú cobras a tus clientes como prefieras dentro de tu producto. Tus clientes no le pagan a Contadeo: el precio mayorista es comercial y lo acordamos contigo.

¿Puedo probar antes de ir a producción?

Sí. Todo cliente nace en el ambiente de Pruebas del SRI (certificación, sin validez tributaria). Emites, verificas el flujo completo y recién entonces pasas ese cliente a Producción.

¿Qué credencial uso?

Una sola: tu partner key cdop_. Sin X-Cuenta gestionas tu portafolio (plano partner); con X-Cuenta: <tenantId> operas un cliente concreto con rol administrador (plano tenant). No mezcles esta credencial con las API keys cdo_ normales, que están restringidas y no pueden administrar cuentas.

¿Cuántos clientes puedo aprovisionar?

Los que permita tu cupo, que fijamos al aprobarte y ampliamos según crezcas. Si intentas superarlo, la API responde con un error claro y basta con pedir más.

¿Mis clientes tienen que entrar a Contadeo?

No es necesario. Por defecto, un tenant aprovisionado se opera solo desde tu plataforma, sin usuario propio. Si algún cliente también quiere acceder al panel de Contadeo, puedes habilitarle un usuario al crearlo.

¿Listo para facturar por tus clientes?

Solicita tu acceso OEM →

Al aprobarte recibes tu partner key y tu cupo inicial, y puedes empezar a aprovisionar clientes y emitir en el ambiente de Pruebas el mismo día. ¿Dudas o volúmenes altos? Cuéntanos en el formulario y lo conversamos.