Buscar facturas
buscar_documentosSearch a client's received invoices and notes by provider, date, amount, document type, CUFE, or payment method; returns matching documents and total count.
Instructions
Busca facturas y notas que recibió el cliente, combinando filtros: proveedor, fechas, valor, tipo de documento, CUFE o medio de pago.
Úsela cuando el usuario pida documentos puntuales, por ejemplo:
"Muéstrame las facturas de Claro de este año"
"¿Qué facturas de más de 5 millones llegaron en marzo?"
"Busca la factura con este CUFE" / "¿Cuáles pagué con tarjeta de crédito?"
No la use para totales de IVA, compras o retenciones (use resumen_periodo): aquí no se suma. Devuelve hasta 200 documentos y cuántos coinciden en total; si son más, pida acotar.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cliente": "<cliente>"
},
"name": "buscar_documentos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cufe | No | CUFE, CUDE o CUDS completo. | |
| tipo | No | 01 factura, 02 exportación, 03 talonario (contingencia), 04 factura tipo 04, 05 documento soporte, 91 nota crédito, 92 nota débito, 95 nota de ajuste. | |
| desde | No | Desde esta fecha de emisión, AAAA-MM-DD. | |
| hasta | No | Hasta esta fecha de emisión, AAAA-MM-DD. | |
| emisor | No | Proveedor: NIT exacto o parte de su nombre. | |
| cliente | Yes | NIT o cédula del cliente, tal como lo escriba el usuario: con puntos, espacios, guion, 'NIT' o 'C.C.', con o sin dígito de verificación. Si lo nombra por su razón social, búsquelo antes con listar_clientes. | |
| valor_max | No | Total a pagar máximo. | |
| valor_min | No | Total a pagar mínimo, en pesos, sin separadores. | |
| medio_pago | No | Código DIAN (tabla 13.3.4.2): 10 efectivo, 42 consignación, 47 transferencia, 48 tarjeta crédito, 49 tarjeta débito, ZZZ otro. |