Perguntas Frequentes

Em Sandbox, ao enviar uma carga de produto, este será aprovado automaticamente?

As regras de aprovação para produto/sku devem ser consultadas em cada Marketplace. Pois cada um utiliza uma forma de validar os produtos/sku enviados para liberar os mesmos nos sites. Em sandbox as informações só podem ser trocadas entre ERP e Integra, nada será enviado para o Marketplace. A comunicação com Markeplace é feita apenas em ambiente de produção.

Se eu enviar um PUT Product para reativar um produto, seus skus serão todos reativados automaticamente? Ou devo enviar reativações separadas para cada.

Existe ativação/inativação de produtos?

Existe o campo de Status para Produto, mas no momento este não é utilizado. Futuramente criaremos a função para que a inativação de produto inative os Skus filhos, e a reativação funcione da mesma maneira.

Como funciona o De/Para de Categorias no Magalu Marketplace?

O Magalu realiza o De/Para de Categorias de forma automática, olhando para os dados de título e descrição dos anúncios. Por isso, é fundamental que seus anúncios tenham um bom título e uma boa descrição. Além disso, o Magalu não utiliza os dados de categoria informados no momento do cadastro do anúncio, assim, recomendamos que seja criada uma categoria genérica para todos os anúncios.

O que acontece se a categorização do Magalu for feita de forma incorreta?

O algoritmo de categorização do Magalu tem rotinas de reverificação de anúncios, assim, de tempos em tempos todos os anúncios são revisitados e recategorizados(se necessário).

Posso inativar apenas um sku de um product?

Sim é possível inativar um ou mais skus de um mesmo produto.

Para apenas inativar ou reativar posso mandar o JSON de put do product ou sku apenas com a propriedade "Status"? Exemplo:

                Body:
                PUT /api/Sku
                {
                "Status": false
                }

Não. É necessário passar o JSON inteiro com o Status false ou true.

Posso enviar alterações de Products/Sku a qualquer momento? Há alguma restrição?

Sim pode enviar alterações de produtos e skus a qualquer momento, lembrando que após um produto já estar à venda no site de um Marketplace, as informações atualizadas serão sempre preço e estoque. Em caso de alteração de cadastro como nome, categoria do produto, descrição, peso etc. Deve ser verificado a política de atualização de produto/ sku para cada marketplace específico. No Magazine Luiza no entanto, não existe restrição, qualquer dado alterado do produto é reenviado, mesmo que o produto ou sku já esteja vendendo no site.

Quais os tamanhos e formatos que podem ser enviados nos skus?

Os campos de Atributo são do tipo string, podendo ser enviados qualquer tipo de tamanho ou formato. Verificar em cada Markeplace se há restrições no tamanho.

Qual o tamanho dos atributos das APIs, especialmente produtos e skus?

No Integra o tamanho é livre, mas é preciso verificar em também em cada Marketplace o tamanho que cada um aceita.

Como funciona o processo de recuperação de pedidos (API GET Order) exatamente?

O processo de recuperação de pedidos vai funcionar na OrderQueue. Na fila OrderQueue haverá os pedidos com status New(Novo pedido do Marketplace ainda não pago) e Approved(Pedidos já aprovados). Os novos pedidos devem ser pesquisados pelo GET passando como parâmetro o status do pedido. Caso não vá trabalhar com os pedidos ainda não pagos, passe como parâmetro sempre o status Approved. Pedidos com Status Approved vem com a data de aprovação. Informação não contida nos pedidos com status New. Após GET na OrderQueue, faça um PUT nesta fila com o Id da OrderQueue, para que o pedido saia desta fila e não apareça nas próximas consultas GET. Altere os status dos pedidos baixados da OrderQueue, por exemplo ao baixar o pedido como APPROVED, altere o status para PROCESSING. Isso fará com que na próxima consulta pela busca de pedidos APPROVED o mesmo não apareça.

Como faço para a cada chamada não retornar os mesmos pedidos que eu já baixei para minha plataforma?

Depois de tratados os pedidos basta fazer um PUT neles e alterar os Status. Assim quando consultar os novos pedidos com Status Approved ou New, você não baixa os pedidos já consultados anteriormente.

No GET Order, o que significa o campo StoreName?

StoreName vai vir sempre como MAGAZINELUIZA para o caso de pedidos provenientes do Magazi- ne Luiza.

Como retorna que o pedido é do Magazine Luiza? A propriedade "MarketPlaceName" terá o valor "Magazine Luiza"?

A propriedade MarketplaceName virá com o valor "magazineluiza"

TelephoneMainNumber e TelephoneSecundaryNumber => O telefone fixo e o celular virão em algum destes campos em específico, ou precisarei identificar quais serão estes?

Não vem discriminado telefone celular ou residencial. Por exemplo, poder vir o celular no MainNumber ou no SecundaryNumber, dependendo do cadastro que o cliente faz no site.

CustomerPjCnpj e CustomerPfCpf => Há casos em que os dois campos serão retornados com valor? E qual é o principal do cliente para inserirmos no pedido, o CNPJ ou CPF?

Se no cadastro no site o cliente se declara como pessoa Jurídica o campo CustomerPjCnpj vem preenchido, caso ele se cadastre como pessoa física o campo CustomerPfCpf vem preenchido. Não há possibilidade dele se cadastrar como pessoa física e jurídica em uma mesma conta.

ReceiverName => É o nome do cliente ou quem irá receber a mercadoria?

É quem irá receber a mercadoria, ou seja, quem efetuou a compra.

Qual é o campo que determina a forma de pagamento do pedido (boleto, cartão de crédito, débito, etc.)?

O campo PaymentType será o responsável por dizer qual foi a forma de pagamento utilizada no pedido.

O que significa o campo "Quantidade" no pedido?

Este campo é a quantidade de produtos no pedido.

Se um pedido é enviado em várias caixas, como isso é representado na API de Pedidos?

Este campo não é contemplado na API.

Como funciona o rastreamento de pedidos na API? É possível enviar dados de rastreamento para o Marketplace?

No momento não há integração para isso, porém futuramente estará disponível.

Qual é a frequência de atualização dos pedidos na fila de pedidos?

Não existe uma frequência definida, os pedidos só sairão da fila quando forem baixados e alterados por PUT, sempre ficarão disponíveis na fila.

É necessário chamar o endpoint para verificação de novos pedidos constantemente?

Sim, para receber os pedidos na OrderQueue você deve ficar sempre fazendo GET na fila.

Se eu baixar o mesmo pedido duas vezes, ele será duplicado em minha plataforma?

O pedido aparece só uma vez na fila e ao dar PUT ele sai da fila, se ele ainda estiver no status New na próxima consulta ele estará novamente disponível para consulta.

Posso fazer download da etiqueta pela API?

Não existe integração na API para isso, porém futuramente estará disponível.

Como sei que a minha aplicação foi homologada?

Após a homologação técnica você receberá um email comunicando a homologação e pedindo para enviar sua logo em PNG, após este envio nossa equipe do Acelera com Magalu irá listar sua aplicação como homologada no nosso Portal de Integrações.

Como devo proceder se houver uma falha técnica durante o processo de homologação?

Se houver alguma falha técnica durante o processo de homologação, você deve informar ao seu consultor da Magalu ou abrir um chamado no nosso portal de atendimento.

Posso homologar mais de uma aplicação para o Magalu Marketplace?

Sim, pode homologar quantas aplicações você desejar, para isso basta cadastrar cada aplicação no Acelera com Magalu e seguir o passo a passo de cada módulo.

Preciso homologar novamente se eu realizar alguma alteração na minha aplicação?

Não é necessário homologar novamente, apenas se houver alguma mudança técnica significativa.

Quanto tempo leva o processo de homologação?

O tempo do processo de homologação depende da entrega das informações necessárias pela sua equipe, porém em média o processo leva 15 dias para ser concluído após a entrega de todas as informações solicitadas.

Qual o status do pedido após ser aprovado?

Pedido aprovado está com o status de Approved, porém isso pode variar de Marketplace para Marketplace.

Como deve ser feito o cálculo do frete para cada pedido?

O cálculo do frete deve ser feito utilizando o módulo de cálculo de frete que está na API do Magalu. Atenção, o cálculo de frete deve ser feito no momento da inclusão do produto no carrinho, após o cliente finalizar a compra o frete é cadastrado na OrderQueue com o valor do frete que foi calculado no momento da inclusão do produto no carrinho.

Quantos pedidos podem ser feitos por minuto para o Magalu?

Não há um limite de pedidos por minuto, porém é importante respeitar os limites de requisições definidos para cada endpoint na API.

Como é feito o controle de estoque entre a minha loja e o Magalu?

O controle de estoque é feito de forma integrada entre a sua loja e o Magalu através da API. Sempre que houver uma venda no Magalu o estoque do seu sistema deve ser atualizado através da API. Sempre que houver uma venda no seu sistema o estoque do Magalu deve ser atualizado através da API.

Posso subir uma lista de produtos de uma só vez?

Sim, é possível subir uma lista de produtos de uma só vez, porém é importante respeitar os limites de requisições definidos para cada endpoint na API.

Há restrição para os dados dos produtos que eu posso subir?

Sim, é importante respeitar os padrões de cadastro definidos na API para cada endpoint.

Como é feito o rastreamento de pedidos após a compra?

No momento não existe integração para isso, porém futuramente estará disponível.

Qual é o formato dos arquivos que podem ser enviados pela API?

O formato dos arquivos que podem ser enviados pela API é JSON.

Posso enviar anúncios de produtos com fotos em formato .PNG?

Sim, é possível enviar anúncios de produtos com fotos em formato PNG, porém é importante respeitar os padrões de cadastro definidos na API para cada endpoint.

Há alguma documentação sobre a API do Magalu?

Sim, a documentação da API do Magalu está disponível na Swagger. Você pode acessar a documentação através do link - https://api.integracommerce.com.br/swagger/index.html

Qual é a URL da documentação da API?

A URL da documentação da API do Magalu é - https://api.integracommerce.com.br/swagger/index.html

É possível subir uma lista de produtos em formato .CSV?

Não, o formato de upload de produtos é JSON.

Há alguma biblioteca específica para usar a API do Magalu?

Não, não existe uma biblioteca específica para usar a API do Magalu.

Qual é o procedimento para se tornar um parceiro do Magalu?

O procedimento para se tornar um parceiro do Magalu é se cadastrar no Acelera com Magalu, fazer o cadastro da sua aplicação e seguir o passo a passo de cada módulo.

Há algum tutorial disponível para ajudar na integração da API do Magalu?

Sim, existem vários tutoriais disponíveis para ajudar na integração da API do Magalu. O link dos tutoriais está disponível na documentação da API.

Posso fazer uma chamada POST para criar produtos e depois atualizar eles via PUT?

Sim, é possível criar os produtos através de uma chamada POST e depois atualizá-los via PUT, porém é importante respeitar os limites de requisições definidos para cada endpoint na API.

Como devo proceder após finalizar a integração da minha aplicação?

Após finalizar a integração da sua aplicação você deve fazer a homologação da mesma com o Magalu e abrir um chamado no portal de atendimento para solicitar a liberação da sua aplicação em ambiente de produção.

A API do Magalu é pública?

Não, a API do Magalu é privada, ou seja, é necessário ter um cadastro no Acelera com Magalu para poder utilizar a API.

O que é o Acelera com Magalu?

O Acelera com Magalu é um programa de parcerias do Magalu que tem o objetivo de trazer mais agilidade e eficiência para o dia a dia dos parceiros e colaboradores, permitindo que as empresas possam desenvolver soluções que tragam ainda mais resultados para o negócio.

Como faço para me cadastrar no Acelera com Magalu?

Para se cadastrar no Acelera com Magalu você deve acessar o site - https://aceleracom.magazineluiza.com.br/ e clicar na opção de cadastro.

Como faço para solicitar acesso à API do Magalu?

Para solicitar acesso à API do Magalu você deve se cadastrar no Acelera com Magalu e fazer o cadastro da sua aplicação.

Qual é o prazo de validade do token de acesso à API?

O prazo de validade do token de acesso à API do Magalu é de 60 dias, porém é possível renovar o token antes do vencimento do mesmo.

Qual é o formato da data que é retornado pela API do Magalu?

O formato da data que é retornado pela API do Magalu é - YYYY-MM-DDThh:mm:ss+hh:mm.

Qual é o tempo de expiração do token de acesso à API?

O tempo de expiração do token de acesso à API do Magalu é de 60 minutos.

Qual é o tempo de expiração do token de acesso à API?

O tempo de expiração do token de acesso à API do Magalu é de 60 minutos.

Existe um valor mínimo de pedidos por mês para ter acesso à API do Magalu?

Não, não existe um valor mínimo de pedidos por mês para ter acesso à API do Magalu.

Como faço para solicitar uma chave de acesso à API?

Para solicitar uma chave de acesso à API do Magalu você deve se cadastrar no Acelera com Magalu e fazer o cadastro da sua aplicação.

É possível configurar um callback para notificar minha aplicação sobre pedidos e produtos?

Não, a API do Magalu é totalmente passiva nas integrações, ou seja, não enviamos nenhum tipo de notificação de eventos para pedidos e produtos.

Como posso receber informações sobre novos pedidos?

Através da OrderQueue você consegue acessar os pedidos com status New(novos pedidos ainda não pagos) e Approved(Pedidos aprovados).

É possível alterar o status de um pedido através da API?

Sim, é possível alterar o status de um pedido através da API do Magalu.

Quais são os status de um pedido?

Os status de um pedido são: New, Approved, Processing, Shipped, Delivered, Cancelled.

O que significa o status de um pedido?

- New: Novo pedido do Marketplace ainda não pago.
- Approved: Pedido aprovado.
- Processing: Pedido em processamento.
- Shipped: Pedido enviado.
- Delivered: Pedido entregue.
- Cancelled: Pedido cancelado.