|
Já sou cadastrado
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 /productsCriação de no mínimo quatro produtos (necessário possuir família completa)
GET /products/{sku}/statusRealizar acompanhamento e validação de critica dos quatro produtos criados
PUT /products/{sku}/statusRealizar 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}/stocksRealizar a primeira chamada de estoque para os produtos cadastrados
POST /products/{sku}/pricesRealizar a primeira chamada de estoque para os produtos cadastrados
PUT /products/{sku}/stocksAlterar a informação do estoque disponível para 2 skus
PUT /products/{sku}/pricesAlterar 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 /ordersCriar pelo menos doze pedidos com mais de um item
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/approvedAlterar 2 pedidos para o status do pedido para aprovado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/canceledAlterar 2 pedidos para o status do pedido para cancelado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/invoicedAlterar 2 pedidos para o status do pedido para faturado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/shippedAlterar 2 pedidos para o status do pedido para enviado
PUT /orders/{orderNumber}/shippings/{shippingCode}/status/deliveredAlterar 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 /brandsRetorna lista de marcas cadastradas para utilização.
GET /colorsRetorna lista de cores cadastradas para utilização.
GET /flavorsRetorna lista de sabores cadastradas para utilização.
GET /sizesRetorna lista de tamanhos cadastradas para utilização.
GET /bus/{buId}/departmentsRetorna 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}/productTypeRetorna 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}/templatesRetorna 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).
Importante: Para a validação técnica, é necessário que realize abertura de ticket solicitando a realização do mesmo. Com este processo, será agendado uma data para que realizem todas as chamadas descritas nesta página com o nosso acompanhamento.
Aviso: Não serão consideradas, na validação técnica, chamadas realizadas pelo portal, e sim, somente, chamadas realizadas diretamente pela integração.
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.
