Cadastrar novo fornecedor - 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 cadastrar um novo fornecedor via API.

2 - Após realizar a configuração da API no equipamento do cliente, basta criar o seguinte código, nesta requisição vamos criar um novo fornecedor.

 1 <?php
 2 
 3 // requerindo arquivo do webservice
 4 require(__DIR__ . DIRECTORY_SEPARATOR . 'WebserviceClient.php');
 5 
 6 // url do sistema
 7 $host = 'https://IP/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     'razao' => 'Telesite', //obrigatorio
21     'fantasia' => '',//nome fantasia
22     'tipo' => '', //tipo do fornecedor
23     'data' => '28/05/2021',//obrigatorio, Máscara: 99/99/9999
24     'tipo_pessoa' => 'J',//obrigatorio, F = Física, J = Jurídica, E = Estrangeiro.
25     'cpf_cnpj' => '', //Máscara cpf/cnpj 99.999.999/9999-99
26     'ie_identidade' => '', //IE ou RG
27     'rg_orgao_emissor' => '',// registro orgao emissor
28     'ativo' => 'S',//obrigatorio
29     'obs' => '',// Observação, maximo 2048 caractares
30     'duplicata' => '',// maximo 200 caractares
31     'lote' => '',// maximo 200 caractares
32     'telefone' => '',//Telefone fixo Máscara: (99) 9999-9999 ou (99) 99999-9999
33     'celular' => '',//Telefone celular Máscara: (99) 9999-9999 ou (99) 99999-9999
34     'email' => '',// Email maximo 100 caractares
35     'site' => '',//Site maximo 200 caractares
36     'cep' => '',//CEP Máscara 99999-999
37     'endereco' => '',//Endereço maximo 100 caractares
38     'numero' => '',//Numero maximo 20 caractares
39     'bairro' => '',//Bairro maximo 100 caractares
40     'cidade' => '4376',//obrigatorio, ID da cidade, consultar na tabela 'cidade'
41     'referencia' => '',//Referencia maximo 100 caractares
42     'id_conta' => '',//ID da conta, consultar na tabela planejamento_analitico
43     'representante' => '',//Representante maximo 100 caractares
44     'telefone_representante' => ''//Telefone representante Máscara: (99) 9999-9999 ou (99) 99999-9999
45 );
46 
47 //execução do método POST API
48 $api->post('fornecedor', $dados);
49 
50 // false para retorno em json e true para retorno em array php
51 $retorno = $api->getRespostaConteudo(false);
52 
53 //printando resultado
54 var_dump($retorno);
55 exit;
56 
57 ?>

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:

Retorno com sucesso novo fornecedor.png

-

Voltar ao menu Recursos da API