API REST v2 · documentación para desarrolladores

Integra la facturación del SRI en tu sistema

Emite facturas, notas, retenciones, guías y liquidaciones directamente desde tu e-commerce, ERP o app, con respuesta en segundos. Autenticación por api_key y secuenciales automáticos.

Obtener mi api_key Ver endpoints

emitir-factura.sh

curl -X POST https://tu-dominio/plataforma/api/v2/factura/emision \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "TU_API_KEY",
    "codigoDoc": "01",
    "emisor": { "fecha_emision": "2026/07/13", "manejo_interno_secuencia": "SI" },
    "comprador": { "tipo_identificacion": "07", "identificacion": "9999999999999", "razon_social": "CONSUMIDOR FINAL", "direccion": "Quito" },
    "items": [ { "codigo_principal": "P1", "descripcion": "Producto", "cantidad": 1, "precio_unitario": 100, "tipoproducto": 1, "tipo_iva": 4 } ]
  }'

# ← { "creado": true, "claveacceso": "..." }

Autenticación

El api_key se envía en el cuerpo del JSON (no en un header). Cada api_key identifica tu empresa, establecimiento, punto de emisión y ambiente.

Secuenciales

Envía manejo_interno_secuencia: "SI" y AZUR asigna el secuencial automáticamente, sin duplicados.

Ambientes

Tu api_key define si emites en Pruebas o Producción. El mismo código funciona en ambos.

Rate limit

Los endpoints de emisión aceptan 5 peticiones cada 60 segundos por comprobante.

Respuesta

Éxito: { "creado": true, "claveacceso": "…" }. Luego consulta el estado con /consulta/comprobante.

Automático

Al emitir, se crean o actualizan solos el cliente y los productos que no existan.

Endpoints de emisión

Ejemplos completos, listos para copiar

Cada comprobante tiene su endpoint. Elige uno para ver el cuerpo JSON completo que acepta.

Request · JSON POST

POST /plataforma/api/v2/factura/emision

{
  "api_key": "TU_API_KEY",
  "codigoDoc": "01",
  "emisor": {
    "fecha_emision": "2026/07/13",
    "secuencial": "000000123",
    "manejo_interno_secuencia": "SI"
  },
  "comprador": {
    "tipo_identificacion": "05",
    "identificacion": "1712345678",
    "razon_social": "JUAN PEREZ LOPEZ",
    "direccion": "Av. Amazonas N34-56, Quito",
    "telefono": "022345678",
    "celular": "0991234567",
    "correo": "juan.perez@ejemplo.com"
  },
  "items": [
    {
      "codigo_principal": "PROD-001",
      "codigo_auxiliar": "AUX-001",
      "descripcion": "Laptop HP 15 Core i5",
      "cantidad": 2,
      "precio_unitario": 850.00,
      "descuento": 50.00,
      "tipoproducto": 1,
      "tipo_iva": 4,
      "unidad_medida": 1,
      "detalles_adicionales": [
        { "nombre": "Marca", "detalle": "HP" },
        { "nombre": "Garantia", "detalle": "12 meses" }
      ]
    },
    {
      "codigo_principal": "SERV-010",
      "descripcion": "Servicio de instalacion",
      "cantidad": 1,
      "precio_unitario": 30.00,
      "tipoproducto": 2,
      "tipo_iva": 4
    }
  ],
  "pagos": [
    { "tipo": "20", "total": 1918.00, "tiempo": "dias", "plazo": 30 }
  ],
  "informacion_adicional": [
    { "nombre": "Vendedor", "detalle": "Maria Gomez" }
  ]
}

Respuesta · éxito

{ "creado": true,
  "claveacceso": "2607…49 dígitos" }

Respuesta · error

{ "creado": false,
  "errors": [ "El campo items es
  obligatorio." ] }

Request · JSON POST

POST /plataforma/api/v2/credito/emision

{
  "api_key": "TU_API_KEY",
  "codigoDoc": "04",
  "emisor": { "fecha_emision": "2026/07/13", "manejo_interno_secuencia": "SI" },
  "documento_modificado": {
    "codigo_documento_sustento": 1,
    "numero_documento_sustento": 122,
    "fecha_documento_sustento": "2026/07/01",
    "motivo": "Devolucion de producto defectuoso",
    "anula_comprobante": "NO"
  },
  "comprador": {
    "tipo_identificacion": "05",
    "identificacion": "1712345678",
    "razon_social": "JUAN PEREZ LOPEZ",
    "direccion": "Av. Amazonas N34-56, Quito",
    "correo": "juan.perez@ejemplo.com"
  },
  "items": [
    {
      "codigo_principal": "PROD-001",
      "descripcion": "Laptop HP 15 Core i5",
      "cantidad": 1,
      "precio_unitario": 850.00,
      "tipoproducto": 1,
      "tipo_iva": 4
    }
  ],
  "informacion_adicional": [ { "nombre": "Motivo", "detalle": "Producto defectuoso" } ]
}

Respuesta · éxito

{ "creado": true,
  "claveacceso": "2607…49 dígitos" }

Respuesta · error

{ "creado": false,
  "errors": [ "El campo items es
  obligatorio." ] }

Request · JSON POST

POST /plataforma/api/v2/debito/emision

{
  "api_key": "TU_API_KEY",
  "codigoDoc": "05",
  "emisor": { "fecha_emision": "2026/07/13", "manejo_interno_secuencia": "SI" },
  "documento_modificado": {
    "codigo_documento_sustento": 1,
    "numero_documento_sustento": 118,
    "fecha_documento_sustento": "2026/06/20"
  },
  "comprador": {
    "tipo_identificacion": "04",
    "identificacion": "1790012345001",
    "razon_social": "COMERCIAL XYZ CIA LTDA",
    "direccion": "Av. 6 de Diciembre y Colon, Quito",
    "correo": "pagos@xyz.com"
  },
  "modificaciones": [
    { "razon_modificacion": "Interes por mora", "valor_modificacion": 25.00, "tipo_modificacion": 4 }
  ],
  "pagos": [ { "tipo": "20", "total": 28.75, "tiempo": "dias", "plazo": 15 } ]
}

Respuesta · éxito

{ "creado": true,
  "claveacceso": "2607…49 dígitos" }

Respuesta · error

{ "creado": false,
  "errors": [ "El campo items es
  obligatorio." ] }

Request · JSON POST

POST /plataforma/api/v2/retencion/emision

{
  "api_key": "TU_API_KEY",
  "codigoDoc": "07",
  "emisor": { "fecha_emision": "2026/07/13", "manejo_interno_secuencia": "SI" },
  "proveedor": {
    "tipo_identificacion": "04",
    "identificacion": "1790012345001",
    "razon_social": "PROVEEDORA NACIONAL S.A.",
    "direccion": "Av. Eloy Alfaro N45-12, Quito",
    "correo": "facturacion@proveedora.com"
  },
  "retenciones": [
    {
      "base_imponible": 1000.00,
      "codigoimpuesto": 1,
      "codigo_retencion": "312",
      "porcentaje_retencion": 1.75,
      "valor_retenido": 17.50,
      "codigo_documento_sustento": "01",
      "numero_documento_sustento": "001001000000123",
      "fecha_documento_sustento": "2026/07/10"
    },
    {
      "base_imponible": 150.00,
      "codigoimpuesto": 2,
      "codigo_retencion": "9",
      "porcentaje_retencion": 30,
      "valor_retenido": 45.00,
      "codigo_documento_sustento": "01",
      "numero_documento_sustento": "001001000000123",
      "fecha_documento_sustento": "2026/07/10"
    }
  ]
}

Respuesta · éxito

{ "creado": true,
  "claveacceso": "2607…49 dígitos" }

Respuesta · error

{ "creado": false,
  "errors": [ "El campo items es
  obligatorio." ] }

Request · JSON POST

POST /plataforma/api/v2/liquidacion/emision

{
  "api_key": "TU_API_KEY",
  "codigoDoc": "03",
  "emisor": { "fecha_emision": "2026/07/13", "manejo_interno_secuencia": "SI" },
  "proveedor": {
    "tipo_identificacion": "05",
    "identificacion": "1712345678",
    "razon_social": "AGRICULTOR SIN RUC",
    "direccion": "Comunidad El Rosario, Cotopaxi",
    "correo": "agricultor@ejemplo.com"
  },
  "items": [
    {
      "codigo_principal": "PAPA-01",
      "descripcion": "Quintal de papa chola",
      "cantidad": 20,
      "precio_unitario": 15.00,
      "tipoproducto": 1,
      "tipo_iva": 0
    }
  ],
  "pagos": [ { "tipo": "01", "total": 300.00, "tiempo": "dias", "plazo": 0 } ]
}

Respuesta · éxito

{ "creado": true,
  "claveacceso": "2607…49 dígitos" }

Respuesta · error

{ "creado": false,
  "errors": [ "El campo items es
  obligatorio." ] }

Request · JSON POST

POST /plataforma/api/v2/guia/emision

{
  "api_key": "TU_API_KEY",
  "codigoDoc": "06",
  "emisor": { "fecha_emision": "2026/07/13", "manejo_interno_secuencia": "SI" },
  "transportista": {
    "tipo_identificacion": "04",
    "identificacion": "1790055566001",
    "razon_social": "TRANSPORTES RAPIDOS CIA LTDA",
    "direccion": "Panamericana Norte Km 5, Quito"
  },
  "destinatario": {
    "tipo_identificacion": "04",
    "identificacion": "0990012345001",
    "razon_social": "DISTRIBUIDORA GUAYAS S.A.",
    "direccion": "Av. Las Americas, Guayaquil"
  },
  "traslado": {
    "fecha_inicio_transporte": "2026/07/13",
    "fecha_fin_transporte": "2026/07/14",
    "direccion_destino": "Av. Las Americas, Guayaquil",
    "ruta": "Quito - Guayaquil via E25",
    "motivo_traslado": "Venta"
  },
  "items": [
    {
      "cantidad": 50,
      "codigo_principal": "PROD-001",
      "descripcion": "Laptop HP 15 Core i5",
      "unidad_medida": 1
    }
  ]
}

Respuesta · éxito

{ "creado": true,
  "claveacceso": "2607…49 dígitos" }

Respuesta · error

{ "creado": false,
  "errors": [ "El campo items es
  obligatorio." ] }

Referencia SRI

Códigos que usa la API

Tipo de identificación

`04`	RUC (13 dígitos)
`05`	Cédula (10 dígitos)
`06`	Pasaporte
`07`	Consumidor final
`08`	Identificación del exterior
`09`	Placa

Tarifa de IVA (tipo_iva)

`0`	0%
`4`	15%
`3`	14%
`5`	5%
`8`	8% (turístico)
`10`	13%
`6`	No objeto de IVA
`7`	Exento de IVA

Formas de pago (tipo)

`01`	Efectivo / sin sistema financiero
`16`	Tarjeta de débito
`17`	Dinero electrónico
`18`	Tarjeta prepago
`19`	Tarjeta de crédito
`20`	Otros con sistema financiero
`21`	Endoso de títulos

Empieza a integrar hoy

Crea tu cuenta, obtén tu api_key y emite tu primer comprobante de prueba en minutos.

Crear cuenta gratis Hablar con un técnico