Consulta Clientes/Fornecedores


Clientes

Para realizar a busca dos clientes cadastrados, você deve realizar uma requisição HTTP usando método GET para o endereço:

http://implantacaoapi.erpflex.com.br/api/cliente/

Exemplo:

$pest = new pestJSON("http://implantacaoapi.erpflex.com.br/api");
$pest->setupAuth("{seu_usuario}","{sua_senha}");
$resposta = $pest->get("/clientes");
print_r($resposta);

O retorno é dos 10 clientes partindo do primeiro registro. Para os próximos 10 clientes partindo de uma posição específica, acrescente esta posição ao final da URL. Ex: http://implantacaoapi.erpflex.com.br/api/clientes/10 (retorna os próximos 10 clientes partindo do 10o. registro de cliente)

Exemplo:

$pest = new pestJSON(“http://implantacaoapi.erpflex.com.br/api”); $pest->setupAuth(“{seu_usuario}”,”{sua_senha}”); $resposta = $pest->get(“/clientes/20”); print_r($resposta);

➡ Também é possível realizar busca maior que 10 clientes, nesse caso o limite máximo é de 400, para isso use o método GET para o endereço:

http://implantacaoapi.erpflex.com.br/api/clientes/?limit=400&offset=1

Limit: Define o valor máximo por consulta, no intervalo de 0 até 400;
Offset: Define a partir de qual registro que iniciará a contagem, no intervalo de 0 até quantidade de registros cadastrados na base;

<?php
header('Content Type : application/json');
require_once '/PestJSON.php';
$pest = new pestJSON("http://implantacaoapi.erpflex.com.br/api");
$pest->setupAuth("usuario","senha");
$resposta = $pest->get("/clientes/?limit=400&offset=0");

for($cp=0; $cp<=400; $cp++){
      $nome     = $resposta['data'][$cp]['nome'];
      $endereco = $resposta['data'][$cp]['endereco'];
      print($nome.' - '. $endereco .'<br>');
}
?>

Caso seja informado um valor maior que 400 no Limit, sempre irá retornar apenas os 10 primeiros registros.

Caso seja informado valor 0 (zero) no Limit, sempre irá retornar apenas os 10 primeiros registros.

Segue abaixo algumas situações de exemplos:

  • Ex. http://implantacaoapi.erpflex.com.br/api/clientes/?limit=0&offset=750 (o exemplo irá trazer os 10 primeiros registros, contando a partir do 750º registro);
  • Ex. http://implantacaoapi.erpflex.com.br/api/clientes/?limit=410&offset=400 (o exemplo irá trazer os 10 primeiros registros, contando a partir do 400º registro);
  • Ex. http://implantacaoapi.erpflex.com.br/api/clientes/?limit=400&offset=400 (o exemplo irá trazer os 400 primeiros registros, contando a partir do 400º registro);
  • Ex. http://implantacaoapi.erpflex.com.br/api/clientes/?limit=377&offset=35 (o exemplo irá trazer os 377 primeiros registros, contando a partir do 35º registro);
  • Ex. http://implantacaoapi.erpflex.com.br/api/clientes/?limit=100&offset=750 (o exemplo irá trazer os 100 primeiros registros, contando a partir do 750º registro);

Consulta de um cliente especifico

Para consultar um cliente pelo ID, você deve realizar uma requisição HTTP usando médoto GET para o endereço: http://implantacaoapi.erpflex.com.br/api/cliente/{ID_DO_CLIENTE}

Exemplo:

$pest = new pestJSON("http://implantacaoapi.erpflex.com.br/api");
$pest->setupAuth("{seu_usuario}","{sua_senha}");
$resposta = $pest->get("/cliente/51");
print_r($resposta);

O resultado será os dados do cliente de ID 51

Busca de cliente

Para realizar a busca de um cliente por determinado campo, , você deve realizar uma requisição HTTP usando médoto GET para o endereço: http://implantacaoapi.erpflex.com.br/api/clientes/busca?{nome_do_campo}={valor_do_campo}

Exemplo:

$pest = new pestJSON("http://implantacaoapi.erpflex.com.br/api");
$pest->setupAuth("{seu_usuario}","{sua_senha}");

$cliente[‘nome’]=”Novo Cliente”;
$cliente[‘email’]=”novo@cliente.com”;
$cliente = http_build_query($cliente);
$resposta = $pest->get("/clientes/busca?",$cliente);
print_r($resposta);

Consulta de Vendedor por Cliente

Será possível consultar todos os vendedores associados ao cadastro do cliente. A consulta a seguir, consiste em retornar todos os vendedores de um cliente especifico. Para isso, realize uma requisição HTTP usando o método GET no endereço abaixo:

http://implantacaoapi.erpflex.com.br/api/clientes_vendedores/busca/?cliente=(id do cliente)

Exemplo:

$pest = new pestJSON("http://implantacaoaapi.erpflex.com.br/api");
$pest->setupAuth("informe seu usuario","informe sua senha");

$resposta = $pest->get("/clientes_vendedores/busca/?cliente=2213147");
print_r($resposta);

Exemplo de Retorno

<cliente_vendedor>
<id>483828</id>
<Empresa>2871</Empresa>
<Cliente>Maria</Cliente>
<Vendedor>Camila</Vendedor>
<Criador>2715</Criador>
<alterador>2715</alterador>
<inclusao>2016-07-18 13:03:27</inclusao>
<alteracao>2016-08-30 16:52:33</alteracao>
<Status_tabela>0</Status_tabela>
</cliente_vendedor>

Para realizar uma consulta que retorne os 10 primeiros clientes, realize uma requisição HTTP usando o método GET no endereço abaixo:

http://implantacaoapi.erpflex.com.br/api/clientes_vendedores

Exemplo:

$pest = new pestJSON("http://implantacaoapi.erpflex.com.br/api");
$pest->setupAuth("informe seu usuario","informe sua senha");

$resposta = $pest->get("/clientes_vendedores/10");
print_r($resposta);

Exemplo de Retorno

  <cliente_vendedor>
        <id>483828</id>
        <Empresa>2871</Empresa>
        <Cliente>Maria</Cliente>
        <Vendedor>Camila</Vendedor>
        <Criador>2715</Criador>
        <alterador>2715</alterador>
        <inclusao>2016-07-18 13:03:27</inclusao>
        <alteracao>2016-08-30 16:52:33</alteracao>
        <Status_tabela>0</Status_tabela>
    </cliente_vendedor>

Observação: O retorno apresentará o primeiro vendedor associado ao cliente, a apresentação dos vendedores por clientes é por data de inclusão.

 

Fornecedores

Funciona da mesma maneira que o do Cliente, porém não possui o LIMIT e OFFSET.

O retorno é sempre de 10 fornecedores partindo do primeiro registro ou de uma posição específica.

Para partir de uma posição específica, acrescente esta posição ao final da URL.

Exemplo:

http://implantacaoapi.erpflex.com.br/api/fornecedores/15

Retornará os próximos 10 fornecedores, a partir do 15º registro.