Histórico da Página

...

1.5- O pacote de expedição contínua do Varejo deverá estar atualizado, mais informações sobre Clique Aqui.

1.6- Somente versões vigentes são suportadas, conforme link de ciclo de vida do TOTVS Linha Protheus:  https://suporte.totvs.com/portal/p/10098/ciclodevidacalendarios

Obs.: A integração com VTEX, faz uso de outras mensagens padronizadas, para mais informações acessar a documentação do time de FrameWork: Integração Protheus x VTEX - Via Mensagem Padronizada (EAI)

...

3- Adapter

3- Adapter

3.1- Para que o 3.1- Para que o Protheus possa receber a mensagem RetailSales é necessário realizar o cadastro dos seguintes adapters: LOJA701, LOJA704 e LOJI701A. Para mais informações de como cadastrar um adapter Clique aqui.

...

• ItemReserve - Com a venda realizada na plataforma do E-Commerce será disparado uma Mensagem Padronizada de Reserva de itens - Produtos no Protheus, essa reserva por sua vez ira percorrer o processo configurado pelo modulo estoque, podendo retirar reservar do estoque o que foi enviado na MP - ItemReserve.

  AvisotitleAviso!

  Reservas utilizando

• produto com Controle de Lote (B1_RASTRO), não estão homologadas com o VTEX.Caso o produto a ser reservado tenha controle de Lote ativo (B1_RASTRO), deverá ser informado o os dados do lote de acordo com as tags abaixo/Sublote/Endereçamento/Serie Com saldo em estoque suficiente - Caso na mensagem Padronizada ItemReserve não seja informado as tags referente à Lote, SubLote, Endereçamento e Serie, mencionadas a baixo:
  • "LotNumber" - Lote
  • "SubLotNumber" - SubLote
  • "AddressingItem" - Endereçamento
  • "SeriesItem" - Serie
• Para customizar as Tags de Reserva, verificar o Ponto de Entrada: https://tdn.engpro.totvs.com.br/display/public/PROT/Ponto+de+entrada+LJI704O1
• Caso as tags referende aos dados do lote não forem enviadas na mensagem, o sistema irá carregar as informações automaticamente utilizando como ordem a data de validade do Lote.
• Para reservas integradas via MP - ItemReserve o cancelamento automático de reserva com a validade expirada (C0_VALIDA) está desabilitado.
• O cancelamento de Reserva só será realizado via Mensagem Padronizada com o evento delete que se encontra dentro do Content no Json EVENT = DELETE
• O cancelamento de reserva também poderá ser realizado via tela na rotina Controle de Reservas - MATA430.  
• CustomerVendor - Apos a confirmação de Reserva de Itens é disparado uma Mensagem Padronizada de Clientes para o Protheus. A MP de Clientes pode ser de inclusão ou de alteração.
• RetailSales - Apos a confirmação de inclusão ou alteração de Cliente é disparado uma Mensagem Padronizada de Vendas para o Protheus. O processo de inclusão do orçamento das tabelas SL1, SL2 e SL4 passa por toda a validação de registros do modulo SIGALOJA. O registro totalmente validado é incluído para próxima etapa, quaisquer informações invalidas identificado nesse processo ira retornar uma critica a integração E-Commerce. 
  •  Importante : Somente é homologado pedidos com pagamento confirmado na plataforma VTEX, não é homologado pedido com boleto para controle de pagamento via Protheus.
• Serviço Gravabatch - Esse serviço é responsável pelo processamento do orçamento das tabelas incluídas pela MP - RetailSales. Para as vendas que estejam campo L1_SITUA = RX, este serviço tem como objetivo: Gerar financeiro, Baixa de estoque, Livros fiscais etc. Caso seja encontrado alguma inconsistência no processamento deste serviço o campo L1_SITUA é atualizado para ER. Caso o processamento da venda seja finalizado com sucesso o campo L1_SITUA é atualizado para FR.

Importante: Após explodir o orçamento SL1 o registro Pai é atualizado o campo L1_SITUA = FR e criará o registro filho com o campo L1_SITUA em branco. Qualquer mudança desses registros falhará no envio da tag RetailSalesInternalId na próxima MP - DocumentTraceAbilityOrder.

Para auxiliar na analise de erros ou criticas é possível habilitar o log do loja, abaixo segue a documentação do log:

SIGALOJA 0290 Quais são os logs auxiliares Protheus Varejo?

Links com orientações de configuração do GravaBatch:

Configuração do Job LJGRVBATCH para processamento das vendas no Protheus

SIGALOJA 0057 Qual o conceito, Configuração e Correção do campo L1_SITUA (GravaBatch, LjGrvBatch, Integração ERP)?

• DocumentTraceAbilityOrder - O Rastreio do Pedido de Vendas é enviado do sistema Protheus, e será integrado com o sistema VTEX no momento do faturamento do pedido de venda, gerando o documento de saida. Link da MP - Rastreio de Pedido de Venda
• Importante: Existe uma validação padrão dentro do módulo do Faturamento para não permitir alterar Pedido quando a origem é do Loja, o motivo é para evitar divergência de valores entre as tabelas do controle de loja e faturamento, porém, caso o cliente deseja realizar a alteração do pedido mesmo sabendo que pode ocorrer divergência de valores caso o valor total do pedido seja alterado, deve-se utilizar o ponto de entrada LJI701O2 (DVARLOJ1-5249 DT Criação de Ponto de Entrada (rotina Pedidos de venda)) para realizar a liberação da alteração.
• Estrutura de gravação: A gravação do pedido segue o padrão utilizado pelo Venda Assistida, onde o registro recebido de orçamento, após o processamento do Job Gravabatch, irá gerar um orçamento filho para a geração do Pedido. Para mais informações sobre essa estrutura, acessar o link: Como é gravado uma venda com itens do tipo ENTREGA (pedido) e RETIRA ?

6.2 - RetailSales - Item Retira

Apos ter realizado as configurações acima a integração de Venda - OrderRetail seguirá os seguintes fluxos:

• ItemReserve - Com a venda realizada na plataforma do E-Commerce será disparado uma Mensagem Padronizada de Reserva de itens - Produtos no Protheus, essa reserva por sua vez ira percorrer o processo configurado pelo modulo estoque, podendo retirar do estoque o que foi enviado na MP - ItemReserve.
• CustomerVendor - Apos a confirmação de Reserva de Itens é disparado uma Mensagem Padronizada de Clientes para o Protheus. A MP de Clientes pode ser de inclusão ou de alteração.
• RetailSales - Apos a confirmação de inclusão ou alteração de Cliente é disparado uma Mensagem Padronizada de Vendas para o Protheus. O processo de inclusão do orçamento das tabelas SL1, SL2 e SL4 passa por toda a validação de registros do modulo SIGALOJA. O registro totalmente validado é incluído para próxima etapa, quaisquer informações invalidas identificado nesse processo ira retornar uma critica a integração E-Commerce
• Serviço Gravabatch - Esse serviço é responsável pelo processamento do orçamento das tabelas incluídas pela MP - RetailSales. Para as vendas que estejam campo L1_SITUA = RX, este serviço tem como objetivo: Gerar as tabelas SL1,SL2 e SL4. Caso seja encontrado alguma inconsistência no processamento deste serviço o campo L1_SITUA é atualizado para ER. Caso o processamento da venda seja finalizado com sucesso o campo L1_SITUA é atualizado para FR.

Importante: Apos explodir o orçamento SL1 o registro Pai é atualizado o campo L1_SITUA = FR e criará o registro filho com o campo L1_SITUA em branco. Qualquer mudança desses registros falhará no envio da tag RetailSalesInternalId na próxima MP - DocumentTraceAbilityOrderRetail.

Para auxiliar na analise de erros ou criticas é possível habilitar o log do loja, abaixo segue a documentação do log:

SIGALOJA 0290 Quais são os logs auxiliares Protheus Varejo?

• Após a geração das tabelas SL1,SL2 e SL4, acessando a rotina de Venda Assistida (LOJA701):
  • No menu "Outras Ações/Confirmar Pedido Pendente", efetue a liberação do pedido - que estará com o status na cor roxa - com isso será gerada a mensagem padronizada DocumentTraceAbilityOrderRetail com o Status "Empacotado". 
  • Finalizando esse orçamento com item de pedido do tipo retira, será gerada a mensagem padronizada DocumentTraceAbilityOrderRetail com o Status "Entregue".
  • Efetuando o cancelamento do orçamento pai ( o filho não pode ser excluído pois é um pedido retira )  será gerada a mensagem padronizada DocumentTraceAbilityOrderRetail com o status "Cancelado".
  • Para maiores informações da mensagem DocumentTraceAbilityOrderRetail, acesse: DocumentTraceAbilityOrderRetail - Pedido Retira

7 - Utilizando Tes no Produto ou Tes Inteligente 

Para gravação de dados do Orçamento (Tabela SL1), é necessário a amarração da TES no produto ou configuração da TES Inteligente.

 Para a utilização da TES no produto deve ser incluído no campo TS Padrao (Campo B1_TS) como mostra o exemplo abaixo:

Image Removed

Agora para utilização da TES Inteligente por default da Mensagem Padronizada utilizamos a informação existente na tag "OperationCode": "01" dentro do bloco "SaleItem", assim procuramos na tabela SFM - TES Inteligente se existe uma regra com a operação 01, caso não exista a configuração infomara a seguinte mensagem: "Inconsistência no item numero do item TES não informada, verifique o Cadastro de Produto no Protheus campo B1_TS e/ou De-Para de TES(XXF) e/ou as configurações para TES Inteligente(DHJ e SFM) e/ou parâmetros MV_TESSERV e MV_TESVEND."

Seguir orientações do ERP para TES Inteligente, exemplo abaixo:

Image Removed

7.1 - Cenário onde pode ser usado a Tes Inteligente no orçamento SL1, SL2 e/ou SC5, SC6

• Orçamento SL1 e SL2: a tes inteligente configurada para o Tp. de Operação recebida na tag OperationCode "valor padrão 01" deve gerar financeiro.
• Pedido de Venda SC5 e SC6: Para uso da tes inteligente no pedido de venda não configurar o parâmetro MV_LJTESPE (deixando em branco), a busca da tes é com base no tipo de operação "V". A tes utilizada no pedido não deve gerar financeiro, campo Gera Dupl. = Não. O financeiro é gerado no momento que o orçamento é processado no Loja (GravaBatch) para o tipo de operação recebido na tag OperationCode "valor padrão 01".

8- Geração do Contas a Receber (SE1)

A geração dos dados do Contas a Receber (SE1), ocorre após a execução do Job de Integração de Vendas (LJGRVBATCH) e depende da

TES-Tipo de Entrada e Saída configurada e segue a sequência:

• Pesquisa da TES Inteligente rotina MaTesInt, caso não encontre, segue;
• Pesquisa da TES na tabela SBZ-Indicadores de Produtos, caso não encontre, segue;
• Pesquisa da TES no campo Tipo de Saída do Produto (B1_TS) de acordo com o produto encontrado, caso não encontre, segue;
• Valida se a venda é um RPS, se sim, busca a TES no parâmetro MV_TESSERV, caso contrário;
• Caso não ache seja RPS, busca a TES para o produto no parâmetro MV_TESVEND;
• Ao final, se nenhuma TES for encontrada haverá retorno com mensagem de inconsistência e o processo de integração não ocorrerá;

Importante:

A TES - Tipo de Entrada e Saída configurada deve ter basicamente esses campos preenchidos:

• Do tipo 'Saída': F4_CODIGO maior ou igual a 500;
• Gera Duplicata (F4_DUPLIC) igual a S;
• Gera Estoque (F4_ESTOQUE) igual a S;

Nos pedidos que contem itens do tipo "1-Retira Posterior" (Campo L2_ENTREGA igual a 1) os orçamentos filhos terão

o Contas a Receber gerado após a finalização do orçamento como venda.

9- Relacionamento entre Orçamento, Pedido de Venda, Pedidos Liberados e Contas a Receber

Relacionamento entre tabelas de Orçamento(Venda Assistida), Pedido de Venda, Pedidos Liberados (Faturamento) e Contas a Receber(Financeiro)

Colocar motivo de não permitir alteração de pedido no Faturamento.

Para encontrar os Pedido de Venda (SC5) e Contas a Receber (SE1) a partir do Orçamento (SL1) pode ser realizado dos campos:

SL1 - L1_FILIAL,  L1_ECPEDEC, L1_DOCPED, L1_SERPED 

SC5 - C5_FILIAL, C5_PEDECOM

SE1 - E1_FILIAL, E1_PREFIXO, E1_NUM

Para encontrar os Pedidos Liberados (SC9) a partir do Pedido de Venda (SC5) pode ser realizado dos campos:

SC9 - C9_FILIAL, C9_PEDIDO

Relacionamento entre as tabelas e campos:

L1_ECPEDEC = C5_PEDECOM
L1_DOCPED = E1_NUM
L1_SERPED = E1_PREFIXO
C9_PEDIDO = C5_NUM

A tabela de cabeçalho da Nota (SF2) é gerada após o Faturar o Pedido pelo módulo do Faturamento, onde:

F2_DOC = C5_NOTA

Para identificar o registro de Orçamento (SL1) que gerou o título financeiro (SE1), relaciona-se:

E1_NUM + E1_PREFIXO = L1_DOCPED + L1_SERPED

10- Exemplo das mensagens

10.1 - RetailSales - com item do tipo "Entrega"

O sistema vai identificar o Lote com a data de validade mais próxima e fará a reserva do produto para esse lote.
Caso a quantidade do produto seja superior ao do primeiro lote, o sistema identifica se tem outros lotes do mesmo produto, caso tenha será reservado 100 unidades do lote com a validade mais próxima e 2 unidades para o segundo lote com a validade mais próxima. Com isso gerando duas linhas do mesmo produto na tabela SC0, para lotes diferentes, como mostra o exemplo abaixo:

• Controle de Lote/Sublote/Endereçamento/Serie sem saldo em estoque -  Caso o produto tenha controle de lote e/ou endereçamento e não tenha saldo nas tabelas SBF(Saldos por Endereço) e SB8(Saldos por Lote), quando configurado para permitir reserva sem estoque (MV_LJGERSC = 4), a reserva será gerada normalmente na tabela SC0 sem preencher os campos de Lote ou Endereço e a quantidade reservada será controlada somente na tabela SB2, nas tabelas SBF e SB8 não terá nenhum tipo de movimentação. Após gerar a reserva e integrar a venda o pedido de venda será gerado no faturamento e ficara bloqueado por saldo em estoque (C9_BLEST = 02). Com isso é necessário realizar a inclusão de saldo por Lote(SB8) ou Endereçamento(SBF) e realizar a liberação do estoque no modulo do Faturamente. Caso deseje realizar alguma alteração no Pedido para informar o lote ou o endereço do produto pode utilizar o Ponto de entrada LJI701O2.

 Importante : Endereçamento e Serie o tratamento é o mesmo.

• • Para reservas integradas via MP - ItemReserve o cancelamento automático de reserva com a validade expirada (C0_VALIDA) está desabilitado.
  • O cancelamento de Reserva só será realizado via Mensagem Padronizada com o evento delete que se encontra dentro do Content no Json EVENT = DELETE
  • O cancelamento de reserva também poderá ser realizado via tela na rotina Controle de Reservas - MATA430. 
• CustomerVendor - Após a confirmação de Reserva de Itens é disparado uma Mensagem Padronizada de Clientes para o Protheus. A MP de Clientes pode ser de inclusão ou de alteração.
• RetailSales - Após a confirmação de inclusão ou alteração de Cliente é disparado uma Mensagem Padronizada de Vendas para o Protheus. O processo de inclusão do orçamento das tabelas SL1, SL2 e SL4 passa por toda a validação de registros do modulo SIGALOJA. O registro totalmente validado é incluído para próxima etapa, quaisquer informações invalidas identificado nesse processo ira retornar uma critica a integração E-Commerce. 
  • Controle de Lote/Sublote/Endereçamento/Serie - Os itens do orçamento na tabela SL2 serão criados de acordo com os itens da reserva.

• •  Importante : Somente é homologado pedidos com pagamento confirmado na plataforma VTEX, não é homologado pedido com boleto para controle de pagamento via Protheus.
  • Serviço Gravabatch - Esse serviço é responsável pelo processamento do orçamento das tabelas incluídas pela MP - RetailSales. Para as vendas que estejam campo L1_SITUA = RX, este serviço tem como objetivo: Gerar financeiro, Baixa de estoque, Livros fiscais etc. Caso seja encontrado alguma inconsistência no processamento deste serviço o campo L1_SITUA é atualizado para ER. Caso o processamento da venda seja finalizado com sucesso o campo L1_SITUA é atualizado para FR.

Importante: Após processar o orçamento na tabela SL1 o registro Pai é atualizado o campo L1_SITUA = FR e criará o registro filho com o campo L1_SITUA em branco. Qualquer mudança desses registros falhará no envio da tag RetailSalesInternalId na próxima MP - DocumentTraceAbilityOrder. 

Para auxiliar na analise de erros ou criticas é possível habilitar o log do loja, abaixo segue a documentação do log:

SIGALOJA 0290 Quais são os logs auxiliares Protheus Varejo?

Links com orientações de configuração do GravaBatch:

Configuração do Job LJGRVBATCH para processamento das vendas no Protheus

SIGALOJA 0057 Qual o conceito, Configuração e Correção do campo L1_SITUA (GravaBatch, LjGrvBatch, Integração ERP)?

• DocumentTraceAbilityOrder - O Rastreio do Pedido de Vendas é uma mensagem do módulo de Faturamento enviado do sistema Protheus, e será integrado com o sistema VTEX no momento do faturamento do pedido de venda, gerando o documento de saída. Link da MP - Rastreio de Pedido de Venda
• Importante: Existe uma validação padrão dentro do módulo do Faturamento para não permitir alterar Pedido quando a origem é do Loja, o motivo é para evitar divergência de valores entre as tabelas do controle de loja e faturamento, porém, caso o cliente deseja realizar a alteração do pedido mesmo sabendo que pode ocorrer divergência de valores caso o valor total do pedido seja alterado, deve-se utilizar o ponto de entrada LJI701O2 (DVARLOJ1-5249 DT Criação de Ponto de Entrada (rotina Pedidos de venda)) para realizar a liberação da alteração.
• Estrutura de gravação: A gravação do pedido segue o padrão utilizado pelo Venda Assistida, onde o registro recebido de orçamento, após o processamento do Job Gravabatch, irá gerar um orçamento filho para a geração do Pedido. Para mais informações sobre essa estrutura, acessar o link: Como é gravado uma venda com itens do tipo ENTREGA (pedido) e RETIRA ?
• Xml da Nota Sefaz: O XML da sefaz é enviado na mensagem no bloco DocumentContent somente no status do Pedido "Empacotado" e a nota fiscal transmitida.

6.2 - RetailSales - Item Retira

Apos ter realizado as configurações acima a integração de Venda - OrderRetail seguirá os seguintes fluxos:

• ItemReserve - Com a venda realizada na plataforma do E-Commerce será disparado uma Mensagem Padronizada de Reserva de itens - Produtos no Protheus, essa reserva por sua vez ira percorrer o processo configurado pelo modulo estoque, podendo retirar do estoque o que foi enviado na MP - ItemReserve. Caso o Produto controle Lote, SubLote, Endereçamento e Serie, será realizado o mesmo tratamento informado no tópico ItemReserve do item  6.1 - RetailSales - item Entrega.
• CustomerVendor - Apos a confirmação de Reserva de Itens é disparado uma Mensagem Padronizada de Clientes para o Protheus. A MP de Clientes pode ser de inclusão ou de alteração.
• RetailSales - Apos a confirmação de inclusão ou alteração de Cliente é disparado uma Mensagem Padronizada de Vendas para o Protheus. O processo de inclusão do orçamento das tabelas SL1, SL2 e SL4 passa por toda a validação de registros do modulo SIGALOJA. O registro totalmente validado é incluído para próxima etapa, quaisquer informações invalidas identificado nesse processo ira retornar uma critica a integração E-Commerce
• Serviço Gravabatch - Esse serviço é responsável pelo processamento do orçamento das tabelas incluídas pela MP - RetailSales. Para as vendas que estejam campo L1_SITUA = RX, este serviço tem como objetivo: Gerar as tabelas SL1,SL2 e SL4. Caso seja encontrado alguma inconsistência no processamento deste serviço o campo L1_SITUA é atualizado para ER. Caso o processamento da venda seja finalizado com sucesso o campo L1_SITUA é atualizado para FR.

Importante: Apos explodir o orçamento SL1 o registro Pai é atualizado o campo L1_SITUA = FR e criará o registro filho com o campo L1_SITUA em branco. Qualquer mudança desses registros falhará no envio da tag RetailSalesInternalId na próxima MP - DocumentTraceAbilityOrderRetail.

Para auxiliar na analise de erros ou criticas é possível habilitar o log do loja, abaixo segue a documentação do log:

SIGALOJA 0290 Quais são os logs auxiliares Protheus Varejo?

• Após a geração das tabelas SL1,SL2 e SL4, acessando a rotina de Venda Assistida (LOJA701):
  • No menu "Outras Ações/Confirmar Pedido Pendente", efetue a liberação do pedido - que estará com o status na cor roxa - com isso será gerada a mensagem padronizada DocumentTraceAbilityOrderRetail com o Status "Empacotado" contendo os dados do retorno da sefaz no bloco DocumentContent.
  • Finalizando esse orçamento com item de pedido do tipo retira, será gerada a mensagem padronizada DocumentTraceAbilityOrderRetail com o Status "Entregue".
  • Efetuando o cancelamento do orçamento pai ( o filho não pode ser excluído pois é um pedido retira )  será gerada a mensagem padronizada DocumentTraceAbilityOrderRetail com o status "Cancelado".
  • Para maiores informações da mensagem DocumentTraceAbilityOrderRetail, acesse: DocumentTraceAbilityOrderRetail - Pedido Retira

7 - Utilizando Tes no Produto ou Tes Inteligente 

Para gravação de dados do Orçamento (Tabela SL1), é necessário a amarração da TES no produto ou configuração da TES Inteligente.

 Para a utilização da TES no produto deve ser incluído no campo TS Padrao (Campo B1_TS) como mostra o exemplo abaixo:

Image Added

Agora para utilização da TES Inteligente por default da Mensagem Padronizada utilizamos a informação existente na tag "OperationCode": "01" dentro do bloco "SaleItem", assim procuramos na tabela SFM - TES Inteligente se existe uma regra com a operação 01, caso não exista a configuração infomara a seguinte mensagem: "Inconsistência no item numero do item TES não informada, verifique o Cadastro de Produto no Protheus campo B1_TS e/ou De-Para de TES(XXF) e/ou as configurações para TES Inteligente(DHJ e SFM) e/ou parâmetros MV_TESSERV e MV_TESVEND."

Seguir orientações do ERP para TES Inteligente, exemplo abaixo:

Image Added

7.1 - Cenário onde pode ser usado a Tes Inteligente no orçamento SL1, SL2 e/ou SC5, SC6

• Orçamento SL1 e SL2: a TES inteligente configurada para o Tp. de Operação recebida na tag OperationCode "valor padrão 01" deve gerar financeiro, pois é nesse momento que as informações de pagamento serão gravadas.
• Pedido de Venda SC5 e SC6: a TES inteligente configurada para o Tp. de Operação "V" não deve gerar financeiro, pois as informações de pagamentos, foram geradas no passo anterior, ou seja, na gravação do orçamento(SL1/SL2).

Importante: Para realizar a busca da TES Inteligente, o parâmetro MV_LJTESPE deverá estar em branco.

8- Geração do Contas a Receber (SE1)

A geração dos dados do Contas a Receber (SE1), ocorre após a execução do Job de Integração de Vendas (LJGRVBATCH) e depende da

TES-Tipo de Entrada e Saída configurada e segue a sequência:

• Pesquisa da TES Inteligente rotina MaTesInt, caso não encontre, segue;
• Pesquisa da TES na tabela SBZ-Indicadores de Produtos, caso não encontre, segue;
• Pesquisa da TES no campo Tipo de Saída do Produto (B1_TS) de acordo com o produto encontrado, caso não encontre, segue;
• Valida se a venda é um RPS, se sim, busca a TES no parâmetro MV_TESSERV, caso contrário;
• Caso não ache seja RPS, busca a TES para o produto no parâmetro MV_TESVEND;
• Ao final, se nenhuma TES for encontrada haverá retorno com mensagem de inconsistência e o processo de integração não ocorrerá;

Importante:

A TES - Tipo de Entrada e Saída configurada deve ter basicamente esses campos preenchidos:

• Do tipo 'Saída': F4_CODIGO maior ou igual a 500;
• Gera Duplicata (F4_DUPLIC) igual a S;
• Gera Estoque (F4_ESTOQUE) igual a S;

Nos pedidos que contem itens do tipo "1-Retira Posterior" (Campo L2_ENTREGA igual a 1) os orçamentos filhos terão

o Contas a Receber gerado após a finalização do orçamento como venda.

9- Relacionamento entre Orçamento, Pedido de Venda, Pedidos Liberados e Contas a Receber

Relacionamento entre tabelas de Orçamento(Venda Assistida), Pedido de Venda, Pedidos Liberados (Faturamento) e Contas a Receber(Financeiro)

Colocar motivo de não permitir alteração de pedido no Faturamento.

Para encontrar os Pedido de Venda (SC5) e Contas a Receber (SE1) a partir do Orçamento (SL1) pode ser realizado dos campos:

SL1 - L1_FILIAL,  L1_ECPEDEC, L1_DOCPED, L1_SERPED 

SC5 - C5_FILIAL, C5_PEDECOM

SE1 - E1_FILIAL, E1_PREFIXO, E1_NUM

Para encontrar os Pedidos Liberados (SC9) a partir do Pedido de Venda (SC5) pode ser realizado dos campos:

SC9 - C9_FILIAL, C9_PEDIDO

Relacionamento entre as tabelas e campos:

L1_ECPEDEC = C5_PEDECOM
L1_DOCPED = E1_NUM
L1_SERPED = E1_PREFIXO
C9_PEDIDO = C5_NUM

A tabela de cabeçalho da Nota (SF2) é gerada após o Faturar o Pedido pelo módulo do Faturamento, onde:

F2_DOC = C5_NOTA

Para identificar o registro de Orçamento (SL1) que gerou o título financeiro (SE1), relaciona-se:

E1_NUM + E1_PREFIXO = L1_DOCPED + L1_SERPED

Também é possível localizar/relacionar o título financeiro com base no número do documento do e-commerce (L1_ECPEDEC e C5_PEDECOM), para isso, é necessário que o campo E1_NRDOC possua o mesmo tamanho.

E1_NRDOC = C5_PEDECOM

10- Exemplo das mensagens

10.1 - RetailSales - com item do tipo "Entrega"

{
	"Header": {
		"

{
	"Header": {
		"GeneratedOn": "Thu, 23 Apr 2020 17:02:20 GMT",
		"BranchId": "D MG 01",
		"DeliveryType": "async",
		"ProductName": "ECOMMERCE",
		"Type": "BusinessMessage",
		"Transaction": "RetailSales",
		"Version": "2.000",
		"UUID": "61e91b9e-e030-40d6-b0fd-dcf63e81c966",
		"SubType": "Event",
		"Event": "upsert",
		"CompanyId": "T1",
		"SourceApplication": "ECOMMERCE",
		"ProductVersion": "1.0.0"
	},
	"Content": {
		"items": null,
		"OperatorCode": "AUTOMATICO",
		"ECommerceOrder": "1027293590055-01",
		"Event": "upsert",
		"NetPrice": 203,
		"InternalId": "15da928b-9e88-4947-a508-8cdd56beabd9",
		"CarrierInternalId": "01",
		"ListOfSaleItem": {
			"SaleItem": [
				{
					"ItemOrder": 1,
					"ItemCode": "d077bf8a-bbbb-4549-9b00-1a203cfe4428",
					"UnitPrice": 18.6,
					"ItemDeliveryType": "3",
					"ItemReserveInternalId": "15da928b-9e88-4947-a508-8cdd56beabd9",
					"ItemInternalId": "d077bf8a-bbbb-4549-9b00-1a203cfe4428",
					"ItemPrice": 93,
					"InternalId": "C14B0CB7AE00430C86475D908AAB843A",
					"FreightValueProrated": 5,
					"OperationCode": "01",
					"Quantity": 5
				},
				{
					"ItemOrder": 2,
					"ItemCode": "69dbb151-bbe6-4547-853a-0342ace00eab",
					"UnitPrice": 55,
					"ItemDeliveryType": "3",
					"ItemReserveInternalId": "15da928b-9e88-4947-a508-8cdd56beabd9",
					"ItemInternalId": "69dbb151-bbe6-4547-853a-0342ace00eab",
					"ItemPrice": 55,
					"InternalId": "77B3D9FC812B47148AF774F44F9C6EF7",
					"FreightValueProrated": 5
					"OperationCode": "01",
					"Quantity": 1
				},
				{
					"ItemOrder": 3,
					"ItemCode": "79f93baf-39ac-40de-ae73-007a256dda31",
					"UnitPrice": 55,
					"ItemDeliveryType": "3",
					"ItemReserveInternalId": "15da928b-9e88-4947-a508-8cdd56beabd9",
					"ItemInternalId": "79f93baf-39ac-40de-ae73-007a256dda31",
					"ItemPrice": 55,
					"InternalId": "F4A61206DEF543E0A613EB63D1141E1D",
					"FreightValueProrated": 5,
					"OperationCode": "01",
					"Quantity": 1
				}
			]
		},
		"StationSalePointInternalId": "AUTOMATICO",
		"ListOfSaleCondition": {
			"SaleCondition": [
				{
					"UniqueSerialNumber": "004112",
					"DateOfPayment": null,
					"PaymentValue": 203,
					"PaymentMethodCode": "CC",
					"FinancialManagerCode": "CAR"
				}
			]
		},
		"DocumentCode": "1027293590055-01",
		"IntermediaryCode": "000001",
		"PresencialIndicator": "1",
		"FreightValue": 15,
		"CarrierCode": "01",
		"IssueDateDocument": "2020-04-23T17:01:06.625349+00:00",
		"CustomerVendorInternalId": "44dca035-dbbe-4aef-8c1e-c2a4acb4f88a",
		"SaleType": "V",
		"GrossPrice": 203,
		"TotalPrice": 203,
		"PersonalIdentification": "1027293590055-01",
		"DiscountValue": 0
	}
}

...

Composição da Tag: Soma dos itens, subtraindo os descontos(item/total) e sem considerar/somar os acréscimos(frete,seguro,despesa)

...

Composição da Tag: Valor do frete total (soma FreightValueProrated)

Tags do JSON - Itens:

...

• IncreaseValue - tag que define o

...

• valor do acrescimo no total, gravado no campo

...

• L1_

...

• DESPESA, tag facultativa.

Composição da Tag: Valor do acrescimo total (soma IncreaseValueProrated)

Tags do JSON - Itens:

ItemTablePrice - tag que define o preço de tabela do produto, gravado no campo L2_PRCTAB, tag facultativa - tag facultativa - caso não seja enviada ou zerada recebe o conteúdo da tag UnitPrice.

...

FreightValueProrated - tag que define o valor rateado de frete do total, nos itens, gravado no campo L2_VALFRE, tag facultativa.

IncreaseValueProrated- tag que define o valor rateado de acrescimo no itens, gravado no campo L2_DESPESA, tag facultativa.

Tags do JSON - Pagamento:

...

"Content": {        
        "TotalPrice": 3520,
        "DiscountValue": 0,
        "NetPrice": 35,
        "GrossPrice": 35,
        "CommodityPrice": 3520,
        "FreightValue": 15,
		"ListOfSaleItem": {
            "SaleItem": [{
                    "Quantity": 2,
                    "ItemTablePrice": 10,
                    "UnitPrice": 10,
                    "ItemPrice": 20,
                    "FreightValueProrated": 15,
                    "DiscountAmount": 0,
                }
            ]
        },
		"ListOfSaleCondition": {
        "SaleCondition": [
            {
                "PaymentValue": 35,
                "PaymentMethodCode": "R$",
                "FinancialManagerCode": "",
                "DateOfPayment": "2021-06-18",
                "UniqueSerialNumber": null
            }
        ]
    }
}

...

"Content": {        
        "TotalPrice": 30,
        "DiscountValue": 0,
        "NetPrice": 30,
        "GrossPrice": 30,
        "CommodityPrice": 35,
        "FreightValue": 15,
		"ListOfSaleItem": {
            "SaleItem": [{
                    "Quantity": 2,
                    "ItemTablePrice": 10,
                    "UnitPrice": 7.5,
                    "ItemPrice": 15,
                    "FreightValueProrated": 15,
                    "DiscountAmount": 5,
                }
            ]
        },
		"ListOfSaleCondition": {
        "SaleCondition": [
            {
                "PaymentValue": 30,
                "PaymentMethodCode": "R$",
                "FinancialManagerCode": "",
                "DateOfPayment": "2021-06-18",
                "UniqueSerialNumber": null
            }
        ]
    }
}

11- Configuração de Administradora Financeira - Geração de Contas a Receber calculo de Data de Vencimento 

Para Formas de pagamento CC - Cartão de Credito o Protheus trabalha a partir do cadastro da Administradora Financeira.

Com a regra configurada na Administradora Financeira o calculo do vencimento será da seguinte forma: Data de Pagamento + Regra da administradora

Abaixo um exemplo de como ficará a data de vencimento:

Venda realizada no dia 05/12, primeira parcela 05/01, porém na Administradora Financeira o campo "Virar em"(AE_DIAS) está preenchido com número 30 e o vencimento do titulo será 05/01 + 30 dias (repetindo para todas as parcelas Ex: 05/02 + 30, 05/03 + 30.)

Links para melhor entendimento das configurações na Administradora Financeira:

Como configurar uma administradora financeira:

https://centraldeatendimento.totvs.com/hc/pt-br/articles/115012459768-MP-SIGALOJA-Como-cadastrar-uma-administradora-Financeira

----------

...

11.1 - Configuração de campos para armazenar o NSU da transação TEF

Caso a numeração de NSU do TEF seja maior que o padrão do Protheus ( Tag UniqueSerialNumber da mensagem padronizada), os campos abaixo devem ser ajustados e possuir o mesmo tamanho:

Campos de tabelas do Varejo: L1_NSUTEF, L4_NSUTEF, LQ_NSUTEF

Campos de tabelas do Financeiro: E1_NSUTEF, MDK_NSUTEF, FIF_NSUTEF

Link com documentação sobre o conciliador do financeiro que utiliza esses campos: https://tdn.totvs.com/display/public/PROT/Conciliador+TEF+-+Financeiro+-+P12

Em caso de dúvidas sobre conciliação de pagamentos, deverá ser acionado o time de suporte do Financeiro. 

12- Tabela de Ocorrências na geração de Pedido de Venda: RetailSales

...

Ação

...

Quantidade do produto não informado 

...

Reserva não encontrada

Não encontrado de/para de reserva

...

Verificar se integrou a reserva adapter - ItemReserve.

Verificar se o de/para de reserva foi criado corretamente.

...

Mensagem de Erro:

Reserva (valor externo) - Já foi usada ou difere com a quantidade reservada (C0_QTDORIG) com a quantidade (valor da tag) recebida na TAG Quantity.

...

Verificar o de/para de reserva e identificar se esta correta a quantidade na tag Quantity no bloco ListOfSaleItem.

Verificar na tabela SC0 se já houve a exclusão do registro, com isso, a reserva já foi usada ou cancelada manualmente.

...

Mensagem de Erro:

Armazém 01 retornado no de/para da tag (WarehouseInternalid) não é o mesmo armazém (C0_LOCAL) 02 da reserva numero: 000001.

...

Mensagem de Erro:

Não existe um Lote que consiga atender a quantidade solicitada(x). Verifique o Saldo por Lote!

...

Verifique o estoque por Lote, porque a quantidade solicitada não é atendida por nenhum lote.

A tag "DetailedMessage" ira trazer o saldo disponivel por Lote para analise.

{

"Code": "001",
"Message": "Não existe um Lote que consiga atender a quantidade solicitada(300). Verifique o Saldo por Lote!",
"DetailedMessage": "{\"Item\":[{\"LotNumber\":\"LOTE_FEVER\",\"SubLotNumber\":\" \",\"ItemCode\":\"LOTE\",\"AvailableStockAmount\":16,\"AddressingItem\":\"\",\"SeriesItem\":\"\"},{\"LotNumber\":\"LOTE_MARÇO\",\"SubLotNumber\":\" \",\"ItemCode\":\"LOTE\",\"AvailableStockAmount\":20,\"AddressingItem\":\"\",\"SeriesItem\":\"\"},{\"LotNumber\":\"LOTE_ABRIL\",\"SubLotNumber\":\" \",\"ItemCode\":\"LOTE\",\"AvailableStockAmount\":18,\"AddressingItem\":\"\",\"SeriesItem\":\"\"}]}",
"HelpUrl": ""

}

...

Não encontrado de/para de forma de pagamento

Não cadastrado ou não encontrado de/para de Administradora Financeira

...

...

Quero mudar a série que meu orçamento (SL1) é gerado e a série do contas a receber (SE1)

Campos(E1_PREFIXO/L1_SERPED)

São gravados conforme o padrão do Venda Assistida com base na estação utilizada na venda.

...

Verificar na tag StationSalePointInternalId o código da estação configurado no De/Para do Protheus e altere o campo SÉRIE (LG_SERIE) no Cadastro de Estação (SLG - rotina LOJA121) relacionada.

Obs.: Por padrão é utilizado uma estação automática (StationSalePointInternalId = AUTOMATICA), para customizar, basta informar nessa TAG um valor de referência para localizar a estação no cadastro de de/para.

...

Ao tentar excluir uma reserva emite-se a mensagem:

"Este orçamento não poderá ser excluído porque se trata de um orçamento com reserva"

...

Verificar a relação de campos, parâmetros e outras informações importantes a serem verificadas e configuradas para que o sistema faça os cálculos de arredondamento corretamente.

SIGAFRT_SIGALOJA_0047_Como evitar diferença de centavos no arredondamento dos ambientes SIGALOJA e SIGAFRT?

10.4.6 - Exemplo de envio - VENDA com Acrescimo  (JSON recortado somente com a tags importantes para entendimento):

Produto 1 - Preço Unitário = $700 + Acrescimo rateado = $41,92 ( o valor do proporcionalizado equivale a 83,84% do total da venda)

Produto 2 - Preço Unitário = $135 + Acrescimo rateado = $8,08 ( o valor do proporcionalizado equivale a 16,17% do total da venda)

total da Venda = $885 

"Content": {
		"items": null,
		"GrossPrice": 885,
		"ECommerceOrder": "1200873417041-01",
		"StationSalePointInternalId": "AUTOMATICO",
		"NetPrice": 885,
		"CommodityPrice": 835,
		"InternalId": "30ed312c-9ff5-4939-a940-8b11021bfFA",
		"CarrierCode": "01",
		"ListOfSaleItem": {
			"SaleItem": [
				{
					"ItemOrder": 1,
					"XItemCode": "d077bf8a-bbbb-4549-9b00-1a203cfe6650",
					"UnitPrice": 700,
					"ItemDeliveryType": "3",
					"ItemReserveInternalId": "b1e5d0d4-ceee-4e3b-9808-1db111c2f7FC",
					"ItemInternalId": "d077bf8a-bbbb-4549-9b00-1a203cfe6650",
					"ItemPrice": 700,					
					"FreightValueProrated": 0,
					"OperationCode": "01",
					"Quantity": 1,
					"IncreaseValueProrated": 41.92
				},
				{
					"ItemOrder": 1,
					"XItemCode": "30ed312c-9ff5-4939-a940-8b11021beb7e",
					"UnitPrice": 135,
					"ItemDeliveryType": "3",
					"ItemReserveInternalId": "b1e5d0d4-ceee-4e3b-9808-1db111c2f7FC",
					"ItemInternalId": "30ed312c-9ff5-4939-a940-8b11021beb7e",
					"ItemPrice": 135,					
					"FreightValueProrated": 0,
					"OperationCode": "01",
					"Quantity": 1,
					"IncreaseValueProrated": 8.08
				}				
			]
		},
		"Event": "upsert",
		"ListOfSaleCondition": {
			"SaleCondition": [
				{
					"DateOfPayment": "2022-03-30T00:00:00",
					"PaymentValue": "885",
					"PaymentMethodCode": "CC",
					"FinancialManagerCode": "CARTAO",
					"UniqueSerialNumber": "",
					"EftDate": "",
					"EftAutorization": "",
					"EftInstitute": "",
					"EftDocument": ""
				}
			]
		},
		"DocumentCode": "000000595",
		"FreightValue": 0,
		"IncreaseValue": 50,		
		"IssueDateDocument": "2022-03-30T17:00:39.01118+00:00",
		"CustomerVendorInternalId": "c5a7a767-3bae-4f0c-af28-d1ed5ef58766",
		"TotalPrice": 835,
		"DiscountValue": 0,
		"SaleType": "V",
		"OperatorCode": "AUTOMATICO"
	}

11- Configuração de Administradora Financeira - Geração de Contas a Receber calculo de Data de Vencimento 

Para Formas de pagamento CC - Cartão de Credito o Protheus trabalha a partir do cadastro da Administradora Financeira.

Com a regra configurada na Administradora Financeira o calculo do vencimento será da seguinte forma: Data de Pagamento + Regra da administradora

Abaixo um exemplo de como ficará a data de vencimento:

Venda realizada no dia 05/12, primeira parcela 05/01, porém na Administradora Financeira o campo "Virar em"(AE_DIAS) está preenchido com número 30 e o vencimento do titulo será 05/01 + 30 dias (repetindo para todas as parcelas Ex: 05/02 + 30, 05/03 + 30.)

Links para melhor entendimento das configurações na Administradora Financeira:

Como configurar uma administradora financeira:

https://centraldeatendimento.totvs.com/hc/pt-br/articles/115012459768-MP-SIGALOJA-Como-cadastrar-uma-administradora-Financeira

----------

Como é definido o vencimento do titulo financeiro para formas com administradora financeira ?
https://tdn.totvs.com/pages/releaseview.action?pageId=525033971

----------
Como fixo o dia de vencimento das parcelas conforme o vencimento da primeira parcela?
https://tdn.totvs.com/pages/releaseview.action?pageId=225264318

----------
Gerar taxa da administradora financeira no contas a pagar?
https://tdn.totvs.com/pages/releaseview.action?pageId=224442986

11.1 - Configuração de campos para armazenar o NSU da transação TEF

Caso a numeração de NSU do TEF seja maior que o padrão do Protheus ( Tag UniqueSerialNumber da mensagem padronizada), os campos abaixo devem ser ajustados e possuir o mesmo tamanho:

Campos de tabelas do Varejo: L1_NSUTEF, L4_NSUTEF, LQ_NSUTEF

Campos de tabelas do Financeiro: E1_NSUTEF, MDK_NSUTEF, FIF_NSUTEF

Link com documentação sobre o conciliador do financeiro que utiliza esses campos: https://tdn.totvs.com/display/public/PROT/Conciliador+TEF+-+Financeiro+-+P12

Em caso de dúvidas sobre conciliação de pagamentos, deverá ser acionado o time de suporte do Financeiro. 

12- Tabela de Ocorrências na geração de Pedido de Venda: RetailSales

13- Cancelamentos

Cancelamento de reserva (Pagamento da venda não confirmado no E-Commerce)

• Neste cenário ainda não temos o pedido integrado no Protheus, somente a reserva integrada.
• Após o cancelamento do pedido no E-commerce, é enviado ao Protheus a mensagem ItemReserve com o evento DELETE, visando realizar o cancelamento desta reserva no Protheus.
• Ao recepcionar a mensagem, é realizado todo o fluxo de cancelamento da reserva e após sua finalização é enviado um response da mensagem ItemReserve  ao E-Commerce com o status ok, caso a reserva tenha sido cancelada corretamente.

Cancelamento de Venda não faturada

• Deve ser realizado no módulo Controle de Lojas (SIGALOJA), na rotina Venda Assistida (LOJA701), onde o orçamento pai deverá ser cancelado para que o orçamento filho (reserva) também seja deletado.

Image Added

Cancelamento de Venda Faturada

• Será necessário realizar manualmente a devolução do pedido, através da rotina LOJA720 Rotina de Troca. Após realizar a devolução da venda integrada, será gerada e enviada ao E-Commerce a mensagem DocummentTraceAbilityOrder, com o status Devolvido.
• No E-Commerce deverá ser atualizado o status da venda.

Image Added

14- Onde consultar demais informações sobre configurações do módulo Venda Assistida?

Abaixo link com a FAQ do Varejo:

https://tdn.totvs.com/display/public/PROT/SIGALOJA

6.1.2. Parâmetros Gerais

15- Status de Pedido - DocumentTraceAbilityOrder

16- Como é fluxo de geração de Pedido x Financeiro?

Image Added

13- Cancelamentos

Cancelamento de reserva (Pagamento da venda não confirmado no E-Commerce)

• Neste cenário ainda não temos o pedido integrado no Protheus, somente a reserva integrada.
• Após o cancelamento do pedido no E-commerce, é enviado ao Protheus a mensagem ItemReserve com o evento DELETE, visando realizar o cancelamento desta reserva no Protheus.
• Ao recepcionar a mensagem, é realizado todo o fluxo de cancelamento da reserva e após sua finalização é enviado um response da mensagem ItemReserve  ao E-Commerce com o status ok, caso a reserva tenha sido cancelada corretamente.

Cancelamento de Venda não faturada

• Deve ser realizado no módulo Controle de Lojas (SIGALOJA), na rotina Venda Assistida (LOJA701), onde o orçamento pai deverá ser cancelado para que o orçamento filho (reserva) também seja deletado.

Image Removed

Cancelamento de Venda Faturada

• Será necessário realizar manualmente a devolução do pedido, através da rotina LOJA720 Rotina de Troca. Após realizar a devolução da venda integrada, será gerada e enviada ao E-Commerce a mensagem DocummentTraceAbilityOrder, com o status Devolvido.
• No E-Commerce deverá ser atualizado o status da venda.

Image Removed

14- Onde consultar demais informações sobre configurações do módulo Venda Assistida?

Abaixo link com a FAQ do Varejo:

https://tdn.totvs.com/display/public/PROT/SIGALOJA

6.1.2. Parâmetros Gerais

15- Como é fluxo de geração de Pedido x Financeiro?

...

Importante: Realizar o checklist abaixo para validar se todas as etapas obrigatórias foram realizadas

•  

  1 - Configurações iniciais

  
  

•  1.1 - Versão SmartClient
  1.2 - Serviço REST
  1.3 - String > 30mb
  1.4 - Schedule para Mensagem Padronizada
  1.5 - Expedição Varejo
•   
•  2 - Validação da lista de parâmetros
•  3 - Cadastro de Adapter
•  4 - Identificação de Lojas
•  5 - Cadastro de "De/Para"
•  6 - Entendimento sobre o fluxo de integração de Pedido Entrega e Retira
•  7 - Tes no Produto ou Tes Inteligente 
•  8 - Gravabatch
•  9 - Entendimento sobre os relacionamentos de tabelas (Loja,Financeiro e Faturamento)
•  10 - Exemplo de mensagem padronizada
•  11 - Administradora Financeira
•  12 - Tabela de possíveis ocorrências de rejeição da mensagem padronizada

...