> ## 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.

# Emisiones de compras

> Sincroniza tus gastos de compra y obtén las emisiones de Scope 3 asociadas a proveedores y categorías

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.

```bash theme={null}
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                 |

<Tip>
  Usa el mismo `id` que en tu sistema contable o ERP para facilitar la sincronización y evitar duplicados.
</Tip>

## Listar gastos

`GET /api/v1/purchased-goods/expenses`

Consulta todos los gastos registrados de una empresa:

```bash theme={null}
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:

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

* [Referencia completa del endpoint Purchased Goods →](/api-reference)
* [Autenticación →](/authentication)
* [GHG Protocol — Scope 3 Category 1](https://ghgprotocol.org/scope-3-technical-calculation-guidance)