Documentación API

NexusFact es un motor de facturación electrónica de alto rendimiento diseñado para integradores. Nuestra API automatiza el proceso completo ante el SRI de Ecuador, eliminando la complejidad de la firma digital (XAdES-BES) y la comunicación SOAP.

ℹ️

Endpoint de Producción: https://api.nexusfact.com/
Endpoint de Pruebas: https://dev-api.nexusfact.com/

Pasos para Integrar

Obtén tu API Token desde el panel administrativo.
Sube tu firma electrónica .p12 y configura tu RUC.
Envía tus documentos en formato JSON; nosotros hacemos el resto.

Autenticación

Todas las peticiones a la API deben estar autenticadas mediante un Token de Portador (Bearer Token). Este token identifica tu cuenta y la empresa emisora vinculada.

POST /index.php?login=1

Parámetros de Entrada

Parámetro	Descripción
username Req	El RUC registrado de la empresa o nombre de usuario de acceso.
password Req	La contraseña de seguridad asignada.

Configuración de Empresa

Para que NexusFact pueda firmar y enviar tus documentos, debes configurar los parámetros técnicos de tu empresa. Este endpoint permite registrar una nueva empresa o actualizar una existente de forma dinámica.

POST /index.php?action=empresas

Parámetros del Endpoint

Campo	Tipo	Descripción
ruc Req	String	RUC de 13 dígitos. Sirve como identificador único para el sistema.
razon_social	String	Nombre legal de la empresa. Requerido obligatoriamente para registros nuevos.
direccion_matriz	String	Dirección tributaria principal que aparecerá en los comprobantes.
obligado_contabilidad	String	Indicar "SI" o "NO" según el estado tributario del emisor.
certificado_p12_path	String	Ruta del archivo de firma electrónica dentro del servidor o nombre del archivo cargado.
certificado_password	String	Contraseña de exportación del archivo certificado (.p12).
activo	Integer	1 para habilitar la empresa, 0 para deshabilitar la emisión.

💡

Actualización Inteligente: Si el RUC ya existe en la base de datos, el sistema realizará un UPDATE automático de los campos proporcionados. No es necesario enviar todos los campos para actualizar uno solo.

Requisitos de Firma Electrónica

Para garantizar una firma exitosa de los comprobantes, asegúrate de cumplir con lo siguiente:

Formato: El archivo debe ser obligatoriamente .p12 (PKCS#12).
Contraseña: Debes usar la contraseña de exportación que te entregó la entidad certificadora (Banco Central, Security Data, etc.).
Vigencia: El sistema rechazará firmas caducadas al momento de intentar emitir.

Emitir Factura

Crea un documento de factura (Tipo 01) en el SRI. El sistema manejará la generación del XML, la firma electrónica y el envío automático a los servicios del SRI.

POST /index.php

⚠️

Clave Acceso: Si no proporcionas una claveAcceso, el sistema generará una automáticamente siguiendo el estándar del SRI.

Estructura del Payload

Campo	Tipo	Descripción
tipo	String	Valor fijo: `"factura"`.
data	Object	Objeto con la información tributaria y detalles del documento.
fechaEmision	String	Formato `DD/MM/YYYY`.
importeTotal	Float	Valor total del comprobante con impuestos.

Notas de Crédito

Permite anular o modificar facturas ya autorizadas. El sistema valida automáticamente que la factura exista y que el monto de la NC no exceda el saldo disponible del documento original.

POST /index.php

Campo Específico	Descripción
numDocModificado	Número de factura original (Ej: 001-001-000000012).
valorModificacion	Monto a descontar o anular de la factura original.

Notas de Débito

Utilízalas para aumentar el valor de una factura emitida o cobrar intereses por mora. Requiere la referencia de la factura original.

POST /index.php

Campo Específico	Descripción
tipo	Debe ser `"notaDebito"`.
numDocModificado	Número de la factura que se modifica.

Comprobante de Retención

Genera retenciones de impuestos (IVA/Renta) aplicadas a tus proveedores. NexusFact soporta el nuevo estándar de retención que incluye el régimen del sujeto retenido.

POST /index.php

Campos Clave	Descripción
tipo	Debe ser `"retencion"`.
impuestos	Array con los códigos de impuesto, base imponible y porcentaje.

Guía de Remisión

Documenta el traslado de mercancías. Incluye datos del transportista, ruta de destino y los documentos que sustentan la mercancía transportada.

POST /index.php

Campo	Descripción
tipo	Debe ser `"guiaRemision"`.
dirPartida	Dirección de inicio del traslado.
transportista	Datos del conductor y placa del vehículo.

Liquidación de Compra

Emitida por adquisiciones de bienes o servicios a personas que no están obligadas a facturar o por reembolsos.

POST /index.php

Campo	Descripción
tipo	Debe ser `"liquidacion"`.

Consultar Estado

Obtén información detallada de un comprobante procesado, incluyendo su estado en el SRI y los mensajes de error en caso de rechazo.

GET /index.php?clave={CLAVE_ACCESO}

Consulta Avanzada SRI

Este endpoint realiza una búsqueda exhaustiva tanto en el ambiente de Pruebas como de Producción del SRI, además de devolver un resumen procesado del contenido del XML.

GET /index.php?action=consulta_sri&clave={CLAVE_ACCESO}

🔍

Versatilidad: Útil para validar documentos emitidos externamente o cuando no estás seguro de en qué ambiente se autorizó el documento.

Descargar RIDE (PDF)

Genera y descarga la representación impresa del comprobante (RIDE). Este endpoint devuelve el binario del PDF listo para visualización o impresión.

GET /index.php?clave={CLAVE_ACCESO}&pdf=1

Reintentar Pendientes

El sistema NexusFact gestiona automáticamente las intermitencias del SRI. Si un comprobante queda en estado RECIBIDA o EN PROCESAMIENTO por demasiado tiempo, puedes forzar una consulta masiva de autorización.

POST /index.php?retry=1

✅

Uso Sugerido: Se recomienda configurar un cronjob que invoque este endpoint cada 15 minutos para asegurar que ningún documento quede pendiente en períodos de alta carga del SRI.

Reemitir Documento

Si un documento fue rechazado definitivamente (por ejemplo, por errores en los datos del comprador) y necesitas emitirlo nuevamente con los mismos datos pero una nueva fecha o secuencial, este endpoint automatiza la tarea.

POST /index.php?reemitir={CLAVE_ACCESO_FALLIDA}

El sistema tomará el JSON original, actualizará la fecha de emisión al día de hoy y generará una nueva clave de acceso automáticamente.

cURL JavaScript

curl -X POST https://api.nexusfact.com/?login=1 \
  -H "Content-Type: application/json" \
  -d '{
    "username": "1712345678001",
    "password": "mi_clave_secreta"
  }'

Respuesta Exitosa

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiJ...",
  "user": {
    "ruc": "1712345678001"
  }
}

Config JSON

{
  "ruc": "1712345678001",
  "razon_social": "NexusFact S.A.",
  "nombre_comercial": "NexusFact",
  "direccion_matriz": "Av. Principal 123",
  "obligado_contabilidad": "SI",
  "certificado_p12_path": "certs/firma.p12",
  "certificado_password": "pass123",
  "activo": 1
}

Factura JSON

{
  "tipo": "factura",
  "data": {
    "fechaEmision": "05/03/2026",
    "razonSocialComprador": "JUAN PEREZ",
    "identificacionComprador": "1712345678",
    "direccionComprador": "Quito, Ecuador",
    "totalSinImpuestos": 10.00,
    "totalDescuento": 0.00,
    "importeTotal": 11.50,
    "pagos": [
      {
        "formaPago": "01",
        "total": 11.50
      }
    ],
    "detalles": [
      {
        "codigoPrincipal": "PROD-001",
        "descripcion": "SERVICIO TECNICO ESPECIALIZADO",
        "cantidad": 1,
        "precioUnitario": 10.00,
        "precioTotalSinImpuesto": 10.00,
        "impuestos": [
          {
            "codigo": "2",
            "codigoPorcentaje": "2",
            "tarifa": 15,
            "baseImponible": 10.00,
            "valor": 1.50
          }
        ]
      }
    ]
  }
}

Nota de Crédito

{
  "tipo": "notaCredito",
  "data": {
    "fechaEmision": "05/03/2026",
    "razonSocialComprador": "JUAN PEREZ",
    "identificacionComprador": "1712345678",
    "numDocModificado": "001-001-000000001",
    "fechaEmisionDocSustento": "01/03/2026",
    "valorModificacion": 11.50,
    "motivo": "Devolución total de servicios",
    "detalles": [
      {
        "descripcion": "SERVICIO DE CONSULTORIA",
        "cantidad": 1,
        "precioUnitario": 10.00,
        "precioTotalSinImpuesto": 10.00,
        "impuestos": [
          {
            "codigo": "2",
            "codigoPorcentaje": "2",
            "tarifa": 15,
            "baseImponible": 10.00,
            "valor": 1.50
          }
        ]
      }
    ]
  }
}

Retención JSON

{
  "tipo": "retencion",
  "data": {
    "identificacionSujetoRetenido": "1792049504001",
    "razonSocialSujetoRetenido": "PROVEEDOR S.A.",
    "periodoFiscal": "03/2026",
    "impuestos": [
      {
        "codigo": "1",
        "codigoRetencion": "312",
        "baseImponible": 100.00,
        "porcentajeRetener": 1.00,
        "valorRetenido": 1.00,
        "numDocSustento": "001-001-000000123",
        "fechaEmisionDocSustento": "01/03/2026"
      }
    ]
  }
}

Guía de Remisión

{
  "tipo": "guiaRemision",
  "data": {
    "dirPartida": "Av. Amazonas N-24",
    "razonSocialTransportista": "Transportes Logísticos",
    "rucTransportista": "1790000000001",
    "fechaIniTransporte": "05/03/2026",
    "fechaFinTransporte": "07/03/2026",
    "placa": "ABC-1234",
    "destinatarios": [
      {
        "identificacionDestinatario": "1712345678",
        "razonSocialDestinatario": "JUAN PEREZ",
        "dirDestinatario": "Quito Sur",
        "motivoTraslado": "Venta",
        "detalles": [
          {
            "codigoInterno": "P001",
            "descripcion": " PRODUCTO A",
            "cantidad": 10
          }
        ]
      }
    ]
  }
}

Nota de Débito

{
  "tipo": "notaDebito",
  "data": {
    "numDocModificado": "001-001-000000001",
    "motivo": "Intereses por mora",
    "valorModificacion": 2.50
  }
}

Liquidación de Compra

{
  "tipo": "liquidacion",
  "data": {
    "fechaEmision": "05/03/2026",
    "razonSocialProveedor": "JUAN PUEBLO",
    "identificacionProveedor": "1700000001",
    "importeTotal": 50.00,
    "pagos": [
      {
        "formaPago": "01",
        "total": 50.00
      }
    ],
    "detalles": [
      {
        "descripcion": "SERVICIO DE LIMPIEZA",
        "cantidad": 1,
        "precioUnitario": 50.00,
        "precioTotalSinImpuesto": 50.00,
        "impuestos": [
          {
            "codigo": "2",
            "codigoPorcentaje": "0",
            "baseImponible": 50.00,
            "valor": 0.00
          }
        ]
      }
    ]
  }
}

GET

curl -X GET \
  "https://api.nexusfact.com/?clave=0403202601179204950400120010010000000011234567819" \
  -H "Authorization: Bearer YOUR_TOKEN"

Consulta Avanzada

curl -X GET \
  "https://api.nexusfact.com/?action=consulta_sri&clave={CLAVE_ACCESO}"

Respuesta con Resumen

{
  "claveAcceso": "0403...",
  "estado": "AUTORIZADO",
  "resumen": {
    "razonSocial": "NEXUSFACT S.A.",
    "totalSinImpuestos": "10.00"
  }
}