Ordem de Serviço

Caro Cliente, a Integração ServiceDesk permite a criação e acompanhamento das ordens de serviço de atendimento técnico de maneira eficaz e centralizada.

Por intermédio desta integração, você pode automatizar a criação de Ordens de Serviço na Simpress a partir de seu sistema interno para gestão de tickets, ganhando eficiência operacional. Além disso, este processo proporciona maior confiabilidade das informações devido aos mecanismos de autenticação e segurança no tráfego de seus dados.

Você também pode utilizar esta integração para acompanhar o andamento das Ordens de Serviço abertas conosco, visualizando o número e o tracking de status da OS diretamente no seu sistema.

Caso seja necessário cancelar uma Ordem de Serviço aberta conosco, também é possível automatizar este processo. Nossas APIs permitem que você mantenha o controle das Ordens de Serviço ao longo de todo seu ciclo de vida.

Ao longo desta documentação, você conhecerá todos os detalhes necessários para consumir nossas APIs e se conectar aos nossos sistemas.

Endereço usado como endereço raiz para todas as funcionalidades. Exemplo do endereço base em negrito: "https://apiexterno-deveq12.simpress.com.br/v1/OrdensDeServico" .

Pesquisa por Atendimento

Objetivo é consultar uma Ordem de Serviço utilizando como identificador o Número do Atendimento e o Número de Série. Caso informações inválidas sejam utilizadas, as mensagens de validação serão exibidas no retorno.

Endereço Base + /v1/OrdensDeServico/{Atendimento}/{NumeroSerie}/{Chave}
Método: Get

Pesquisa por ordem de Serviço 

Objetivo é consultar uma Ordem de Serviço utilizando como identificador o Número da Ordem de Serviço e o Número de Série.

Caso informações inválidas sejam utilizadas, as mensagens de validação serão exibidas no retorno.

  Endereço Base +
 + /v1/OrdensDeServico/{NumeroSerie}/{OrdemServico}/{Chave}
  Método: Get

Pesquisa Por ordem de Serviço do Cliente

Objetivo é consultar uma Ordem de Serviço utilizando como identificador o código do cliente.

Caso informações inválidas sejam utilizadas, as mensagens de validação serão exibidas no retorno.

  Endereço Base +
  /v1/OrdensDeServico/{chaveAutenticacao}/{ServicoCliente}?numeroserie=xA1000XX&apelido=maq222323.
  Método: Get

Cancelamento da Ordem de Serviço

Endereço Base + /v1/OrdensDeServico/{CodigoServico}/{Chave}
Método: Get
Objetivo é cancelar uma Ordem de Serviço utilizando como identificador o Número da Ordem de Serviço e a chave de autenticação.

Caso informações inválidas sejam utilizadas, as mensagens de validação serão exibidas no retorno.

Tipos de Defeitos

Método para retornar quais os tipos de defeitos possíveis para o equipamento selecionado, necessário enviar o número de série.

Endereço Base + /v1/Equipamentos/Diagnosticos/{numeroSerie}
Método: Get

Solicitação da Ordem de Serviço

Foi disponibilizado um método POST para solicitar a abertura de uma Ordem de Serviço. Segue o detalhe:
Endereço Base + /v1/OrdensDeServico
Método: Post
Objetivo é solicitar a abertura de uma Ordem de Serviço utilizando diversos dados que serão informados.
Caso informações inválidas sejam utilizadas, as mensagens de validação serão exibidas no retorno.

Exemplo da criação da ordem em formato Json:

Atualização de Status – Monitoramento das ordens 

A integração permite que seja configurado um meio de comunicação para receber informações sobre atualizações de status das ordens de serviços que foram abertas.
As atualizações para os parceiros são feitas via Get “consulta por atendimento” e “consulta por número de série” passando a ordem que foi gerada na integração conforme nos itens acima.
O cliente executa as ordens e recebe o retorno no mesmo processo tendo ostatus do chamado fazendo as atualizações nos repositórios necessários.

Tabela de referência de Tipos de Defeitos

Tabela de Referência Situação do Equipamento