Escolar Documentos
Profissional Documentos
Cultura Documentos
BematechConnector
Sumário
1. Introdução ............................................................................................................................................. 2
2. Conceitos ............................................................................................................................................... 3
2.1. Estrutura dos Tickets ................................................................................................................. 4
2.2. Estrutura de Documentos.......................................................................................................... 5
2.3. Artefatos de Banco de Dados .................................................................................................. 25
2.4. Procedures ............................................................................................................................... 29
2.5. Parâmetros Utilizados ............................................................................................................. 30
2.6. Mensagens............................................................................................................................... 30
3. Fluxo do BematechConnector ............................................................................................................. 30
3.1. Informações de Entrada para o BematechConnector ............................................................. 30
3.2. Informações de Saída do BematechConnector ....................................................................... 31
3.2.1. Montando Tickets de saída.................................................................................................. 31
3.2.2. Chamada dos métodos “Recuperar” ................................................................................... 33
3.2.3. Lista dos métodos “Recuperar” ........................................................................................... 33
3.3. Log de Erros ............................................................................................................................. 34
4. Considerações...................................................................................................................................... 34
1. Introdução
O BematechConnector funciona como um barramento, ou seja, um intermediário entre o PracticoLive e os
sistemas externos com o papel de disponibilizar informações do PracticoLive e receber informações de
outros sistemas integrando-as dentro do PracticoLive.
As informações são disponibilizadas através de WebService e são utilizados “Tickets” para receber e enviar
informações. Os Tickets podem ser de dois tipos, os de entrada e os de saída, e cada ticket pode ter um
conjunto de documentos, ou seja, um conjunto de notas fiscais, um conjunto de cupons fiscais, etc.
bematech.com Pagina 2 de 34
Manual Operacional
BematechConnector
2. Conceitos
Segue abaixo alguns conceitos importantes que são utilizados no BematechConnector:
Sistema Satélite – São os sistemas externos que utilizarão a integração do BematechConnector (ou
cada “Master” que utilizará a integração), cada sistema satélite receberá um código interno
fazendo com que a integração consiga distinguir para onde vai cada informação.
Chave – É um token que o sistema satélite precisa informar sempre que for utilizar a integração.
Esse token é definido para cada sistema satélite e tem uma validade de para o dia atual, o sistema
satélite tem a responsabilidade de solicitar uma nova chave todos os dias chamando o método
“ObterChaveAcesso”. Este método (ObterChaveAcesso) recebe como parâmetros um usuário e
uma senha, que devem existir no banco do Live. O usuário não precisa ter acesso a nada, será
usado apenas para validar a senha.
Tickets de entrada – São informações enviadas do sistema satélite para o PracticoLive (Sistema
Satélite -> BematechConnector).
Tickets de saída – São informações enviadas do PracticoLive para o sistema satélite (PracticoLive ->
Sistema Satélite).
Número do Ticket – Os números dos Tickets são criados de acordo com a seguinte regra:
o Entrada: O Número do Ticket enviado para o Live deverá ser uma string de 16 caracteres,
composta por um Zero (indicação de que o ticket é de entrada) seguido do ano (dois
dígitos), mês, dia, hora, minuto, segundo e milissegundos. Isso dará origem a um
identificador único. Exemplo de número para a data de criação igual “2013-09-17
18:05:46.677”: 0130917180546677.
o Saída: O Número do Ticket enviado para o Live deverá ser uma string de 16 caracteres,
composta por um 1 (indicação de que o ticket é de saída) seguido do ano (dois dígitos),
mês, dia, hora, minuto, segundo e milissegundos. Isso dará origem a um identificador
único. Exemplo de número para a data de criação igual a “2013-08-07 10:22:05.270”:
1130807102205270.
Situação dos Tickets – Os Tickets podem receber as seguintes situações (status):
o Aberto: Os Tickets estão abertos para receber documentos, ou seja, o número máximo de
documentos configurado para o ticket não foi atingido e o mesmo pode receber mais
documentos até sua capacidade máxima.
o Disponível para envio: O ticket está com o número máximo de documentos permitidos e
com isso está disponível para enviar as informações. Existe a possibilidade de um ticket ser
configurado para ser enviado parcialmente, ou seja, o número máximo de documentos não
foi atingido mas ele poderá ser enviado parcialmente.
o Envio confirmado: Após o recebimento do ticket por parte do sistema satélite o mesmo
deverá enviar uma confirmação de recebimento, essa confirmação altera a situação do
ticket para “Envio Confirmado” fazendo com que esse ticket não seja mais enviado para o
sistema satélite.
Data e Hora – Os campos Data e Hora dos Tickets são do tipo string, a Data deve ser no formado
yyyyMMdd e a Hora deve ser no formato hhmmss. Não há máscara ou caracteres de formatação.
bematech.com Pagina 3 de 34
Manual Operacional
BematechConnector
Ticket
Descrição Tipo
Data Varchar(8)
Hora Varchar(6)
CodigoSistemaSatelite Varchar(10)
Chave Guid
Numero Varchar(16)
Documentos IList
LC_TicketCupomFiscal
LC_TicketInventario
LC_TicketMovimentoCaixa
LC_TicketNotaEspelho
LC_TicketNotaEspelhoSaida
LC_TicketNotaFiscal
LC_TicketPedidoCompra
LC_TicketPreco
LC_TicketProduto
LC_TicketDocumentoFornecedorPedidoCompra
LC_TicketImpressoraFiscal
LC_TicketPreVenda
LC_TicketCampanhaCodigosPromocional
LC_TicketCupomFiscalCodigoPromocional
LC_TicketCliente
LC_TicketClienteSaida
LC_TicketReducaoZ
LC_TicketRegistroInventarioP7
LC_TicketRegistroMovimentacaoP3
bematech.com Pagina 4 de 34
Manual Operacional
BematechConnector
* Observações:
LC_TicketCupomFiscal
o LC_CupomFiscal
LC_ItemCupomFiscalCancelado
LC_FormaPagamento
LC_ItemCupomFiscal
LC_TributoCupomFiscal
LC_CupomFiscal
Descrição Tipo
DataHora DateTime
DataHoraServidor DateTime
Numero Long
Observação Varchar(500)
QuantidadeItens Double
DescricaoTipoDocumento Varchar (50)
DescricaoTipoOperacao Varchar (50)
ValorBruto Double
ValorLiquido Double
CodigoLoja Varchar (14)
CPFCliente Varchar (14)
NumeroImpressora Varchar (20)
NumeroPDV Varchar (4)
Situacao Varchar (1)
ValorDesconto Double
NumeroLoja Varchar (20)
SerieNFCe Varchar (3)
ChaveNFCe Varchar (54)
bematech.com Pagina 5 de 34
Manual Operacional
BematechConnector
LC_ItemCupomFiscalCancelado
Descrição Tipo
AliquotaImposto Double
Codigo Varchar(10)
Item Int
Quantidade Double
TipoImpostoECF TiposImpostoECF
ValorComissao Double
ValorTotalItem Double
ValorTotalItemBruto Double
Vendedor Varchar(50)
LC_FormaPagamento
Descrição Tipo
FormaPagamento Varchar (2)
ProdutoEletronico Varchar (3)
Parcela Varchar (10)
ValorPagamento Double
DescricaoFormaPagamento Varchar (50)
DescricaoProdutoEletronico Varchar (50)
Autorizacao Varchar (40)
AdministradoraCartao Varchar(100)
CodigoAdministradoraCartao Varchar(50)
LC_ItemCupomFiscal
Descrição Tipo
CodigoAlternativo Varchar (20)
CodigoProduto Varchar (20)
DescricaoTipoImpostoECF Varchar (20)
DescricaoTipoOperacao Varchar (50)
IdentificacaoVendedor Varchar (20)
Observacao Varchar (500)
Quantidade Double
SituacaoTributariaICMS Varchar (2)
ValorComissao Double
ValorTotalBruto Double
bematech.com Pagina 6 de 34
Manual Operacional
BematechConnector
ValorTotalLiquido Double
ValorUnitarioBruto Double
ValorUnitarioLiquido Double
CodigoPrincipalPracticoProduto Varchar (20)
NumeroItem Varchar (6)
UnidadeMedida Varchar (3)
ValorDescontoItem Double
LC_TributoCupomFiscal
Descrição Tipo
CodigoTributo Varchar (10)
BaseCalculo Double
Aliquota Double
ValorTributo Double
ValorIsenta Double
ValorOutras Double
SituacaoTributaria Varchar (2)
DescricaoTributo Varchar (250)
CFOP Int
CodTot Varchar(20)
LC_TicketInventario
o LC_Inventario
LC_ItemInventario
LC_Inventario
Descrição Tipo
CodigoInventario Varchar(25)
CNPJLoja Varchar(20)
NumeroSerieLoja Varchar(9)
DataCriacao DateTime
DataFechamento DateTime
LC_ItemInventario
Descrição Tipo
IDProduto Guid
DescricaoProduto Varchar(200)
QuantidadeInventariada Double
CodigoAlternativo Varchar(20)
bematech.com Pagina 7 de 34
Manual Operacional
BematechConnector
CodigoPrincipalPractico Varchar(20)
CodigoProduto Varchar(20)
LC_TicketMovimentoCaixa
o LC_MovimentoCaixa
LC_ManipulacaoMovimentoCaixa
LC_PagamentoMovimentoCaixa
LC_MovimentoCaixa
Descrição Tipo
CodigoLoja Varchar(20)
NumeroPDV Varchar(7)
Operador Varchar(200)
DataAbertura DateTime
DataFechamento DateTime
LC_ManipulacaoMovimentoCaixa
Descrição Tipo
Descricao Varchar(60)
Data DateTime
Valor double
Motivo Varchar(500)
Operador Varchar(200)
CodigoPlano Varchar(25)
Descricaoplano Varchar(50)
NaturezaPlano Char(1)
LC_PagamentoMovimentoCaixa
Descrição Tipo
FormaPagamento Varchar(60)
ValorCalculado Double
Movimento Double
ValorCaixa Double
ValorConferido Double
Quebra Double
LC_TicketNotaEspelho
o LC_NotaEspelho
LC_ItemNotaEspelho
Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo
CEP: 13208-056 Fone: 55 11 4583-8800
bematech.com Pagina 8 de 34
Manual Operacional
BematechConnector
LC_NotaEspelho
Descrição Tipo Obrigatório
CNPJFornecedor Varchar(20) Sim
CNPJUnidadeNegocio Varchar(20) Sim
DataEmissao DateTime Sim
NumeroNota Varchar(6) Sim
NumeroOrdemVenda Varchar(10) Sim
ValorLiquidoNota Double Sim
CategoriaFiscalUnidadeNegocio Varchar(5) Não
ChaveNfe Varchar(44) Não
CodigoSetorIndustrial Varchar(8000) Não
CPFFuncionario Varchar(20) Não
DescricaoSetorIndustrial Varchar(50) Não
DescricaoTipoDocumento Varchar(50) Não
Excluir Bool Não
Modelo Varchar(2) Não
NomeEntidade Varchar(100) Não
NomeUnidadeNegocio Varchar(50) Não
NumeroDocumentoFornecedor Varchar(10) Não
NumeroLogNfe Varchar(15) Não
NumeroNotaFiscalE Varchar(16) Não
QuantidadeItens Long Não
StatusNota Varchar(1) Não
TipoNota Varchar(4) Não
TotalCOFINS Double Não
TotalDescontos Double Não
TotalICMS Double Não
TotalIPI Double Não
TotalPIS Double Não
TotalProdutos Double Não
ValorNota Double Não
LC_ItemNotaEspelho
Descrição Tipo Obrigatório
CFOP Varchar(10) Sim
CodigoItemNota Varchar(20) Sim
CodigoLoja Varchar(20) Sim
PosicaoItemNota Varchar(5) Sim
PrecoUnitarioItemNota Double Sim
QuantidadeRecebidaItemNota Double Sim
bematech.com Pagina 9 de 34
Manual Operacional
BematechConnector
bematech.com Pagina 10 de 34
Manual Operacional
BematechConnector
LC_TicketNotaEspelhoSaida
o LC_NotaEspelhoSaida
LC_NotaEspelhoSaida
Descrição Tipo
CNPJUnidadeNegocio Varchar(20)
CNPJFornecedor Varchar(20)
NumeroNotaFiscal Varchar(6)
NumeroNotaFiscalE Varchar(16)
DataRecebimento DateTime
SerieNotaFiscal Varchar(10)
Situacao Varchar(3)
LC_TicketNotaFiscal
o LC_NotaFiscal
LC_TipoDocumentoNotaFiscal
LC_ItemNotaFiscal
LC_TributoNotaFiscal
LC_NotaFiscal
Descrição Tipo
ChaveNFe Varchar(44)
CodigoLoja Varchar(20)
DataEmissao DateTime
DataMovimento DateTime
Destinatario Varchar(20)
Emitente Varchar(20)
Modelo Varchar(10)
NumeroLogNFe Varchar(15)
NumeroNotaFiscal Varchar(9)
bematech.com Pagina 11 de 34
Manual Operacional
BematechConnector
Observacao Varchar(5000)
Serie Varchar(10)
Situacao Varchar(255)(Enum)
TipoNota LC_TipoNotaFiscal
ValorBruto Double
ValorDesconto Double
ValorDespesas Double
ValorLiquido Double
ValorTotalFinanceiro Double
ValorTotalGeral Double
ValorTributos Double
LC_TipoDocumentoNotaFiscal
Descrição Tipo
Categoria Varchar(4)
Codigo Int
Descricao Varchar(50)
Entidade Varchar(4)
LC_ItemNotaFiscal
Descrição Tipo
CNPJLojaOrigem Varchar(20)
CodigoProduto Varchar(20)
DataEmissaoOrigem DateTime
ItemDoctoOrigem Int
NumeroDoctoDest Varchar(20)
NumeroDoctoOrigem Varchar(20)
NumeroItem Int
OperacaoFiscal Varchar(10)
PrecoUnitario Double
Quantidade Double
UnidadeMedida Varchar(10)
ValorBrutoItem Double
ValorDescontoItem Double
ValorDespesaItem Double
ValorLiquidoItem Double
ValorTotalItem Double
VariacaoCFOP Varchar(10)
CodigoAlternativo Varchar(20)
ItemDoctoDest Int
Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo
CEP: 13208-056 Fone: 55 11 4583-8800
bematech.com Pagina 12 de 34
Manual Operacional
BematechConnector
CodigoPrincipalPractico Varchar(20)
ValorTotalTributos Double
LC_TributoNotaFiscal
Descrição Tipo
Aliquota Double
BaseCalculo Double
SiglaTributo Varchar(10)
SituacaoTributaria Varchar(50)
ValorIsenta Double
ValorOutras Double
ValorTributo Double
DispositivoLegal Varchar(8000)
LC_TicketPedidoCompra
o LC_PedidoCompra
LC_ItemPedidoCompra
LC_PedidoCompra
Descrição Tipo
Atualizar Bool
CNPJUnidadeNegocio Varchar(20)
CodigoExternoCondicaoPagamento Varchar(10)
CPUnidadeNegocio Varchar(20)
DataEmissao DateTime
DataHora DateTime
DescricaoCondicaoPagamento Varchar(50)
DescricaoSituacao Varchar(80)
Excluir Bool
IDCondicaoPagamento Guid
IDEntidade Guid
IDLote Guid
IDSerie Guid
IDSugestaoPedidoCompra Guid
IDUnidadeNegocio Guid
IDUsuario Varchar(100)
NomeEntidade Varchar(100)
NomeUnidadeNegocio Varchar(50)
Numero Long
NumeroLojaUnidadeNegocio Varchar(20)
bematech.com Pagina 13 de 34
Manual Operacional
BematechConnector
NumeroOrdemVenda Varchar(10)
NumeroSerieUnidadeNegocio Varchar(10)
Observacao Varchar(500)
PaginacaoPaginaAtual Int
PaginacaoTotalPaginas Int
PermiteDesbloqueioProdutos Bool
SiglaSerie Varchar(10)
Situacao SituacaoPedido
TemSugestaoCompra Bool
TotalItensLinhas Int
TotalProdutos Double
ValorBruto Double
ValorLiquido Double
ValorTotalCalculado Double
CNPJFornecedor Varchar(20)
LC_ItemPedidoCompra
Descrição Tipo
CodigoAlternativo Varchar(20)
CodigoExternoCondicaoPagamento Varchar(10)
CodigoPrincipalPracticoProduto Varchar(20)
CodigoProduto Varchar(20)
DescricaoCondicaoPagamento Varchar(50)
DescricaoOperacaoFiscal Varchar(50)
DescricaoProduto Varchar(200)
DescricaoSituacao Varchar(80)
DescricaoTipoProduto Varchar(50)
EstoqueMinimo Double
GeraFinanceiroOperacaoFiscal Bool
IDCondicaoPagamento Guid
IDItemSugestaoPedidoCompra Guid
IDOperacaoFiscal Guid
IDProduto Guid
IDUsuario Varchar(100)
Item Int
Observacao Varchar(500)
PaginacaoPaginaAtual Int
PaginacaoTotalPaginas Int
QuantidadeAberto Double
QuantidadeCancelado Double
bematech.com Pagina 14 de 34
Manual Operacional
BematechConnector
QuantidadeCasaDecimal Int
QuantidadeEstoque Double
QuantidadeFornecedorAberto Double
QuantidadeFornecedorAtendimento Double
QuantidadeFornecedorFaturado Double
QuantidadeFornecedorOriginal Double
QuantidadeFornecedorRecusado Double
QuantidadeMultiplaCompra Double
QuantidadeOriginal Double
QuantidadeRecebido Double
QuantidadeRecusadoFornecedor Double
QuantidadeSolicitado Double
QuantidadeUnidadeCaixa Double
ReferenciaOperacaoFiscal Varchar(10)
Situacao Int
ValorTotalItemBruto Double
ValorTotalItemLiquido Double
ValorUnitarioBruto Double
ValorUnitarioLiquido Double
LC_TicketPreco
o LC_Preco
LC_ItemPreco
LC_PrecoUnidadeNegocio
LC_Preco
Descrição Tipo Obrigatório
Sim - Não pode ser
menor que a data
VigenciaPadrao DateTime atual
Descricao Varchar(50) Sim
PrecoDeCompra Bool Sim
Não pode ser menor
DiasEncargo Int que zero
Não pode ser menor
PercentualEncargoEmbutido Double que zero
Codigo Long Não
Inativo Bool Não
PrecoCentralizado Bool Não
QTDItens Int Não
Regiao Varchar(3) Não
bematech.com Pagina 15 de 34
Manual Operacional
BematechConnector
LC_ItemPreco
Descrição Tipo Obrigatório
Sim - Deve ser maior
InicioVigencia DateTime que a data atual
CodigoProduto Varchar(20) Sim
Valor Double Sim
Apagar Bool Não
DescricaoProduto Varchar(200) Não
IDProduto Guid Não
NaoConsistirVigencia Bool Não
Observacao Varchar(50) Não
LC_PrecoUnidadeNegocio
Descrição Tipo Obrigatório
CNPJUnidadeNegocio Varchar(20) Sim
NumeroLojaUnidadeNegocio Varchar(9) Não
LC_TicketProduto
o LC_Produto
LC_ClassificacaoProduto
LC_Produto
Descrição Tipo Obrigatório
Ativo Bool Sim
CNPJFornecedor Varchar(20) Sim
CodigoAlternativo Varchar(20) Sim
CodigoClassificacaoFiscal Varchar(20) Sim
CodigoPadrao Varchar(20) Sim
Descricao Varchar(200) Sim
DescricaoResumida Varchar(50) Sim
DescricaoTipoProduto Varchar(50) Sim
IPPT Varchar(1) Sim
SiglaUnidadeMedida Varchar(10) Sim
CNAE Guid Não
CodigoItemServico Varchar(20) Não
CodigoPrincipal Varchar(20) Não
DescontoMaximo Double Não
DescontoVendaPromocao Double Não
Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo
CEP: 13208-056 Fone: 55 11 4583-8800
bematech.com Pagina 16 de 34
Manual Operacional
BematechConnector
LC_TicketDocumentoFornecedorPedidoCompra
o LC_DocumentoFornecedorPedidoCompra
LC_ItemDocumentoFornecedorPedidoCompra
LC_DocumentoFornecedorPedidoCompra
Descrição Tipo Obrigatório
CNPJUnidadeNegocio Varchar(20) Sim
DataPedido DateTime Sim
NumeroDocumentoFornecedor Varchar(10) Sim
NumeroPedido Int Sim
LC_ItemDocumentoFornecedorPedidoCompra
Descrição Tipo Obrigatório
CodigoProduto Varchar(20) Sim
PrecoUnitario Double Sim
QuantidadeAceita Double Sim
SequenciaItem Int Sim
LC_TicketImpressoraFiscal
o LC_ImpressoraFiscal
LC_ImpressoraFiscal
Descrição Tipo
CNPJUnidadeNegocio Varchar(20)
IDImpressora GUID
bematech.com Pagina 17 de 34
Manual Operacional
BematechConnector
Marca Varchar(30)
Modelo Varchar(30)
NumeroSerie Varchar(20)
LC_TicketPreVenda
o LC_PreVenda
LC_ItemPreVenda
LC_DescontoItem
LC_PreVenda
Descrição Tipo
CodigoLojaUnidadeNegocio Varchar(14)
Data DateTime
DataEmissaoCupom DateTime
IDCliente GUID
IdentificacaoCliente Varchar(20)
IDUnidadeNegocio GUID
Numero Long
NumeroCupom Long
Situacao LC_SituacaopreVenda
ValorBruto Double
ValorLiquido Double
ValorTotalCupom Double
LC_ItemPreVenda
Descrição Tipo
Codigo Varchar(20)
CodigoPrincipalPractico Varchar(20)
Item Int
Quantidade Double
ValorTotalItem Double
ValorTotalItemBruto Double
IdentificacaoVendedor Varchar(20)
LC_DescontoItem
Descrição Tipo
Complemento Varchar(100)
Motivo Varchar(100)
Valor Double
bematech.com Pagina 18 de 34
Manual Operacional
BematechConnector
LC_TicketCampanhaCodigosPromocional
o LC_CampanhaPromocional
LC_CodigosCampanhaPromocional
LC_CampanhaPromocional
Descrição Tipo Obrigatório
CodigoExterno Int Sim
DescricaoCampanha Varchar(200) Sim
DataInicioVigencia DateTime Sim
DataFimVigencia DateTime Sim
HoraInicioVigencia Varchar(5) Sim
HoraFimVigencia Varchar(5) Sim
IndentificacaoFornecedorCampanha Varchar(20) Não
LC_CodigosCampanhaPromocional
Descrição Tipo Obrigatório
Codigo Varchar(50) Sim
LC_TicketCupomFiscalCodigoPromocional
o LC_CupomFiscalCodigoPromocional
LC_CupomFiscalCodigoPromocional
Descrição Tipo
DataHora DateTime
DataHoraServidor DateTime
Numero Long
CodigoValido Varchar(50)
DataHoraValidacaoCodigoPromocional DateTime
CPFCliente Varchar(20)
PrecoCompra Double
IDCampanha Int
LC_TicketCliente
o LC_Cliente
LC_Endereco
LC_DocumentoCliente
LC_EnderecoEletronico
LC_Telefone
bematech.com Pagina 19 de 34
Manual Operacional
BematechConnector
LC_Cliente
Descrição Tipo
TipoCliente TiposFichaPessoa
CPF_CNPJ Varchar(20)
Nome_RazaoSocial Varchar(100)
Apelido Varchar(100)
Indicacao Varchar(120)
Nota Varchar(255)
Sexo TiposSexo
DataNascimento DateTime
Obsercacoes Varchar(255)
Inativo Bool
LC_Endereco
Descrição Tipo
TipoEndereco LC_TipoEndereco
Logradouro Varchar(100)
Numero Int
Complemento Varchar(200)
Bairro Varchar(50)
CEP Varchar(10)
Estado Varchar(2)
Cidade_NumeroMunicipioIBGE Long
LC_DocumentoCliente
Descrição Tipo
TipoDocumentoCliente LC_TipoDocumentoCliente
Identificacao Varchar(50)
LC_EnderecoEletronico
Descrição Tipo
TipoEnderecoEletronico LC_TipoEnderecoEletronico
Descricao Varchar(60)
LC_Telefone
Descrição Tipo
TipoTelefone LC_TipoTelefone
DDD Varchar(3)
bematech.com Pagina 20 de 34
Manual Operacional
BematechConnector
Numero Varchar(9)
Complemento Varchar(30)
LC_TicketClienteSaida
o LC_ClienteSaida
LC_EnderecoSaida
LC_DocumentoClienteSaida
LC_TelefoneSaida
LC_EnderecoEletronicoSaida
LC_ClassificacaoClienteSaida
LC_ClienteSaida
Descrição Tipo
TipoCliente TiposFichaPessoa
CPF_CNPJ Varchar(20)
Nome_RazaoSocial Varchar(100)
Apelido Varchar(100)
Indicacao Varchar(120)
Nota Varchar(255)
Sexo TiposSexo
DataNascimento DateTime
Obsercacoes Varchar(255)
Inativo Bool
LC_EnderecoSaida
Descrição Tipo
TipoEndereco LC_TipoEndereco
Logradouro Varchar(100)
Numero Int
Complemento Varchar(200)
Bairro Varchar(50)
CEP Varchar(10)
Estado Varchar(2)
Cidade_NumeroMunicipioIBGE Long
LC_DocumentoClienteSaida
Descrição Tipo
TipoDocumentoCliente LC_TipoDocumentoCliente
Identificacao Varchar(50)
Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo
CEP: 13208-056 Fone: 55 11 4583-8800
bematech.com Pagina 21 de 34
Manual Operacional
BematechConnector
LC_TelefoneSaida
Descrição Tipo
TipoTelefone LC_TipoTelefone
DDD Varchar(3)
Numero Varchar(9)
Complemento Varchar(30)
LC_EnderecoEletronicoSaida
Descrição Tipo
TipoEnderecoEletronico LC_TipoEnderecoEletronico
Descricao Varchar(60)
LC_ClassificacaoClienteSaida
Descrição Tipo
ParticipaDesconto Bool
DescricaoTipoClassificacao Varchar(200)
Descricao Varchar(200)
LC_TicketReducaoZ
o LC_ReducaoZ
LC_ReducaoZ
Descrição Tipo
CNPJUnidadeNegocio Varchar(20)
ContReducaoZ Long
COOFinal Long
COOInicial Long
Data DateTime
DataF Varchar(10)
DescrAliq1 Varchar(10)
DescrAliq2 Varchar(10)
DescrAliq3 Varchar(10)
DescrAliq4 Varchar(10)
EnderecoUnidadeNegocio Varchar(100)
FuncaoResponsavel Varchar(50)
IEUnidadeNegocio Varchar(20)
MunicipioUnidadeNegocio Varchar(50)
Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo
CEP: 13208-056 Fone: 55 11 4583-8800
bematech.com Pagina 22 de 34
Manual Operacional
BematechConnector
NomeResponsavel Varchar(50)
NomeUnidadeNegocio Varchar(50)
Numero Int
NumeroSerieUnidadeNegocio Varchar(9)
Obs Varchar(200)
PDV Int
PercAliq1 Double
PercAliq2 Double
PercAliq3 Double
PercAliq4 Double
TGFinal Double
TGInicial Double
UFUnidadeNegocio Varchar(2)
VrAliq1 Double
VrAliq2 Double
VrAliq3 Double
VrAliq4 Double
VrCancelamentos Double
VrContabil Double
VrImp1 Double
VrImp2 Double
VrImp3 Double
VrImp4 Double
VrImposto Double
VrIsentas Double
VrISSQN Double
VrMovDia Double
VrSubstituicao Double
NumeroSerieImpressora Varchar(20)
OperacaoNaoFiscal Varchar(15)
Desconto Varchar(15)
Acrescimo Varchar(15)
LC_TicketRegistroInventarioP7
o LC_RegistroInventarioP7
LC_RegistroInventarioP7
Descrição Tipo
NumeroSerieLoja Varchar(20)
DataRegistro Varchar(15)
IDProduto Varchar(36)
Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo
CEP: 13208-056 Fone: 55 11 4583-8800
bematech.com Pagina 23 de 34
Manual Operacional
BematechConnector
CodSitTrib Varchar(10)
DescSitTrib Varchar(50)
CodigoNCM Varchar(20)
CodigoProduto Varchar(20)
PosicaoAtual Double
UnidMed Varchar(10)
VrUnitario Double
VrParcial Double
LC_TicketRegistroMovimentacaoP3
o LC_RegistroMovimentacaoP3
LC_RegistroMovimentacaoP3
Descrição Tipo
IDProduto GUID
CodigoPadrao Varchar(20)
CodigoPractico Varchar(20)
DescricaoProduto Varchar(200)
Sigla Varchar(10)
DataDocumento DateTime
NumeroDocumento Varchar(20)
SequenciaDocumento Int32
CodigoTransacaoEstoque Int32
DescricaoTransacaoEstoque Varchar(100)
TipoMovimento Int32
ModificaCusto Boolean
Quantidade Double
ValorUnitario Double
ValorTotal Double
CustoUnitario Double
CustoTotal Double
CustoMedio Double
NumeroNotaFiscal Varchar(10)
DataEmissao DateTime
DataRecebimento DateTime
Serie Varchar(10)
SerieFiscal Varchar(10)
bematech.com Pagina 24 de 34
Manual Operacional
BematechConnector
LC_ChaveAcesso: Tabela utilizada para salvar as informações de chave de acesso, como código do
sistema satélite, chave e a validade da chave.
LC_ChaveAcesso
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
OwnerID uniqueidentifier 16 Sim
UserID uniqueidentifier 16 Sim
Creation datetime 8 Sim
LastUpdate datetime 8 Sim
CodigoSistemaSatelite varchar 10 Não
Chave uniqueidentifier 16 Sim
Validade datetime 8 Sim
LC_ConfiguracaoTicket
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
OwnerID uniqueidentifier 16 Sim
UserID uniqueidentifier 16 Sim
Creation datetime 8 Sim
LastUpdate datetime 8 Sim
TipoTicket int 4 Sim
QuantidadeDocumentosPorTicket int 4 Sim
PermiteGerarTicketParcial bit 1 Sim
LC_DocumentoDisponibilizado
bematech.com Pagina 25 de 34
Manual Operacional
BematechConnector
LC_DocumentoEntrada: Tabela utilizada para salvar as informações dos documentos que são
enviados dos sistemas satélites para o PracticoLive.
LC_DocumentoEntrada
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
OwnerID uniqueidentifier 16 Sim
UserID uniqueidentifier 16 Sim
Creation datetime 8 Sim
LastUpdate datetime 8 Sim
Data varchar 8 Não
Hora varchar 6 Não
CodigoSistemaSatelite varchar 10 Não
Chave uniqueidentifier 16 Sim
IDDocumento uniqueidentifier 16 Não
NumeroSequencia varchar 6 Não
IDFila uniqueidentifier 16 Não
QuantidadeInvocacoes int 4 Sim
Ticket uniqueidentifier 16 Sim
LC_TicketEntrada: Tabela utilizada para salvar as informações de Tickets que foram enviadas dos
sistemas satélites para o PracticoLive.
LC_TicketEntrada
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
bematech.com Pagina 26 de 34
Manual Operacional
BematechConnector
LC_DocumentoSaida: Tabela utilizada para salvar as informações dos documentos que serão
incluídos no ticket de saída.
LC_DocumentoSaida
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
OwnerID uniqueidentifier 16 Sim
UserID uniqueidentifier 16 Sim
Creation datetime 8 Sim
LastUpdate datetime 8 Sim
Data varchar 8 Não
Hora varchar 6 Não
CodigoSistemaSatelite varchar 10 Não
Chave uniqueidentifier 16 Sim
IDDocumento uniqueidentifier 16 Não
NumeroSequencia varchar 6 Não
Excluido bit 1 Sim
Ticket uniqueidentifier 16 Sim
LC_TicketSaida:Tabela utilizada para salvar as informações dos Tickets que serão enviados o
PracticoLive para os sistemas satélites.
LC_TicketSaida
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
OwnerID uniqueidentifier 16 Sim
UserID uniqueidentifier 16 Sim
bematech.com Pagina 27 de 34
Manual Operacional
BematechConnector
LC_SistemaSatelite: Tabela utilizada para salvar as informações referente ao cadastro dos sistemas
satélites, como código, descrição e ID do domínio associado.
LC_SistemaSatelite
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
OwnerID uniqueidentifier 16 Sim
UserID uniqueidentifier 16 Sim
Creation datetime 8 Sim
LastUpdate datetime 8 Sim
Codigo varchar 10 Não
Descricao varchar 255 Sim
UltimoTicketEntrada varchar 16 Sim
UltimoTicketSaida varchar 16 Sim
IDDominioAssociado uniqueidentifier 16 Sim
LC_LogLiveConnector: Tabela utilizada para salvar as informações de erros que aconteceram nos
métodos do BematechConnector.
LC_LogLiveConnector
Nome da Coluna Tipo Tamanho Permite Nulo?
Record bigint 8 Não
ObjectID uniqueidentifier 16 Não
OwnerID uniqueidentifier 16 Sim
UserID uniqueidentifier 16 Sim
Creation datetime 8 Sim
LastUpdate datetime 8 Sim
Data datetime 8 Sim
bematech.com Pagina 28 de 34
Manual Operacional
BematechConnector
2.4. Procedures
Algumas procedures são utilizadas para garantir o fluxo das informações entre PracticoLive,
BematechConnector e Sistemas Satélites. Segue abaixo a relação de cada uma com sua respectiva
explicação.
0 - Produto
1 - Preco
2 - NotaEspelho
3 - CupomFiscal
4 - ReducaoZ
5 - Inventario
6 - Fornecedor
7 - Cliente
8 - ContratoCredito
9 - ContaReceber
10 - NCM
11 - ClienteProduto
12 - PedidoCompra
13 - NotaFiscal
14 - NotaEspelhoSaida
15 - MovimentoCaixa
16 - DocumentoFornecedorPedidoCompra
17 - CupomFiscalCodigoPromocional
18 - CampanhaPromocional
19 - ClienteSaida
20 - ImpressoraFiscal
21 - PreVenda
bematech.com Pagina 29 de 34
Manual Operacional
BematechConnector
22 - PreVendaSaida
23 - RegistroInventarioP7
24 - RegistroMovimentacaoP3
Parâmetro 85 (Tem Integração com o BematechConnector?), utilizado para verificar se a loja tem
integração com o BematechConnector. Sem esse parâmetro a loja não conseguirá utilizar a integração
mesmo se a Master possuir um código de sistema satélite.
2.6. Mensagens
Foi criado um novo grupo para trabalhar com as mensagens geradas pelo BematechConnector (grupo 5), as
regras de mensagens do BematechConnector são os códigos 71, 72, 73, 74, 75, 76, 77. As tabelas que
armazenam essas informações são:
GrupoMensagem
RegraMensagem
Foi criada a task 011 para processar o grupo 5 da fila, ou seja, o grupo que tem as mensagens que foram
geradas pelo BematechConnector.
3. Fluxo do BematechConnector
3.1. Informações de Entrada para o BematechConnector
Para as informações de entrada para o BematechConnector o Sistema Satélite deverá montar o objeto que
será enviado para a integração, o Ticket e o documento do Ticket, para isso ele deverá:
bematech.com Pagina 30 de 34
Manual Operacional
BematechConnector
Validar os Tickets, verificando se o objeto enviado está vazio, verifica se a chave de acesso é válida,
entre outras;
Verifica se o Ticket enviado já existe no banco de dados;
Verifica se o documento enviado já se encontra no banco de dados, se sim significa que é uma
alteração e o método encaminha o fluxo para os métodos de alteração (AlterarNotaEspelho,
AlterarPreco, AlterarProduto, AlterarCampanha, AlterarCliente), senão o fluxo utilizado é o de
inserção de dados (IncluirNotaEspelho, IncluirPreco, IncluirProduto, IncluirCampanha,
IncluirCliente);
Envia informações
Retorna objeto
bematech.com Pagina 31 de 34
Manual Operacional
BematechConnector
Toda vez que uma nota fiscal for exportada ou um cupom fiscal for inserido no PracticoLive essas
informações, de alguma forma, deverão ser disponibilizadas para que outros sistemas possam recuperá-las
e trabalhar com elas.
Para garantir esse fluxo foi desenvolvido o método “DisponibilizarDocumento”, que é responsável por
gravar o ID das operações que foram programadas para trabalhar com o BematechConnector. A chamada
“Rentech.PracticoLive.Global.Server.LC_TicketSaida.DisponibilizarDocumento(Guid
publicDomain, Guid protectedDomain, LC_TiposTicket tipoTicket, Guid
ownerIDDocumento, Guid iDDocumento, Boolean excluido)”, em cada método que executa
uma operação que seja relevante/importante para ser enviada pelo BematechConnector garante que os IDs
sejam salvos na tabela “LC_DocumentoDisponibilizado”, por exemplo, essa chamada foi incluída no final
do método “Integrar” da Nota Fiscal, com isso toda vez que uma nota fiscal for integrada o ID dessa nota
será disponibilizado na tabela “LC_DocumentoDisponibilizado”.
Comercial:
o Rentech.PracticoLive.Comercial.Facade.AberturaCaixa.Atualizar
o Rentech.PracticoLive.Comercial.Server.AberturaCaixa.Excluir
o Rentech.PracticoLive.Comercial.Facade.Venda.Informar
o Rentech.PracticoLive.Comercial.Server.OutroMovimentoCaixa.Incluir
o Rentech.PracticoLive.Comercial.Server.OutroMovimentoCaixa.Alterar
o Rentech.PracticoLive.Comercial.Server.OutroMovimentoCaixa.Excluir
o Rentech.PracticoLive.Comercial.Server.ImpressoraFiscal.Incluir
o Rentech.PracticoLive.Comercial.Server.ImpressoraFiscal.Alterar
o Rentech.PracticoLive.Comercial.Server.ImpressoraFiscal.Excluir
Estoque:
o Rentech.PracticoLive.Estoque.Facade.Inventario.Fechar
o Rentech.PracticoLive.Estoque.Server.Inventario.Excluir
Fiscal:
o Rentech.PracticoLive.Fiscal.NotaFiscal.Facade.Integrar
o Rentech.PracticoLive.Fiscal.NotaFiscal.Facade.Cancelar
o Rentech.PracticoLive.Fiscal.NotaFiscal.Facade.RegistrarImpressao
Global
o Rentech.PracticoLive.Global.Cliente.Atualizar
Suprimento:
o Rentech.PracticoLive.Suprimento.Facade.Nota.Atualizar
o Rentech.PracticoLive.Suprimento.Facade.Nota.Cancelar
o Rentech.PracticoLive.Suprimento.Facade.Pedido.Atualizar
o Rentech.PracticoLive.Suprimento.Facade.Pedido.AtualizarSituacao
o Rentech.PracticoLive.Suprimento.Facade.Pedido.atualizarItens
bematech.com Pagina 32 de 34
Manual Operacional
BematechConnector
Todos os métodos de recuperação efetuam algumas validações antes de montar o objeto de retorno
(Ticket de Saída), como verificar se o código do sistema satélite foi preenchido ou se a chave de acesso
passada é uma chave válida. Após esse processo o método verifica se existe algum Ticket aberto ou
disponível para envio, se existir as informações do Ticket são recuperadas do banco do PracticoLive e o
objeto de retorno é montado (o tipo do objeto depende do método que foi invocado).
Solicita informações
Retorna objeto
bematech.com Pagina 33 de 34
Manual Operacional
BematechConnector
RecuperarImpressoraFiscal
RecuperarInventario
RecuperarMovimentoCaixa
RecuperarNotaEspelho
RecuperarNotaFiscal
RecuperarNotaFiscalEletronica
RecuperarNotaFiscalEletronica
RecuperarPreVenda
RecuperarProdutoFidelidade
RecuperarReducaoZ
RecuperarUnidadeMedidaFidelidade
4. Considerações
Os parâmetros 129 e 130 são utilizados para bloquear o uso do BematechConnector para os
códigos de sistemas satélites informados para estes parâmetros.
O parâmetro 132 (LiveConnector - Desabilita lista de Unidade de Negocio para tabela de preço (1 =
SIM | 0 = NÃO)), foi criado para desabilitar a utilização das unidades de negocio passadas por
parâmetro para o método “ManterPreco”, com isso se o parâmetro estiver ativo o método
recupera as unidades de negocio já cadastradas para a tabela de preço e utiliza as mesmas para
atualizar as informações de preço.
bematech.com Pagina 34 de 34