Método
O nome do método utilizado na consulta é getProductShowcase.
Descrição
Trazer produtos e variações no formato json para retornar nas vitrines. Este novo método no webservice é capaz de capturar as vitrines de produtos de cada cliente para uso externo, tanto para agências ou integradores como SmartHint.
Filtros
Os filtros são organizados em uma tabela contendo o nome, tipo e descrição de cada filtro.
Nome | Tipo | Descrição |
codigos | array(String(40)) | Busca pelo código do produto específico. |
referencia | Integer | Busca produtos com a referencia específica. |
valor_inicio | Decimal | Produtos com valor atual a partir do valor deste campo. |
valor_final | Decimal | Produtos com valor atual até o do valor deste campo. |
categorias | array(Integer(11)) | Código ou sequência de códigos (separados por vírgula) com ID's de categoria dos produtos |
marcas | array(Integer(11)) | Código ou sequência de códigos (separados por vírgula) com ID's de marcas dos produtos |
qtd_de | Integer | Quantidade de produtos no estoque(a partir) |
qtd_ate | Integer | Quantidade de produtos no estoque(até) |
order | String | Modo de ordenação (ASC ou DESC) |
Exemplo de Requisição:
XML:
<qtd_de>0</qtd_de>
<qtd_ate>10</qtd_ate>
<categorias>45</categorias>
<marcas>21</marcas>
<marcas>53</marcas>
<order>Produto.id desc</order>
JSON:
{
"qtd_de": 0,
"qtd_ate": 10,
"categorias": [45],
"marcas": [21,53],
"order": "Produto.id desc"
}
Retorno:
Os retornos são organizados em uma tabela contendo grupo do campo, nome, tipo, e descrição de cada campo.
Grupo | Nome | Descrição |
Product | sku | Código do produto. |
Product | url | URL do produto (Caso o produto em questão possua variação de cor ou tamanho, este campo irá ser apresentado vazio) |
Product | image | URL da imagem principal do produto |
Product | title | Título do Produto, |
Product | description | Descrição do produto |
colors | sku | Código da variaçao do produto. |
colors | url | URL da variação produto (Caso o produto em questão possua variação de cor ou tamanho, este campo irá ser apresentado vazio) |
colors | image | URL da imagem do produto |
colors | quantity | Quantidade em estoque. |
colors | title | Título da variação do produto. |
colors | price | Preço do produto |
colors | sale_price | Compara valor atual com valor antigo e define se houve um desconto. |
colors | color | cor da variação do produto. |
colors | cash_price | Preço a vista. |
colors | description | Descrição da variação de cor do produto. |
size | sku | Código da variaçao do produto. |
size | gtin | EAN do produto. |
size | quantity | Quantidade em estoque da variação do produto. |
size | size | Tamanho do Produto. |
Exemplo de Retorno:
XML:
<?xml version="1.0" encoding="UTF-8" ?>
<product>
<sku>01007</sku>
<url></url>
<image>https://cdnv2.moovin.com.br/copalparafusos/imagens/produtos/original/pa-allen-cilindrica-12-9-m4-x-6-60f9596edf97c.jpg</image>
<title>PARAFUSO ALLEN CABEÃ A CILINDRICA 12.9 M4 X 6</title>
<description><p>PARAFUSO ALLEN CABE&Ccedil;A CILINDRICA 12.9 M4 X 6</p>
<p>*imagem meramente ilustrativaaaa</p></description>
<colors>
<21>
<sku>01007</sku>
<url>http://www.copalparafusos.com.br/pa-allen-cilindrica-129-m4-x-6</url>
<image>https://cdnv2.moovin.com.br/copalparafusos/imagens/produtos/original/pa-allen-cilindrica-12-9-m4-x-6-60f9596edf97c.jpg</image>
<quantity>200</quantity>
<title></title>
<price>0.18</price>
<sale_price></sale_price>
<color></color>
<cash_price>0.18</cash_price>
<description></description>
<sizes>
<27>
<sku>01007</sku>
<gtin>0</gtin>
<quantity>200</quantity>
<size></size>
</27>
</sizes>
</21>
</colors>
</product>
JSON:
{
"product": {
"sku": "01007",
"url": "",
"image": "https://cdnv2.moovin.com.br/copalparafusos/imagens/produtos/original/pa-allen-cilindrica-12-9-m4-x-6-60f9596edf97c.jpg",
"title": "PARAFUSO ALLEN CABEÃ A CILINDRICA 12.9 M4 X 6",
"description": "<p>PARAFUSO ALLEN CABEÇA CILINDRICA 12.9 M4 X 6</p>\r\n<p>*imagem meramente ilustrativaaaa</p>",
"colors": {
"21": {
"sku": "01007",
"url": "http://www.copalparafusos.com.br/pa-allen-cilindrica-129-m4-x-6",
"image": "https://cdnv2.moovin.com.br/copalparafusos/imagens/produtos/original/pa-allen-cilindrica-12-9-m4-x-6-60f9596edf97c.jpg",
"quantity": "200",
"title": "",
"price": "0.18",
"sale_price": "",
"color": "",
"cash_price": "0.18",
"description": "",
"sizes": {
"27": {
"sku": "01007",
"gtin": "0",
"quantity": "200",
"size": ""
}
}
}
}
}
Mais sobre Webservice
Consulte nossa tabela de retorno aqui.
Não conhece todos os métodos webservice da Moovin? Veja nossa lista completa aqui.
Caso tenha dúvidas em como realizar o envio ou formatos de envio, veja nesta nossa documentação aqui.