Valores de los catálogos que aparecen en Fotofacturas.
Dirigido a: equipos técnicos que integran con la API o los webhooks. El significado de cada concepto está en Conceptos.
Los catálogos que se consultan con una API (formas de pago, regímenes fiscales, usos de CFDI, códigos del ticket y productos del SAT) son la fuente oficial: si un valor de esta página no coincide con lo que regresa la API, prevalece el de la API.
Ticket
Estatus del ticket (ticketStatusId)
| Id | Nombre (API) | App Enterprise | Grupo en reportes | Tipo |
|---|---|---|---|---|
| 1 | CREATED | Creado | En proceso | Inicial |
| 3 | AUTO INVOICING | Auto factura | En proceso | Intermedio |
| 5 | WAITING INVOICE EMAIL | Esperando correo con factura | En proceso | Intermedio |
| 6 | MANUAL REVIEW | Revisión manual | En proceso | Intermedio |
| 7 | ADVANCED REVIEW | Revisión avanzada | En proceso | Intermedio |
| 8 | WAITING MERCHANT | Esperando comercio | En proceso | Intermedio |
| 10 | UNSIGNABLE | No facturable | Rechazados | Final |
| 11 | SIGNED | Facturado | Facturados | Final |
Las transiciones entre estatus están en Flujo del ticket.
Código del ticket (ticketCodeId)
Catálogo oficial: GetTicketCodes (incluye la descripción, la categoría y el mensaje que ve el usuario).
| Id | Código | Se usa con el estatus |
|---|---|---|
| 1 | Creado (sin resultado) | En proceso |
| 2 | Facturado | 11 |
| 3 | Facturado previamente | 11 |
| 4 | No es un ticket de compra | 10 |
| 5 | Ticket vencido | 10 |
| 6 | Comercio extranjero | 10 |
| 7 | Datos de facturación inválidos | 10 |
| 8 | Ticket ilegible | 10 |
| 9 | Ticket incompleto | 10 |
| 10 | Requiere cuenta personal | 10 |
| 11 | Portal del comercio caído | 10 |
| 12 | El comercio no responde | 10 |
| 13 | Error en el portal de facturación | 10 |
| 14 | Contacto del comercio no encontrado | 10 |
| 15 | No identificado | 10 |
| 16 | Facturado previamente con otro RFC | 10 |
| 17 | Varios tickets en la imagen | 10 |
| 18 | Facturado sin archivos | 10 |
| 19 | No se pudo contactar al comercio | 10 |
Origen del ticket (ticketOriginId)
Canal por el que se subió el ticket. Viene en GetTicketById (ticketOriginId y ticketOrigin).
| Id | Origen | Canal |
|---|---|---|
| 1 | App | App móvil (iOS/Android). |
| 2 | Web App | Web app. |
| 3 | Web app business | Web app business. |
| 4 | API | API (CreateUserTicket, CreateAssociationTicket). |
| 5 | Embedded | Flujo embebido en el sitio de un socio B2B. |
| 6 | WhatsApp | WhatsApp. |
Método de facturación (invoiceMethod)
Cómo se obtuvo la factura. Viene en GetTicketById y solo tiene valor cuando el ticket ya se facturó.
| Id | Método | Significado |
|---|---|---|
| 1 | Manual | Un agente realizó el proceso. |
| 2 | Automática | Un bot facturó en el portal del comercio al primer intento. |
| 3 | Automática (reintento) | Un bot facturó después de uno o más intentos fallidos. |
| 4 | Automática con correcciones | Un bot facturó después de que un agente corrigió los datos. |
Plan
Tipo multi RFC (multiRfcType)
| Código API | BackOffice | Qué RFC puede usar un colaborador |
|---|---|---|
P | Padre | Los RFC de su asociación o, si no tiene activos, los de la asociación raíz. |
C | Hijo | Solo sus RFC propios. |
M | Mixto | Sus RFC propios y los RFC de asociación. |
Solo Fotofacturas puede modificar este valor.
Valores especiales de los límites
| Campo | null | 0 |
|---|---|---|
ticketsMonthlyLimit | Sin límite de grupo. | Nadie puede subir tickets. |
ticketsMonthlyLimitPerUser | Sin límite por colaborador. | Ningún colaborador puede subir tickets. |
multiRfcPerUser | — | Los colaboradores no pueden registrar RFC propios. |
multiRfcPerAssociation | — | No se pueden cargar RFC de asociación. |
Datos fiscales (SAT)
Forma de pago (ticketPaymentMethodId)
Catálogo oficial: GetTicketPaymentMethods (regresa solo las formas habilitadas). Valores más usados:
| Id | Forma de pago | Pide CardLastFour |
|---|---|---|
01 | Efectivo | No |
04 | Tarjeta de crédito | Sí |
28 | Tarjeta de débito | Sí |
29 | Tarjeta de servicios | No |
CardLastFour son los últimos 4 dígitos de la tarjeta, solo números.
Régimen fiscal (regimenFiscalId)
Catálogo oficial: GetRegimenFiscalAndCFDI, que además indica si aplica a persona física (isFisica) o moral (isMoral) y qué usos de CFDI admite cada régimen.
| Id | Régimen | Física | Moral |
|---|---|---|---|
| 601 | Régimen General de Ley Personas Morales | No | Sí |
| 603 | Régimen de Personas Morales con Fines no Lucrativos | No | Sí |
| 605 | Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios | Sí | No |
| 606 | Régimen de Arrendamiento | Sí | No |
| 607 | Régimen de Enajenación o Adquisición de Bienes | Sí | No |
| 608 | Régimen de los demás ingresos | Sí | No |
| 610 | Residentes en el Extranjero sin Establecimiento Permanente en México | Sí | Sí |
| 611 | Régimen de Ingresos por Dividendos (socios y accionistas) | Sí | No |
| 612 | Régimen de las Personas Físicas con Actividades Empresariales y Profesionales | Sí | No |
| 614 | Régimen de los ingresos por intereses | Sí | No |
| 615 | Régimen de los ingresos por obtención de premios | Sí | No |
| 616 | Sin obligaciones fiscales | Sí | No |
| 620 | Sociedades Cooperativas de Producción que optan por diferir sus ingresos | No | Sí |
| 621 | Régimen de Incorporación Fiscal | Sí | No |
| 622 | Régimen de Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras PM | No | Sí |
| 623 | Régimen de Opcional para Grupos de Sociedades | No | Sí |
| 624 | Régimen de los Coordinados | No | Sí |
| 625 | Régimen de las Actividades Empresariales con ingresos a través de Plataformas Tecnológicas | Sí | No |
| 626 | Régimen Simplificado de Confianza | Sí | Sí |
Uso de CFDI (usoCfdiId)
Catálogo oficial: GetRegimenFiscalAndCFDI (campo cfdi de cada régimen). El uso elegido debe ser válido para el régimen fiscal.
| Id | Uso |
|---|---|
| G01 | Adquisición de mercancías |
| G02 | Devoluciones, descuentos o bonificaciones |
| G03 | Gastos en general |
| I01 | Construcciones |
| I02 | Mobiliario y equipo de oficina por inversiones |
| I03 | Equipo de transporte |
| I04 | Equipo de computo y accesorios |
| I05 | Dados, troqueles, moldes, matrices y herramental |
| I06 | Comunicaciones telefónicas |
| I07 | Comunicaciones satelitales |
| I08 | Otra maquinaria y equipo |
| D01 | Honorarios médicos, dentales y gastos hospitalarios |
| D02 | Gastos médicos por incapacidad o discapacidad |
| D03 | Gastos funerales |
| D04 | Donativos |
| D05 | Intereses reales efectivamente pagados por créditos hipotecarios (casa habitación) |
| D06 | Aportaciones voluntarias al SAR |
| D07 | Primas por seguros de gastos médicos |
| D08 | Gastos de transportación escolar obligatoria |
| D09 | Depósitos en cuentas para el ahorro, primas que tengan como base planes de pensiones |
| D10 | Pagos por servicios educativos (colegiaturas) |
| S01 | Sin efectos fiscales |
| CP01 | Pagos |
| CN01 | Nómina |
Productos y servicios del SAT
Catálogo jerárquico División → Familia → Clase → Producto. Las claves son prefijos (división 01 → familia 0101 → clase 010101 → productos 01010101).
Se consulta con GetSatProductDivisions, GetSatProductFamilies, GetSatProductClasses y GetSatProducts; ver EnterpriseAPI.
Webhooks
Tipo de evento (eventType)
| Id | Nombre (X-FF-Event) | Cuándo se envía |
|---|---|---|
| 1 | ticket.invoiced | El ticket pasó a 11 SIGNED. |
| 2 | ticket.failed | El ticket pasó a 10 UNSIGNABLE. |
| 3 | ticket.status_changed | Cualquier cambio de estatus, incluida la creación. |
| — | ping | Evento de prueba de TestWebhook. No se configura ni queda en el historial. |
Estatus del evento (status)
| Id | Nombre | Significado |
|---|---|---|
| 1 | PENDING | Pendiente de envío o esperando reintento. |
| 2 | DELIVERED | Entregado (el servidor respondió 2xx). |
| 3 | FAILED | Se agotaron los intentos o el webhook se desactivó. |
El detalle está en Webhooks.