Integração de Abertura de Solicitações de Serviço - Envio.
Esta integração permite que outros sistemas (CRM, ERP, Sistemas Especialistas e etc) efetuem a abertura de Solicitações de Serviços na plataforma. Não é possível abrir Solicitações de Serviços com data retroativa.
MÓDULO
Gestão Inteligente de Manutenção.
REQUEST HEADERS
Formato: JSON
Tecnologia: REST
Método: POST
Content-Type: application/json
HEADERS
unit:
key:
Os dados de autenticação são fornecidos pela equipe de suporte SISMETRO.
ABERTURA POR ID PATRIMÔNIO NO SISMETRO
Está opção deverá ser utilizada para abrir SS na plataforma. Deve ser enviado um registro por vez.
URL: https://post.api.sismetro.com/SS/save/
Nomenclatura: CamelCase
Variáveis: Case Sensitive
{
"idErpEmpresa": "1",
"idErpFilial": "1",
"idErpSolicitante": "655",
"idPatrimonio": 2,
"objeto": "BOMBA DE PRESSAO",
"categoria": 11,
"gravidade": 1,
"urgencia": 1,
"tendencia": 1,
"idOrigem": "21546",
"descricao": "EQUIPAMENTO COM VAZANDO OLEO"
"tipo": 5,
"atendimento": 20,
"dataChamado": "2019-09-04T16:00:04Z",
"ssExterna": "87994",
"evolucao": 4,
"idErpCentroCusto": "5454",
"servicosRealizar": "SUBSTITUIR O CONJUNTO DE REPAROS DA CAIXA",
"observacoes": "RECOLHER AS PEÇAS","idProjeto": 15152132,
"status": 1,"projeto":
{
"nome": "PROJETO 001",
"tipo": 1,
"idErp": "2001",
"idErpTipoProjeto": "3001",
"idErpFase": "4001",
"idErpSubFase": "5001",
"idErpAtividade": "2001",
"idErpSubAtividade": "3001",
"idErpTarefa": "1001"
},
"pedidos":
[{
"idErp": "154",
"statusNegociacao": "AGUARDANDO LIBERACAO"
}]
},
"horaPrevisao":
[{
"idOcupacao": "154",
"previsao": "60"
}]
}
Obs.: Não deve ser utilizado caracteres especiais nem nova linha no no body.
DEFINIÇÃO DE VALORES
Permite Permite
Atualizar?
Valor idErpEmpresa Text 20 Obrigatório Não ID da empresa no ERP. idErpFilial Text 20 Obrigatório Não ID da filial no ERP. idErpSolicitante Text 20 ObrigatórioID do patrimônio no SISMETRO. Para abrir uma SS para um equipamento sem cadastro envie o ID 2 e descreva no parâmetro "Objeto" os dados do patrimônio.
Quando este parâmetro for igual a ID 2 não deverá ser validado se o patrimônio pertence ao solicitante.
objeto Text 65 Condicional Sim Dados descritivos do equipamento sem cadastro (Exemplo: Tipo, marca, modelo, serial e etc). Campo obrigatório apenas quando idPatrimonio for ID 2. Parâmetro ignorado quando idPatrimonio maior que ID 2. categoria Integer 2 Condicional SimID da categoria da SS.
Parâmetro obrigatório quando idPatrimonio for igual ID 2. Parâmetro ignorado quando idPatrimonio maior que ID 2 (Quando definido o patrimônio a SS assumirá a categoria do cadastro). Solicitar a equipe de suporte as categorias de SS utilizadas pelo cliente.
gravidade Integer 1 Opcional NãoID da gravidade da SS.
- Sem gravidade;
- Pouco grave;
- Grave;
- Muito grave;
- Extremamente grave.
Quando não informado a gravidade é coletada do cadastro do equipamento. Na ausência da informação no cadastro do equipamento sera atribuído ID 1.
urgencia Integer 1 Obrigatório NãoID da gravidade da SS.
- Pode esperar;
- Pouco urgente;
- O mais rápido possível;
- É urgente;
- Necessita ação imediata.
ID da tendência da SS.
- Não irá piorar;
- Irá piorar a longo prazo;
- Irá piorar em médio prazo;
- Irá piorar em pouco tempo ;
- Irá piorar em rapidamente.
idOrigem
Text 20 Opcional Não ID único do documento, oportunidade ou ocorrência no sistema integrado (CRM, ERP entre outros) que disparou a abertura da SS. descricao Text 65 Obrigatório Sim Descrição ou título da SS. tipo Integer - Obrigatório SimTipo da SS (Exemplo: Preventiva, corretiva e etc). Solicitar a equipe de suporte os tipos de SS que o cliente utiliza.
atendimento Integer - Opcional Sim Tipo de atendimento (Exmeplo: Remoto, no cliente, telefone e etc). Solicitar a equipe de suporte os tipos de atendimento que o cliente utiliza. dataChamado Date time Formato ISO Opcional Sim Data do chamado do cliente (Formato ISO aaaa/mm/dd hh:mm:ss). Esta data é apenas orientativa, a SS será aberta com data e hora do envio da requisição.Tipo da SS (Exemplo: Preventiva, corretiva e etc). Solicitar a equipe de suporte os tipos de SS que o cliente utiliza.
servicosRealizar Text - Obrigatório SimDescrição completa dos serviços a realizar.
observacoes Text - Opcional SimObservações da SS. Este campo não é exibido para o solicitante nem no print da SS.
idErpCentroCusto Text - Opcional SimID do centro de custo da SS no ERP. A atribuição do centro de custo na SS deverá ser realizada seguindo as regras abaixo.
- Quando o parâmetro idPatrimonio igual ID 2 deverá ser atribuído o centro de custo na SS na seguinte ordem:
- Centro de custo enviado neste parâmetro;
- Centro de custo do solicitante enviado no parâmetro idErpSolicitante.
- Centro de custo enviado neste parâmetro;
- Quando o parâmetro idPatrimonio for um cadastro válido deverá ser atribuído o centro de custo na SS na seguinte ordem:
- Centro de custo enviado neste parâmetro;
- Centro de custo do patrimônio na plataforma;
- Centro de custo da localização do patrimônio na plataforma;
- Centro de custo do solicitante do patrimônio na plataforma.
- Centro de custo enviado neste parâmetro;
Caso nenhum centro de custo seja encontrado o campo ficará vazio.
projeto Objeto - -Status da SS.
1. Aberta;
3. Excluída
4. Cancelada;
5. Não Aprovada.
ID do projeto no SISMETRO.
Função utilizada pelo CRM.
pedidos Set/Array - -Listagem de pedidos que estão vinculados a SS.
Listagem de previsão de horas por função. Utilizar tabela 'drawoshoraprevisao' para adicionar a previsão. idOcupacao Integer - Opcional Não id da ocupação / função. (drawoccupation) previsao Integer - Opcional Não Tempo de previsão em minutos
VALIDAÇÃO DE EXECUÇÃO DA INTEGRAÇÃO
Tipo da integração: 7
Vendor: 1
Status: 1
CHAVE DE UNICIDADE DE REGISTRO
Chave de unicidade na plataforma: unit + idErpEmpresa + idErpFilial + idOrigem
Comportamento do WebService: Cada requisição enviada gerará uma nova SS (não triada) na plataforma.
RETORNO
{
“valid”:“valor”,
“codigo”:“valor”,“url”:“valor”,
“messagem”:“valor”
}
MENSAGENS DE RETORNO
DÚVIDAS