Histórico da Página
...
| Informações | ||
|---|---|---|
| ||
A venda efetuada no E-Commerce ou MarketPlace, será enviada do TOTVS OMNI e integrado com o TOTVS |
Protheus através de comunicação de Mensagem Única (RetailSales). Caso queira verificar os campos que compõem a mensagem, acesse https://api.totvs.com.br/legado Clique no Link: Mensagem Padronizada, depois em Lista de Serviços e busque a mensagem RetailSales. |
Produto | Fluxo | Tipo da Mensagem | Versão MSU | Formato |
|---|
| TOTVS OMNI | Envia | Assíncrona | 2. |
| 009 | JSON | ||
| TOTVS Protheus | Recebe | Assíncrona | 2. |
| 009 | JSON |
| Notatip | ||
|---|---|---|
|
Pré-requisitos:
Para que o recebimento de cupons seja realizado com sucesso, é necessário que já tenha integrado os seguintes cadastros:
- Cadastro de Produtos - Item
- Cadastro de Clientes - CustomerVendor
- Cadastro de Locais de Estoque - Warehouse
- Realizado o cadastro das Transportadoras
- Realizado o cadastro das Formas de pagamento
...
| title | Como funciona a identificação de TES? |
|---|
A - TES utilizada para gravação do Orçamento:
O Sistema respeita a seguinte ordem para encontrar a TES na RetailSales:
1º. Efetua a busca da TES Inteligente:
2º. Busca TES Inteligente pela operação(Tag "OperationCode") enviada pela Ciashop = "V";
3º. Caso não encontre, busca a TES Inteligente com a operação = "01" padrão do Sistema ;
4º. Caso não encontre, busca a TES através dos indicadores do Produto(BZ_TS) caso habilitado o parâmetro MV_ARQPROD ;
...
6º. Caso não tenha informações da TES nos produtos usá a TES conforme parâmetro abaixo:
MV_TESVEND = TES padrão para venda de Produtos
MV_TESSERV = TES padrão para venda de Serviços
B - TES utilizada para gravação do Pedido de Venda:
O Sistema respeita a seguinte ordem para encontrar a TES do Pedido de venda:
1º. Busca TES pelo parâmetro MV_LJTESPE ;
2º. Caso não encontre,Busca TES Inteligente pela operação"V" Venda Futura;
Antes de realizar a integração de uma reserva de produto, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).
O Adapter é uma rotina responsável pela mensagem (RetailSales) e seu cadastro é necessário para definir algumas informações importantes, como por exemplo, o tipo da mensagem JSON ou XML, se será possível enviar e receber a mensagem ou somente uma dessas opções.
|
Cadastro do adapter RetailSales
- No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
- Clique em incluir e cadastre a rotina responsável pela mensagem Item, como mostra o vídeo abaixo:
Conector de Widget width 600 url https://www.youtube.com/watch?v=T8_U1xZF7cY height 400
| Informações | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
Importante: O campo Condição de envio pode ser preenchido com uma função ou expressão logica, para determinar se o Produto em questão será enviado ou não, no caso do adapter de cliente. |
Pré-requisitos e Dicas
| Nota | ||
|---|---|---|
| ||
Antes de realizar a integração de venda, é necessário que alguns DE/PARA estejam cadastrados corretamente, para isso acesse: Cadastros de De/Para Para maiores detalhes técnicos referente à mensagem RetailSales e integração de venda acesse: Guia de uso - RetailSales |
Integrando uma venda do tipo Entrega
| Dica | ||
|---|---|---|
| ||
Como funciona a integração de uma venda do tipo entrega? Com a venda realizada no E-Commerce o TOTVS OMNI será encarregado de enviar a reserva dos itens da venda(ItemReserva), o cliente(CustomerVendor). Após o processamento desses registros pelo Protheus será realizado o TOTVS OMNI faz o envio da venda através da mensagem(RetailSales). Após a integração da venda, o serviço GravaBatch é responsável pelo processamento da venda no Protheus, onde será gerado o titulo financeiro e pedido de venda no modulo do Faturamento. |
Finalizando uma venda do tipo Entrega
- Após ter a venda integrada e processada pelo GravaBatch, no modulo Faturamento(SIGAFAT), acesse: Atualizações/ Pedidos/ Pedidos de venda.
- Posicione no Pedido de venda gerado na integração, gere e transmita o Documento de Saída (NF-e) à Sefaz, como mostra no vídeo abaixo:
| Conector de Widget | ||||||
|---|---|---|---|---|---|---|
|
| Dica | ||
|---|---|---|
| ||
Conforme a realização dos procedimentos acima ocorre a geração e envio da mensagem de rastreio de pedido(DocumentTraceAblityOrder) ao TOTVS OMNI, com os seguintes status:
O ciclo de integração de venda do tipo entrega se encerra nesse momento. |
Integrando uma venda do tipo Retira
| Dica | ||
|---|---|---|
| ||
Como funciona a integração de uma venda do tipo retira? Com a venda realizada no E-Commerce o TOTVS OMNI será encarregado de enviar a reserva dos itens da venda(ItemReserva), o cliente(CustomerVendor). Após o processamento desses registros pelo Protheus será realizado o TOTVS OMNI faz o envio da venda através da mensagem(RetailSales). Após a integração da venda, o serviço GravaBatch é responsável pelo processamento da venda no Protheus, onde será gerado o titulo financeiro e o pedido filho no modulo Controle de Lojas. |
Finalizando uma venda do tipo Retira
| Nota | ||
|---|---|---|
| ||
Caso o WOT do TOTVS OMNI esteja habilitado o não é necessário realizar a confirmação o de pedido pendente como indicado abaixo; |
- Após ter a venda integrada e processada pelo GravaBatch, no modulo Controle de Lojas(SIGALOJA), acesse: Atualizações/ Atendimento/ Venda Assistida
- Posicione no Pedido gerado na integração e em seguida realize a confirmação do pedido retira, Outras Ações/ Confirmar Pedido Pendente.
- Com a confirmação do pedido efetuada, realize a finalização do mesmo emitindo documento fiscal(NF-e ou SAT). Como mostra o vídeo abaixo:
| Conector de Widget | ||||||
|---|---|---|---|---|---|---|
|
| Dica | ||
|---|---|---|
| ||
Conforme a realização dos procedimentos acima ocorre a geração e envio da mensagem de rastreio do varejo(DocumentTraceAblityOrderRetail) ao TOTVS OMNI, com os seguintes status:
O ciclo de integração de venda do tipo entrega se encerra nesse momento. |
Próximo passo
| Dica | ||
|---|---|---|
| ||
Após configurar e entender funcionamento de integração de Vendas, vamos para o próximo passo, Cancelamento de vendas. |
...
| title | Como funciona o calculo reverso de IPI |
|---|
Ao integrar o pedido do E-Commerce o valor do IPI é retirado para que possa ser calculado na geração da Nota Fiscal (Faturamento).
Formula de calculo: Valor do item / ( (aliquota / 100) + 1) * (aliquota / 100)
Exemplo:
...
Valor de Venda Produto (e-commerce)
...
Alíquota do IPI
...
Base do IPI
...
Valor do IPI
...
Valor de Venda Produto (NF de Saída)
...
85,00
...
10%
...
77,27
...
7,72
...
85,00
Importante:
Para que não tenha diferenças de centavos no valor da Nota fiscal é necessário que os campos informados na documentação abaixo tenham 4 casas decimais:
| Dica | ||
|---|---|---|
| ||
Fique atento aos parâmetros de fechamento de estoque MV_ULMES e MV_DBLQMOV pois caso a data de emissão for inferior ou igual a data desses parâmetros a venda não será processada. Ou seja, as mensagens de "RetailSales" deverão ser reprocessadas. |
| Dica | ||
|---|---|---|
| ||
Venda MarketPlace
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas