Pular para o conteúdo principal

Configuração Systemsat / SSX

O objetivo desta documentação é orientar sobre as configurações necessárias para o funcionamento correto com a plataforma Systemsat.

Estas configurações não se aplicam para outras plataformas.

Preparação​

Antes da primeira integração com a plataforma na SystemSat tem alguns detalhes importantes a serem cadastrados. Inicialmente, no cadastro da plataforma, é necessário inserir o usuário e senha de um usuário da plataforma que possui acesso aos cadastros de cliente, equipamento, veiculo, entre outros.

Passo a passo​

  1. Cadastrar a plataforma no cadastro de plataforma - menu > cadastros > plataforma. Preencher, nome, usuário, senha, tipo: Systemsat;
  2. Cadastrar o template no SSX (se não tiver);
  3. Cadastrar a categoria de cliente no Rodar Gestão (mesmo nome do template np SSX) - menu > cadastros > categoria;
  4. Cadastrar o template de rastreador no SSX (se não tiver);
  5. Cadastrar o modelo de rastreador no Rodar Gestão com o mesmo nome de template cadastrado no SSX;
observação

O Rodar Gestão utiliza o nome cadastrado nos campos código de integração dentro do SSX.

Clientes​

O cadastro dos clientes dentro do Rodar Gestão devem estar associados as categorias que vinculam aos templates do SSX.

Modelos de Equipamento​

Os modelos de equipamentos utilizados devem mapear aos nomes dos modelos criados dentro do SSX.

Template de cliente​

Inicialmente na plataforma SystemSat, é necessário inserir os templates de clientes, preenchendo tanto o nome como o código de integração.

Preencher "NOME" e "Cód. de Integração".

No Rodar Gestão​

No rodar gestão você deve criar uma categoria com o mesmo nome do template criado na Systemsat.

observação

Ex: se o código de integração estiver FAMILY, o nome da categoria deverá ser "Template-FAMILY".

Você deve associar a categoria no cadastro do cliente dentro do GESTÃO. Desta forma, o sistema irá associar o cliente ao template correto dentro da Systemsat.

Cliente Master​

Caso o cliente tenha o campo Master preenchido (como o caso anterior), existe um processo adicional que é necessário ser feito.

Dentro da SystemSat, é necessário inserir um registro de Tipo Unidade Organizacional.

observação

Nome "MASTER".

Dentro do ERP, no cadastro do Cliente Fornecedor que é Master do cliente, é necessário adicionar uma categoria que possui o nome cadastrado na SystemSat com o seguinte formato: "TemplateTipoUnidadeOrganizacional-MASTER"

Template de Rastreador​

Também é necessário inserir na plataforma SystemSat os templates de rastreador, preenchendo tanto o nome como o código de integração.

No Rodar Gestão incluir no modelo do equipamento o modelo equivalente associando à plataforma, informando na descrição do equipamento da plataforma a mesma nomenclatura utilizada no código integração configurado na Systemsat.

observação

Informação importante: caso necessite que o Master do seu cliente tenha acesso aos veiculos cadastrados dentro da SystemSat, é necessário entrar em contato com o suporte do Gestão para ativar uma configuração onde o Master será cadastrado como Cliente na SystemSat e o cliente abaixo do master será cadastrado como Unidade Organizacional desse Cliente dentro da SystemSat.

Recomendações​

Na integração, existem algumas informações obrigatórias e certos detalhes dessas informações.

Abaixo este listado essas informaçes:

  • Clientes: Nome, CPF/CNPJ, Template (adicionado como categoria), email;
  • Veículos: Placa;
  • Equipamentos: Número e modelo de equipamento;
  • Chip: APN, Número (deve conter DDD e número de telefone), ICC;

Ao realizar o primeiro teste de integração, criar cliente e veiculo fictício (inclusive o cpf/cnpj deve ser um gerado no site 4devs).

Erros comuns​

  • "Erro SystemSat: Tracker does not exist" - Verifique se a APN e o número de telefone do chip (com apenas DDD e número) estão preenchidos corretamente;
  • "Erro SystemSat: The property login is required" - Verifique se o email do cliente em questão está preenchido corretamente;
  • "Erro SystemSat: A propriedade ClienteTemplateIntegrationCode é obrigatória" - Verifique se foi adicionada a categoria no cliente com o template cadastrado na SystemSat;
  • "Erro SystemSat: A propriedade TypeOrganizationalUnit é obrigatória" - Verifique se foi adi- cionada a categoria no master do cliente com o template cadastrado na SystemSat;
  • "Erro SystemSat: ICCD1 does not exist" - Verifique se a APN e o número de telefone do chip (com apenas DDD e número) estão preenchidos corretamente;
  • "Erro SystemSat: That IdTracker is already used" - Verifique se o equipamento não está vinculado a outro equipamento;