Importar ítems de otra cotización
POST/api/quotation/{quotationId}/import-items
Importa los ítems de una cotización del servidor externo dentro de la cotización indicada. El servidor consulta /api/quotation-export/{external_quotation_id} en EXTERNAL_SERVER_URL, crea los títulos, los costos unitarios y sus componentes, y recalcula los totales. Los ítems se agregan al final de los existentes. Ver el formato y las reglas de la importación.
Parámetros de la ruta
Sección titulada «Parámetros de la ruta»quotationIdintegerobligatorioIdentificador de la cotización.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»external_quotation_idintegerobligatorioIdentificador de la cotización en el servidor externo.
Permiso
Sección titulada «Permiso»No exige un permiso del módulo: basta con un token válido (auth:sanctum). El controlador no llama a ninguna política ni valida el estado de la cotización destino.
curl -X POST \ "https://servererp.allendostmen.app/api/quotation/1/import-items" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "external_quotation_id": 245}'const response = await fetch( "https://servererp.allendostmen.app/api/quotation/1/import-items", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "external_quotation_id": 245 }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/quotation/1/import-items', [ 'external_quotation_id' => 245, ]);Importación realizada200
{ "success": true, "message": "Items importados correctamente.", "imported": { "quotation_items": 4, "unit_costs": 3, "materials": 9, "workforces": 2, "equipment_tools": 1, "subcontracts": 0 }, "warnings": [ "Mano de obra 'Peón' en UC 'Tendido de cable': no encontrada, omitida." ]}Sin ítems200
{ "success": true, "message": "No se encontraron items para importar.", "imported": { "quotation_items": 0, "unit_costs": 0, "materials": 0, "workforces": 0, "equipment_tools": 0, "subcontracts": 0 }, "warnings": []}Cotización no existe404
{ "message": "No query results for model [App\\Models\\Quotation] 999."}Servidor externo no disponible422
{ "message": "No se pudo obtener la cotización del servidor externo. HTTP 404", "errors": { "external_quotation_id": [ "No se pudo obtener la cotización del servidor externo. HTTP 404" ] }}