API Enterprise

Documentación del API Enterprise

API REST para integrar la recuperación de facturas de Fotofacturas en tu producto: tu sistema sube la foto de un ticket y recibe el CFDI 4.0 (PDF y XML) que emite el comercio.

Fotofacturas recupera facturas: identifica el comercio del ticket y gestiona la facturación con él (portal, correo o teléfono) hasta obtener el CFDI. No emitimos facturas ni somos un PAC — la factura la emite el comercio; esta API la consigue y te la entrega.

La referencia cubre 20 endpoints en 5 grupos, todos bajo https://api.fotofacturas.ai/B2B/, con autenticación Bearer y un envelope de respuesta común (FFResponse).

Quickstart

  1. 1.Obtén tu token

    El acceso al API Enterprise se habilita por cuenta. Si aún no tienes credenciales, solicita acceso.

  2. 2.Prueba la conexión

    Un GET a MiscellaneousV1/Test confirma que la API está activa y que tu token es válido.

    cURL 
    curl "https://api.fotofacturas.ai/B2B/MiscellaneousV1/Test" \
  -H "Authorization: Bearer $FF_API_TOKEN"
    Respuesta · 200 OK 
    {
  "isSuccess": true,
  "message": "API funcionando correctamente"
}

  3. 3.Sube tu primer ticket

    Con CreateTicket envías la foto por multipart/form-data junto con el contexto fiscal del usuario, y consultas el resultado con GetTicketById.

Referencia

Tickets

Sube la foto del ticket (CreateTicket, multipart) y consulta estado, PDF y XML.

Usuarios

Altas, actualizaciones, estado y carga de la constancia de situación fiscal.

Asociaciones

Organiza a tus usuarios en jerarquías: matriz, sucursales, equipos.

Reportes

Tickets por día y resumen mensual: procesados, en espera, montos e IVA.

Catálogos

Test, información de la cuenta, métodos de pago, regímenes y usos de CFDI.

Códigos de ticket

Los códigos de resultado de un ticket: éxito, imagen, datos fiscales y comercio.

¿Integras con un agente de IA? Toda la referencia está disponible en texto plano en /docs/llms.txt.