Validação Técnica
Para iniciar em Produção, suas integrações deverão passar pelo processo de validação técnica. O processo de validação consiste em verificar se todos os fluxos básicos de integração com a API do Grupo Netshoes foram realizados de forma adequada.
Dessa forma, o Marketplace garante que os processos de compra nos portais de venda ocorram sem nenhum problema e o lojista não perca nenhuma venda.
Request Produtos
As chamadas de produtos devem ser realizadas exclusivamente através da API V2.
POST /products
Criação de no mínimo quatro produtos (necessário possuir família completa)
GET /products/{sku}/status
Realizar acompanhamento e validação de critica dos quatro produtos criados
PUT /products/{sku}/status
Realizar a alteração de status do produto para aprovado e pronto para venda (após o produto estar com o status catalogando).
Request SKUs
Assim como as chamadas de produtos, chamadas de SKUs (preço e estoque) também devem ser realizadas exclusivamente na API V2.
POST /products/{sku}/stocks
Realizar a primeira chamada de estoque para os produtos cadastrados
POST /products/{sku}/prices
Realizar a primeira chamada de estoque para os produtos cadastrados
PUT /products/{sku}/stocks
Alterar a informação do estoque disponível para 2 skus
PUT /products/{sku}/prices
Alterar a informação do preço para 2 skus
Request Orders
As informações referente a pedidos devem ser realizadas exclusivamente através da API V1.
POST /orders
Criar pelo menos doze pedidos com mais de um item
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/approved
Alterar 2 pedidos para o status do pedido para aprovado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/canceled
Alterar 2 pedidos para o status do pedido para cancelado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/invoiced
Alterar 2 pedidos para o status do pedido para faturado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/shipped
Alterar 2 pedidos para o status do pedido para enviado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/delivered
Alterar 2 pedidos para o status do pedido para entregue
Products Templates
Visando facilitar o acesso às informações cadastrais permitidas para os produtos cadastrados no ambiente Netshoes e Zattini, disponibilizamos uma série de consulta que permitirá listar desde marca e sabor disponível para utilização à categorização do produto cadastrado. A importância desta implementação está diretamente ligada ao fluxo correto de cadastro de produtos para as lojas do grupo.
(Todas as informações contidas nestas consultas são obrigatórias e serão validadas no momento do cadastro de produtos e devem ser realizadas através do endpoint da API V1.)
GET /brands
Retorna lista de marcas cadastradas para utilização.
GET /colors
Retorna lista de cores cadastradas para utilização.
GET /flavors
Retorna lista de sabores cadastradas para utilização.
GET /sizes
Retorna lista de tamanhos cadastradas para utilização.
GET /bus/{buId}/departments
Retorna a relação de departamentos disponíveis para categorização do produto e está vinculada ao business unit id (buId) que define basicamente os departamentos das lojas do grupo: NS – Netshoes e ZT – Zattini.
GET /department/{departmentCode}/productType
Retorna os “tipos de produtos” com base no departamento consultado. Essas duas informações (department e product type) definem a categorização do produto nas lojas do grupo e são obrigatórias no cadastro de produto.
GET /department/{departmentCode}/productType/{productTypeCode}/templates
Retorna lista de atributos vinculados a categoria (department + product Type) do produto consultado. Através dessa consulta é possível verificar quais atributos existem para cada categoria de produto, a obrigatoriedade do atributo e a forma de preenchimento (lista pré-definida, conteúdo livre).
Obtenção de token de produção
Após o desenvolvimento das chamadas acima, será necessário abertura de ticket através do Portal de Desenvolvedores solicitando a validação técnica. O processo consiste em agendarmos uma data para que realizem todas as chamadas acima enquanto realizamos o acompanhamento para validação se todas estão sendo realizadas corretamente.
Com as integrações devidamente validadas, a integradora estará apta a receber a chave de acesso para utilização da API de Produção. Através do ticket de validação técnica será passado as orientações necessárias para obtenção desta chave de Produção.