Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
NOME DO REQUISITO

Integração SIGATMS x ERP Datasul Finanças ACR

Características do Requisito

Linha de Produto:

Informe a linha de produto.
Microsiga Protheus

Segmento:

Informe o segmento.

Supply Chain - Logística

Módulo:

Informe o módulo.

SIGATMS - Gestão de Transportes

Rotina:

Rotina

Nome Técnico

Informe a rotina.

Informe o nome técnico da rotina.

Fatura por Documento

TMSA850

Fatura AutomáticaTMSA491

Rotina(s) envolvida(s)

Nome Técnico

Informe a(s) rotina(s) envolvidas.

Informe o nome técnico da(s) rotina(s) envolvidas.

 

 
Solicitação de TransferênciaTMSA890
TransferênciaTMSA870
Transferência por LoteTMSA900
Manutenção de DocumentosTMSA500
Perfil do ClienteTMSA480
Baixa Documentos TransportadosTMSA880
Painel de AgendamentoTMSAF76

Parâmetro(s):

MV_TMSERP

Cadastros Iniciais:

Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito.

Parâmetro(s):

Informe os parâmetros utilizados.

Ponto de Entrada:

Informe o ponto de entrada relacionado (link).

Chamados Relacionados

Informe o(s) chamado(s) relacionado(s).

Requisito (ISSUE):
 Informe o requisito relacionado (Issue).
LOGTMS01-516

País(es):

Brasil

Tabelas Utilizadas:

Informe o(s) Pais(es).

Banco(s) de Dados:

Informe o(s) Banco(s) de Dados utilizado(s).

Tabelas Utilizadas:

Informe as tabelas utilizadas.

Sistema(s) Operacional(is):

Informe o(s) sistema(s) operacional(is) utilizados.

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

 

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

  • Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
  • Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
  • Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
  • Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
  • O compatibilizador deve ser executado com a Integridade Referencial desativada*.

 

Atenção

O procedimento a seguir deve ser realizado por um profissional   qualificado como Administrador de Banco de Dados (DBA) ou equivalente!

A ativação indevida da Integridade Referencial pode alterar   drasticamente o relacionamento entre tabelas no banco de dados. Portanto,   antes de utilizá-la, observe atentamente os procedimentos a seguir:

  1. No   Configurador (SIGACFG), veja se a empresa utiliza Integridade   Referencial, selecionando a opção Integridade/Verificação   (APCFG60A).
  2. Se não   há Integridade Referencial ativa,   são relacionadas em uma nova janela todas as empresas e filiais cadastradas   para o sistema e nenhuma delas estará selecionada. Neste caso, E SOMENTE NESTE, não é necessário   qualquer outro procedimento de ativação   ou desativação de integridade, basta finalizar a verificação e aplicar   normalmente o compatibilizador, conforme instruções.
  3.  Se há Integridade Referencial ativa   em todas as empresas e filiais, é   exibida uma mensagem na janela Verificação   de relacionamento entre tabelas. Confirme a mensagem para que a   verificação seja concluída, ou;
  4.  Se   há Integridade Referencial ativa   em uma ou mais empresas, que não   na sua totalidade, são relacionadas em uma nova janela todas as empresas e   filiais cadastradas para o sistema e, somente, a(s) que possui(em)   integridade está(arão) selecionada(s). Anote qual(is) empresa(s) e/ou   filial(is) possui(em) a integridade ativada e reserve esta anotação para   posterior consulta na reativação (ou ainda, contate nosso Help Desk Framework   para informações quanto a um arquivo que contém essa informação).
  5. Nestes   casos descritos nos itens “iii” ou   “iv”, E SOMENTE NESTES CASOS, é necessário desativar tal integridade, selecionando a opção Integridade/ Desativar (APCFG60D).
  6.  Quando desativada a Integridade Referencial,   execute o compatibilizador, conforme instruções.
  7. Aplicado o compatibilizador, a Integridade   Referencial deve ser reativada, SE E   SOMENTE SE tiver sido desativada, através da opção Integridade/Ativar (APCFG60). Para isso, tenha em mãos as   informações da(s) empresa(s) e/ou filial(is) que possuía(m) ativação da   integridade, selecione-a(s) novamente e confirme a ativação.

 

Contate o Help Desk Framework EM CASO DE DÚVIDAS!

 

  1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
  2. Clique em OK para continuar.
  3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
  4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
    1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
    2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
    3. Clique em Gravar para salvar o histórico (log) apresentado.
    4. Clique em OK para encerrar o processamento.

 

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

  1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
  2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Nome da Variável:

Informe o Nome da Variável

Tipo:

Informe o Tipo

Descrição:

Informe a Descrição

Valor Padrão:

Informe o Valor Padrão

 

 

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

  1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

Pergunte

(X1_PERGUNT)

Nome

 

Grupo

(X1_GRUPO)

Ordem

(X1_ORDEM)

Tipo

(X1_TIPO)

Tamanho

(X1_TAMANHO)

 

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

Chave

Nome

Modo

PYME

B04

(X2_CHAVE)

Dente/Região

(X2_NOME)

C

(X2_MODO)

N

(X2_PYME)

 

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

Chave

Ex.: AR

Descrição

Ex.: Tabela de IR de Aplicações Financeiras

 

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

  • Tabela BGD - Prod x Cob x Proc x Co-Part:

 

Campo

(X3_CAMPO)

Tipo

(X3_TIPO)

Tamanho

(X3_TAMANHO)

Decimal

(X3_DECIMAL)

Formato

(X3_PICTURE)

Título

(X3_TITULO)

Descrição

(X3_DESCRIC)

Nível

(X3_NÍVEL)

Usado

(X3_USADO) Informe Sim ou Não

Obrigatório

(X3_OBRIGAT) Informe Sim ou Não

Browse

(X3_BROWSE) Informe Sim ou Não

Opções

(X3_CBOX)

When

(X3_WHEN)

Relação

(X3_RELACAO)

Val. Sistema

(X3_VALID)

Help

Descreva o conteúdo informado para Help de Campo no ATUSX

 

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

 

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

  • Pesquisa B05PLS:

Alias

(XB_ALIAS)

Tipo

(XB_TIPO)

Sequência

(XB_SEQ)

Coluna

(XB_COLUNA)

Descrição

(XB_DESCRI)

Contém

(XB_CONTEM)

 

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

Índice

AA1

Ordem

6

Chave

AA1_FILIAL+AA1_CODVEN

Descrição

Cod. Vendedor

Proprietário

S

 

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

Nome da Variável

(X6_VAR)

Tipo

(X6_TIPO)

Descrição

(X6_DESCRIC + X6_DESC1 + X6_DESC2)

Valor Padrão

(X6_CONTEUD)

 

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

  • Tabela BD5 – Contas Médicas:

Campo

Informe o conteúdo do (X7_CAMPO)

Sequência

Informe o conteúdo do (X7_SEQUENC)

Campo Domínio

Informe o conteúdo do (X7_CDOMIN)

Tipo

Informe o conteúdo do (X7_TIPO)

Regra

Informe o conteúdo do (X7_REGRA)

Posiciona?

Informe o conteúdo do (X7_SEEK)

Chave

Informe o conteúdo do (X7_CHAVE)

Condição

Informe o conteúdo do (X7_CONDIC)

Proprietário

Informe o conteúdo do (X7_PROPRI)

 

 

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

 

CONFIGURAÇÃO DE PARÂMETROS

 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
    (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

Itens/Pastas

Descrição

Nome:

 

Tipo:

Informe o Tipo do parâmetro

Cont. Por.:

Informe o Conteúdo padrão

Descrição:

 

 

CONFIGURAÇÃO DE MENUS

 

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Menu

Informe o Menu em que estará localizada a rotina

Submenu

Informe o Submenu em que estará localizada a rotina

Nome da Rotina

Informe o Título da rotina

Programa

Informe o Fonte da rotina

Módulo

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Tipo

Informe a Função

 

 

Procedimento para Utilização

  • Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
  • Localização da rotina no menu;
  • Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
  • Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

 

 

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

 

 

Vídeo

  • Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

 

Título do Vídeo:

Disponibilizado pelo Marketing.

Introdução:

Disponibilizado pelo Marketing.

Passo a Passo:

Capturar diretamente do sistema.

Finalização:

Disponibilizado pelo Marketing.

 

 

DRT - Fatura de Transporte a Receber


Descrição

Por intermédio deste requisito, será possível integrar as informações de contas a receber geradas pelo módulo SIGATMS (Transportation Management System) da linha Microsiga Protheus com o módulo Finanças ACR da linha Datasul.

Para isto, foram realizadas as seguintes alterações:

  • Disponibilização de um novo parâmetro para configuração da integração com o módulo Finanças ACR da linha Datasul.
  • Inclusão de uma nova tabela: DRT - Fatura de Transporte a Receber, que controlará a Fatura dentro do SIGATMS.
  • Inclusão de novos programas de Fatura por Documento e Fatura Automática, que serão executados pelos programas já existentes em substituição e utilizarão a nova tabela.
  • Alteração de todos os pontos que possuem amarração com o SIGAFIN (Integração com o Financeiro Protheus), para possuírem tratamentos necessários utilizando a nova tabela de fatura.
  • Bloqueio do programa de Baixa Documento de Transporte.
  • Inclusão de novos programas de adapters para processamento das mensagens de integração: Fatura de Transporte (Tratamento de envio e recebimento da resposta) e Status da Fatura de Transporte (Tratamento de recebimento da mensagem para atualização do status da fatura). 


Procedimento para Configuração 

CONFIGURAÇÃO DE PARÂMETROS 

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017)
  2. Configure o(s) parâmetro(s) a seguir:

Itens/Pastas

Descrição

Nome:

MV_TMSERP

Tipo:

C - Caractere

Cont. Por.:

1

Descrição:

ERP que está integrado ao SIGATMS.

Observação:Novo parâmetro que indica se há integração com o Datasul (Conteúdo igual a "1") 

Itens/Pastas

Descrição

Nome:

MV_TMSMFAT

Tipo:

C - Caractere

Cont. Por.:

2

Descrição:

Modo de faturamento

Observação:Parâmetro já existente no SIGATMS, porém, quando houver integração com o contas a receber do ERP Datasul, deverá conter o conteúdo "2" 


Procedimento para Utilização

Para efetuar a correta integração entre os módulos Protheus (SIGATMS) e Datasul (ACR) (Contas a Receber), é necessário efetuar os processos de instalação/configuração e cadastros, conforme o documento de integração DI_Protheus_x_Datasul.

Todos os procedimentos e resultados citados abaixo, consideram que o parâmetro MV_TMSERP, esteja indicando a integração com o Datasul (Valor: "1").

Fatura por Documento

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Financeiro / Fatura por Documento (TMSA850).
  2. Ao acessar o programa Fatura por Documento (TMSA850), será automaticamente direcionado ao novo programa de Fatura (TMSA851).
  3. A nova rotina Fatura (TMSA851) é semelhante a rotina já existente Fatura por Documento (TMSA850), porém utiliza a nova tabela DRT e se difere nos seguintes pontos:
    1. Não são apresentados os campos: Tipo, Natureza e Prefixo (por serem apenas utilizados na integração com o SIGAFIN).
    2. A data de vencimento é opcional (sendo definida pela condição de pagamento do cliente no ERP Datasul, quando não informada).
    3. Não será possível realizar ajustes de Acréscimo e Decréscimo nos conhecimentos selecionados para a fatura. Sendo assim, qualquer alteração de valor, desconto ou juros, deve ser aplicado no momento da baixa do título no contas a receber.
    4. Ao selecionar os conhecimentos que irão compor a fatura e confirmar a inclusão da mesma, será integrado ao contas a receber do ERP Datasul, gerando os títulos conforme parametrização do financeiro.
    5. A operação de cancelamento será da fatura total, não permitindo o cancelamento parcial.
    6. Possui a funcionalidade de Histórico, permitindo que sejam consultadas as informações principais do título gerado de forma descritiva.

Fatura Automática


  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Financeiro / Fatura Automática (TMSA491).
  2. Ao acessar o programa de Fatura por Documento (TMSA491) será automaticamente direcionado ao novo programa de Fatura (TMSA492).
  3. A nova rotina de Fatura Automática (TMSA492), é semelhante a rotina já existente (TMSA491), porém utiliza a nova tabela DRT e respeita o novo processo de geração de fatura conforme a Fatura por Documento (TMSA851).

Solicitação de Transferência

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Financeiro / Solicitação de Transferência (TMSA890).
  1. Ao clicar em Solicitar, estando selecionado um conhecimento que está vinculado a uma fatura, deve apresentar o help TMSA89007.

Transferência

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Financeiro / Transferência (TMSA870).

  2. Ao selecionar uma Solicitação de Transferência que contenha um conhecimento que esteja vinculado em uma fatura e clicar em Outras Ações / Aprovar, será apresentado o help FIN63003.

Transf. Por Lote

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Financeiro / Transferência por Lote (TMSA900).

  2. No botão Transferir, se informado Fil.Docto., No.Docto. e Serie Docto. de um documento que esteja em uma fatura, será apresentado o help TMSA90002.

Manutenção de Documentos

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Transportes / Manutenção de Documentos (TMSA500).

  2. Ao selecionar um documento que esteja faturado, entrar no modo Visualizar e após clicar em Outras Ações / Visualiza Títulos será apresentado o histórico da fatura, que consta a chave do título gerado no contas a receber, valor e data de vencimento.

Perfil dos Clientes

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Comercial / Perfil dos Clientes (TMSA480).
  2. Ao Incluir ou Alterar um Perfil, ir em Outras Ações / Doc. Fatur. Difer. será apresentado o help TMSA48005, não permitindo o faturamento diferenciado.

Baixa doc. Transp

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Financeiro / Baixa Documentos Transportados (TMSA880).

  2. Será apresentado o Help TMSA88008.

Painel de Agendamento

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / S.A.C / Painel de Agendamento (TMSAF76).

  2. No Painel, na pasta Faturas será apresentado a grid com as informações da nova tabela e operações do novo programa de Fatura por documento (TMSA851). 


Ponto de Entrada


Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Filtro para MBrowse

Programa Fonte:

TMSA851

Função:

TM851FIL

Retorno:

Nome

Tipo

Descrição

Obrigatório

cFilMbrPE

Caracter

Filtro para a tela principal

Não

Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Montagem aRotina no MenuDef

Programa Fonte:

TMSA851

Função:

TM851MNU

Retorno:

Nome

Tipo

Descrição

Obrigatório

aRotAdic

Array

Rotinas adicionais

Não

Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Manipula as colunas de aCampos

Programa Fonte:

TMSA851

Função:

TM851MEC (.F., .F., {aCampos})

Retorno:

Nome

Tipo

Descrição

Obrigatório

aCampos

Array

Campos que deverão ser apresentados na seleção de documentos

Não

Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Atualiza os campos do usuário de cada conhecimento (DT6) selecionado para a fatura

Programa Fonte:

TMSA851

Função:

TM491CPO (.F.,.F., {2,aDoctos[nX][RECNOCTRC],cAliasTRB,,cFatura,})

Retorno:
NomeTipoDescriçãoObrigatório
aCposUsrArrayCampos do usuárioNão

Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Executado após a geração da fatura

Programa Fonte:

TMSA851

Função:

TM851CPO

Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Executado após a gravação da fatura

Programa Fonte:

TMSA851

Função:

TM851ITE

Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Complementar a gravação de alguns campos do DT6 e DVV no cancelamento da fatura

Programa Fonte:

TMSA851

Função:

TM851GRV

Descrição:

Fatura Por docto.

Localização:

Atualizações / Financeiro

Eventos:

Após o cancelamento da fatura

Programa Fonte:

TMSA851

Função:

TM851EXC

Descrição:

Fatura Automática

Localização:

Atualizações / Financeiro

Eventos:

Montagem aRotina no MenuDef

Programa Fonte:

TMSA492

Função:

TM492MNU (Variável aRotina como Private)

Ponto de Entrada

Descrição:

Informe o Menu em que estará localizada a rotina

Localização:

Informe o Submenu em que estará localizada a rotina

Eventos:

Informe o Título da rotina

Programa Fonte:

Informe o Fonte da rotina

Função:

Informe o Nome do(s) produto(s) a ser utilizado ou “Todos”

Retorno:

Nome

Tipo

Descrição

Obrigatório

 

 

 

 

 

 

 

 

 

 

 

 

 

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf

Return aCab