- Criado por Quezia Pereira Da Silva, última alteração por Felippe Augusto de Oliveira Neto em 10 ago, 2021
CONTEÚDO
01. VISÃO GERAL
No cenário de omni channel, as lojas, que geralmente são pontos de vendas direta ao consumidor, passam a ser consideradas também como mini centros de distribuição, operando o envio e entrega de produtos comprados em outros pontos de venda, e-commerce ou marketplaces. Isto caracteriza o que é chamado de prateleira infinita, em que uma loja tem acesso ao estoque de outra e pode operar a venda de um produto não fisicamente presente através do omni channel.
Com isso é muito importante a integração dos ERPs/PDVs utilizados no back-office e lojas com o TOTVS Omni.
Os processos de integração do TOTVS Omni com sistemas ERPs/PDVs estão divididos em relação à duas entidades principais: Produtos e Pedidos.
02. PRODUTOS
Os produtos cadastrados no ERP/PDV são sincronizados no TOTVS Omni. As seguintes ações precisam ser implementadas para a integração:
Geralmente a carga de categorias é realizada a partir de um arquivo Excel extraído do ERP.
A carga é feita manualmente (off-line) através da interface web do Omni durante a implementação de projeto, e alterada pelo usuário final ao longo do uso do Omni.
O excel contém 1 coluna e cada linha representa uma categoria. Após a carga, pode-se configurar a estrutura de herança de categorias no Omni
ERP -> Omni: ERP gera um arquivo Excel contendo a lista de categorias para importação no Omni.
Desenvolvimento:
Este processo geralmente é realizado durante o projeto de implementação.
Produtos existentes no ERP/PDV são sincronizados com o TOTVS Omni, para que possam ser publicados nos canais. Há 3 soluções possíveis que são analisadas de acordo com as possibilidades do ERP/PDV.
- Via Servidor de Arquivo: A carga de produtos pode ser realizada a partir de um arquivo (EXCEL ou JSON, gerado pelo ERP (ou PDV) e carregado pelo mesmo para um servidor de arquivos (FTP ou S3) para que o arquivo possa ser lido pelo Omni.
Descrição:
Este modelo de integração também pode ser utilizado para criação de produtos e atualização de preços.
O mesmo modelo pode conter também o estoque por loja de cada produto, porém estoque é uma informação opcional para carga de produtos e pode ser feito por processo separado.
Nota: O Omni dispõe de um servidor de arquivos FTP próprio onde se faz a carga destes arquivos, porém é possível utilizar um servidor do cliente ou serviço de armazenamento de arquivo em nuvem
ERP gera arquivo, carrega para o servidor e Omni consome via integração (Módulo Integrador).
- Omni -> ERP: ERP disponibiliza interface REST API que devolve a lista de produtos em formato JSON. O Omni consume a API do ERP no pré processo de uma integração configurada.
Descrição:
A carga de produtos pode ser realizada a partir de comunicação via API REST tanto do Omni como do ERP.
O formato do arquivo pode ser usado EXCEL ou JSON, igual ao especificado na documentação abaixo.
Neste modelo de integração o TOTVS Omni consulta a API do ERP, lista os produtos e armazena no servidor interno de FTP no pré processo de uma integração FTP configurada no Omni. A Integração no Omni irá ler o arquivo na sequência.
- ERP -> Omni: O ERP se comunica com a API do Omni e envia uma mensagem JSON contendo todos os produtos a serem carregados/atualizados no Omni.
Descrição:
A carga de produtos pode ser realizada a partir de comunicação via API REST tanto do Omni como do ERP.
O formato do arquivo é igual ao especificado na documentação abaixo.
Neste modelo de integração, o ERP envia a lista de produtos para a API do Omni. O Omni processa o arquivo armazenando-o internamente em seu FTP interno. A Integração configurada no Omni irá ler o arquivo na sequência.
A atualização de atributos de produtos segue o mesmo modelo de integração da Criação de Produtos no TOTVS Omni.
Importante: O arquivo de produtos deve sempre conter valor para preço e preço com desconto, indicando o preço do produto no PDV e o preço que se deseja aplicar do mesmo nos canais atendidos pelo Omni. Porém este preço com desconto torna-se o preço base do cálculo de descontos aplicados nas publicações pelo Omni.
A atualização de preços de produtos segue o mesmo modelo de integração da Criação de Produtos no TOTVS Omni.
Importante: O arquivo de produtos deve sempre conter valor para preço e preço com desconto, indicando o preço do produto no PDV e o preço que se deseja aplicar do mesmo nos canais atendidos pelo Omni. Porém este preço com desconto torna-se o preço base do cálculo de descontos aplicados nas publicações pelo Omni.
A carga de fotos para os produtos deve ser feita através da carga dos arquivos de fotos para um servidor arquivos.
Outra opção é durante a carga de produtos, referenciar no arquivo de carga uma foto disponível no ecommerce (endereço HTTP). Desta forma, não se faz necessária a carga de fotos para o TOTVS Omni.
A carga de fotos é geralmente realizada durante a fase de implementação do TOTVS Omni no cliente, porém pode ser necessário atualização das fotos.
Definir uma estrutura de pasta no servidor de arquivos e referenciar esta estrutura no sistema integrador.
No nome dos arquivos de imagens deve constar o <código de referencia do produto>, espaço, e um sequencial caso houver mais de uma foto a ser carregada para o mesmo produto. Exemplo: “333 1.png”, “3266 1.jpg”, e “3266 2.jpg”.
Nota: O Omni dispõe de um servidor de arquivos FTP próprio onde se faz a carga destes arquivos, porém é possível utilizar um servidor do cliente ou serviço de armazenamento de arquivo em nuvem, como Amazon S3.
Este processo pode ter 3 soluções possíveis que precisam ser analisadas de acordo com as possibilidades do ERP/PDV.
- Via Servidor de Arquivo: ERP gera arquivo Excel ou JSON, carrega para FTP/S3 e Omni consome arquivo.
Descrição: A atualização de estoque de produtos O TOTVS Omni deve ser feita periodicamente, e pode ser feita separadamente da carga/atualização de produtos.
A atualização diária de todo o estoque pode ser realizada fora horário comercial, uma vez por dia, e através de arquivo excel ou JSON extraído do ERP e carregado para um servidor FTP. Neste caso configura-se uma integração total no Omni.
É recomendável que haja uma periodicidade curta para a atualização do estoque de produtos que tiverem vendas nos PDV. E recomendamos utilizar a comunicação via API neste caso. Neste caso configura-se uma integração parcial no Omni.
Desenvolvimento:
Implementação da geração do arquivo no ERP e envio para o servidor de arquivos.
- Omni -> ERP: ERP disponibiliza interface REST API que devolve a quantidade de estoque por loja em formato JSON para processamento pelo Omni.
Descrição:
A atualização de estoque de produtos O TOTVS Omni deve ser feita periodicamente, e pode ser feita separadamente da carga/atualização de produtos. É recomendável que haja uma periodicidade curta para a atualização do estoque.
Neste modelo de integração o TOTVS Omni periodicamente consome a API do ERP para atualização do estoque dos produtos. A integração deve ser parcial, isto é, se o ean do produto não estiver na mensagem trocada entre ERP e Omni, o valor de estoque do produto não é alterado.
Recomenda-se que o ERP envie somente os dados de estoque de produtos que sofreram alteração de estoque.
Desenvolvimento:
Disponibilização da interface REST pelo ERP.
Desenvolvimento de Pré Processo no Omni
- ERP -> Omni: ERP gera o arquivo e envia para a API REST do módulo integrador do Omni, que armazenará o arquivo no servidor FTP interno para processamento.
Descrição:
A atualização de estoque de produtos O TOTVS Omni deve ser feita periodicamente, e pode ser feita separadamente da carga/atualização de produtos. É recomendável que haja uma periodicidade curta para a atualização do estoque.
Neste modelo de integração o TOTVS Omni periodicamente consome a API do ERP para atualização do estoque dos produtos. A integração deve ser parcial, isto é, se o ean do produto não estiver na mensagem trocada entre ERP e Omni, o valor de estoque do produto não é alterado.
Recomenda-se que o ERP envie somente os dados de estoque de produtos que sofreram alteração de estoque.
Desenvolvimento:
Implementar no ERP a comunicação com a API disponível do Omni.
03. PEDIDOS
Os pedidos realizados por consumidores nos canais de vendas e atendidos pelo TOTVS Omni, precisam ser designados para atendimento pelas lojas/centro de distribuição.
As seguintes ações precisam ser implementadas para a integração:
Após receber o pedido de compra feito no canal de venda, o TOTVS Omni define, através de regras configuradas, qual é a loja participante do omni channel que irá atender o pedido.
É possível implementar esta atividade por uma das duas direções de comunicação entre ERP/PDV e TOTVS Omni, descritas a seguir:
- Omni -> ERP: Permite a criação do pedido no PDV quase em tempo real, após a designação da loja pelo TOTVS Omni.
Descrição:
Direção idealmente desejada.
Desenvolvimento:
Disponibilização de API pelo ERP/PDV.
Implementação da integração no TOTVS Omni.
- ERP -> Omni: PDV consulta a lista de pedidos abertos no Omni.
Descrição:
Para implementação desta integração é necessário que o ERP/PDV tenha o ID da loja (storeID) e do site (siteID) armazenado para consulta no Omni.
Importante configurar uma periodicidade da consulta curta.
Este processo se implementa em 2 casos de uso (Jornadas do Cliente: “Loja enviará o pedido ao cliente” e “Pick up in Store”).
O TOTVS Omni irá designar uma loja para atender o pedido, independente do caso de uso. A loja, após verificar disponibilidade do(s) produto(s) (sem avaria, em estoque, etc) deverá aceitar o pedido proveniente do TOTVS Omni; Ou em caso de não disponibilidade (devido à avaria na peça, não ter mais em estoque, etc) deverá recusar o pedido.
É possível aceitar ou recusar o pedido inteiro ou parcial, e utiliza-se a mesma API para esta finalidade.
- ERP -> Omni: : A loja deve comunicar ao TOTVS Omni que aceitou ou não o pedido independente do caso de uso.
Este processo acontece após a loja realizar a entrega do pedido ao cliente (Jornada do Cliente: "Pick up in Store") ou após a entrega do pedido para entrega pelo operador logístico (Jornada do Cliente: "Ship from Store").
Opcionalmente, o TOTVS Omni permite que a loja carregue um comprovante de entrega do pedido ao cliente (Jornada do Cliente: "Pick up in Store").
Qualquer outra necessidade de atualizar o status do pedido, seja por devolução, cancelamento, ou outra necessidade, o ERP/PDV pode fazer a partir desta mesma API.
- ERP -> Omni: : A loja deve comunicar ao TOTVS Omni que aceitou ou não o pedido independente do caso de uso.
Descrição:
Após o pedido entregue, o ERP/PDV deve comunicar ao TOTVS Omni que o pedido foi entregue ao cliente (status “4” Entregue) ou entregue no operador logístico (status “3” Em trânsito).
Este processo acontece sempre que a loja deseja obter informações sobre o status logístico da entrega de um pedido (tracking). Se aplica geralmente à jornada do cliente "Ship from store".
Integração Opcional.
- ERP -> Omni: : A loja deve comunicar ao TOTVS Omni que aceitou ou não o pedido independente do caso de uso.
Descrição:
Consulta o status logístico da entrega (tracking).
Este processo acontece quando a loja tem que enviar o produto comprador para o endereço do cliente (Jornada do Cliente: "Ship from Store").
Após a confirmação do pedido pela loja, o ERP/PDV deve consultar o Omni para recuperar a etiqueta de despacho do produto, que foi gerada pelo operador logístico.
- ERP -> Omni: O ERP/PDV deve implementar a consulta da etiqueta de envio do pedido.
Cupons são gerados a partir de uma devolução de produto comprado através do omni channel e que foram devolvidos para uma loja, seja ela de origem do produto ou não.
Os cupons devem ser criados pelo ERP/PDV no Omni quando o cliente devolver na loja itens que foram comprados no e-commerce.
É possível à loja consultar os cupons que o cliente tem direito, desde que armazenados no TOTVS Omni.
Nota: Importante salientar que produtos vendidos em alguns Marketplaces, adotam políticas de devolução e gerenciamento de crédito específicos destes marketplaces, e precisam ser analisados conforme o acordo comercial que a empresa cliente TOTVS Omni tenha com o marketplace.
- ERP -> Omni: Esta integração permite à loja criar, buscar e atualizar cupons para o cliente no Omni.
É possível consultar a API do TOTVS Omni para coletar informações específicas a respeito de vendas de clientes, por data, lojas, status, e outros atributos de produtos.
Nota: O TOTVS Omni não realiza operações fiscais, contábeis, nem financeiras. Os relatórios são meramente para fins de consulta por conter os dados dos pedidos.
- ERP -> Omni: Uso da API para consultas relativas à pedidos.
A integração entre ERP/PDV e Omni para devolução de um pedido deve ser implementada no casos em que o consumidor compre pelo site (E-Commerce) e faça a retirada do pedido em uma loja e que para devolução, a empresa especifique que o consumidor deve levar o item à loja onde retirou o pedido.
Neste cenário, a devolução ocorre após o cliente ter retirado o item na loja e retorna à loja para a devolução.
Caso este cenário não seja aplicado, então as devoluções devem ser direcionadas para atendimento pelo E-Commerce, e não irão interagir com o ERP/PDV.
Após efetuar a devolução do pedido, o ERP/PDV deve incluir o item à seu estoque para que na próxima atualização de estoque com o Omni, o item possa aparecer disponível para venda novamente.
Nota: As devoluções de compras feitas em marketplace, geralmente são feitas diretamente com o marketplace, mesmo em cenários de pickup in store. É necessário analisar os marketplaces participantes do Omni channel para adotar as políticas corretas.
É possível consultar a API do TOTVS Omni para coletar informações específicas a respeito de vendas de clientes, por data, lojas, status, e outros atributos de produtos.
04. CONECTORES
- Conector com TOTVS Moda
- Conector com TOTVS Protheus PDV
- Conector com TOTVS WinThor
- Consumo de APIs REST para ERPs e PDVs