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