Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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 Protheushttps://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)

...

, ficara
Parâmetro/PETipoDescriçãoExemplo de Conteúdo

Observação

MV_LJECOMOL

E-commerce CiaShop .T. (Ativo) .F. (Desativado)

  • Integração Antiga
.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)

  • Integração AntigaOperationCode
.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_LJECOMML

Identifica que o sistema utiliza E-commerce .T. (Ativo) .F. (Desativado)

  • Integração AntigaOperationCode
.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_TABPADCPreço Padrão para digitação de vendas001Deve 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_RESESTLIndica 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_LJIFPLIC

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_LJGERSCN

Se utiliza o conceito de gerar Solicitação de Compras para reserva sem estoque.

SIGALOJA 0357 Qual a finalidade do parâmetro MV_LJGERSC ?

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

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_LJTESPEC

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_LJPEDVELDefine 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_LJCONDPC

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 CTipo 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_VALCNPJCParâmetro do módulo de Faturamento, define se permite ter mais de um cliente com o mesmo CNPJ1

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_VALCPFCParâmetro do módulo de Faturamento, define se permite ter mais de um cliente com o mesmo CPF1

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_LJE1NUMCDefine padrão de número na geração do título financeiro1Para mais informações: DT_MV_LJE1NUM
MV_LJTDESINPara controlar o tipo de desconto na integração RetailSales 0 = desligado padrão, 1 = desconto no campo Indenização.0Parâmetro usado para desconto no total da venda, onde muda o desconto no pedido de venda para o campo Indenização (C5_DESCONT).
MV_LJCTRESLVerifica 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.
LJI701O1PE

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
LJI701O2PE

Ponto de entrada para liberação da alteração do pedido de venda, gerados pela mensagem única RetailSales


Documentação: Ponto de entrada LJI701O2
LJDEPSE1PE

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_DTLIMITNParâ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_LJIPIFRN

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_LJCFPDPN

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 
Para pedidos tipo retira posterior deverá habilitar o parâmetro.
1 = Habilitado.


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 - 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 SL4acessando 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

6.1.2. Parâmetros Gerais

15

...

- Status de Pedido - DocumentTraceAbilityOrder

Dica
titleDica!

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:

Expandir
titleLiberado

Esse status ocorre quando o pedido é integrado ao Protheus e processado pela rotina do GravaBatch, com isso ao gerar o pedido de venda verifica se o parâmetro MV_LJIFPLI  esta configurado com a forma de pagamento da venda efetuada para gerar a libertação automática.

(informação) Importante: Configurar o parâmetro MV_LJIFPLI = Ex: FI|CC|R$ para recebimento de pedido de venda liberado.
OBS: Neste momento ocorre a geração e o envio de mensagem de rastreio com o status Pedido Liberado ao Vtex.



Expandir
titleFaturado

Esse status ocorre quando é gerado no TOTVS Protheus o documento de saída(NF-e) do pedido integrado.

  1. No Faturamento (SIGAFAT) acesse Atualizações / Faturamento / Documento de Saída (MATA460A).
  2. Selecione o pedido de venda e gere o Documento de Saída.
    (informação) Importante: Pedido deve estar liberado para a emissão da Nota Fiscal de Saída.
    OBS: Neste momento é gerada e enviada a mensagem Docummenttraceabilityorder com o status Faturado ao Vtex.
Expandir
titleEmpacotado

Esse status ocorre quando é transmitida e autorizado o documento de saída(NF-e) do pedido integrado.

  1. No Faturamento (SIGAFAT) acesse Atualizações / NF-e e NFS-e / NF-e Sefaz
  2. Selecione o Documento de Saída e realize a Transmissão da Nota Fiscal à  Sefaz.
  3. Clique em Outras Ações/ Monitor/ Faixa. Informe a serie um range de notas para a pesquisa e clique em OK.
    OBS: No momento de monitoramento da NF-e é gerada e enviada a mensagem Docummenttraceabilityorder ao Vtex, com o status Empacotado e os dados da NF-e  junto com o XML da nota transmitida à Sefaz.


Aviso
titleImportante

Caso a NF-e monitorada estiver em contingência e aguardando o processamento do Lote. Não será gerado a mensagem de rastreio Docummenttraceabilityorder com o status Empacotado. 

Image Added


Neste caso aguarde a efetiva autorização da NF-e para a Sefaz e realize novamente o monitoramento. Após isso será gerado a mensagem Docummenttraceabilityorder com o status Empacotado. 

Image Added


Caso já tenha monitorado sua NF-e e a mesma esteja autorizada na Sefaz e não gerou a mensagem de rastreio Docummenttraceabilityorder com o status Empacotado. Verifique se os campos F3_PROTOC e F3_CODRSEF, estão preenchidos. Pois a mensagem é gerada somente quando os dois campos informados estejam preenchidos.

Expandir
titleDevolvido

Esse status ocorre quando é realizado a devolução manual do pedido no Protheus.

  1. No modulo Controle de Lojas (SIGALOJA) acesse Atualizações / Atendimento / Rotina de Troca
  2. Informe os dados da venda conforme sua necessidade e em seguida finalize o processo de devolução.

(informação) Importante: Qualquer item devolvido ira gerar uma mensagem de Rastreio de Pedido com o status Devolvido.

 Não existe integração de NCC com o Vtex, sendo assim ao efetuar uma devolução o e-Commerce não será avisado sobre credito do cliente.
OBS: Neste momento é gerada e enviada a mensagem Docummenttraceabilityorder com o status Devolvido ao Vtex.


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

Aviso
titleImportante

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

...