{"info":{"_postman_id":"b3e9218d-6490-449e-b991-884812a10401","name":"WMS Middleware Hub - Los Rosales","description":"# API Middleware de Integraci\u00f3n: ERP Flexline <-> Enfasys WMS\n\nEspecificaci\u00f3n de endpoints del Middleware de Integraci\u00f3n para el **CD Los Rosales** (Owner: `LOSROSALES`, Dep\u00f3sito: `006`).\n\nBasado en el **Dise\u00f1o Funcional Detallado (DFD) ENFASYS WMS LOS ROSALES v1.4** (Valgreti \/ Los Rosales).","schema":"https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json"},"variable":[{"key":"base_url","value":"https:\/\/wms.thomas.com.pe\/api\/v1","type":"string"}],"item":[{"name":"1. Maestros (Cat\u00e1logos)","description":"Endpoints para la sincronizaci\u00f3n unificada de cat\u00e1logos maestros desde Flexline\/Tablero hacia Enfasys WMS.","item":[{"name":"POST Sincronizar Maestros (Items)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"entidad\": \"ITEMS\",\n  \"data\": [\n    {\n      \"CodItem\": \"SKU-10020\",\n      \"NomItem\": \"Taladro Inal\u00e1mbrico 20V\",\n      \"Articulo\": \"TLD-20V\",\n      \"CodUnidadMedida\": 1,\n      \"Vigente\": \"S\",\n      \"ControlaLote\": \"N\",\n      \"ControlaSerie\": \"S\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/maestros","host":["{{base_url}}"],"path":["maestros"]},"description":"Sincroniza cat\u00e1logo de SKUs y c\u00f3digos de barra directamente hacia `\/api\/WMS_Admin\/CreateItem`."},"response":[{"name":"200 \u00c9xito","status":"OK","code":200,"_postman_previewlanguage":"json","body":"{\n  \"success\": true,\n  \"status\": 200,\n  \"message\": \"ITEMS sincronizados con Enfasys exitosamente\",\n  \"enfasys_response\": {\n    \"totalRegistros\": 1,\n    \"errors\": null,\n    \"status\": 200\n  },\n  \"duration_ms\": 245\n}"}]},{"name":"POST Sincronizar Maestros (Clases)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"entidad\": \"CLASES\",\n  \"codTipoItemClase\": 1,\n  \"data\": [\n    {\n      \"codItemClase\": \"HERR\",\n      \"nomItemClase\": \"Herramientas El\u00e9ctricas\",\n      \"alias\": \"HERRAMIENTAS\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/maestros","host":["{{base_url}}"],"path":["maestros"]}},"response":[]}]},{"name":"2. Inbound (Recepciones)","description":"Inyecci\u00f3n de \u00f3rdenes de entrada y notificaci\u00f3n de cierre de recepci\u00f3n f\u00edsica desde Enfasys a Flexline.","item":[{"name":"POST Inyectar Orden de Entrada","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"nroDocumento\": \"OC-50201\",\n  \"codProveedor\": \"PRV-001\",\n  \"contenedor\": \"MSKU948210-4\",\n  \"observacion\": \"Embarque mar\u00edtimo puerto Valpara\u00edso\",\n  \"lineas\": [\n    {\n      \"codItem\": \"SKU-10020\",\n      \"cantidadEsperada\": 500,\n      \"lpn\": \"LPN-001928\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/documentos\/entrada\/importacion","host":["{{base_url}}"],"path":["documentos","entrada","importacion"]}},"response":[]},{"name":"POST Confirmar Cierre Recepci\u00f3n","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"nroDocumentoEntrada\": \"OC-50201\",\n  \"tipoDocumento\": \"OCI\",\n  \"fechaCierre\": \"2026-09-26T14:30:00Z\",\n  \"usuarioWms\": \"OPER_BODEGA_1\",\n  \"lineas\": [\n    {\n      \"codItem\": \"SKU-10020\",\n      \"cantidadRecibida\": 500,\n      \"cantidadFaltante\": 0,\n      \"lpn\": \"LPN-001928\",\n      \"ubicacionDestino\": \"RACK-01-A-02\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/recepciones\/confirmar","host":["{{base_url}}"],"path":["recepciones","confirmar"]},"description":"Gatillado por Enfasys WMS al pulsar 'Cerrar Recepci\u00f3n' en la Web (DFD L195)."},"response":[{"name":"200 \u00c9xito","status":"OK","code":200,"_postman_previewlanguage":"json","body":"{\n  \"success\": true,\n  \"status\": 200,\n  \"message\": \"Recepci\u00f3n confirmada en ERP Flexline\",\n  \"flexline_recepcion_id\": \"REC-7721\",\n  \"unidades_actualizadas\": 500\n}"}]},{"name":"POST Notificar Devoluci\u00f3n Recibida","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"nroDevolucionWms\": \"DEV-4401\",\n  \"tipoDevolucion\": \"RETAIL_CONTRA_FACTURA\",\n  \"tipoDocumentoFiscalOriginal\": \"FACTURA_ELECTRONICA\",\n  \"folioFiscalOriginal\": \"104920\",\n  \"lineas\": [\n    {\n      \"codItem\": \"SKU-10020\",\n      \"cantidadDevuelta\": 2,\n      \"motivoDevolucion\": \"Caja da\u00f1ada\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/recepciones\/devolucion","host":["{{base_url}}"],"path":["recepciones","devolucion"]}},"response":[]}]},{"name":"3. Comercial & Precios (Salidas - Tiempo 1)","description":"Validaci\u00f3n comercial de pedidos B2B cubicados y generaci\u00f3n de Notas de Venta en Flexline.","item":[{"name":"POST Validar Precios y Generar NV (B2B)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"nroPedidoWms\": \"PED-B2B-1029\",\n  \"codCliente\": \"FALABELLA_RETAIL\",\n  \"tipoDocumentoFiscalSolicitado\": \"FACTURA\",\n  \"lineas\": [\n    {\n      \"codItem\": \"SKU-10020\",\n      \"cantidadSolicitada\": 120\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/precios\/validar\/b2b","host":["{{base_url}}"],"path":["precios","validar","b2b"]},"description":"DFD L485: Enfasys consulta al ERP para validar SKUs y precios de lista, generando la Nota de Venta correspondiente."},"response":[{"name":"200 Aprobado","status":"OK","code":200,"_postman_previewlanguage":"json","body":"{\n  \"success\": true,\n  \"status\": 200,\n  \"validacion\": \"APROBADO\",\n  \"folioNotaVenta\": \"NV-88491\",\n  \"cliente\": \"FALABELLA_RETAIL\",\n  \"totalNeto\": 1440000,\n  \"moneda\": \"CLP\"\n}"}]}]},{"name":"4. Outbound & DTE (Salidas - Tiempo 2)","description":"Confirmaci\u00f3n de pedidos en Predespacho, emisi\u00f3n de DTEs fiscales (Facturas\/Gu\u00edas) y retorno de folios a Enfasys.","item":[{"name":"POST Confirmar Despacho y Emitir DTE (B2B)","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"nroPedidoWms\": \"PED-B2B-1029\",\n  \"folioNotaVenta\": \"NV-88491\",\n  \"tipoDTE\": \"FACTURA\",\n  \"bultosTotales\": 8,\n  \"lineas\": [\n    {\n      \"codItem\": \"SKU-10020\",\n      \"cantidadPreparada\": 120,\n      \"codigoPik\": \"PIK-001\",\n      \"codigoPallet\": \"PAL-99\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/salidas\/confirmar\/b2b","host":["{{base_url}}"],"path":["salidas","confirmar","b2b"]},"description":"DFD L469: Pedido alcanza PREDESPACHO. Flexline emite la Factura Electr\u00f3nica y devuelve el Folio fiscal a WMS."},"response":[{"name":"200 Factura Emitida","status":"OK","code":200,"_postman_previewlanguage":"json","body":"{\n  \"success\": true,\n  \"status\": 200,\n  \"tipoDTE\": \"FACTURA_ELECTRONICA\",\n  \"folioDTE\": \"104920\",\n  \"fechaEmision\": \"2026-09-26T16:00:00Z\",\n  \"pdfUrl\": \"https:\/\/dte.losrosales.cl\/docs\/104920.pdf\",\n  \"mensaje\": \"Factura generada y rebaja de stock contable aplicada\"\n}"}]}]},{"name":"5. Transferencias (Bodegas Virtuales ERP)","description":"Notificaci\u00f3n de traslados a ubicaciones vinculadas a Bodegas ERP (Da\u00f1ados, ST, Certificaci\u00f3n, Bajas).","item":[{"name":"POST Transferencia a Bodega ERP","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"bodegaOrigen\": \"006\",\n  \"bodegaDestinoErp\": \"BOD_DANADOS\",\n  \"motivo\": \"Reclasificaci\u00f3n por control de calidad\",\n  \"skus\": [\n    {\n      \"codItem\": \"SKU-10020\",\n      \"cantidad\": 5,\n      \"lpn\": \"LPN-0029\",\n      \"lote\": \"L-2026-A\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/transferencias\/bodegas\/item","host":["{{base_url}}"],"path":["transferencias","bodegas","item"]},"description":"DFD L372: Movimiento de SKU o LPN en PDA hacia ubicaci\u00f3n de Bodega ERP. Flexline ejecuta el traslado contable."},"response":[{"name":"200 Traspaso Exitoso","status":"OK","code":200,"_postman_previewlanguage":"json","body":"{\n  \"success\": true,\n  \"status\": 200,\n  \"message\": \"Traspaso entre bodegas ejecutado en Flexline\",\n  \"folioTraslado\": \"TRAS-1109\",\n  \"bodegaDestino\": \"BOD_DANADOS\"\n}"}]}]},{"name":"6. Inventario & Ajustes (Lost & Found)","description":"Notificaci\u00f3n de diferencias y mermas acumuladas en ubicaci\u00f3n Lost & Found para cuadratura contable.","item":[{"name":"POST Notificar Ajuste Lost & Found","request":{"method":"POST","header":[{"key":"Content-Type","value":"application\/json"},{"key":"Accept","value":"application\/json"}],"body":{"mode":"raw","raw":"{\n  \"tipoAjuste\": \"NEGATIVO\",\n  \"origen\": \"CONTEO_CICLICO\",\n  \"fechaAjuste\": \"2026-09-26T15:00:00Z\",\n  \"items\": [\n    {\n      \"codItem\": \"SKU-10020\",\n      \"cantidad\": 1,\n      \"ubicacionOrigen\": \"RACK-02-B-01\",\n      \"motivo\": \"Diferencia f\u00edsica en conteo c\u00edclico pasillo 2\"\n    }\n  ]\n}"},"url":{"raw":"{{base_url}}\/inventario\/ajustes","host":["{{base_url}}"],"path":["inventario","ajustes"]},"description":"DFD L778, L885: Notificaci\u00f3n de merma o sobrante en Lost & Found para ajuste contable en Flexline."},"response":[{"name":"200 Ajuste Contabilizado","status":"OK","code":200,"_postman_previewlanguage":"json","body":"{\n  \"success\": true,\n  \"status\": 200,\n  \"message\": \"Ajuste contable procesado en Flexline\",\n  \"folioAjusteErp\": \"AJU-9921\",\n  \"unidadesAjustadas\": -1\n}"}]}]},{"name":"7. Sistema & Salud","description":"Verificaci\u00f3n de operatividad del Middleware Hub.","item":[{"name":"GET Health Check","request":{"method":"GET","header":[{"key":"Accept","value":"application\/json"}],"url":{"raw":"{{base_url}}\/health","host":["{{base_url}}"],"path":["health"]}},"response":[]}]}]}