Saltar al contenido
DevFact

Documentación

Claves, versiones y límites

Claves de prueba y de producción, permisos, versión de la API, formatos y límites.

Claves API

Toda petición lleva tu clave en la cabecera Authorization: Bearer. Las creas y revocas en Claves API; el secreto se muestra una sola vez.

  • fk_test_…Emite siempre en pruebas (SRI simulado o ambiente de pruebas del SRI), aunque el emisor ya esté en producción. Para desarrollo y CI.
  • fk_live_…Emite en el ambiente del emisor: en producción, con validez tributaria. Sólo se crea con la verificación en dos pasos activa.
GET /v1/emisores
curl "https://api.devfact.fonles.com/v1/emisores" \
  -H "Authorization: Bearer $DEVFACT_API_KEY"
Nunca pongas una clave en el navegador, en una app móvil ni en un repositorio. Llama a la API desde tu servidor. Para agentes de IA usa el servidor MCP, que usa OAuth.

Permisos

  • emitirEmitir comprobantes, reintentarlos, reenviar el correo y anularlos.
  • consultarConsultar y listar comprobantes, descargar el XML y el RIDE.
  • adminConfigurar emisores, firmas, secuenciales, webhooks y claves.

Una clave sólo de lectura (por ejemplo para un tablero o un contador) lleva sólo consultar.

Versiones

La API se versiona por fecha. Cada clave queda fijada a la versión vigente al crearla (hoy 2026-11-01) y toda respuesta trae la cabecera Fk-Version. Puedes fijarla tú en cada petición con esa misma cabecera. Los cambios compatibles (campos o endpoints nuevos) llegan sin versión nueva: ignora los campos que no conozcas.

Formatos

  • MontosTexto decimal: "10.50". Los totales se redondean half-up a 2 decimales.
  • CantidadesHasta 6 decimales: 2, "6.5".
  • FechasAAAA-MM-DD. La fecha de emisión por defecto es hoy en Ecuador.
  • NúmerosEstablecimiento-punto-secuencial: 001-001-000000123.

Tipos de identificación del comprador:

  • cedulaPersonas con cédula ecuatoriana (10 dígitos).
  • rucPersonas naturales o sociedades con RUC (13 dígitos).
  • pasaporteExtranjeros con pasaporte.
  • exteriorIdentificación tributaria del exterior.
  • consumidorFinalLo mismo que no enviar comprador: 9999999999999, hasta USD 50.

Formas de pago (también se aceptan los códigos 01, 16, 19, 20… de la ficha del SRI):

  • efectivo01 · Sin utilización del sistema financiero
  • tarjetaDebito16
  • tarjetaCredito19
  • transferencia20 · Otros con utilización del sistema financiero
  • dineroElectronico17
  • tarjetaPrepago18
  • compensacion15 · Compensación de deudas
  • endoso21 · Endoso de títulos

Tarifas de IVA de cada ítem:

  • 15Tarifa general.
  • 5Materiales de construcción (con su código de la Tabla 31 en codigoAuxiliar).
  • 8Servicios turísticos en los feriados que fije un decreto.
  • 0Bienes y servicios con tarifa 0 % (alimentos básicos, medicinas, libros…).
  • noObjetoNo objeto de IVA.
  • exentoExento de IVA.
  • 12, 14Sólo en notas de crédito y débito sobre facturas antiguas.

Límites

  • 300 peticiones por minuto por clave. Si te pasas: 429 LIMITE_EXCEDIDO con Retry-After.
  • Hasta 2 MiB por comprobante (miles de ítems).
  • Plan Gratis: 50 comprobantes en producción al año. Al llegar al tope la emisión en producción responde 403 LIMITE_ANUAL_ALCANZADO; las pruebas no cuentan.

URL base de la API: https://api.devfact.fonles.com.