Desconto adicional - API

No sistema IXC Provedor, podemos realizar várias tarefas diárias do sistema via API, dentre elas, conceder um desconto adicional.

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 dar um desconto adicional dentro do contrato de um cliente.

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

<?php
require(__DIR__ . DIRECTORY_SEPARATOR . 'WebserviceClient.php');
$host = 'https://ip/webservice/v1';
$token = 'TOKEN';//token gerado no cadastro do usuario (verificar permissões)
$selfSigned = true; //true para certificado auto assinado
$api = new IXCsoft\WebserviceClient($host, $token, $selfSigned);
$dados = array(
'id_produto' => '',//obrigatório
'descricao' => '',//obrigatório
'id_produto_contrato_vinc' => '',//obrigatório
'data' => '',//obrigatório
'id_unidade' => '',//obrigatório
'quantidade' => '',//obrigatório
'valor_unitario' => '',//obrigatório
'valor_total' => '',//obrigatório
'repetir' => '',//obrigatório
'repetir_qtde' => '',
'status' => 'A',//obrigatório
'execucoes' => '',
'ultima_execucao' => '',
'status_nf21' => 'A',//obrigatório
'execucoes_nf21' => '0',
'ultima_execucao_nf21' => '',
'id_contrato' => '',//obrigatório
'tipo_acres_desc' => ''
);
$api->post('cliente_contrato_descontos_servicos', $dados);
$retorno = $api->getRespostaConteudo(false);// false para json | true para array
var_dump($retorno);

2.1 - 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:

Sucesso.png

2.2 - No exemplo acima, temos o retorno sendo feito em JSON, para que o mesmo seja retornado em formato de array PHP, 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 array PHP.

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

-

Voltar ao menu Recursos da API.