Pré-requisitos
Parâmetro = 105 | LiveConnector - Cupom Fiscal (1 = SIM | 0 = NAO)
Parâmetro Unidade de Negócio = 91| LiveConnector - Cupom Fiscal (1 = SIM | 0 = NAO)
Obs: Somente após a configuração dos parâmetros as informações alteradas/incluídas serão enviadas para integração.
As informações modificadas anteriormente e as bloqueadas para edição não serão enviadas. Qualquer dúvida para implantação entrar em contato com a equipe de Serviços TOTVS Live.
Nota para Dev e QA
O Log relacionado aos cupons fiscais gerados devem ser buscados da seguinte forma:
A consulta com o comando "for xml path, root('Cupom') é necessária devido a grande extensão do conteúdo.
Exemplo de Utilização:
1 - As vendas realizadas nos PDVs são integradas ao TOTVS LIVE e serão gerados tickets. Então devemos realizar a requisição RecuperarCupomFiscalLC_Integracao no Connector para recuperar a lista com os cupons gerados no formato Xml.
Exemplo de consumo Via SoapUI:
Parâmetros de Entrada
ENTRADA
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Chave | varchar(16) | Sim | Sim | Não se Aplica | Não se Aplica | Chave de acesso do Sistema Satélite |
| CodigoSistemaSatelite | varchar(20) | Sim | Sim | Não se Aplica | Não se Aplica | Código do Sistema Sátelite |
| NumeroTicket | varchar(16) | Não | Não | Não se Aplica | Não se Aplica | Número do Ticket. Permite recuperar novamente um ticket específico. Este campo é opcional e por padrão não deve ser passado |
Parâmetros de Saída
RETORNO
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Chave | varchar(16) | Sim | Sim | Não se Aplica | Não se Aplica | Chave de acesso do Sistema Satélite |
| CodigoSistemaSatelite | varchar(20) | Sim | Sim | Não se Aplica | Não se Aplica | Código do Sistema Satélite |
| NumeroTicket | varchar(16) | Não | Não | Não se Aplica | Não se Aplica | Número do Ticket para Retorno |
| NumeroSequencia | varchar(16) | Não | Sim | Não se aplica | Não se aplica | Sequência número dos objetos retornados no ticket |
| CPFCliente | varchar(14) | Sim | Não | Não | Não | CPF do cliente identificado na venda |
| CanalVenda | List | Sim | Sim | Não | Não | Canal de origem da venda |
| ChaveNFCe | varchar(54) | Não | Sim | Não | Não | Chave da venda quando modelo 65 NFCe |
| ChaveNFCeCancelada | varchar(54) | Não | Não | Não | Não | Chave da venda cancelada quando modelo 65 NFCe |
| CodigoLoja | varchar(14) | Sim | Sim | Não | Não | CNPJ da venda que a venda foi realizada |
| DataHora | datetime | Não | Sim | Não | Não | aaaa-mm-ddThh:mm:ss quando for executado método XML o retorno terá no padrão dd/mm/aaaa hh:mm:ss |
| DataHoraServidor | datetime | Não | Sim | Não | Não | aaaa-mm-ddThh:mm:ss quando for executado método XML o retorno terá no padrão dd/mm/aaaa hh:mm:ss |
| DataInutilizacao | datetime | Não | Não | Não | Não | Data e hota da inutilização do cupom Quando for executado método XML o retorno terá no padrão dd/mm/aaaa hh:mm:ss |
| DescricaoTipoDocumento | varchar(50) | Não | Sim | Não | Não | Descrição do tipo de documento |
| DescricaoTipoOperacao | varchar(50) | Não | Sim | Não | Não | Descrição do tipo de operação, podendo ser venda ou troca |
| FormasPagamento | List | Não | Sim | Não | Não | Lista da forma de pagamento da venda |
| IDOperacao | guid | Sim | Sim | Não | Não | ID da venda |
| IdentificacaoCliente | varchar(20) | Sim | Não | Não | Não | CPF do cliente na venda |
| Itens | List | Não | Sim | Não | Não | Lista de itens do cupom |
| ItensCancelados | List | Não | Não | Não | Não | Lista de itens cancelados do cupom |
| Modalidade | List | Sim | Sim | Não | Não | Lista da modalidade da venda |
| Numero | varchar(16) | Não | Sim | Não | Não | Número do cupom |
| NumeroCancelamento | varchar(4) | Não | Não | Não | Não | Número de cancelamento Obrigatório quando o cupom for cancelado |
| NumeroImpressora | varchar(20) | Não | Não | Não | Não | |
| NumeroLoja | varchar(20) | Sim | Sim | Não | Não | Número de série da loja |
| NumeroPDV | varchar(4) | Não | Sim | Não | Não | Número do PDV que ocorreu a venda |
| Observacao | varchar(500) | Não | Não | Não | Não | Informações complementares |
| ProtocoloInutilizacao | varchar(8) | Não | Sim | Não | Não | Protocolo de inutilização de venda quando cupom NFCe Obrigatório quando a venda for inutilizada |
| QuantidadeItens | float | Não | Sim | Não | Não | Quantidade de itens na venda |
| RetornoSefazInutilizacao | varchar(5) | Não | Não | Não | Não | Código de retorno de inutilização de venda quando cupom NFCe Obrigatório quando a venda for inutilizada |
| SerieNFCe | varchar(3) | Não | Sim | Não | Não | Série fiscal para venda modelo 65 NFCe |
| SiglaModelo | varchar(30) | Não | Sim | Não | Não | Sigla do modelo fiscal da venda (65 para NFCE ou 59 para SAT) |
| Situacao | varchar(1) | Não | Sim | Sim | Não | Situação do cupom fiscal (A para Ativo ou C para cancelado) |
| SituacaoNFCe | varchar(30) | Não | Sim | Sim | Não | Situação da venda NFCe (Normal, Cancelada ou Inutilizada) |
| ValorBruto | float | Não | Sim | Não | Não | Valor bruto da venda |
| ValorDesconto | float | Não | Sim | Não | Não | Valor de desconto total da venda |
| ValorLiquido | float | Não | Sim | Não | Não | Valor líquido da venda |
CanalVenda
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| NumeroSequencia | varchar(16) | Não | Sim | Não se aplica | Não se aplica | Sequência número dos objetos retornados no ticket |
| Codigo | int | Sim | Sim | Não | Não | Código do canal de venda cadastrado no retaguarda |
| Descricao | varchar(50) | Não | Sim | Não | Não | Descrição do canal de venda |
FormasPagamento
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| AdministradoraCartao | varchar(100) | Não | Não | Não | Não | Nome da administradora do cartão Obrigatório quando venda em cartão |
| Autorizacao | varchar(40) | Não | Não | Não | Não | Código de autorização da venda em cartão |
| CodigoAdministradoraCartao | varchar(50) | Não | Não | Não | Não | Código da administradora de cartão cadastrada no retaguarda Obrigatório quando venda em cartão |
| DescricaoFormaPagamento | varchar(50) | Não | Sim | Não | Não | Nome da forma de pagamento da venda |
| DescricaoProdutoEletronico | varchar(50) | Não | Não | Não | Não | Nome do produto eletrônico quando venda em cartão Obrigatório quando venda em cartão |
| FormaPagamento | varchar(2) | Não | Sim | Não | Não | Código da forma de pagamento cadastrada no retaguarda |
| NSU | varchar(12) | Não | Não | Não | Não | Código da NSU quando for venda em cartão |
| NSUTEF | varchar(12) | Não | Não | Não | Não | Código da NSU quando for venda em cartão via TEF |
| Parcela | varchar(10) | Não | Sim | Não | Não | Quantidade de parcelas da venda |
| ProdutoEletronico | varchar(3) | Não | Não | Não | Não | Código do produto eletrônico cadastrado no retaguarda Obrigatório quando venda em cartão |
| ValorPagamento | float | Não | Sim | Não | Não | Valor do pagamento da venda e/ou parcela da forma de pagamento deste bloco |
Itens e ItensCancelados
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| AcrescimosDescontos | List | Não | Não | Não | Não | |
| CodigoAlternativo | varchar(20) | Não | Não | Não | Não | Código alternativo do produto de acordo com a configuração do retaguarda |
| CodigoPrincipalPracticoProduto | varchar(20) | Sim | Sim | Não | Não | Código interno do produto |
| CodigoProduto | varchar(20) | Sim | Sim | Não | Não | Código padrão do produto |
| DescricaoTipoImpostoECF | varchar(20) | Não | Sim | Não | Não | Descrição do imposto configurado para o produto |
| DescricaoTipoOperacao | varchar(50) | Não | Sim | Não | Não | Descrição do tipo de operação (venda ou troca) |
| IdentificacaoVendedor | varchar(20) | Não | Não | Não | Não | CPF do vendedor da venda |
| NumeroItem | varchar(6) | Não | Sim | Não | Não | Número do item dentro do cupom |
| Observacao | varchar(500) | Não | Não | Não | Não | Observação adicional do item |
| Quantidade | float | Não | Sim | Não | Não | Quantidade de itens do produto na venda |
| SituacaoTributariaICMS | varchar(2) | Não | Sim | Não | Não | Código da Situação tributária configurada no produto |
| Tributos | List | Não | Sim | Não | Não | Lista dos tributos do item no cupom |
| UnidadeMedida | varchar(10) | Não | Sim | Não | Não | Unidade de medida do produto |
| ValorComissao | float | Não | Não | Não | Não | Valor de comissão configurada para o produto |
| ValorDescontoItem | float | Não | Não | Não | Não | Valor do desconto no item |
| ValorTotalBruto | float | Não | Sim | Não | Não | Valor total bruto do produto |
| ValorTotalLiquido | float | Não | Sim | Não | Não | Valor total líquido do produto |
| ValorUnitarioBruto | float | Não | Sim | Não | Não | Valor unitário bruto do produto |
| ValorUnitarioLiquido | float | Não | Sim | Não | Não | Valor unitário líquido do produto |
AcrescimosDescontos
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| TipoAcrescimoDesconto | int | Não | Não | Não | Não | Informa se é acréscimo ou desconto Obrigatório quando houver desconto ou acréscimo na venda |
| Valor | float | Não | Não | Não | Não | Valor do acréscimo ou desconto Obrigatório quando houver desconto ou acréscimo na venda |
| OrigemDescontoAcrescimo | int | Não | Não | Não | Não | Origem do acréscimo ou desconto (Exemplo: PDV) Obrigatório quando houver desconto ou acréscimo na venda |
| Complemento | varchar(100) | Não | Não | Não | Não | Informações adicionais |
Tributos
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| Aliquota | float | Não | Sim | Não | Não | Alíquota do produto na venda |
| BaseCalculo | float | Não | Sim | Não | Não | Base de cálculo do produto |
| CFOP | int | Não | Sim | Não | Não | CFOP do produto na venda |
| CodTot | varchar(20) | Não | Não | Não | Não | Código totalizador |
| CodigoTributo | varchar(10) | Sim | Sim | Não | Não | Código do tributo de acordo com cadastro no retaguarda |
| DescricaoTributo | varchar(250) | Não | Sim | Não | Não | Nome do tributo |
| SituacaoTributaria | varchar(2) | Não | Sim | Não | Não | Código da situação tributária do produto |
| ValorIsenta | float | Não | Não | Não | Não | Valor isento de tributação |
| ValorOutras | float | Não | Não | Não | Não | Outros valores |
| ValorTributo | float | Não | Sim | Não | Não | Valor do tributo do produto |
Modalidade
| Descrição | Tipo | Chave | Obrigatório | Permite Alteração | Permite Exclusão | Informação Negocial |
| NumeroSequencia | varchar(16) | Não | Sim | Não se aplica | Não se aplica | Sequência número dos objetos retornados no ticket |
| Codigo | Int | Sim | Sim | Não | Não | Código da modalidade de venda de acordo com o cadastro no retaguarda |
| Descricao | varchar(50) | Não | Sim | Não | Não | Nome da modalidade da venda |
Exemplo de Chamada do Método
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/" xmlns:ren="http://schemas.datacontract.org/2004/07/Rentech.Framework.Data" xmlns:ren1="http://schemas.datacontract.org/2004/07/Rentech.PracticoLive.Connector.Objects">
<soapenv:Header/>
<soapenv:Body>
<liv:RecuperarCupomFiscalLC_Integracao>
<liv:identificacao>
<ren1:Chave>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</ren1:Chave>
<ren1:CodigoSistemaSatelite>XXXXXXXX</ren1:CodigoSistemaSatelite>
</liv:identificacao>
</liv:RecuperarCupomFiscalLC_Integracao>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:liv="http://LiveConnector/">
<soapenv:Header/>
<soapenv:Body>
<liv:RecuperarCupomFiscalLC_Integracao_Xml>
<liv:codigoSistemaSatelite>XXXXXXXX</liv:codigoSistemaSatelite>
<liv:xmlIdentificacao><![CDATA[<LC_Identificacao>
<Chave>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</Chave>
<CodigoSistemaSatelite>XXXXXXXX</CodigoSistemaSatelite>
</LC_Identificacao>]]></liv:xmlIdentificacao>
</liv:RecuperarCupomFiscalLC_Integracao_Xml>
</soapenv:Body>
</soapenv:Envelope>