Clasificación de gastos

Fegora clasifica automáticamente cada documento tributario recibido (facturas de proveedores, notas de crédito/débito recibidas, etc.) en una categoría de gasto, para poder generar estadísticas sin que el cliente tenga que categorizar manualmente cada documento.

La clasificación aplica únicamente a documentos recibidos (/recibidos/dte). Los documentos que su Cuenta emite no se clasifican.

El objeto `clasificacion`

Cuando un documento recibido ya fue clasificado, la respuesta de GET /recibidos/dte y GET /recibidos/dte/{id} incluye un objeto clasificacion:

{
  "clasificacion": {
    "categoria": "transportation",
    "subcategoria": "fuel",
    "tags": ["recurring"],
    "confianza": 0.95,
    "fuente": "llm",
    "versionCatalogo": "v1",
    "fecha": "2026-07-31T18:09:18Z"
  }
}

Campo	Tipo	Descripción
`categoria`	string	Identificador de la categoría de gasto, en inglés y estable entre versiones del catálogo (por ejemplo `transportation`). Vea el catálogo completo abajo.
`subcategoria`	string	Identificador de la subcategoría dentro de `categoria` (por ejemplo `fuel`).
`tags`	string[]	Etiquetas adicionales asociadas a la clasificación (por ejemplo `recurring`). Puede venir vacío.
`confianza`	number	Nivel de confianza de la clasificación, entre `0` y `1`.
`fuente`	string	Origen de la clasificación: `rule` (regla determinística), `llm` (modelo de lenguaje), `issuercache` (clasificación previa reutilizada para el mismo emisor) o `human` (corregida manualmente).
`versionCatalogo`	string	Versión del catálogo de categorías usada para esta clasificación (por ejemplo `v1`).
`fecha`	string (date-time)	Fecha en que se generó la clasificación.

La clasificación es asíncrona: un documento recién recibido puede aparecer sin clasificacion (el campo no está presente) durante algunos minutos u horas, hasta que Fegora termine de procesarlo. No asuma que todo documento recibido trae clasificacion de inmediato — si su integración depende de este dato, vuelva a consultar el documento más adelante, o use el filtro sinClasificacion descrito abajo para identificar los pendientes.

Catálogo de categorías (v1)

La versión v1 del catálogo define 17 categorías:

`categoria`
`transportation`
`professional-services`
`rent-and-real-estate`
`utilities`
`food-and-beverage`
`office-supplies`
`technology`
`cleaning-and-maintenance`
`construction-and-hardware`
`health`
`insurance`
`taxes-and-fees`
`financial-services`
`personnel`
`inventory-and-merchandise`
`entertainment-and-events`
`other`

Cada categoría tiene sus propias subcategorías. versionCatalogo le permite saber, a futuro, si un documento fue clasificado con una versión anterior del catálogo si Fegora publica una v2.

Filtrar documentos recibidos por clasificación

GET /recibidos/dte acepta dos parámetros adicionales, junto con los filtros existentes (desde, hasta, tipo, idReceptor, etc.):

Parámetro	Tipo	Descripción
`categoria`	string	Devuelve solo los documentos clasificados con este `categoria`.
`sinClasificacion`	boolean	Si es `true`, devuelve solo los documentos que todavía no tienen `clasificacion` (pendientes de procesar).

curl -X GET "https://api.fegora.com/recibidos/dte?categoria=transportation" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...ejemplo"

curl -X GET "https://api.fegora.com/recibidos/dte?sinClasificacion=true" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...ejemplo"

Estadísticas de gasto: `GET /recibidos/dte/estadisticas`

Devuelve los totales de documentos recibidos agrupados por categoría y mes, dentro de un rango de fechas.

curl -X GET "https://api.fegora.com/recibidos/dte/estadisticas?desde=2026-01-01T00:00:00Z&hasta=2026-07-31T23:59:59Z" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...ejemplo"

Parámetro	Tipo	Obligatorio	Descripción
`desde`	string (date-time)	Sí	Inicio del rango, mismo formato que en `GET /recibidos/dte`.
`hasta`	string (date-time)	Sí	Fin del rango, mismo formato que en `GET /recibidos/dte`.

Respuesta

[
  { "categoria": "transportation", "mes": "2026-07", "total": 1250.50, "cantidad": 8 },
  { "categoria": "food-and-beverage", "mes": "2026-07", "total": 430.00, "cantidad": 3 },
  { "categoria": "sin-clasificar", "mes": "2026-07", "total": 620.00, "cantidad": 2 }
]

Campo	Descripción
`categoria`	Categoría del gasto, o `sin-clasificar` para los documentos que aún no tienen `clasificacion` dentro del rango consultado.
`mes`	Mes al que corresponde el agregado, formato `YYYY-MM`.
`total`	Suma de los montos de los documentos de esa categoría y mes.
`cantidad`	Cantidad de documentos incluidos en ese total.

Este endpoint usa la misma autenticación y el mismo alcance (Cuenta/Canal) que el resto de /recibidos/dte — solo agrega documentos que su credencial ya puede consultar individualmente.

Introducción

Documentos DTE

Guías por país

Clasificación de gastos

El objeto `clasificacion`

Catálogo de categorías (v1)

Filtrar documentos recibidos por clasificación

Estadísticas de gasto: `GET /recibidos/dte/estadisticas`

Respuesta

Páginas relacionadas

Documentos recibidos (guía de usuario)

Estructura del DTE

​El objeto clasificacion

​Catálogo de categorías (v1)

​Filtrar documentos recibidos por clasificación

​Estadísticas de gasto: GET /recibidos/dte/estadisticas

​Respuesta

​Páginas relacionadas

Documentos recibidos (guía de usuario)

Estructura del DTE

El objeto `clasificacion`

Catálogo de categorías (v1)

Filtrar documentos recibidos por clasificación

Estadísticas de gasto: `GET /recibidos/dte/estadisticas`

Respuesta

Páginas relacionadas