Planes y límites

El plan se define a nivel de organización y decide dos cosas: qué endpoints puedes usar y cuánto puedes emitir. Todos los planes reciben e-CF; solo Full Service emite.

	Receptor	Full Service 1	Full Service 2	Esencial
Recibir e-CF y acuse automático	Sí	Sí	Sí	Sí
Aprobación comercial	Sí	Sí	Sí	Sí
Consulta al directorio de la DGII	Sí	Sí	Sí	Sí
Emitir e-CF y anulaciones	—	Sí	Sí	Sí
Webhooks	—	Sí	Sí	Sí
Reportes 606 y 607	—	Sí	Sí	Sí
Documentos por mes	1,000	2,000	5,000	2,000 por empresa
Peticiones por minuto	30	60	300	60

Esencial se paga en línea desde el dashboard (Facturación): RD$500 al mes con dos empresas en producción incluidas, RD$500 por cada empresa adicional y RD$1,500 por empresa con el conector Odoo, ITBIS incluido. Activar o cancelar empresas ajusta la mensualidad sola: al agregar, ese día se cobra la parte proporcional hasta el próximo corte; al quitar, queda un crédito para la próxima factura.

Conector Odoo es para quien factura desde Odoo: RD$1,500 al mes por cada empresa en producción, sin base, ITBIS incluido y con las mismas funciones y cuota que Esencial.

Descargar el PDF, el XML y el QR de un documento está disponible en todos los planes: un comprobante recibido también necesita esos artefactos.

Qué pasa al chocar con un límite

Una funcionalidad fuera de tu plan devuelve 403 diciendo cuál falta:

403 Response

{
  "error": "Your plan (Receptor) does not include this feature.",
  "feature": "emission",
  "plan": "receptor"
}

La cuota mensual agotada devuelve 429:

429 Response

{
  "error": "Monthly document limit reached",
  "limit": 1000
}

Ese 429 no lleva Retry-After y no se resuelve esperando: hasta el próximo periodo, o hasta ampliar el plan, seguirá igual. Distínguelo del 429 por ritmo, que sí trae la cabecera. Ver Errores y rechazos.

En el plan Esencial la cuota no bloquea: al pasarla se sigue emitiendo y te contactamos para ajustar el plan.

Si la mensualidad lleva más de siete días sin pagarse, la emisión nueva se suspende con 402. Recibir y consultar comprobantes sigue funcionando, y al pagar la emisión vuelve de inmediato:

402 Response

{
  "error": "La emisión está suspendida por falta de pago. Actualice su método de pago en el dashboard, en Facturación.",
  "code": "SUBSCRIPTION_SUSPENDED"
}

Consultar tu consumo

curl -H "X-API-Key: ffs_live_ejemplodeclavenoreal000000000000000000" \
  https://api.fiscalflowsupport.com/api/v1/account

200 Response

{
  "success": true,
  "data": {
    "slug": "mi-organizacion",
    "name": "Mi Organización SRL",
    "status": "active",
    "environment": "ecf",
    "companies": [
      {
        "uuid": "9f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
        "legal_name": "Mi Empresa SRL",
        "rnc": "101000000",
        "monthly_document_limit": 2000,
        "documents_used_this_month": 412,
        "documents_remaining": 1588,
        "status": "active"
      }
    ]
  }
}

El consumo se cuenta por mes calendario y solo del ambiente de la key que uses: una key de pruebas no te muestra el gasto de producción. Un buen hábito es revisarlo a diario y avisar antes de quedarte sin cuota, no después.

Empresas de pruebas

Una organización puede tener hasta tres empresas marcadas como sandbox, con un tope de 200 documentos al mes y 10 peticiones por minuto. Sirven para desarrollar contra testecf sin consumir la cuota real. Una key ffs_cert_ o ffs_live_ contra una empresa de pruebas se rechaza con 403.