Histórico da Página

CONTEÚDO

01. VISÃO GERAL

Para funcionamento de forma automática de envios e retornos de informações do Coleta Entrega é necessário que haja a sincronização dos dados apontados via aplicação App Mobile do Coleta Entrega.

O sincronismo ocorre por meio dos Jobs localizados nas rotinas de Jobs: Envio e Retorno (TMSAI86 / TMSAI87 - SIGATMS).

Para a configuração do Job, acesse o módulo Configurador (SIGACFG) do Protheus e execute os seguintes passos:

1.1 Configuração do Agente do Schedule

a. Acesse o Agente do Schedule via menu Ambiente > Schedule > Schedule.

b. No menu lateral, clique no ícone Agent e, em seguida, na opção Cadastro.

c. Na parte inferior da tela Detalhes, clique no ícone representado por uma página com o sinal de mais , preencha os campos, conforme quadro Campos Agent Schedule detalhado logo abaixo.

d. Salve o cadastro, clicando no ícone representado pela imagem de check na cor verde .

...

Informe o nome do agente que faz o gerenciamento das execuções das threds/jobs agendados.

Exemplo:
Agente de Execução Empresa T1.

...

Informe o IP do servidor, que deve ser o mesmo que está executando o Appserver.

Também pode ser o localhost ou o nome da máquina servidora.

...

Informe o grupo da empresa. Utilize a lupa para selecionar o código da empresa.

...

Informe a quantidade de Threads que será gerenciada pelo agente do Schedule.

É permitido executar em paralelo uma ou mais rotinas.

Exemplo:
Se for informado 3 Threads o agente fará o gerenciamento da execução de até 3 rotinas em paralelo.

...

Nesta documentação demonstraremos alguns exemplos básicos de utilização de processos de viagens: coleta e entrega, utilizando a integração com Coleta Entrega.

Lembrando que, para execução do processo de integração:

• No ambiente deve estar funcional a utilização dos processos de viagem (coleta e/ou entrega);
• As configurações de integração com coleta entrega devem estar realizadas;
• Configurações do Portal Coleta Entrega devem estar realizadas (acesso, configurações dos motoristas, planejadores e organizações);
• Motoristas devem ter posse de celulares com aplicativo TOTVS Logística Minha Coleta e Entrega.

   IMPORTANTE - DESPACHA VIAGEM AO MOTORISTA

Antes de iniciar a leitura dos exemplos abaixo, informamos que os exemplos foram utilizados com o código de registro 1150 - DESPACHA VIAGEM AO MOTORISTA = SIM no layout de integração TMS x Coleta Entrega, ou seja, o envio será de forma automática ao Portal e ao APP do Motorista (atividade de despacho ao motorista).

Sendo assim o despacho manual, dentro do Portal Logístico não precisará ser efetuado. Esta configuração contudo pode ser alterada caso o cliente deseje desta forma.

Image Added

   IMPORTANTE - ENDEREÇOS CLIENTES

Para a utilização do processo de integração entre SIGAFAT x COLETA ENTREGA, recomendamos atenção ao cadastro de clientes, tabela Protheus SA1 (Clientes) com respeito as informações de Endereço.

Para correta integração, o endereço dos clientes (campo A1_END)  devem estar preenchidos conforme exemplo abaixo:

Use vírgula para separar os números e escreva-os sempre que possível em algarismos arábicos, exemplo: AVENIDA BRAZ LEME , 1000                                    

Nome do logradouro, Número, Complemento - (campo A1_END)
Nome do Bairro -  (campo A1_BAIRRO)
CEP - ( campo A1_CEP)
Nome da localidade (Cidade/Município) - (campo A1_MUN)
UF - (campo A1_EST)

Image Added

Nos casos, onde o cliente não possua numeração em seu logradouro utilizar "SN", exemplo: ROD ARTHUR BERNARDES, SN                                   

Nome do logradouro, SN, Complemento - (campo A1_END)
Nome do Bairro -  (campo A1_BAIRRO)
CEP - ( campo A1_CEP)
Nome da localidade (Cidade/Município) - (campo A1_MUN)
UF - (campo A1_EST)

Image Added

02. EXEMPLOS DE UTILIZAÇÃO - ENTREGA/COLETA  ENVIO COM SUCESSO

2.1 Inclusão de Documentos

a.  Inclua um Documento de Entrada via menu Atualizações > Recebimento > Documento Entrada Clientes.

b.  Calcule o Frete para gerar um ou mais documentos de CT-e.

c.  Transmita o CT-e e aguarde a autorização pela SEFAZ;

Ou

d. Inclua uma solicitação de coleta via menu  Atualizações > S.A.C.> Solicitações de Coleta.

2.2 Inclusão da Viagem

a.  Inclua uma viagem:

Do tipo Coleta por meio do menu Atualizações > Viagens > Rodoviário Coleta> Viagens (modelo 2).
Ou do tipo Entrega por  meio do menu Atualizações > Viagens > Rodoviário Entrega > Viagens(modelo 2) ou ainda Atualizações > Viagens > Viagem Mod. 3> Viagem Mod. 3.

b.  Clique em Incluir para abrir a tela de Cadastro de Viagem.

c.  Informe a rota que será utilizada.

d. Através da viagem Rodoviário Coleta> Viagens (modelo 2) ou  Rodoviário Entrega > Viagens(modelo 2) utilizando-se Outras Ações > Comp. via. inserir veículo e motorista. Neste passo é importante incluir um motorista que esteja integrado ao processo do Coleta Entrega, vide Cadastros de Motoristas - Integração SIGATMS x Coleta Entrega (OMSA040 - SIGATMS).

e. Caso utilizado a Viagem Mod. 3., selecione a Aba Recursos, na seção Veículos da Viagem - insira os dados do(s) veículo(s) da viagem,onde caso exista motorista vinculado será automaticamente gatilhados informações na  Aba inferior Motoristas (Aba de  Recursos) caso contrário o preenchimento deverá ser manual,informando um motorista que esteja integrado ao processo do Coleta Entrega, vide Cadastros de Motoristas - Integração

h.  Na tela da viagem, inclua os documentos que serão entregues por meio do grid. Pode ser utilizada a lupa pressionando a tecla F3, ao selecionar o campo Fil. Docto. Isso fará com que seja exibida a tela de seleção de documentos de transportes. Selecione os documentos que serão carregados/inseridos na viagem.

i.  Com os documentos informados na viagem, clique em Salvar para confirmar os dados e gerar a viagem no sistema.

j. O processo de integração ocorrerá de acordo com a configuração da rotina Configuração das Integrações (TMSAI80 - SIGATMS), ou seja, de acordo com campo Envio Reg = 1=Fechamento da Viagem ou 2=Operação de Saída.  Configurado como 1 a integração ocorrerá no Fechamento da Viagem sendo detalhada no item 2.3. abaixo, já quando o campo estiver configurado como 2 a integração ocorrerá no Saída da Viagem sendo detalhada no item 2.4. abaixo:

2.3 Fechamento da Viagem e Integração Com Coleta Entrega

a.  Quando a Configuração das Integrações (TMSAI80 - SIGATMS) estiver configurada: Campo Envio Reg (DN1_ENVREG) = 1. Fechamento da Viagem.

b.  Através da viagem Rodoviário Coleta> Viagens (modelo 2) ou  Rodoviário Entrega > Viagens(modelo 2), posicione sobre a viagem incluída e acesse o menu Outras Ações > Manutenção > Fechamento > Fechar. Na tela de confirmação, clique em OK.

Caso utilizado a Viagem Mod. 3., através da rotina principal de Viagem Modelo 3 na Opção Outras Ações> Manutenção> Fechamento> Fechar (ou ainda via fechamento automático - videFechamento Viagem Modelo 3 (TMSA310 - SIGATMS)).

c.  Neste momento será realizado o fechamento da viagem e, estando configurado a integração com o Coleta Entrega:

• Caso exista layout pré-definido pela TOTVS importado no ambiente e job de envio ativo (ou executado de forma manual), ocorrerá gravação da tentativa de integração com Coleta Entrega na rotina de Histórico de Integrações (TMSAI84 - SIGATMS).

d.  Haverá a inclusão dos registros na tabela DLY - Eventos do Comprovante de Entrega.

e.  A integração será disparada para cada documento existente na viagem, e será enviado para o Portal Coleta Entrega (acesso planejador) assim como para o App Mobile do Minha Coleta Entrega (Motorista):

f. Apontar o operação de saída de viagem.

Através da viagem Rodoviário Coleta> Viagens (modelo 2) ou  Rodoviário Entrega > Viagens(modelo 2), posicione sobre a viagem incluída e acesse o menu  Outras Ações > Manutenção > Operações. 

Na tela de Apontamento de Operações, selecione a operação de Saída de Viagem e clique em Apontar.

Informe os campos de Dt. Início/Hr .Início e Dt. Realizada/Hr. Realizada.

Clique em Confirmar para registrar o apontamento de Saída.

Ou

Caso utilizado a Viagem Mod. 3., através da rotina principal de Viagem Modelo 3 acesse a Aba Operações da Viagem, posicione na operação de Saída de Viagem e clique no botão Apontar.

Informe os campos de Dt. Início/Hr .Início e Dt. Realizada/Hr. Realizada.

Clique em Confirmar para registrar o apontamento de Saída.

2.4 VISÃO MOTORISTA

Após o recebimento da tarefa  (Entrega / Coleta)	Confirmação do App  para deslocamento	Será disponibilizado opções de apps de  navegação	Em caso de cancelamento de apps de navegação, liberadas ações	Cheguei no local	Confirmação chegada no local	Para o caso de entrega: 3 fotos, nome do recebedor, documento, relato, assinatura. Para o caso de Coleta: 3 fotos e relato.	Assinatura no aplicativo mobile A coleta d assinatura não é obrigatória.	Processo finalizado.	Confirmação final.
Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added

2.5 VISÃO PLANEJADOR PORTAL

g. No Protheus, com o job de retorno ativo (ou executado de forma manual), ocorrerá gravação das ocorrências definidas na rotina de  Configuração das Integrações (TMSAI80 - SIGATMS).

Image Added

2.4  Saída da Viagem e Integração Com Coleta Entrega

Ao realizar o processo de integração com integração no apontamento da operação de saída, o processo será o mesmo descrito anteriormente contudo:

a. Quando a Configuração das Integrações (TMSAI80 - SIGATMS) estiver configurada: Campo Envio Reg (DN1_ENVREG) = 2. Saída de Viagem.

b. A integração ocorrerá no apontamento de operação de saída de viagem.
Caso exista layout pré-definido pela TOTVS importado no ambiente e job de envio ativo (ou executado de forma manual), ocorrerá gravação da tentativa de integração com Coleta Entrega na rotina de Histórico de Integrações (TMSAI84 - SIGATMS).

c. Demais informações permaneceram as mesmas detalhadas no item 2.3.Fechamento da Viagem e Integração Com Coleta Entrega.

03. EXEMPLOS DE UTILIZAÇÃO - ENTREGA/COLETA  ENVIO COM INSUCESSO

Diferente da integração predecessora SIGATMS x Meu Checklist, a integração SIGATMS x Coleta Entrega permite o registro de insucesso nas viagens para documentos do tipo solicitação de coleta e entrega.

Ocorrerá a integração e processos de forma idêntica até o item f. da documentação anterior, ou seja, criação de documentos, viagem, fechamento de viagem ou operação de saída para integração, execução de job de envio e deslocamento do motorista ao cliente.

A partir disto, segue abaixo uma simulação de insucesso:

3.1 VISÃO MOTORISTA

2.5 VISÃO PLANEJADOR PORTAL

Além disso, o portal manterá o registro do documento com insucesso (3.) para consulta m Menu lateral Col.Ent (1.), aba Finalizadas com insucesso (2.):

Image Added

No Protheus, com o job de retorno ativo (ou executado de forma manual), ocorrerá gravação das ocorrências definidas para insucesso na rotina de  Configuração das Integrações (TMSAI80 - SIGATMS).

Image Added

04. EXEMPLOS DE UTILIZAÇÃO - ESTORNO DE VIAGEM INTEGRADA E NÃO INICIADA

O processo de estorno da integração também ocorrerá de acordo com a configuração do campo Envio Reg (DN1_ENVREG) = 1. Fechamento ou u 2. Saída de Viagem na rotina Configuração das Integrações (TMSAI80 - SIGATMS).

4.1 PROCEDIMENTO

Quando há utilização do layout pré-definido pela TOTVS importado no ambiente, o código de registro 1150 - DESPACHA VIAGEM AO MOTORISTA envia de forma automática ao Portal e ao APP do Motorista a atividade de despacho ao motorista.

Nesta situação, para prosseguir com estorno no SIGATMS, deve ser realizado inicialmente no Portal o procedimento a seguir:

1. Acessar o Portal Coleta Entrega e e o menu lateral Acompanhamento de Viagens;
2. Posicionar sobre o registro que deve estar com status "Aguardando confirmação de despacho";
   Image Added
   
   
3. Posicionar sobre os três pontos (a.) e depois clicar na opção "Estornar despacho";
   Image Added
   
   
4. Confirmar. A partir deste momento, pode ser realizado o estorno do Fechamento da Viagem ou estorno da Operação de Saída no SIGATMS Protheus.
   

Image Added

05. TABELAS UTILIZADAS

1.2 Configuração dos Jobs (ENVIO e RETORNO)

a. Acesse o Cadastro de Agendamentos de Rotinas via menu Ambiente > Schedule > Schedule.

b. No menu lateral, clique no ícone com o título de Agendamentos para expandir;.

c. Ainda em Agendamentos, clique em Cadastro.

d. Na parte inferior da tela Detalhes, clique no ícone representado por uma página com o sinal de mais . 

e. Para incluir um novo registro, preencha os campos, conforme o quadro Campos Cad. Job.

f.  Salve o cadastro, clicando no ícone representado pela imagem de check na cor verde .

...

Código do usuário que tenha direitos de Administrador.

Utilize o botão representado por uma lupa para abrir a lista de usuários.

...

Nome da rotina do Job.

Informe a rotina TMSAI86 (Função auxiliar do Job Envio Coleta entrega - Envio).

...

...

Informe a hora que será iniciada a execução da rotina, deve estar no formato HH:MM.

Exemplo: 10:07.

...

Informe o grupo de empresa e Filial.

Utilize a lupa ao lado do campo para abrir a tela de Wizard, para seleção da empresa e filial. 

...

Código do usuário que tenha direitos de Administrador.

Utilize o botão representado por uma lupa para abrir a lista de usuários.

...

Nome da rotina do Job.

Informe a rotina TMSAI87 (Função de Job de retorno da integração Coleta Entrega).

...

...

Informe a hora que será iniciada a execução da rotina, deve estar no formato HH:MM.

Exemplo: 10:07.

...

Informe o grupo de empresa e Filial.

Utilize a lupa ao lado do campo para abrir a tela de Wizard, para seleção da empresa e filial. 

...

1.3 Configuração Sem o uso dos  Jobs

Existe a possibilidade de inclusão das rotinas Envio e Retorno (TMSAI86 / TMSAI87 - SIGATMS), diretamente no menu do Módulo TOTVS Logística TMS, porém a execução passará a ser manual, não ocorrendo assim o sincronismo automático do retorno de dados do Portal Coleta Entrega.

a. Uma vez no módulo Configurador, acesse Ambiente > Cadastros > Menus;

b. Na janela aberta, localize na listagem "TMS - Gestão de Transportes";

c. Clique em OK;

d. Clique em adicionar, para ajuste do novo menu;

e. Sugerimos que seja selecionado o grupo "Miscelânia > Integrações" e em seguida, acionado a opção/botão "Novo Item";

f. Na nova janela, inclua a descrição da rotina "Job de Envio ", em programa digite "TMSAI86", em Módulo procure por "TMS - Gestão de Transportes" e em tipo informe "Função Protheus";

g. Clique em OK;

h. Acione novamente a opção/botão "Novo Item";

i. Na nova janela, inclua a descrição da rotina "Job de Retorno ", em programa digite "TMSAI87", em Módulo procure por "TMS - Gestão de Transportes" e em tipo informe "Função Protheus";

j. Clique em OK;

k. No retorno a tela principal, selecione opção/botão "Gerar";

l. Digite "SIGATMS";

m. Clique em "Gerar";

n. Confirme a geração do menu, clicando em "Sim".

o. No caso de solicitação de criação de backup pelo sistema, confirme clicando em "Sim".

...

Importante: Com a utilização do processo somente via rotina no menu, a execução do processo passa a ser manual, desta forma será necessário a execução da rotina para consulta afim de verificar se há dados de envio e/ou retorno no App Coleta Entrega para assim atualizar dados no Módulo  TOTVS Logística TMS, desde que também não exista um processo automático configurado no Schedule.

02. OUTRAS CONFIGURAÇÕES

Configuração Appserver.ini

O arquivo appserver.ini deve conter as chaves abaixo:

Na sessão [Environment] :

MemoMega>1
TopMemoMega=2

Além disso segue abaixo exemplo de configuração REST que deverá ser configurada:

[ONSTART]
JOBS=FW_MANAGER,FW_QUEUE,REST_JOB

[FW_MANAGER]
MAIN=FWSCHDMANAG
ENVIRONMENT=P1233

[FW_QUEUE]
MAIN=FWSCHDQUEUE
ENVIRONMENT=P1233

[REST_JOB]
MAIN=HTTP_START
ENVIRONMENT=P1233

[HTTPV11]
ENABLE=1
Sockets=HTTPREST
MAXSTRINGSIZE=500

[HTTPREST]
Port=1225
SECURITY=0
URIs=HTTPURI1
IPsBind=

[HTTPURI1]
URL=/rest
PrepareIn=T1,M SP 01
Instances=1,2
ENVIRONMENT=P1233
CORSEnable=1
AllowOrigin=*                                                                                                 

[WebApp/webapp]
MPP=

Obs.: Os exemplos acima contém apenas os valores referentes a integração com Coleta Entrega.

Para melhor aproveitamento e em caso de dúvidas recomendamos a leitura da documentação sobre REST.

03. TABELAS UTILIZADAS

• DA4 - Motoristas
• DN0 - Configuração das Integrações  
• DN1 - Config Integr Coleta/Entrega  

• DN2 - Tipos de Registro             
• DN3 - Layout dos Registros    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  Herança ID Externo

...

• DNC - Cabeçalho do Histórico

06. ASSUNTOS RELACIONADOS

• Integração Coleta Entrega (SIGATMS)
• Fontes de Integração (TMSAI81 - SIGATMS)
• Configuração das Integrações (TMSAI80 - SIGATMS)
• Filiais de Integração (TMSAI85 - SIGATMS)
• Layouts de Integrações (TMSAI82 - SIGATMS)
• Chaves Protheus e Portal (TMSAI83 - SIGATMS)
• Histórico de Integrações (TMSAI84 - SIGATMS)
• Exporta e Importa Layout (TMSAI88A / TMSAI88B - SIGATMS)
• Exemplos de Utilização - Viagens Integradas SIGATMS x Coleta Entrega (SIGATMS)
• Pontos de Entrada da Integração (SIGATMS)
• Melhorias na Integração TMS x Coleta Entrega (SIGATMS)

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>