Ordem de serviço - Encaminhar (alterar setor) - API

No sistema IXC Provedor, podemos realizar várias tarefas diárias do sistema via API, dentre elas, encaminhar (alterar setor) de ordem de serviço.

1 - Antes de qualquer coisa, precisa-se realizar a configuração da API no equipamento do provedor, para saber como realizar esta configuração, basta acessar o link Configurando acesso ao Webservice API Apache ou Configurando acesso ao Webservice API Nginx após esta configuração, realize os passos abaixo para encaminhar (alterar setor) de ordem serviço.

2 - Após realizar a configuração da API no equipamento do cliente, basta criar o seguinte código:

 1 <?php
 2 require(_DIR_ . DIRECTORY_SEPARATOR . 'WebserviceClient.php');
 3 $host = 'https://seuip/webservice/v1';
 4 $token = '48:06285ec23778754c351f0edce58960b68f1812d8b70fc8625658710449747c2a';//token gerado no cadastro do usuario (verificar permissões)
 5 $selfSigned = true; //true para certificado auto assinado
 6 $api = new IXCsoft\WebserviceClient($host, $token, $selfSigned);
 7 $dados = array(
 8 'id_chamado' => '',
 9 'id_setor' => '',
10 'id_tecnico' => '',
11 'id_assunto' => '',
12 'mensagem' => '',
13 'status' => 'EN'
14 
15 );
16 $api->post('su_oss_chamado_alterar_setor', $dados);
17 $retorno = $api->getRespostaConteudo(false);// false para json | true para array
18 var_dump($retorno);

2.1 - Na parte de valores temos os seguintes campos para inserir:

  • F => Finalizada
  • EX => Execução
  • AG => Agendado
  • AS => Assumida
  • EN => Encaminhada
  • AN => Análise
  • A => Aberto

2.2 - O retorno recebido pode ser tanto de sucesso como de erro no caso de alguma inconsistência nos dados passados. Nesse caso obtemos um retorno de sucesso:

ENCAMINHAR OS.png

2.2 - No exemplo acima, temos o retorno sendo feito em array, para que o mesmo seja retornado em formato JSON, precisamos apenas mudar o parâmetro que está dentro de $api->getRespostaConteudo(), ao invés de deixarmos como FALSE, alteramos para TRUE e a API já se encarrega de retornar os dados em JSON.

Esse foi um breve tutorial de como podemos utilizar esta funcionalidade através da API, caso haja alguma dúvida referente ao processo, ou algo ainda assim não esteja de acordo com o processo que esteja sendo solicitado, é de extrema importância que entre em contato com o suporte API para que possamos esclarecer todas as suas dúvidas.

-

Voltar ao menu Recursos da API.