Ir al contenido

Cambiar el estado de una cotización

POST/api/quotation-workflow

Registra un paso del flujo y mueve la cotización al estado indicado. Todo ocurre en una transacción. El servidor copia el vendedor y el project manager de la cotización al paso y, según el estado destino:

  • Al pasar a negociando, guarda la fecha de inicio de validez; al volver a cotizando o revisando, la borra.
  • Al pasar a cerrado, crea el proyecto de la oportunidad (o suma el total al proyecto existente), vincula la carpeta, descarta las demás cotizaciones de la familia y marca al cliente como cliente.
  • Notifica al usuario asignado y al vendedor y al project manager.

Reglas: la transición debe ser válida según el flujo; con revisando, aprobado, negociando o cerrado el total debe ser mayor a 0; para cerrar, la cotización debe tener fecha de validez y no estar vencida; si otra cotización de la familia ya se cerró, no se cambia de estado; y en una oportunidad de tipo Obra no se pasa a negociando ni cerrado.

quotation_idintegerobligatorio

Cotización cuyo estado cambia. Debe existir.

statusstringobligatorio

Estado destino: cotizando, revisando, aprobado, negociando o cerrado.

user_idintegercondicional

Usuario asignado al estado. Obligatorio si status es revisando.

commentsstring

Comentario del paso.

quotation.edit, que se valida en QuotationPolicy::enabledStatusWorkflowQuotation. Además se exige el permiso de vendedor o de project manager, una transición válida y que el usuario sea quien tiene asignado el paso actual (o su superior) o, si no hay asignado, el vendedor o el project manager que autoriza ese estado.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/quotation-workflow" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"quotation_id": 1520,
"status": "revisando",
"user_id": 9,
"comments": "Listo para revisión"
}'
Paso creado201
{
"id": 40,
"quotation_id": 1520,
"user_id": 9,
"seller_id": 5,
"project_manager_id": 9,
"comments": "Listo para revisión",
"status": "revisando",
"create_user_id": 5,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Sin permiso403
{
"message": "No se permite cambiar de estado."
}
Datos no válidos422
{
"message": "No se puede cambiar el estado de la cotización. El total debe ser mayor a 0.",
"errors": {
"total": [
"No se puede cambiar el estado de la cotización. El total debe ser mayor a 0."
]
}
}