API e documentação de comunicação (for PHP servers) com a plataforma 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+

composer require smartdealer/sdapi

  # include API class
  include_once 'src/smart/api.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

Será necessário a criação de um login, chave de acesso e a liberação do endereço de IP (servidor onde a API será executada) pela Smart para autenticação no webservice Rest, ambiente de produção.

A solicitação poderá ser feita atravéz deste link: http://bit.ly/2bVryEC

  # 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' 
    )
  )
  

Tradução dos campos retornados na consulta das ofertas selecionadas do estoque.

  
  # 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);
  

  
  $data = array();
  
  # remove data (required ID param) 
  $api->delete('/route/method/:id');
  

{
  "status": 500,
  "errors": [
    "O limite de 1 conta(s) foi atingido. Entre em contato conosco."
  ],
  "response": false
}

Lista as categorias de veículos do estoque (carro, moto, caminhão)

Cadastra um novo cliente/CNPJ no sistema

Filtros

Uso

https://{usuario}:{chave}@{cliente}.smartdealer.com.br/webservice/rest/connect/contracts?param=value

Lista as filiais/lojas 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 canais/portais disponíveis para integração

Lista de tradução dos códigos de resposta dos canais de integração.

Breve exemplo, para ver a lista completa faça uma chamada a rota Rest acima.

Cria uma configuração de integração (connect)

Filtros

Uso

https://{usuario}:{chave}@{cliente}.smartdealer.com.br/webservice/rest/connect/contracts?param=value

Lista as integrações configuradas (contratos de integração)

Cadastra um veículo para publicação em um pacote de ofertas (connect)

Formato das imagens (em base64)

Atualiza uma oferta de veículo no estoque (connect)

A flag :id deverá ser substituída pelo código da oferta, ex: "/connect/offer/1".

Parâmetros da chamada

Formato das imagens (em base64)

Importante

O o tipo de estoque "U" para usados e "N" para novos não poderá ser alterado. Neste caso será necessário excluir a oferta e adicionar novamente no pacote (estoque).

Lista os pacotes de ofertas disponíveis (connect)

Filtros

Uso

https://{usuario}:{chave}@{cliente}.smartdealer.com.br/webservice/rest/connect/contracts?param=value

Lista as ofertas de um determinado pacote (connect)

Lista todas as ofertas do cliente

Remove a oferta do pacote e do portal (pós sincronização automática)

A flag :id deverá ser substituída pelo código da oferta, ex: "/connect/offer/1".

Remove uma configuração de integração e seus pacotes (contrato)

A flag :id deverá ser substituída pelo código do contrato, ex: "/connect/contract/1".

  # 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 erros de 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)

Fluxo de interação com o webservice Smart via Api na integração com portais automotivos.

@Release 1.6

Nota da versão:

Nenhuma.