Política de uso justo de la API

Esta política explica cuánto tráfico rechazado incluye tu cuenta en la API, cómo te avisamos si tu integración lo rebasa y qué pasa con el excedente. Nuestro objetivo es ayudarte a corregirlo a tiempo: la gran mayoría de las cuentas nunca llega al límite.

En resumen:

• Cada cuenta incluye hasta 10,000 respuestas de rechazo al día sin costo.
• Si tu integración rebasa ese límite, tienes 10 días de cortesía completos para corregirlo, sin ningún cargo, y te enviamos hasta 4 avisos con el detalle técnico.
• Si pasado ese plazo el exceso continúa, el excedente se cobra a $2.00 MXN más IVA por cada 1,000 respuestas, solo por los días en que se rebasa el límite.
• Las órdenes quedan pendientes en Mi Cuenta y las pagas tú: nunca se cargan de forma automática a una tarjeta.

1. Objeto y alcance

La presente Política de uso justo de la API (la "Política") forma parte integrante de los Términos y condiciones de Factura Digital, conforme a su Cláusula 10, inciso d). Los términos que inician con mayúscula tienen el significado que les dan los Términos.

Aplica a las peticiones que tu integración envía a la API de Factura Digital (versión 5, autenticada con el encabezado X-Api-Key) con la llave de tu cuenta. Su propósito es mantener la API ágil y disponible para todos los Usuarios y ayudarte a detectar a tiempo una integración que reenvía peticiones que ya fueron rechazadas.

2. Qué es el tráfico rechazado

Una petición rechazada es la que la API responde con un código HTTP de la familia 4xx (del 400 al 499): la petición llegó, pero no se pudo atender tal como venía. Por ejemplo, porque le faltan datos o alguno es inválido, porque el comprobante ya se había timbrado o porque la cuenta no tiene créditos disponibles.

Un rechazo ocasional es normal y forma parte de cualquier integración. El problema aparece cuando un sistema reenvía de forma automática la misma petición una y otra vez: la respuesta siempre es la misma, nada se corrige y cada intento consume capacidad compartida de la Plataforma (servidores, base de datos y validaciones) que también usan los demás Usuarios.

3. Qué cuenta y qué no cuenta

a) Lo que cuenta

Cuentan las respuestas 4xx a las peticiones autenticadas con la llave de tu cuenta, de cualquier endpoint de la API, sumadas por día.

También cuentan los rechazos que dependen del estado de tu cuenta, por ejemplo: sin créditos o timbres disponibles (código 601), sin certificado de sello digital (CSD) cargado (código 602) o una serie sin rango de folios configurado (No folio range found). Se corrigen desde tu cuenta y, mientras no se corrigen, cada reintento vuelve a rechazarse. Estos rechazos nunca quedan sujetos al freno de la sección 9.

b) Lo que no cuenta

• Las respuestas exitosas (2xx) y los errores del servidor (5xx).
• Los rechazos que no dependen de tu integración: las fallas nuestras o de nuestros proveedores y los errores de captura de los datos fiscales, por ejemplo:
  • cuando el PAC no le respondió a la API a tiempo o la conexión se cortó (código 5034).
  • cuando no fue posible conectar con el PAC (código 5037).
  • los rechazos del SAT por los datos fiscales capturados en el comprobante, como el nombre, el régimen, el código postal o el RFC del receptor y el uso del CFDI (reglas CFDI40xxx).
  • los comprobantes que no cumplen con el esquema del SAT por los datos capturados, por ejemplo un RFC mal formado (código 702).
  • las fallas del proveedor externo de los servicios de validación (v5/validator), códigos 401, 0 (sin respuesta), 500, 503 y 504.
  • las fallas del proveedor externo de los servicios de validación (v5/validator/lco), código 502.
• Las peticiones que hace la propia Plataforma en nombre de tus clientes, como las del portal de autofacturación y los kioskos.
• Las peticiones con una llave inválida o inexistente, porque no se asocian a ninguna cuenta.
• El tráfico de las cuentas propias de Factura Digital, que usamos para operar y probar la Plataforma.

Si crees que en tu conteo aparece un rechazo que se debió a una falla nuestra, escríbenos y lo revisamos contigo (sección 8).

4. Límite diario incluido

Cada cuenta incluye hasta 10,000 respuestas de rechazo por día, sin costo y sin ningún trámite. El día es el día natural en la hora del centro de México, y el conteo es por cuenta: suma todos los endpoints de la API.

Mientras tu tráfico rechazado se mantenga en ese límite o por debajo, esta Política no tiene ningún efecto para ti.

5. Días de cortesía y avisos

El primer día en que tu cuenta rebasa el límite es el día 1 de un periodo de 10 días de cortesía completos. Durante esos días no se genera ningún cargo, aunque el tráfico siga por encima del límite.

En ese periodo te enviamos hasta 4 avisos por correo, los días 1, 4, 7 y 9 del periodo, siempre que ese día el tráfico haya estado por encima del límite. Cada aviso llega al día siguiente del día revisado e incluye el detalle técnico de ese día (endpoints, códigos y motivos más frecuentes, orígenes y referencias de ejemplo), cómo corregirlo, los días de cortesía que quedan y la fecha a partir de la cual se generaría un cargo. El último, previsto para el día 9, es el aviso final.

Los avisos se envían a los correos registrados de tu cuenta y a los contactos técnicos que registres en la sección API y desarrolladores de la Plataforma (hasta 3 correos).

a) Cuando el tráfico se corrige

Si tu tráfico rechazado queda en el límite o por debajo durante 2 días seguidos, damos el caso por resuelto, te lo confirmamos por correo y dejan de generarse cargos. Si se resuelve dentro de los días de cortesía, no se genera ningún cargo.

b) Si el exceso regresa

Si dentro de los 30 días siguientes a que se dé por resuelto el tráfico vuelve a rebasar el límite, te avisamos y el periodo continúa con su fecha de inicio original: los días de cortesía no se reinician. Si ya se generaban cargos, se reanudan a partir del día en que recibas ese aviso. Pasado ese plazo, un nuevo exceso inicia un periodo nuevo, con sus propios días de cortesía.

6. Cargo por el excedente

A partir del día 11 del periodo, y nunca antes del día siguiente a que recibas el aviso final, cada día en que el tráfico rechazado de tu cuenta supere el límite genera un cargo de $2.00 MXN más IVA por cada 1,000 respuestas por encima de 10,000.

• El cargo se calcula sobre el número exacto de respuestas excedentes, en proporción, no por bloques completos de 1,000.
• Solo generan cargo los días en que se rebasa el límite; los días en que el tráfico queda en el límite o por debajo no generan cargo.
• Los días 1 a 10 del periodo nunca se cobran.
• Si el aviso final no se pudo entregar, lo reintentamos cada día mientras el tráfico siga por encima del límite, y no se genera ningún cargo antes de que lo recibas.

Por ejemplo, un día con 25,000 respuestas de rechazo tiene 15,000 por encima del límite y genera un cargo de $30.00 MXN más IVA.

7. Órdenes y pago

Los cargos diarios se agrupan en órdenes de pago:

• La primera orden se genera al día siguiente de tu primer día con cargo, junto con el cargo de ese día, si su importe alcanza $20.00 MXN sin IVA. Si no lo alcanza, el importe se acumula a la siguiente orden.
• Después, el día 1 de cada mes se genera una orden con los cargos del mes anterior que no se hayan incluido en otra. Si su importe no alcanza $20.00 MXN sin IVA, se acumula para el mes siguiente.

Te avisamos por correo cuando una orden está lista. Las órdenes quedan pendientes en Mi Cuenta y las pagas tú, con tarjeta, en OXXO o por SPEI, desde el correo de la orden o desde el aviso en el Resumen de Mi Cuenta. Nunca se cargan de forma automática a una tarjeta guardada.

Una vez pagada, puedes generar la factura (CFDI) de la orden en Mi Cuenta › Suscripción › Compras y facturas, dentro del mismo mes calendario del pago.

8. Aclaraciones, negociación y cancelación

Si consideras que un cargo no corresponde, si el excedente se debió a una situación extraordinaria o si prefieres acordar el monto o la forma de pago, escríbenos a soporte@facturadigital.com.mx, antes o después de que se genere la orden. Revisamos cada caso y, cuando se justifique, podemos ajustar o cancelar la orden. Si un rechazo se debió a una falla nuestra, lo revisamos y, si procede, cancelamos la orden o el cargo correspondiente. Una orden cancelada no se cobra.

Una orden pendiente, por sí sola, no bloquea tu cuenta ni detiene tus peticiones nuevas y válidas.

9. Freno de reintentos idénticos

El freno de reintentos idénticos nunca se activa de forma automática. Factura Digital puede activarlo de forma manual, solo para tu cuenta, cuando una orden de esta Política sigue pendiente de pago y el tráfico rechazado continúa. Si lo activamos, te lo avisamos por correo ese mismo día y, si el correo no sale, lo reintentamos.

Mientras está activo, la API responde con un error 429 (código 4290) a cualquier petición idéntica a otra que la API rechazó, con el freno ya activo, en las últimas 24 horas. Para decidir si es idéntica se comparan el método, la dirección completa (con sus parámetros), los encabezados que envía tu integración y el contenido. Los rechazos anteriores a la activación no cuentan para el freno, y las peticiones nuevas o distintas se procesan con normalidad: tu operación sigue funcionando.

Las respuestas 429 del freno también cuentan como tráfico rechazado (sección 3).

El freno nunca detiene los rechazos que dependen del estado de tu cuenta (sin créditos, sin CSD o sin rango de folios): en cuanto los corriges, el mismo reintento pasa.

El freno se retira solo en cuanto se registra el pago de la orden o su cancelación, y te lo confirmamos por correo. También podemos retirarlo antes, por ejemplo al acordar contigo el pago.

Incumplimiento reiterado

Si, después de los avisos de la sección 5 y de los cargos de la sección 6, tu integración sigue generando tráfico rechazado por encima del límite, ese tráfico se considera un uso abusivo del servicio conforme a la Cláusula 10 de los Términos y Condiciones. En ese caso, Factura Digital podrá restringir o suspender el acceso de tu cuenta a la API conforme a la Cláusula 16, previo aviso por correo a los contactos de tu cuenta. La suspensión del acceso a la API no afecta los comprobantes ya emitidos ni el acceso a la Plataforma desde el navegador.

10. Cómo evitarlo: buenas prácticas de reintentos

• No reintentes igual una petición rechazada con 4xx. La respuesta será la misma. Lee el código y el mensaje de la respuesta y corrige los datos, la configuración de tu cuenta o el flujo antes de volver a enviarla.
• Reintenta solo ante errores 5xx, tiempos de espera agotados o fallas de red, con espera exponencial (por ejemplo 1, 2, 4 y 8 minutos), una pequeña variación aleatoria entre intentos y un número máximo de intentos.
• Respeta el encabezado Retry-After cuando recibas un error 429.
• Usa una referencia única por operación (tu número de ticket, o tu serie y folio) y, antes de reintentar una operación cuya respuesta no llegó, verifica si ya quedó registrada en lugar de enviarla de nuevo. Así evitas duplicados y rechazos por un comprobante ya timbrado.
• Revisa las colas de reenvío de tu sistema y de cada sucursal o caja: marca como terminados los registros que la API ya respondió, aunque haya sido con un rechazo, y deja los rechazados para revisión.
• Vigila el volumen de rechazos en tu sistema: un aumento repentino suele ser la primera señal de un ciclo de reintentos.
• Prueba los cambios de tu integración en el Entorno Sandbox antes de llevarlos a Producción.
• Registra tus contactos técnicos en API y desarrolladores, para que los avisos lleguen a quien puede corregir la integración.

11. Cambios a esta Política

Factura Digital puede actualizar esta Política, incluidos el límite diario, los días de cortesía y de aviso, el precio y la orden mínima. Cada cambio se publica en esta página con una nueva versión y fecha, y se rige por la Cláusula 17 de los Términos y condiciones; los cambios de precio se avisan con la anticipación prevista en su Cláusula 6, inciso c).

12. Contacto

Si tienes dudas sobre esta Política o necesitas ayuda para revisar tu integración, escríbenos a soporte@facturadigital.com.mx con el RFC de tu cuenta. Con gusto lo revisamos contigo.