---
title: "Obtener nota de crédito de venta"
method: POST
path: "/tools/creditNotes_getCreditNote"
tags: ["Sales Documents"]
---

# Obtener nota de crédito de venta

`POST /tools/creditNotes_getCreditNote`

## Request

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

Herramienta MCP: `creditNotes_getCreditNote`.

Obtiene una nota de crédito de venta por su ID local de Alegra y devuelve el documento completo: fecha, estado de Alegra, tipo de nota de crédito, cliente, numeración, ítems con sus impuestos, total, saldo no aplicado, monto ya aplicado, las facturas de venta que acredita (con el monto aplicado a cada una) y los reembolsos registrados contra la nota.

Úsala cuando ya conoces el ID de la nota de crédito; si solo conoces el cliente, una fecha, un número o una factura, usa `creditNotes_listCreditNotes` para encontrar el ID. No devuelve una factura de venta: para consultar la factura usa las herramientas de facturas de venta de Alegra (por ejemplo `invoice_getInvoiceById`). Con `includeComments: true` la respuesta incluye además el arreglo `comments` del documento. Este endpoint no ofrece URLs de PDF ni XML.

El `id` es el ID interno de Alegra, no la numeración impresa (por ejemplo "NC-12") ni el identificador fiscal del timbre (UUID del SAT en México, CUFE en Colombia, clave de Hacienda en Costa Rica).

Notas por país (el catálogo documenta una variante por país; las reglas y el esquema de parámetros son los mismos): en México el tipo de nota usa los códigos SAT ("01" = anulaciones, descuentos y bonificaciones; "03" = devolución de mercancía sobre facturas o traslados previos). En Colombia el tipo toma valores DIAN como `PARTIALL_DEVOLUTION`, `VOID_ELECTRONIC_INVOICE`, `REDUCTION_DISCOUNT_PARTIAL_TOTAL`, `PRICE_ADJUSTMENT` u `OTHER`. En Panamá el tipo es `CREDIT_NOTE_FE` (nota de crédito referente a una FE) o `CREDIT_NOTE` (nota genérica), y además incluye la forma de pago. En Costa Rica la respuesta no incluye el campo de tipo.

Solo lectura.

## Request body

- object
  - `id` string, required: ID de la nota de crédito a consultar, tal como aparece en el campo `id` que devuelve `creditNotes_listCreditNotes` (por ejemplo "1"). Es el ID interno de Alegra, no la numeración impresa ("NC-12") ni el identificador fiscal del timbre (UUID del SAT en México, CUFE en Colombia, clave de Hacienda en Costa Rica).
  - `includeComments` boolean: Si es true, la nota de crédito incluye además su arreglo `comments`. Por defecto false.

## Response `200`

Detalle completo de la nota de crédito de venta

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