Ir al contenido

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.

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": []
}
}
]
}
]
}
}

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.
  • 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 usa GENÉ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.

La respuesta incluye el conteo de lo creado en imported y una lista de warnings con lo que se omitió. Ver Importar ítems.