Magecommerce - API - Utilização

A seguir, você encontrará detalhes sobre como utilizar a integração da Magecommerce no ERP para gerenciar seus pedidos, estoque e outras funcionalidades. É importante ressaltar que esta integração foi desenvolvida pelo time da Magecommerce, utilizando nossa API. Portanto, a responsabilidade pelo processamento das informações recai sobre a plataforma Magecommerce, enquanto o ERP atua como fornecedor dos dados por meio das URLs configuradas.

Como enviar produtos do ERP para a plataforma?

Você acessa menu → cadastros → produtos, identifica os produtos desejados, seleciona os mesmos e clica em enviar para o e-commerce. Na tela seguinte, você seleciona a integração de destino do envio e, se desejar, poderá selecionar as opções Atualizar estoque no e-commerce (para enviar o estoque do produto no ERP junto com os demais dados) e Parar o envio em lote caso algum produto seja rejeitado (Para que o envio seja interrompido ao ser encontrado erro em algum produto). Clicando em avançar, será aberta uma tela para verificação das informações a serem enviadas e confirmar o envio dos produtos clicando em enviar.

Campos enviados:

• Código SKU
• Descrição
• Descrição complementar
• Preço
• Preço promocional
• Preço de custo
• Estoque
• GTIN
• GTIN embalagem
• Marca
• Peso bruto
• Peso líquido
• Altura
• Largura
• Comprimento
• Diâmetro
• Imagens
• Variações
• Garantia
• Atributos
• NCM
• CEST
• Origem
• Estoque mínimo
• Unidade
• Situação
• Título para SEO
• Descrição para SEO
• Keywords para SEO
• Link do vídeo
• Slug
• Observações
• Tags
• Linha de produto
• Código do fornecedor
• Categoria principal

Observação:

Devido esta ser uma integração de terceiros, é essencial observar que, caso o retorno da plataforma não esteja conforme o padrão recomendado pela API, a criação adequada do anúncio não será possível. Isso implica que a transmissão de informações cruciais, como preço e estoque, para esses itens, pode ser comprometida.

Como receber produtos da plataforma no ERP?

Atualmente, esta integração é desenvolvida pela equipe da plataforma, através das APIs disponíveis do ERP, sendo assim, o ERP atua na mesma apenas disponibilizando os dados para que a plataforma possa efetuar o processamento dos mesmos e recebendo aqui os dados enviados pela plataforma.

A recepção dos produtos cadastrados na plataforma no ERP, ocorre de forma passiva, ou seja, esta ação ocorre por meio do painel da plataforma, onde os mesmos executam por lá a ação de envio dos dados dos produtos para o ERP. Neste caso, sugerimos verificar o processo de envio junto ao time da plataforma.

Como enviar estoque dos produtos do ERP para o e-commerce?

Individual:

Para enviar o estoque de um produto de forma individual para plataforma, basta acessar menu → cadastros → produtos, identificar o produto desejado, clicar no menu de contexto (...) ao lado esquerdo do mesmo e selecionar a opção enviar estoque ao e-commerce.

Na tela seguinte, irá selecionar a plataforma de destino do envio, qual saldo de estoque deseja enviar, físico ou disponível, e por fim selecionar a opção selecionar.

Por fim, serão apresentados os dados a serem enviados para conferência e basta clicar em enviar, para que o envio dos dados seja efetuado.

Em lote:

Para efetuar um envio de estoque em lote para a plataforma, basta acessar menu → cadastros → produtos, identificar os produtos desejados, selecionar os mesmos, clicar em mais ações e selecionar a opção enviar estoque ao e-commerce.

Na tela seguinte, irá selecionar a plataforma de destino do envio, qual saldo de estoque deseja enviar, físico ou disponível, e por fim selecionar a opção selecionar.

Por fim, serão apresentados os dados a serem enviados para conferência e basta clicar em enviar, para que o envio dos dados seja efetuado.

Automático:

Nesta integração, temos disponível também a opção de configuração para que o estoque dos produtos seja disponibilizado para a plataforma sempre que houver alterações no ERP, ou seja, sempre que o estoque de um produto sofrer alteração, o mesmo será enviado automaticamente para a plataforma.
Para isso, basta efetuar a configuração mencionada no tópico Passo 1 - Regras de Estoque da Etapa 2 - Produtos mencionada no manual de configurações da integração no ERP.

Observações:

• Para que o envio de estoque possa ser efetuado, é necessário que o seu produto do ERP esteja mapeado adequadamente com o anúncio correspondente na plataforma.
• Por esta ser uma integração API, no envio de estoque, o ERP apenas disponibiliza para a plataforma, através da URL configurada, os dados de estoque. O consumo e processamento dos dados é de responsabilidade da plataforma.
• É importante que o campo URL de notificações do estoque esteja preenchido nas configuraçoes da integração no ERP, para que o envio do estoque ocorra corretamente.
• A opção Enviar saldo disponível é apresentada somente quando existe o módulo de Reservas de estoque instalado na conta.
• Lançamentos de balanço de estoque gerados a partir de importações de produtos de plataformas, não geram sincronização de estoque automática.

Como enviar preço dos produtos no ERP para o e-commerce?

O envio de preços, pode ser efetuado de duas formas diferentes.

Individual:

Para enviar o preço de um produto de forma individual para plataforma, basta acessar menu → cadastros → produtos, identificar o produto desejado, clicar no menu de contexto (...) ao lado esquerdo do mesmo e selecionar a opção enviar preços para o e-commerce.

Na tela seguinte, irá selecionar a plataforma de destino do envio e clicar na opção selecionar. Em seguida será aberta uma tela com o resumo das informações a serem enviadas para que faça a conferência.

E por fim clique em enviar, para que os dados sejam enviados para a plataforma processar.

Em lote:

Para efetuar um envio de preços em lote para a plataforma, basta acessar menu → cadastros → produtos, identificar os produtos desejados, selecionar os mesmos, clicar em mais ações e selecionar a opção enviar preços para o e-commerce.

Na tela seguinte, irá selecionar a plataforma de destino do envio e clicar na opção selecionar. Na tela seguinte, será demostrado um resumo das informações a serem enviadas, para que faça a conferência das mesmas.

E por fim clique em enviar, para que os dados sejam enviados para a plataforma processar.

Observações:

• Para que o envio de preços possa ser efetuado, é necessário que o seu produto do ERP esteja mapeado adequadamente com o anúncio correspondente na plataforma.
• Por esta ser uma integração API, no envio de preços, o ERP apenas disponibiliza para a plataforma, através da URL configurada, os dados de preço. O consumo e processamento dos dados é de responsabilidade da plataforma.
• Os preços enviados serão considerados no envio, conforme a opção configurada no tópico de Preços, aba Produtos, nas configurações da integração da plataforma no ERP.

Como receber pedidos no ERP?

A funcionalidade de importação de pedidos de venda foi desenvolvida pelo plataforma e é realizada de forma automática. Ou seja, a plataforma faz o envio dos pedidos para o sistema e aqui no ERP você irá identificar estes pedidos em menu → vendas → pedidos de venda.

Caso haja dúvidas sobre o processo de importação de pedidos da plataforma para o ERP, ou então, referente aos dados importados nos pedidos, poderá verificar juntamente ao time da sua plataforma.

Observação:

Sempre que um pedido é importado para o ERP, o cliente informado no mesmo é automaticamente cadastrado no sistema, em cadastros → clientes e fornecedores.

Como enviar os dados das NF-es do ERP para a plataforma?

Em notas fiscais:

Você deve acessar menu → vendas → notas fiscais, identificar as notas desejadas, selecionar as mesmas, clicar em mais ações e em seguida selecionar a opção enviar dados da NFe para e-commerce.

Na expedição:

Você deve acessar menu → vendas → expedição, identificar a expedição desejada e abrir a mesma para edição, e em seguida clicar no menu de contexto (...) ao lado esquerdo do pedido/nota que deseja enviar os dados.

Por fim, deverá selecionar a opção enviar chave de acesso para o e-commerce.

Observação:

É necessário que haja uma nota fiscal gerada e autorizada vinculada ao objeto da expedição para que os dados possam ser enviados com sucesso.

Como enviar um rastreamento do ERP para a plataforma?

Individual:

Você poderá acessar menu → vendas → expedição, identificar a expedição desejada, abrir a mesma para edição, identificar o pedido/nota desejado, clicar no menu de contexto (...) ao lado esquerdo do mesmo e selecionar a opção enviar código de rastreio para e-commerce.

Em lote:

Você poderá acessar menu → vendas → expedição, identificar a expedição desejada, clicar no menu de contexto (...) ao lado esquerdo da mesma e selecionar a opção enviar códigos de rastreio para e-commerce.

Ou então, poderá abrir a expedição, clicar em mais ações e selecionar a opção enviar códigos de rastreio para e-commerce.

Automático:

Nesta integração, temos disponível também a opção de configuração para que os rastreamentos dos pedidos/notas sejam disponibilizados para a plataforma sempre que um pedido for marcado como enviado no ERP, ou seja, sempre que o pedido de venda tiver sua situação alterada para Enviado, o rastreamento será enviado automaticamente para a plataforma, se preenchido.
Para isso ocorrer corretamente, basta efetuar ativar o parâmetro Enviar rastreamento ao alterar a situação no ERP para enviado encontrado nas configurações da integração no ERP, conforme mencionado no tópico Passo 1 - Fluxo de Pedidos da Etapa 3 - Pedidos, do manual de configurações da plataforma.

Observações:

• Para que o envio do rastreamento ocorra com sucesso é importante que o mesmo esteja preenchido no pedido/nota.
• Também é necessário que o campo URL para envio do rastreio esteja preenchido nas configurações da integração no ERP, para que o sistema possa disponibilizar a informação para a plataforma consumir.
• É importante lembrar que, o ERP apenas disponibiliza as informações para que a plataforma consuma e processe, ou seja, nós fornecemos os dados para a plataforma, a responsabilidade de consumir os dados e apresentar os mesmos no painel, é da plataforma.

A integração da plataforma Magecommerce no ERP simplifica a recepção de pedidos, gerenciamento de produtos e atualização de estoques. Ao unir as funcionalidades da plataforma Magecommerce com a estrutura do ERP, empresas ganham eficiência operacional, agilizando processos essenciais para o dia a dia do negócio. Essa integração oferece uma solução prática para otimizar operações comerciais de forma direta e eficaz! 

Para mais detalhes sobre a configuração da integração da Magecommerce no ERP, acesse Magecommerce - API - Configurações.