Importación de cotizaciones
La importación copia los ítems de una cotización que vive en otro servidor del ERP dentro de una cotización existente. No hay un archivo que se suba: el servidor descarga un JSON del servidor externo y lo convierte en ítems, costos unitarios y sus componentes. No existe un modelo QuotationImport; el proceso lo hace QuotationImportController.
| Controlador | App\Http\Controllers\QuotationImportController |
| Endpoint | Importar ítems |
| Origen de los datos | GET <EXTERNAL_SERVER_URL>/api/quotation-export/{external_quotation_id} |
La dirección del servidor externo sale de la variable de entorno EXTERNAL_SERVER_URL. El servidor espera hasta 30 segundos la respuesta.
Formato esperado
Sección titulada «Formato esperado»La respuesta del servidor externo debe traer la lista de ítems raíz en data.quotation_items o, si no existe, en quotation_items. Cada ítem raíz se convierte en un título (tipo simple) con sus hijos.
{ "data": { "quotation_items": [ { "name": "Cableado", "description": "Tendido de cables", "children": [ { "type": "simple", "name": "Tableros" }, { "type": "sin costo unitario", "name": "Cable THW 2.5 mm", "quantity": 120, "utility": 10, "measurement_unit": { "name": "Metro", "abbreviation": "m" }, "provider_product": { "price": 3.2, "code": "CAB-25", "product": { "name": "Cable THW 2.5 mm", "code": "P-0040", "brand": { "name": "Indeco" }, "measurement_unit": { "name": "Metro", "abbreviation": "m" } }, "provider": { "document_number": "20123456789", "name": "ELECTRO SUR SAC" } } }, { "type": "costo unitario", "name": "Tendido de cable", "quantity": 80, "unit_cost": { "yield": 1, "workday": 8, "measurement_unit": { "name": "Metro", "abbreviation": "m" }, "unit_cost_materials": [], "unit_cost_workforces": [], "unit_cost_equipment_tools": [], "unit_cost_subcontracts": [] } } ] } ] }}Cómo se interpreta cada hijo
Sección titulada «Cómo se interpreta cada hijo»Cada elemento de children se clasifica en este orden:
| Condición | Resultado |
|---|---|
type es simple y no trae provider_product_id ni unit_cost_id |
Subtítulo (nivel 2) sin costo. |
type es sin costo unitario, o trae provider_product_id sin unit_cost_id |
Producto directo: se crea un costo unitario con un solo material (quantity del hijo como cantidad del ítem y utility como porcentaje de utilidad). Si falta provider_product o su product, se omite con una advertencia. |
Trae unit_cost |
Costo unitario completo con su desglose. |
| Cualquier otro caso | Se ignora sin advertencia. |
Un costo unitario completo toma de unit_cost: description, yield (por defecto 1), workday (por defecto 8) y measurement_unit (obligatoria; sin ella se omite el ítem con una advertencia). Su desglose se lee de estas listas, y cada elemento acepta quantity, utility y, según el caso, resource:
| Lista | Cómo se resuelve cada elemento |
|---|---|
unit_cost_materials |
Con provider_product (y su product, brand, provider) o product. Se busca o se crea el producto, la marca, el proveedor y el producto de proveedor. Sin producto se omite con advertencia. |
unit_cost_workforces |
Se busca la mano de obra por code o por name. Si no existe, se omite con advertencia. |
unit_cost_equipment_tools |
Se busca el equipo o herramienta por code o por name. Si no existe, se omite con advertencia. |
unit_cost_subcontracts |
Se busca el subcontrato por name o code; si no existe se crea. Se enlaza a un proveedor genérico con la moneda en soles. |
Qué crea el servidor
Sección titulada «Qué crea el servidor»- Los ítems raíz se agregan después de los ítems existentes de la cotización (continúan el índice máximo).
- Los ítems de costo unitario se crean con la moneda y el valor de la moneda de la cotización destino, y los decimales de la cotización.
- Las unidades de medida, marcas, productos, proveedores y subcontratos que no existen se crean y llevan el prefijo
[IMPORTADO]en la descripción (la marca sin nombre usaGENÉRICO). Las existentes se buscan por abreviatura, nombre, código o número de documento, sin distinguir mayúsculas. - Al terminar, en una sola pasada se recalculan los totales de los costos unitarios, de los ítems y de la cotización.
- Todo ocurre en una transacción: si algo falla, no se guarda nada.
Resultado
Sección titulada «Resultado»La respuesta incluye el conteo de lo creado en imported y una lista de warnings con lo que se omitió. Ver Importar ítems.
