Histórico da Página
OperationCode
Dica | ||
---|---|---|
| ||
Neste artigo você tem informações sobre a integração de pedidos do e-commerce VTEX através da mensagem RetailSales. A documentação completa com demais processos integrados com VTEX, deve ser consultado com o time de TOTVS Connector. Qualquer outro tipo de uso da mensagem padronizada RetailSales, deverá ser alinhado previamente com o time de produto. |
...
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_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_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 |
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 | O sistema considera as regras da rotina TES Inteligente MATA089 para eleger um TES considerando somente o cadastro do tipo de operação (campo FM_TIPO) “V” IDENTIFICAÇÃO DE ENTREGAS FUTURAS. Caso não seja eleito um TES automaticamente, seja pela ausência do TES Inteligente ou pela não-adequação às regras, o TES informado nesse parâmetro será utilizado na geração do Pedido de Venda. Esse TES não deve gerar movimento financeiro (Campo Gera Dupl. = Não). Pois o financeiro é gerado pelas rotinas de varejo (GravaBatch) no momento que o pedido é criado, colocando para não gerar, não será gerado no momento que o pedido for faturado no módulo de faturamento. Esse parâmetro também permite executar funções de usuário para definir qual TES o sistema deverá considerar para geração do pedido de venda. Para executar uma função de usuário por meio desse parâmetro, basta incluir o & antes da função de usuário. Se a função do usuário retornar um TES, este será utilizado no pedido de venda, desconsiderando o TES inteligente. Importante: Para utilização da TES Inteligente, onde o Pedido Gerado no Loja deverá gerar financeiro e o Pedido gerado no Faturamento não deverá gerar, o TOTVS Connector deve enviar o tipo de operação (tag OperationCode) diferente de "V". Para seguir o padrão do Loja, enviar a tag com "01". |
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?) |
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. |
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://centraldeatendimento.totvs.com/hc/pt-br/articles/360029117791-MP-FAT-Incluir-m%C3%BAltiplos-endere%C3%A7os-de-entrega-no-cadastro-do-cliente |
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://centraldeatendimento.totvs.com/hc/pt-br/articles/360029117791-MP-FAT-Incluir-m%C3%BAltiplos-endere%C3%A7os-de-entrega-no-cadastro-do-cliente |
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). |
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 |
...
Bloco de código | ||||
---|---|---|---|---|
| ||||
{ "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": "V01", "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": "V01", "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": "V01", "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 } } |
...
Bloco de código | ||||
---|---|---|---|---|
| ||||
{ "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": "1", "ItemReserveInternalId": "15da928b-9e88-4947-a508-8cdd56beabd9", "ItemInternalId": "d077bf8a-bbbb-4549-9b00-1a203cfe4428", "ItemPrice": 93, "InternalId": "C14B0CB7AE00430C86475D908AAB843A", "FreightValueProrated": 5, "DiscountAmount": 5, "OperationCode": "V01", "Quantity": 5 }, { "ItemOrder": 2, "ItemCode": "69dbb151-bbe6-4547-853a-0342ace00eab", "UnitPrice": 55, "ItemDeliveryType": "1", "ItemReserveInternalId": "15da928b-9e88-4947-a508-8cdd56beabd9", "ItemInternalId": "69dbb151-bbe6-4547-853a-0342ace00eab", "ItemPrice": 55, "InternalId": "77B3D9FC812B47148AF774F44F9C6EF7", "FreightValueProrated": 5, "DiscountAmount": 5, "OperationCode": "V01", "Quantity": 1 }, { "ItemOrder": 3, "ItemCode": "79f93baf-39ac-40de-ae73-007a256dda31", "UnitPrice": 55, "ItemDeliveryType": "1", "ItemReserveInternalId": "15da928b-9e88-4947-a508-8cdd56beabd9", "ItemInternalId": "79f93baf-39ac-40de-ae73-007a256dda31", "ItemPrice": 55, "InternalId": "F4A61206DEF543E0A613EB63D1141E1D", "FreightValueProrated": 5, "DiscountAmount": 5, "OperationCode": "V01", "Quantity": 1 } ] }, "StationSalePointInternalId": "AUTOMATICO", "ListOfSaleCondition": { "SaleCondition": [ { "UniqueSerialNumber": "004112", "DateOfPayment": null, "PaymentValue": 203, "PaymentMethodCode": "CC", "FinancialManagerCode": "CAR" } ] }, "DocumentCode": "1027293590055-01", "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": 15 } } |
...