Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://developers.manglai.io/llms.txt

Use this file to discover all available pages before exploring further.

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

CampoTipoRequeridoDescripción
iduuidSíIdentificador único del gasto (generado por ti)
companyIduuidSíID de la empresa compradora
supplierIduuidNoID del proveedor en Manglai
descriptionstringNoDescripción del gasto
amountnumberSíImporte del gasto
currencystringSíMoneda: EUR, USD, etc.
datedateSíFecha del gasto (YYYY-MM-DD)
categoryIduuidNoCategorí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ámetroRequeridoDescripción
companyIdSíID de la empresa
pageNoNúmero de página (paginación)
limitNoResultados 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:
  1. Se asocia el gasto a una categoría de actividad y proveedor
  2. Se aplica el factor de emisión correspondiente por unidad monetaria
  3. 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.

​
Más información