Docs
Servidor MCPHerramientas disponibles

Cancelar recibo de venta

Cancela un recibo abierto y conserva su historial operativo.

Herramienta MCPcancel_sales_receipt

Propósito

Cancela un recibo abierto y conserva su historial operativo.

Usar cuando
Un recibo abierto ya no debe utilizarse.
No usar cuando
Ya fue facturado o debe reembolsarse.
Permisos requeridos
receipts:cancel
Efectos secundarios
Destructivo
Idempotencia
Idempotente

Esquema de entrada

JSON Schema
{  "type": "object",  "properties": {    "documentRef": {      "type": "string",      "pattern": "^sales_receipt:.+$"    },    "idempotencyKey": {      "type": "string",      "minLength": 1,      "maxLength": 200,      "description": "Unique retry key for this exact operation. Reuse it only when retrying the same request."    }  },  "required": [    "documentRef",    "idempotencyKey"  ],  "$schema": "http://json-schema.org/draft-07/schema#",  "additionalProperties": false}

Esquema de salida

JSON Schema
{  "type": "object",  "properties": {    "data": {      "type": "object",      "properties": {        "documentRef": {          "type": "string",          "pattern": "^sales_receipt:.+$"        },        "status": {          "type": "string",          "enum": [            "open",            "invoiced",            "global_invoiced",            "canceled"          ]        }      },      "required": [        "documentRef",        "status"      ],      "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"      ]    }  ]}

Flujo relacionado

Consulta los flujos canónicos en la introducción

Herramientas relacionadas

Crear recibo de venta

Crea un recibo de venta de caja sin timbrar un CFDI.

Reembolsar recibo de venta

Registra un reembolso de recibo y, cuando corresponda, crea una nota de crédito CFDI.