Qué información importa · Cuándo se sube · Qué extrae el parser · Cómo se vincula al expediente
upload_audits (no se guarda contenido del PDF).
El campo codigo_expediente agrupa todos los documentos de un despacho.
| # | Documento | Origen / Subida | Timing | Obligatorio | Parser backend | Escribe en despachos |
|---|---|---|---|---|---|---|
| 1 | Orden de Compra (PO) | Trento Core DB | Automático | Sí | — | orden_pedido |
| 2 | Factura Electrónica | PDF upload | Pre-cierre | Sí | parse_factura_exportacion_pdf |
factura_exportacion |
| 3 | Guía de Remisión | PDF upload | Pre-cierre ★ | Sí | parse_guia_remision_despacho_pdf |
fecha_guia_remision |
| 4 | Bill of Lading (BL) | PDF upload | Pre-cierre | Sí (marítimo) | parse_bl_pdf |
bl_number, numero_contenedor, puerto_origen, puerto_destino |
| 5 | DUA | PDF upload | Post-cierre ★ | Sí (aduanas) | parse_dam_pdf (mismo parser) |
numero_dam, fob_usd, drawback, series |
| 6 | DAM | PDF upload | Post-cierre ★ | Sí (aduanas) | parse_dam_pdf |
numero_dam, fecha_numeracion_dam, aduana_nombre, regimen_aduanero, partida_arancelaria |
| 7 | Booking | PDF upload | Por validar | ? | parse_booking_pdf |
— (no actualiza despachos) |
★ Guía de Remisión: su fecha_emision se extrae y se guarda como fecha_guia_remision — fecha oficial de cierre CP9.
★ DUA y DAM: ambos son post-cierre; el sistema los admite para completar el expediente pero no bloquean el cierre.
La PO del cliente (Hábitat, Peter Millar, Escape) se obtiene directamente desde Trento Core vía la relación lote → ordenes_produccion → purchase_order_id. No requiere upload manual.
Factura SUNAT emitida por Confecciones Trento. Documento de valor comercial del despacho. Al subirla, activa la transición DPP COLLECTING → DATA_COMPLETE.
Documento SUNAT que acredita el traslado físico de la mercancía. Su fecha de emisión es el trigger oficial de cierre CP9 — se guarda en despachos.fecha_guia_remision.
// Campo clave en despachos "fecha_guia_remision": "2026-05-28" // cierre oficial CP9
Documento naviero que acredita el embarque marítimo. Parser más completo — extrae 18 campos incluyendo contenedor, buque, puertos y POs referenciados.
Campos clave extraídosDocumento Único Aduanero — formulario SUNAT previo a la DAM. Mismo parser que DAM (parse_dam_pdf). Se sube después de cerrar CP9, como parte del expediente aduanero.
Declaración Aduanera de Mercancías — documento SUNAT final que acredita la exportación. Contiene series por ítem con cantidad, peso y FOB. Se valida posteriormente ante SUNAT.
Campos adicionales vs DUA// dam_series en despachos (JSONB) [ { "serie": "1/1", "cantidad": 1941, "peso_neto_kg": 543.5, "fob_usd": 28230.0 } ]
Confirmación de reserva de espacio naviero emitida por la agencia de carga. Parser implementado, pero su obligatoriedad en el flujo CP9 está pendiente de validación con el equipo. No actualiza campos en despachos.
| Documento | Timing | Parser | Campos clave extraídos | Escribe en BD | Upload type |
|---|---|---|---|---|---|
| OC Cliente (PO) | Auto | — | orden_pedido, cliente_gln |
Trento Core → despachos |
— |
| Factura Electrónica | Pre | parse_factura_exportacion_pdf |
numero_factura, fecha_emision, comprador, total_usd, incoterms |
factura_exportacion → activa DATA_COMPLETE |
documentos_exportacion_factura |
| Guía de Remisión ★ | Pre | parse_guia_remision_despacho_pdf |
numero_guia, fecha_emision★, destinatario, peso_bruto_kg, bultos |
fecha_guia_remision (cierre CP9) |
documentos_exportacion_guia_remision |
| Bill of Lading | Pre | parse_bl_pdf |
numero_bl, container_number, vessel_voyage, puerto_origen/destino, packages_count, shipped_on_board, po_numbers |
bl_number, numero_contenedor, puerto_origen, puerto_destino |
documentos_exportacion_bill_of_lading |
| DUA | Post | parse_dam_pdf |
numero_declaracion, fecha_numeracion, fob_total_usd, regimen_aduanero, partida_arancelaria, drawback |
numero_dam, fob_usd, drawback, regimen_aduanero |
documentos_exportacion_dua |
| DAM | Post | parse_dam_pdf |
Ídem DUA + aduana_nombre, empresa_transporte, terminal_almacen, exportador_ruc, dam_series[] |
numero_dam, fecha_numeracion_dam, aduana_nombre, terminal_almacen, dam_series |
documentos_exportacion_dam |
| Booking | ? | parse_booking_pdf |
numero_booking, etd, eta, vessel, puertos, peso_kg, bultos |
— (no escribe en despachos) |
documentos_exportacion_booking |
★ fecha_guia_remision es el único campo que determina la fecha oficial de cierre CP9.
DUA y DAM usan el mismo parser parse_dam_pdf — la distinción es solo de nomenclatura (DUA es el formulario previo; DAM es la declaración final numerada por SUNAT).
Todos los uploads se registran en upload_audits con upload_type = "documentos_exportacion_{tipo}".