Histórico da Página

Image Modified

CONTEÚDO

Índice

01. VISÃO GERAL

...

Informações

title	Importante:

Para que os documentos do tipo Fatura, ou seja, títulos no Contas à Receber sejam integrados ao P

ortal Portal Logístico, é indispensável que os documentos de transporte que serão aglutinados em uma única fatura (título) a receber, já existam no Portal Logístico (Documento de Carga + Documento Transporte).

...

No SIGATMS, clique em Atualizações > Financeiro > Fatura Automática.
Na tela Fatura Automática, clique em Gerar.
Na sequência é apresentada a tela Faturas a Receber por Cliente, indicando o objetivo da rotina.
Clique em Parâmetros para configurar os parâmetros que serão considerados na geração da Fatura automática.
Informe os dados necessários para este processo.
Clique em OK para continuar.
Se ocorrer algum problema durante o processamento será exibida tela Verifique os Dados, destacando as divergências encontradas.
Exemplo: Informar condição de pagamento no cadastro do cliente 000001/01.
Para verificar os detalhes do Cadastro do Cliente, clique em Mais Detalhes.
Caso contrário, será apresentada a tela Faturas por Cliente, exibindo: os clientes considerados, valor da Fatura por cliente, o valor total das Faturas, separa por produto, por transporte, Filial de débito, entre outros.
Nesta tela é possível marcar/desmarcar os clientes considerados para a Fatura automática. Para isto, dê duplo clique no registro desejado e observe que, ao marcar/desmarcar um item, o campo Total da(s) Fatura(s) (exibido no rodapé). será alterado.
Confira os dados e confirme a geração da fatura automática.
Ao confirmar, as Faturas serão gerados no Contas a Receber, de acordo com o perfil do cliente e a condição de pagamento determinada.
Além da geração do título para a cobrança total do serviço (Componentes da Tabela (TAXA) + valor fixo do Contrato), o Sistema irá gerar uma Nota Fiscal de serviço ou Conhecimento de Frete para o embasamento legal.
A partir deste momento será registrado na rotina de Histórico de Integrações (TMSAI84), com Status = 'Não Integrado' e Situação = 'Em aberto'.
Após a execução do Job de Envio, o registro será atualizado:
Registro será atualizado na rotina Histórico de Integrações (TMSAI84), com Status = 'Integrado' e Situação= 'Enviado':

Portal Logístico
O registro no Portal é efetivado, acessar menu lateral Documentos Financeiros, o status do documento neste momento será "À vencer":

Mais detalhes:

Baixa à Receber

O processo de baixa a receber será o mesmo destacado anteriormente para Faturamento por Documento.

...

03. EXEMPLO DE UTILIZAÇÃO - CANCELAMENTO DE FATURAS

Para documentos

...

SEM baixa realizada - Contas à Receber

...

Acessar as rotinas Fatura por Documento ou Fatura Automática:
No SIGATMS, clique em Atualizações > Financeiro > Fatura Automática ou Atualizações > Financeiro > Fatura por Documento.
Posicione sobre uma fatura/título com Status = 'Em aberto'
TMS
Image Added

PORTAL
Image Added

Acesse a opção Outras Ações > Cancelar
Image Added

Clique em Confirmar.
O status da fatura/título passará para o status = 'Fatura Cancelada'.
Image Added

Após a execução do Job de Envio o documento financeiro no Portal Logístico deixará de existir.
Image Added

04. FATURAS COM ACRÉSCIMO - DECRÉSCIMO - RECEBIMENTO PARCIAL

Visualização de Documentos com Recebimento Parcial

Ao realizar a consulta de documentos onde há recebimento parcial no Portal Logístico será possível identificar ao visualizar o documento na seção descritiva de valores:

TMS
Image Added

PORTAL

Image Added

Visualização de Documentos com Ajuste Decréscimo

No exemplo abaixo o valor do Frete é de R$220,00 sendo realizado um ajuste/desconto valor fatura/título passará a ser R$200,00.

TMS

Image Added

PORTAL

Image Added

Visualização de Documentos com Ajuste Acréscimo

No exemplo abaixo o valor do Frete é de R$280,22 sendo realizado um ajuste/acréscimo o valor fatura/título passará a ser R$300,00.

TMS

Image Added

PORTAL

Image Added

05. JOB STATUS DAS FATURAS PORTAL LOGÍSTICO

Para que a atualização de status dos documentos financeiros ocorra, é necessário que existam títulos (SE1) de faturas originadas pelo Módulo SIGATMS integrados com o Portal Logístico anteriormente.

Ocorrerá o sincronismo por meio do Job localizado na rotina de Job Envio Status Faturas (TMSAI89 - SIGATMS).

Caso a data de vencimento seja menor que a database, os títulos no Portal Logístico serão identificados como vencidos, caso estejam dentro do prazo de pagamento à vencer e pagos quando pagamento já efetuado.

Status documentos financeiros, Portal Logístico:

Status	Descrição
Image Added	Títulos com data de vencimento dentro prazo pagamento.
Image Added	Títulos pagos.
Image Added	Títulos com data de vencimento fora prazo pagamento.

Informações

title	Observação:

A integração de status das faturas TOTVS Logística TMS x TOTVS Portal Logístico utiliza-se apenas do Job de Status (TMSAI89).

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 .

Campos Agent Schedule
Campo	Descrição
Nome	Informe o nome do agente que faz o gerenciamento das execuções das threds/jobs agendados. Exemplo: Agente de Execução Empresa T1.
IP	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.
Porta	Informe a mesma porta de execução do Appserver que fará o controle de execução dos Jobs.
Ambiente	Informe o ambiente configurado no Appserver.ini.
Empresa	Informe o grupo da empresa. Utilize a lupa para selecionar o código da empresa.
Nº de Threads	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.
Habilitado	Quando assinalado, o Agente é habilitado na próxima vez que o Appserver for iniciado.

1.2 Configuração dos Jobs (STATUS)

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 .

Campos Cad. Job
Campo	Descrição
Usuário	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.
Rotina	Nome da rotina do Job. Informe a rotina TMSAI89 (Job Envio Status Fatura).
Data	Informe a data de início da execução do Job no formato DD/MM/YYYY. Exemplo: 26/10/2022
Hora	Informe a hora que será iniciada a execução da rotina, deve estar no formato HH:MM. Exemplo: 10:07.
Ambiente	Informe o ambiente configurado do Appserver.
Empresa/Filial	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.
Módulo	Informe o código do Módulo que, neste caso, deve ser o 43 - TMS Gestão de Transporte.
Habilitada	Quando assinalado, indica que o Job está habilitado.
Descrição	Texto livre. Por sugestão pode ser informado "Função auxiliar do Job Envio Status Fatura)".

Image Added

1.3 Configuração Sem o uso do Job

Existe a possibilidade de inclusão da rotina Job Envio Status Fatura (TMSAI89 - 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ânea > Integrações" e em seguida, acionado a opção/botão "Novo Item";

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

g. 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".

p. Processo realizado, bastando sair da tela de configuração.

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.

Execução Job Manual

Image Added

Atualização Portal

Image Added

06. TABELAS UTILIZADAS

DUO - Perfil do Cliente
SA1 - Cadastro de Clientes
SE1 - Contas a Receber
SE5 - Movimentação Bancária
DT6 - Documentos de Transporte
DUX – Itens da prestação de serviço

07. ASSUNTOS RELACIONADOS

Seguindo a documentação da rotina FINA070 - Baixas a Receber , realize o processo de cancelamento da baixa fatura/título.
Após a execução do Job do Envio;

04. TELA XXXXX

Principais Campos e Parâmetros

...

Card documentos

Informacao	Use esse box para destacar informações relevantes e/ou de destaque.
Titulo	IMPORTANTE!

05. TABELAS UTILIZADAS

SE1

Árvore de páginas

Versões comparadas

Versão antiga 7

Nova versão Atual

Chave

Image Modified

CONTEÚDO

01. VISÃO GERAL