Visão geral
O Customs do NexLog OS é a gestão aduaneira da plataforma: classificação NCM/HS, Incoterms, documentos comerciais (BL, AWB, Booking), valoração aduaneira, Denied Party Check e integração com janelas únicas como o Portal Único Siscomex.
Declaração Aduaneira e Documento Comercial compartilham o MDM com Remessa (shipments) e Pedido (orders). Incoterms vêm do pedido, peso e cubagem vêm da remessa e NCM/HS vêm do Product Master, sem redigitação entre sistemas.
Entidades principais
O modelo canônico do Customs usa nomes em português e code em inglês (a collection no MongoDB), como o resto da plataforma: WMS, TMS, OMS, Control Tower, ESG e Financeiro.
| Entidade | Code | Descrição |
|---|---|---|
| Declaração Aduaneira | tradeDeclarations | Declaração de importação ou exportação. Inclui NCM/HS, valor aduaneiro, Incoterms, ICMS-ST, origem e destino. Toda declaração passa pelo Denied Party Check. |
| Documento Comercial | tradeDocuments | BL, AWB, Booking, packing list, commercial invoice e certificado de origem (CoO). Fica anexado à remessa (shipments) e à declaração correspondente. |
Fluxos operacionais
Os seis fluxos que levam a carga do booking ao desembaraço.
Tariff Intelligence
Classificação NCM/HS assistida por IA. A sugestão parte da descrição do produto, da BOM, do histórico de classificações aprovadas e da jurisprudência; cada sugestão traz a base, o nível de confiança e as fontes consultadas.
Denied Party Check
Screening automático das partes de cada declaração contra listas de sanções (OFAC, UE, ONU, BACEN e listas setoriais, configuráveis por tenant). Uma parte sancionada bloqueia o embarque.
Single Window
Conector para janelas únicas nacionais, como o Portal Único Siscomex e equivalentes no exterior, com conectores específicos por operação.
Documentação multi-padrão
Emissão e troca de documentos em Cargo-XML, DCSA, ONE Record e WCO Data Model, no formato que cada parte aceita.
Valoração aduaneira
Cálculo do valor aduaneiro e dos tributos de importação: II, PIS/COFINS-importação e ICMS-ST.
Playbooks fiscais
Regras versionadas que automatizam regime aduaneiro, drawback, ex-tarifário e regimes especiais.
Documentos comerciais
Tipos de documento guardados em tradeDocuments.
| Documento | Definição | Modal |
|---|---|---|
| BL (Bill of Lading) | Conhecimento de embarque marítimo. | Marítimo |
| AWB (Air Waybill) | Conhecimento de embarque aéreo. | Aéreo |
| Booking | Reserva de espaço em navio ou aeronave. | Marítimo e aéreo |
| Packing list | Relação de volumes, pesos e conteúdo da carga. | Todos |
| Commercial invoice | Fatura comercial da operação de compra e venda. | Todos |
| CoO | Certificado de origem da mercadoria. | Todos |
Siglas e padrões
O vocabulário do comércio exterior e onde cada termo aparece no modelo. BL, AWB e Booking estão em Documentos comerciais.
| Sigla | Significado | Onde aparece |
|---|---|---|
| NCM / HS | Nomenclatura Comum do Mercosul / Harmonized System | tradeDeclarations |
| Incoterms | International Commercial Terms (FOB, CIF, DAP, DDP e outros) | orders, shipments, tradeDeclarations |
| Single Window | Janela única de integração com autoridades aduaneiras | Integração |
| DPC | Denied Party Check, screening de sanções | Compliance |
| Cargo-XML | Padrão IATA para dados de carga aérea | Integração |
| DCSA | Digital Container Shipping Association, padrão marítimo | Integração |
| ONE Record | Padrão IATA de dados conectados | Integração |
| WCO Data Model | Modelo de dados da World Customs Organization | Integração |
Endpoints REST
Endpoints versionados em /api/v1/.
| Endpoint | Método | Uso |
|---|---|---|
/api/v1/trade-declarations | GET | Lista declarações aduaneiras. |
/api/v1/trade-declarations | POST | Cria uma declaração de importação ou exportação. |
/api/v1/trade-documents | GET | Lista documentos comerciais. |
/api/v1/tariff/classify | POST | Pede uma sugestão de classificação NCM/HS ao Tariff Intelligence. |
/api/v1/customs/denied-party-check | POST | Executa o screening de partes contra listas de sanções. |
/api/v1/customs/single-window/submit | POST | Envia a declaração à janela única. |
Convenção: endpoints em kebab-case, versionados em /api/v1/; collections em camelCase (tradeDeclarations) e classes em PascalCase (TradeDeclaration).
Customs como módulo de primeira classe
Do silo fiscal ao núcleo operacional
A gestão aduaneira costuma viver isolada em sistemas de despachantes e traders, o que gera duplicação de dados, retrabalho e exposição a multas.
No NexLog OS, Declaração Aduaneira (tradeDeclarations) e Documento Comercial (tradeDocuments) compartilham MDM com Remessa (shipments) e Pedido (orders): Incoterms vêm do pedido, peso e cubagem vêm da remessa e NCM/HS vêm do Product Master.
Tariff Intelligence e compliance
O Tariff Intelligence usa IA para sugerir a classificação NCM/HS a partir da descrição textual, da BOM, do histórico de classificações aprovadas e da jurisprudência, e cada sugestão traz explicação auditável.
O Denied Party Check roda automaticamente em toda declaração e barra embarques para partes sancionadas. Drawback, ex-tarifário e regimes especiais ficam em playbooks versionados.
Padrões internacionais e Single Window
O Customs fala Cargo-XML, DCSA, ONE Record e WCO Data Model. Ao integrar com o Portal Único Siscomex e com autoridades da Europa e da Ásia, usa o formato que cada parte aceita.
Como compartilha o MDM com WMS, TMS e OMS, a operação internacional deixa de ser um silo e passa a ser parte natural do supply chain operating system, visível no Control Tower como qualquer outro evento.