API de comunicação (for PHP servers) com o software para revendas e concessionárias Smart Dealer

Para mais informações, acesse o nosso site.

Direitos reservados à Smart Dealer Soluções em Software Ltda.

Caso necessite de acesso a integração antiga, veja o SD Soap-XML.

• PHP 5.3 ou superior
• Extensões do PHP "php_curl" e "php_openssl"
• Apache 2.2+

  # include API class
  include_once 'sdapi.class.php';
  
  # client name OR direct instance URL (prima or prima.smartdealer.com.br)
  $env = 'prima';
  
  # login webservice Rest
  $usr = 'primafiat';    
  
  # password webservice Rest (example)
  $pwd = 'unXEmpkV7ush#';     
  
  # init API
  $api = new Smart\Api($env, $usr, $pwd, array());
  

https://{usuario}:{chave}@{cliente}.smartdealer.com.br/webservice/rest/connect/offers/?format={formato}&template={template}

• {usuario} = usuário do ws
• {chave} = chave do ws
• {cliente} = nome da instância
• {formato} = formato do saída em JSON ou XML (vide parâmetros de configuração)
• {template} = estrutura de campos da saída

  # call method
  $ret = $api->get('/parts/');
  
  # output (Array)
  array(
    0 => array(
      'codigo' => 0001
      'nome'   => 'Parachoque Dianteiro (Palio ELX)',
      'modelo' => 'MCBSA-12',
      'preco'  => 840.00,
      'qtd'    => 10,
      'fab'    => '1 - FIAT' 
    ),
    1 => array(
      'codigo' => 0002
      'nome'   => 'Parachoque Traseiro (Palio ELX/EX)',
      'modelo' => 'MCBSA-15',
      'preco'  => 532.00,
      'qtd'    => 7
      'fab'    => '1 - FIAT' 
    ),
    2 => array(
      'codigo' => 0003
      'nome'   => 'Motor Limpador de Parabrisa (UNO Vivace)',
      'modelo' => 'MCBSA-88',
      'preco'  => 120.00,
      'qtd'    => 2,
      'fab'    => '1 - FIAT' 
    )
  )
  

  
  # reading data list
  $api->get('/route/method');
  
  # reading specific data
  $api->get('/route/method/:id');

  
  $data = array();
  
  # send data (simple)
  $api->post('/route/method/', $data);
  
  # send data with ID param (if required)
  $api->post('/route/method/:id', $data);

  
  # delete data
  $api->delete('/route/method/:id');

Lista as filiais do cliente

Lista o estoque de peças

Lista os fabricantes cadastrados

Registra ou atualiza a reserva de uma peça (e-commerce)

Registra ou atualiza a lista de notificações, pendências no estoque (e-commerce)

Remove a reserva de uma peça

Lista os pacotes de ofertas disponíveis (connect)

Lista as ofertas de um determinado pacote (connect)

Lista todas as ofertas do cliente

  # the API settings
  $settings = array(
    'handle' => 'curl',
    'timeout' => 10,
    'use_ssl' => false,
    'port' => 80,
    'debug' => false,
    'output_format' => 1,
    'output_compile' => true
  );
  
  # init API (with param settings)
  $api = new Smart\Api($env, $usr, $pwd, $settings);
  
  

Escolha do método/protocolo de conexão com o servidor Restful.

• String: "curl" (padrão), "socket" e "stream"

Tempo máximo da resposta do servidor em segundos.

• Integer: 10 (padrão)

Habilitar esta opção se a conexão exigir SSL.

• Bool: false (padrão)

Número da porta de conexão com servidor Restful.

• Integer: 80 (padrão)

Para desenvolvedores, se ativa exibe os erros execução e comunicação com o servidor.

• Bool: false (padrão)

Opção de configuração do formato de resposta do servidor ('JSON' = 1, 'XML' = 2).

• Integer: 1 (padrão)

Se desativada, mostra a resposta literal do servidor em XML ou JSON.

• Bool: true (padrão)

@Release 1.1

Nota da versão:

• Adição de feature: configuração para resposta em XML

Observação: os parâmetros dos métodos de envio (POST) serão adicionados futuramente.

Faça o download da documentação em PDF (incompleto).