Magazord

A integração entre o ERP Excia e a plataforma Magazord foi desenvolvida para automatizar e sincronizar as principais operações relacionadas a vendas, clientes e produtos, garantindo maior consistência das informações entre os dois ambientes.

Por meio dessa integração, é possível enviar dados do ERP para a plataforma, como cadastro de produtos, preços, estoque e notas fiscais, além de receber retornos relacionados a pedidos, itens e clientes. Dessa forma, as movimentações realizadas no ERP refletem diretamente na Magazord, evitando retrabalhos e falhas de comunicação.

Configuração:

Para configurar a integração com a plataforma Magazord, é necessário solicitar à equipe técnica da Magazord as seguintes informações:

• URL da API da loja do cliente;
• Usuário de autenticação da API;
• Senha/token de autenticação da API.

Além disso, deve ser solicitada a liberação dos seguintes escopos de requisições:

• POST /v1/estoque
• POST /v1/preco
• GET /v2/site/pessoa/{pessoaId}?listaContatos=1&listaEnderecos=1
• GET /v2/faturamento/notaFiscal/{identificador}
• GET /v2/estoqueLocalizacao/deposito
• GET /v2/faturamento/notaFiscal?limit=100&page={pagina}&date={data}&tipo=0
• GET /v2/site/pedido?limit=100&page={pagina}&dataHora[gt]={dataHora}&situacao={situacao}
• GET /v2/site/pedido/{id}/payments
• GET /v2/site/pedido/{codigoPedido}
• POST /v2/site/pedido/{codigoPedido}/notaFiscal
• DELETE /v2/site/pedido/{codigoPedido}/notaFiscal/{chave}
• PUT /v2/site/pedido/{codigoPedido}/notaFiscal/{chave}
• POST /v2/site/categoria
• POST /v2/site/derivacao/{id}/item
• POST /v2/site/marca
• PATCH /v2/site/produto/{codigoProduto}
• POST /v2/site/produto/{codigoProduto}
• PUT /v2/site/produto/{codigoProduto}/derivacao/{codigoDerivacao}
• POST /v2/site/produto/{codigoProduto}/derivacao
• PUT /v2/site/pedido/{codigo}/situacao

Configuração no Excia Plugin

Com as informações fornecidas e todos os métodos liberados, abra o Excia Plugin e acesse a aba Plataforma para realizar a configuração:

• Integrações: selecione a plataforma Magazord;
• Endereço: informe a URL da API fornecida pela Magazord;
• Usuário: informe o usuário de autenticação da API;
• Senha: informe a senha/token de autenticação da API;
• Empresa: informe o patch da empresa em que os pedidos serão inseridos dentro do Excia ERP.

Na mesma aba, no painel Gerenciador do Serviço, é possível configurar o intervalo dos ciclos de integração.

Observação: este intervalo deve ser de no mínimo 15 minutos, garantindo uma integração estável e evitando sobrecarga no servidor onde o serviço está instalado.

Configuração da Aba Informações de Retorno no Excia Plugin

Após a configuração inicial da plataforma, acesse a aba Retorno no Excia Plugin para definir os dados padrões que serão importados para dentro do ERP e ajustar os parâmetros de importação.

Filtro “Tabela”:

Neste filtro é possível selecionar a tabela que receberá os dados fixos.

• Pedidos e Entidades possuem fórmulas específicas para definição da natureza de operação (CFOP), conforme a origem do cliente (dentro ou fora do estado).
  Exemplos de fórmulas:
  • Tabela Pedido – Campo CFOP
    $:UF=(Sigla do Estado),5102.02,6102.02

  • Tabela Entidade – Campo Natureza
    $:UF=(Sigla do Estado),5102.02,6102.02


Painel “Parâmetros para Importação”:

Filtros:

• Data inicial:
  • Na implantação: deve ser definida a data atual.
  • Nas atualizações: serão considerados pedidos com data atual – 30 dias.
• Status do Pedido:
  • Status 4: quando o faturamento ocorre dentro do Excia.
  • Status 7: quando o faturamento ocorre diretamente na Magazord.

Opções:

• Utilizar Preços do Site nos Itens: quando existir preço promocional aplicado ao pedido no site, este valor será importado para o item do pedido.
• Alterar Clientes: permite atualizar dados de entrega, e-mail e telefone do cliente.
• Desconto da Venda do Site: em casos de desconto condicional (voucher ou similar), o valor é importado e aplicado na capa do pedido.
• Estoque: para clientes que utilizam o fluxo de faturamento pela plataforma, define se o estoque será atualizado dentro do Excia ERP.
• Nota Fiscal: permite importar a Nota Fiscal de venda do pedido quando o faturamento é feito na plataforma.

• Nota Fiscal de Devolução: permite importar a Nota Fiscal de devolução do pedido quando o faturamento é feito na plataforma.

Configuração da Aba Informações de Envio no Excia Plugin

Dentro do Excia Plugin, a aba Exportação contém sub-abas e parâmetros que determinam quais informações serão enviadas para a plataforma.

Sub-Abas:

• Depósito do Estoque: Selecione os depósitos que serão enviados à plataforma.
  Observação: É obrigatório enviar pelo menos um depósito.
• Tabelas de Preços: Selecione as tabelas de preços que serão enviadas à plataforma.
  Observação: É obrigatório enviar pelo menos uma tabela de preços.

• Coleções: Selecione as coleções dos produtos que serão integrados à plataforma.
  Observação: Caso nenhuma coleção seja informada, todos os produtos serão enviados.

Painel “Informações para Exportação”

Filtros:

• Cor: Código do grupo de variação de cor do site.

• Tamanho: Código do grupo de variação de tamanho do site.

Opções:

• Produtos: define se o ERP irá cadastrar novos produtos na plataforma.
• Cores/Tamanhos: define se o ERP irá cadastrar novas variações de cores e tamanhos.
• Estoque: define se o ERP irá cadastrar novos depósitos.
• Alterar Descrição Produtos: define se o ERP irá atualizar a descrição dos produtos no site.
• Nota Fiscal: define se o ERP irá cadastrar as notas fiscais de faturamento no site.
• Rastreamento: define se o ERP irá cadastrar o código de rastreio no site.
• Preços: define se o ERP irá atualizar os preços dos produtos.
• Atualizar Categoria Produtos: define se o ERP irá atualizar a categoria dos produtos.
• Marca Produto: define se o ERP irá cadastrar novas marcas no site.
• Salvar Exceção: permite salvar os erros gerados nas integrações.

Envio

No envio de produtos do ERP para a plataforma Magazord, é possível preencher, de forma opcional, alguns campos na aba “E-Commerce” do cadastro de produtos, que podem ser utilizados na integração entre o ERP e a Magazord.

• Referência(id_ecom):  Na plataforma Magazord, este campo é denominado “codigo”, responsável por guardar o identificador do produto principal da plataforma, isso é importante na hora de enviar uma requisição de atualização, método (PATCH), para a plataforma, pois sem essa referência o integrador entende que o produto não existe na plataforma e deve ser enviado como novo.
• Título (titulo): Na plataforma Magazord, este campo é denominado “titulo”, responsável por definir um nome para o produto visualizado na loja do site. A mesma regra vale para o campo ‘tituloComplemento’. O campo ‘nome’ na plataforma Magazord recebe a informação somente quando tiver preenchido, se não estiver preenchido o campo PRODUTO.DESCRICAO, é o que prevalece.
• Descrição(descricao): Na plataforma Magazord, este campo é denominado “descricaoResumida”, responsável por definir uma descrição resumida do produto que vai ser enviado para loja.
• Palavras-Chave(palavra_chave): Na plataforma Magazord, este campo é denominado “palavraChave”, responsável por definir o resumo do conteúdo de um texto para facilitar na hora de pesquisar o produto na loja do site.
• Descrição Detalhada (HTML): Na Magazord, este campo é chamado de “descricao”, nesse campo tem a escolha de descrever de forma mais abrangente sobre o produto(variação) que vai ser enviado para loja do site.

Estoque: O estoque do produto é enviado levando em consideração o parâmetro 20 de vendas no ERP. Que compõe: estoque físico somado com a quantidade em estoque da expedição menos a quantidade reservada para pedidos. para atualização do estoque é levado em consideração o SKU do produto no ERP, considerando o parâmetro 100 do produto.

Preço: O preço parte da tabela TAB_PRECO, filtrando a REGIAO da tabela TAB_PRECO( tabela de preço selecionada no configurador), campo ativo da tabela PA_ITEN deve ser igual a “S”, campo ATIVO da tabela PRODUTO deve ser igual “S” campo TIPO  da tabela TAB_PRECO deve ser igual “P”.

Retorno

Pedido: No retorno verifica o campo PED_CLI da tabela PEDIDO, para verificar se o pedido realmente existe no ERP.

Produto: Para retorno do item é considerado o SKU do item para verificar se existe no ERP.

Cliente: O retorno dos clientes é feito atualização com base bi parâmetro “Alterar Clientes” no configurador”.

XML Nota Fiscal: Para o envio do XML da nota a consulta parte da tabela PEDIDO, relacionado com a tabela NOTA e NOTA_XML.