Manual de Integração
Pit-Caixa
Versão 3.0
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 2. 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
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 ...
1.1. Usuarios
CAMPO DESCRICAO TIPO TAM OBS
ID Chave do registro Texto 38
CODIGO Código Texto 14
NUMERO Número Número 7
NOME Nome do usuário Texto 60
SENHA Senha Texto 32 MD5 da Senha
TIPO Tipo de usuário Texto 1 V-vendedor, O-operador, S-supervisor ATIVO Indicador de ativo Texto 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
1.2. Clientes
CAMPO DESCRICAO TIPO TAM
ID Chave do registro Texto 38
CODIGO Código Texto 14
NUMERO Número Número 7
DOCUMENTO CPF/CNPJ/Passaporte Texto 20
NOME Nome do cliente Texto 60
ENDERECO_LOGRADOURO Logradouro Texto 60
ENDERECO_NUMERO Número Texto 10
ENDERECO_COMPLEMENTO Complemento Texto 60
ENDERECO_BAIRRO Bairro Texto 60
ENDERECO_MUNICIPIO Nome do Município Texto 60 ENDERECO_MUNICIPIO_IBGE Código do Município Número 7
ENDERECO_UF Sigla da UF Texto 2
ENDERECO_CEP CEP Texto 8
ENDERECO_PAIS Nome do País Texto 60
ENDERECO_PAIS_IBGE Código do País Número 4
FONE Telefone Número 14
EMAIL E-mail Texto 60
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
1.3. Clientes_Convenios
CAMPO DESCRICAO TIPO TAM OBS
ID Chave do registro Texto 38
CLIENTE_ID Chave do cliente Texto 38
CODIGO Código Texto 14
NOME Nome do convênio Texto 60
SENHA Senha Texto 32 MD5 da Senha
LIMITE Valor de limite Moeda 13,2
ACUMULADO Valor acumulado Moeda 13,2
BLOQUEADO Indicador de bloqueio Texto 1 S-sim, N-não
OBSERVACAO Observação Texto 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
1.4. Produtos
CAMPO DESCRICAO TIPO TAM OBS
ID Chave do registro Texto 38
ESPECIE Espécie de produto Texto 1 N-normal,
K-kit, J-confjunto, C-complemento
CODIGO Código Texto 14
NUMERO Número Número 7
BARRAS Código de barras Número 14
DESCRICAO Descrição Texto 100
COMPLEMENTO Complemento Texto 100
NCM NCM Número 8
EXTIPI EXTIPI Número 3
FCI FCI Texto 36
CFOP CFOP Número 4
UNIDADE Sigla da Unidade Texto 6
UNITARIO Valor unitário Moeda 13,2
ESTOQUE Estoque Moeda 12,3
TRIBUTACAO Tributação para ECF Texto 1 I-Isento,
N-Não tributado, F-Subs.tributária, T-Tributado
ORIGEM Código de origem Número 1 0 a 8
ICMS_CSOSN CSOSN de ICMS Número 3
ICMS_CST CST de ICMS Número 2
ICMS_BASE % Base de ICMS Moeda 7,3
ICMS_ALIQUOTA Alíquota de ICMS Moeda 7,3
PIS_CST CST de PIS Número 2
PIS_ALIQUOTA Alíquota de PIS Moeda 7,3
COFINS_CST CST de Cofins Número 2
COFINS_ALIQUOTA Alíquota de Cofins Moeda 7,3 OBSERVACAO_FISCAL Observação Fiscal Texto 400 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
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 DESCRICAO TIPO TAM
ID Chave do registro Texto 38
PRODUTO_ID Chave do produto Texto 38
BARRAS Código de barras Número 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 DESCRICAO TIPO TAM
ID Chave do registro Texto 38
PRODUTO_ID Chave do produto Texto 38
COMPLEMENTO_ID Chave do complemento Texto 38
QUANTIDADE Quantidade Moeda 12,3
UNITARIO Valor unitário Moeda 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
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
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
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
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
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)
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
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
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
[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)
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;
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;
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;
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 Dinheiro em espécie ou moeda
CARTAO Cartão de Crédito, Débito, Voucher, Crediário, Crédito IATA, Private Label
CHEQUE Cheque
VALE Vale Presente, Vale Alimentação (não cartão), Contra-Vale, Crédito
CREDIARIO Duplicata, Carnet, Promissória
CONVENIO Crediário com controle de limite e com senha para cliente TICKET Forma genérica de recebimento de valor
6.3. Tabela de Tipos de Transação de Cartão
0 Nenhum (exibe menu de seleção de tipo de cartão)
1 Cartão Crédito (se TEF ativo, será ajustado para tipo 9, caso contrário, tipo 5)
2 Cartão Débito (se TEF ativo, será ajustado para tipo 10, caso contrário, tipo 6)
3 Cartão Voucher (se TEF ativo, será ajustado para tipo 11, caso contrário, tipo 7)
4 Cartão Crediário (se TEF ativo, será ajustado para tipo 12, caso contrário, tipo 8)
5 POS: Cartão Crédito
6 POS: Cartão Débito
7 POS: Cartão Voucher
8 POS: Cartão Crediário
9 TEF: Cartão Crédito
10 TEF: Cartão Débito
11 TEF: Cartão Voucher
12 TEF: Cartão Crediário
13 TEF: Cartão Crédito IATA
14 TEF: Cartão Private Label
6.4. Tabela de Siglas de Cartão
CCR Cartão de Crédito ou Crédito IATA CDB Cartão de Débito
CCV Cartão Voucher CCD Cartão Crediário CPR Cartão Private Label