Herramienta MCP: creditNotes_listCreditNotes.
Lista notas de crédito de venta: los documentos que reducen lo que un cliente debe sobre facturas de venta ya emitidas (devoluciones, anulaciones, descuentos y bonificaciones) y que, cuando se emiten electrónicamente, se timbran ante la autoridad fiscal de cada país. Úsala para encontrar notas cuando no conoces sus IDs, o para reportar por cliente, período, numeración, ítem o estado de emisión electrónica. No lista facturas de venta: una nota de crédito es un documento aparte que apunta a las facturas que acredita a través de su arreglo invoices; para las facturas usa las herramientas de facturas de venta. Para consultar una sola nota por ID, usa creditNotes_getCreditNote.
La respuesta es siempre un objeto: data contiene las notas encontradas y returnedByApi, discardedByClientFilter y note reportan el filtrado, porque los filtros de período (dateFrom/dateTo) y de estado (status) los aplica esta herramienta y no la API — lee note antes de concluir que un período no tiene notas de crédito. apiTotal siempre indica cuántas notas de crédito tiene la empresa en total. Por defecto cada registro es una versión ligera (IDs, fechas, estado, numeración, cliente, facturas acreditadas y montos); con detail: true se incluye el payload completo (ítems, impuestos, reembolsos, bodega, direcciones, etc.).
Reglas de filtrado y paginación: date es el único filtro de fecha que aplica la propia API. El filtro id acepta hasta 30 IDs separados por comas (sin espacios) y, cuando se envía, la API ignora todos los demás filtros: no lo combines con client_id, date ni number. limit está limitado a 30 (máximo y valor por defecto de la API; valores mayores se rechazan); cuando se usan dateFrom, dateTo o status, ese límite restringe los registros escaneados, por lo que pueden coincidir menos. Avanza con start hasta que la API devuelva menos registros que limit. Para conjuntos grandes (más de ~120 registros) o descargas de rangos completos de fechas, usa la herramienta exportable en lugar de paginar.
Notas por país: en México la nota se convierte en un CFDI de egreso y emission_status refleja el timbrado ante el SAT (incluye STAMPED_AND_CANCELLED). En Colombia la validación electrónica es de la DIAN y su catálogo incluye STAMPED_AND_ACCEPTED_WITH_OBSERVATIONS. En Costa Rica el timbrado es ante Hacienda (incluye STAMPED_AND_WAITING_RESPONSE). En Panamá la validación es de la DGI, cuyo catálogo de estados no incluye estado de cancelación. El enum de emission_status documentado es la unión de los catálogos por país; usa los valores del catálogo de tu país.
Solo lectura.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
No autorizado