Visión general
Customs de NexLog OS es la gestión aduanera de la plataforma: clasificación NCM/HS, Incoterms, documentos comerciales (BL, AWB, Booking), valoración aduanera, Denied Party Check e integración con ventanillas únicas como el Portal Único Siscomex de Brasil.
Declaración aduanera y Documento comercial comparten el MDM con Envío (shipments) y Pedido (orders). Los Incoterms vienen del pedido, el peso y el cubicaje vienen del envío y el NCM/HS viene del Product Master, sin volver a digitar datos entre sistemas.
Entidades principales
El modelo canónico de Customs da a cada entidad un nombre descriptivo y un código en inglés (la colección en MongoDB), como el resto de la plataforma: WMS, TMS, OMS, Control Tower, ESG y Finanzas.
| Entidad | Código | Descripción |
|---|---|---|
| Declaración aduanera | tradeDeclarations | Declaración de importación o exportación. Incluye NCM/HS, valor en aduana, Incoterms, ICMS-ST, origen y destino. Toda declaración pasa por el Denied Party Check. |
| Documento comercial | tradeDocuments | BL, AWB, Booking, packing list, factura comercial y certificado de origen (CoO). Queda adjunto al envío (shipments) y a la declaración correspondiente. |
Flujos operativos
Los seis flujos que llevan la carga del booking al despacho aduanero.
Tariff Intelligence
Clasificación NCM/HS asistida por IA. La sugerencia parte de la descripción del producto, de la BOM, del historial de clasificaciones aprobadas y de la jurisprudencia; cada sugerencia trae la base, el nivel de confianza y las fuentes consultadas.
Denied Party Check
Screening automático de las partes de cada declaración frente a listas de sanciones (OFAC, UE, ONU, BACEN y listas sectoriales, configurables por tenant). Una parte sancionada bloquea el embarque.
Single Window
Conector para ventanillas únicas nacionales, como el Portal Único Siscomex y sus equivalentes en el exterior, con conectores específicos por operación.
Documentación multiestándar
Emisión e intercambio de documentos en Cargo-XML, DCSA, ONE Record y WCO Data Model, en el formato que acepta cada parte.
Valoración aduanera
Cálculo del valor en aduana y de los tributos de importación: II, PIS/COFINS-importación e ICMS-ST.
Playbooks fiscales
Reglas versionadas que automatizan el régimen aduanero, el drawback, el ex-tarifario y los regímenes especiales.
Documentos comerciales
Tipos de documento guardados en tradeDocuments.
| Documento | Definición | Modo |
|---|---|---|
| BL (Bill of Lading) | Conocimiento de embarque marítimo. | Marítimo |
| AWB (Air Waybill) | Guía aérea (conocimiento de embarque aéreo). | Aéreo |
| Booking | Reserva de espacio en un buque o una aeronave. | Marítimo y aéreo |
| Packing list | Relación de bultos, pesos y contenido de la carga. | Todos |
| Commercial invoice | Factura comercial de la operación de compraventa. | Todos |
| CoO | Certificado de origen de la mercancía. | Todos |
Siglas y estándares
El vocabulario del comercio exterior y dónde aparece cada término en el modelo. BL, AWB y Booking están en Documentos comerciales.
| Sigla | Significado | Dónde aparece |
|---|---|---|
| NCM / HS | Nomenclatura Común del Mercosur / Sistema Armonizado | tradeDeclarations |
| Incoterms | International Commercial Terms (FOB, CIF, DAP, DDP y otros) | orders, shipments, tradeDeclarations |
| Single Window | Ventanilla única de integración con las autoridades aduaneras | Integración |
| DPC | Denied Party Check, screening de sanciones | Compliance |
| Cargo-XML | Estándar IATA para datos de carga aérea | Integración |
| DCSA | Digital Container Shipping Association, estándar marítimo | Integración |
| ONE Record | Estándar IATA de datos conectados | Integración |
| WCO Data Model | Modelo de datos de la Organización Mundial de Aduanas | Integración |
Endpoints REST
Endpoints versionados en /api/v1/.
| Endpoint | Método | Uso |
|---|---|---|
/api/v1/trade-declarations | GET | Lista las declaraciones aduaneras. |
/api/v1/trade-declarations | POST | Crea una declaración de importación o exportación. |
/api/v1/trade-documents | GET | Lista los documentos comerciales. |
/api/v1/tariff/classify | POST | Pide a Tariff Intelligence una sugerencia de clasificación NCM/HS. |
/api/v1/customs/denied-party-check | POST | Ejecuta el screening de partes frente a listas de sanciones. |
/api/v1/customs/single-window/submit | POST | Envía la declaración a la ventanilla única. |
Convención: endpoints en kebab-case, versionados en /api/v1/; colecciones en camelCase (tradeDeclarations) y clases en PascalCase (TradeDeclaration).
Customs como módulo de primera clase
Del silo fiscal al núcleo operativo
La gestión aduanera suele vivir aislada en los sistemas de agentes de aduanas y traders, lo que genera duplicación de datos, retrabajo y exposición a multas.
En NexLog OS, Declaración aduanera (tradeDeclarations) y Documento comercial (tradeDocuments) comparten el MDM con Envío (shipments) y Pedido (orders): los Incoterms vienen del pedido, el peso y el cubicaje vienen del envío y el NCM/HS viene del Product Master.
Tariff Intelligence y compliance
Tariff Intelligence usa IA para sugerir la clasificación NCM/HS a partir de la descripción textual, de la BOM, del historial de clasificaciones aprobadas y de la jurisprudencia, y cada sugerencia trae una explicación auditable.
El Denied Party Check se ejecuta automáticamente en toda declaración y bloquea los embarques a partes sancionadas. Drawback, ex-tarifario y regímenes especiales quedan en playbooks versionados.
Estándares internacionales y Single Window
Customs habla Cargo-XML, DCSA, ONE Record y WCO Data Model. Al integrarse con el Portal Único Siscomex y con autoridades de Europa y Asia, usa el formato que acepta cada parte.
Como comparte el MDM con WMS, TMS y OMS, la operación internacional deja de ser un silo y pasa a ser parte natural del supply chain operating system, visible en el Control Tower como cualquier otro evento.