Árvore de páginas


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 CredencialDescriçãoFormato 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_PAGADOSLista de status utilizados na consulta de pedidos que o conector faz no Magento.

Formato: Texto

Exemplo:

processing,pedido_pago,em_separacao,pedido_faturado

MAGENTO_HOSTHost do MagentoFormato: Texto
MAGENTO_ID_WEB_sITEId do WebSite do MagentoFormato: Texto
MAGENTO_PASSWORDSenha de acesso do usuário à API do Magento.Formato: Texto
MAGENTO_PRODUCT_FOR_EACH_COLOR
Formato: Texto
MAGENTO_STOCK_SOURCE
Formato: Texto
MAGENTO_STORE_CODEPara 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_USERNAMEUsuário de acesso à API do MagentoFormato: Texto
magento.access.tokenO 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.translationsMapeamento entre atributos do Magento e atributos do Omni.

Formato: Objeto JSON

Exemplo

JSON
{
	"cc_nsu_authorization": "nsu",
	"cc_installments": "cuotas"
}
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:{
            "status":"<STATUS_NO_MAGENTO>",
            "comment":"<TEXTO_DO_COMENTARIO_DO_PEDIDO>",
            "notifyCustomer":"<true ou false>",
            "visibleOnFront":"<true ou false>"
}

Formato: Array JSON

Exemplo:

JSON
{
	1:{
		"status":"recco_pedido_pago",
		"comment":"Pedido integrado no ERP",
		"notifyCustomer":"false",
		"visibleOnFront":"false"
	},
	16:{
		"status":"recco_em_separacao",
		"comment":"Seu pedido esta em separação",
		"notifyCustomer":"true",
		"visibleOnFront":"true"
	}
}
magento.order.customer.fiscal.id
Formato: Texto
magento.order.form.paymentsRelacionamento 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

JSON
{
	"rm_pagseguro_cc": "53",
	"mundipagg_creditcard": "53",
	"rede": "53",
	"rm_pagseguro_boleto": "40",
	"mundipagg_billet": "40"
}

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

IMPORTANTE!

Use esse box para destacar informações relevantes e/ou de destaque.