Tempo aproximado para leitura: 00:04:18 min
Dúvida
Como utilizar a Integração do SIGAOMS x Portal Coleta Entrega SAAS?
Ambiente
TOTVS Logística - TOTVS OMS (Linha Protheus) - Gestão de Distribuição (SIGAOMS) - Todas as versões.
Solução
A integração entre o SIGAOMS - Gestão de Distribuição e o Portal Coleta Entrega consiste no envio das cargas geradas pela rotina OMSA200 - Montagem de Carga, localizada no módulo 39 - SIGAOMS.
Cada carga enviada pelo SIGAOMS gera uma viagem no Portal Coleta Entrega, permitindo o gerenciamento operacional da entrega e proporcionando maior integração entre planejadores e motoristas por meio de automações e troca de informações em tempo real.
Fluxo da integração
Para que a integração seja executada corretamente, siga o fluxo abaixo:
- Realize as configurações da integração conforme a documentação oficial - Integração OMS x Coleta Entrega - Integrações - SIGAOMS
- Valide se o token de integração está ativo.
- Crie um Pedido de Venda pela rotina MATA410.
- Na rotina OMSA200 - Montagem de Carga, gere uma carga para o pedido de venda.
- Informe na carga um veículo e um motorista cadastrados no Portal Coleta Entrega.
- Efetue o faturamento da carga.
Pré-requisitos
Antes de gerar a integração, verifique se as seguintes condições foram atendidas:
- A carga possui um veículo vinculado.
- A carga possui um motorista vinculado.
- O motorista está cadastrado como apto para a integração OMS x Coleta Entrega.
- A carga encontra-se com o status Faturada, porém não Encerrada.
Geração da integração
Após o faturamento da carga:
- Acesse a rotina OMSA200 - Montagem de Carga.
Selecione a opção: Outras Ações/Gestão de Entregas/Gerar Histórico - Essa opção gera os registros que serão utilizados na integração com o Portal Coleta Entrega.
- Para confirmar a geração dos registros, consulte a rotina: TMSAI84 - Histórico de Integrações
Envio ao Portal Coleta Entrega
Após gerar o histórico, utilize a opção:
- Acesse a rotina OMSA200 - Montagem de Carga Outras Ações/Gestão de Entregas/Enviar ao Portal.
O resultado do processamento poderá ser consultado na rotina: TMSAI84 - Histórico de Integrações.
Nessa rotina é possível verificar se a integração foi realizada com sucesso ou identificar possíveis inconsistências durante o envio. - Após a integração ser concluída com sucesso, utilize a opção:
Acesse a rotina OMSA200 - Montagem de Carga/Outras Ações/Gestão de Entregas/Enviar ao Motorista
Essa ação disponibiliza a viagem no aplicativo do motorista.
Formas de envio da integração
O envio das informações ao Portal pode ocorrer de três formas:
- Envio manual
O usuário executa a opção Enviar ao Portal pela rotina OMSA200. - Envio automático pela Configuração das Integrações
Caso a rotina TMSAI80 - Configuração das Integrações esteja parametrizada para envio automático, os registros serão enviados imediatamente após a execução da opção Gerar Histórico, não sendo necessária nenhuma ação adicional. - Envio automático pelo Job
Caso o Job TMSAI86 - Envio esteja configurado, os registros gravados no histórico serão enviados automaticamente conforme a recorrência definida no Schedule, dispensando o envio manual.
Principais tabelas envolvidas na integração
As principais tabelas utilizadas pela integração entre o OMS e o Portal Coleta Entrega são:
Tabela Descrição
DAK Carga
DAI Itens da Carga (identificação das Notas Fiscais)
DA4 Motoristas
DN0 Configuração das Integrações
DN1 Configuração da Integração Coleta/Entrega
DN2 Tipos de Registro
DN3 Layout dos Registros
DN4 Relacionamento entre Registros
DN5 Histórico de Integrações
DN6 Fontes de Integração
DN7 Integrações do Motorista
DN8 Filiais Externas
DNB Herança de ID Externo
DNC Cabeçalho do Histórico
Importante
Caso o envio automático não esteja habilitado, tanto pela rotina TMSAI80 quanto pelo Job TMSAI86, o envio deverá ser realizado obrigatoriamente por meio da opção Enviar ao Portal.
Para o correto funcionamento da integração, é necessário que o ambiente esteja atualizado com os pacotes acumulados recomendados para a versão do Protheus em utilização.
Recomendamos validar se os Pacotes Acumulados do SIGAOMS e do SIGATMS estão devidamente aplicados antes de realizar as configurações e os testes da integração.
Saiba mais
Para obter mais detalhes sobre a integração, consulte as documentações relacionadas:
Montagem de Carga
Guia de Uso - TOTVS Coleta e Entrega
Logística - Linha Protheus - OMS - Pacote Acumulado do TOTVS OMS
Logística - Linha Protheus - TMS - Pacotes de Atualização
0 Comentários