# 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!](https://documentacao.senior.com.br/gestaoempresarialerp/5.10.2/webservices/com_senior_g5_co_mct_pat_bem.htm "Documentação Integração ERP Senior")

**PROCEDIMENTO CLIENTE**

***Cadastro do sistema integrado*** Cadastro do sistema integrado no ERP. Para mais informações. [Clique aqui!](https://doc.sismetro.com/books/erp-senior/page/cadastro-de-sistema-integrado-no-erp-senior "Cadastro de Sistema Integrado no ERP Senior") ***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”. ![](https://doc.sismetro.com/uploads/images/gallery/2019-07-Jul/scaled-840-0/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”. ![](https://doc.sismetro.com/uploads/images/gallery/2019-07-Jul/scaled-840-0/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".

**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**
userUsuárioCadastro unidade -> Integrações
passwordPasswordCadastro unidade -> Integrações
IdentificacaoSistemaSiglaCadastro unidade -> Integrações
CodEmpID ERP da EmpresaCadastro unidade -> Integrações
CodFilID ERP da FilialCadastro unidade -> Integrações
TipoIntegracaoIntegrar 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.CodBemID ERP do patrimônio.Não.Cadastro -> Patrimônio.
Bens.DesBemDados da Integração.Sim.Cadastro -> Patrimônio.
Bens.DatAqiData da compra.Sim.Cadastro -> Patrimônio.
Bens.FilLocFilial 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.FilAqiFilial 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.CodLocSolicitante. 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.CodForFornecedor.Sim.Cadastro -> Patrimônio.
Bens.CodSnfSérie da Nota Fiscal de Entrada.Sim.Cadastro -> Patrimônio.
Bens.NumDocN° da nota.Sim.Cadastro -> Patrimônio.
Bens.DatGarGarantia até.Sim.Cadastro -> Patrimônio.
Bens.VlrBasValor pago.Sim.Cadastro -> Patrimônio.
Bens.DatBaiData 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.CodCcuCentro de custo.Sim.Cadastro -> Patrimônio.
Bens.ImgBemImagem. 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ãoCadastro -> 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.
serBemNúmero de série do patrimônio. Sim.Cadastro -> Patrimônio
Usu.DesTecDescriçã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.TagBemTAG 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.-