Síntesis Pilotaje FTL

📊 Carga de Datos — Lote Habitat (2026-06-10)

Estado de registros cargados en BD para el lote más completo de Habitat. CP9 despacho cerrado.

CP	Archivo / Fuente	Registros / Campos	Notas
CP1	Recepción tela	11 registros	—
CP2	Reasignación OP	46 registros	—
CP2	Transferencias materiales	4,143 registros	—
CP3	Guía retorno lavandería	1 registro	Solo partida `26-1874` — las otras 7 partidas no tienen CP3 salida en BD
CP7	Inspección calidad	78 registros	—
CP9	Factura × 3	1 campo c/u	3 facturas parseadas, 1 campo por factura
CP9	BL (Bill of Lading)	4 campos	`bl_number`, `container`, puertos (origen/destino)
CP9	DAM	12 campos	`numero_dam`, `fob`, `aduana`, etc.
CP9	Guía + Booking	Parseados	Datos extraídos, sin campos directos en modelo `Despacho`
CAT	Tipos de lavado	30 tipos activos	Catálogo cargado
—	upload_audits	12 registros	Tabla ya no está vacía
REF	SERVICIOS - PLANTA TRENTO.xlsx	Cargado	Servicios de terceros por PO/OP ejecutados en planta Trento — referencia cruzada CP3, CP6, CP8 `piloto-habitat\SERVICIOS-TRENTO\`

📈 Resumen Ejecutivo

✅ CP1

Completamente Implementado

32

Archivos Identificados

0 🔴

Bloqueadores Críticos Activos

9-10

Cargas/Embarque

10-20 días

Timeline Estimado

0

Contradicciones

🎯 Estado Actual — Granularidad Backend / Web / Mobile

Actualizado 2026-06-10 · ✅ listo · ⚠️ parcial/pendiente confirmación · ❌ bloqueado

CP	Nombre	Backend	Frontend Web	Mobile App
CP1	Ingreso Tela	✅ Completo	✅ Carga Guía Recepción	✅ Escáner + peso
CP2	Corte Paños	✅ Completo reasignacion_tela + migración 061 aplicada	✅ Upload Transferencias + Reasignación	⚠️ Merma manual
CP3	Lavado Externo	✅ PDF parser listo guia_retorno_lavanderia_parser.py	✅ Upload PDF (UI lista)	⚠️ Comparativa peso retorno
CP4	Corte Piezas	✅ Completo	✅ Upload CORTE-HBT	⚠️ Merma manual
CP5	Habilitado (Avíos)	⚠️ Modelo OK, upload pendiente Campo guia_avios creado, falta lógica carga	✅ Upload archivo avíos (UI lista)	⚠️ Balanza báscula
CP6	Costura	✅ Completo guia_servicio_costura (mig060) + auditoria_pdf (mig066)	✅ Upload PDF (UI lista)	⚠️ Lectura guía física
CP7	Inspección QC	✅ Completo	✅ Upload DATA-CP7	⚠️ Clasificación defectos
CP8	Acabados	⚠️ Modelo OK, upload pendiente Hoja AVÍOS ACABADOS (Jenny)	✅ Upload Packing List + avíos (UI lista)	⚠️ Lectura packing list
CP9	Despacho	✅ Parsers Completos Todos los parsers CP9 implementados (2026-06-10)	✅ UI lista (6 subpáginas)	⚠️ Lectura documentación

🔴 Bloqueadores Críticos

CP	Bloqueador	Responsable	Urgencia
CP2	~~Archivo Reasignación OP (partida → OP)~~ — RESUELTO Archivo recibido. Modelo `reasignaciones_tela` + migración 061 aplicada en Railway 2026-06-09.	✅ Trento (Jemima Romero)	✅ Resuelto
CP3	~~Guía retorno lavandería (PDF)~~ — RESUELTO Parser `guia_retorno_lavanderia_parser.py` implementado. GUÍA DE REMISIÓN ELECTRÓNICA en PDF parseada.	✅ Backend	✅ Resuelto
CP3	7 de 8 partidas sin CP3 salida en BD — solo `26-1874` cargada	Backend / Datos	🟡 Investigar
CP5	~~ARCHIVO DE CONSUMO DE AVÍOS PARA HABILITADO (.xls)~~ — RESUELTO Hoja AVÍOS COSTURA en TRANSFERENCIAS MATERIALES-PP entregada por Jenny (D3, 2026-06-09).	✅ Jenny (QLEVER)	✅ Resuelto
CP5	Confirmar cálculo kg avíos	CORE	🟡 Media
CP6	~~PDFs auditoría costura~~ — RESUELTO Parser + UI: `upload-auditoria` endpoint + `auditoria-costura.astro`. `costuras.auditoria_archivo_url` en BD (mig 066).	✅ Backend+Frontend	✅ Resuelto
CP6	Verificar campo `guia_servicio_costura` en modelo `Costura` (migración 060) — CONFIRMADO	Backend	✅ Confirmado
CP8	~~ARCHIVO DE CONSUMO DE AVÍOS PARA ACABADOS (.xls)~~ — RESUELTO Hoja AVÍOS ACABADOS en TRANSFERENCIAS MATERIALES-PP entregada por Jenny (D3, 2026-06-09).	✅ Jenny (QLEVER)	✅ Resuelto
CP9	6 documentos de prueba comercio exterior (PDF) — parsers listos	Fintech Lab	🟡 Media

🗃️ Filtros TRANSFERENCIAS MATERIALES-PP por CP

Archivo actualizado: TRANSFERENCIAS MATERIALES-PP -- 09-06.xlsx (QLEVER). Actualizado 2026-06-09.
⚠️ Parseo: los valores usan espacios no-breaking (\xa0) — normalizar con .replace('\xa0', ' ').strip().

📄 Hoja 1: TRANSFERENCIAS TELAS + PRENDAS
CP2, CP3, CP4 — Número Guía idx 4 · Or. Nro idx 16 = OP · Almacén idx 19 · Almacén Destino idx 20

📄 Hoja 2: AVÍOS COSTURA D3 ✓ Jenny
CP5, CP6 — Número Guía idx 3 · Proyecto idx 16 = OP · Razón Social = taller costura

📄 Hoja 3: AVÍOS ACABADOS D3 ✓ Jenny
CP8 — Número Guía idx 4 · Proyecto idx 17 = OP · Razón Social = taller acabados

CP	Uso	Almacén Origen	Almacén Destino	Campo sistema	Filas históricas
CP2	Reasignación OP (kilos tela)	`ALMACEN DE CAMBIO (REASIGNACIONES)`	`ALMACEN DE CORTE DE TELA EN PAÑOS PP`	— validación kg	⚠️ Confirmar archivo actualizado Andrea
CP3	Guía envío a lavandería	`ALMACEN DE CORTE DE TELA EN PAÑOS PP`	`ALMACEN DE LAVADO DE TELA EN PAÑOS PP`	`Lavado.guia_remision_salida` ← `Número Guía`	17 filas ✓
CP3	Guía retorno de lavandería	`ALMACEN DE LAVADO DE TELA EN PAÑOS PP`	`ALMACEN DE TELA PARA TRANSFORMACION DE CORTE`	`Lavado.guia_remision_retorno` ← `Número Guía`	41 filas ✓
CP5	Guía de avíos (habilitado)	Hoja AVÍOS COSTURA — `ALMACEN DE MATERIAS PRIMAS AVIOS → ALMACEN DE PRODUCTOS INTERMEDIOS` Filtro OP: `Proyecto` (idx 16) · `Número Guía` idx 3		`CierreQA.guia_avios` campo nuevo	478 filas ✓ (nuevo)
CP6	Guía servicio costura	Hoja AVÍOS COSTURA — mismo documento que CP5 (a confirmar) `Razón Social` (idx 6) = taller costura · `Número Guía` idx 3		`Costura.guia_servicio_costura` campo nuevo	⚠️ confirmar
CP8	Consumo avíos acabados	Hoja AVÍOS ACABADOS — `ALMACEN DE MATERIAS PRIMAS AVIOS → ALMACEN DE PRODUCTOS INTERMEDIOS` Filtro OP: `Proyecto` (idx 17) · `Número Guía` idx 4		— ✓ Hoja AVÍOS ACABADOS	144 filas ✓ (nuevo)

📋 SERVICIOS - PLANTA TRENTO.xlsx — piloto-habitat\SERVICIOS-TRENTO\
Permite saber, para esta PO y sus OPs, qué servicios de terceros se ejecutaron en planta Trento. Relevante para validar flujos de CP3 (lavandería), CP6 (costura) y CP8 (acabados) donde intervienen proveedores externos.

CP2 — nota
"Almacén de resignaciones" como origen fue confirmado en reunión 2026-06-05 (Andrea Valencia). Solo 1 fila en el Excel histórico actual porque el archivo está siendo actualizado (Andrea agrega campo partida).

CP5 — nota
478 filas en hoja AVÍOS COSTURA — flujo confirmado reunión 2026-06-05. Archivo entregado por Jenny (D3 ✅ 2026-06-09). Falta implementar lógica de upload en backend.

CP8 — nota
144 filas en hoja AVÍOS ACABADOS — entregada por Jenny (D3 ✅ 2026-06-09). Falta implementar lógica de upload en backend. Filtro a confirmar.

✅ Qué Puede Adelantar Franco (Sin Bloqueadores)

Funcional	Backend	Frontend Web	Mobile App
CP1: Recepción Tela ✅ COMPLETAMENTE IMPLEMENTADO	✅ Implementado: • Modelo Rollo • GET partidas (Guía Recepción) • POST recepción_tela • Validación kilos • Parámetro peso para CP2	✅ Implementado: • "Carga de Datos" • "Guía de Recepción de tela" • (en app-astro-dashboard)	✅ Implementado: • Pantalla CP1 • Escáner/Input partida • Campo peso (recibe backend) • Captura timestamp • (en app-mobile)
CP2: Corte Paños ✅ D1 Resuelto	• Modelo OP/Lote • Modelo Merma • POST merma • Validación merma • SELECT OP ✅ (reasignaciones_tela)	✅ Implementado: • Upload TRANSFERENCIAS • Preview datos • Selector OP (pending) • Ingreso merma	• Captura merma manual • Validación peso • Histórico mermas
CP3: Lavandería ✅ Adelanta	• Modelo Lavado • POST cargas • Validación peso • Cálculo merma	✅ Implementado: • Upload TRANSFERENCIAS • Upload Guía retorno • Preview validaciones	• Captura merma retorno • Comparativa peso
CP4: Corte Piezas ✅ Adelanta	• Modelo Corte • POST cargas • Validación proveedor • Cálculo merma	✅ Implementado: • Upload CORTE-HBT • Identificar interno/externo • Ingreso merma	• Registro proveedor externo • Captura merma
CP5: Habilitado (Avíos) ⚠️ Upload lógica pendiente	• Modelo Avíos • POST pesaje • Validación vs teórico • Cálculo consumo — falta lógica upload hoja AVÍOS COSTURA	✅ Implementado: • Upload archivo avíos • Ingreso pesaje manual • Comparativa teórico	• Balanza báscula • Captura peso avíos
CP6: Costura ✅ Completo	• Modelo Costura ✅ • POST auditoría ✅ • Upload PDF auditoría ✅ (`auditoria-costura.astro`) • `guia_servicio_costura` ✅ (mig 060)	✅ Implementado: • Upload PDF • Ingreso cantidad • Estado aprobado/rechazado	• Lectura guía física
CP7: Inspección ✅ Adelanta	• Modelo Inspección • POST clasificación • Validación totales	✅ Implementado: • Upload DATA-CP7 • Ingreso primera/segunda/reparación • Consolidación por OP	• Registro clasificación • Captura defectos
CP8: Acabados ⚠️ Upload lógica pendiente	• Modelo Acabado • POST validación • Validación packing — falta lógica upload hoja AVÍOS ACABADOS	✅ Implementado: • Upload Packing List • Upload avíos • Comparativa inspeccionado	• Lectura packing list
CP9: Despacho ✅ Parsers Listos	• Modelo Despacho • POST documentos ✅ • Parsers: Factura, Guía, BL, DUA, DAM, Booking • Generación reporte	✅ Implementado: • Upload 6 documentos (Factura, Guía, BOL, DUA, DAM, Booking) • Submenu desplegable • Validación referencias cruzadas	• Lectura documentación
Validaciones Generales ✅ Adelanta	• Validar kilos (CP1-CP9) • Validar merma • Validar cantidades • Validar fechas	• Mensajes error/éxito • Alertas validación • Tooltips ayuda	• Feedback usuario • Validación offline
EPCIS Events 🟡 Espera F4	• Generador EPCIS • eventos CP1-CP9 • Integración huella carbono (pending)	• Visualización eventos • Timeline trazabilidad	• Timeline móvil

UI Carga de Documentos (CP2-CP9): ✅ Completamente implementada con sidebar tags CP, submenu desplegable CP9, y componente FileUploadZone reutilizable. Flujo CP1→CP2: CP1 busca partida en Guía de Recepción → CP2 busca OP en Archivo Reasignación. (D1) y (D3/D4) son bloqueadores que Denis está gestionando.

📚 Documentos Disponibles

📑 INDICE.md

Índice completo, flujos de lectura, checklist pilotaje, responsables

Abrir

📋 README.md

Guía rápida (5 min), quick reference, próximos pasos

Abrir

🗂️ mapeo_archivos_por_cp.md

32 archivos CP1-CP9, estado, bloqueadores (6), flujo carga

Abrir MD CSV

📊 estimacion_puntos_carga.md

Puntos estimados, timeline (10-20 días), escenario OP-6989, criterios aceptación

Abrir

📝 resumen_reunion_2026_06_08.md

Decisiones de proceso filtradas, CP1-CP9 desglosadas, action items

Abrir

✅ VALIDACION_EJECUTIVA.md

Status aprobado, hallazgos, cambios recomendados, conclusión

Abrir

🔍 VALIDACION_CRUZADA_2026_06_05_vs_08.md

Análisis histórico, CP por CP, cambios/omisiones/evoluciones

Abrir

🎯 Action Items Inmediatos

Para Franco (F1-F6)

✓ F1: Mapear documentos → DONE (este sitio)
□ F2: Confirmar Andrés → servidor (Dev+Cert)
□ F3: Revisar Denis → validar SW + pendientes
□ F4: Finalizar → huella carbono + residuos
□ F5: Probar → residuos con datos reales
□ F6: Agendar → reunión Kenneth

Para Denis (D1-D4)

✓ D1: Archivo reasignación PARTIDA → OP recibido y procesado — backend listo (2026-06-09)
□ D2: Cambiar formato → nombres MAYÚSCULAS
✓ D3: Jenny entregó archivo con 3 hojas: TELAS+PRENDAS, AVÍOS COSTURA, AVÍOS ACABADOS (2026-06-09)
✓ D4: PDFs comercio exterior recibidos y parseados (CP9 parsers completos, 2026-06-10)

Próximas Reuniones

✓ Mañana 11:00 → Revisión CP7
✓ Mañana 14:00 → Cierre pendientes
✓ Esta semana → Resolver 6 bloqueadores

⏱️ Timeline Estimado

🟢

Sin bloqueadores: 10-11 días

1 embarque completo CP1→CP9

🔴

Con bloqueadores: 15-20 días

Espera de archivos pendientes (5-10 días)

📊

Cargas por embarque: 9-10

CP1 (1) + CP2-CP9 (8 cargas operativas)

ℹ️ Cambios vs Histórico (2026-06-05)

✏️ Clarificaciones Explícitas (3)

CP3: Por OP (no por partida) ← Aclaración importante
CP8: Packing List FINAL (no pre-packing)
CP2: Reasignación ahora explícita como PENDIENTE

📈 Evolución de Scope (1)

CP5: De operativo (unidades) → operativo + cuantitativo (kilos ahora)
Cambio deliberado, coherente con necesidad de huella carbono

✏️ Correcciones (3)

CP1: Flujo corregido — Input es PARTIDA (no OC). Lookup en Guía Recepción por número de partida
CP5/CP8: Terminología corregida — "ARCHIVO DE CONSUMO DE AVÍOS" (no TRANSFERENCIAS)
CP9: Confidencialidad documentos (importante recordar)

Conclusión: Cero contradicciones. Cambios son evoluciones lógicas de scope.

🔍 Decisiones Técnicas — Abiertas y Resueltas (2026-06-10)

Preguntas que surgieron durante la sesión de implementación de codificación EPCIS. Estado al 2026-06-10.

#	CP	Pregunta	Estado	Decisión / Acción
1	CP6	Fuente de `guia_servicio_costura`	✅ DECIDIDO	Hoja AVÍOS COSTURA del Excel — `Número Guía` índice 3, filtro `Proyecto` (índice 16) = OP. `RUC/Razón Social` identifica el taller de costura.
2	CP8	¿El campo "PO" es `Rollo.orden_compra_marca`?	✅ RESUELTO	Piloto Habitat confirma: PO = `1894` (Habitat FA26) → campo `Rollo.orden_compra_marca`. Valor real validado en codificación EPCIS CP8.
3	CP9	¿Campo primario "PO" = `Rollo.orden_compra_marca`?	✅ RESUELTO	Piloto Habitat confirma: CP9 `(10)1894(240)F001-00005489` — PO = `1894` (mismo que CP8), Factura = `F001-00005489`. Campo correcto: `Rollo.orden_compra_marca`, distinto de OC Tela (`Rollo.orden_compra`).
4	CP2-9	¿`bizTransactionList` EPCIS también cambia con las correcciones de campo? ¿O solo el GS1-128 del QR?	⚠️ RE-VERIFICAR	Implementación previa dice "sí, alineados". Tras correcciones CP8/CP9 (PO pendiente), re-verificar que `bizTransactionList` refleje el campo correcto. Propósito: alinear GS1-128 y EPCIS bizTxn.
5	Migración	Migraciones 060 y 061 en Railway	✅ APLICADO	Migraciones 059, 060 (`guia_avios`, `guia_servicio_costura`) y 061 (`reasignaciones_tela`) aplicadas en Railway el 2026-06-09. `load_dotenv` agregado a `migrations/env.py`.
6	CP5/CP6	¿CP5 y CP6 comparten el mismo `Número Guía`?	⚠️ PENDIENTE	En el dato real: OP-6987 tiene `Número Guía = 22407` en hoja AVÍOS COSTURA para ambos. Confirmar si son el mismo documento o si existe guía separada para el servicio de costura.
7	CP6	Modelo `Costura` no tiene `guia_servicio_costura`. ¿Mismo caso que CP5 (`CierreQA.guia_avios`)?	✅ VERIFICADO	Mig 060 confirma `costuras.guia_servicio_costura` varchar(100). Mig 066 confirma `costuras.auditoria_archivo_url` varchar(255). No requiere mig 062.

Nota AVÍOS COSTURA sheet
La hoja usa Número Guía en índice 3 (sin columna vacía en col 3), distinto al índice 4 de la hoja principal. Or. Nro vacío — usar Proyecto (idx 16) para filtrar por OP. Razón Social = taller costura (TEXTILES ANGGYTEX, TEXTIBELA, etc.).

Nota D3 de Denis — RESUELTO
El archivo separado de avíos habilitado + acabados que pedía Jenny ya existe en el nuevo Excel (3 hojas separadas): AVÍOS COSTURA y AVÍOS ACABADOS. El bloqueador D3 queda levantado con este archivo.

⚙️ Estado Implementación: Codificación EPCIS / GS1-128 por CP

Change: correccion-codificacion-epcis-cp1-cp9 | Actualizado 2026-06-10 | ⚠️ Pendientes: CP6 campo modelo, CP8/CP9 PO, bizTxn re-verificar

CP	AI(10) — Campo 1	AI(240) — Campo 2	GS1-128	EPCIS bizTxn	Fuente campo 2
CP1	`Rollo.orden_compra`	`Rollo.lote_proveedor`	✅ sin cambio	✅ po incluida	Directo del Rollo
CP2	`op_nombre`	`Lavado.guia_remision_salida`	✅	✅ desadv→guía envío	TELAS+PRENDAS: `CORTE PAÑOS PP → LAVADO PP`
CP3	`op_nombre`	`Lavado.guia_remision_retorno`	✅	✅ solo retorno	TELAS+PRENDAS: `LAVADO PP → TELA TRANSFORMACION CORTE`
CP4	`op_nombre`	`Lote.hoja_corte_id`	✅	✅ sin cambio	CORTE-HBT.xlsx
CP5	`op_nombre`	`CierreQA.guia_avios`	✅ campo DB creado	⚠️ upload pendiente	Hoja AVÍOS COSTURA — `Número Guía` idx 3, `Proyecto` idx 16 = OP
CP6	`op_nombre`	`Costura.guia_servicio_costura`	✅ campo DB creado	⚠️ upload + confirmar fuente	Hoja AVÍOS COSTURA — mismo `Número Guía` que CP5 (a confirmar)
CP7	`op_nombre`	`Rollo.estilo`	✅	✅ desadv→estilo	Lookup lote→pano→rollo
CP8	`op_nombre`	`Rollo.orden_compra_marca` ❓	⚠️ confirmar PO	⚠️ confirmar PO	Hoja AVÍOS ACABADOS — `Número Guía` idx 4, `Proyecto` idx 17 = OP
CP9	`Rollo.orden_compra_marca` ❓	`Despacho.factura_exportacion`	⚠️ confirmar PO	✅ po+inv	PO del cliente; factura de CP9 despacho

Estado deploy (2026-06-09):

✅ Migración 060 aplicada en Railway (guia_avios, guia_servicio_costura)
✅ Migración 061 aplicada en Railway (reasignaciones_tela)
⚠️ Implementar lógica de upload para poblar guia_avios (CP5) y guia_servicio_costura (CP6) desde Excel AVÍOS COSTURA
⚠️ Verificar panel EPCIS dashboard: tareas 9.3 y 9.4

🧪 Codificación EPCIS — Piloto Habitat (OP-6989)

Valores reales del lote piloto. CP8/CP9: PO = 1894 confirma que el campo es orden_compra_marca (decisiones técnicas #2 y #3 resueltas).

OP	`OP-6989`
Partida	`26-01875`
PO	`1894` (Habitat FA26)
GTIN	`62076b7f3c4701`
Estilo	`27553` — SHIRTTAIL TEE

CP	Nombre	Evento EPCIS	Doc 1 (type)	Valor Doc 1	Doc 2 (type)	Valor Doc 2	Concepto Doc 2
CP1	Recepción Tela	`ObjectEvent`	`po`	`3-2026-39`	`desadv`	`26-01875`	Partida de tela
CP2	Corte Paños	`TransformationEvent`	`prodorder`	`OP-6989`	`desadv`	`T001-22191`	Guía remisión lavado envío
CP3	Lavado Externo	`ObjectEvent`	`prodorder`	`OP-6989`	`desadv`	`EG07-00001390`	Guía remisión lavado retorno
CP4	Corte Piezas	`TransformationEvent`	`prodorder`	`OP-6989`	`desadv`	`26-01875`	Orden de corte
CP5	Cierre QA	`AggregationEvent`	`prodorder`	`OP-6989`	`desadv`	❓ pendiente	Guía de avíos
CP6	Costura	`TransformationEvent`	`prodorder`	`OP-6989`	`desadv`	❓ pendiente	Guía servicio costura
CP7	Inspección QC	`ObjectEvent`	`prodorder`	`OP-6989`	`desadv`	`27553`	Estilo
CP8	Acabados	`AggregationEvent`	`prodorder`	`OP-6989`	`po`	`1894`	PO cliente ✅ confirmado
CP9	Despacho	`ObjectEvent`	`po`	`1894`	`inv`	`F001-00005489`	Factura exportación

📋 Correspondencia Guías CP2→CP3 — 8 partidas Habitat

EG07 = guía retorno lavandería (CP3) · T001 = guía envío lavado (CP2) · O/S = Orden de Servicio lavandería.
▶ 26-1874 es la única partida con CP3 cargada en BD actualmente.

EG07 (retorno)	Partida	Guía envío (T001)	O/S lavandería	Estado CP3
`EG07-00001390`	26-1874	`T001-22191`	`7-2026-595`	✅ Cargada en BD
`EG07-00001388`	26-1876	`T001-22192`	`7-…`	⚠️ Pendiente
`EG07-00001414`	26-1877	`T001-22363`	`7-2026-654`	⚠️ Pendiente
`EG07-00001391`	26-1878	`T001-22193`	`7-…`	⚠️ Pendiente
`EG07-00001389`	26-1879	`T001-22194`	`7-…`	⚠️ Pendiente
`EG07-00001404`	26-1880	`T001-…`	`7-2026-611`	⚠️ Pendiente
`EG07-00001408`	26-1882	`T001-…`	`7-2026-603`	⚠️ Pendiente
`EG07-00001407`	26-1883	`T001-22214`	`7-…`	⚠️ Pendiente

Decisiones confirmadas por el piloto:

✅ CP8/CP9 PO = 1894 → campo Rollo.orden_compra_marca (decisions técnicas #2 y #3 resueltas)
✅ CP9 campo 1 = po (PO cliente), campo 2 = inv (factura exportación)
⚠️ CP5/CP6 — guías de avíos y servicio costura aún sin valor confirmado

📦 CP9 — Documentos de Despacho (Comercio Exterior)

La UI (submenu "Documentos de Exportación" en sidebar) y el backend están completamente implementados. Solo faltan los 6 archivos de prueba de Fintech Lab para validar el flujo CP9.

Documento	Tipo EPCIS	Backend	UI	Docs prueba	Notas
Factura Electrónica	`btt:inv`	✅ Listo	✅	❌ Fintech Lab	Llave: `Despacho.factura_exportacion`
Guía de Remisión	`btt:desadv`	✅ Listo	✅	❌ Fintech Lab	Guía de remisión aduanal — sin campos directos en Despacho
Bill of Lading	`btt:bol`	✅ Listo	✅	❌ Fintech Lab	4 campos: `bl_number`, `container`, puertos origen/destino
DUA	`btt:desadv`	✅ Listo	✅	❌ Fintech Lab	Llave: `Despacho.numero_dua`
DAM	`btt:desadv`	✅ Listo	✅	❌ Fintech Lab	12 campos: `numero_dam`, `fob`, `aduana`, etc.
Booking	—	✅ Listo	✅	❌ Fintech Lab	Confirmación reserva — sin campos directos en Despacho
7	CP6	Modelo `Costura` no tiene `guia_servicio_costura`. ¿Mismo caso que CP5 (`CierreQA.guia_avios`)?	❓ NUEVO	Verificar que migración 060 aplicó el campo a `Costura` y no a otro modelo. Si falta: crear migración 062 para `Costura.guia_servicio_costura`, análoga a CP5.

✅ Ya implementado
UI con submenu desplegable CP9 (6 subpáginas) en sidebar "Documentos de Exportación". Backend: modelo Despacho con todos los campos. Endpoints POST/GET listos. EPCIS: _cp9_extras() popula inv, bol, desadv.

⚠️ Pendiente: Documentos de prueba
Parsers de los 6 documentos CP9 completados (2026-06-10). Fintech Lab debe entregar los archivos reales (OP-6989 Habitat) para validar el flujo end-to-end y generar el EPCIS ShippingEvent completo.

✨ Conclusión

Status: ✅ APROBADO PARA PILOTAJE

Los documentos de síntesis son válidos (98% consistentes vs histórico 2026-06-05). No hay contradicciones sustanciales. Cambios identificados son evoluciones lógicas de scope y clarificaciones necesarias tras refinamiento de 2-3 sesiones.

Recomendación: Proceder con pilotaje. Incorporar 3 aclaraciones menores en guía operativa.