Servidor MCPHerramientas disponibles
Leer resumen de ventas
Consulta agregados de ventas de recibos de caja por periodo.
Herramienta MCP
get_sales_receipt_summaryPropósito
Consulta agregados de ventas de recibos de caja por periodo.
- Usar cuando
- Necesitas ventas POS, facturadas y no facturadas.
- No usar cuando
- Necesitas actividad CFDI reconocida.
- Permisos requeridos
- Efectos secundarios
- Ninguno
- Idempotencia
- Idempotente
Esquema de entrada
JSON Schema{ "type": "object", "properties": { "date": { "description": "Business date in YYYY-MM-DD; defaults to the org's today", "allOf": [ { "$ref": "#/definitions/__schema0" } ] }, "activityLimit": { "description": "Top customers, products, and locations; defaults to 4", "allOf": [ { "$ref": "#/definitions/__schema1" } ] } }, "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "definitions": { "__schema0": { "type": "string" }, "__schema1": { "type": "integer", "minimum": 1, "maximum": 10 } }}Esquema de salida
JSON Schema{ "type": "object", "properties": { "data": { "type": "object", "properties": { "source": { "type": "string", "const": "sales_receipts" }, "currency": { "type": "string", "const": "MXN" }, "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "includesInvoicedReceipts": { "type": "boolean", "const": true }, "cfdiTotalsIncluded": { "type": "boolean", "const": false }, "totals": { "type": "object", "properties": { "netSales": { "type": "number" }, "receiptCount": { "type": "number" } }, "required": [ "netSales", "receiptCount" ], "additionalProperties": false }, "byPaymentMethod": { "type": "array", "items": { "type": "object", "properties": { "paymentMethod": { "type": "string", "enum": [ "cash", "card", "transfer", "credit", "other" ] }, "netSales": { "type": "number" }, "share": { "type": "number" } }, "required": [ "paymentMethod", "netSales", "share" ], "additionalProperties": false } }, "top": { "type": "object", "properties": { "customers": { "type": "array", "items": { "$ref": "#/definitions/__schema0" } }, "products": { "type": "array", "items": { "$ref": "#/definitions/__schema0" } }, "locations": { "type": "array", "items": { "$ref": "#/definitions/__schema0" } } }, "required": [ "customers", "products", "locations" ], "additionalProperties": false } }, "required": [ "source", "currency", "date", "includesInvoicedReceipts", "cfdiTotalsIncluded", "totals", "byPaymentMethod", "top" ], "additionalProperties": false }, "error": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "code": { "type": "string", "enum": [ "validation_error", "unauthenticated", "forbidden", "not_found", "method_not_allowed", "conflict", "idempotency_conflict", "operation_in_progress", "recovery_required", "rate_limited", "provider_unavailable", "internal" ] }, "message": { "type": "string" }, "details": { "type": "object", "properties": { "issues": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "code": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } }, "retryable": { "type": "boolean" }, "retryAfterSeconds": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "required": [ "code", "message" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "definitions": { "__schema0": { "type": "object", "properties": { "name": { "type": "string" }, "amount": { "type": "number" }, "quantity": { "type": "number" }, "receiptCount": { "type": "number" }, "share": { "type": "number" } }, "required": [ "name", "amount", "quantity", "receiptCount", "share" ], "additionalProperties": false } }, "oneOf": [ { "required": [ "data" ] }, { "required": [ "error" ] } ]}