Você está na página 1de 34

Manual Operacional

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

Setor responsável: Desenvolvimento de Software


Criado por: Henrique Pugliese
Revisado por: Ângelo Amaral
Aprovado por: Ângelo Amaral
Última modificação: 06/01/2015
Manual Operacional
BematechConnector

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.

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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.

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 3 de 34
Manual Operacional
BematechConnector

2.1. Estrutura dos Tickets


Os Tickets são estruturados da seguinte forma:

 Identificação: Contendo Data, Hora, Código do Sistema Satélite e Chave.


 Número: Seguindo as regras para criação do número do ticket.
 Lista de Documentos: Conjunto de objetos contendo um número de sequência para cada
documento.

Ticket
Descrição Tipo
Data Varchar(8)
Hora Varchar(6)
CodigoSistemaSatelite Varchar(10)
Chave Guid
Numero Varchar(16)
Documentos IList

Os objetos de Tickets que o BematechConnector disponibiliza são:

 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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 4 de 34
Manual Operacional
BematechConnector

2.2. Estrutura de Documentos


O documento é uma lista de objetos, estes objetos são disponibilizados pelo BematechConnector tanto
para Tickets de entrada quanto para Tickets de saída. Segue abaixo a lista com os objetos de Tickets e seus
respectivos objetos de documentos:

* Observações:

- Para o código da loja ou código do fornecedor será utilizado o respectivo CNPJ.

- Alguns objetos não estão na estrutura de Tickets. Exemplo:


 Produto
 Fornecedor
 Cliente
 UnidadeMedida

 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)

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 5 de 34
Manual Operacional
BematechConnector

SituacaoNFCe Varchar (30)


SiglaModelo Varchar (30)

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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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)

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 9 de 34
Manual Operacional
BematechConnector

CodigoDescricaoFiscalICMS Varchar(4) Não


DescontoUnitarioItemNota Double Não
DescricaoOperacaoFiscal Varchar(50) Não
DescricaoProduto Varchar(200) Não
IcmsItemNota Double Não
IDItemPedido Guid Não
IpiItemNota Double Não
ItemPedido Int Não
ItemPedidoFornecedor Int Não
ItemPedidoPractico Int Não
Linha1DescricaoFiscalICMS Varchar(200) Não
Linha2DescricaoFiscalICMS Varchar(200) Não
Linha3DescricaoFiscalICMS Varchar(200) Não
Linha4DescricaoFiscalICMS Varchar(200) Não
LoteItemNota Varchar(3) Não
NumeroNota Varchar(6) Não
NumeroOrdemVenda Varchar(10) Não
NumeroPedidoFornecedor Varchar(20) Não
NumeroPedidoPractico Varchar(6) Não
Observacao Varchar(500) Não
OrigemPedido Double Não
PercentualCOFINS Double Não
PercentualICMS Double Não
PercentualICMSSubstituicao Double Não
PercentualIPI Double Não
PercentualISS Double Não
PercentualIVA Double Não
PercentualPIS Double Não
PercentualReducaoICMS Double Não
PercentualReducaoIPI Double Não
QuantidadeDevolvidaItemNota Double Não
TipoItemNota Char(1) Não
TotalDespesas Double Não
TotalICMSItemNota Double Não
ValorBaseCOFINS Double Não
ValorBaseICMS Double Não
ValorBaseICMSSubstituicao Double Não
ValorBaseIPI Double Não
ValorBaseISS Double Não
ValorBasePIS Double Não
ValorBruto Double Não

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 10 de 34
Manual Operacional
BematechConnector

ValorCOFINS Double Não


ValorICMS Double Não
ValorICMSSubstituicao Double Não
ValorIPI Double Não
ValorISS Double Não
ValorLiquido Double Não
ValorPIS Double Não
ValorTaxaServico Double Não
ValorTributos Double Não

 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)

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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)

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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

IndicadorArredondamento Bool Não


InserirClassificacao Bool Não
PesoBruto Double Não
PesoLiquido Double Não
PrecoCentralizado Bool Não
QuantidadeCasaDecimal Int Não
QuantidadeCasaDecimalValor Int Não
QuantidadeMultiplaCompra Double Não

LC_ClassificacaoProduto (Não obrigatório)


Descrição Tipo Obrigatório
DescricaoClassificacao Varchar(50) Sim
DescricaoTipoClassificacao Varchar(50) Sim

 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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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)

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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)

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 24 de 34
Manual Operacional
BematechConnector

2.3. Artefatos de Banco de Dados


O BematechConnector utiliza uma estrutura de banco de dados própria com tabelas, procedures e serviço.
Essa estrutura é utilizada para garantir o fluxo da informação, armazenar os dados de Tickets e
documentos, logs e algumas configurações. Segue abaixo a relação desta estrutura:

 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: Tabela utilizada para salvar as informações de configuração dos Tickets,


como a quantidade de documentos por Tickets e se o ticket pode ser enviado parcialmente.

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: Tabela utilizada para salvar as informações que foram


disponibilizada pelo PracticoLive, ela também é utilizada para controlar se as informações já foram
processadas e enviadas para um ticket.

LC_DocumentoDisponibilizado

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 25 de 34
Manual Operacional
BematechConnector

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
IDDocumento uniqueidentifier 16 Sim
Excluido bit 1 Sim
Processado bit 1 Sim

 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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 26 de 34
Manual Operacional
BematechConnector

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
TipoTicket int 4 Sim
Numero varchar 16 Não

 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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 27 de 34
Manual Operacional
BematechConnector

Creation datetime 8 Sim


LastUpdate datetime 8 Sim
Numero varchar 16 Não
Situacao int 4 Sim
DataCriacao datetime 8 Sim
Data varchar 8 Não
Hora varchar 6 Não
CodigoSistemaSatelite varchar 10 Não
Chave uniqueidentifier 16 Sim
TipoTicket int 4 Sim

 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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 28 de 34
Manual Operacional
BematechConnector

SistemaSatelite varchar 10 Sim


Method varchar 256 Sim
Descricao text 16 Sim
IDDominio uniqueidentifier 16 Sim

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.

 usp_PLIVEDisponibilizarDocumentoConnector: Utilizada para copiar os documentos da tabela


“LC_DocumentoDisponibilizado” e adiciona-los na tabela “LC_DocumentoSaida”. Somente as lojas
com o parâmetro 85 igual a 1 serão copiados.
 usp_PLIVEAssociarDocumentosConnector: Esta procedure chama a procedure
“usp_PLIVEDisponibilizarDocumentoConnector” e depois monta os Tickets de acordo com cada tipo
de ticket, incluindo os documentos de saída em seus respectivos Tickets.
o Tipos de Ticket:

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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 29 de 34
Manual Operacional
BematechConnector

22 - PreVendaSaida
23 - RegistroInventarioP7
24 - RegistroMovimentacaoP3

 usp_PLIVEConfirmarTicketConnector: Procedure utiliza para confirmar o ticket, atualizando a


situação do mesmo para:
o 0 - Aberto;
o 1 - Disponível para envio;
o 2 - Envio confirmado;
O Sistema Satélite pode enviar um conjunto de sequencias de documentos que foram recusados
por qualquer motivo, com isso a procedure incluí automaticamente esses documentos no próximo
Ticket e eles serão enviados novamente para o Sistema Satélite.

2.5. Parâmetros Utilizados


O BematechConnector utiliza parâmetros para complementar algumas funcionalidades, segue abaixo a
relação destes parâmetros com as respectivas descrições:

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á:

 Obter uma chave de acesso válida através do método “ObterChaveAcesso”;


 Montar o número do Ticket respeitando a regra de criação descrita no capitulo 2;

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 30 de 34
Manual Operacional
BematechConnector

 Montar o objeto de Ticket que será enviado para o BematechConnector (LC_TicketPreco,


LC_TicketProduto, LC_TicketNotaEspelho ou LC_TicketDocumentoFornecedorPedidoCompra,
LC_TicketCampanhaCodigosPromocional, LC_TicketCliente);
 Montar o objeto de documento do Ticket (LC_Preco, LC_Produto, LC_NotaEspelho ou
LC_DocumentoFornecedorPedidoCompra, LC_CodigosCampanhaPromocional, Objects.Cliente);
 Adicionar à lista de objetos de documento ao objeto de Ticket;
 Chamar o método (ManterNotaEspelho, VincularDocumentoFornecedorPedidoCompra,
ManterPreco ou ManterProduto, ManterCampanha, ManterCliente) passando os respectivos
parâmetros;

Os métodos de entrada de informações para o BematechConnector têm algumas verificações, antes de


salvar as informações eles:

 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);

Após as verificações e nenhum erro acontecer os métodos de Alteração/Inclusão salvam um Ticket de


entrada com essas informações na tabela “LC_TIcketEntrada” e criam uma mensagem no banco
“LiveStage”, essa mensagem será processado e as informações serão Alteradas/Incluidas.

Envia informações

Retorna objeto

BematechConnector Sistema Satélite

3.2. Informações de Saída do BematechConnector


3.2.1. Montando Tickets de saída

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

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

Segue abaixo a relação de classes/métodos onde a chamada para o método


“LC_DocumentoDisponibilizado” foi incluída:

 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

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 32 de 34
Manual Operacional
BematechConnector

Após a inserção das informações disponibilizadas na tabela “LC_DocumentoDisponibilizado” um job no


banco de dados chamado [Associar Documento Connector], que é executado de 5 em 5 minutos, chama a
procedure “usp_PLIVEAssociarDocumentosConnector”, essa procedure monta os Tickets e inclui os
documentos disponibilizados em seus respectivos Tickets, com isso o fluxo das informações do PracticoLive
para os sistemas satélites é garantido.

3.2.2. Chamada dos métodos “Recuperar”


Antes de chamar os métodos de recuperação o sistema satélite deverá montar o objetos “LC_Identificacao”
informando o código do sistema satélite e uma chave de acesso válida (através do método
“ObterChaveAcesso”), esse objeto deverá ser passado como parâmetro para os métodos de recuperação.

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

BematechConnector Sistema Satélite

3.2.3. Lista dos métodos “Recuperar”


 RecuperarCliente
 RecuperarClienteFidelidade
 RecuperarCupomFiscal
 RecuperarCupomFiscalCodigoPromocional
 RecuperarFornecedorFidelidade
Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo
CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 33 de 34
Manual Operacional
BematechConnector

 RecuperarImpressoraFiscal
 RecuperarInventario
 RecuperarMovimentoCaixa
 RecuperarNotaEspelho
 RecuperarNotaFiscal
 RecuperarNotaFiscalEletronica
 RecuperarNotaFiscalEletronica
 RecuperarPreVenda
 RecuperarProdutoFidelidade
 RecuperarReducaoZ
 RecuperarUnidadeMedidaFidelidade

3.3. Log de Erros


Caso aconteça alguma exceção ao montar os objetos de retorno o método “GravarLog” é acionado
gravando a descrição do erro na tabela “LC_LogLiveConnector”, com isso é possível ter um controle de
onde e o que aconteceu.

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.

Avenida Nove de Julho, 2960 - Anhangabaú - Jundiaí - São Paulo


CEP: 13208-056 Fone: 55 11 4583-8800

bematech.com Pagina 34 de 34

Você também pode gostar