Protocolo aberto · IBIACDRAFT v0.2

OpenLOG

Open Logistics Object Graph Protocol

A linguagem aberta da logística inteligente.

OpenLOG é um protocolo internacional aberto para padronizar identificação, comunicação, rastreabilidade e troca de metadados entre sistemas logísticos. Multimodal, fiscalmente interoperável, auditável por design.

Ler especificação Contribuir como pesquisador

STATUSDraft técnico-conceitual

VERSÃO0.2

MANTENEDORIBIAC (em constituição)

ESCOPOMultimodal · COMEX · Fiscal · IA

00 · O problema

A logística sofre por falta de linguagem comum.

Cada TMS fala de um jeito.
Cada WMS registra de um jeito.
Cada ERP interpreta de um jeito.
Cada rastreador envia dados de um jeito.
Cada porto, aeroporto e terminal organiza informações de um jeito.
Cada país tem seus documentos, tributos e regras.
Cada embarcador exige integração de um jeito.

OpenLOG nasce para resolver essa fragmentação.

01 · O que é

Não é só uma API. É uma especificação de interoperabilidade.

OpenLOG funciona como uma linguagem comum entre sistemas, empresas, modais, países, documentos e agentes logísticos — para que objetos logísticos possam ser compreendidos, auditados e processados por diferentes sistemas autorizados.

Vocabulário comum

Objetos, eventos, documentos e estados padronizados em torno do domínio logístico.

Interoperável por design

Independente de fornecedor, com mapeamento para padrões abertos (GS1, OpenAPI, AsyncAPI, JSON-LD).

Auditável e fiscal

Rastreabilidade, não-repúdio e cadeia de auditoria nativos. Suporte a documentos fiscais brasileiros e COMEX internacional.

02 · Princípios

Catorze princípios fundamentais.

01Interoperabilidade

02Rastreabilidade

03Disponibilidade

04Integridade

05Confidencialidade

06Autenticidade

07Não repúdio

08Auditabilidade

09Governança

10Extensibilidade

11Multimodalidade

12Conformidade fiscal e aduaneira

13Inteligência operacional

14Neutralidade tecnológica

03 · Arquitetura

Dez camadas, um único objeto.

O protocolo é estratificado em dez camadas que cobrem desde a identificação universal até a inteligência aplicada.

N°CamadaFunção

01IdentityIdentificação universal de objetos via OLID.

02MetadataMetadados técnicos, operacionais e fiscais.

03ObjectDefinição dos objetos logísticos canônicos.

04EventEventos, mudanças de estado e cadeia temporal.

05DocumentDocumentos fiscais, comerciais e aduaneiros.

06CommunicationAPIs, webhooks, mensageria e streaming.

07SecurityAutenticação, autorização e assinatura.

08GovernanceAuditoria, conformidade, políticas e retenção.

09Fiscal & CustomsImpostos, COMEX e obrigações nacionais e internacionais.

10IntelligenceIA, predição, otimização e automação.

04 · Identificação

OLID — OpenLOG Identifier.

Todo objeto OpenLOG carrega um identificador universal único, opaco e composicional, que permite roteamento, busca e auditoria sem depender do sistema de origem.

Formato

ol_{object_type}_{country_code}_{issuer}_{unique_id}

Exemplo

ol_shipment_bra_aiqia_018f7c2e-4d71-7c0a-9d91-bfa912347abc

olPrefixo do identificador OpenLOG
object_typeTipo de objeto: shipment, trip, container…
country_codePaís principal de emissão (ISO 3166-1 alfa-3)
issuerOrganização emissora do identificador
unique_idUUID, ULID ou hash único globalmente

05 · Objeto canônico

A estrutura comum a todo objeto OpenLOG.

Independentemente do tipo (shipment, trip, document, customs_operation…), todo objeto carrega o mesmo envelope com identidade, metadados, segurança, payload, links e auditoria.

{
  "openlog_version": "0.2",
  "object_type": "openlog:shipment",
  "olid": "ol_shipment_bra_aiqia_018f7c2e-4d71-7c0a-9d91-bfa912347abc",
  "metadata": { /* origem, tempo, geo, classificação */ },
  "security":  { /* classificação, criptografia, assinatura */ },
  "payload":   { /* dados específicos do tipo de objeto */ },
  "links":     [ /* relacionamento com outros objetos OpenLOG */ ],
  "audit":     { /* hash, cadeia de auditoria, assinatura */ }
}

06 · Multimodalidade

Sete perfis multimodais.

Rodoviário, ferroviário, marítimo, aéreo, hidroviário, dutoviário e armazenagem — cada modal com objetos, eventos e estados específicos, integrados ao núcleo comum.

07 · Domínios funcionais

Quinze domínios cobrem a operação ponta a ponta.

Os domínios funcionais organizam o vocabulário em torno de áreas claras — núcleo, modais, COMEX, fiscal, telemetria, risco, ESG e IA.

openlog:coreopenlog:roadopenlog:railopenlog:seaopenlog:airopenlog:riveropenlog:pipelineopenlog:warehouseopenlog:customsopenlog:taxopenlog:documentopenlog:telemetryopenlog:riskopenlog:esgopenlog:ai

08 · Serializações

Multiformato, multiprotocolo.

OpenLOG não se prende a um único formato. JSON é o canônico; XML para documentos fiscais e COMEX; JSON-LD para semântica; Protobuf, Avro e Parquet para volume e analytics.

JSON

application/openlog+json

Formato canônico — APIs, webhooks, eventos e integração entre sistemas.

XML

application/openlog+xml

Documental — NFe, CTe, MDFe, DUIMP, DUE e integrações com ERPs legados.

JSON-LD

application/ld+json

Semântica — ontologia logística e interoperabilidade internacional.

Protobuf

application/x-protobuf

Telemetria, IoT e comunicação de baixa latência entre microsserviços.

Avro

application/avro

Streaming e evolução de esquemas em pipelines de eventos.

Parquet

application/parquet

Data lake, analytics e treinamento de modelos de IA.

09 · Conformidade

Cinco níveis de conformidade.

Sistemas declaram seu nível de adesão ao OpenLOG. Cada nível abrange capacidades cumulativas, do consumo simples à certificação completa de nó da rede.

01
Reader
O sistema consegue ler objetos OpenLOG.
02
Writer
O sistema consegue criar objetos OpenLOG válidos.
03
Event Publisher
O sistema consegue publicar eventos OpenLOG.
04
Interoperable System
Lê, escreve, publica, assina, valida e audita eventos.
05
Certified Node
Nó certificado da rede OpenLOG, com suporte completo a segurança, auditoria, COMEX, impostos e rastreabilidade.

10 · Roadmap

O caminho até a v1.0 estável.

A versão atual é um draft técnico-conceitual. As próximas versões consolidam contratos, perfis e a infraestrutura de certificação que tornará o OpenLOG um padrão verificável.

OpenLOG v0.3

Schemas e SDKs

JSON Schema oficial
XSD oficial
OpenAPI / AsyncAPI
Protobuf / Avro
Dicionário de tags
Perfil Brasil fiscal completo
Perfil COMEX completo
SDKs TypeScript, Python e PHP
Validador CLI
Portal de documentação

Em planejamento

OpenLOG v0.4

Certificação e registry

Programa de certificação
Sandbox de testes
Registry de objetos, eventos e documentos
Compatibilidade automatizada
Extensão blockchain (opcional)
Telemetria e IoT avançada

Estável

OpenLOG v1.0

Especificação aberta

Especificação estável
Governança aberta
Comitê técnico
Licença aberta
Casos de uso produtivos
Implementação de referência

Engajamento

OpenLOG é uma especificação aberta — feita para muitas mãos.

A direção é definida por quem implementa, audita, regula e pesquisa. Existem três caminhos para participar do desenvolvimento.

Implementadores

Empresas de TMS, WMS, ERP, torres de controle, rastreadores e plataformas logísticas que queiram declarar conformidade e participar dos testes de interoperabilidade.

Acesso ao draft técnico completo
Mesa de implementação técnica
Testes de conformidade no v0.3

Conversar sobre adoção ict@ibiac.com.br

Pesquisadores

Pesquisadores em logística, otimização, segurança da informação, semântica, padrões abertos e IA que queiram contribuir nas RFCs e perfis em desenvolvimento.

Co-autoria em RFCs e papers
Discussão técnica do comitê
Contribuição em perfis específicos

Candidatar-se afiliacao@ibiac.com.br

Governos e reguladores

Esferas pública, agências de fomento, órgãos reguladores e formuladores de política em logística e comércio exterior interessados em padronização aberta.

Articulação de política pública
Mapeamento para padrões nacionais (NFe, CTe, MDFe, DUIMP)
Editais cooperativos

Articular agenda ict@ibiac.com.br