Entornos

El API de Factura Online cuenta con dos entornos disponibles:

Sandbox

Host: https://sandbox.facturaonline.com.mx/api

Es un entorno de pruebas que simula el funcionamiento de nuestra API en producción, generando CFDIs sin validez fiscal.

Producción

Host: https://facturaonline.com.mx/api

Es el host para realizar el timbrado real, te recomendamos hacer pruebas en la versión sandbox primero, ya que los CFDIs generados en este entorno si tienen validez fiscal.

Composición de la URL

Independientemente del entorno en el que estes trabajando, la estructura de la URL se compone de la siguiente forma:

• Host = sandbox https://sandbox.facturaonline.com.mx/api o producción https://facturaonline.com.mx/api
• Version = Versión de la API = api/v1, api/v3 ó api/v4
• Endpoint = Describe el método al que se está haciendo la petición.

Por ejemplo, para traer listado de facturas en el entorno de producción la url es la siguiente:

https://facturaonline.com.mx/api/v1/invoices

Límite de peticiones (Rate Limit)

Con el fin de garantizar la disponibilidad y estabilidad del servicio en los entornos, se aplica una política de restricción de peticiones (Rate Limiting):

• Límite máximo: 350 peticiones por cada ventana de 10 segundos.
• Bloqueo temporal: Si se excede esta cuota, el sistema bloqueará automáticamente las peticiones entrantes durante 60 segundos, retornando un error 429 Too Many Requests.