Integração

Os próximos passos irão detalhar a sequência lógica de integração com a API do Marketplace da Via Varejo. Algumas informações podem ser úteis antes de iniciar as integrações, como:

Padrões utilizados na modelagem das APIs

Segurança das informações trafegadas

Ambiente de Sandbox

API Explorer

SDKs diponíveis


Introdução

Através da API versão 4 modificamos o fluxo de integração de ofertas no marketplace com o intuito de aumentar a qualidade das informações do produto, melhorando os motores de busca, experiência do usuário e tempo para catalogação.

Diversos conceitos presentes nas versões anteriores foram remodelados como, por exemplo, o conceito de carga. O conceito de carga é um agrupamento de itens (SKUs) enviado para o cadastro na Via Varejo que somente é efetivado caso todos os SKUs estejam válidos, ou seja, se a carga possuir 1000 SKUs e 1 estiver inválido, toda a carga será cancelada. Logo, estamos ignorando os 999 SKUs pois um está inválido. Nessa nova versão, o conceito foi alterado para que cada operação seja feita por SKU, mesmo que você envie um lote maior, visando o cadastro rápido e efetivo.

Cadastro de produto simples

O cadastro de produto simples é feito com somente um SKU (Stock keeping Unit). Ou seja, não há variação de um produto simples.

Cadastro de produto variante

O cadastro de um produto variante possui duas ou mais variações. As variações são necessárias quando o produto necessita de uma escolha como, por exemplo, o tamanho de uma camisa (P, M e G).

Confira abaixo como trabalhar com a nossa API de Categorias.

Categorização de Produtos
Importação de produtos com a API V4

URL Base: http://api.cnova.com/api/v4/api-front-importer-v4/jersey

Fluxo de Cadastro de Produtos da API V4

Explicação campo a campo

"idItem" - Código informado pelo seller para agrupar os SKU's por item.
 
"marca" - Marca do produto
 
"titulo" - Título do produto
 
"idCategoria" - Código da categoria de último nível com base na nossa árvore de categorias
 
"descricao" - Descrição do produto
 
"garantia": - Tempo de garantia do produto em meses
 
"gtin": Código EAN
 
"idSkuViaVarejo": Código identificador do SKU na base de dados da Via Varejo. Utilizado para forçar um match com o SKU informado.
 
"idSkuLojista": Código identificador do SKU na base de dados do lojista.
 
"idUda": Código do atributo com base em uma categoria da nossa árvore de categorias
"valor": Valor do atributo com base em uma categoria da nossa árvore de categorias
 
Exemplo de envio dos campos:
 "atributos": [{          
"idUda": "13841",
"valor": "Amarelo Claro"
 }
 
"padrao": Valor padrão do produto (De)
"oferta": Valor de oferta do produto (Por)
 
O valor padrão pode ser igual ao de oferta caso o lojista não possua essa lógica.
 
Exemplo de envio dos campos:
    "preco": {
        "padrao": "699,00"
        "oferta": "649,00",
    }
 
"tempoDePreparacao": Quantidade de dias necessário para preparar o produto
"quantidade": Quantidade de estoque do produto
 
Exemplo de envio dos campos:
    "estoque": {
        "quantidade": "9",
        "tempoDePreparacao": "0"
    }
 
"imagens": Necessário informar de 1 a 4 imagens por SKU.
 
"largura": Dimensão em metros
"altura": Dimensão em metros
"profundidade": Dimensão em metros
"peso": Dimensão em quilos
 
Exemplo de envio dos campos:
    "dimensao": {
        "altura": "37.0",
        "largura": "61.0",
        "profundidade": "47.0",
        "peso": "7.0"
    }
 

Exemplo de payload para importação de produtos

POST http://api.cnova.com/api/v4/api-front-importer-v4/jersey/import/itens/

Header

client_id: <Seu client id>

access_token: <Seu access token>

Content-Type:application/json

Body
 
{
  "itens": [{
    "idItem": "211456",
    "titulo": "Smart TV LED 50\" Philips 50PUG6513/78 4K UHD com WI-FI, 2 USB, 3 HDMI, Sleep Timer e 60Hz",
    "descricao": "Características do Produto: <br/>Resolução da Tela: 4K<br/>Tamanho da Tela: 50&quot;<br/>Smart TV: Sim<br/>Android TV: Não <br/>Tecnologia da Tela: LED<br/>Tela 3D: Não<br/>Plataforma de Games: Não<br/>Selo Inmetro: Procel<br/>Classificação Energética: A<br/><br/>Informações Adicionais:<br/>Tipo de Painel: LED<br/>Resolução (modo TV): 3840x2160 (UHD 4K)<br/>Resolução (modo Monitor - máxima via VGA/RGB): 3840x2160 - 60 Hz<br/>Frequência do Painel: 60 Hz<br/>Receptor Digital Integrado (DTV): Sim<br/>Brilho (cd/m2): 350<br/>Sistema de Cores: NTSC-M/PAL-M/PAL-N<br/>Smart TV (Wi-Fi Integrado): Sim<br/>Sistema Operacional: Linux<br/>Processador: Quad Core<br/>HDR <br/>Consumo em modo espera (standby, máximo): &lt;0,3 W<br/><br/>Sistema:<br/>Recursos de Som: Dynamic Surround/Clear Dialogue/Smart Sound/5 Band Equalizer<br/>Potência de Áudio: (RMS) 20 W<br/>WiFi Miracast: Sim<br/>Parental Control (controle dos pais): Sim<br/>Aplicativos pré-instalados: Netflix, YouTube, Globo Play e muitos outros<br/>Sleep Timer: Sim<br/>EPG (Guia Eletrônico de Programação): Sim<br/>Produto ecológico (menor consumo de energia): Sim<br/><br/>Conexões:<br/>Vídeo Composto: 1<br/>Vídeo Componente: 1<br/>Entrada Audio L/R: 1<br/>HDMI: 3<br/>USB: 1 Entrada USB 2.0/1 Entrada USB 3.0<br/>LAN (para conexão de rede via cabo - Internet): 1<br/>Conexão Wireless: Sim<br/>Saída de áudio/vídeo: 1 (digital áudio - SPDIF)<br/>Entrada para fone de ouvido: Sim<br/><br/>Dimensões do Produto:<br/>Dimensões s/ base (L x A x P): 112,76 x 65,53 x 8,59 cm<br/>Embalagem (L x A x P): 12,40 x 8,0 x 15,0 cm<br/><br/>Peso:<br/>Peso líquido: 11,79 kg<br/>Peso Bruto com Embalagem: 16,58 kg<br/><br/>Garantia: 1 Ano (ofertada pelo fabricante)<br/><br/>SAC - Fornecedor<br/>Philips <br/>2121 0203 (Grande São Paulo)<br/>0800 701 0203 (demais regiões)<br />",
    "marca": "PHILIPS",
    "idCategoria": "370",
    "atributos": [],
    "skus": [
        {
            "idSkuLojista": "2217478",
            "gtin": "7898620270650",
            "imagens": [
                "http://ecms.loremipsum.com.br/loremipsum/2217478_01.jpg",
                "http://ecms.loremipsum.com.br/loremipsum/2217478_02.jpg",
                "http://ecms.loremipsum.com.br/loremipsum/2217478_03.jpg"
            ],
            "preco": {
                "oferta": "2523,99",
                "padrao": "2523,99"
            },
            "estoque": {
                "quantidade": "180",
                "tempoDePreparacao": "0"
            },
            "dimensao": {
                "altura": "70.0",
                "largura": "23.0",
                "profundidade": "113.0",
                "peso": "11.79"
            },
            "idSkuViaVarejo": ""
        }
    ]
}
]
}
 

Clique aqui para conferir o Swagger da API.

 

Importação de produtos com a API V2 (Deprecated)
Controle dos itens de venda
Controle de ordens
Controle de tickets
Controle de eventos

 

Português, Brasil