Ir al contenido

Crear un subcontrato

POST/api/subcontract

Crea un subcontrato. Dentro de una transacción, el servidor genera el code correlativo de cuatro dígitos, guarda el subcontrato con estado activo, registra sus proveedores y, si se envían, sus categorías de costo unitario. Responde 201.

namestringobligatorio

Nombre del subcontrato. Máximo 255 caracteres.

measurement_unit_idintegerobligatorio

Unidad de medida. Debe ser un entero que exista en unidades de medida.

descriptionstring

Descripción. Máximo 500 caracteres.

unified_index_idinteger

Índice unificado. Debe existir en índices unificados.

subcontract_providersarrayobligatorio

Proveedores del subcontrato. Debe tener al menos un elemento. Cada elemento lleva provider_id (obligatorio, entero que exista en proveedores; no puede repetirse en la lista), coin_id (obligatorio, debe existir), price (obligatorio, numérico, de 0.01 a 1000000000), delivery_days (obligatorio, entero de 1 a 180), code (máximo 255), name (máximo 255), description (máximo 500), commentary (máximo 500) y payment_type (contado o crédito).

subcontract_unit_cost_categoriesarray

Categorías de costo unitario. Cada elemento lleva unit_cost_category_id, que debe existir en categorías de costo unitario.

quotation.configuration.create, que se valida en SubcontractPolicy::create.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/subcontract" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Instalación de tablero eléctrico",
"measurement_unit_id": 4,
"subcontract_providers": [
{
"provider_id": 12,
"coin_id": 1,
"price": 1800,
"delivery_days": 10,
"payment_type": "contado"
}
],
"subcontract_unit_cost_categories": [
{
"unit_cost_category_id": 1
}
]
}'
Subcontrato creado201
{
"id": 1,
"name": "Instalación de tablero eléctrico",
"description": null,
"price": null,
"code": "0001",
"unified_index_id": null,
"measurement_unit_id": 4,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Error de validación422
{
"message": "Los proveedores son requeridos",
"errors": {
"subcontract_providers": [
"Los proveedores son requeridos"
]
}
}
Sin permiso403
{
"message": "This action is unauthorized."
}