Receber título - API

No sistema IXC Provedor, podemos realizar várias tarefas diárias do sistema via API, dentre elas, efetuar um recebimento.

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 receber um título via API.

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

 1 <?php
 2 //requerindo arquivo do webservice
 3 require(__DIR__ . DIRECTORY_SEPARATOR . 'WebserviceClient.php');
 4 $host = 'https://dominio/webservice/v1';
 5 $token = '17:e41e2970347b5a7e9ef8aec659wa2fa31c38a3b19fg87f15rw1';
 6 //true para certificado auto assinado
 7 $selfSigned = true;
 8 //instanciando api requerida na primeira linha do código
 9 $api = new IXCsoft\WebserviceClient($host, $token, $selfSigned);
10 //array de parâmetros do método
11 $dados = array(
12     'filial_id' => '1', // filial do recebimento
13     'id_receber' => '395', // id do título
14     'conta_' => '3', // conta que está fazendo o recebimento 
15     'id_conta' => '365', // planejamento analítico da conta que está fazendo o recebimento
16     'tipo_recebimento' => 'D', // tipo recebimento em dinheiro
17     'data' => '13/07/2020', // data do recebimento
18     'valor_parcela' => 'R$66,68',   // valor da parcela
19     'credito' => '66,68', // credito e débito devem se anular na baixa
20     'debito' => '66,68',
21     'valor_total_recebido' => 'R$66,68', // valor total
22     'historico' => 'teste', // descrição registrada 
23     'previsao' => 'N', // Previsão = S significa isentar de um período, previsão = significa que foi cobrado
24     'tipo_lanc' => 'R', // tipo de lançamento recebimento 
25 );
26 
27 $api->post('fn_areceber_recebimentos_baixas_novo', $dados);//Faz a o POST na API na tabela
28 $retorno = $api->getRespostaConteudo(true);// false para json | true para array
29 echo "<pre>";
30 print_r($retorno);
31 ?>

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:

2020-07-13 16-34.png

2.2 - Ao acessar o Financeiro do cliente, podemos perceber que a parcela ID '365' já está recebida. Para acessar o financeiro do cliente, basta ir em menu Sistema > Cadastros > Clientes. Selecionar o cliente e Editar. Seguir até a aba Financeiro.

2020-07-13 16-38.png

2.3 - Caso o título já estiver recebido, será retornado o seguinte:

Azsxqq.png

-

Voltar ao menu Recursos da API.