Folio de factura: ahora tú tienes el control en Fiscalapi
15 de julio de 2026
Una de las solicitudes que más nos han repetido ustedes, los que integran facturación todos los días, tienen que ver con el folio de factura. La primera: poder enviar su propio folio en lugar de aceptar el que asignamos nosotros. La segunda: que el folio automático deje de saltarse números cuando una factura es rechazada. Hoy las dos están en producción.
Ninguna requiere que toques tu integración. Si hoy no envías el folio, todo sigue funcionando igual que siempre. Pero si llevas meses esperando alguna de estas dos mejoras, sigue leyendo.
Envía tu propio folio de factura
Hasta ahora, el folio lo generaba Fiscalapi por ti. Enviar el campo number en tu solicitud producía un error de validación. Eso cambió: el campo ya es opcional y tú decides.
Folio de la factura. Opcional. Si lo envías, tu factura se timbra exactamente con ese folio. Si lo omites o lo envías vacío, Fiscalapi lo genera automáticamente como siempre. Acepta de 1 a 40 caracteres conforme al estándar del SAT, así que puedes usar folios numéricos, alfanuméricos o con tu propio formato.
¿Por qué importa? Migración, sobre todo. Hemos acompañado muchas migraciones desde otros sistemas de facturación y el patrón se repite: la empresa ya emitió 500 facturas en su sistema anterior y lo natural es que la primera factura con Fiscalapi sea la 501, no la número 1. Antes eso no se podía. Ahora envías la serie que ya usabas y number con el valor "501", y tu consecutivo continúa como si nada hubiera pasado.
El otro caso es control interno. Muchos negocios administran sus propias series y folios como parte de sus procesos contables, y necesitan que la factura salga con el número que su sistema asignó, no con uno ajeno. Ese escenario ya está cubierto.
Los detalles del campo y ejemplos completos de emisión están en la documentación de Fiscalapi, con implementaciones listas para usar en los SDKs oficiales.
Folio automático sin saltos en la numeración
Esta mejora es para ti si prefieres que Fiscalapi siga generando el folio, pero te molestaba encontrar huecos en tu numeración. Nos lo reportaron muchas veces y tenían razón en molestarse.
Antes
Tu última factura timbrada era la 500. Enviabas la siguiente con un RFC incorrecto y era rechazada: el folio 501 quedaba quemado. Al corregir y reenviar, la factura salía como 502. Resultado: 500, 502, y un hueco difícil de explicar ante tus clientes o en una auditoría interna.
Ahora
Mismo escenario: la solicitud es rechazada por un dato erróneo. Corriges, reenvías, y tu factura se timbra como 501. El folio automático solo se consume cuando el timbrado es exitoso, así que tu numeración queda continua: 500, 501, 502.
El motivo del comportamiento anterior era que el folio se asignaba al recibir tu solicitud, antes de conocer el resultado del timbrado. Un rechazo por código postal inválido, un RFC mal capturado o cualquier dato erróneo dejaba ese número inservible. Eso ya no ocurre: si el timbrado falla, el folio queda disponible de nuevo para tu siguiente intento.
Estos cambios son 100% retrocompatibles. No hay cambios en el formato del request ni del response, y tus integraciones actuales siguen operando sin modificación alguna. Si no envías folio, se genera automáticamente como siempre, y ahora además sin saltos.
Folio de factura y folio fiscal no son lo mismo
Vale la pena aclararlo porque genera confusión constante en soporte. El folio de factura es el consecutivo interno que tú o Fiscalapi asignan al comprobante, el que aparece junto a la serie. El folio fiscal es el UUID de 36 caracteres que el PAC asigna al timbrar, y ese no lo controla nadie más que el PAC. Esta liberación te da control sobre el primero; el segundo sigue funcionando exactamente igual. Si quieres entender a fondo el UUID, lo desarmamos completo en la guía de folio fiscal.
Preguntas frecuentes
Gracias a todos los que nos pidieron estas mejoras, insistieron y nos compartieron sus casos reales de migración. Ese contexto fue el que definió cómo se comporta el campo. Si hay algo más que el folio de factura debería hacer y no hace, escríbenos: las dos funciones de este release salieron exactamente de ahí.