Servidor MCPHerramientas disponibles
Registrar pago de cotización
Registra un pago manual de una cotización aceptada.
Herramienta MCP
record_quote_paymentPropósito
Registra un pago manual de una cotización aceptada.
- Usar cuando
- Ocurrió un pago para una cotización aceptada.
- No usar cuando
- No fue aceptada o el pago no corresponde.
- Permisos requeridos
- Efectos secundarios
- Destructivo y externo
- Idempotencia
- Idempotente
Esquema de entrada
JSON Schema{ "type": "object", "properties": { "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Unique retry key for this exact operation. Reuse it only when retrying the same request." }, "input": { "type": "object", "properties": { "paymentForm": { "type": "string", "enum": [ "12", "13", "14", "15", "17", "23", "24", "25", "26", "27", "28", "29", "30", "31", "99", "02", "06", "01", "05", "04", "03", "08" ], "description": "Active SAT payment-form code.", "x-exac-sat-catalog": "payment-forms" }, "paidAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "notes": { "type": "string" }, "documentRef": { "type": "string", "pattern": "^quote:.+$" } }, "required": [ "paymentForm", "documentRef" ], "additionalProperties": false } }, "required": [ "idempotencyKey", "input" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false}Esquema de salida
JSON Schema{ "type": "object", "properties": { "data": { "type": "object", "properties": { "paymentId": { "type": "string" }, "source": { "type": "string", "enum": [ "manual", "online" ] }, "amount": { "type": "number" }, "currency": { "type": "string", "const": "MXN" }, "paymentForm": { "type": "string" }, "applicationStatus": { "type": "string", "enum": [ "pending", "processing", "applied", "failed", "conflict" ] }, "applicationErrorCode": { "type": "string", "enum": [ "payment_form_required", "fiscal_drift", "location_resolution_required", "duplicate_payment", "application_failed" ] }, "invoiceStatus": { "type": "string", "enum": [ "pending", "processing", "issued", "failed" ] }, "salesReceiptDocumentRef": { "type": "string", "pattern": "^sales_receipt:.+$" }, "cfdiDocumentRef": { "type": "string", "pattern": "^cfdi:.+$" }, "paidAt": { "type": "string", "format": "date-time" } }, "required": [ "paymentId", "source", "amount", "currency", "applicationStatus", "paidAt" ], "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, "oneOf": [ { "required": [ "data" ] }, { "required": [ "error" ] } ]}