Disparar e Finalizar processo de O.S. - API

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 disparar/finalizar processo de ordem de serviço via API.

2 - Após realizar a configuração da API no equipamento do cliente, devesse inserir um novo atendimento, o qual a documentação segue no link: Atendimento_api, e na variável 'id_wfl_processo' colocar o ID do processo que vai ser disparado.

2.1 - Quando você criar o atendimento como o processo, ele já dispara a primeira tarefa do processo.

3 - Após a criação do atendimento com o processo, basta criar o seguinte código para dispara a próxima tarefa do processo:

 1 <?php
 2 
 3 // requerindo arquivo do webservice
 4 require(__DIR__ . DIRECTORY_SEPARATOR . 'WebserviceClient.php');
 5 
 6 // url do sistema
 7 $host = 'https://10.65.1.171/webservice/v1';
 8 
 9 //token gerado no cadastro do usuario (verificar permissões)
10 $token = 'TOKEN';
11 
12 //true para certificado auto assinado
13 $selfSigned = true;
14 
15 // instanciando api requerida na primeira linha do código
16 $api = new IXCsoft\WebserviceClient($host, $token, $selfSigned);
17 
18 //array de parâmetros do método
19 $dados = array(
20     'id_chamado' => '', //ID do Atendimento que esta disparando o processo
21     'id_tarefa_atual' => '1', //ID da tarefa que atendimento esta atualmente
22     'data_inicio' => '01/01/2019 00:00:00', //Data do inicio da tarefa O.S.
23     'data_final' => '01/01/2019 00:00:00', //Data do final da tarefa O.S.
24     'mensagem' => '', //Mensagem que vai seguir na O.S.
25     'gera_comissao' => 'N', //"S" para se gera comissão a O.S., "N" para se não gera
26     'id_su_diagnostico' => '', //ID do diagnostico que vai constar na O.S.
27     'finaliza_processo' => 'N', //Se for a ultimo processo, colocar "S", se não, colocar "N"
28     'id_proxima_tarefa' => '', //ID sequencia da proxima tarefa, se for a ultima, colocar "0"
29     'id_proxima_tarefa_aux' => '',//ID da proxima tarefa, idempendente de é o proximo na sequencia
30     'status' => 'F', //Status que constara na O.S., "A" Aberto, "AN" Analise, "EN" Encaminhada, "AS" Assumida, "AG" Agendado, "EX" Execução e "F" Finalisado
31     'id_tecnico' => '18', //ID do Tecnico responsavem da O.S.
32 );
33 
34 //execução do método GET API
35 $api->post('su_oss_chamado_fechar', $dados);
36 
37 // false para retorno em json e true para retorno em array php
38 $retorno = $api->getRespostaConteudo(false);
39 
40 //printando resultado
41 var_dump($retorno);
42 exit;
43 
44 ?>

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 SAC - Suporte API para que possamos esclarecer todas as suas dúvidas.

-

Voltar ao menu Recursos da API