Get month
getMonthPermiso read
The plant’s last 30 days, up to its today: units, meta, efficiency and «Facturación» per day. The 30-day chart of Reportes.
/v1/external/organizations/{organizationId}/analytics/monthWhat it is: the whole plant day by day over its last 30 plant days, today included, the 30-day chart of the dashboard’s «Reportes». Each entry of days is one plant day: units made by every «puesto», goal (the sum of each «puesto»’s «meta» for each hour it worked), efficiency, and billedAmount, the day’s «Facturación». days is oldest first, and a day with no work is no row.
It takes no parameter: the window is fixed and ends on the plant’s today, on its own clock. For another window, or to group by «módulo», «operario» or «puesto», use getEfficiency and getBilling.
efficiency is «Eficiencia»: units made × 100 ÷ the «meta» of the same span, a percentage with 2 decimals (100 = exactly the goal, it can pass 100; never a 0–1 ratio), null where the goal is 0. Every «puesto» counts towards it, a «puesto de salida» or not.
Money is «Facturación»: the units of the «puestos de salida» × the price per unit each was billed at, in the plant’s currency (currency, ISO 4217: EUR for a plant in España, COP for every other), in whole currency units with up to 2 decimals, never cents. Whether a money figure reads null or 0 where nothing was priced is stated on each field. A day with production and nothing billed keeps its units and a null billedAmount.
Days and hours are the plant’s own: a plant day is a calendar day YYYY-MM-DD in the organization’s timezone (getOrganization timezone), never UTC, and an hour is the clock hour 0–23 that starts at it in that zone.
Plan: needs the plan feature reports («Reportes»), the one its dashboard screen is gated by. Pro, a trial of Pro, an «exenta» organization and a Light of plan version 1 (getPlan planVersion) answer it; a Light of plan version 2 does not: 403 PLAN_LIMIT with feature: "reports". getPlan features lists what the organization’s plan has.
Heavy read: besides the credential’s ordinary budget it spends the heavy one, 20 requests per 60 seconds per credential and organization; past it the answer is 429 RATE_LIMITED with Retry-After.
Autorización
apiToken An API token created in Configuración › Tokens de API, or a connected app’s access token
En: header
Parámetros de ruta
The organization, from getMe or listOrganizations.
Respuestas
application/json
application/json
curl -X GET "https://api.fluenta.io/v1/external/organizations/0/analytics/month" \ -H "Authorization: Bearer fluenta_live_XXXX"{ "currency": "string", "days": [ { "day": "string", "units": 0, "goal": 0, "efficiency": 0, "billedAmount": 0 } ]}