Manual Operacional - Integração com SIG

Projeto: FS008145 (A23716) - Integração com SIG

Nome do cliente: FIEPE

Objetivo

O manual a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual se baseiam no que está descrito no documento "Especificação - Detalhamento Funcional - Integração com SIG".

Pré-requisitos

Não se aplica.

Descrição do processo

Este requisito detalha os parâmetros necessários para a Integração de dados entre o TOTVS Gestão de Estoque, Compras e Faturamento e o Sistema SIG.

Detalhamento do processo

No TOTVS Gestão de Estoque, Compras e Faturamento | Customização | Integração SIG | Parâmetros, o usuário administrador deverá indicar as parametrizações referentes a Integração.

Fábrica de Software TOTVS BH > Manual Operacional - Integração com SIG > image2020-3-27_15-26-2.png

Para correto funcionamento da Integração, deverão ser parametrizadas as seguintes informações:

Campo	Descrição
Endereço WebService SIG	Caminho do WebService SIG que será utilizado na Integração.
Usuário	Usuário para autenticação no WebService da Integração SIG.
Senha	Senha para autenticação no WebService da Integração SIG.
Token Autenticação WebService SIG	Token para autenticação no WebService da Integração SIG.
Numero máximo de Reenvio	Especifica o numero máximo de reenvios que a customização fará.

Obs: Estas informações são armazenadas por coligada.

Pré-requisitos

Necessário realizar a Parametrização da Integração SIG.

Descrição do processo:

A integração de dotação orçamentária acontece do SIG para o TOTVS Gestão de Estoque, Compras e Faturamento via WebService.

Detalhamento do processo

O processo é acionado assim que o usuário cria um orçamento pelo SIG, então chama o WebService disponibilizado pela customização que alimenta as tabelas que são utilizadas pelo TOTVS Gestão de Estoque, Compras e Faturamento.

As tabelas nativas do SGE alimentadas neste processo são: TORCAMENTO e TITMORCAMENTO.

Obs: Não há DE/PARA entre os sistemas, desta forma é necessário que os códigos sejam idênticos, exemplo: centro de custo, natureza orçamentária e demais cadastros que são compartilhados pelo TOTVS Gestão de Estoque, Compras e Faturamento e SIG.

Dados que são recebidos para a propriedade TORCAMENTO (Dados do Orçamento):

Campo WS	Descrição	Destino	Observação
CODCUSTO	Código do centro de custo	TORCAMENTO.CODCUSTO
CODCOLIGADA	Coligada	TORCAMENTO.CODCOLIGADA
CODCOLTBORCAMENTO	Coligada da Nat. Orçamentária/Financeira	TORCAMENTO.CODCOLTBORCAMENTO	Obrigatório
CODSISTEMA	Código do sistema	TORCAMENTO.CODSISTEMA	Não é necessário enviar. Tratado pela customização, padrão 'T'.
CODTBGRUPOORC	Código do grupo orçamentário	TORCAMENTO.CODTBGRUPOORC
CODTBORCAMENTO	Cód. da Tabela da natureza do orçamento	TORCAMENTO.CODTBORCAMENTO
IDORCAMENTO	Id. do centro orçamentário	TORCAMENTO.IDORCAMENTO	Código gerado pela rotina nativa. Não é necessário enviar.
IDPERIODO	Id. do período do orçamento	TORCAMENTO.IDPERIODO	Código gerado pela rotina nativa. Não é necessário enviar.

Dados que são recebidos para a propriedade TITMORCAMENTO (Dados do itens do Orçamento):

Campos WS	Descrição	Destino	Observação
CODCOLIGADA	Coligada	TITMORCAMENTO.CODCOLIGADA	Obrigatório
IDITMPERIODO	Id. do item do período do orçamento	TITMORCAMENTO.IDITMPERIODO	Geração nativa SGE. Não é necessário enviar.
IDORCAMENTO	Id. do controle orçamentário	TITMORCAMENTO.IDORCAMENTO	Geração nativa SGE.. Não é necessário enviar.
IDPERIODO	Id. período do orçamento	TITMORCAMENTO.IDPERIODO	Geração nativa SGE.. Não é necessário enviar.
VALORCEDIDO	Valor cedido	TITMORCAMENTO.VALOREXCEDIDO
VALOREXCEDENTE	Valor excedente	TITMORCAMENTO.VALOREXCEDENTE
VALOROPCIONAL1	Valor opcional 1	TITMORCAMENTO.VALOROPCIONAL1
VALOROPCIONAL2	Valor opcional 2	TITMORCAMENTO.VALOROPCIONAL2
VALORORCADO	Valor orçado	TITMORCAMENTO.VALORORCADO
VALORREAL	Valor realizado	TITMORCAMENTO.VALORREAL
VALORRECEBIDO	Valor recebido	TITMORCAMENTO.VALORRECEBIDO

Retorno do WS:

Campo WS	Descrição	Observação
IDORCAMENTO	Id. do controle orçamentário
IDPERIODO	Id. do período do orçamento
IDITMPERIODO	Id. do item do período de orçamento
STATUS	Status do retorno	0= Erro 1= Sucesso
MENSAGEM	Mensagem	Mensagem de rotina nativa SGE

Pré-requisitos

Necessário realizar a Parametrização da Integração SIG.

Descrição do processo

Faz a integração de transferência de valores do SIG para o TOTVS Gestão de Estoque, Compras e Faturamento via WebService.

Detalhamento do processo

O processo é acionado assim que o usuário cria um orçamento pelo SIG, o processo acionará o WebService disponibilizado pela customização que alimenta as tabelas que são utilizadas pelo TOTVS Gestão de Estoque, Compras e Faturamento. Foi disponibilizado um WebService no TOTVS Gestão de estoque, Compras e Faturamento que recebe as informações necessárias para ajustar o orçamento alimentando a tabela nativa TMOVORCAMENTO.

Propriedade TMOVORCAMENTO (Dados da movimentação do orçamento):

Campos WS	Descrição	Observação
CODCCUSTOORIGEM	Código do centro de custo origem
CODCUSTODESTINO	Código do centro de custo destino	Apenas se for transferência
CODCOLIGADA	Coligada
CODCOLTBORCAMENTO	Coligada da Nat. orçamentária/Financeira
CODTBGRUPOORC	Código do grupo orçamentário
CODTBORCAMENTOORIGEM	Cód. da tabela de natureza do orçamento de origem
CODTBORCAMENTODESTINO	Cód. da tabela de natureza do orçamento de destino	Apenas se for transferência
IDMOVORCAMENTO	Id. da movimentação de orçamento
IDORCAMENTO	Id. do controle orçamentário
IDPERIODOORIGEM	Id. do período do orçamento de origem
IDPERIODODESTINO	Id. do período do orçamento de destino	Apenas se for transferência
TIPO	Tipo da movimentação	Somente deve ser enviado se for Atualização. Retificação (R) Suplementação (S) Transposição (T)
VALORORCADO	Valor orçado
VALORREAL	Valor real
VALOROPCIONAL1	Valor opcional 1
VALOROPCIONAL2	Valor opcional 2
VALORRECEBIDO	Valor recebido
VALORCEDIDO	Valor cedido

Propriedade TMOV (Tabela de Movimentos):

Campos WS	Descrição
FILIAL	Filial
RECCREATEDBY	Usuário de criação
CODTMV	Tipo do movimento
NUMEROMOV	Número do movimento
HISTORICO	Histórico

A partir do Centro de Custo e Natureza Orçamentária de destino informados no TOTVS Gestão de Estoque, Compras e Faturamento, a customização localiza todos os itens de Movimentos que possuem o mesmo Centro de Custo e Natureza enviado como bloqueado para o sistema SIG e realiza o preenchimento do campo complementar indicando que o Item foi reprovado.

Dessa forma, o usuário pode prosseguir com a solicitação do movimento escolhendo apenas os itens que foram aprovados e desbloqueados pelo SORS.

Para identificar que se trata de uma reprovação, o campo "TipoDestino" do Web Service de "Transferência de Valor" é enviado com valor "0".

A customização a partir do "IdMov", "CodCCustoDestino" e "CodTbOrcamentoDestino", localiza os itens de movimentos que utilizam esses dados e preenche o campo complementar indicando a reprovação.

Pré-requisitos

Necessário realizar a Parametrização da Integração SIG.

Descrição do processo

O objetivo deste requisito é detalhar a integração movimentações que afetem orçamento (comprometimento, reserva e realização de orçamento) para o SIG via WebService.

Detalhamento do processo

Os dados do SIG serão atualizados com os dados da movimentação realizada no TOTVS Gestão de Estoque, Compras e Faturamento para que tenha condições de atualizar o orçamento no TOTVS Gestão de Estoque, Compras e Faturamento se for no caso de uma movimentação que gera bloqueio através da rotina de exportação.

Propriedade TMOVORCAMENTO (Dados da movimentação do orçamento):

Campos WS	Descrição
BLOQUEADO	Movimentação bloqueada no TOTVS Gestão de estoque, Compras e Faturamento	0= Não bloqueada 1 = Bloqueada.
CODCUSTO	Código do centro de custo
CODCOLIGADA	Coligada
CODCOLTBORCAMENTO	Coligada da Nat. Orçamentária/Financeira
CODTBGRUPOORC	Código do grupo orçamentário
CODTBORCAMENTO	Cód. da tabela de natureza do orçamento
IDMOVORCAMENTO	Id. da movimentação de orçamento
IDORCAMENTO	Id. do controle orçamentário
IDPERIODO	Id. do período do orçamento
VALORORCADO	Valor orçado
VALORREAL	Valor real
VALOROPCIONAL1	Valor opcional 1
VALOROPCIONAL2	Valor opcional 2
VALORRECEBIDO	Valor recebido
VALORCEDIDO	Valor cedido

Pré-requisitos

Não se aplica.

Descrição do processo

Criação do menu TOTVS Educacional | Customização | Log da Integração. Neste processo o usuário consegue consultar o LOG das operações de importação e exportação executadas pela integração e executar o reenvio dos registros do tipo exportação.

Detalhamento do processo

Na tela "Log da Integração" é possível efetuar apenas a consulta das informações, não sendo possível editar os dados. Os campos abaixo são exibidos na visão:

Campos	Descrição
ID	ID do Processo
CODCOLIGADA	Código da Coligada
PROCESSO	Nome do Processo
STATUS	Status do registro – Erro ou Sucesso
CHAVE	Chave do Registro
DATA	Data do registro
DESCRIÇÃO DO ERRO	Descrição do Erro
ARQUIVO XML	Arquivo XML recebido ou Enviado
REPROCESSADO	Indica se o registro já foi reenviado – Exibe Sim ou Não
TIPO	Exportação ou Importação

Pré-requisitos

Não se aplica.

Descrição do processo

Tela para registro de rateio de centro de custo do movimento

Detalhamento do processo

Ao acessar um tipo de movimento que esteja parametrizado para lançar rateio de centro de custo por item de movimento (Etapa Rateio de centro de custo e departamento dos parâmetros) um anexo com as informações de Rateio por centro de custo do item será disponibilizada.