Integradora ou integração própria
- Crie a APP no portal: os tokens de Sandbox saem na hora.
- Teste os fluxos e peça a validação técnica.
- Validada, recebe um novo client_id de Produção.
Uma única integração para vender nos sites do Grupo Netshoes: catálogo, preço, estoque, pedidos e entregas pela API.
Os três passos de toda integração com a API Marketplace.
Cadastre-se no Portal de Desenvolvedores para realizar a criação do seu APP e Token de Sandbox, onde será possível realizar testes de integração.
Criar contaRealize os testes no ambiente de sandbox, solicite a sua validação técnica e esteja apto a integrar à API Marketplace do Grupo Netshoes em Produção.
Conhecer o SandboxCom o acesso liberado em Produção, você poderá enviar a sua carga de produtos e acompanhar até a disponibilização no marketplace.
Regras de produçãoCom a APP criada, os tokens de Sandbox já estão em Minhas Apps. A primeira chamada lista os departamentos do site — é com eles que você monta o produto.
curl https://api-sandbox.netshoes.com.br/api/v1/bus/NS/departments \
-H "client_id: $CLIENT_ID" \
-H "access_token: $ACCESS_TOKEN" \
-H "content-type: application/json"É isto que a sua integração faz todos os dias: mover cada entrega do pedido até o cliente. Escolha um status para ver a chamada e a regra dele.
A chamada
PUT /api/v1/orders/{orderNumber}/shippings/{shippingCode}/status/invoiced
client_id: {client_id}
access_token: {access_token}A regra
O faturamento leva a nota fiscal no campo danfeXml, com as aspas escapadas, e é processado de forma assíncrona. É aqui que a reserva de estoque é de fato subtraída.
Ver referência de Pedidos e entregasE duas regras que valem sempre: requisição acima de 1 MB responde 413, e quem passa do limite de chamadas por minuto recebe 429.
A maior do varejo online de esporte também é a marca de lifestyle esportivo que há mais de 20 anos entrega esporte na casa dos brasileiros — parte do Grupo Magalu desde 2019.
Cursos curtos, guias do dia a dia do seller e os termos que aparecem na integração.
As perguntas frequentes respondem sobre tokens, cadastro de produtos, estoque e pedidos. Não achou? Abra um chamado com o time do Marketplace.
Não. Uma única integração é necessária para colocar os seus produtos para vender em nossos sites. Inclusive o estoque é compartilhado entre eles e gerenciado por nós. Você também irá reparar que alguns métodos na nossa API possuem o parâmetro "BU" (Business Unity) que serve para identificar para qual site aquela informação está sendo enviada. Se o método permitir e você desejar que aquela informação só apareça na Zattini basta enviar a business unity ZT. Para Netshoes basta enviar a business unity NS. Opcionalmente alguns métodos irão solicitar o país, basta enviar BR. Contudo, as duas URL's das nossas API's tanto para Sandbox quanto produção, funcionam para os dois sites.
Não existe um prazo definido, pois envolve etapas de verificação manuais no meio do percurso. Normalmente o prazo é de 2 dias, porém dependendo de alguns casos, pode levar até algumas semanas.
Created (Criado) > Approved (Aprovado) > Invoiced (Faturado) > Shipped (Enviado) > Delivered (Entregue).
Para lojistas, necessário entrar em contato com o analista comercial responsável pela conta e solicitar a chave de acesso. Para integradores ou integração própria deverá passar pela validação técnica.
Não. Depois que o produto estiver em processo de catalogação e disponível para venda, ele não poderá sofrer alterações. Só poderá ocorrer alterações quando o produto encontrar-se no status de 'recebido' ou 'criticado', conforme disponível em: [documentação](/docs/general/regras-e-uso-em-producao#obtenção-do-token-de-produção). Caso necessário em Produção, deverá solicitar a exclusão do produto internamente e cadastra-lo novamente, em Sandbox não é possível nenhuma exclusão, uma vez que via API não é liberada nenhuma ação de exclusão.
Não achou a sua dúvida?
Abrir um chamado