Saltar al contenido
Facturador

Cambiar estado de cotización

POST /api/quotations/{quotation_id}/state

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Cambia el estado de la cotización (p. ej. marcarla como aceptada o rechazada).

Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403.

Campo Tipo Obligatorio Descripción / valores permitidos
state_type_id string Sí 01 registrado, 05 aceptado, 09 rechazado, 11 anulado.

Errores: 422 si el estado no es uno de los permitidos; 409 si la cotización está anulada y se intenta otro estado; 403; 404.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
quotation_id ruta sí 1

Cuerpo

Content-Type: application/json

{
  "state_type_id": "05"
}

Respuestas

200 — Estado actualizado

{
  "success": true,
  "data": {
    "id": 33,
    "number_full": "COT-33",
    "state_type_id": "05",
    "state_type_description": "Aceptado",
    "date_of_issue": "2026-11-07",
    "customer_id": 1,
    "currency_type_id": "PEN",
    "total": 23.6,
    "items_count": 1
  },
  "message": "Estado actualizado correctamente"
}

422 — Estado inválido

{
  "success": false,
  "message": {
    "state_type_id": [
      "state type id es inválido."
    ]
  }
}

409 — Anulada

{
  "success": false,
  "message": "La cotización está anulada: no se puede reactivar."
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.