---
title: "Obtener factura de compra"
method: POST
path: "/tools/expenses_get-bill"
tags: ["Gastos"]
---

# Obtener factura de compra

`POST /tools/expenses_get-bill`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/expenses_get-bill`
- Auth: HTTP bearer

Herramienta MCP: `expenses_get-bill`.

Obtiene una factura de compra (gasto) completa por su ID numérico local de Alegra: proveedor, ítems, impuestos, retenciones, pagos y totales.

El `id` es el campo `id` que devuelve `expenses_list-bills`. Úsalo cuando el usuario pida el detalle de un gasto concreto; para listar o filtrar varios documentos, usa `expenses_list-bills`.

Con `fields` puedes ampliar la respuesta con campos adicionales separados por comas (por ejemplo `totalTaxes`, `retentions`, `payments`, `stamp`, `xml`). `decimalMode` controla el redondeo de los totales ('calculation' usa la escala de la empresa, 'display' la precisión de visualización) y `dataByDate` calcula los totales a una fecha determinada (YYYY-MM-DD). Con `includeVoidPayments: true` se incluyen pagos anulados en los totales; con `simple: true` se devuelve un objeto simplificado.

Notas por país: en México las facturas de compra son CFDI; en República Dominicana usan NCF/ECF.

Solo lectura.

## Request body

- object
  - `id` integer, required: ID numérico local de la factura de compra a consultar.
  - `dataByDate` string: Calcula los totales a esta fecha (YYYY-MM-DD).
  - `decimalMode` 'calculation' | 'display': Modo de redondeo de los totales: 'calculation' o 'display'.
  - `fields` string: Campos adicionales separados por comas: editable, deletable, comments, journal, url, purchaseOrders, totalTaxes, subTotal, advances, retentions, createdAt, updatedAt, idGlobal, uid, stamp, additionalInfoStamp, stampFiles, xml, documentReceivedStatus, etc.
  - `includeVoidPayments` boolean: Incluye los pagos anulados en los totales.
  - `simple` boolean: Devuelve un objeto simplificado con menos campos.

## Response `200`

Detalle completo de la factura de compra

## Other responses

- `401`: No autorizado

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)