Registra los gastos de compra de tu empresa y Manglai calculará automáticamente las emisiones de Scope 3 — Categoría 1 (Bienes y servicios adquiridos) según el GHG Protocol.
Esto es especialmente útil para empresas que quieren conectar su sistema contable o ERP con Manglai y obtener la huella de carbono de su cadena de suministro.
Crear o actualizar un gasto
POST /api/v1/purchased-goods/expenses
Este endpoint es idempotente: si ya existe un registro con el mismo id, se actualiza. Si no existe, se crea.
curl -X POST "https://www.manglai.io/api/v1/purchased-goods/expenses" \
-H "Authorization: Bearer TU_TOKEN_AQUI" \
-H "Content-Type: application/json" \
-d '{
"id": "a3f2e810-bc14-4c87-9d02-fe1234567890",
"companyId": "1b1e07a7-083d-4831-a1d2-84b6e93a1572",
"supplierId": "d0486f00-d1fc-4f96-95d3-155b038e98a7",
"description": "Compra de material de oficina",
"amount": 4500.00,
"currency": "EUR",
"date": "2024-03-15",
"categoryId": "668f3fcb-7fb0-4b65-b77d-9303c551632f"
}'
Campos
| Campo | Tipo | Requerido | Descripción |
|---|
id | uuid | Sí | Identificador único del gasto (generado por ti) |
companyId | uuid | Sí | ID de la empresa compradora |
supplierId | uuid | No | ID del proveedor en Manglai |
description | string | No | Descripción del gasto |
amount | number | Sí | Importe del gasto |
currency | string | Sí | Moneda: EUR, USD, etc. |
date | date | Sí | Fecha del gasto (YYYY-MM-DD) |
categoryId | uuid | No | Categoría GHG Protocol asociada |
Usa el mismo id que en tu sistema contable o ERP para facilitar la sincronización y evitar duplicados.
Listar gastos
GET /api/v1/purchased-goods/expenses
Consulta todos los gastos registrados de una empresa:
curl -X GET "https://www.manglai.io/api/v1/purchased-goods/expenses\
?companyId=1b1e07a7-083d-4831-a1d2-84b6e93a1572" \
-H "Authorization: Bearer TU_TOKEN_AQUI"
Parámetros
| Parámetro | Requerido | Descripción |
|---|
companyId | Sí | ID de la empresa |
page | No | Número de página (paginación) |
limit | No | Resultados por página |
Cómo se calculan las emisiones
Manglai utiliza el método de gasto monetario (spend-based method) del GHG Protocol para calcular las emisiones de Scope 3:
- Se asocia el gasto a una categoría de actividad y proveedor
- Se aplica el factor de emisión correspondiente por unidad monetaria
- Se genera la emisión en CO₂e trazable y auditable
Si el proveedor tiene un factor de emisión personalizado configurado en Manglai, se utiliza ese en lugar del genérico.
