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)
...
Parâmetro/PE | Tipo | Descrição | Exemplo de Conteúdo | Observação | |||
---|---|---|---|---|---|---|---|
MV_LJECOMO | L | E-commerce CiaShop .T. (Ativo) .F. (Desativado)
| .F. | Colocar obrigatoriamente falso (.F.) Importante: Não existe compatibilidade para o funcionamento simultâneo das integração CiaShop e VTEX, para funcionar VTEX a integração com CiaShop deverá ser desligada. | |||
MV_LJECOMMLJVFNFS | L | Identifica que o sistema utiliza E-commerce .T. (Ativo) .F. (Desativado)
| .F. | Colocar obrigatoriamente falso (.F.) Importante: Não existe compatibilidade para o funcionamento simultâneo das integração CiaShop e VTEX, para funcionar VTEX a integração com CiaShop deverá ser desligada. | Define a utilização da emissão de nota fiscal de simples faturamento na venda futura: .T. para habilitar ou .F. para desabilitar. Conteúdo padrão: .F. | .F. | Quando o conteudo do parametro esta ativo (.T.), a venda é integrada normalmente nas tabelas SL1, SL2 e SL4, porém é gerado dois pedidos de venda nas tabelas (SC5) e (SC6) sendo que o primeiro pedido de venda (O que esta vinculado no campo L1_PEDRES), é utilizado para o simples faturamento, gerando o documento de saída automaticamente. O segundo Pedido de venda deve ser utilizado para o faturamento normal emissão da NFe à Sefaz. |
MV_LJECOMM | L | Identifica que o sistema utiliza E-commerce .T. (Ativo) .F. (Desativado)
| .F. | Colocar obrigatoriamente falso (.F.) Importante: Não existe compatibilidade para o funcionamento simultâneo das integração CiaShop e VTEX, para funcionar VTEX a integração com CiaShop deverá ser desligada. | |||
MV_MV_TABPAD | C | Preço Padrão para digitação de vendas | 001 | Deve possuir o código cadastrado na tabela de preços DA0 para referência. Importante: Esse parâmetro não define regras de preço para o E-commerce, o preço recebido via integração não é modificado, esse parâmetro é necessário por regras do módulo SIGALOJA. | |||
MV_RESEST | L | Indica se o estoque deve ser reservado para clientes que possuem bloqueio de credito. | .T. | Recomenda-se habilitar esse parâmetro com integração VTEX para gerar a liberação do pedido e reservar o estoque mesmo quando o crédito estiver bloqueado (Boleto por exemplo). | |||
MV_LJIFPLI | C | Define as formas de pagamento para geração de pedido de venda liberado para faturamento, ou seja, sem nenhum tipo de bloqueio financeiro. | FI|CC|R$ | Importante: Somente informar as formas que tem confirmação de pagamento na camada do e-commerce. Exemplo: Caso utilize boleto sem a confirmação de pagamento pela VTEX, não deverá informar o boleto nesse parâmetro, caso isso ocorra, um pedido que ainda não teve o boleto pago, poderá ser liberado para o faturamento após a integração. | |||
MV_LJGERSC | N | Se utiliza o conceito de gerar Solicitação de Compras para reserva sem estoque. | 4 | Para MarketPlace como o Pedido já vem fechado recomenda-se o uso deste parâmetro = 4 (Permite reserva sem estoque e não gera solicitação de compras) para permitir reservar mesmo sem o estoque. Obs: As configurações para geração automática de solicitação de compra não são compatíveis para a integração do e-commerce Importante: Quando configurado com a opção 4 é possível realizar reserva sem saldo para produtos que controlam Lote e/ou Endereçamento porém, ao integrar a venda | , o pedido gerado no faturamento | ficara ficará bloqueado por saldo em estoque (C9_BLEST = 02) devido ao produto ter controle de Lote e/ou Endereçamento. Com isso, é necessário realizar a inclusão de saldo por Lote(SB8) ou Endereçamento(SBF). | |
MV_LJTESPE | C | Define qual o TES será utilizado para a geração do Pedido de Venda por meio da rotina Venda Assistida. O parâmetro pode ser macro-executado. | 501 | Para utilização da TES Inteligente, esse parâmetro deverá estar em branco. | |||
MV_LJPEDVE | L | Define a utilização da emissão de Pedidos de Venda através da rotina de Venda Assistida. | .T. | O parâmetro deve ficar obrigatoriamente .T. para emissão do pedido de venda, essa configuração é padrão para seguir o fluxo de pedido com entrega no módulo de Venda Assistida. (SIGALOJA 0196 Como habilitar a emissão de pedido de venda na Rotina Venda Assistida?) Obs.: Usuários CiaShop não precisavam habilitar esse parâmetro, pois o fluxo para geração do Pedido não era o mesmo do Venda Assistida. | |||
MV_LJCONDP | C | Determina a Condição de Pagamento que será utilizada para a emissão do Pedido de Venda através da rotina de Venda Assistida. Esta condição de pagamento é meramente informativa pois o TES utilizado não pode gerar movimento financeiro. | 001 | Importante: É necessário verificar se existe Condição de Pagamento cadastrada na tabela SE4 - Condições de Pagamento, para informar no parâmetro. (SIGALOJA 0196 Como habilitar a emissão de pedido de venda na Rotina Venda Assistida?) Obs: Os pagamentos contidos no XML enviado a SEFAZ são com base os pagamentos do orçamento (Tabela SL4 ), sendo assim, a condição de pagamentos contida no pedido de venda está presente apenas para preencher uma obrigatoriedade do pedido de venda, não sendo utilizada para a geração do XML. | |||
MV_LJTPFRE | C | Tipo de frete para o processo de integração de venda via mensagem padronizada RetailSales. | F | O parâmetro pode ser macro-executado. Para isso, ele deve iniciar com & e em seguida com a função a ser chamada. Exemplo: &U_EXEMPLO(). Caso não seja eleito um Tipo de Frete diferente do permite no campo será informado uma critica e não integrará a orçamento/venda. Para maiores informações acesse: https://tdn.engpro.totvs.com.br/display/public/PROT/MV_LJTPFRE | |||
MV_VALCNPJ | C | Parâmetro do módulo de Faturamento, define se permite ter mais de um cliente com o mesmo CNPJ | 1 | Esse parâmetro é importante para a integração VTEX para permitir múltiplos endereços, mais informações no link: https://tdn.totvs.com/display/public/PROT/DSERFAT-20178+DT+EAI+Adapter+CustomerVendor+-+Clientes | |||
MV_VALCPF | C | Parâmetro do módulo de Faturamento, define se permite ter mais de um cliente com o mesmo CPF | 1 | Esse parâmetro é importante para a integração VTEX para permitir múltiplos endereços, mais informações no link: https://tdn.totvs.com/display/public/PROT/DSERFAT-20178+DT+EAI+Adapter+CustomerVendor+-+Clientes | |||
MV_LJE1NUM | C | Define padrão de número na geração do título financeiro | 1 | Para mais informações: DT_MV_LJE1NUM | |||
MV_LJTDESI | N | Para controlar o tipo de desconto na integração RetailSales 0 = desligado padrão, 1 = desconto no campo Indenização. | 0 | Parâmetro usado para desconto no total da venda, onde muda o desconto no pedido de venda para o campo Indenização (C5_DESCONT). | |||
MV_LJCTRES | L | Verifica se controla quantidade reservada para o cliente que efetuou a compra. | .T. | Na criação da reserva a quantidade é empenhada no estoque, caso houver necessidade de cancelamento o empenho é retornado ao estoque. | |||
LJI701O1 | PE | Ponto de entrada para customizar os dados recebidos na integração. Seu uso não é obrigatório e o conteúdo customizado não é avaliado pelo time de produto, conforme ocorre com demais pontos de entrada do Protheus. Somente deverá ser utilizado se houver a necessidade de customizar algum dado recebido pela camada da VTEX. Ele permite alterar o valor das tags dos itens que foram recebidas pela mensagem única RetailSales. | Documentação: Ponto de entrada LJI701O1 | ||||
LJI701O2 | PE | Ponto de entrada para liberação da alteração do pedido de venda, gerados pela mensagem única RetailSales | Documentação: Ponto de entrada LJI701O2 | ||||
LJDEPSE1 | PE | Este Ponto de Entrada é acionado na finalização do Venda Assistida após a gravação do título a receber na tabela SE1, possibilitando que sejam realizadas gravações complementares no titulo inserido. O registro inserido fica posicionado para uso no Ponto de Entrada. | Documentação: LJDEPSE1 - Ponto de entrada após a gravação do título a receber (SE1) | ||||
MV_DTLIMIT | N | Parâmetro para determinar a validade de um orçamento com ou sem reserva. | Documentação: https://centraldeatendimento.totvs.com/hc/pt-br/articles/115015439487-MP-SIGALOJA-Como-determinar-a-validade-de-um-or%C3%A7amento-com-ou-sem-reserva | ||||
MV_LJIPIFR | N | Define se quando produto possui cálculo de IPI com frete na base, será realizado o cálculo reverso no valor do frete da venda integrada. 0 (Padrão) = Desativado , 1 = Ativado | 0 | Realiza o calculo reverso de IPI no valor do Frete, para mais detalhes: Cálculo de reversão de IPI no valor do frete | |||
MV_LJCFPDP | N | Determina se a funcionalidade de Confirmar Pedido Pendente esta ativa: 0 = Desabilitado 1 = Habilitado 2 = Automático | 0 | Documentação: DT Venda Assistida com opção Confirma Pedido Pendente |
3- Adapter
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.
...
- 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
...
- 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
...
https://tdn.totvs.com/display/public/PROT/SIGALOJA
15
...
- Status de Pedido - DocumentTraceAbilityOrder
Dica | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||
Como funciona a integração de Rastreio de Pedido entre o TOTVS Protheus e Vtex? Após a integração de um pedido do tipo entrega, qualquer atualização que o mesmo tiver no Protheus, será gerado e enviado à mensagem DocumentTraceAbilityOrder, ao Vtex, com o status do pedido no Protheus. Quais são os status de rastreio de pedido que o Protheus envia ao Vtex? Os status de rastreio de pedido são os seguintes:
|
16- Como é fluxo de geração de Pedido x Financeiro?
Aviso | ||
---|---|---|
| ||
Os pagamentos contidos no XML enviado a SEFAZ são com base os pagamentos do orçamento (Tabela SL4 ), sendo assim, a condição de pagamentos contida no pedido de venda está presente apenas para preencher uma obrigatoriedade do pedido de venda, não sendo utilizada para a geração do XML. |
...
-
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
...