Documentação - Acelera Magalu

Introdução API em Homologação

Autenticação Oauth2 Criação conta ID Magalu Criação da API Key Criação do Client Consentimento de Acesso Troca do Code pelo Token Refresh Token

Api de Sac Buscar Tickets de Atendimento Ticket por Limit Ticket por Pedido Detalhes do Ticket Enviar Mensagen ao Ticket Autorizar Estorno de Ticket

PUT Price

Este recurso serve para realizar a atualização de preços dos anúncios no Magalu Marketplace. Recomendamos que sempre utilize este método para realizar a atualização de preço, pois ele é mais performático para este tipo de ação. O recurso aceita até 100 itens por requisição.


curl -X 'PUT' \
  'https://in.integracommerce.com.br/api/Price' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json-patch+json' \
  -d '[
  {
    "idSku": "abc123",
    "listPrice": 10,
    "salePrice": 10
  }
]'

POST Product

Este recurso permite a criação do produto pai e é obrigatório para a criação de anúncios no Magalu Marketplace. Certifique-se de fornecer todas as informações necessárias conforme o modelo JSON apresentado.


curl -X 'POST' \
  'https://in.integracommerce.com.br/api/Product' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
  "idProduct": "string",
  "name": "string",
  "code": "string",
  "brand": "string",
  "nbmOrigin": "string",
  "nbmNumber": "string",
  "warrantyTime": "string",
  "active": true,
  "categories": [
    {
      "id": "string",
      "name": "string",
      "parentId": ""
    }
  ],
  "marketplaceStructures": [],
  "attributes": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}'

PUT Product

Este recurso serve para atualizar as informações de um produto no Magalu Marketplace. Certifique-se de fornecer o ID do produto que será atualizado e todas as informações necessárias conforme o modelo JSON apresentado.


curl -X 'PUT' \
  'https://in.integracommerce.com.br/api/Product' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
  "idProduct": "a",
  "name": "string",
  "code": "string",
  "brand": "string",
  "nbmOrigin": "string",
  "nbmNumber": "string",
  "warrantyTime": "string",
  "active": true,
  "categories": [
    {
      "id": "string",
      "name": "string",
      "parentId": "string"
    }
  ],
  "marketplaceStructures": [
    {
      "id": "string",
      "name": "string",
      "parentId": "string"
    }
  ],
  "attributes": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}'

GET Product By Id

Este recurso serve para recuperar as informações de um produto específico com base no seu ID.


curl -X 'GET' \
  'https://in.integracommerce.com.br/api/Product/1' \
  -H 'accept: */*'

GET Product All

Este recurso serve para recuperar todos os produtos cadastrados. Você pode aplicar filtros adicionais conforme necessário.


curl -X 'GET' \
  'https://in.integracommerce.com.br/api/Product?page=1&perPage=10' \
  -H 'accept: */*'

Aqui está o trecho formatado conforme o padrão fornecido: ```html

POST SKU

SKU
Este recurso permite a criação do sku, que deve ser obrigatoriamente associado a um produto pai. Conforme explicado acima, o Magalu segue uma lógica de associação de produtos pai com SKU filho. Assim, a criação de um anúncio deve seguir o modelo abaixo

POST SKU
Rota - (API Magalu Identity Provider) /api/SKU

API Magalu Identity Provider
Homologação - https://api.integracommerce.com.br
Produção - https://in.integracommerce.com.br

Padrões de Cadastro
-IDSKU - Até 32 caracteres, não sendo permitido espaço, underline, vírgula e barra.
-Nome - Recomendado até 100 caracteres.
-NBM - 0(zero) para produto nacional e 1(um) para produto importado
-Descrição - Aceita apenas as tags HTML <br> para quebra de linha e <b> para negrito. Limite de 5000 caracteres.
-Medidas - em quilos e metros.
-Attributes - Valores exclusivos de cada variação, como Cor, Tamanho, Voltagem, Sabor e etc.
-Imagens - HTTP ou HTTPS, sendo PNG ou JPG, com no mínimo 800p x 800p e no máximo 2500p x 2500p e até 16MB. URL de imagem deve ter até 255 caracteres e cada produto deve ter no mínimo 1 imagem e no máximo 30.


curl -X 'POST' \
  'https://in.integracommerce.com.br/api/Sku' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
  "idSku": "string",
  "idProduct": "string",
  "name": "string",
  "description": "string",
  "height": 0,
  "width": 0,
  "length": 0,
  "weight": 0,
  "codeEan": "string",
  "codeNcm": "string",
  "codeIsbn": "string",
  "codeNbm": "string",
  "variation": "string",
  "status": true,
  "price": {
    "listPrice": 0,
    "salePrice": 0
  },
  "stockQuantity": 0,
  "mainImageUrl": "string",
  "urlImages": [
    "string"
  ],
  "attributes": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "fulfillment": true
}'

PUT SKU
Rota - (API Magalu Identity Provider) /api/SKU

API Magalu Identity Provider
Homologação - https://api.integracommerce.com.br
Produção - https://in.integracommerce.com.br


curl -X 'PUT' \
  'https://in.integracommerce.com.br/api/Sku' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
  "idSku": "string",
  "idProduct": "string",
  "name": "string",
  "description": "string",
  "height": 0,
  "width": 0,
  "length": 0,
  "weight": 0,
  "codeEan": "string",
  "codeNcm": "string",
  "codeIsbn": "string",
  "codeNbm": "string",
  "variation": "string",
  "status": true,
  "price": {
    "listPrice": 0,
    "salePrice": 0
  },
  "stockQuantity": 0,
  "mainImageUrl": "string",
  "urlImages": [
    "string"
  ],
  "attributes": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "fulfillment": true
}'

GET SKU By Id
Rota - (API Magalu Identity Provider) /api/SKU/{IdSKU}

API Magalu Identity Provider
Homologação - https://api.integracommerce.com.br
Produção - https://in.integracommerce.com.br


curl -X 'GET' \
  'https://in.integracommerce.com.br/api/Sku/a' \
  -H 'accept: */*'

GET SKU All
Rota - (API Magalu Identity Provider) /api/SKU/{filter}

API Magalu Identity Provider
Homologação - https://api.integracommerce.com.br
Produção - https://in.integracommerce.com.br


curl -X 'GET' \
  'https://in.integracommerce.com.br/api/Sku?page=1&perPage=10' \
  -H 'accept: */*'

PUT Stock

STOCK
Este recurso serve para realizar a atualização de estoque de seus skus. Recomendamos que toda a atualização de estoque seja feita através deste recurso, uma vez que, este recurso é mais performático para esta ação. É possível atualizar até 100 skus por requisição

PUT Stock
Rota - (API Magalu Identity Provider) /api/SKU/{filter}

API Magalu Identity Provider
Homologação - https://api.integracommerce.com.br
Produção - https://in.integracommerce.com.br

Detalhes da Requisição
Parâmetros
-IdSKU - informe o id do sku em questão
-quantity - informe a nova quantidade de estoque


curl -X 'PUT' \
  'https://in.integracommerce.com.br/api/Stock' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json-patch+json' \
  -d '[
  {
    "idSku": "1",
    "quantity": 10
  }
]'

SISTEMAS DE FILA

Conforme explicado acima, a API do Magalu é totalmente passiva nas integrações, de modo que, não enviamos nenhum tipo de notificação de eventos(nem para produtos e nem para pedidos). Assim, a gestão de pedidos novos, aprovados e cancelados é feito através de uma fila dedicada para estes tipos de pedidos. Sua aplicação deve ser capaz de ler e atualizar a fila de pedidos, para assim não capturar pedidos duplicados a cada nova consulta na fila. Segue abaixo um modelo da dinâmica de funcionamento da fila de pedidos.

HOMOLOGAÇÃO

O processo de homologação de aplicações no Magalu Marketplace é segmentado por módulos, de modo que, você pode homologar quais módulos considerar necessários para aplicação/segmento de negócio. Conforme explicado na seção Introdução, temos 5 módulos disponíveis na API, sendo eles: Módulo de Produto e Pedidos, Módulo de Frete, Módulo de Etiquetas do Magalu Entregas, Módulo de Fulfillment e Módulo de Migração Direta.

OBS - Temos um processo de homologação específico para cada módulo. Para homologar sua aplicação com algum módulo realize o seu cadastro no Acelera com Magalu, marcando a opção de módulo desejada. Esta seção irá focar no processo de homologação do módulo de produtos e pedidos especificamente.

Após o cadastro no Acelera com Magalu, o time SRE Integradores irá gerar todos os acessos necessários para início dos testes. Após a criação dos acessos, o time irá enviar através de um chamado em nossa ferramenta de ITSM. Este chamado sempre é vinculado ao email utilizado no cadastro do Acelera com Magalu. Estando com os dados, você deve começar sua homologação pela autenticação:

-Crie sua conta no IDMagalu
-Gere sua API Key
-Crie seu client em sandbox
-Teste o recebimento dos dados OAuth2 do seller teste(lembrando que informaremos dados basic e você deve migrar para OAuth2)
-Utilize os recursos OAuth2 disponíveis dentro de nossa API para realizar a migração do Basic para o OAuth2
-Link Swagger Sandbox - https://api.integracommerce.com.br/swagger/index.html
-Realize chamadas na API de Sandbox

Concluída a parte da autenticação, você deve começar a criação e atualização de anúncios:

-Realize as chamadas em sandbox seguindo a lógica explicada nos módulos de Product e SKU
-Link FAQ de cadastro de anúncios - Link 1 - Link 2

Concluída a criação e atualização de anúncios, você deve começar o tracking de pedidos:

-Realize a criação de pedidos em sandbox utilizando os produtos cadastrados anteriormente.
-Avise nosso time via chamado que você ja criou os produtos e precisa testar a fila.
- Nosso time irá inserir os produtos na fila e, a partir daí, você consegue consumi-los via OrderQueue.

- Por fim, deixe um pedido em cada um dos status, lembre-se de informar os dados obrigatórios do pedido em cada um dos status.

Concluída a etapa dos pedidos, sua aplicação estará homologada e realizaremos alguns cadastros aqui do nosso lado

-Acelera com Magalu - iremos listar sua aplicação como homologada em nosso Portal de Integrações. Aqui você precisa enviar uma imagem da sua logo em PNG para inserirmos no Acelera com Magalu.
- Est reitamento comercial - finalizada as partes técnicas da homologação, direcionamentos sua empresa para o time comercial de parcerias começar o estreitamento comercial com sua empresa.

Introdução

Autenticação

Produtos

Pedidos

Sac

FAQ - Perguntas Frequentes