Saltar al contenido principal

Cancelar un presupuesto

POSThttps://carchost.fieldcontrol.com.br/quotations/{id}/cancel

Cancela un presupuesto pendiente. La respuesta de éxito usa el estado 201.

Requiere los headers X-Api-Key, User-Agent y Content-Type: application/json. Límite: 1 solicitud por segundo (más información).

Solicitud​

Parámetros de ruta

idstringobligatorio

Identificador del presupuesto.

Ejemplo: YmIwYzk1ZGMtYzNhYi00YmQ4LTkxNjEtZDVjNTU1ZTQxNTQwOjIyOTE1.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Cuerpo de la solicitud

JSON, enviado con el header Content-Type: application/json.

canceledAtstring

Fecha de la cancelación (ISO 8601), que no puede ser futura. El valor predeterminado es el momento de la solicitud.

Acepta: null.

Respuestas

  • 201

    Presupuesto cancelado.

  • 401

    Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

  • 403

    Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

  • 422

    Presupuesto inexistente (reason: not found; no hay 404), situación que no permite cancelar (reason: invalid status transition) o fecha inválida o futura (resourceValidationErr). Un presupuesto ya cancelado se devuelve sin cambios.

  • 429

    Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

  • 500

    Error inesperado en el servidor.