CONTEÚDO
01. VISÃO GERAL
O conector do Magento possue 2 fluxos distintos de funcionamento que depende do COD_ISO configurado para o site do canal e para o site principal.
Importante que o Site no Omni seja configurado com COD_ISO = BRA.
02. Funcionamento
A seguir os métodos/operação que o conector opera na integração Omni/Magento:
- updateMasterData: Este método prepara a estrutura do Magento com as Marcas e Categorias relacionadas aos produtos disponíveis no site do Omni.
Este método pode ser executado em qualquer publicação, e afetará a instância do Magento. - insertProducts: Para publicar produtos que foram incluídos na publicação (seja nova publicação ou pré existente) deve-se executar esta operação.
Esta operação também sobe as fotos presentes no Omni para o Magento.
Os produtos são sempre cadastrados no seller principal do Magento. - updateProducts: Quando há modificações nos produtos (modificações de atributos - fora estoque e preço) esta operação atualiza o produto que já está publicado no Magento.
- updateStock: Atualiza o estoque dos produtos de acordo com os cenários suportados (vide 01. Visão Geral). O estoque pode ser atualizado diretamente no seller principal,
para cada seller (no caso de multi-seller) ou nas docas.
Importante que os IDs das lojas cadastradas no TOTVS Omni seja configuradas no conector com o ID do seller/doca (Vide 03. Parâmetros de Credenciais e 04. Parâmetros de Propriedades). - updatePrices: Atualiza o preço dos produtos no seller central.
- eliminarPublicaciones: Remove produtos do Magento, desde que o produto não esteja mais em nenhuma publicação do canal.
- importOrders: Baixa para o Omni os pedidos de Magentoque estão no status "ready-for-handling" no Magento.
Este método pode ser executado a partir de qualquer publicação. - sendStatusOrders: Atualiza os pedidos do Omni no Magento, subindo informação sobre fatura (para pedidos que já foram faturados) e número de rastreamento (pedidos que já foram acionado a logística), além do status do pedido no Omni (Vide fluxos em Layout Email Notificacao Omni).
Este método pode ser executado a partir de qualquer publicação.
Ao final de cada operação o Omni gera um relatório da execução, informando se todos os produtos da publicação foram integrados ou não.
03. PARAMETROS DE CREDENCIAIS
A seguir os parametros de credencial do conector Magento e descrição de como configurar-los.
Parâmetro da Credencial | Descrição | Formato do Parâmetro, Exemplo e Observações |
---|---|---|
Flag de Controle is-in-stock para Produto Base | Formato: Texto Valores possíveis: True ou False | |
MAGENTO_ESTADOS_PEDIDOS_PAGADOS | Lista de status utilizados na consulta de pedidos que o conector faz no Magento. | Formato: Texto Exemplo: processing,pedido_pago,em_separacao,pedido_faturado |
MAGENTO_HOST | Host do Magento | Formato: Texto |
MAGENTO_ID_WEB_sITE | Id do WebSite do Magento | Formato: Texto |
MAGENTO_PASSWORD | Senha de acesso do usuário à API do Magento. | Formato: Texto |
MAGENTO_PRODUCT_FOR_EACH_COLOR | Formato: Texto | |
MAGENTO_STOCK_SOURCE | Formato: Texto | |
MAGENTO_STORE_CODE | Para atualizar preço de produtos o conector consulta o endpoint /rest/default/V1/store/storeViews do Magento e seleciona o store_id cujo code equivale ao configurado nesta credencial. Desta forma, a mensagem de atualização de preço, como no exemplo abaixo: {"prices":[{"sku":"14909-06516-Meu_site_principal-42_5222752","store_id":1,"price":99.0}]} | Formato: Texto |
MAGENTO_THUMBNAIL_POSITION | Formato: Texto | |
MAGENTO_USERNAME | Usuário de acesso à API do Magento | Formato: Texto |
magento.access.token | O conector do Magento permite que ao invés de ser utilizado Usuário e Senha de acesso à API, seja gerado um Token para comunicação com a API. Caso o token seja configurado, o conector dará prioridade para utilizar este frente ao usuário/senha. | Formato: Texto |
Formato: Texto | ||
Formato: Texto Valores possíveis: True ou False | ||
Formato: Texto | ||
magento.order.custom.attrs.translations | Mapeamento entre atributos do Magento e atributos do Omni. | Formato: Objeto JSON Exemplo: |
magento.order.custom.statuses | O conector do Magento permite utilizar status customizados do Magento. Para cada ID de pedido do Omni, veja Lista de IDs do TOTVS Omni#02.STATUSDEPEDIDO, é possível configurar o status no Magento, o comentário que será adcionado ao pedido, a informação se o cliente será notificado e a visilidade desse comentário no front. ID_STATUS_OMNI:{ | Formato: Array JSON Exemplo: |
magento.order.customer.fiscal.id | Formato: Texto | |
magento.order.form.payments | Relacionamento entre os códigos de formas de pagamento do Magento com os IDs de forma de pagamento no Omni. Veja Lista de IDs do TOTVS Omni#03.FORMASDEPAGAMENTO. | Formato: Objeto JSON Exemplo: |
Formato: Texto | ||
magento.orders.invoiced | Formato: Texto Valores possíveis: True ou False | |
MAIL TO | Formato: Texto | |
MAGENTO_ORDER_ENDPOINT_PAGESIZE | Quantidade de pedidos que deve ser retornado por pagina de consulta de pedidos no Magento. Caso não sei passado parametro neste campo assume-se o valor 30 como paginação padrão. | Formato: Numero |
Use esse box para destacar informações relevantes e/ou de destaque.IMPORTANTE!