Manual de Integração
Pit-Caixa
Versão 3.0
Sumário
1.
2.
Importação ............................................................................................................................ 2
1.1.
Usuarios......................................................................................................................... 3
1.2.
Clientes .......................................................................................................................... 4
1.3.
Clientes_Convenios ....................................................................................................... 5
1.4.
Produtos ........................................................................................................................ 6
1.5.
Produtos_Barras ............................................................................................................ 7
1.6.
Produtos_Complementos ............................................................................................. 7
Exportação............................................................................................................................. 8
2.1.
Venda .......................................................................................................................... 10
2.2.
Recebimento ............................................................................................................... 12
2.3.
Vinculado (exclusivo para ECF).................................................................................... 13
2.4.
Cancelamento ............................................................................................................. 13
2.5.
Atualizacao (exclusivo para NFe)................................................................................. 13
2.6.
Relatorio ...................................................................................................................... 13
2.7.
Suprimento .................................................................................................................. 14
2.8.
Sangria ......................................................................................................................... 14
2.9.
LeituraX (exclusivo para ECF) ...................................................................................... 14
2.10.
ReducaoZ (exclusivo para ECF) ................................................................................ 14
3.
Pré-Venda ............................................................................................................................ 15
4.
Layout de tela ...................................................................................................................... 17
5.
Layout de teclado ................................................................................................................ 19
6.
Tabelas auxiliares ................................................................................................................ 20
6.1.
Tabela de Espécies de Produto ................................................................................... 20
6.2.
Tabela de Finalizadoras ............................................................................................... 20
6.3.
Tabela de Tipos de Transação de Cartão .................................................................... 20
6.4.
Tabela de Siglas de Cartão .......................................................................................... 20
2
1. Importação
O Pit-Caixa importa arquivos no formato “ini”.
Pode-se gerar um único arquivo contendo registros de várias tabelas ou vários arquivos, cada
qual para uma tabela.
O nome do arquivo é de livre escolha, mas sugerimos incluir informações de data e hora de
geração, exemplo: 20130415-150125.ini.
A estrutura do arquivo “ini” deve seguir alguns critérios:

a chave de cada seção deve ser única para o arquivo, podendo ser um número
sequencial ou mesmo um texto aleatório;

deve-se identificar a tabela em cada seção, pois cada seção pode ser de uma tabela
diferente.
Os registros que podem ser importados são:

usuarios;

clientes;

clientes_convenios;

produtos;

produtos_barras;

produtos_complementos.
Exemplo de arquivo único:
[1]
tabela=usuarios
...
[2]
tabela=clientes
...
[3]
tabela=clientes_convenios
...
[4]
tabela=produtos
...
[5]
tabela=produtos_barras
...
[6]
Tabela=produtos_complementos
...
A seguir serão detalhados os campos dos registros:
3
1.1.
Usuarios
CAMPO
ID
CODIGO
NUMERO
NOME
SENHA
TIPO
DESCRICAO
Chave do registro
Código
Número
Nome do usuário
Senha
Tipo de usuário
TIPO
Texto
Texto
Número
Texto
Texto
Texto
ATIVO
Indicador de ativo
Texto
TAM OBS
38
14
7
60
32 MD5 da Senha
1 V-vendedor,
O-operador,
S-supervisor
1 S-sim, N-não
Exemplo de arquivo: usuarios.ini
[1]
tabela=usuarios
id={59F42A5C-27ED-4316-A9DE-FDF5B2A9FA84}
codigo=12345678900001
numero=1
nome=Supervisor Exemplo
senha=96e79218965eb72c92a549dd5a330112
tipo=S
ativo=S
[2]
tabela=usuarios
id={3165DAA5-A20B-4A9F-A203-5EF4DB4139A9}
codigo=12345678900002
numero=2
nome=Operador Exemplo
senha=
tipo=O
ativo=S
[3]
tabela=usuarios
id={AC2A43E0-5B35-4282-B09A-9D67AF27CAF2}
codigo=12345678900004
numero=3
nome=Vendedor Exemplo
senha=
tipo=V
ativo=S
4
1.2.
Clientes
CAMPO
ID
CODIGO
NUMERO
DOCUMENTO
NOME
ENDERECO_LOGRADOURO
ENDERECO_NUMERO
ENDERECO_COMPLEMENTO
ENDERECO_BAIRRO
ENDERECO_MUNICIPIO
ENDERECO_MUNICIPIO_IBGE
ENDERECO_UF
ENDERECO_CEP
ENDERECO_PAIS
ENDERECO_PAIS_IBGE
FONE
EMAIL
DESCRICAO
Chave do registro
Código
Número
CPF/CNPJ/Passaporte
Nome do cliente
Logradouro
Número
Complemento
Bairro
Nome do Município
Código do Município
Sigla da UF
CEP
Nome do País
Código do País
Telefone
E-mail
Exemplo de arquivo: clientes.ini
[1]
tabela=clientes
id={84515ED7-0C64-48AE-8551-72E7DA090B7A}
codigo=12345678900005
numero=1
documento=11122233399
nome=CLIENTE EXEMPLO
endereco_logradouro=RUA A
endereco_numero=S/N
endereco_complemento=FUNDOS
endereco_bairro=CENTRO
endereco_municipio=MARECHAL CANDIDO RONDON
endereco_municipio_ibge=4114609
endereco_uf=PR
endereco_cep=85960000
endereco_pais=BRASIL
endereco_pais_ibge=1058
fone=4532542405
email=cliente@empresa.com.br
TIPO
Texto
Texto
Número
Texto
Texto
Texto
Texto
Texto
Texto
Texto
Número
Texto
Texto
Texto
Número
Número
Texto
TAM
38
14
7
20
60
60
10
60
60
60
7
2
8
60
4
14
60
5
1.3.
Clientes_Convenios
CAMPO
ID
CLIENTE_ID
CODIGO
NOME
SENHA
LIMITE
ACUMULADO
BLOQUEADO
OBSERVACAO
DESCRICAO
Chave do registro
Chave do cliente
Código
Nome do convênio
Senha
Valor de limite
Valor acumulado
Indicador de bloqueio
Observação
TIPO
Texto
Texto
Texto
Texto
Texto
Moeda
Moeda
Texto
Texto
TAM OBS
38
38
14
60
32 MD5 da Senha
13,2
13,2
1 S-sim, N-não
100
Exemplo de arquivo: clientes_convenios.ini
[1]
tabela=clientes_convenios
id={9F454951-CCC2-4DEE-8C28-CF3BC91D87BD}
cliente_id={84515ED7-0C64-48AE-8551-72E7DA090B7A}
codigo=1001
nome=ASSOCIACAO DOS FUNCIONÁRIOS DA EMPRESA A
senha=f1e2b2c9255d552500a833ac828cd635
limite=100,00
acumulado=50,00
bloqueado=N
observacao=
[2]
tabela=clientes_convenios
id={4105436D-3D46-49BD-8AFE-E6E4738466FA}
cliente_id={84515ED7-0C64-48AE-8551-72E7DA090B7A}
codigo=1002
nome=CONVENIO PARTICULAR
senha=e5cdaf84033e295836010d5d49970989
limite=1000,00
acumulado=950,00
bloqueado=S
observacao=ENTRAR EM CONTATO COM FINANCEIRO PARA QUITAR ATRASOS
6
1.4.
Produtos
CAMPO
ID
ESPECIE
DESCRICAO
Chave do registro
Espécie de produto
TIPO
Texto
Texto
CODIGO
NUMERO
BARRAS
DESCRICAO
COMPLEMENTO
NCM
EXTIPI
FCI
CFOP
UNIDADE
UNITARIO
ESTOQUE
TRIBUTACAO
Código
Número
Código de barras
Descrição
Complemento
NCM
EXTIPI
FCI
CFOP
Sigla da Unidade
Valor unitário
Estoque
Tributação para ECF
Texto
Número
Número
Texto
Texto
Número
Número
Texto
Número
Texto
Moeda
Moeda
Texto
ORIGEM
ICMS_CSOSN
ICMS_CST
ICMS_BASE
ICMS_ALIQUOTA
PIS_CST
PIS_ALIQUOTA
COFINS_CST
COFINS_ALIQUOTA
OBSERVACAO_FISCAL
Código de origem
CSOSN de ICMS
CST de ICMS
% Base de ICMS
Alíquota de ICMS
CST de PIS
Alíquota de PIS
CST de Cofins
Alíquota de Cofins
Observação Fiscal
Número
Número
Número
Moeda
Moeda
Número
Moeda
Número
Moeda
Texto
Exemplo de arquivo: produtos.ini
[1]
tabela=produtos
id={0649CD1D-A81E-4EE4-A88B-AE3D07B317F6}
especie=N
codigo=12345678900001
numero=1
barras=12345678900001
descricao=PRODUTO A
complemento=Garantia de 90 dias
ncm=12345678
extipi=
fci=B4250E9D-FDC6-4DC3-A8B3-1E0F0D4853C5
cfop=5102
unidade=UN
unitario=149,99
estoque=50,000
TAM OBS
38
1 N-normal,
K-kit,
J-confjunto,
C-complemento
14
7
14
100
100
8
3
36
4
6
13,2
12,3
1 I-Isento,
N-Não tributado,
F-Subs.tributária,
T-Tributado
1 0a8
3
2
7,3
7,3
2
7,3
2
7,3
400
7
tributacao=T
origem=0
icms_csosn=101
icms_cst=00
icms_base=100,000
icms_aliquota=7,000
pis_cst=49
pis_aliquota=1,650
cofins_cst=49
cofins_aliquota=7,600
observacao_fiscal= Diferimento cfe. RICMS, Livro I, art.53, inciso I
1.5.
Produtos_Barras
CAMPO
ID
PRODUTO_ID
BARRAS
DESCRICAO
Chave do registro
Chave do produto
Código de barras
TIPO
Texto
Texto
Número
TAM
38
38
18
Exemplo de arquivo: produtos_barras.ini
[1]
tabela=produtos_barras
id={B08C96CA-FDD5-47B5-ACF5-DA7B2471808B}
produto_id={0649CD1D-A81E-4EE4-A88B-AE3D07B317F6}
barras=9876543210111
[2]
tabela=produtos_barras
id={7B774A5D-59A6-42FA-AB53-06EDA298AD6D}
produto_id={0649CD1D-A81E-4EE4-A88B-AE3D07B317F6}
barras=98765432102220001
1.6.
Produtos_Complementos
CAMPO
ID
PRODUTO_ID
COMPLEMENTO_ID
QUANTIDADE
UNITARIO
DESCRICAO
Chave do registro
Chave do produto
Chave do complemento
Quantidade
Valor unitário
TIPO
Texto
Texto
Texto
Moeda
Moeda
TAM
38
38
38
12,3
13,2
Exemplo de arquivo: produtos_complementos.ini
[1]
tabela=produtos_complementos
id={7D844626-DB77-CAEA-5B4A-A4AB87A89800}
produto_id={0649CD1D-A81E-4EE4-A88B-AE3D07B317F6}
complemento_id={02FA35C9-0DB4-D3D0-1F36-E820C53BB7E4}
quantidade=2
unitario=1,50
8
2. Exportação
O Pit-Caixa gera a cada registro de operação um arquivo identificando a operação ocorrida. Estes
registros podem ser:

Venda: Cupom Fiscal emitido em ECF ou Nota Fiscal de Consumidor Eletrônica;

Recebimento: Cupom Não Fiscal emitido em ECF ou Recebimento de valores;

Vinculado: Cupom Vinculado a um Cupom Fiscal ou Cupom Não Fiscal, emitido em ECF
contendo os Comprovantes TEF;

Cancelamento: Cancelamento de Venda ou Recebimento;

Atualizacao: Atualização de dados de Nota Fiscal de Consumidor Eletrônica no
tratamento de pendências nos casos de contingência;

Relatorio: Relatório Gerencial;

Suprimento: Entrada de Recursos;

Sangria: Saída de Recursos;

LeituraX: Relatório de Leitura X emitido em ECF;

ReducaoZ: Relatório de Redução Z emitido em ECF;
Os arquivos são exportados no formato “ini”, porém, com extensão “pdv”.
O nome dos arquivos gerados segue a seguinte regra:
AA-BBBBBB-CC-DDDDDD-EEEEEE-FFFFF.pdv, onde:

AA se refere ao número do PDV, de 01 a 99;

BBBBBB se refere a data da sessão no formado AAMMDD;

CC se refere ao número da sessão na data, de 01 a 99;

DDDDDD se refere ao número sequencial do registro, de 000001 a 999999;

EEEEEE se refere a hora da emissão no formato HHNNSS;

FFFFF se refere ao tipo de registro, podendo ser: Venda; Recebimento; Vinculado;
Cancelamento; Atualizacao; Relatorio; Suprimento; Sangria; LeituraX; ReducaoZ;
Todos os arquivos possuem uma seção de cabeçalho identificado pela seção [Operacao]:
[Operacao]
Tipo= tipo de registro (Venda, Recebimento, etc...)
Cancelado= flag de registro cancelado: 0-Não, 1-Sim
Pdv= número do PDV, de 1 a 99
Data= data da sessão
Sessao= número da sessão na data, de 1 a 99
Sequencial= número sequencial do registro, de 000001 a 999999
Emissao= data e hora de emissão do registro
OperadorId= identificação do usuário operador
SupervisorId= identificação do usuário supervisor
9
Nos tipos de registro Vinculado, Cancelamento e Atualizacao, existirá uma seção adicional,
correspondente a operação de origem, identificado pela seção [Origem]:
[Origem]
Tipo= tipo de registro (Venda, Recebimento, etc...)
Cancelado= flag de registro cancelado: 0-Não, 1-Sim
Pdv= número do PDV, de 1 a 99
Data= data da sessão
Sessao= número da sessão na data, de 1 a 99
Sequencial= número sequencial do registro, de 000001 a 999999
Emissao= data e hora de emissão do registro
OperadorId= identificação do usuário operador
SupervisorId= identificação do usuário supervisor
Conforme o tipo de registro definido, existirá uma seção correspondente, por exemplo, se o tipo
de registro for “Venda”, existirá uma seção [Venda], bem como outras seções adicionais.
Se o modo de operação for ECF, na seção de tipo de registro haverá informações do ECF:
Ecf-Serie= número de série do ECF
Ecf-SerieMFD= número de série da MFD
Ecf-Numero= número do ECF
Ecf-CRZ= contador de redução z
Ecf-CRO= contador de reinício de operação
Ecf-COO= contador de ordem de operação
Ecf-CCF= contador de cupom fiscal
Ecf-GNF= contador de operação não fiscal
Ecf-GRG= contador de relatório gerencial
Ecf-CDC= contador de cupom vinculado
Ecf-Movimento= data do movimento
Ecf-Emissao= data e hora da emissão no ECF
Se o modo de operação for NFE, na seção Venda haverá informações da NFe:
Nfe-Serie= série da nfe
Nfe-Numero= número da nfe
Nfe-Modelo= modelo da nfe
Nfe-Emissao= date e hora da emissão da nfe
Nfe-MsgErro= mensagem de erro na nfe
Nfe-Chave= chave da nfe
Nfe-XML= xml da nfe
Nfe-XML-Cancelamento= xml de cancelamento da nfe
Nfe-XML-Inutilizacao= xml de inutilização da nfe
Nfe-Protocolo-Autorizacao= protocolo de autorização da nfe
Nfe-Protocolo-Denegacao= protocolo de denegação da nfe
Nfe-Protocolo-Cancelamento= protocolo de cancelamento da nfe
Nfe-Protocolo-Inutilizacao= protocolo de inutilização da nfe
Nfe-Autorizada= flag de nfe autorizada: 0-Não, 1-Sim
Nfe-Denegada= flag de nfe denegada: 0-Não, 1-Sim
Nfe-Cancelada= flag de nfe cancelada: 0-Não, 1-Sim
Nfe-Inutilizada= flag de nfe inutilizada: 0-Não, 1-Sim
Nfe-Contingencia= flag de nfe em contingência: 0-Não, 1-Sim
10
Nos tipos de registro Venda, Recebimento, Relatorio, Suprimento e Sangria existirá uma seção
[Espelho]. Nesta seção será apresentado uma simulação do conteúdo exibido na tela ou
impresso, para fins de auditoria. Exemplo:
[Espelho]
Espelho=
|-------------- ABERTURA DE SESSAO ------------|Pdv.....: 1
|Data....: 03/09/2015
|Sessao..: 3
|Operador: 1000-PRIORI
|----------------------------------------------|01-150903-03-000260-170436 03/09/2015 17:04:36
|Priori Sistemas www.priori.com.br (45)3254-2405
A seguir serão detalhadas as seções de tipo de registro:
2.1.
Venda
[Venda]
{Aqui informações do ECF caso seja operação com ECF}
{Aqui informações da NFE caso seja operação com NFE}
ImportacaoId= identificação de importação
VendedorId= identificação do usuário vendedor (opcional)
ClienteId= identificação do cliente
Consumidor-Documento= cpf ou cnpj
Consumidor-Nome= nome
Consumidor-Endereco-Logradouro= logradouro
Consumidor-Endereco-Numero= número
Consumidor-Endereco-Complemento= complemento
Consumidor-Endereco-Bairro= bairro
Consumidor-Endereco-Municipio= nome do município
Consumidor-Endereco-Municipio-IBGE= código IBGE do município
Consumidor-Endereco-UF= UF
Consumidor-Endereco-CEP= CEP
Consumidor-Endereco-Pais= nome do país
Consumidor-Endereco-Pais-IBGE= código IBGE do país
Consumidor-Fone= telefone
Consumidor-Email= email
SubTotal= valor total de produtos
AcrescimoDesconto= valor de acréscimo/desconto geral
Total= valor total (SubTotal + AcrescimoDesconto)
Saque= valor de saque em cartão de débito (opcional)
Saldo= se negativo indica troco em dinheiro ou contravale
Contravale= flag de impressão de contravale: 0-Não, 1-Sim
Icms-Base= valor total de base de ICMS
Icms-Valor= valor total de ICMS
Pis-Base= valor total de base de PIS
Pis-Valor= valor total de PIS
Cofins-Base= valor total de base de Cofins
Cofins-Valor= valor total de Cofins
11
Imposto-Federal= valor total de imposto federal
Imposto-Estadual= valor total de imposto estadual
Observacao= observação no Cupom Fiscal ou Nota Eletrônica
Produtos= quantidade de produtos
Finalizadoras= quantidade de finalizadoras
[Produto NNN] (onde NNN vai de 001 a 999)
Cancelado= flag de cancelamento do produto: 0-Não, 1-Sim
SupervisorId= identificação do usuário supervisor
ImportacaoId= identificação de importação do produto
ProdutoId= identificação do produto
Especie= identificação da espécie de produto
Codigo= código impresso no ECF ou registrado na NFe
Barras= código de barras
Descricao= texto de descrição
Complemento= texto de complemento
NCM= nomenclatura comum do Mercosul
EXTIPI= EX da TIPI
FCI= ficha de conteúdo de importação
CFOP= código fiscal de operação
Origem= código de origem do produto
Unidade= sigla da unidade
Quantidade= quantidade vendida
Unitario= valor unitário vendido
Total= valor total (Quantidade x Unitario)
AcrescimoDesconto= valor de acréscimo/desconto no produto
AcrescimoDescontoGeral= valor de acréscimo/desconto geral rateado
TotalLiquido= valor total líquido (Total + Ac.Desc. + Ac.Desc.Geral)
Ecf-Totalizador= se for operação com ECF, código do totalizador
Ecf-Tributacao= se for operação com ECF, código de tributação
Ecf-Aliquota= se for operação com ECF, alíquota original
Ecf-Base= se for operação com ECF, percentual de base
Icms-CST= preenchido se for CRT=3
Icms-CSOSN= preenchido se for CRT=1
Icms-PercBase= percentual de base de ICMS
Icms-Base= valor de base de ICMS
Icms-Aliquota= alíquota de ICMS
Icms-Valor= valor de ICMS
Pis-CST= CST de PIS
Pis-Base= valor de base de PIS
Pis-Aliquota= alíquota de PIS
Pis-Valor= valor de PIS
Cofins-CST= CST de Cofins
Cofins-Base= valor de base de Cofins
Cofins-Aliquota= alíquota de Cofins
Cofins-Valor= valor de Cofins
Imposto-PercFederal= percentual de imposto federal
Imposto-Federal= valor de imposto federal
Imposto-PercEstadual= percentual de imposto estadual
Imposto-Estadual= valor de imposto estadual
ObservacaoFiscal=
[Finalizadora NNN] (onde NNN vai de 001 a 999)
ImportacaoId= identificação de importação da finalizadora
Nome= nome da finalizadora
Valor= valor da finalizadora
12
Cartao-Tipo= tipo da transação do cartão
Cartao-TR= sigla do tipo de cartão
Cartao-CT= código da transação
Cartao-NSU= número sequencial único da transação
Cartao-Parcelas= quantidade de parcelas da transação
Cartao-Taxa= valor de taxa de serviço ou taxa de embarque
Cartao-Saque= valor de saque (opcional com Cartão Débito)
Cartao-Desconto= valor de desconto retornado pela autorizadora
Cartao-Rede= número da rede autorizadora do cartão
Cartao-Bandeira= número da bandeira do cartão)
Cheque-Documento= documento (cfp ou cnpj) do emitente do cheque
Cheque-CMC7= código CMC7 do cheque
Cheque-Camara= número da câmara de compensação do cheque
Cheque-Banco= número do banco do cheque
Cheque-Agencia= número da agência do cheque
Cheque-Conta= identificação da conta do cheque
Cheque-Numero= número do cheque
Cheque-Deposito= data para depósito do cheque
Convenio-Id= identificação do convênio
Convenio-Codigo= código do convênio
Convenio-Nome= nome do convênio
Convenio-Limite= valor de limite do convênio
Convenio-Acumulado= valor acumulado do convênio
Convenio-Bloqueado= flag de bloqueio do convênio: 0-Não, 1-Sim
Convenio-Observação= texto de observação do convênio
Convenio-SupervisorId= identificação do usuário supervisor
Crediario-Tipo= texto do tipo de crediário (cadastrado no CFG)
Crediario-Parcelas= quantidade de parcelas do crediário
Crediario-Vencimento= data de vencimento do primeiro crediário
2.2.
Recebimento
[Recebimento]
{Aqui informações do ECF caso seja operação com ECF}
ImportacaoId= identificação de importação
VendedorId= identificação do usuário vendedor (opcional)
ClienteId= identificação do cliente
Consumidor-Documento= cpf ou cnpj
Consumidor-Nome= nome
Consumidor-Endereco-Logradouro= logradouro
Consumidor-Endereco-Numero= número
Consumidor-Endereco-Complemento= complemento
Consumidor-Endereco-Bairro= bairro
Consumidor-Endereco-Municipio= nome do município
Consumidor-Endereco-Municipio-IBGE= código IBGE do município
Consumidor-Endereco-UF= UF
Consumidor-Endereco-CEP= CEP
Consumidor-Endereco-Pais= nome do país
Consumidor-Endereco-Pais-IBGE= código IBGE do país
Consumidor-Fone= telefone
Consumidor-Email= email
SubTotal= valor total de recebimentos
AcrescimoDesconto= valor de acréscimo/desconto geral
Total= valor total (SubTotal + AcrescimoDesconto)
13
Saque= valor de saque em cartão de débito (opcional)
Saldo= se negativo indica troco em dinheiro ou contravale
Contravale= flag de impressão de contravale: 0-Não, 1-Sim
Observacao=
Recebimentos= quantidade de recebimentos
Finalizadoras= quantidade de finalizadoras
[Recebimento NNN] (onde NNN vai de 001 a 999)
ImportacaoId= identificação de importação do recebimento
Nome= nome do recebimento
Valor= valor do recebimento
AcrescimoDescontoGeral= valor de acréscimo/desconto geral rateado
ValorLiquido= valor líquido (Valor + AcrescimoDescontoGeral)
[Finalizadora NNN] (vide finalizadora em 2.1 Venda)
2.3.
Vinculado (exclusivo para ECF)
[Vinculado]
{Aqui informações do ECF}
[Origem]
{Aqui informações da operação de origem}
2.4.
Cancelamento
[Cancelamento]
{Aqui informações do ECF caso seja operação com ECF}
[Origem]
{Aqui informações da operação de origem}
2.5.
Atualizacao (exclusivo para NFe)
[Atualizacao]
{Nenhuma informação, apenas para manter compatibilidade}
[Origem]
{Aqui informações da operação de origem}
2.6.
Relatorio
[Relatorio]
{Aqui informações do ECF caso seja operação com ECF}
Relatorio= Abertura de Sessao, Relatorio de Sessao, Fechamento de
Sessao, Contravale, Promissoria ou Comprovante.
14
2.7.
Suprimento
[Suprimento]
{Aqui informações do ECF caso seja operação com ECF}
Valor= valor do suprimento
Texto= texto do suprimento
2.8.
Sangria
[Sangria]
{Aqui informações do ECF caso seja operação com ECF}
Valor= valor da sangria
Texto= texto da sangria
2.9.
LeituraX (exclusivo para ECF)
[LeituraX]
{Aqui informações do ECF}
2.10. ReducaoZ (exclusivo para ECF)
[ReducaoZ]
{Aqui informações do ECF}
COOInicial= número do COO inicial
VendaBruta= valor da venda bruta
GrandeTotal= valor do grande total
[Totalizadores]
F1= valor de ST em ICMS
I1= valor de isento em ICMS
N1= valor de não tributado em ICMS
DT= valor de desconto em ICMS
AT= valor de acréscimo em ICMS
Can-T= valor de cancelamento em ICMS
nnTxxxx= valor de ICMS na alíquota xxxx, onde nn é o índice
OPNF= valor em operação não fiscal
DO= valor de desconto em operação não fiscal
AO= valor de acréscimo em operação não fiscal
Can-O= valor de cancelamento em operação não fiscal
15
3. Pré-Venda
O Pit-Caixa importa pré-venda no formato “ini’, porém, com extensão “prv”.
O nome do arquivo deve ser gerado com o número da identificação e com extensão “prv”,
Exemplo: “123.prv” para a identificação 123.
Após a importação, o arquivo de pré-venda será excluído do diretório.
O arquivo de pré-venda deve possuir uma seção de cabeçalho identificada pela seção
[Operacao]:
[Operacao]
Tipo= tipo de registro: Venda ou Recebimento
Alteracao= flag para permitir alteração: 0-Não, 1-Sim (caso não
seja permitido alteração, a Venda ou Recebimento será totalizada,
não permitindo acrescentar ou remover produtos ou recebimentos)
Observacao= texto de observação a ser exibido na tela de
confirmação de importação (opcional)
RelatorioAnexo= texto a ser impresso em relatório gerencial após
a impressão da Venda ou Recebimento (opcional) (com operação ECF
inviabiliza o cancelamento do cupom)
Conforme o tipo de registro informado, deve-se criar uma seção correspondente, por exemplo,
se o tipo de registro for “Venda”, deve-se criar uma seção [Venda]:
[FFFFF] (onde FFFFF é Venda ou Recebimento)
ImportacaoId= identificação de importação (opcional)
VendedorId= identificação do usuário vendedor (opcional)
ClienteId= identificação do cliente (opcional)
Consumidor-Documento= cpf ou cnpj (opcional)
Consumidor-Nome= nome (opcional)
Consumidor-Email= email (opcional)
SubTotal= valor total de produtos ou recebimentos
AcrescimoDesconto= valor de acréscimo/desconto geral
Produtos= quantidade de produtos, quando for [Venda]
Recebimentos= quantidade de recebimentos, quando for [Recebimento]
Finalizadoras= quantidade de finalizadoras (opcional)
[Produto NNN] (onde NNN vai de 001 a 999, quando for [Venda])
SupervisorId= identificação do usuário supervisor (opcional)
ImportacaoId= identificação de importação do produto (opcional)
ProdutoId= identificação do produto
Complemento= texto de complemento (opcional)
Quantidade= quantidade vendida
Unitario= valor unitário vendido (opcional)
AcrescimoDesconto= valor de acréscimo/desconto (opcional)
[Recebimento NNN] (onde NNN vai de 001 a 999, quando for [Recebimento])
ImportacaoId= identificação de importação do recebimento (opcional)
Nome= nome do recebimento
Valor= valor do recebimento
16
[Finalizadora NNN] (onde NNN vai de 001 a 999) (opcional)
ImportacaoId= identificação de importação da finalizadora (opcional)
Nome= nome da finalizadora
Valor= valor da finalizadora
Cartao-Tipo= tipo da transação do cartão (opcional)
Cartao-Parcelas= quantidade de parcelas da transação (opcional)
Cartao-Rede= número da rede autorizadora do cartão (opcional)
Cartao-Bandeira= número da bandeira do cartão (opcional)
Cheque-Documento= documento (cfp/cnpj) do emitente (opcional)
Cheque-CMC7= código CMC7 (opcional)
Cheque-Camara= número da câmara de compensação (opcional)
Cheque-Banco= número do banco (opcional)
Cheque-Agencia= número da agência (opcional)
Cheque-Conta= identificação da conta (opcional)
Cheque-Numero= número do cheque (opcional)
Cheque-Deposito= data para depósito (opcional)
Convenio-Codigo= código do convênio (opcional)
Crediario-Tipo= texto do tipo de crediário (opcional)
Crediario-Parcelas= quantidade de parcelas (opcional)
Crediario-Vencimento= data de vencimento (opcional)
17
4. Layout de tela
O Pit-Caixa permite personalizar a tela principal por meio de um arquivo no formato “ini”. Junto
ao instalador é fornecido o arquivo “tela_priori_800x600.ini” que pode ser utilizado como base
para personalização. É essencial que o nome do arquivo comece com o texto “tela” para que o
Pit-Caixa Configurador possa carregar automaticamente o arquivo na lista de opções de layout
de tela.
Os elementos existentes no layout são:




































Tela: tamanho da tela em pixels em largura (Width) e altura (Height);
Imagem: imagem de fundo (File);
Menu: menu do programa;
Mensagem: texto com mensagens do programa;
Digitacao: texto com o conteúdo digitado pelo usuário;
Aguarde: texto com mensagem de aguarde;
Bobina: bobina exibindo as operações;
gProdutos: grid de localização de produtos;
gClientes: grid de localização de clientes;
gNotas: grid de localização de notas;
tProdutoDescricao: título da descrição do produto;
vProdutoDescricao: valor da descrição do produto;
tProdutoCodigo: título do código do produto;
vProdutoCodigo: valor do código do produto;
tProdutoQuantidade: título da quantidade do produto;
vProdutoQuantidade: valor da quantidade do produto;
tProdutoUnitario: título do unitário do produto;
vProdutoUnitario: valor do unitário do produto;
tProdutoTotal: título do total do produto;
vProdutoTotal: valor do total do produto;
tCupomItens: título da quantidade de itens do cupom;
vCupomItens: valor da quantidade de itens do cupom;
tCupomSubTotal: título do subtotal do cupom;
vCupomSubTotal: valor do subtotal do cupom;
tCupomAcrescimoDesconto: título do acréscimo/desconto do cupom;
vCupomAcrescimoDesconto: valor do acréscimo/desconto do cupom;
tCupomTotal: título do total do cupom;
vCupomTotal: valor do total do cupom;
tQuantidade: título da quantidade a ser vendida;
vQuantidade: valor da quantidade a ser vendida;
tPdv: título do número do pdv;
vPdv: valor do número do pdv (00);
tSessao: título do número da sessão;
vSessao: valor do número da sessão (00);
tOperador: título do operador;
vOperador: valor do operador (0-Nome);
18








tPendentes: título de operações pendentes;
vPendentes: valor de operações pendentes (00);
tStatus: título do status;
vStatus: valor do stasus (NORMAL ou CONTINGENCIA);
tVersao: título da versão do programa;
vVersao: valor da versão do programa (00.00);
tDataHora: título da data e hora;
vDataHora: valor da data e hora (00/00/0000 00:00);
19
5. Layout de teclado
O Pit-Caixa permite personalizar o layout do teclado por meio de um arquivo no formato “ini”.
Junto ao instalador é fornecido o arquivo “teclado_priori.ini” que pode ser utilizado como base
para personalização. O arquivo possui uma única seção [TEC]. Cada tecla possui um número que
pode ser ligado a um comando do programa Pit-Caixa. Se o teclado a ser utilizado for do tipo
reduzido (especifico para ponto de venda, exemplo: 44 teclas), deve-se alterar a flag “Texto=1”
para “Texto=0”, de modo ao programa saber que não será permitido digitação de textos no
terminal. Os comandos disponíveis no programa Pit-Caixa são:



































101000: Menu Supervisor;
102000: Menu Operador;
103000: Menu NFe;
104000: Menu TEF;
105000: Menu Recebimento;
106000: Entrar/Sair Modo Consulta
107000: Entrar/Sair Modo Detalhe;
108000: Identificar Cliente/Consumidor;
109000: Ajustar Quantidade/Ler balança pesadora;
110000: Subtotalizar;
111000: Cancelar Item;
112000: Cancelar Cupom;
113000: Importar Pré-Venda;
120000: Finalizadora (Abre Menu Finalizadoras);
121000: Finalizadora Dinheiro;
122000: Finalizadora Cartão (Abre Menu Cartões);
122010: Finalizadora Cartão Crédito;
122020: Finalizadora Cartão Débito;
122030: Finalizadora Cartão Voucher;
122040: Finalizadora Cartão Crediário;
122110: Finalizadora Cartão Crédito POS;
122120: Finalizadora Cartão Débito POS;
122130: Finalizadora Cartão Voucher POS;
122140: Finalizadora Cartão Crediário POS;
122210: Finalizadora Cartão Crédito TEF;
122220: Finalizadora Cartão Débito TEF;
122230: Finalizadora Cartão Voucher TEF;
122240: Finalizadora Cartão Crediário TEF;
122250: Finalizadora Cartão Crédito IATA TEF;
122260: Finalizadora Cartão Private Label TEF;
123000: Finalizadora Cheque;
124000: Finalizadora Vale;
125000: Finalizadora Crediário
126000: Finalizadora Convênio;
127000: Finalizadora Ticket;
20
6. Tabelas auxiliares
6.1.
Tabela de Espécies de Produto
N Produto normal, pesquisável, impresso no ECF
J Produto principal de conjunto, pesquisável, impresso no ECF e logo após os produtos
complementares/normais associados serão impressos
K Produto agrupador de kit, pesquisável, não impresso no ECF mas os produtos
complementares/normais associados serão impressos
C Produto complementar, produto não pesquisável, impresso no ECF
6.2.
Tabela de Finalizadoras
DINHEIRO
CARTAO
CHEQUE
VALE
CREDIARIO
CONVENIO
TICKET
6.3.
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Dinheiro em espécie ou moeda
Cartão de Crédito, Débito, Voucher, Crediário, Crédito IATA, Private Label
Cheque
Vale Presente, Vale Alimentação (não cartão), Contra-Vale, Crédito
Duplicata, Carnet, Promissória
Crediário com controle de limite e com senha para cliente
Forma genérica de recebimento de valor
Tabela de Tipos de Transação de Cartão
Nenhum (exibe menu de seleção de tipo de cartão)
Cartão Crédito (se TEF ativo, será ajustado para tipo 9, caso contrário, tipo 5)
Cartão Débito (se TEF ativo, será ajustado para tipo 10, caso contrário, tipo 6)
Cartão Voucher (se TEF ativo, será ajustado para tipo 11, caso contrário, tipo 7)
Cartão Crediário (se TEF ativo, será ajustado para tipo 12, caso contrário, tipo 8)
POS: Cartão Crédito
POS: Cartão Débito
POS: Cartão Voucher
POS: Cartão Crediário
TEF: Cartão Crédito
TEF: Cartão Débito
TEF: Cartão Voucher
TEF: Cartão Crediário
TEF: Cartão Crédito IATA
TEF: Cartão Private Label
6.4.
CCR
CDB
CCV
CCD
CPR
Tabela de Siglas de Cartão
Cartão de Crédito ou Crédito IATA
Cartão de Débito
Cartão Voucher
Cartão Crediário
Cartão Private Label
Download

Manual de Integração