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:
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 .
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). |
No SIGATMS, clique em Atualizações > Financeiro > Fatura por Documento.
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.
Após execução do Job de Envio - O status do documento será atualizado para "Pago":
Mais detalhes:
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. |
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.
O registro no Portal é efetivado, acessar menu lateral Documentos Financeiros, o status do documento neste momento será "À vencer":
Mais detalhes:
O processo de baixa a receber será o mesmo destacado anteriormente para Faturamento por Documento.
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. |
Acessar as rotinas Fatura por Documento ou Fatura Automática:
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
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
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
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. |
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:
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. |
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)". |
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.
