CONTEÚDO
01. VISÃO GERAL
O processo de Planejamento, trata-se do envio à Here dos documentos e dos veículos que estão disponíveis para entrega e coleta na filial, gerando novas programações de carregamento a partir do retorno do roteirizador .
O processo de Planejamento, refere-se ao processo onde o Protheus TMS encaminha ao roteirizador da Here todos os documentos, mesmo que estes documentos possuam coletas e entregas na mesma localização, ou seja, a mesma latitude/longitude.
No processo de planejamento o roteirizador da Here devolverá os documentos para criação das Programações de Carregamento, levando em consideração a capacidade dos veículos. Não sendo assim um processo de agrupamento.
Quanto aos veículos, o Protheus TMS encaminha de forma agrupada de acordo com a capacidade de carga destes.
Exemplo:
Encaminhado ao roteirizador da Here um registro de veículo do tipo “VAN” com seguinte capacidade: 5 metros de comprimento, 2 metros de altura, 2 metros de largura, que possui capacidade de 2 toneladas e 300 metros cúbicos, porém com a quantidade de veículos
que se enquadram nesta condição. Quando o roteirizador da Here retorna as Programações de Carregamento a serem criadas, o retorno ocorre já com sequeciamento.
O usuário pode informar os documentos e veículos que desejar, ou ainda acionar a opção de 'Geração do Planejamento' à partir do estoque, onde o sistema considerará todos os documentos e veículos que estão disponíveis nas filiais para as viagens.
Importante:
Documentos e veículos que possam estar a caminho da filial (trânsito) não são considerados.
No caso da seleção por estoque, o sistema irá solicitar os limites de início e fim de remetente, destinatário, filial de destino e região de destino.
02. ROTINA
Na rotina Planejamento (TMSAF94) estarão dispostos os itens:
Cabeçalho
Código - Indica o código do planejamento que será enviado ao roteirizador.
Data Planejamento - Indica a data de inclusão do planejamento.
Hora do planejamento - Indica a hora de criação do planejamento.
Status - Indica se o planejamento já foi enviado à Here. São aceitos:
1=Sim;
2=Não.
Observação - Indica a observação de criação do planejamento.
Importante:
O campo observação (DNP_OBSERV) tem obrigatoriedade de preenchimento.
Documentos do Planejamento:
Relação de documentos do SIGATMS que estão sendo incluídos no planejamento.
Veículos do Planejamento:
Relação de veículos do SIGATMS que estão sendo incluídos no planejamento.
Importante:
O envio a programação de carregamento não será exigido motorista (caso o veículo não possua motorista vinculado ao cadastro).
Contudo, ao realizar a efetivação da programação, deverá ser preenchido o motorista, ou alterado caso necessário.
04. CONFIGURAÇÃO
CAMPOS CONFIGURAÇÃO DAS INTEGRAÇÕES
Abaixo da imagem detalhado campo a campo:
- Ger Pla Aut (DNM_GERPLA) - Este campo determina se após o cadastro do planejamento, a geração do histórico de integração será executada de forma automática.
Caso esteja configurada como “2-Não”, o usuário deverá acionar a geração de forma manual, por meio da opção “Gerar Planejamento” na rotina de Envio de Planejamentos à Here. - Env Pla Aut (DNM_PLAAUT) - Este campo determina se após a geração do histórico de integrações, o planejamento será enviado de forma automática à Here.
Caso esteja configurado como “2-Não”, o usuário deverá efetuar este envio de forma manual por meio da opção “Enviar à Here” na rotina de Envio de Planejamentos à Here, através das opções:- Manualmente pela tela de cadastro do planejamento - por meio da opção “Enviar à Here” no botão "Outras Ações".
- Pelo Menu de integrações com sistema externo (Job de Envio - TMSAI86).
- Automaticamente pelo Schedule do Protheus.
- Tipo Planej (DNM_TIPPLA) - Este campo determina se o envio do planejamento será enviado de forma: 1-Síncrona ou 2-Assíncrona. A diferenciação está somente na quantidade de registros de documentos, veículos e perfis que serão enviados. Estas quantidades devem ser configuradas nos campos de quantidades máxima de registros.
Após o envio, no caso configurado como:
1-Síncrono, o sistema irá aguardar o retorno da Here para geração das novas programações de carregamento;
2-Assíncrono o sistema fica liberado para uso, porém a Here devolve o código identificador externo, o qual será utilizado posteriormente para busca do planejamento processado, e somente com o sucesso nesta busca as novas programações de carregamento serão criadas.
No caso de 2-Assíncrono a busca poderá ser acionada:- Manualmente via menu de integrações com sistema externo,
Configurando um schedule no configurador do Protheus.
Aviso!
No caso de estar configurado como 1-Síncrono, porém alguma das quantidades (documentos, veículos ou perfis) exceder o configurado, o sistema irá trocar automaticamente para opção 2-Assíncrono.
- URL Sincro (DNM_URLSIN) - Este campo determina o EndPoint para envio do JSon de planejamento de forma síncrona.
- URL Assincro (DNM_URLASI) - Este campo determina o EndPoint para envio do JSon de planejamento de forma assíncrona.
- Qtd Max Doc (DNM_MAXDOC) - Este campo determina o limite máximo de documentos para envio de forma síncrona.
- Qtd Max Vei (DNM_MAXVEI) - Este campo determina o limite máximo de veículos para envio de forma síncrona.
- Qtd Max Per (DNM_MAXPER) - Este campo determina o limite máximo de perfis dos veículos para envio de forma síncrona.
- Cod Reg Doc e Desc Reg Doc (DNM_REGDOC e DNM_DESDOC) - Campos para localização da quantidade de documentos que serão enviados à Here, o sistema faz uso destes campos de código e descrição dos registros de documentos de acordo com o layout configurado.
- Cod Reg Vei e Desc Reg Vei (DNM_REGVEI e DNM_DESVEI) - Campos para localização da quantidade de veículos que serão enviados à Here, o sistema faz uso destes campos de código e descrição dos registros de veículos de acordo com o layout configurado.
- Cod Reg Per e Desc Reg Per (DNM_REGPER e DNM_DESPER) - Campos para localização da quantidade de perfis de veículos que serão enviados à Here, o sistema faz uso destes campos de código e descrição dos registros de perfis de acordo com o layout configurado.
CÓDIGO DO PLANEJAMENTO
Cod Planej (DF8_CODPLA) - Indica o número do planejamento base para geração da programação de carregamento, quando a origem da programação de carregamento for igual a 2-Here (DF8_ORIGEM =2), ou seja, originada de um planejamento de programações de carregamento.
05. INCLUIR ESTOQUE
No caso da seleção por estoque, o sistema irá solicitar os limites de início e fim de remetente, destinatário, filial de destino e região de destino.
Com a opção de geração do planejamento a partir do estoque, onde o sistema considera todos os documentos e veículos que já estão nas filiais e disponíveis para as viagens.
Documentos e veículos que possam estar a caminho da filial (trânsito) não são considerados.
PARÂMETROS DA ROTINA
Ao clicar em incluir estoque será apresentado na sequência, tela os Perguntes da rotina:
GRAVAÇÃO DE HISTÓRICO
Após gravar o planejamento o usuário deverá executar a rotina acionada pelo botão “Gerar Planejamento”, este processo irá gerar os registros na tabela intermediária de controle de integração do Protheus com sistemas externos (DN5-Histórico de Integrações).
ENVIO AO ROTEIRIZADOR HERE
Em seguida o usuário deverá acionar o envio à Here, esta rotina poderá ser acionada:
- Manualmente pela tela de cadastro do planejamento - por meio da opção “Enviar à Here” no botão "Outras Ações".
- Pelo Menu de integrações com sistema externo (Job de Envio - TMSAI86).
- Automaticamente pelo Schedule do Protheus.
Opção Outras Ações:
Opção Menu:
STATUS
Não enviado
Enviado
ATUALIZAÇÃO HISTÓRICO
06. TABELAS UTILIZADAS
- DD9 - Conf Integr TMS x Here
- DF8 - Programação de Carregamento
- DN0 - Configuração das Integrações
- DN1 - Config Integr 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
- DNB - Herança ID Externo
- DNC - Cabeçalho do Histórico
- DNM - Conf Integr TMS x Here
- DNO - Subprocesso da Fonte
- DNP - Cabeçalho do Planejamento
- DNR - Veículos do Planejamento
07. ASSUNTOS RELACIONADOS
- Integração TMS x Roteirizador HERE (Integrações - SIGATMS)
- Integração TMS x Roteirizador HERE - Plotagem de Mapa (Integrações - SIGATMS)
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas