Saltar al contenido
CuadraDEV
IngresarCrear cuenta

Facturación electrónica dentro de tu software

Cuadra DEV es para apps que atienden a muchas empresas, como un ERP, un POS o un software contable. Creas las empresas de tus clientes por API y facturas ante la DIAN en todas con una sola llave de socio.

Crear cuenta de desarrolladorIngresar a la consola
Crear la empresa de un cliente (sandbox)
POST /v1/partner/companies
Authorization: Bearer cdp_test_…
Content-Type: application/json

{ "legalName": "Tienda SAS", "nit": "900123456",
  "adminEmail": "admin@tienda.co" }

→ 201 { "slug": "tienda-sas", … }

Cómo funciona

Cuatro pasos, de la primera llave a tus clientes facturando en producción.

  1. 1

    Crea tu cuenta de desarrollador

    Sin empresa propia. Activas la verificación en dos pasos y generas una llave de socio de sandbox (cdp_test_…). Gratis y sin validez fiscal.

  2. 2

    Crea las empresas de tus clientes

    Por API, con razón social, NIT y correo del administrador. La empresa nace en sandbox y su administrador recibe una invitación para aceptar los términos él mismo.

  3. 3

    Factura en cada una

    Los mismos endpoints de la API pública, con tu llave de socio y la cabecera Cuadra-Tenant con el slug de la empresa.

  4. 4

    Llévalas a producción

    Consulta los pendientes, envía el perfil fiscal que tu app ya tiene y abre un enlace de configuración para lo que solo la empresa puede hacer.

Facturar en una empresa de tu app
POST /v1/invoices
Authorization: Bearer cdp_test_…
Cuadra-Tenant: tienda-sas
Idempotency-Key: pedido-10045
Enlace de configuración para su administrador
POST /v1/partner/companies/tienda-sas/setup-links
Authorization: Bearer cdp_test_…

{ "returnUrl": "https://tu-app.co/empresas/tienda" }

→ { "url": "…/configurar/…", "expiresAt": "…" }

Lo que obtienes

Lo que ya funciona hoy en la consola de socios y en la API.

  • Una llave para todas

    Tu llave de socio opera todas tus empresas. Cada una conserva su aislamiento, sus permisos, su idempotencia y su auditoría.

  • Un webhook para todas

    Una URL recibe los eventos de todas tus empresas, firmados con un solo secreto. El campo company.slug dice de cuál es cada evento.

  • Enlace de configuración

    De un solo uso y válido 1 hora. El administrador sube su certificado, conecta la DIAN y vuelve a tu app.

  • La empresa tiene el control

    Ve tu integración como un usuario de su equipo y puede cortarla cuando quiera. Su certificado y su PIN nunca pasan por tu app.

  • Pendientes de producción

    La API te dice qué le falta a cada empresa para producción, para mostrarlo en tu app como una barra de avance.

  • Conectar empresas que ya usan Cuadra

    Próximamente

    Para que una empresa que ya factura con Cuadra autorice a tu app.

Lo que recibe tu webhook
{ "id": "evt…", "type": "document.accepted",
  "company": { "slug": "tienda-sas" },
  "data": { "document": { … } } }

Firma X-Cuadra-Signature con HMAC-SHA256, 8 reintentos y protección contra destinos internos: lo mismo que un webhook de empresa. Los detalles de la API pública están en la guía de la API.

Sandbox y producción

Pruebas libres; producción con revisión, para que cada documento tenga respaldo.

  • Sandbox

    Disponible

    Gratis y sin validez fiscal. Llaves cdp_test_ y empresas ilimitadas para probar tu integración.

  • Producción

    Disponible

    Cuando el equipo de Cuadra aprueba tu cuenta, generas llaves cdp_live_. Cada empresa pasa a producción cuando completa sus requisitos ante la DIAN.

  • Cobro al por mayor

    Próximamente

    Una cuota base más documentos por tramos, facturada a tu app y no a cada empresa. Tarifas: [EN DEFINICIÓN].

¿Integras solo tu propia empresa? Usa la API de tu empresa.

Empieza hoy en el sandbox

Crea tu cuenta, genera tu llave de socio y crea la primera empresa de prueba en minutos.

Crear cuenta de desarrollador