Ir para o conteúdo principal

Integração Cadastro de Patrimônios (Bens) com o ERP Senior.

Esta integração permite que os cadastros de patrimônios (bens) sejam replicados do ERP Senior para a plataforma.

MÓDULO

Gestão Inteligente de Manutenção.

ESPECIFICAÇÕES TÉCNICAS

Sentido: Mão única ERP Senior -> Plataforma
Consulta: Plataforma consome WS para receber cadastros pendentes de sincronia
Mecanismo: XML
WSDL: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mct_pat_bem?wsdl
Porta: Exportar_5
Documentação Senior: Clique aqui!

PROCEDIMENTO CLIENTE

Cadastro do sistema integrado
Cadastro do sistema integrado no ERP. Para mais informações. Clique aqui!

Configurações da integração no ERP

  1. No menu principal clique “Cadastro”;

  2. Clique em “Integrações”;

  3. Clique em “Configurações de Tipos de Informações” (Código da Tela: F000SXT);

  4. No campo “Sistema” clique no ícone lupa;

  5. A lista de sistemas integrados será exibida. Clique duas vezes na linha do cadastro do sistema UPSIM;

  6. No campo “Filial” clique no ícone lupa;

  7. A lista de filiais será exibida. Clique duas vezes na linha do cadastro da filial que deseja integrar;

  8. No campo “Informação” selecione a opção “Bem";

  9. Clique em “Mostrar”;

  10. Marque o check box da linha “Tipo de Informação” com a descrição “Bem”;

  11. Na coluna “Situação” insira “A”;

  12. Tecle “Tab”;

  13. O ERP emitirá a mensagem “Deseja Atribuir Valores Para os Itens Selecionados”; Clique na opção “Item atual”;

  14. Clique em “Processar”;

  15. O ERP emitirá mensagem “Processo realizado com sucesso”;

  16. Clique em “OK”.

image-1562888317001.png

Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior


Ativação do Web Service no ERP

  1. No menu principal clique “Cadastro”;

  2. Clique em “Integrações”;

  3. Clique em “Configuração de Web Service” (Código da Tela: F000CWS);

  4. No campo “Código” digite “0”;

  5. Tecla “Tab”;

  6. No campo “Empresa” clique no ícone lupa;

  7. A lista de empresas será exibida. Clique duas vezes na linha do cadastro da empresa desejada;

  8. No campo “Filial” clique no ícone lupa;

  9. A lista de filiais será exibida. Clique duas vezes na linha do cadastro da filial desejada;

  10. No campo “Sistema” clique no ícone lupa;

  11. A lista de sistemas integrados será exibida. Clique duas vezes na linha do cadastro do sistema UPSIM;

  12. No campo “Web Service” selecione a opção “com.senior.g5.co.mct.pat.bem”;

  13. No campo “Porta” selecione a opção “Exportar_5”;

  14. Utilize a caixa where para implementar filtros para evitar a exportação de cadastros que não tem aplicação para a plataforma.

    Exemplo 1:
    AND E670BEM.TIPACR = ' ' AND E670BEM.USU_INTUPS = 'S'

    Exemplo 2:
    AND E670BEM.CODESP IN ('1','5')

  15. No menu lateral “Campos Exportados Pelo Web Service” selecione todas as opções;

  16. Clique em “Processar”;

  17. O ERP emitirá mensagem “Confirmar o Processamento das Configurações do Web Service?”;

  18. Clique “Sim”;

  19. O ERP emitirá mensagem “Configurações do Web Service Gravadas com Sucesso”; Clique em “OK”.

image-1562888246387.png

Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior


Ativação da Integração na Plataforma

  1. Solicite a equipe de suporte que ative a integração;

  2. Informe os seguintes os dados abaixo;

    1. Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);

    2. Usuário responsável Integração no ERP Senior;

    3. Password do usuário responsável Integração no ERP Senior;

    4. Empresa cadastrada no ERP Senior;

    5. Filial cadastrada no ERP Senior;

    6. Tipo de tecnologia padrão. Todo patrimônio que for integrado receberá este tipo de tecnologia;
    7. Categoria padrão. Todo patrimônio que for integrado pertencerá a está categoria. Somente usuários com permissão para visualizar a categoria padrão poderão visualizar os patrimônios integrados;
    8. URL dos Web Service de produção (Exemplo: https://web999.senior.com.br:39999). Caso o usuário não tenha esta informação deve ser aberto um chamado na Senior solicitando a URL.


PROCEDIMENTO EQUIPE SUPORTE 

Ativar a integração na plataforma

  1. Acesse o cadastro da unidade do cliente;

  2. Clique em “Integrações”;

  3. Clique em “Adicionar”;

  4. Selecione o tipo de integração “Patrimônios ”;

  5. Selecione o Vendor/ERP “Senior”;

  6. Insira o "Usuário" e "Password";

  7. Insira a Sigla "UPSIM";

  8. Insira no "parâmetro 1" o ID do tipo de tecnologia padrão que o cliente escolheu. Caso o cliente não informe nenhum tipo de tecnologia utilize o ID 7339 (PATRIMÔNIO INTEGRADO);
  9. Insira no "parâmetro 2" o ID da categoria padrão que o cliente escolheu. Caso o cliente não informe nenhuma categoria utilize o ID 20 (INDUSTRIAL);
  10. Insira o EndPoint WebService. Exemplo:
    https://web999.senior.com.br:3999

  11. Insira a EndPoint Confirmação. Exemplo:
    https://web999.senior.com.br:3999

  12. Insira o EndPoint SISMETRO.
    http://dev.sismetro.com:5000

  13. Insira as observações da integração;

  14. Selecione o tipo da integração: “Total”. Após a primeira sincronia o tipo deverá ser alterado para "Parcial";

  15. Ative a opção “Registrar Logs”;

  16. Clique em “Salvar”.

Observações

  • Substituir o início da URL pelos dados fornecidos pelo cliente
  • A primeira sincronia com o ERP deverá ser realizada com o tipo de integração “Total” ativada. Após a sincronia total ser realizada a integração deverá ser alterada para "Parcial".

 

ParâmetrosPARÂMETROS adicionaisADICIONAIS obrigatóriosOBRIGATÓRIOS

    Definir o IDERP no cadastro da EMPRESA Definir o IDERP no cadastro da FILIAL Selecionar um "Solicitante padrão" no cadastro da FilialFILIAL

     

    GATILHOS DE EXECUÇÃO DO SERVIÇO

    Temporal: O serviço é executado a cada 12 (Doze) horas.

    VALIDAÇÃO DE EXECUÇÃO DO SERVIÇO

    Configuração da integração na unidade

    Tipo de integração: 9
    Vendor: 3
    Status: 1

    A chamada será realizada para o endpoint configurado no cadastro da integração concatenada com o WSDL.

    Exemplo: 
    http://example.com:8080/g5-senior-services/sapiens_Synccom_senior_g5_co_mct_pat_bem


    PARÂMETROS DE REQUISIÇÃO

    Parâmetro de Requisição Campo Tela
    user Usuário Cadastro unidade -> Integrações
    password Password Cadastro unidade -> Integrações
    IdentificacaoSistema Sigla Cadastro unidade -> Integrações
    CodEmp ID ERP da Empresa Cadastro unidade -> Integrações
    CodFil ID ERP da Filial

    Cadastro unidade -> Integrações
    TipoIntegracao

    Integrar total ou parcial

    (T = Todos, A = Somente Alterados).

    Cadastro unidade -> Integrações 

    CHAVE DE UNICIDADE DE REGISTRO

    Chave de unicidade no ERP: codEmp + codBem

    Chave de unicidade na plataforma: unit + codEmp + codBem

    Comportamento do WS: Todos os ativos da empresa serão exportados

    Comportamento da plataforma: A integração será executada periodicamente para todas as empresas e filiais configuradas na plataforma. Todos os cadastros com parâmetros filLoc e Filaqi serão registrados com o tipo de tecnologia e categoria padrão da unidade, para o solicitante padrão da filial. Cadastros de filiais não existentes (sem ID ERP na plataforma) não serão registrados nem confirmados para o ERP, porém serão salvos na listagem de itens pendentes na plataforma. Cadastros com alteração nos parâmetros filLoc e Filaqi gerarão registro de movimentações de patrimônio na plataforma.

    ATRIBUTOS DE RESPOSTA REGISTRADOS

    Parâmetro de Resposta Campo Atualização Cadastral Tela
    Bens.CodBem ID ERP do patrimônio. Não. Cadastro -> Patrimônio.
    Bens.DesBem Dados da Integração. Sim. Cadastro -> Patrimônio.
    Bens.DatAqi Data da compra. Sim. Cadastro -> Patrimônio.
    Bens.FilLoc

    Filial e solicitante.


    *Caso o atributo retorne vazio, as regras abaixo serão aplicadas com base no parâmetro filAqi retornado.


    Inclusão de patrimônio e atualização de patrimônio com filLoc diferente da filial do solicitante atual:  O cadastro do patrimônio será alterado para solicitante padrão selecionado nas configurações da filial retornada neste parâmetro e será gerado uma movimentação para este solicitante.

    Atualização de patrimônio com filLoc igual a filial do solicitante atual:  Não ocorrerá atualização do solicitante do patrimônio nem registro de movimentação. 

    		 Sim. Apenas quando houver alteração de filial.  Cadastro -> Patrimônio.
    Bens.FilAqi

    Filial e solicitante proprietário.


    * Deverá ser registrado apenas uma movimentação com todas as alterações baseadas nos parâmetros filLoc e filAqi.

    Inclusão de patrimônio e atualização de patrimônio com filAqi diferente da filial do solicitante proprietário atual:  O cadastro do patrimônio será alterado para o solicitante proprietário padrão selecionado nas configurações da filial retornada neste parâmetro e será gerado uma movimentação com alteração de solicitante proprietário.

    Atualização de patrimônio com filAqi igual a filial do solicitante proprietário atual:  Não ocorrerá atualização do solicitante proprietário do patrimônio nem registro de movimentação proprietário. 

    		 Sim. Apenas quando houver alteração de filial.  Cadastro -> Patrimônio.
    Bens.CodLoc

    Solicitante.


    Corresponde ao ID ERP do solicitante da filial em questão. Quando o valor for válido o patrimônio será registrado no solicitante deste parâmetro e a regra de solicitante padrão da filial será ignorada. 


    Quando este parâmetro estive em vazio ou com valor inválido (ID ERP Solicitante) o solicitante será atribuído de acordo com o solicitante padrão da filial em questão.

    Atualização de patrimônio com alteração do solicitante atual:  O cadastro do patrimônio será alterado para o novo solicitante (Padrão da filial em questão ou CodLoc) e será gerado uma movimentação para este solicitante.

    		 Sim.  Cadastro -> Patrimônio.
    Bens.CodFor Fornecedor. Sim. Cadastro -> Patrimônio.
    Bens.CodSnf Série da Nota Fiscal de Entrada. Sim. Cadastro -> Patrimônio.
    Bens.NumDoc N° da nota. Sim. Cadastro -> Patrimônio.
    Bens.DatGar Garantia até. Sim. Cadastro -> Patrimônio.
    Bens.VlrBas Valor pago. Sim. Cadastro -> Patrimônio.
    Bens.DatBai

    Data baixa.


    Quando o patrimônio possuir data de baixa o status será alterado para 5 (Baixado) e motivo para 4 (Outro).
    		Cadastro -> Patrimônio.
    Bens.CodCcu Centro de custo. Sim. Cadastro -> Patrimônio.
    Bens.ImgBem

    Imagem.

    		 Sim. Cadastro -> Patrimônio -> Galeria de fotos.


    Detalhes.


    Todos os parâmetros de usuários são salvos no campo detalhes no seguinte formato:


    Nome do campo: Conteúdo

    Nome do campo: Conteúdo

    		 Sim. Cadastro -> Patrimônio.

    CamposUsuario

    CamposUsuario.campo

    CamposUsuario.valor

    Detalhes.


    Todos os parâmetros de usuários são salvos no campo detalhes no seguinte formato:


    Nome do campo: Conteúdo

    Nome do campo: Conteúdo

    		 Sim. Cadastro -> Patrimônio.

    Tipo de tecnologia.


    O patrimônio possuirá o tipo de tecnologia inserido no parâmetro 1 na configuração da integração no cadastro da unidade.

    		 Não. Cadastro -> Patrimônio.

    Categoria.


    O patrimônio possuirá a categoria inserida no campo no parâmetro 2 na configuração da integração no cadastro da unidade.

    		 Não. Cadastro -> Patrimônio.

    Usuário.


    Todos os patrimônios serão lançados como usuário rotina automática ID 10.

    		 Sim. Cadastro -> Patrimônio.

    Marca.


    Todos os patrimônios serão lançados como sem marca ID 1.


    Regra válida apenas para inclusões cadastrais, edições não geram alterações neste campo.

    		 Não Cadastro -> Patrimônio.

    Modelo.


    Todos os patrimônios serão lançados como sem modelo ID 1.


    Regra válida apenas para inclusões cadastrais, edições não geram alterações neste campo.

    		 Não. Cadastro -> Patrimônio.

    Gravidade.


    Todos os patrimônios receberão gravidade ID 1 (Sem gravidade).

    		 Não. Cadastro -> Patrimônio.
    serBem

    Número de série do patrimônio.

    		 Sim. Cadastro -> Patrimônio
    Usu.DesTec

    Descrição técnica complementar do patrimônio.


    Deverá ser criado o campo de usuário e configurado o parâmetro no WebService no ERP.

    		 Sim. Cadastro -> Patrimônio
    Usu.TagBem

    TAG do patrimônio.


    Deverá ser criado o campo de usuário e configurado o parâmetro no WebService no ERP.

    		 Sim. Cadastro -> Patrimônio


    Dúvidas

    Dúvida Solução Direito
    É necessário contatar a equipe de suporte da Senior para esta operação? Não. O usuário do ERP pode efetuar a operação sozinho. -

    Esta documentação é válida para GO UP e ERP Full?

    		 Sim. O procedimento é o mesmo para ambos. -

    É obrigatório restringir a exportação a produtos de manutenção?

    		 Não, porém restringir garante que produtos não relacionados a manutenção não sejam enviados para a plataforma. -

    É necessário reiniciar o servidor após efetuar o procedimento?

    		 Não. -

    Ao excluir um cadastro no ERP o mesmo é replicado para a plataforma?

    		 Não. Quando um cadastro é "excluído" do ERP não é gerado sincronia para a plataforma. -







    Voltar ao topo