(Desenvolvimento) Magento

Documentação e suporte

• https://developer.adobe.com/commerce/webapi/rest/quick-reference/
• Suporte Magento;
  • Colocar numero aqui
• Tem ambiente de homologação?
  • Não

Autenticação

• URL API: Informado pelo cliente através da Climba.

• Usuario: Informado pelo cliente através da Magento.

• Senha: Informado pelo cliente através da Magento.

O que é sincronizado?

• Envio de marcas;

• Envio de categorias (grupos);

• Envio de itens;

• Busca de pedidos;

• Busca de clientes. 

• Envio de nota fiscal de saída;

Envio de marcas

Regras para envio

• • Somente marcas Ativas.

  • Somente marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro da marca (Data de atualização do cadastro da marca for maior que a data da última sincronização da marca).

Opções na Configuração

• • Se o parâmetro "Exporta Marcas específicas" estiver marcado: 

    • Serão enviadas somente as marcas informadas na aba "Marcas". 

    • Permite fazer um De/Para das marcas específicas inserindo id da categoria da Climba na coluna "Cód. E-commerce". (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tratamento de retorno

Envio de categorias

Regras para envio

• • Somente grupos ou catálogos Ativos.

  • Somente grupos ou catálogos com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou alteração no cadastro do grupo ou catálogo (Data de atualização do cadastro do grupo ou catálogo for maior que a data da última sincronização do grupos ou catálogos).

Opções na Configuração

• • O parâmetro "Tipo exportação categoria" decide se serão enviados os Grupos ou Catálogos do ERP.

  • Se o parâmetro "Exporta Grupos específicos" estiver marcado: 

    • Serão enviadas somente os grupos informados na aba "Grupos". 

  • Se o parâmetro "Exporta Catálogos específicos" estiver marcado: 

    • • Serão enviadas somente os catálogos informados na aba "Catálogos". 

  • Permite fazer um De/Para dos catálogos específicos inserindo id da categoria da Climba na coluna "Cód. E-commerce".  (Deve ser solicitado para a Climba os IDs)

Dados enviados

Tratamento de Retorno

Envio de itens simples

Regras para envio

• • Somente itens com o campo "Exporta para Climba" marcado.

  • Somente itens vinculados a marcas com o campo "Exporta para Climba" marcado.

  • Primeira sincronização ou, alteração no estoque do item ou, alteração no preço do item, ou qualquer alteração no cadastro do item (Data de atualização do cadastro do item for maior que a data da última sincronização do item).

  • Antes de enviar um item novo, é realizada a busca por esse item na Clima, se encontrar um <SKU> na climba com o mesmo <Id do item no ERP>, são enviados os dados para atualização (PUT).

Opções na Configuração

• • SKU: o campo "SKU do produto" define se o SKU será  o iditem ou referencia.

  • Nome: o campo "Descrição do item" define o campo do item que será enviado.
    • Descrição, descrição técnica, observação ou complemento
  • Preço: o campo "Utilizar" define qual o preço que será enviado:
    • Preço de pauta da filial: deve ser informada a "Filial".
    • Tabela de preço específica: deve ser informada a Tabela de preço" .
  • Estoque: o campo "Depósito" indica os depósitos que serão somados para enviar a quantidade em estoque.
    • O campo "Abate quantidade reservada do saldo disponível", se marcado, será descontado o saldo já reservado no ERP.
    • O campo "% Envio estoque", indica o percentual do estoque que será enviado.
    • Respeita o campo "Qt. Múltiplo" do cadastro do item.

Dados enviados

Tratamento de Retorno

Envio das fotos do itens simples

Regras para envio

• • Envia fotos de itens com o campo "Exporta para Climba" marcado e vinculados a uma marca também marcada para enviar.
  • Parâmetro "Sincroniza fotos" marcado.
  • Primeira sincronização de fotos do item ou alteração nas fotos do item (Data de atualização de fotos maior que a data da última sincronização das fotos).
  • Deleta todas as fotos do item na Climba e envia todas as fotos do item no ERP.

Tratamento de Retorno

Busca de pedidos

Regras

• • Busca somente pedidos em aberto na Climba. (status = 2)

Opções na Configuração

• • Transação: 
    • Informado no cadastro de E-commerce conforme imagem Clique aqui!
  • Filial:
    • Informado no cadastro de Filial conforme imagem Clique aqui!
  • Responsável Notificação:
    • Informa usuário padrão que irá receber notificações dos pedidos criados no ERP.
  • Método e condições de pagamento:
    • Fazer De/para dos metodos/condicoes e parcelas da Climba.
    • Informar padrão.
    • Se não tiver nenhum acima informado pega do cliente.
  • Vendedor:
    • Informa padrão.
    • Se não tiver nenhum acima pega do cliente.
  • Transportadora:
    • Fazer De/para das transportadoras da Climba.
    • Informa padrão.

Dados usados para criar o pedido

Item do pedido

Regras

• • Somente Itens com SKU correspondente no ERP (iditem ou referencia).

Dados usados para criar os itens

Cliente do pedido

Regras 

• • Insere novo cliente no ERP;
  • Se existir cliente no ERP com o campo "Cód Climba" igual ao "id" retornado pela Climba, somente altera os dados.

  • Procura Cidade + UF sem acentos, se não achar, procura Cidade + UF igual o retorno, se não achar, cria uma nova cidade no ERP. 

  • Se não retornar tag IE, o IE e IM no ERP será "ISENTO".

Opções na Configuração

• • Tipo do cliente pode ser padronizado nas configurações pelo campo "Tipo Cliente".

Dados usados para criar o cliente

Envio de Nota fiscal

Regras 

• • Busca somente as notas fiscais de saída de pedidos sincronizados (origem = 3).
  • Somente Notas fiscais de saída finalizadas (status = 2).

Opções na Configuração

• • Permite fazer De/para do operador logístico da transportadora.

Dados enviados