Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Nota
titleCadastro De/Para Venda
Dica
titleIntegrando Inventario

Abaixo iremos mostrar como configurar o Processo de Venda no Protheus para integra-lo com o sistema Totvs Live. Siga o Passo a Passo.

Dica
titleInutilização

As inutilizações também são integradas através do processo de venda, do assinante LIVE, para mais detalhes: Inutilização NFCE Integrada LIVE

Nota
titleImportante!

Realize este processo para tabela:

SL1 - Orçamento

Nota
titleImportante! FECP
  • Será considerado na alíquota de ICMS o valor de Alíquota de FECP enviado no XML
  • E assim Calculando os novos valores para gravação quando existir o FECP para o ESTADO.
Nota
titleImportante! CAMPO L1_VEND
  • Para gravação do campo L1_VEND, quando o vendedor for identificado na venda irá considerar o vendedor da primeira linha do Item recebido do live (Primeiro registro da tabela SL2.)

Alterando tamanho do campo:

  Para alterar o tamanho do campo L1_UMOV na Tabela SL1 - Orçamento  veja o exemplo abaixo:
  (informação) Importante: O tamanho do campo deve ser igual 36.

Image Removed

Cadastrando o Processo de Venda

Para integrarmos o Venda com o Totvs Live  PdvSync primeiramente é necessário acessar o cadastro do Processo para verificar se o Venda foi criado automaticamente no Protheus.

...

Tabela: SL1

Chave: L1_FILIAL+L1_NUM

Vinculando o Processo de Venda ao Assinante

...

PdvSync

1- No módulo 12 (Controle de Lojas), acesse Atualizações/ RMI/ Cadastros/ Assinantes.

2- Com o assinante Live  PdvSync previamente cadastrado, posicione no assinante Live PdvSync e clique em alterar.

3- Na guia Assinantes x Processos, preencha os seguintes campos:

...

Filiais Proc: Informe o código das filiais que deseja Buscar o Processo

Configuração: Preencha esta campo de acordo com a sua URL da API   Preencha este campo com as configurações do processo de Venda. A URL deve ser preenchida com o caminho da API de Venda, como mostra o exemplo abaixo:

Avisocode
titleAviso!

A tag ValeTroca deve ser preenchida com o código da forma de pagamento Vale Troca, é necessário verificar no Live qual o código correto.

Configuração
{
	
Bloco de código
{
    "url": "httphttps://XXXXXXXX/XXXXXXX/LiveConnector/FacadeIntegracao.svc?wsdl.../api/retaguarda/vendaMensagens/",
    "operacao	"listasPublicacao":"RecuperarCupomFiscalLC_Integracao_Xml",
    "tagretorno":"<LC_TicketCupomFiscal>",
    "SL2":"self:oRegistro:_Itens:_Lc_ItemCupomfiscal",
    "SL4":"self:oRegistro:_FormasPagamento:_Lc_FormaPagamento",
    "ValeTroca":""
 {
		"SL2": "self:oRegistro['VendaItems']",
		"SL4": "self:oRegistro['VendaPagamentos']"
	},
	"ChaveUni": [
		"numeroLoja",
		"cupom",
		"serieNota"
	]
}


Layout Envio: Preencha este campo de acordo com o exemplo abaixo: Lembrando que é permitido utilizar macro execuções no Layout abaixo, após o &.

Bloco de código
&"<?xml version='1.0' encoding='UTF-8'?>
<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/' xmlns:liv='http://LiveConnector/'>
   <soapenv:Header />
   <soapenv:Body>
      <liv:RecuperarCupomFiscalLC_Integracao_Xml>
         <liv:codigoSistemaSatelite>" + self:oConfAssin['sistemasatelite'] + "</liv:codigoSistemaSatelite>
         <liv:xmlIdentificacao><![CDATA[<?xml version='1.0' encoding='utf-8'?><LC_Identificacao><Chave>" + self:cToken + "</Chave><CodigoSistemaSatelite>" + self:oConfAssin['sistemasatelite'] + "</CodigoSistemaSatelite><Data/><Hora/></LC_Identificacao>]]></liv:xmlIdentificacao>
      </liv:RecuperarCupomFiscalLC_Integracao_Xml>
   </soapenv:Body>
</soapenv:Envelope>"

 


Bloco de código
titleLayout Envio
{
	"listIdProprietario": "jdlQGsNQeiFN3VA7l94z"
}



Layout Publicação: Layout Layout Publicação:  Layout que será utilizado para gerar a Publicação (tabela MHQ), especificamente o campo MHQ_MENSAGObs: Os campos abaixo L1_CLIENTEL1_LOJA são configuráveis conforme a sua necessidade após o &. No exemplo abaixo está configurado

para quando o Cliente for não identificado no Live-Conector no Protheus não vai existir De/Para gravado então será utilizado o Cliente Padrão

configurado no parâmetro MV_CLIPADMV_LOJPAD.

Dica
titleInstrução De/Para

Caso seus códigos de Produto sejam iguais entre Live x Protheus não usar a função "DePara" na tag L2_PRODUTO. 

Exemplificando o uso da tag:  "L2_PRODUTO": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_CodigoProduto:Text"

Dica
titleInstrução L1_DOC

O tamanho e o preenchimento com zeros ( "0" ) a direita nesse campos respeita o tipo de documento, a partir da sigla do modelo

(campo self:oRegistro:_SiglaModelo:Text recebido pela integração.

  • Regras para venda com SAT
    • Deverá ser gerado um novo registro na tabela SLG para cada equipamento fiscal SAT que enviar venda, onde deverá conter o número de série do equipamento (LG_SERSAT)
    • O número do PDV enviado na venda, não será considerado para gravação do campo LG_PDV, pois na SLG não permite duplicidade de PDV e o Live permite que um mesmo PDV utilize dois equipamentos SAT diferentes. O campo LG_PDV deverá ser sequencial a partir do 999, ou seja, como o campo possui 3 posições, será a sequencia padrão Protheus com letras. Exemplo: "A01".."Z99". O motivo é para não conflitar com um possível PDV de um ECF. que nos registros C400 do Sped, são obrigatórios para identificar o ECF e possuem 3 posições.
    • o campo LG_SERIE deverá ser gerado de forma automática, o SAT não possui série de documento, apenas o número serial do equipamento. O LG_SERIE, deverá ser sequencial a partir do número 999, ou seja, como o campo possui 3 posições, será a sequencia padrão Protheus com letras. Exemplo: "A01".."Z99". O motivo é para não conflitar com número de série de NF-e/NFC-e (000-999)
    • A busca da estação SLG da venda, sempre será com base no número de série do equipamento.
  • Regras para venda com NFC-e
    • A numeração de série da NFC-e, deverá ser o mesmo valor recebido na venda (tag SerieNFCE)
    • Caso já exista a série na SLG para uma estação que não seja NFC-e (para um SAT ou ECF), deverá ser gerado erro com mensagem clara do motivo (não pode ser utilizado uma série que foi utilizada para uma venda com SAT ou ECF)
    • O número do PDV enviado na venda, não será considerado para gravação do campo LG_PDV, pois na SLG não permite duplicidade de PDV e o Live permite que um mesmo PDV utilize dois equipamentos SAT diferentes. O campo LG_PDV deverá ser sequencial a partir do 999, ou seja, como o campo possui 3 posições, será a sequencia padrão Protheus com letras. Exemplo: "A01".."Z99". O motivo é para não conflitar com um possível PDV de um ECF. que nos registros C400 do Sped, são obrigatórios para identificar o ECF e possuem 3 posições.
  • Regras para venda com ECF
    • Deverá ser gerado um novo registro na tabela SLG para cada equipamento fiscal ECF que enviar venda, onde deverá conter o número de série do equipamento (LG_SERPDV)
    • Não é recebido valor nas tags SiglaModelo e SerieNFCE, assim quando recebermos apenas a tag numeroImpressora o tipo de equipamento sera ECF.
    • O número do PDV enviado na venda, não será considerado para gravação do campo LG_PDV, pois na SLG não permite duplicidade de PDV e o Live permite que um mesmo PDV utilize dois equipamentos ECF diferentes. O campo LG_PDV deverá ser sequencial a partir do 001, ou seja, como o campo possui 3 posições, será a sequencia padrão Protheus.
    • o campo LG_SERIE deverá ser gerado de forma automática, o ECF não possui série de documento, apenas o número serial do equipamento. O LG_SERIE, deverá ser sequencial a partir do número 001, ou seja, como o campo possui 3 posições, será a sequencia padrão Protheus.
    • A busca da estação SLG da venda, sempre será com base no número de série do equipamento.
Bloco de código
titleLayout Publicação
{
	
Bloco de código
{
    "L1_FILIAL": "&self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)D MG 01",
    	"L1_CLIENTE": "&IIF( Empty(self:oRegistro:_IdentificacaoCliente:Text['IdentificacaoCliente']), SuperGetMv('MV_CLIPAD', .F., '000001'), self:DePara('SA1', self:oRegistro:_IdentificacaoCliente:Text['IdentificacaoCliente'], 2, 0) )",
    	"L1_LOJA": "&IIF( Empty(self:oRegistro:_IdentificacaoCliente:Text['IdentificacaoCliente']), SuperGetMv('MV_LOJAPAD', .F., '01',self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)), self:DePara('SA1', self:oRegistro:_IdentificacaoCliente:Text['IdentificacaoCliente'], 3, 0) )",
    	"L1_OPERADO": "&self:DePara('SA6',self:oRegistro:_Operador:Text, 2,0)C06",
    	"L1_EMISSAOTROCO1": "&DtoS( CtoD( SubStr(self:oRegistro:_DataHora:Text, 1, 10) ) )",
    0,
	"L1_NUMCFISEMISSAO": "&self:oRegistro:_Numero:Text['VendaData']",
    	"L1_DOCEMISNF": "&IIF(self:oRegistro:_SiglaModelo:Text == '59',StrZero(Val(self:oRegistro:_Numero:Text),6),IIF(self:oRegistro:_SiglaModelo:Text == '65',StrZero(Val(self:oRegistro:_Numero:Text),9),cValToChar(self:oRegistro:_Numero:Text)))",
    "L1_SERIE['VendaData']",
	"L1_DTLIM": "&self:LayEstAuto('LG_SERIE')oRegistro['VendaData']",
    	"L1_KEYNFCENUMMOV": "&IIFSubStr(cValToChar(self:oRegistro:_SiglaModelo:Text <> '2D', self:oRegistro:_ChaveNFCe:Text, ''['IdCaixa']),1,2)",
    	"L1_SERSATDOC": "&IIFcValToChar(self:oRegistro:_SiglaModelo:Text == '59', self:oRegistro:_NumeroImpressora:Text, ''['NumeroVenda'])",
    	"L1_SERPDVSERIE": "&IIFcValToChar(self:oRegistro:_SiglaModelo:Text == '2D', self:oRegistro:_NumeroImpressora:Text, ''['SerieNota'])",
    	"L1_COMIS": 0,
    "L1_VLRTOT"SERPDV": "&cValToChar(self:oRegistro:_ValorLiquido:Text['SerieNota'])",
    	"L1_VALBRUTKEYNFCE": "&self:oRegistro:_ValorLiquido:Text['Chaveacesso']",
    	"L1_VLRLIQCOMIS": "&self:oRegistro:_ValorLiquido:Text"0,
    	"L1_VALMERCORIGEM": "&self:oRegistro:_ValorBruto:TextN",
    	"L1_DESCONTCGCCLI": "&IIF( Empty(self:oRegistro:_ValorDesconto:Text",
    "L1_CGCCLI": "&self:oRegistro:_CPFCliente:Text",
    "L1_MSEXP": "&DtoS(Date())",
    "L1_CONDPG": "CN",
    ['CpfCnpjConsumidor']), '', self:oRegistro['CpfCnpjConsumidor'] )",
	"L1_CONDPG": "CN",
	"L1_SITUA": "IP",
	"L1_TIPO": "V",
    	"L1_TIPOCLI": "F",
    	"L1_ESPECIE": "&IIF( self:oRegistro:_SiglaModelo:Text['ModeloFiscal'] == '59'1, 'SATCE', IIF(self:oRegistro:_SiglaModelo:Text['ModeloFiscal'] == 2,'65NFCE','NFCE',self:oRegistro:_SiglaModelo:Text)ECF') )",
    	"L1_PDV": "&self:LayEstAuto('LG_PDV')001",
    "L1_ORIGEM": "N",
    "	"SL2": [
        {
            		{
			"L2_FILIAL": "&self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)",
            D MG 01",
			"L2_PRODUTO": "&cValToChar(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_CodigoProduto:Text",
            ['VendaItems'][nItem]['ProdutoId'])",
			"L2_ITEM": "&Right( AllTrim(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_NumeroItem:Text)StrZero(nItem, TamSx3('L2_ITEM')[1])",
            			"L2_VENDDESCRI": "&IIF( Empty(self:oRegistro:_Itens:_Lc_ItemCupomfiscal['VendaItems'][nItem]:_IdentificacaoVendedor:Text), SuperGetMv('MV_VENDPAD', .F., '000001'), self:DePara('SA3',self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_IdentificacaoVendedor:Text, 2,0) )",
            ['Produto']['Descricao']",
			"L2_QUANT": "&Val(self:oRegistro:_Itens:_Lc_ItemCupomfiscal['VendaItems'][nItem]:_Quantidade:Text)",
            ['Qtde']",
			"L2_VRUNIT": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorUnitarioLiquido:Text",
            ",
			"L2_VLRITEM": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorTotalLiquido:Text",
			"L2_PRCTABLOCAL": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorTotalBruto:Text",
            ",
			"L2_DESCPROUM": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorDescontoItem:Text",
            ",
			"L2_LOCALVALDESC": "&SuperGetMv('MV_LOCPAD', .F., '01')",
            ",
			"L2_UMTES": "&self:DePara('SAH', self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_UnidadeMedida:Text, 2,0)",
            "L2_TES": "&SuperGetMv('MV_TESSAI', .F., '501',self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0))",
            "L2_CF"",
			"L2_CF": "",
			"L2_PICM": "",
			"L2_BASEICM": "",
			"L2_VALICM": "",
            			"L2_EMISSAO": "&DtoS( CtoD( SubStr(self:oRegistro:_DataHora:Text, 1, 10) ) )"
        }
    ],
    ",
			"L2_CSTPIS": "",
			"L2_CSTCOF": ""
		}
	],
	"SL4": [
        {
            		{
			"L4_FILIAL": "&self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)",
            D MG 01",
			"L4_DATA": "&DtoS( CtoD( SubStr(self:oRegistro:_DataHora:Text, 1, 10) ) )",
            ['VendaData']",
			"L4_VALOR": "&self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_ValorPagamento:Text",
            "L4_FORMA['VendaPagamentos'][nItem]['ValorPago']",
			"L4_ADMINIS": "",
			"L4_TROCO": "&IIF(!Empty(self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_FormaPagamento:Text),self:DePara('SX5', self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_FormaPagamento:Text, 3),'')",
            "L4_ADMINIS'VendaPagamentos'][nItem]['ValorTroco']",
			"L4_FORMA": "&IIFcValToChar( Empty(self:oRegistro:_FormasPagamento:_Lc_FormaPagamento['VendaPagamentos'][nItem]:_ProdutoEletronico:Text), '', self:DePara('SAE', self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_ProdutoEletronico:Text, 2,0) )",
            "L4_AUTORIZ": "&AllTrim(self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_Autorizacao:Text)",
            "L4_NSUTEF": "&self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_NSU:Text",
            "L4_PARCTEF": "&self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_Parcela:Text"
        }
    ]
}
Nota
titleRegras para controle de Serie e PDV

Exemplo da configuração do Processo Venda no assinante Live:

Image Removed

Dica
titleFluxo de integração

Após ter realizado as configurações acima a integração do Venda seguirá o seguinte fluxo:

Serviço RMIBUSCA: Neste serviço o Protheus irá realizar a busca das vendas no sistema Totvs LIVE, e grava-las na tabela MHQ - Mensagens Publicadas.  

O Campo MHQ_CHVUNI será a chave do registro publicado e será composto pelas TAGs abaixo:

LC_TicketCupomFiscal:Numero|SerieNFCe|NumeroImpressora|SiglaModelo|Numero

Serviço RMIDISTRIB: Após as mensagens serem publicadas na tabela MHQ, o serviço RMIDISTRIB se encarregará de distribuir as vendas para seus assinantes, neste caso as mensagens serão distribuídas para o assinante Protheus, neste processo será gravado as distribuições na tabela MHR - Mensagens Distribuição  

Serviço RMIENVIA: Com as mensagens distribuídas para o assinante Protheus o serviço RMIENVIA é responsável por gerar a venda de cada mensagem distribuída. Neste momento é gravado as tabelas SL1, SL2 e SL4(Tabelas responsáveis pela venda) e caso a venda seja gerada com sucesso será gravado o numero da mesma no campo MHR_RETORN. Caso o seja encontrado algum erro no momento da geração da venda no Protheus, no campo MHR_ENVIO é gravado os dados que foram passados para gerar a venda e no campo MHR_RETORN é gravado o motivo da inconsistência na geração da venda.

Serviço RMICONTROL: Com as vendas geradas nas tabelas SL1, SL2 e SL4,  o campo L1_SITUA deve estar com o conteúdo IP (Integração Pendente), para que o serviço RMICONTROL realize as validações da venda. Caso seja encontrado alguma inconsistência na venda o campo L1_SITUA sera atualizado para IR (Integração com erro) e será gravado um log do motivo desta inconsistência na tabela MHL - Logs de Integração. Caso a venda seja validada com sucesso o campo L1_SITUA é atualizado para RX (Recebido pelo Server).

Serviço do GravaBacth:  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 OK.

Nota
titleImportante!

Vendas do tipo troca seguirá o mesmo fluxo da venda como mencionado acima porém com um diferencial, Ao integrar venda do Live ao Protheus com a forma de pagamento Vale Troca, o valor do Vale Troca será gravado no campo L1_CREDITO e a forma de pagamento será desconsiderada da gravação na tabela SL4, assim como já funciona no Venda Assistida com uma venda com pagamento em NCC. Após o processamento da venda pelo serviço GRAVABATCH será gerado um titulo a receber já baixado do tipo NCC. 

Caso seja integrado uma troca cancelada no Protheus, será gerado um registro na tabela SL4 com a forma de pagamento R$, o titulo a receber gerado no Financeiro também é gerado com o tipo de pagamento em Dinheiro. Após isso a venda seguira os mesmos passos de uma venda cancelada. 

Nota
titleCancelamento de venda.

O Cancelamento de Venda  tem como pré requisito que a venda a ser cancelada esteja integrada no Protheus e processada pelo serviço GravaBatch (L1_SITUA = OK), como informado na Dica de Fluxo de Integração feito isso o cancelamento seguirá o seguinte fluxo:

Serviço RMIBUSCA: Neste serviço é realizado a busca das vendas no Totvs LIVE, o serviço identifica se a tag <Situacao> (Xml integrado do Live) é igual a C, Caso seja significa que se trata de um cancelamento, com isso é gravado um registro na tabela MHQ - Mensagens Publicadas com o campo MHQ_EVENTO = 2 (Cancelamento).

Serviço RMIDISTRIB: Após a Publicação do cancelamento o serviço RMIDISTRIB se encarregará de distribuir o cancelamento da venda  para o assinante Protheus, gerando um registro na tabela MHR - Mensagens Distribuição.

Serviço RMIENVIA: Realizado a distribuição, o serviço RMIENVIA inclui as informações do cancelamento da venda na tabela SLX - Log Cancelamento x Devolução.

Serviço RMICONTROL: Com as informações do cancelamento inseridos na tabela SLX - Log Cancelamento x Devolução este serviço realiza a leitura das informações e em seguida é executado a rotina padrão de cancelamento LOJA140, com isso realizando o cancelamento da venda no Protheus.
['Id'])",
			"L4_NSUTEF": "",
			"L4_DOCTEF": "",
			"L4_DATATEF": "",
			"L4_HORATEF": "",
			"L4_BANDEIR": ""
		}
	]
}