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_4

Documentação Senior: Clique aqui!

PROCEDIMENTO CLIENTE

Cadastro do sistema integrado

  1. 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”.

 

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_3”;

  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”.

 

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://web03.senior.com.br:39301). 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 “Produtos”;

  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://web03.senior.com.br:39301

  11. Insira a EndPoint Confirmação. Exemplo:

    https://web03.senior.com.br:39301

  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".

GATILHOS DE EXECUÇÃO DO SERVIÇO

Temporal: O serviço é executado a cada 2 (Duas) 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://mobilidade-homolog.sismetro.ind.br:9090/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

O parâmetro CodFil embora obrigatório na requisição não realiza filtragem dos cadastros por filial.

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.
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.NumSer

Número de série 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. -

 

 

 

 

 

 

Back to top