Referencia del API · ReportV1

Reportes

Métricas agregadas de la cuenta: tickets por día y resumen mensual (procesados, en espera, cancelados, montos facturados e IVA).

GetTicketsByDay

Consulta los tickets diarios de un periodo (mes y año). Si no se envían parámetros, regresa el mes en curso.

GET https://api.fotofacturas.ai/B2B/ReportV1/GetTicketsByDay

Parámetros (query string)

Campo Tipo Requerido Descripción
month int No Mes (1–12). Opcional.
year int No Año. Opcional.
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/ReportV1/GetTicketsByDay?month=4&year=2026" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "data": {
    "days": [
      { "day": 1, "ticketCount": 0 },
      { "day": 2, "ticketCount": 1 },
      { "day": 3, "ticketCount": 2 },
      { "day": 4, "ticketCount": 0 },
      { "day": 5, "ticketCount": 1 }
    ],
    "average": 1.2352941176470589
  },
  "isSuccess": true,
  "message": "Tickets obtenidos para 4/2026"
}

El arreglo days trae un elemento por cada día del mes consultado (aquí se muestra truncado).

GetMonthStats

Regresa el estado de los tickets del mes consultado y, como referencia, el del mes anterior.

GET https://api.fotofacturas.ai/B2B/ReportV1/GetMonthStats

Parámetros (query string)

Campo Tipo Requerido Descripción
month int No Mes (1–12). Opcional.
year int No Año. Opcional.
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/ReportV1/GetMonthStats?month=4&year=2026" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "data": {
    "currentMonth": {
      "startDate": "2026-04-01T00:00:00Z",
      "endDate": "2026-04-30T23:59:59.999999Z",
      "processedTicketCount": 8,
      "waitingTicketCount": 1,
      "cancelledTicketCount": 12,
      "totalInvoiced": 2983.76,
      "totalIVATaxInvoiced": 477.4016,
      "totalTicketsUsed": 21,
      "ticketsMonthlyLimit": 1000
    },
    "lastMonth": {
      "startDate": "2026-03-01T00:00:00Z",
      "endDate": "2026-03-31T23:59:59.999999Z",
      "processedTicketCount": 24,
      "waitingTicketCount": 6,
      "cancelledTicketCount": 9,
      "totalInvoiced": 13222.30,
      "totalIVATaxInvoiced": 2115.5680,
      "totalTicketsUsed": 39,
      "ticketsMonthlyLimit": 1000
    }
  },
  "isSuccess": true,
  "message": "Ejecutado correctamente"
}