Linha Microsiga Protheus

Árvore de páginas

Bandeira Brasil Localização.png

CONTEÚDO


01. VISÃO GERAL

Após a configuração do processo de integração  TOTVS Logística TMS x TOTVS Portal Logístico, incluindo os itens abaixo será possível a integração documento Fatura, ou seja, títulos no Contas à Receber (SE1), para integração junto ao TOTVS Portal Logístico:

  • Configuração de rotinas;
  • Layout;
  • Job de Envio.

A geração do documento tipo Fatura poderá ocorrer via rotinas Fatura Por Documento (TMSA850) ou Fatura Automática (TMSA491).

Quanto ao processo de baixa do título ocorrerá através da rotina FINA070 - Baixas a Receber .

02. EXEMPLO DE UTILIZAÇÃO - GERAÇÃO DE FATURAS

Importante:

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

ortal 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).

Gerar Faturas Por Documento

  1.  No SIGATMS, clique em Atualizações > Financeiro > Fatura por Documento.

  2.  Pressione a tecla F12 para realizar a parametrização específica da rotina.
  3.  Em seguida é apresentada a tela Parâmetros:
     a.  Considera Lojas?
     b.  Vis Doc Apoio/CTE/Ambos (este parâmetro será descontinuado a partir do release 12.1.27).
  4.  Informe os dados necessários, com atenção especial ao seguinte parâmetro: Considera Lojas?.

  5.  Selecione Sim para definir se a loja do cliente deve ser considerada na filtragem dos documentos a serem faturados.
     Caso contrário,     os documentos de todas as lojas do cliente são exibidos para a geração da fatura.

  6.  Confira os dados e confirme.

  7.  Em seguida, clique em Selecionar.
     O Sistema apresenta uma pequena janela, solicitando a seleção da Filial do cliente desejada.
  8.  Selecione a Filial e confirme.
  9.  Na sequência é apresentada a tela para informação dos dados da fatura.
  10.  Informe os dados necessários e confirme.
  11.  O Sistema abre uma janela solicitando a confirmação dos dados.  Confirme.
  12.  O Sistema apresenta a tela de Faturas a Receber.
  13.   Informe os dados necessários e confirme.


  14. 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'.




  15. Após a execução do Job de Envio, o registro será atualizado:


  16. 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

  1. Seguindo a documentação da rotina FINA070 - Baixas a Receber , realize o processo de baixa fatura/título.

  2. Após execução do Job de Envio - O status do documento será atualizado para "Pago":


    Mais detalhes:


    Aviso:

    Processos de acréscimo e decréscimo dos valores da fatura/título serão atualizados na visualização do documento financeiro no Portal Logístico.

Gerar Faturas de Forma Automática

  1.  No SIGATMS, clique em Atualizações > Financeiro > Fatura Automática.

  2.  Na tela Fatura Automática, clique em Gerar.

  3.  Na sequência é apresentada a tela Faturas a Receber por Cliente, indicando o objetivo da rotina.

  4.  Clique em Parâmetros para configurar os parâmetros que serão considerados na geração da Fatura automática.

  5.  Informe os dados necessários para este processo.

  6.  Clique em OK para continuar.

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

  8.  Para verificar os detalhes do Cadastro do Cliente, clique em Mais Detalhes.

  9.  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.

  10.  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.

  11.  Confira os dados e confirme a geração da fatura automática.

  12.  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.

  13.  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.

  14. 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'.



  15. Após a execução do Job de Envio, o registro será atualizado:


  16. Registro será atualizado na rotina Histórico de Integrações (TMSAI84), com Status = 'Integrado' e Situação= 'Enviado':




    Portal Logístico


  17.  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.

Aviso:

Processos de acréscimo e decréscimo dos valores da fatura/título serão atualizados na visualização do documento financeiro no Portal Logístico.


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:

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


    PORTAL


  3. Acesse a opção Outras Ações > Cancelar


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


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

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

PORTAL

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

PORTAL

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

PORTAL

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:

StatusDescrição

Títulos com data de vencimento dentro  prazo pagamento.

Títulos pagos.

Títulos com data de vencimento fora prazo pagamento.

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 (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 (seleção).


Campos Agent Schedule
CampoDescriçã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.

PortaInforme a mesma porta de execução do Appserver que fará o controle de execução dos Jobs.
AmbienteInforme 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.

HabilitadoQuando 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 (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 (seleção).

Campos Cad. Job
CampoDescriçã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:  

Hora

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

Exemplo: 10:07.

AmbienteInforme 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óduloInforme o código do Módulo que, neste caso, deve ser o 43 - TMS Gestão de Transporte.
HabilitadaQuando assinalado, indica que o Job está habilitado.
DescriçãoTexto livre. Por sugestão pode ser informado "Função auxiliar do Job Envio Status Fatura)".





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



Atualização Portal


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