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.