Manual de Integração com ERPs e PDVs

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.

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.