Histórico da Página

...

Dica

title	Inutilizaçã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

Importante: No cenário de integração de TVFR x Protheus, quem é o responsável pelas vendas e inutilizações é o TVFR, ou seja, caso seja realizado inutilização direto no Protheus, não será integrado com o TVFR e irá acusar como falha no processo de conciliação de movimentações.

Nota

title	Importante!

Realize este processo para tabela:

SL1 - Orçamento

Alterando tamanho do campo:

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

Image Removed

Cadastrando o Processo de Venda

Nota

title	Importante! 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

title	Importante! 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:
Importante: O tamanho do campo deve ser igual 36.

Image Added

Cadastrando o Processo de Venda

Para integrarmos o Venda com o Totvs Live primeiramente é necessário acessar o cadastro do Processo para Para integrarmos o Venda com o Totvs Live 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 Live

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

...

Tipo Process: Busca

Filiais Proc: Informe o código das filiais que deseja Buscar de apenas uma filial para buscar o Processo.

Configuração: Preencha esta campo de acordo com a sua URL da API Venda, como mostra o exemplo abaixo:

Aviso

title	Aviso!

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.

As notas de devolução, não devem ser transmitidas pelo TVFR, no fluxo de integração, essas notas são geradas no TVFR sem ocorrer a comunicação com a SEFAZ e são integradas no Protheus (consumo do método RecuperarNotaFiscalLC_Integracao_Xml) e transmitidas via JOB NF-e.

Configurações TVFR para não transmitir a Nota de Devolução:

IMPRIMEDOCUMENTO

Bloco de código

linenumbers	true

Bloco de código

{
    "url": "http://XXXXXXXX/XXXXXXX/LiveConnector/FacadeIntegracao.svc?wsdl",
    "operacao":"RecuperarCupomFiscalLC_Integracao_Xml",
    "tagretornourl": "http://XXXXXXXX/XXXXXXX/LiveConnector/FacadeIntegracao.svc?wsdl",
    "operacao":"RecuperarCupomFiscalLC_Integracao_Xml",
    "tagretorno":"<LC_TicketCupomFiscal>",
    "SL2":"self:oRegistro:_Itens:_Lc_ItemCupomfiscal",
    "SL4":"self:oRegistro:_FormasPagamento:_Lc_FormaPagamento",
    "ValeTroca": "9"
}
,
    "ChaveUni": [
        "SerieNFCe",
        "NumeroImpressora",
        "SiglaModelo",
        "Numero"
    ] 
}

Layout Envio: Preencha este campo de 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

linenumbers	true

&"<?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:oLive:getSatelite(self) + "</liv:codigoSistemaSatelite>
			<liv:xmlIdentificacao><![CDATA[<?xml  <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>"

Layout Publicação: Layout que será utilizado para gerar a Publicação (tabela MHQ), especificamente o campo MHQ_MENSAG

Obs: Os campos abaixo L1_CLIENTE e L1_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_CLIPAD e MV_LOJPAD.

Dica

title	Instruçã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

title	Instruçã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.

version='1.0' encoding='utf-8'?><LC_Identificacao><Chave>" + self:oLive:getToken(self) + "</Chave><CodigoSistemaSatelite>" + self:oLive:getSatelite(self) + "</CodigoSistemaSatelite><Data/><Hora/></LC_Identificacao>]]></liv:xmlIdentificacao>
		</liv:RecuperarCupomFiscalLC_Integracao_Xml>
	</soapenv:Body>
</soapenv:Envelope>"

Layout Publicação: Layout que será utilizado para gerar a Publicação (tabela MHQ), especificamente o campo MHQ_MENSAG

Obs: Os campos abaixo L1_CLIENTE e L1_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_CLIPAD e MV_LOJAPAD.

Dica

title	Instruçã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

title	Instruçã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.

Bloco de código

linenumbers	true

{
	"L1_FILIAL": "&self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)",
	"L1_CLIENTE": "&IIF( Empty(self:oRegistro:_IdentificacaoCliente:Text), SuperGetMv('MV_CLIPAD', .F., '000001',self:DePara('SM0', self:oRegistro:_CodigoLoja:Text,1,0)), self:DePara('SA1', self:oRegistro:_IdentificacaoCliente:Text, 2, 0,,, self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)))",
	"L1_LOJA": "&IIF( Empty(self:oRegistro:_IdentificacaoCliente:Text), SuperGetMv('MV_LOJAPAD', .F., '01',self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)), self:DePara('SA1', self:oRegistro:_IdentificacaoCliente:Text, 3, 0,,, self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)) )",
	"L1_OPERADO

Bloco de código

{
    "L1_FILIAL": "&self:DePara('SM0SA6', self:oRegistro:_CodigoLojaOperador:Text, 12, 0)",
    	"L1_CLIENTEEMISSAO": "&IIFDtoS( CtoD( EmptySubStr(self:oRegistro:_IdentificacaoClienteDataHora:Text), SuperGetMv('MV_CLIPAD', .F., '000001'), self:DePara('SA1', 1, 10) ) )",
	"L1_NUMCFIS": "&self:oRegistro:_IdentificacaoCliente:Text, 2,0) )Numero:Text",
    	"L1_LOJADOC": "&SuperGetMv('MV_LOJAPAD', .F., '01',self:DePara('SM0', IIF(self:oRegistro:_SiglaModelo:Text == '59',StrZero(Val(self:oRegistro:_CodigoLojaNumero:Text), 1, 0))",
    "L1_OPERADO": "&self:DePara('SA6',6),IIF(self:oRegistro:_SiglaModelo:Text == '65',StrZero(Val(self:oRegistro:_OperadorNumero:Text), 2,09),cValToChar(self:oRegistro:_Numero:Text)))",
    	"L1_EMISSAOSERIE": "&DtoS( CtoD( SubStr(self:oRegistro:_DataHora:Text, 1, 10) ) )",
    "L1_NUMCFISself:LayEstAuto('LG_SERIE')",
	"L1_KEYNFCE": "&IIF(self:oRegistro:_NumeroSiglaModelo:Text",
 <> '2D', self:oRegistro:_ChaveNFCe:Text, '')",
	"L1_DOCSERSAT": "&IIF(self:oRegistro:_SiglaModelo:Text == '59',StrZero(Val( self:oRegistro:_NumeroNumeroImpressora:Text),6 '')",
	"L1_SERPDV": "&IIF(self:oRegistro:_SiglaModelo:Text == '652D',StrZero(Val( self:oRegistro:_NumeroNumeroImpressora:Text),9),cValToChar(self:oRegistro:_Numero:Text))) '')",
    	"L1_SERIECOMIS": "&self:LayEstAuto('LG_SERIE')",
    0,
	"L1_KEYNFCEVLRTOT": "&IIF(self:oRegistro:_SiglaModelo:Text <> '2D', :_ValorLiquido:Text",
	"L1_VALBRUT": "&self:oRegistro:_ChaveNFCeValorLiquido:Text, '')",
    	"L1_SERSATVLRLIQ": "&IIF(self:oRegistro:_SiglaModeloValorLiquido:Text == '59', ",
	"L1_VALMERC": "&self:oRegistro:_SerieNFCeValorBruto:Text, '')",
    	"L1_SERPDVDESCONT": "&IIF( Val(self:oRegistro:_SiglaModeloValorDesconto:Text) == '2D'> 0, self:oRegistro:_NumeroImpressoraValorDesconto:Text, ''0 )",
    	"L1_COMISCGCCLI": 0,
    "L1_VLRTOT": "&self:oRegistro:_ValorLiquidoCPFCliente:Text",
    	"L1_CONDPG": "CN",
	"L1_VALBRUTTIPO": "&self:oRegistro:_ValorLiquido:TextV",
	"L1_TIPOCLI": "F",
    	"L1_VLRLIQESPECIE": "&IIF(self:oRegistro:_ValorLiquidoSiglaModelo:Text",
    "L1_VALMERC": "&== '59','SATCE',IIF(self:oRegistro:_ValorBrutoSiglaModelo:Text",
    "L1_DESCONT": "&== '65','NFCE',IIF(self:oRegistro:_SiglaModelo:Text == '55','SPED',self:oRegistro:_ValorDescontoSiglaModelo:Text)))",
     "L1_CGCCLIPDV": "&self:oRegistro:_CPFCliente:TextLayEstAuto('LG_PDV')",
    	"L1_MSEXPORIGEM": "&DtoS(Date())N",
    "L1_CONDPG	"SL2": [
		{
			"L2_FILIAL": "CN",
    "L1_TIPO": "V",
    "L1_TIPOCLI": "F",
    "L1_ESPECIE&self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)",
			"L2_PRODUTO": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_CodigoProduto:Text",
			"L2_ITEM": "&IIF(self:oRegistro:_SiglaModelo:Text == '59','SATCE',IIFRight( AllTrim(self:oRegistro:_SiglaModelo:Text == '65','NFCE',self:oRegistro:_SiglaModelo:Text))",
    "L1_PDV": "&self:LayEstAuto('LG_PDV')",
    "L1_ORIGEM": "N",
    "SL2": [
        {
            "L2_FILIAL": "&self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)",
            "L2_PRODUTO": "&Itens:_Lc_ItemCupomfiscal[nItem]:_NumeroItem:Text), TamSx3('L2_ITEM')[1])",
			"L2_VEND": "&IIF( Empty(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_IdentificacaoVendedor:Text), SuperGetMv('MV_VENDPAD', .F., '000001'), self:DePara('SA3',self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_CodigoProdutoIdentificacaoVendedor:Text, 2,0) )",
            			"L2_ITEMQUANT": "&RightVal( AllTrim(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_NumeroItemQuantidade:Text), TamSx3('L2_ITEM')[1])",
            			"L2_VENDVRUNIT": "&IIF( Empty(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_IdentificacaoVendedorValorUnitarioLiquido:Text), SuperGetMv('MV_VENDPAD', .F., '000001'), self:DePara('SA3',self:",
			"L2_VLRITEM": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_IdentificacaoVendedorValorTotalLiquido:Text, 2,0) )",
            ",
			"L2_QUANTDESCPRO": "&IIF( Val(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_QuantidadeValorDescontoItem:Text)",
 >           "L2_VRUNIT": "&0, self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorUnitarioLiquidoValorDescontoItem:Text, 0 )",
            			"L2_VLRITEMVALACRS": "& "&IIF( Val(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorTotalLiquidoValorDescontoItem:Text",
			"L2_DESCPRO": "&) < 0, Abs(Val(self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorDescontoItem:Text)), 0 )",
            			"L2_LOCAL": "&SuperGetMv('MV_LOCPAD', .F., '01')",
            , '01')",
			"L2_UM": "&self:DePara('SAH', self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_UnidadeMedida:Text, 2,0)",
            			"L2_TES": "&SuperGetMv('MV_TESSAI', .F., '501')",
            "L2_CF": "",
            ",
			"L2_CF": "",
			"L2_PRCTAB": "&self:oRegistro:_Itens:_Lc_ItemCupomfiscal[nItem]:_ValorUnitarioBruto:Text",
			"L2_EMISSAO": "&DtoS( CtoD( SubStr(self:oRegistro:_DataHora:Text, 1, 10) ) )"
        		}
    	],
    	"SL4": [
        {
            		{
			"L4_FILIAL": "&self:DePara('SM0', self:oRegistro:_CodigoLoja:Text, 1, 0)",
            			"L4_DATA": "&DtoS( CtoD( SubStr(self:oRegistro:_DataHora:Text, 1, 10) ) )",
            			"L4_VALOR": "&self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_ValorPagamento:Text",
            			"L4_FORMA": "&IIF(!Empty(self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_FormaPagamento:Text),self:DePara('SX5', self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[nItem]:_FormaPagamento:Text, 3),'')",
            			"L4_ADMINIS": "&IIF( Empty(self:oRegistro:_FormasPagamento:_Lc_FormaPagamento[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

title	Regras para controle de Serie e PDV

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.

...

Dica

title	Fluxo 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

title	Importante!

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.

...

Árvore de páginas

Versões comparadas

Versão antiga 32

Nova versão Atual

Chave

Alterando tamanho do campo:

Cadastrando o Processo de Venda

Alterando tamanho do campo:

Cadastrando o Processo de Venda

Vinculando o Processo de Venda ao Assinante Live