Histórico da Página
...
Quando o conector de um canal de venda baixa pedidos pela APi do canal de venda para criar no TOTVS Omni , alguns ele usa uma interface interna SOAP para comunicação dos módulos.
Alguns campos do TOTVS Omni devem ser mapeados com informações específicas para que o pedido esteja devidamente cadastrado e possa ser enviado para os ERPs e operação logística.
Para criação do pedido via XML (código Abaixo a estrutura XML do pedido que é equivalente à estrutura JSON.
Campo do XML | Descrição do dado |
---|---|
<TIPO> | Valor default para canais de venda: VENTA |
<FECHA_PEDIDO> | Utilizar a mesma data que consta no pedido do canal de venda, porém no seguinte formato 2021-01-27 12:01:41 |
<NUMERO_PEDIDO_ORIGINAL> | Código do pedido no canal de venda, apresentado na tela de resultado de consulta de pedidos no Omni. |
<NUMERO_PEDIDO_ALTERNATIVO> * | Caso o canal de venda possua um segundo código de pedido (gerado por um hub ou por uma estrutura de lojas dentro do canal) este pode ser armazenado aqui, e também é apresentado na tela de resultado de consulta de pedidos no Omni. Exemplo: |
<ID_ALMACEN_SUMINISTRADOR> * | Id da loja que vai atender o pedido. OBS: Este campo só é utilizado para o caso em que o canal de venda decide qual é a loja para a qual será designada o pedido (VTEX). Em todos os demais casos, não deve ser utilizado este campo. |
<ID_OPERADOR_LOGISTICO> | O ID do operador logístico deve ser definido a partir do nível de serviço logístico selecionado durante a compra pelo cliente. Alguns canais de venda precisam de mapeamento para os níveis de serviço apresentados e o operador logístico. Outros descem a informação (nome ou código) do operador logístico no corpo do pedido. Ainda assim, deve-se criar um parâmetro de credencial para mapear os valores no canal de venda com os códigos de operadores logísticos. Vide TOTVS Omni - Lista de IDs do Omni#ListadeIDsdoOmni-ListadeIDsdeOperadoresLog%C3%ADsticos |
<SERVICE_LEVEL_COD_LOGISTIC> | Código do serviço de entrega que o cliente tem contratado no operador logístico. Este valor será utilizado na criação da entrega no operador logístico (integração via API Operador Logístico pelo Conector). Para alguns casos deve-se criar um parâmetro de credencial para mapear os valores no canal de venda com os códigos de níveis de serviço suportados pelo operador logístico. Vide TOTVS Omni - Lista de IDs do Omni#ListadeIDsdoOmni-ListadeIDsdeOperadoresLog%C3%ADsticos |
<IMPORTE_TOTAL> | Valor total do pedido, sem o custo de entrega. |
<GASTOS_ENVIO> | Custos de envio de acordo com a seleção de serviço de entrega. |
<ID_FORMA_PAGO> | Código da forma de pagamento do pedido. Geralmente o valor é mapeado de cada canal para os códigos Omni. Vide TOTVS Omni - Lista de IDs do Omni#ListadeIDsdoOmni-ListadeIDsdeFormasdePagamento Deve-se criar um parâmetro na credencial do canal para mapear estes valores. |
<ID_FORMA_PAGO_TPV> | Informação da forma de pagamento no gateway de pagamento do canal de venda, caso a API do canal disponibize. Para os ERPs trata-se do Adquirente do Cartao de Credito. |
<TPV_REFERENCE> | Geralmente é a marca do cartão de crédito utilizado em caso de pagamento com cartão, caso a API do canal disponibize. |
<IDENTIFICADOR_TRANSACCION> | Identificador da transação financeira operada no canal de venda, caso a API do canal disponibize. |
<TPV_AUTO> | Código de autorização da transação financeira no canal de venda, caso a API do canal disponibize. |
<TARJETA_PAGO> | Dados do cartão de crédito ou débito usado no pagamento do pedido no canal de crédito, caso a API do canal disponibize. |
<PRODUCTOS> <PRODUCTO> <ID_PRODUCTO>995045</ID_PRODUCTO> <ID_SUBPRODUCTO>4101486</ID_SUBPRODUCTO> <IMPORTE>5.00</IMPORTE> <CANTIDAD>1</CANTIDAD> <REFERENCIA>0406210201OMNI-0C5-TNFBR Principal TEST-P</REFERENCIA> <NUMERO_PEDIDO_ORIGINAL>640405</NUMERO_PEDIDO_ORIGINAL> </PRODUCTO> </PRODUCTOS> | Lista dos itens presentes no pedido. Cada item (SKU ou Subproduto) deve estar contido dentro da tag <PRODUCTO>, de acordo com a quantidade vendida daquele SKU (subproduto) e o valor total. <IMPORTE> deve ser o preço da unidade multiplicada pela quantidade. O <ID_PRODUCTO> e o <ID_SUBPRODUCTO> são IDs internos do TOTVS Omni, e devem ser recuperados caso estes não sejam publicados no canal venda com a publicação do produto e recuperado no Pedido. |
<ATRIBUTOS> <ATRIBUTO> <NOMBRE>nsu</NOMBRE> <VALOR>753801563</VALOR> </ATRIBUTO> <ATRIBUTO> <NOMBRE>cuotas</NOMBRE> <VALOR>1</VALOR> </ATRIBUTO> <ATRIBUTO> <NOMBRE>authorization_code</NOMBRE> <VALOR>20242012220300386049</VALOR> </ATRIBUTO> </ATRIBUTOS> | Dados adicionais sobre a operação financeira. Exemplo cuotas é a quantidade de parcelas em que a compra foi feita. Exemplo authorization_code é o código de autorização da operação financeira. |
<DNI_ENVIO>3324734584-1</DNI_ENVIO> | Os dados de envio do pedido, como nome da pessoa receptora e endereço devem ser cadastrados nos campos devidos. OBS: A API do Omni obriga passar Email e Telefone, porém em alguns casos o canal de venda não passa esta informação dentro do pedido. Neste cenário pode-se configurar um valor padrão do conector para passar nestes campos e não deixa-los em branco. OBS: Caso o canal de venda forneça Latitude e longitude pode-se adicionar no XML. |
<DNI>3324734584-1</DNI> <NOMBRE>Mayara</NOMBRE> <APELLIDO_1>Caroline</APELLIDO_1> <VIA>Rua Ricardo Franco</VIA> <NUMERO>91</NUMERO> <COMPLEMENTO>Apto 1</COMPLEMENTO> <COLONIA>Bairro 1</COLONIA> <POBLACION>Sao Paulo</POBLACION> <LOCALIDAD>Sao Paulo</LOCALIDAD> <PROVINCIA>SP</PROVINCIA> <CODIGO_POSTAL>02473130</CODIGO_POSTAL> <TELEFONO_MOVIL>992442314</TELEFONO_MOVIL> <EMAIL>e-mail@.com.bt</EMAIL> <OBSERVACIONES>Mayara Caroline</OBSERVACIONES> | Dados de endereço utilizados para a fatura devem ser criados conforme os campos, mesmo que sejam os mesmos valores de envio. COLONIA = Bairro POBLACION e LOCALIDAD = Cidade PROVINCIA = Estado (Código do estado) OBS: A API do Omni obriga passar Email e Telefone, porém em alguns casos o canal de venda não passa esta informação dentro do pedido. Neste cenário pode-se configurar um valor padrão do conector para passar nestes campos e não deixa-los em branco. |
...
Expandir | ||
---|---|---|
| ||
JET é um conector que integra através da geração de token, usando credenciais e chamadas via post, que permite que você crie pedidos e categorias de produtos. Exemplo ao inserir uma nova categoria Campo "level" Ao inserir uma nova categoria, o campo Os valores aceitos serão: "01" - Valores no padrão de código de nível da categoria superior. No exemplo acima, vamos usar a categoria "Moda Masculina" que possua o código do 01 - Moda Masculina
Os valores de categoria vão de 01 a 99. Ou seja, será possível cadastrar até 99 categorias com 3 níveis de hierarquia de subcategoria. |
Expandir | ||
---|---|---|
| ||
É um Marketingplace de venda que permite acessar aos recursos de integração com a Magalu. utilizamos a API da Magalu via Rest Service |
...
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
A API de integração da Via Varejo permite que lojistas comercializem seus produtos no Marketplace Via Varejo através de uma interface. Através dela é possível cadastrar produtos, gerenciar os estoques e preços e ser notificado quando pedidos são feitos e confirmados. Mapeamento de criação de pedidos Via Varejo
Observações:
Status dos pedidos.
Status de tracking dos pedidos.
Código de Pagamento.
Separação dos campos rua, número e complemento para endereços sender e shipping |
Expandir | |||||
---|---|---|---|---|---|
| |||||
O conector do VTEX permite trabalhar a integração com o TOTVS Omni em dois formatos: Com Franquias ou Sem Franquias. No cenário de franquia cada loja pode ser vista como se fosse uma instancia de VTEX separada. E para que o Omni possa se comunicar necessita de credencias de acesso próprias. De forma resumida, o conector funciona publicando produtos no VTEX e carregando o stock atrelado a cada loja (ou seller, como são chamadas as lojas no VTEX). Uma vez realizada a compra no VTEX, o pedido criado é associado à um desses sellers de acordo com a forma de entrega escolhida pelo usuário. O TOTVS Omni, ao descer os pedidos, obedece à esta decisão de submissão de pedido à seller do VTEX, sendo assim, o conector cria o pedido no Omni já com a identificação de qual loja irá atender o pedido (ID_ALMACEN_SUMINISTRADOR).
Abaixo vemos dois exemplos de JSON de pedidos do VTEX: O primeiro de loja principal e o segundo de franquia. A diferença dar-se no prefixo do pedido, que inicia com SLR. Pedido de loja principal: Pedido de Franquia: |
Expandir | ||
---|---|---|
| ||
Configurar o conector do Mercado Livre: Parar configurar o conector do Mercado Livre, o cliente precisa criar uma conta para TOTVS com perfil administrador e logar com essa conta TOTVS em https://developers.mercadolivre.com.br
Substituindo APP_ID com o ID da App criada.
curl -X POST -H 'accept: application/json' \ Substituindo os valores correspondentes a APP_ID, SECRET_KEY e AUTHORIZATION_CODE.
Parametros da Credencial do conector no Omni access_token usado na Credencial do conector no Omni no campo MERCADO_LIBRE_AUTH_TOKEN O campo MERCADO_AUTH_URL da credential deve ser configurado com a seguinte URL: Onde SITEID_ML é o ID do site que representa o Mercado Livre na conta Omni do cliente. O campo MERCADO_ACTIVAR_RETIRO de ser configurado com valor Si O campo MERCADO_CURRENCY com o valor BRL MERCADO_LISTING_TYPE indica o tipo de publicação do cliente. Configurar gold_special E o código de país do Mercado Livre é configurado no campo MERCADO_MELI_COUNTRY_CODE. Para Brasil usar MLB Estes dados serão utilizados em ambiente de Omni produção com a conta de produção do cliente. Conta de Testes Mercado Livre Para realizar os testes de publicação no Mercado Livre antes de configurar a conta de produção, Siga o procedimento abaixo: 1) Criar usuários de testes para uso nos testes do conector fazendo a chamada abaixo 2 vezes para criar 2 usuários (um comprador e um vendedor): curl -X POST -H "Content-Type: application/json" -d Resposta exemplo:
Com o código access_token e refresh_token deve-se configurar os parametros correspondentes da Credencial do conector no Omni. Configurações Omni para Mercado Livre 1) Logado no Mercado Livre com a conta vendedora (conta vendedor de teste ou a conta do usuário) chamar a URL abaixo para obter o código do vendedor: https://api.mercadolibre.com/sites/MLB/search?nickname=TESTGZB7BZJ2 Exemplo Retorno: { "site_id": "MLB", "seller": { "id": 674940286, "nickname": null, "permalink": null, "registration_date": null, "real_estate_agency": false, ...} Configurar o valor do seller > id no campo MERCADO_LIBRE_ORDERID da credencial do conector do mercado livre. 2) Acessar a interface web do TOTVS Omni com a conta do cliente > Gerenciador de canais > Categorias de links. Selecionar no lado esquerdo as categoria do Omni que contenham produtos e associá-las às categorias do Canal. 3) Acessar a interface web do TOTVS Omni com a conta do cliente > Configurações > Sites Certifique-se que há uma loja associada ao Site principal e também ao site correspondente ao Mercado Livre. Publicar Produtos no Mercado Livre Criar uma publicação no TOTVS Omni e incluir pelo menos um produto da categoria mapeada. |
05. FLUXO DE VENDAS
- Flujo de venta Magento - entrega en tienda_com comentarios.pdf
- Flujo de venta Vtex - entrega en tienda.pdf
- Flujo Vtex - Totvs Omni.pdf
HTML |
---|
<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style> |