Crear una prefactura self-service

Genera un link con QR para que el cliente final capture sus datos fiscales y se timbre en automático. Crear la prefactura no consume timbre: se cobra hasta que el CFDI se emite, así que una prefactura que nadie usa no te cuesta nada. Para abrir el link, el cliente necesita además la referencia que imprimas junto al QR. Si mandas cfdi.Fecha se ignora: el comprobante se emite cuando el cliente completa sus datos, y el SAT rechaza comprobantes con Fecha de más de 72 h.

Authentication

AuthorizationBearer

API key (uuid_live_* / uuid_sandbox_*) o token de Firebase.

Request

This endpoint expects an object.
referenciastringRequired

Tu propio identificador del ticket, orden o folio. Obligatorio: es el segundo factor que protege la prefactura. Imprímelo junto al QR. Se compara sin distinguir mayúsculas, acentos, espacios ni guiones.

cfdiobjectRequired

El CFDI SIN Receptor — esos son justo los datos que captura el cliente. Fecha se ignora y se fija al timbrar.

vigenciaSegundosintegerOptional

Cuánto dura el link. Default 86400, entre 300 y 2592000.

Response

Default Response
dataobjectOptional

Prefactura creada. Comparte url (o el QR de qrUrl) con el cliente final e imprime la referencia junto a el: sin la referencia no puede abrir el link.

Errors

400
Bad Request Error
403
Forbidden Error
500
Internal Server Error