Cambiar el estado de una cotización
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 acotizandoorevisando, 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 comocliente. - 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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»quotation_idintegerobligatorioCotización cuyo estado cambia. Debe existir.
statusstringobligatorioEstado destino: cotizando, revisando, aprobado, negociando o cerrado.
user_idintegercondicionalUsuario asignado al estado. Obligatorio si status es revisando.
commentsstringComentario del paso.
Permiso
Sección titulada «Permiso»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.
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"}'const response = await fetch( "https://servererp.allendostmen.app/api/quotation-workflow", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "quotation_id": 1520, "status": "revisando", "user_id": 9, "comments": "Listo para revisión" }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/quotation-workflow', [ 'quotation_id' => 1520, 'status' => 'revisando', 'user_id' => 9, 'comments' => 'Listo para revisión', ]);{ "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}{ "message": "No se permite cambiar de estado."}{ "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." ] }}