Contratos
Anular un contrato
Anula un contrato VALIDADO con un motivo, que es obligatorio y se conserva.
contracts:writecontracts:write- 120/min
- Anotación del servidor: Destructiva
- Requiere confirmación humana
- No reversible
Resultado
generado desde el esquema
No reversible
Anular lleva el documento a voided y ninguna operación lo deshace.
Requiere confirmación humana
Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por destructiveHint. El servidor marca esta herramienta con _meta["anthropic, que los clientes que lo respetan usan para preguntar a una persona antes de cada llamada.
Conserva su número y pasa a voided: mueve el estado del DOCUMENTO y le quita la validez, esté firmado o no. Solo desde validated: un borrador se elimina desde la aplicación, no se anula. NO es /cancel, que mueve el estado de la firma y deja el documento vivo. Devuelve el contrato completo, la misma proyección que su GET.
Argumentos
Identificador del contrato.
Límites: longitud mín. 1
Motivo de la anulación. Se guarda en el contrato y en su historial.
Límites: longitud mín. 1, longitud máx. 500
Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.
Límites: longitud mín. 1, longitud máx. 255
Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.
Límites: longitud mín. 1
Resultado
En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.
Ver los atributos de data
Identificador único del contrato.
Número del contrato, por ejemplo "C260001"; null mientras es un borrador.
Estado del documento.
Opciones disponibles: draft, validated, voided
Estado de la firma.
Opciones disponibles: pending, signed, cancelled
true si el contrato consta como firmado. Es lo que decide si el equipo puede salir.
Fecha de firma en ISO 8601 UTC; null si no está firmado.
Identificador del cliente; null en borradores sin cliente.
Pedido asociado; null si no tiene.
Número del pedido asociado; null si no tiene.
Proyecto asociado; null si no tiene.
Fecha del contrato en ISO 8601 UTC; null si no está definida.
Inicio de la vigencia en ISO 8601 UTC; null si no aplica.
Fin de la vigencia en ISO 8601 UTC; null si no aplica.
Importe total con impuestos como cadena decimal "1234.50"; null si no aplica.
Límites: patrón ^-?\d+\.\d{2}$
Fecha de creación en ISO 8601 UTC; null si no consta.
Fecha de la última modificación en ISO 8601 UTC; null si no está registrada.
Un error es un resultado con isError: true y el problema en content[0].; no hay structuredContent. Consulta Errores.
La misma operación por REST
Esta herramienta ejecuta POST /api/v1/contracts/{contractId}/void.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasContratos
Anular un contrato
Anula un contrato VALIDADO con un motivo, que es obligatorio y se conserva.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con
isError: truey el problema en el primer bloque de texto. Ramifica por sucode.
¿Te ha resultado útil esta página?