Recursos
Códigos de ticket
Cada ticket termina en un código de resultado: facturado, ilegible, expirado, comercio que no responde… Este catálogo (endpoint GetTicketCodes) es la base para interpretar el estado de un ticket en tu integración y comunicárselo a tus usuarios.
Los códigos con isSuccessCode: true cierran
el ticket con factura (o confirman que ya estaba facturado); el resto explica por qué no se pudo
recuperar y qué debe corregir el usuario. El campo userMessage
trae el texto listo para mostrar al usuario final.
Ticket
| ID | Resumen | Descripción y mensaje al usuario | ¿Éxito? |
|---|---|---|---|
1 | Ticket facturado exitosamente | El ticket fue procesado exitosamente por Fotofacturas. “¡Hola! Este ticket fue facturado exitosamente.” | Sí |
2 | Ticket facturado previamente | El ticket ya fue procesado previamente por Fotofacturas o por otro medio. “¡Hola! Este ticket ya fue facturado anteriormente. Cada ticket solo puede facturarse una vez. ¡Gracias!” | Sí |
4 | Ticket expirado | El ticket fue subido fuera del período de facturación vigente del comercio. “El ticket fue subido fuera del período de facturación vigente del comercio.” | No |
3 | No es ticket de compra | La imagen corresponde a un voucher o comprobante de pago, no a un ticket de venta. “¡Hola! La imagen corresponde a un comprobante de pago o voucher, no a un ticket de compra. Por favor sube el ticket de venta que te entregó el comercio. ¡Gracias!” | No |
5 | Comercio extranjero | El ticket no corresponde a un comercio mexicano. “El ticket no corresponde a un comercio mexicano.” | No |
Imagen
| ID | Resumen | Descripción y mensaje al usuario | ¿Éxito? |
|---|---|---|---|
7 | Ticket ilegible | La imagen del ticket no permite extraer los datos necesarios. “¡Hola! No podemos leer la información del ticket. Por favor sube una foto más clara y nítida del ticket completo. ¡Gracias!” | No |
8 | Ticket incompleto | La imagen no muestra el ticket completo o algunos datos están tapados. “¡Hola! Por favor sube nuevamente una foto donde salga tu ticket completo con todos los datos legibles, evita doblar, arrugar, tapar o romper tus tickets. ¡Gracias!” | No |
Datos fiscales
| ID | Resumen | Descripción y mensaje al usuario | ¿Éxito? |
|---|---|---|---|
6 | Datos de facturación incorrectos | Los datos fiscales del receptor (RFC, régimen fiscal, CP) son inválidos o están incompletos. “¡Hola! No pudimos generar tu factura porque tus datos fiscales están incorrectos. Por favor sube tu constancia de situación fiscal vigente (menos de 3 meses) y vuelve a subir tu ticket. ¡Gracias!” | No |
Comercio
| ID | Resumen | Descripción y mensaje al usuario | ¿Éxito? |
|---|---|---|---|
12 | Error en portal de facturación | El portal del comercio devolvió un error durante el procesamiento. “¡Hola! El portal de facturación del comercio generó un error al procesar tu solicitud. Reintentaremos más tarde. ¡Gracias por tu paciencia!” | No |
13 | Contacto del comercio no encontrado | No se encontró información de contacto del comercio para gestionar la factura. “¡Hola! No encontramos información de contacto del comercio. Si tienes teléfono o correo del comercio, inclúyelos junto con la foto del ticket. ¡Gracias!” | No |
11 | Comercio no responde | El comercio no respondió a los intentos de contacto tras múltiples reintentos. “¡Hola! No pudimos generar tu factura porque el comercio no respondió a nuestros intentos de contacto. Te recomendamos elegir comercios que faciliten el proceso de facturación. ¡Gracias!” | No |