Histórico da Página
CONTEÚDO
...
- Visão Geral
- Exemplo de utilização
- Tela XXX
- Outras Ações / Ações relacionadas
- Outras Ações / Ações relacionadas
- Tela XXX
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL
Demonstrar regras de negócio e configurações das Faturas emitidas pelo módulo SIGATMS, títulos no Contas a Receber (SE1), para integrar junto ao Totvs Portal Logístico
02. EXEMPLO DE UTILIZAÇÃO
03. TELA XXXXX
Outras Ações / Ações relacionadas
...
04. TELA XXXXX
Principais Campos e Parâmetros
...
Card documentos | ||||
---|---|---|---|---|
|
05. TABELAS UTILIZADAS
Índice |
---|
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
Informações | ||
---|---|---|
| ||
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
No SIGATMS, clique em Atualizações > Financeiro > Fatura por Documento.
- Pressione a tecla F12 para realizar a parametrização específica da rotina.
- 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). - Informe os dados necessários, com atenção especial ao seguinte parâmetro: Considera Lojas?.
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.Confira os dados e confirme.
- Em seguida, clique em Selecionar.
O Sistema apresenta uma pequena janela, solicitando a seleção da Filial do cliente desejada. - Selecione a Filial e confirme.
- Na sequência é apresentada a tela para informação dos dados da fatura.
- Informe os dados necessários e confirme.
- O Sistema abre uma janela solicitando a confirmação dos dados. Confirme.
- O Sistema apresenta a tela de Faturas a Receber.
- Informe os dados necessários e confirme.
- 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
- Seguindo a documentação da rotina FINA070 - Baixas a Receber , realize o processo de baixa fatura/título.
Após execução do Job de Envio - O status do documento será atualizado para "Pago":
Mais detalhes:Aviso title 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
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.
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:
- 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
PORTAL - Acesse a opção Outras Ações > Cancelar
- Clique em Confirmar.
- O status da fatura/título passará para o status = 'Fatura Cancelada'.
- 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:
Status | Descrição |
---|---|
Títulos com data de vencimento dentro prazo pagamento. | |
Títulos pagos. | |
Títulos com data de vencimento fora prazo pagamento. |
Informações | ||
---|---|---|
| ||
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: |
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: |
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: |
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)". |
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
- Fatura Por Documento (TMSA850 - SIGATMS)
- Fatura Automática (TMSA491 - SIGATMS)
- FINA070 - Baixas a Receber - Protheus 12
- TOTVS PORTAL LOGÍSTICO
- DLOGTMS02-22758 DT INTEGRAÇÃO TMS X PORTAL LOGÍSTICO
- Exemplo de utilização TMS x Portal Logístico - Solicitação de Coleta (DT5)
- Exemplo de utilização TMS x Portal Logístico - Documento de Transporte (DT6)
- Exemplo de utilização TMS x Portal Logístico - Entrada Doc. Cliente (DTC)
- Exemplo de utilização TMS x Portal Logístico - Comprovante de Entrega EletrônicoSE1