ERP Senior
A plataforma possui inúmeras integrações nativas e homologadas com o ERP Senior.
- Cadastro de Sistema Integrado no ERP Senior
- Integração de Produtos com o ERP Senior
- Integração de Requisição de Estoque com o ERP Senior
- Integração Cadastro de Solicitantes (Clientes) com o ERP Senior.
- Integração de Fornecedores com o ERP Senior
- Integração Cadastro de Patrimônios (Bens) com o ERP Senior.
- Integração Cadastro de Filiais com o ERP Senior.
- Integração de Serviços com o ERP Senior
- Integração Cadastro de Centro de Custos com o ERP Senior.
- Integração Obter Itens do Pedido com o ERP Senior.
- Integração Pedido por Transação com o ERP Senior.
- Integração Módulo Projetos ERP Senior
- Integração Pedido por Transação com SS Existente com o ERP Senior.
- Integração Cadastro de Solicitantes (Locais - CodLoc) com o ERP Senior.
- Especificações de Liberação de Servidores de projetos em PowerBI
Cadastro de Sistema Integrado no ERP Senior
Para que qualquer integração entre a plataforma e o ERP Senior seja ativada é necessário primeiro que o sistema integrado seja cadastrado no ERP Senior.
MÓDULO
Gestão Inteligente de Manutenção
PROCEDIMENTO CLIENTE
Para cadastrar o sistema integrado siga os passos abaixo:
-
Efetue login no ERP;
-
No menu principal clique “Cadastro”;
-
Clique em “Integrações”;
-
Clique em “Cadastro de Sistemas Integrados” (Código da Tela: F000SIS);
-
Tecle “F2”;
-
O ERP exibirá a busca de cadastros de sistemas integrados. Verifique se o sistema UPSIM já está cadastrado. Caso não exista nenhum sistema cadastrado o ERP exibirá a mensagem “Nenhum registro disponível para consulta”. Clique em “OK” e prossiga para o item 10;
-
Caso o sistema UPSIM esteja cadastrado, verifique se as informações estão corretas (Sigla: UPSIM, Tipo: 99 e Situação: A). Se as informações estiverem corretas não será necessário efetuar mais nenhuma operação;
-
Se as informações estiverem incorretas, clique duas vezes na linha do cadastro UPSIM. A tela de edição será exibida. Efetue as alterações necessárias e clique em alterar e prossiga para o item 10;
-
Caso o sistema UPSIM não esteja cadastrado, clique em cancelar e prossiga para o item 11;
-
No campo “Código” digite “0”;
-
Tecla “Tab”;
-
Insira a “Descrição” “UPSIM”;
-
Tecla “Tab”;
-
Insira a “Sigla” “UPSIM”;
-
Tecla “Tab”;
-
Insira “Tipo” “99”;
-
Tecla “Tab”;
-
Insira a “Situação” “A”;
-
Tecla “Tab”.
Tela de Cadastro de Sistemas Integrados no ERP Senior (Código da Tela: F000SIS)
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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
Integração de Produtos com o ERP Senior
Esta integração permite que os cadastros de produtos 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_cad_produtos?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
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração na Plataforma
-
Solicite a equipe de suporte da que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável Integração no ERP Senior;
-
Empresa cadastrada no ERP Senior;
-
Filial cadastrada no ERP Senior;
-
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 mesma.
PROCEDIMENTO EQUIPE SUPORTE
Ativar a Integração na Plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Produtos”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
- Insira em cada empresa o ID da filial utilizada para integração de produtos (Informado pelo cliente). Embora os produtos tenham chave de unicidade por empresa, o ERP necessita dos parâmetros de empresa e filial para fazer o consumo do WS. Portanto deve ser lançado no cadastro de cada empresa o ID da filial que será utilizada na integração;
-
Insira o EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_cad_produtos
-
Insira a EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_int_geral_exportacao
-
Insira o EndPoint da plataforma. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
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.
Usuário: O serviço é executado quando o usuário clica no botão
VALIDAÇÃO DE EXECUÇÃO DO SERVIÇO
Tipo de integração: 34
Vendor: 3
Status: 1
Parâmetro 1: CUSTO*
Parâmetro 2: APP**
* Quando o valor do "parâmetro 1" for igual a "CUSTO" o custo médio do produto no ERP será registrado no SISMETRO;
**Quando o valor do "parâmetro 2" for igual a "APP" todos os produtos serão marcados como disponíveis para utilização no APP.
IMPORTANTE! A integração apenas adiciona o produto no SISMETRO, não efetua atualização de nenhum campo.
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 + codPro + codDer
Chave de unicidade na plataforma: unit + codEmp + codPro + codDer
Comportamento do WS: Todos os produtos da empresa serão exportados.
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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
O WebService precisa estar visível para a web? |
Sim. O WebService necessita estar publicado e visível na na web. | - |
É possível liberar apenas os domínios dos servidores da plataforma para consumir o WebService? |
Sim. Se o firewall permitir a liberação por domínio o usuário deverá liberar os seguintes domínios: dev.sismetro.com br.sismetro.com |
- |
É possível liberar apenas os IP´s dos servidores da plataforma para consumir o WebService? |
Não. A plataforma é hospedada em servidores na AWS e não possuem IP fixo. Portanto não é possível liberar o consumo para IP´s específicos. | - |
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. | - |
É obrigatório implementar um where? |
Não, porém é altamente recomendado para evitar a exportação de cadastros desnecessários. | - |
Integração de Requisição de Estoque com o ERP Senior
Esta integração permite que a plataforma envie requisições de estoque (De produtos inseridos em SS Solicitações de Serviços) para o ERP Senior,
Identificador de tipo: 12
A plataforma envia apenas um produto por requisição por vez (Requisição individual).
Para enviar requisições ao ERP não é necessário efetuar nenhuma ativação. Porém para realizar consulta do andamento da aquisição é necessário.
MÓDULO
Gestão Inteligente de Manutenção
ESPECIFICAÇÕES TÉCNICAS
Sentido: Mão única ERP Senior -> UPSIM
Consulta: UPSIM consome WS para receber cadastros pendentes de sincronia
Chave de unicidade no ERP: Requisição por empresa
Chave de unicidade na plataforma: Requisição gera um ID único para a unidade
Comportamento do WS: A plataforma realiza requisições unitárias e consulta periodicamente o andamento do atendimento
Gatilhos de consulta: UPSIM consome o WS periodicamente (por tempo) ou quando solicitado via tela
Mecanismo: XML
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
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração no UPSIM
-
Solicite a equipe de suporte UPSIM que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável Integração no ERP Senior;
-
Empresa cadastrada no ERP Senior;
-
Filial cadastrada no ERP Senior;
- Código da transação de requisição de estoque no ERP Senior;
-
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 mesma.
PROCEDIMENTO EQUIPE SUPORTE
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Requisição de Estoque”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
-
Insira o usuário (informado pelo cliente);
-
Insira o password (informado pelo cliente);
-
Insira o código da empresa (informado pelo cliente);
-
Insira o código da filial (informado pelo cliente);
- Insira a key da unidade (cadastro da unidade);
- Insira o password (informado pelo cliente);
- Insira no campo "Parâmetro 1" o código da transação (informado pelo cliente). Quando o código não é informado a integração utiliza o código padrão 90250;
-
Insira o EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_est_requisicoes
- Insira o EndPoint UPSIM. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
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".
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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
O WebService precisa estar visível para a web? |
Sim. O WebService necessita estar publicado e visível na na web. | - |
É possível liberar apenas os domínios dos servidores da plataforma para consumir o WebService? |
Sim. Se o firewall permitir a liberação por domínio o usuário deverá liberar os seguintes domínios: dev.sismetro.com br.sismetro.com |
- |
É possível liberar apenas os IP´s dos servidores da plataforma para consumir o WebService? |
Não. A plataforma é hospedada em servidores na AWS e não possuem IP fixo. Portanto não é possível liberar o consumo para IP´s específicos. | - |
Ao excluir uma requisição no ERP a mesmo é replicada para a plataforma? |
Não. Quando uma requisição é "excluída" no ERP não é gerado sincronia para a plataforma. O usuário deverá "cancelar" para que a sincronia seja realizada. | - |
É possível realizar requisições agrupadas? |
Não. A plataforma realiza apenas requisições unitárias. | - |
Integração Cadastro de Solicitantes (Clientes) com o ERP Senior.
Esta integração permite que os cadastros de solicitantes (clientes) sejam replicados do ERP Senior para a plataforma.
Esta integração é aplicável apenas para empresas que utilizarão a plataforma para gerenciar a prestação de serviços para seus clientes.
MÓDULO
Gestão Inteligente de Manutenção.
ESPECIFICAÇÕES TÉCNICAS
Sentido: Mão única ERP Senior -> UPSIM
Consulta: Plataforma consome WebService para receber cadastros pendentes de sincronia
Mecanismo: XML
WSDL: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_cad_clientes?wsdl
Porta: Exportar_2
Documentação Senior: Clique aqui!
PROCEDIMENTO CLIENTE
Cadastro do sistema integrado
-
Cadastro do sistema integrado no ERP. Para mais informações. Clique aqui!
EXECUTAR OS PROCEDIMENTO ABAIXO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.
Configurações da integração no ERP
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração no UPSIM
-
Solicite a equipe de suporte UPSIM que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável pela integração no ERP Senior;
-
Listagem de empresas e filiais que serão integradas (Nome e ID ERP);
-
URL do 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 mesma.
-
PROCEDIMENTO EQUIPE SUPORTE
Cadastramento das empresas e filiais na plataforma
-
Acesse as configurações da unidade (Menu engrenagem);
-
Cadastre as empresas e filiais que serão integradas. Somente empresas e filiais com ID ERP serão integradas;
- Cliquem em "salvar".
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Cliente Heroku”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
- Insira a URL do cliente no campo EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint UPSIM. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
Clique em “Salvar”.
Observações
- Não é necessário inserir o EndPoint no final da URL;
- 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 DA INTEGRAÇÃO
Tipo da integração: 23
Vendor: 3
Status: 1
CHAVE DE UNICIDADE DE REGISTRO
Chave de unicidade no ERP: codCli
Chave de unicidade na plataforma: unit + codEmp + codFil + codCli
Comportamento do WebService: O cliente é único para todas as empresas e filiais no ERP. Para poder utilizar um cliente é necessário vincular (conectar) a empresa e filial. Apenas os clientes conectados a empresa e filial serão integrados.
Comportamento da plataforma: Todo cliente integrado gerará um solicitante dentro da filial sincronizada.
Exemplo: Se um cliente estiver vinculado em 10 filiais no ERP a plataforma irá gerar um solicitante embaixo de cada filial integrada.
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. |
Configurações -> Empresa. A integração será disparada para todas as empresas e filiais que possuírem idErp configurado. |
CodFil | ID ERP da Filial. |
Configurações -> Filial. A integração será disparada para todas as empresas e filiais que possuírem idErp configurado. |
TipoIntegracao |
Integrar total ou parcial. (T = Todos, A = Somente Alterados). |
Cadastro unidade -> Integrações.
|
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
codCli | ID ERP do solicitante. | Não. | Cadastro -> Solicitante. |
nomCli | Razão social do solicitante. | Sim. | Cadastro -> Solicitante. |
apeCli | Nome do solicitante. | Sim. | Cadastro -> Solicitante. |
cgcCpf |
CNPJ ou CPF. |
Sim. | Cadastro -> Solicitante. |
tipCli |
Tipo do solicitante. (Pessoa física ou jurídica). |
Sim. | Cadastro -> Solicitante. |
cepCli | CEP do solicitante. | Sim. | Cadastro -> Solicitante. |
endCli | Endereço do solicitante. | Sim. | Cadastro -> Solicitante. |
nenCli | Número do solicitante | Sim. | Cadastro -> Solicitante. |
baiCli | Bairro do solicitante. | Sim. | Cadastro -> Solicitante. |
cplEnd |
Complemento do endereço do solicitante. |
Sim. | Cadastro -> Solicitante. |
intNet | Email do cliente. | Sim. | Cadastro -> Solicitante. |
fonCI2 |
Fone do solicitante. |
Sim. | Cadastro -> Solicitante. |
zipCode |
Código IBGE do solicitante. |
Sim. | Cadastro -> Solicitante. |
cidCli |
Cidade do solicitante. |
Sim. | Cadastro -> Solicitante. |
sigUfs |
Estado do solicitante. |
Sim. | Cadastro -> Solicitante. |
DÚVIDAS
Dúvidas | 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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
O WebService precisa estar visível para a web? |
Não. O WebService deverá estar visível para os IP fixos da plataforma. Solicite a equipe de suporte a listagem de IP Fixo. | - |
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. | - |
Integração de Fornecedores com o ERP Senior
Esta integração permite que os cadastros de fornecedores 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_cad_fornecedor?wsdl
Porta: Exportar_2
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
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração na Plataforma
-
Solicite a equipe de suporte que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável Integração no ERP Senior;
-
Empresa cadastrada no ERP Senior;
-
Filial cadastrada no ERP Senior;
-
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 mesma.
PROCEDIMENTO EQUIPE SUPORTE
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Fornecedores”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
-
Insira o código da empresa (informado pelo cliente);
-
Insira o código da filial (informado pelo cliente);
-
Insira o EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_cad_fornecedor
-
Insira a EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_int_geral_exportacao
-
Insira o EndPoint da plataforma:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
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.
Usuário: O serviço é executado quando o usuário clica no botão
VALIDAÇÃO DE EXECUÇÃO DO SERVIÇO
Configuração da integração na unidade
Tipo de integração: 42
Vendor: 3
Status: 1
A chamada será realizada para o endpoint configurado no cadastro da integração.
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: codFor
Chave de unicidade na plataforma: unit + codFor
Comportamento do WS: Todos os fornecedores conectados a empresa serão exportados
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
O WebService precisa estar visível para a web? |
Sim. O WebService necessita estar publicado e visível na na web. | - |
É possível liberar apenas os domínios dos servidores da plataforma para consumir o WebService? |
Sim. Se o firewall permitir a liberação por domínio o usuário deverá liberar os seguintes domínios:
dev.sismetro.com br.sismetro.com |
- |
É possível liberar apenas os IP´s dos servidores da plataforma para consumir o WebService? |
Não. A plataforma é hospedada em servidores na AWS e não possuem IP fixo. Portanto não é possível liberar o consumo para IP´s específicos. | - |
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. | - |
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
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração na Plataforma
-
Solicite a equipe de suporte que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável Integração no ERP Senior;
-
Empresa cadastrada no ERP Senior;
-
Filial cadastrada no ERP Senior;
- Tipo de tecnologia padrão. Todo patrimônio que for integrado receberá este tipo de tecnologia;
- 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;
- 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
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Patrimônios ”;
-
Selecione o Vendor/ERP “Senior”;
- Insira o "Usuário" e "Password";
-
Insira a Sigla "UPSIM";
- 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);
- 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);
- Insira o EndPoint WebService. Exemplo:
https://web999.senior.com.br:3999
-
Insira a EndPoint Confirmação. Exemplo:
https://web999.senior.com.br:3999
-
Insira o EndPoint SISMETRO.
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”. Após a primeira sincronia o tipo deverá ser alterado para "Parcial";
-
Ative a opção “Registrar Logs”;
-
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ÂMETROS ADICIONAIS OBRIGATÓRIOS
- Definir o IDERP no cadastro da EMPRESA
- Definir o IDERP no cadastro da FILIAL
- Selecionar um "Solicitante padrão" no cadastro da FILIAL
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.
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. |
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.
|
Sim. | Cadastro -> Patrimônio |
Usu.TagBem |
TAG do patrimônio.
|
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. | - |
Integração Cadastro de Filiais com o ERP Senior.
Esta integração permite que os cadastros de filiais 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
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
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração na Plataforma
-
Solicite a equipe de suporte que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável Integração no ERP Senior;
-
Empresa cadastrada no ERP Senior;
-
Filial cadastrada no ERP Senior;
- Tipo de tecnologia padrão. Todo patrimônio que for integrado receberá este tipo de tecnologia;
- 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;
- 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
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Produtos”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
-
Insira o código da empresa (informado pelo cliente);
-
Insira o código da filial (informado pelo cliente);
- 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);
- 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);
- Insira o EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint SISMETRO.
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”. Após a primeira sincronia o tipo deverá ser alterado para "Parcial";
-
Ative a opção “Registrar Logs”;
-
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
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 | Observação. | Sim. | Cadastro -> Patrimônio. |
Bens.DatAqi | Data da compra. | Sim. | Cadastro -> Patrimônio. |
Bens.FilLoc |
Filial e solicitante.
O patrimônio será vinculado ao solicitante padrão selecionado nas configurações da filial retornada neste parâmetro. Caso o atributo retorne vazio, o patrimônio será atribuído ao solicitante padrão da filial enviada na requisição (CodFil). |
Sim. Apenas quando houver alteração de filial. | Cadastro -> Patrimônio. |
Bens.FilAqi |
Filial e solicitante.
O patrimônio será atribuído ao solicitante (proprietário) padrão selecionado nas configurações da filial retornada neste parâmetro. |
Sim. Apenas quando houver alteração de filial. | 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. |
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. | - |
O WebService precisa estar visível para a web? |
Sim. O WebService necessita estar publicado e visível na na web. | - |
É possível liberar apenas os domínios dos servidores da plataforma para consumir o WebService? |
Sim. Se o firewall permitir a liberação por domínio o usuário deverá liberar os seguintes domínios:
dev.sismetro.com br.sismetro.com |
- |
É possível liberar apenas os IP´s dos servidores da plataforma para consumir o WebService? |
Não. A plataforma é hospedada em servidores na AWS e não possuem IP fixo. Portanto não é possível liberar o consumo para IP´s específicos. | - |
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. | - |
Integração de Serviços com o ERP Senior
Esta integração permite que os cadastros de serviços 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_cad_servicos?wsdl
Porta: Exportar
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
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração na Plataforma
-
Solicite a equipe de suporte da que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável Integração no ERP Senior;
-
Empresa cadastrada no ERP Senior;
-
Filial cadastrada no ERP Senior;
-
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 mesma.
PROCEDIMENTO EQUIPE SUPORTE
Ativar a Integração na Plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Serviços”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
-
Insira o código da empresa (informado pelo cliente);
-
Insira o código da filial (informado pelo cliente);
-
Insira o EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint da plataforma. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
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
Tipo de integração: 24
Vendor: 3
Status: 1
A chamada será realizada para o endpoint configurado no cadastro da integração.
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 + codSer
Chave de unicidade na plataforma: unit + codEmp + codSer
Comportamento do WS: Todos os serviços da empresa serão exportados
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
codSer | ID no ERP. | Sim. | Cadastro -> Patrimônio. |
desSer | Nome do Serviço | Sim. | Cadastro -> Patrimônio. |
obsSer | Observações. | Sim. | Cadastro -> Patrimônio. |
Categoria.
Será atribuído ao serviço o ID da categoria configurada no "Parâmetro 1" da integração de serviços no cadastro da unidade. |
Sim. | Cadastro -> Patrimônio. | |
Ocupação/Função.
Será atribuído ao serviço o ID da ocupação/função configurada no "Parâmetro 2" da integração de serviços no cadastro da unidade. |
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. | - |
É 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. | - |
É obrigatório implementar um where? |
Não, porém é altamente recomendado para evitar a exportação de cadastros desnecessários. | - |
Integração Cadastro de Centro de Custos com o ERP Senior.
Esta integração permite que os cadastros de centro de custos 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 -> UPSIM
Consulta: Plataforma consome WebService para receber cadastros pendentes de sincronia
Mecanismo: XML
WSDL: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_ger_cad_centrocusto?wsdl
Porta: Exportar_2
Documentação Senior: Clique aqui!
PROCEDIMENTO CLIENTE
Cadastro do sistema integrado
-
Cadastro do sistema integrado no ERP. Para mais informações. Clique aqui!
EXECUTAR O PROCEDIMENTO ABAIXO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.
Configurações da integração no ERP
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação do Web Service no ERP
Tela de configuração de Web Service (Código da Tela: F000CWS) no ERP Senior
Ativação da Integração no UPSIM
-
Solicite a equipe de suporte UPSIM que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável pela integração no ERP Senior;
-
Listagem de empresas e filiais que serão integradas (Nome e ID ERP);
-
URL do 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 mesma.
-
PROCEDIMENTO EQUIPE SUPORTE
Cadastramento das empresas e filiais na plataforma
-
Acesse as configurações da unidade (Menu engrenagem);
-
Cadastre as empresas e filiais que serão integradas. Somente empresas e filiais com ID ERP serão integradas;
- Cliquem em "salvar".
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Centro Custo”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
- Insira a URL do cliente no campo EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint UPSIM. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
Clique em “Salvar”.
Observações
- Não é necessário inserir o EndPoint no final da URL;
- 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 DA INTEGRAÇÃO
Tipo da integração: 25
Vendor: 3
Status: 1
CHAVE DE UNICIDADE DE REGISTRO
Chave de unicidade no ERP: codCcu
Chave de unicidade na plataforma: unit + codCcu
Chave de unicidade de conexão com empresa no ERP: codCcu + codEmp
Chave de unicidade de conexão de centro custo com empresa na plataforma: unit + codEmp + codCcu
Comportamento do WebService: O centro de custo é único para todas as empresas e filiais no ERP. Para poder utilizar um centro de custo é necessário vincular (conectar) a empresa. Apenas os centro de custos conectados a empresa serão integrados. Se um mesmo centro de custo estiver conectado em várias empresas o mesmo será exportado em todas elas.
Comportamento da plataforma: O centro de custo (codCcu) é cadastrado na tabela de centros de custo e vinculado a empresa correspondente.
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. |
Configurações -> Empresa. A integração será disparada para todas as empresas e filiais que possuírem idErp configurado. |
CodFil | ID ERP da Filial. |
Configurações -> Filial. A integração será disparada para a primeira filial que possuir idErp configurado. O parâmetro é obrigatório na requisição, porém não é aplicado como filtro. |
TipoIntegracao |
Integrar total ou parcial. (T = Todos, A = Somente Alterados). |
Cadastro unidade -> Integrações. |
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
centrosCusto.codCcu | ID ERP do centro de custo. | Não. | Cadastro -> Centro do Custo. |
centrosCusto.abrCcu |
Nome do centro de custo. Concatenar separado por traço centrosCusto.abrCcu - centrosCusto.desCcu |
Sim. | Cadastro -> Centro do Custo. |
centrosCusto.desCcu |
Nome do centro de custo. Concatenar separado por traço centrosCusto.abrCcu - centrosCusto.desCcu |
Sim. | Cadastro -> Centro do Custo. |
centrosCusto.anaSin |
Tipo do centro de custo.
|
Sim. | Cadastro -> Centro de Custo. |
centrosCusto.ccuPai |
Centro de custo pai. |
Sim. | Cadastro -> Centro de custo. |
- |
Filial. Filial enviada no parâmetro CodFil da requisição* Registro realizado em tabela de relacionamento centro de custo com filial. |
Sim. | Cadastro -> Centro de custo. |
DÚVIDAS
- As integrações Totais agendadas (que definimos pela configuração da integração manualmente) iniciam às 03h01, 11h01 e 19h01 todos os dias para este tipo de integração;
- As integrações de Alterações são iniciadas a cada 30 minutos, ou seja, elas são chamadas para execução a cada 30 minutos o que seguem até o fim da integração e param.
- Nas madrugadas de Domingo, Terça e Sexta, todas as integrações ativas desse tipo, exceto as que estão com "IgnoraTotal" no Parâmetro 4, são colocadas para rodar em Total e rodam uma integração total, inciando às 04h10 da manhã.
Cadastro de empresa deve possuir o ID SISMETRO da Filial Padrão no campo "ID Filial padrão para integração de Centro de Custo".
Este campo é apenas usado para a requisição, não sendo usado para armazenar no SISMETRO.
Dúvidas | 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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
O WebService precisa estar visível para a web? |
Não. O WebService deverá estar visível para os IP fixos da plataforma. Solicite a equipe de suporte a listagem de IP Fixo. | - |
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. | - |
Integração Obter Itens do Pedido com o ERP Senior.
Esta integração permite que os itens dos pedidos 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 -> UPSIM
Consulta: Plataforma consome WebService para obter os itens dos pedidos.
Mecanismo: XML
WSDL: https://web03.senior.com.br:39301/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_pedidos?wsdl
Porta: OberItensPedido_2
Documentação Senior: Clique aqui!
PROCEDIMENTO CLIENTE
Cadastro do sistema integrado
-
Cadastro do sistema integrado no ERP. Para mais informações. Clique aqui!
EXECUTAR OS PROCEDIMENTO ABAIXO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.
Configurações da integração no ERP
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação da Integração no UPSIM
-
Solicite a equipe de suporte UPSIM que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável pela integração no ERP Senior;
-
Listagem de empresas e filiais que serão integradas (Nome e ID ERP);
-
URL do 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 mesma.
-
PROCEDIMENTO EQUIPE SUPORTE
Cadastramento das empresas e filiais na plataforma
-
Acesse as configurações da unidade (Menu engrenagem);
-
Cadastre as empresas e filiais que serão integradas. Somente empresas e filiais com ID ERP serão integradas;
- Cliquem em "salvar".
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Pedidos Obter Itens”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
- Insira a URL do cliente no campo EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint UPSIM. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
Clique em “Salvar”.
Observações
- Não é necessário inserir o EndPoint no final da URL;
- 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 5 (Cinco) minutos.
VALIDAÇÃO DE EXECUÇÃO DA INTEGRAÇÃO
Tipo da integração: 26
Vendor: 3
Status: 1
CHAVE DE UNICIDADE DE REGISTRO
Chave de unicidade no ERP: codEmp + codFil + numeroPedido
Chave de unicidade na plataforma: unit + codEmp + codFil + numeroPedido
Comportamento do WebService: O pedido é único por empresa e filial. O WS exporta todos os itens do pedido requisitado.
Comportamento da plataforma: O integrador consulta no WS todos os pedidos identificados como pendentes de sincronia na plataforma. A pendência é gerada na abertura da SS e também via integração de consulta de pedidos alterados. Todos os itens do pedido são atualizados (Subescritos) independe de número sequencial.
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 da SS. |
Configurações -> Empresa. |
CodFil | ID ERP da Filial da SS. |
Configurações -> Filial. |
numeroPedido | ID ERP do pedido associado a SS. |
SS -> Pedidos. |
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
sequenciaItem | Item do pedido. | Sim. | SS -> Pedidos. |
codigoProdutoServico |
ID ERP do produto ou serviço.
Quando produto ou serviço é encontrado na plataforma o ID SISMETRO também é registrado. |
Sim. | SS -> Pedidos. |
DescricaoProdutoServico | Descrição do produto ou serviço. | Sim. | SS -> Pedidos. |
DescricaoDerivacao | Concatenado com a descrição do produto (Separado por traço). | Sim. | SS -> Pedidos. |
precoUnitario | Preço unitário. | Sim. | SS -> Pedidos. |
quantidadePedida | Quantidade. | Sim. | SS -> Pedidos. |
unidadeMedida | Unidade. | Sim. | SS -> Pedidos. |
dataEntrega | Previsão. | Sim. | SS -> Pedidos. |
complemento | Complemento. | Sim. | SS -> Pedidos. |
DÚVIDAS
Dúvidas | 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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
O WebService precisa estar visível para a web? |
Não. O WebService deverá estar visível para os IP fixos da plataforma. Para consultar a listagem clique aqui!. | - |
Integração Pedido por Transação com o ERP Senior.
Esta integração permite que os pedidos no ERP Senior que possuem determinada transação (produto e/ou serviço) efetuem a abertura automática de SS na plataforma SISMETRO. Cada pedido integrado gera uma SS nova contendo o pedido.
MÓDULO
Gestão Inteligente de Manutenção.
ESPECIFICAÇÕES TÉCNICAS
Sentido: Mão única ERP Senior -> SISMETRO
Consulta: Plataforma consome WebService para obter os itens dos pedidos.
Mecanismo: XML
WSDL: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_pedidos?wsdl
Porta: ExportarPedido_4
Documentação Senior: Clique aqui!
PROCEDIMENTO CLIENTE
Cadastro do sistema integrado
-
Cadastro do sistema integrado no ERP. Para mais informações. Clique aqui!
EXECUTAR OS PROCEDIMENTO ABAIXO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.
Configurações da integração no ERP
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação da Integração no UPSIM
-
Solicite a equipe de suporte UPSIM que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável pela integração no ERP Senior;
-
Listagem de empresas e filiais que serão integradas (Nome e ID ERP);
- Código da transação de produto (ID ERP) que deverá abrir SS no SISMETRO. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- Código da transação de serviço (ID ERP) que deverá abrir SS no SISMETRO. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- ID do tipo da SS que deverá ser aberta no SISMETRO*;
- ID da categoria de SS que deverá ser aberta no SISMETRO*;
- ID do tipo de atendimento da SS que deverá ser aberta no SISMETRO*;
-
URL do 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 mesma.
* Para localizar o ID do item desejado acesse "Configurações" (Ícone Engrenagem) e clique em "Parâmetros da SS";
-
PROCEDIMENTO EQUIPE SUPORTE
Cadastramento das empresas e filiais na plataforma
-
Acesse as configurações da unidade (Menu engrenagem);
-
Cadastre as empresas e filiais que serão integradas. Somente empresas e filiais com ID ERP serão integradas;
- Cliquem em "salvar".
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Pedidos Obter Itens”;
-
Selecione o Vendor/ERP “Senior”;
- Insira o "Usuário" e "Password";
-
Insira a Sigla "UPSIM";
- Insira no "parâmetro 1" o ID da transação de produto que abrirá SS. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- Insira no "parâmetro 2" o ID da transação de serviço que abrirá SS. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- Insira no "parâmetro 3" o ID do tipo da SS que será aberta;
- Insira no "parâmetro 4" o ID da categoria que será aberta;
- Insira no "parâmetro 5" o ID do tipo de atendimento;
- Insira a URL do cliente no campo EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint UPSIM. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
Clique em “Salvar”.
Observações
- Não é necessário inserir o EndPoint no final da URL;
- 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 5 (Cinco) minutos.
VALIDAÇÃO DE EXECUÇÃO DA INTEGRAÇÃO
Tipo da integração: 29
Vendor: 3
Status: 1
CHAVE DE UNICIDADE DE REGISTRO
Chave de unicidade no ERP: codEmp + codFil + numPedido
Chave de unicidade na plataforma: unit + codEmp + codFil + numPedido
Comportamento do WebService: O pedido é único por empresa e filial. O WS exporta todos os itens do pedido requisitado.
Comportamento da plataforma: O integrador consulta no WS todos os pedidos e abre uma SS para os pedidos que possuírem transação de produto e/ou serviço configuradas na integração (Parâmetro 1 e Parâmetro 2).
Na consulta de pedidos alterados a plataforma consulta todos os pedidos e registra as alterações dos pedidos que estão na plataforma (Pedidos que não estão na plataforma são desprezados).
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. |
Configurações -> Empresa. |
CodFil | ID ERP da Filial. |
Configurações -> Filial. |
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
dadosGerais.numPed | Número do Pedido. | Sim. | SS -> Pedidos. |
dadosGerais.tipPed | Tipo do pedido. | Sim. | SS -> Pedidos. |
dadosGerais.tnsPro | Transação de produto. | Sim. | SS -> Pedidos. |
dadosGerais.tnsSer | Transação de serviço. | Sim. | SS -> Pedidos. |
dadosGerais.datEmi | Data de emissão. | Sim. | SS -> Pedidos. |
dadosGerais.codCli | Cliente. A SS é aberta para o cliente do pedido de acordo com os parâmetros configurados nos parâmetros da integração. |
Sim. | SS -> Inclusão |
dadosGerais.obsPed | Observações do pedido. | Sim. | SS -> Pedidos. |
sequenciaItem | Item do pedido. | Sim. | SS -> Pedidos. |
codigoProdutoServico |
ID ERP do produto ou serviço.
Quando produto ou serviço é encontrado na plataforma o ID SISMETRO também é registrado. |
Sim. | SS -> Pedidos. |
DescricaoProdutoServico | Descrição do produto ou serviço. | Sim. | SS -> Pedidos. |
DescricaoDerivacao | Concatenado com a descrição do produto (Separado por traço). | Sim. | SS -> Pedidos. |
precoUnitario | Preço unitário. | Sim. | SS -> Pedidos. |
quantidadePedida | Quantidade. | Sim. | SS -> Pedidos. |
unidadeMedida | Unidade. | Sim. | SS -> Pedidos. |
dataEntrega | Previsão. | Sim. | SS -> Pedidos. |
complemento | Complemento. | Sim. | SS -> Pedidos. |
DÚVIDAS
Dúvidas | 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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
Integração Módulo Projetos ERP Senior
Esta integração permite que a plataforma SISMETRO interaja com o módulo de projetos do ERP Senior.
MÓDULO
Gestão Inteligente de Manutenção.
INTEGRAÇÃO DE ABERTURA DE SS
O usuário do módulo de projeto poderá disparar uma SS para a plataforma para que seja efetuado um serviço em uma determinado projeto, fase e atividade (Opcional).
A abertura será disparada via WebService SISMETRO em formato JSON. Para mais informações Clique aqui!
Obs.: Será necessário adicionar os parâmetros "projeto", "fase" e "atividade" no WebService SISMETRO.
O módulo deverá registrar o ID da SS e a URL aberta da SS permitindo a consulta da mesma em tela.
INTEGRAÇÃO DE CONSULTA DE SS
O módulo de projetos possuíra um processo agendado que roda periodicamente (periodicidade a definir) para consultar as SS´s de projetos atualizadas. Será disponibilizado botão em tela para que o usuário efetue a sincronia em tempo real.
Obs.: Será necessário criar chamada (URL) de consulta de SS´s de projetos alteradas.
Integração Pedido por Transação com SS Existente com o ERP Senior.
Esta integração permite que os pedidos no ERP Senior que possuem determinada transação (produto e/ou serviço) e que estão vinculados a uma SS (no ERP) sejam integrados na plataforma SISMETRO. Cada pedido integrado será vinculado a SS correspondente.
MÓDULO
Gestão Inteligente de Manutenção.
ESPECIFICAÇÕES TÉCNICAS
Sentido: Mão única ERP Senior -> SISMETRO
Consulta: Plataforma consome WebService para obter os itens dos pedidos.
Mecanismo: XML
WSDL: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mcm_ven_pedidos?wsdl
Porta: ExportarPedidos
Documentação Senior: Clique aqui!
PROCEDIMENTO CLIENTE
Cadastro do sistema integrado
-
Cadastro do sistema integrado no ERP. Para mais informações. Clique aqui!
EXECUTAR OS PROCEDIMENTO ABAIXO EM TODAS AS FILIAS QUE SERÃO INTEGRADAS.
Configurações da integração no ERP
Tela de configurações de tipos de informações (Código da Tela: F000SXT) no ERP Senior
Ativação da Integração no UPSIM
-
Solicite a equipe de suporte UPSIM que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável pela integração no ERP Senior;
-
Listagem de empresas e filiais que serão integradas (Nome e ID ERP);
- Código da transação de produto (ID ERP) que deverá abrir SS no SISMETRO. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- Código da transação de serviço (ID ERP) que deverá abrir SS no SISMETRO. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- Nome do campo de usuário retornado no atributo "dadosGerais.usuario.cmpUsu" que corresponde ao ID da SS retornado no campo "dadosGerais.usuario.vlrUsu";
-
URL do 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 mesma.
-
PROCEDIMENTO EQUIPE SUPORTE
Cadastramento das empresas e filiais na plataforma
-
Acesse as configurações da unidade (Menu engrenagem);
-
Cadastre as empresas e filiais que serão integradas. Somente empresas e filiais com ID ERP serão integradas;
- Cliquem em "salvar".
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Pedidos Obter Itens”;
-
Selecione o Vendor/ERP “Senior”;
- Insira o "Usuário" e "Password";
-
Insira a Sigla "UPSIM";
- Insira no "parâmetro 1" o ID da transação de produto que abrirá SS. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- Insira no "parâmetro 2" o ID da transação de serviço que abrirá SS. TODOS OS PEDIDOS COM ESSA TRANSAÇÃO GERARÃO SS NO SISMETRO;
- Insira no "parâmetro 3" o nome do campo de usuário retornado no atributo "dadosGerais.usuario.cmpUsu" que corresponde ao ID da SS retornado no campo "dadosGerais.usuario.vlrUsu";
- Insira a URL do cliente no campo EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint UPSIM. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
Clique em “Salvar”.
Observações
- Não é necessário inserir o EndPoint no final da URL;
- 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 5 (Cinco) minutos.
VALIDAÇÃO DE EXECUÇÃO DA INTEGRAÇÃO
Tipo da integração: 31
Vendor: 3
Status: 1
CHAVE DE UNICIDADE DE REGISTRO
Chave de unicidade no ERP: ID da SS retornando no campo de usuário.
Chave de unicidade na plataforma: ID da SS.
Comportamento do WebService: O pedido é único por empresa e filial. O WS exporta todos os itens do pedido requisitado.
Comportamento da plataforma: O integrador consulta no WS todos os pedidos e vincula os pedidos que possuem uma SS registrada no campo de usuário correspondente (Parâmetro 3) e que pertencem a transação de produto e/ou serviço configuradas na integração (Parâmetro 1 e Parâmetro 2).
Na consulta de pedidos alterados a plataforma consulta todos os pedidos e registra as alterações dos pedidos que estão na plataforma (Pedidos que não estão na plataforma são desprezados).
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. |
Configurações -> Empresa. |
CodFil | ID ERP da Filial. |
Configurações -> Filial. |
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
dadosGerais.numPed | Número do Pedido. | Sim. | SS -> Pedidos. |
dadosGerais.tipPed | Tipo do pedido. | Sim. | SS -> Pedidos. |
dadosGerais.tnsPro | Transação de produto. | Sim. | SS -> Pedidos. |
dadosGerais.tnsSer | Transação de serviço. | Sim. | SS -> Pedidos. |
dadosGerais.datEmi | Data de emissão. | Sim. | SS -> Pedidos. |
dadosGerais.codCli | Cliente. A SS é aberta para o cliente do pedido de acordo com os parâmetros configurados nos parâmetros da integração. |
Sim. | SS -> Inclusão |
dadosGerais.obsPed | Observações do pedido. | Sim. | SS -> Pedidos. |
sequenciaItem | Item do pedido. | Sim. | SS -> Pedidos. |
codigoProdutoServico |
ID ERP do produto ou serviço.
Quando produto ou serviço é encontrado na plataforma o ID SISMETRO também é registrado. |
Sim. | SS -> Pedidos. |
DescricaoProdutoServico | Descrição do produto ou serviço. | Sim. | SS -> Pedidos. |
DescricaoDerivacao | Concatenado com a descrição do produto (Separado por traço). | Sim. | SS -> Pedidos. |
precoUnitario | Preço unitário. | Sim. | SS -> Pedidos. |
quantidadePedida | Quantidade. | Sim. | SS -> Pedidos. |
unidadeMedida | Unidade. | Sim. | SS -> Pedidos. |
dataEntrega | Previsão. | Sim. | SS -> Pedidos. |
complemento | Complemento. | Sim. | SS -> Pedidos. |
DÚVIDAS
Dúvidas | 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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
Integração Cadastro de Solicitantes (Locais - CodLoc) com o ERP Senior.
Esta integração permite que os cadastros de locais (codLoc) sejam replicados do ERP Senior para a plataforma. Esta integração é aplicável apenas para empresas que utilizarão a plataforma para gerenciar as manutenções internas.
MÓDULO
Gestão Inteligente de Manutenção.
ESPECIFICAÇÕES TÉCNICAS
Sentido: Mão única ERP Senior -> UPSIM
Consulta: Plataforma consome WebService para receber cadastros pendentes de sincronia
Mecanismo: XML
WSDL: http://example.com/g5-senior-services/sapiens_Synccom_senior_g5_co_mct_pat_localizacaobem?wsdl
Porta: Exportar
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
Ativação da Integração no UPSIM
-
Solicite a equipe de suporte UPSIM que ative a integração;
-
Informe os seguintes os dados abaixo;
-
Sigla do sistema no ERP Senior (deverá ser a mesma sigla cadastrada dentro do cadastro de sistemas integrados no ERP Senior);
-
Usuário responsável Integração no ERP Senior;
-
Password do usuário responsável pela integração no ERP Senior;
-
Listagem de empresas e filiais que serão integradas (Nome e ID ERP);
-
URL do 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 mesma.
-
PROCEDIMENTO EQUIPE SUPORTE
Cadastramento das empresas e filiais na plataforma
-
Acesse as configurações da unidade (Menu engrenagem);
-
Cadastre as empresas e filiais que serão integradas. Somente empresas e filiais com ID ERP serão integradas;
- Cliquem em "salvar".
Ativar a integração na plataforma
-
Acesse o cadastro da unidade do cliente;
-
Clique em “Integrações”;
-
Clique em “Adicionar”;
-
Selecione o tipo de integração “Solicitantes - Setor”;
-
Selecione o Vendor/ERP “Senior”;
-
Insira a Sigla "UPSIM";
- Insira a URL do cliente no campo EndPoint WebService. Exemplo:
https://web03.senior.com.br:39301
-
Insira a URL do cliente no campo EndPoint Confirmação. Exemplo:
https://web03.senior.com.br:39301
-
Insira o EndPoint UPSIM. Exemplo:
http://dev.sismetro.com:5000
-
Insira as observações da integração;
-
Selecione o tipo da integração: “Total”;
-
Ative a opção “Registrar Logs”;
-
Clique em “Salvar”.
Observações
- Não é necessário inserir o EndPoint no final da URL;
- 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 DA INTEGRAÇÃO
Tipo da integração: 38
Vendor: 3
Status: 1
CHAVE DE UNICIDADE DE REGISTRO
Chave de unicidade no ERP: codEmp + codFil + codLoc
Chave de unicidade na plataforma: unit + codEmp + codFil + codLoc
Comportamento do WebService: O cliente é único para todas as empresas e filiais no ERP. Para poder utilizar um cliente é necessário vincular (conectar) a empresa e filial. Apenas os clientes conectados a empresa e filial serão integrados.
Comportamento da plataforma: Todo cliente integrado gerará um solicitante dentro da filial sincronizada.
Exemplo: Se um cliente estiver vinculado em 10 filiais no ERP a plataforma irá gerar um solicitante embaixo de cada filial integrada.
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. A integração deverá ser rodada para todas as empresas configuradas no SISMETRO. |
Configurações -> Empresa. A integração será disparada para todas as empresas e filiais que possuírem idErp configurado. |
TipoIntegracao |
Integrar total ou parcial. (T = Todos, A = Somente Alterados). |
Cadastro unidade -> Integrações.
|
ATRIBUTOS DE RESPOSTA REGISTRADOS
Parâmetro de Resposta | Campo | Atualização Cadastral | Tela |
codFil |
ID ERP da filial. Quando for codFil = 0 deverá ser registrado um codFil para cada filial. |
Não. | Cadastro -> Solicitante. |
codLoc | ID ERP do solicitante. | Não. | Cadastro -> Solicitante. |
nomLoc | Razão social do solicitante. | Sim. | Cadastro -> Solicitante. |
desLoc | Mais informações. | Sim. | Cadastro -> Solicitante. |
- |
CNPJ.* |
Sim. | Cadastro -> Solicitante. |
- |
Tipo do solicitante (Pessoa física, jurídica ou setor). |
Sim. | Cadastro -> Solicitante. |
- | CEP do solicitante.* | Sim. | Cadastro -> Solicitante. |
- | Endereço do solicitante.* | Sim. | Cadastro -> Solicitante. |
- | CEP do solicitante.* | Sim. | Cadastro -> Solicitante. |
- | Endereço do solicitante.* | Sim. | Cadastro -> Solicitante. |
- | Número do solicitante.* | Sim. | Cadastro -> Solicitante. |
- | Bairro do solicitante.* | Sim. | Cadastro -> Solicitante. |
- |
Complemento do endereço do solicitante.* |
Sim. | Cadastro -> Solicitante. |
- | Email do solicitante.* | Sim. | Cadastro -> Solicitante. |
- |
Fone do solicitante.* |
Sim. | Cadastro -> Solicitante. |
- |
Código IBGE do solicitante.* |
Sim. | Cadastro -> Solicitante. |
- |
Cidade do solicitante.* |
Sim. | Cadastro -> Solicitante. |
- |
Estado do solicitante.* |
Sim. | Cadastro -> Solicitante. |
* Capturar os dados do cadastro da filial do solicitante.
DÚVIDAS
Dúvidas | 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. | - |
É necessário reiniciar o servidor após efetuar o procedimento? |
Não. | - |
O WebService precisa estar visível para a web? |
Não. O WebService deverá estar visível para os IP fixos da plataforma. Solicite a equipe de suporte a listagem de IP Fixo. | - |
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. | - |
Especificações de Liberação de Servidores de projetos em PowerBI
Para maior segurança das integrações entre a plataforma e projetos em PowerBI nossa política de parceira prevê que a liberação de acesso aos servidores seja pontual e restrita mantendo desta forma os web services invisíveis para a web. Segue abaixo o IP fixos da SISMETRO que deverão ser liberados no firewall:
. 18.229.2.58