TOTVS Omni

Árvore de páginas


CONTEÚDO


01. VISÃO GERAL

Para o TOTVS Omni, um operador logístico é um sistema que gerencia o processo de entrega de encomendas.

Sistemas de operadores logísticos geralmente disponibilizam APIs ou Webservices para que externamente sistemas possam criar um pedido de entrega e rastreá-lo posteriormente.

O TOTVS Omni dispõe de um módulo (serviço) chamado Moddo Logistics que funciona como um hub de integração entre o core do TOTVS Omni e a API do operador logístico. Neste módulo são disponibilizados os conectores, que fazem a tradução das informações do Omni para a interface do operador logístico, e serve também como único ponto de contato para os marketplaces e e-commerce que desejam fazer cálculo de frete em tempo real.


Para o desenvolvimento precisamos entender se é necessário uma conta de homologação no operador logístico e quem cria esta conta.

Os casos de uso que um conector de operador logístico deve atender são:

1) Criar um pedido de entrega.

Geralmente o retorno deste caso de uso é a guia logística (etiqueta que deve ser anexada à caixa que será despachada) e o número de rastreio, que deve ser devolvido ao core do TOTVS Omni para envio ao marketplace, e-commerce e PDV/ERP.

2) Solicitar status da entrega (tracking).

3) Solicitar a guia logística (segunda via) a partir do número de rastreio.

4) Cálculo de custo de entrega (geralmente recebe o endereço de origem e endereço de destino retornando o valor do frete).

5) Gerar guia logística de devolução.

Nem todos os operadores logísticos disponibilizam endpoints na API para todos estes casos de uso.

Para cada um dos casos de uso, deve-se analisar qual endpoint da API do operador logístico deve ser chamado, realizar o mapeamento das informações que a API necessita com as informações disponível no TOTVS Omni, e desenvolver o conector.

02. LISTA DE CONECTORES