Listar notas de débito de compra

Herramienta MCP: expenses_list-debit-notes.

Lista notas de débito de compras (cuentas por pagar) con paginación y filtros: proveedor, fecha, estado de emisión, número de documento o tipo de documento (nota estándar frente a nota de ajuste).

Úsala para descubrir los id que necesita expenses_get-debit-note, auditar notas de débito abiertas o filtrar los documentos de un proveedor con client_id. Con id puedes recuperar hasta 30 documentos por sus IDs locales separados por comas en una sola petición. Con metadata: true la respuesta envuelve los resultados como { metadata: { total }, data: [...] } en lugar de un arreglo.

Notas por país: en Colombia el filtro type=adjustmentNote es relevante para los flujos de notas de ajuste; en Costa Rica los documentos se rigen por la facturación electrónica de Ministerio de Hacienda; en México operan bajo las reglas SAT (CFDI).

Errores relevantes: start o limit inválidos, o más de 30 IDs en id → código 903; documento no encontrado → 404 (código 13005); acceso denegado por permisos → 403.

Solo lectura.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer

ID numérico local del proveedor. Limita la lista a sus documentos.

string

Fecha exacta del documento (YYYY-MM-DD).

string

Filtro: fecha de emisión >= valor (YYYY-MM-DD).

string

Filtro: fecha de emisión <= valor (YYYY-MM-DD).

string

Rango de fechas requerido por los filtros de la API.

string

Filtro de estado de emisión electrónica, separado por comas o con varios valores.

string

Campos adicionales separados por comas: editable, deletable, stamp, xml, idGlobal, uid, createdAt, updatedAt, companyCurrencyValues, calculationTotalMethod, bills.idGlobal, bills.currency, accountingVouchers, etc.

string

Lista separada por comas de IDs locales a recuperar en una petición (máximo 30). Alternativa a listar todos.

string

Filtro por identificador global del documento.

integer

Filtra documentos que contengan un ítem con este ID local.

integer
≥ 0
Defaults to 30

Tamaño de página; 0 = sin límite (sujeto al máximo del servidor). Por defecto 30.

boolean

Si es true, la respuesta es { metadata: { total }, data: [...] }.

string

Filtra por número del documento.

string
enum

Dirección del orden: ASC (ascendente) o DESC (descendente).

Allowed:
string
enum

Campo por el que se ordenan los resultados.

Allowed:
string

Filtra por nombre del proveedor.

integer
≥ 0
Defaults to 0

Desplazamiento inicial de la paginación (debe ser >= 0).

string
enum

Filtro de estirpe del documento: nota de débito estándar, nota de ajuste o todas.

Allowed:
Responses

401

No autorizado

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json