getProductShowcase - Webservice
Atualizado há mais de uma semana

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>&lt;p&gt;PARAFUSO ALLEN CABE&amp;Ccedil;A CILINDRICA 12.9 M4 X 6&lt;/p&gt;
&lt;p&gt;*imagem meramente ilustrativaaaa&lt;/p&gt;</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&Ccedil;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.

Respondeu à sua pergunta?