Ir al contenido

Crear un proyecto

POST/api/project

Crea un proyecto. Todo ocurre en una transacción: el servidor genera el code, calcula investment como la suma de los montos de cost_centers, completa end_date si falta, guarda el proyecto con estado activo y crea el centro de costo padre con sus seis subcentros por defecto (ver Resumen). Los subcentros que no se envíen se crean con un presupuesto de 50000. Si no existe ninguna moneda responde 422 con No se encontró una moneda. Por favor, crea una moneda primero.

customer_idintegerobligatorio

Cliente. Debe existir en clientes. Mensajes: El campo cliente es requerido, El campo cliente debe ser un número entero y El campo cliente no existe.

namestringobligatorio

Nombre del proyecto. Máximo 500 caracteres. Mensaje: El campo nombre es requerido.

descriptionstring

Descripción. Máximo 1000 caracteres.

start_datedateobligatorio

Fecha de inicio. Si se envía end_date, debe ser anterior. Mensajes: El campo fecha de inicio es requerido y El campo fecha de inicio debe ser anterior a la fecha de fin.

end_datedate

Fecha de fin. Si no se envía, el servidor usa la fecha de inicio más un año.

investmentnumber

Se acepta, pero se ignora: el servidor la reemplaza por la suma de cost_centers.*.total_budget.

cost_centersarrayobligatorio

Montos por subcentro de costo. Al menos un elemento. Mensajes: Debe ingresar los montos de los subcentros de costo y Debe ingresar al menos un subcentro de costo.

cost_centers.*.namestringobligatorio

Nombre del subcentro. Valores válidos: materiales, mano de obra, equipo y herramientas, subcontratos, gastos generales y caja chica. Mensaje: El subcentro de costo seleccionado no es válido.

cost_centers.*.total_budgetnumberobligatorio

Monto del subcentro. Debe ser mayor a 0. Mensaje: El monto del subcentro de costo debe ser mayor a 0.

project_manager_idinteger

Usuario gerente del proyecto. Debe existir en usuarios.

seller_idinteger

Usuario vendedor. Debe existir en usuarios.

comercial_conditionarray

Se valida como arreglo, pero no se guarda: el modelo usa comercial_conditions (plural) y este campo no está en $fillable.

cost_center_type_idinteger

Tipo de centro de costo. Se valida solo como entero; no se comprueba que exista.

project.create, que se valida en ProjectPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/project" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"customer_id": 5,
"name": "Instalación eléctrica Planta Norte",
"description": "Instalación de tableros y cableado",
"start_date": "2026-11-02",
"end_date": "2027-11-02",
"project_manager_id": 3,
"seller_id": 4,
"cost_center_type_id": 2,
"cost_centers": [
{
"name": "materiales",
"total_budget": 120000
},
{
"name": "mano de obra",
"total_budget": 180000
}
]
}'
Proyecto creado201
{
"customer_id": 5,
"name": "Instalación eléctrica Planta Norte",
"description": "Instalación de tableros y cableado",
"start_date": "2026-11-02T00:00:00.000000Z",
"end_date": "2027-11-02T00:00:00.000000Z",
"project_manager_id": 3,
"seller_id": 4,
"cost_center_type_id": 2,
"investment": 300000,
"code": "110001",
"status": "activo",
"previous_status": null,
"create_user_id": 1,
"updated_at": "2026-11-19T10:40:15.000000Z",
"created_at": "2026-11-19T10:40:15.000000Z",
"id": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El campo cliente es requerido",
"errors": {
"customer_id": [
"El campo cliente es requerido"
]
}
}