Manual de Integração. Pit-Caixa. Versão 1.0

Manual de Integração Pit-Caixa Versão 1.0

Sumário Importação... 2 Usuários... 3 Clientes... 4 Convênios... 6 Convênios de Clientes... 7 Produtos... 8 Exportação... 10 Seção de cabeçalho... 11 Seção de redução Z... 11 Seção de totalizador... 11 Seção para os demais documentos... 11 Seção de produto... 12 Seção de recebimento... 13 Seção de pagamento... 13 Tabelas auxiliares... 14 Tabela de Tipos de Produto... 14 Tabela de Origens... 14 Tabela de Tributações... 14 Tabela CSOSN... 14 Tabela CST ICMS... 15 Tabela CST ISSQN... 15 Tabela CST PIS/COFINS... 15 Tabela de Totalizadores... 16 Tabela de Tipos de Transação de Cartão... 16

2 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 pelo PIT-CAIXA são: Usuários; Clientes; Convênios; Convênios Clientes; Produtos. Exemplo de arquivo único: [1] tabela=usuarios... [2] tabela=usuarios... [3] tabela=convenios... [4] tabela=clientes... [5] tabela=convenios_clientes... [6] tabela=produtos... [7] tabela=produtos... A seguir serão detalhados os campos dos registros:

3 Usuários CAMPO DESCRICAO TIPO TAM OBS ID Chave do registro texto 38 CODIGO Código texto 14 Informar números NUMERO Número número 7 NOME Nome texto 60 SENHA Senha texto 30 Informar números TIPO Tipo de usuário texto 1 V-vendedor, O-operador, S-supervisor ATIVO Usuário 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=123 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 Clientes CAMPO DESCRICAO TIPO TAM OBS ID Chave do registro texto 38 CODIGO Código texto 14 Informar números TIPO Tipo de cliente texto 1 F-física, J-jurídica CPF CPF texto 11 Informar números CNPJ CNPJ texto 14 Informar números IE Inscrição Estadual texto 14 IM Inscrição Municipal texto 14 NOME Nome/Razão Social texto 100 FANTASIA Nome/Fantasia texto 60 ENDERECO Endereço texto 60 NUMERO Número texto 10 COMPLEMENTO Complemento texto 60 BAIRRO Bairro texto 60 MUNICIPIO Nome do Município texto 60 MUNICIPIO_IBGE Código do Município número 7 UF Sigla UF texto 2 CEP Cep texto 8 Informar números PAIS Nome do País texto 60 PAIS_IBGE Código do País número 4 FONE Telefone texto 14 Informar números EMAIL E-mail texto 60

5 Exemplo de arquivo: clientes.ini [1] tabela=clientes id={84515ed7-0c64-48ae-8551-72e7da090b7a} codigo=12345678900005 tipo=f cpf=11122233399 cnpj= ie= im= nome=cliente PF EXEMPLO fantasia=cliente PF EXEMPLO endereco=rua A numero=s/n complemento=fundos bairro=centro municipio=marechal CANDIDO RONDON municipio_ibge=4114609 uf=pr cep=85960000 pais=brasil pais_ibge=1058 fone=4532542405 email=cliente@empresa.com.br [2] tabela=clientes id={1404fc4f-ba56-4bc5-9ed7-7cbf1077883e} codigo=12345678900006 tipo=j cpf= cnpj=11222333000199 ie=12345678901234 im=12345678901234 nome=cliente PJ EXEMPLO fantasia=cliente PJ EXEMPLO endereco=rua B numero=1000 complemento=sala 1 bairro=centro municipio=marechal CANDIDO RONDON municipio_ibge=4114609 uf=pr cep=85960000 pais=brasil pais_ibge=1058 fone=4532542405 email=empresa@empresa.com.br

6 Convênios CAMPO DESCRICAO TIPO TAM OBS ID Chave do registro texto 38 NOME Nome texto 30 Exemplo de arquivo: convenios.ini [1] tabela=convenios id={2ba0bb8a-8eb7-4792-b017-6bb578915c26} nome=particular [2] tabela=convenios id={c865bd16-2832-4a4a-a97d-96551aeeddb9} nome=empresa X

7 Convênios de Clientes CAMPO DESCRICAO TIPO TAM OBS ID Chave do registro texto 38 CONVENIO_ID Chave do convênio texto 38 CLIENTE_ID Chave do cliente texto 38 CODIGO Código texto 14 Informar números SENHA Senha texto 30 Informar números LIMITE Valor de limite moeda 13,2 ACUMULADO Valor acumulado moeda 13,2 BLOQUEADO Convênio bloqueado texto 1 S-sim, N-não Exemplo de arquivo: convenios_clientes.ini [1] tabela=convenios_clientes id={9f454951-ccc2-4dee-8c28-cf3bc91d87bd} convenio_id={2ba0bb8a-8eb7-4792-b017-6bb578915c26} cliente_id={84515ed7-0c64-48ae-8551-72e7da090b7a} codigo=1001 senha=123 limite=100,00 acumulado=50,00 bloqueado=n [2] tabela=convenios_clientes id={4105436d-3d46-49bd-8afe-e6e4738466fa} convenio_id={c865bd16-2832-4a4a-a97d-96551aeeddb9} cliente_id={84515ed7-0c64-48ae-8551-72e7da090b7a} codigo=1002 senha=321 limite=1000,00 acumulado=350,00 bloqueado=n [3] tabela=convenios_clientes id={53e3efb1-e961-46cd-b3e5-95d300264497} convenio_id={c865bd16-2832-4a4a-a97d-96551aeeddb9} cliente_id={1404fc4f-ba56-4bc5-9ed7-7cbf1077883e} codigo=2001 senha=123456 limite=500,00 acumulado=500,00 bloqueado=n

8 Produtos CAMPO DESCRICAO TIPO TAM OBS ID Chave do registro texto 38 CODIGO Código texto 14 Informar números NUMERO Número número 7 Código interno/balança BARRAS Código de barras texto 14 Informar números DESCRICAO Descrição texto 100 UNIDADE Sigla da Unidade texto 6 TIPO Tipo de produto número 2 Tabela de Tipos de Produto NCM Código NCM texto 8 Informar números TIPI Código TIPI texto 3 Informar números GENERO Código do gênero texto 2 Informar números SERVICO Código lista serviço texto 7 Informar números IAT Indic. Arred. Trunc. texto 1 A-arredonda, T-trunca IPPT Indic. Produção texto 1 P-própria, T-terceiro ORIGEM Código de origem número 1 Tabela de Origens TRIBUTACAO Tributação texto 1 Tabela de Tributações ICMS_CSOSN CSOSN de ICMS número 3 Tabela CSOSN ICMS_CST CST de ICMS número 2 Tabela CST ICMS ICMS_BASE % Base de ICMS moeda 7,3 ICMS_ALIQUOTA Alíquota de ICMS moeda 7,3 ISSQN_CST CST de ISSQN texto 1 Tabela CST ISSQN ISSQN_BASE % Base de ISSQN moeda 7,3 ISSQN_ALIQUOTA Alíquota de ISSQN moeda 7,3 PIS_CST CST de PIS número 2 Tabela CST PIS/COFINS PIS_BASE % Base de PIS moeda 7,3 PIS_ALIQUOTA Alíquota de PIS moeda 7,3 COFINS_CST CST de Cofins número 2 Tabela CST PIS/COFINS COFINS_BASE % Base de Cofins moeda 7,3 COFINS_ALIQUOTA Alíquota de Cofins moeda 7,3 OBSERVAO_FISCAL Observação Fiscal texto - UNITARIO Valor unitário moeda 13,2 ESTOQUE Quantidade estoque moeda 9,3 Exemplo de arquivo: produtos.ini [1] tabela=produtos id={0649cd1d-a81e-4ee4-a88b-ae3d07b317f6} codigo=12345678900001 numero=1 barras=12345678900001 descricao=produto EXEMPLO unidade=un tipo=00 ncm=12345678 tipi= genero=12 servico= iat=t ippt=t

9 origem=0 tributacao=t icms_csosn=101 icms_cst=00 icms_base=100,000 icms_aliquota=7,000 issqn_cst=n issqn_base=0,000 issqn_aliquota=0,000 pis_cst=49 pis_base=100,000 pis_aliquota=1,650 cofins_cst=49 cofins_base=100,000 cofins_aliquota=7,600 observacao_fiscal= unitario=149,99 estoque=50,000 [2] tabela=produtos id={02fa35c9-0db4-d3d0-1f36-e820c53bb7e4} codigo=12345678900002 numero=2 barras=12345678900002 descricao=servico EXEMPLO unidade=un tipo=09 ncm=99999999 tipi= genero=99 servico=1234 iat=t ippt=t origem=0 tributacao=s icms_csosn=400 icms_cst=90 icms_base=0,000 icms_aliquota=0,000 issqn_cst=n issqn_base=100,000 issqn_aliquota=3,000 pis_cst=49 pis_base=100,000 pis_aliquota=1,650 cofins_cst=49 cofins_base=100,000 cofins_aliquota=7,600 observacao_fiscal= unitario=1500,00 estoque=0,000

10 Exportação O PIT-CAIXA exporta arquivos no formato INI. São gerados vários arquivos, sendo um arquivo para cada registro de: Cupom Fiscal (CF); Cancelamento de Cupom Fiscal (FC); Cupom Não Fiscal (CN); Cancelamento de Cupom Não Fiscal (NC); Suprimento (SU); Cancelamento de Suprimento (UC); Sangria (SA); Cancelamento de Sangria (AC); Comprovante de Cartão de Crédito ou Débito (CC); Relatório Gerencial (RG); Leitura X (LX); Redução Z (RZ). O nome dos arquivos gerados segue a seguinte regra: VVV-OOOOOO-EEE-CCCCCC-AAAAMMDD-HHNNSS-TT.ini Onde: VVV se refere ao número do PDV; OOOOOO se refere ao número da sessão; EEE se refere ao número do ECF; CCCCCC se refere ao número do COO; AAAA se refere ao ano da emissão; MM se refere ao mês da emissão; DD se refere ao dia da emissão; HH se refere a hora da emissão; NN se refere ao minuto da emissão; SS se refere ao segundo da emissão; TT se refere ao tipo de registro. A estrutura dos arquivos gerados é a mesma, contendo uma sessão de cabeçalho e sessões adicionais conforme o tipo de registro. A estrutura básica dos arquivos gerados é a seguinte:

11 Seção de cabeçalho [arquivo] pdv= (número de identificação do ponto de venda) sessao= (número de identificação da sessão de trabalho) ecf= (número de identificação do emissor de cupom fiscal) coo= (número do contador de ordem de operação do documento impresso no ecf) emissao= (data e hora da emissão do documento impresso no ecf) tipo= (tipo de documento impresso no ecf) operador_id= (chave de identificação do usuário operador) supervisor_id= (chave de identificação do usuário supervisor que autorizou a operação) O campo tipo determina qual seção deve ser lida. Se for do tipo RZ a sessão a ser lida será reducao", os demais tipos devem ler a seção cupom. Seção de redução Z [reducao] emissao= (data e hora da emissão) movimento= (data do movimento) serie= (número de série do ecf) ecf= (número sequencial do ecf) crz= (número do contador de redução Z) cro= (número do contador de reinício de operação) coo= (número do contador de ordem de operação) coo_inicial= (número do contador de ordem de operação do início do movimento) venda_bruta= (valor da venda bruta) grande_total= (valor do grande total) totalizadores= (quantidade de totalizadores) O campo totalizadores informa quantos totalizadores estão relacionados a Redução Z. Seção de totalizador [totalizador xxx] (onde xxx é o número sequencial do totalizador) totalizador= (código do totalizador [tabela de totalizadores]) valor= (valor do totalizador) Seção para os demais documentos [cupom] emissao= (data e hora da emissão) serie= (número de série do ecf) ecf= (número sequencial do ecf) coo= (número do contador de ordem de operação) ccf= (número do contador de cupom fiscal) gnf= (não fiscal) grg= (relatório gerencial) cdc= (número do contador de débito e crédito) subtotal= (valor de subtotal)

12 desconto= (valor de desconto) acrescimo= (valor de acréscimo) total= (valor total) pis= (valor total de pis) cofins= (valor total de cofins) consumidor_doc= (documento[cpf/cnpj] do consumidor) consumidor_nome= (nome do consumidor) cliente_id= (chave de identificação do cliente) vendedor_id= (chave de identificação do usuário vendedor) supervisor_id= (chave de identificação do usuário supervisor [em casos de autorização]) cancelado= (indicador de cupom cancelado [S/N]) observacao= (observação do cupom [sangria e suprimento]) produtos= (quantidade de produtos [cupom fiscal]) recebimentos= (quantidade de recebimentos [cupom não fiscal]) pagamentos= (quantidade de pagamentos [cupom fiscal e cupom não fiscal]) O campo produtos informa quantos produtos estão relacionados ao cupom fiscal. O campo recebimentos informa quantos recebimento estão relacionados ao cupom não fiscal. O campo pagamentos informa quantos pagamentos estão relacionados, tanto para cupom fiscal, quanto para cupom não fiscal. Seção de produto [produto xxx] (onde xxx é o número sequencial do produto) sequencia= (número de sequência do produto no ecf) produto_id= (chave de identificação do produto) complemento= (texto de complemento) quantidade= (quantidade com 3 casas decimais) unitario= (valor unitário com 2 casas decimais) total= (valor total com 2 casas decimais) desconto= (valor de desconto no produto) acrescimo= (valor de acréscimo no produto) desconto_cupom= (valor de desconto do cupom rateado para o produto) acrescimo_cupom= (valor de acréscimo do cupom rateado para o produto) totalizador= (código do totalizador no ecf [tabela de totalizador]) tributacao= (código de tributação [tabela de tributação]) aliquota= (alíquota efetiva do produto no ecf) base= (percentual de base utilizado para cálculo de alíquota efetiva) icms_cst= (código cst de icms [tabela de cst icms]) icms_base= (valor de base de icms) icms_aliquota= (alíquota de icms) icms_valor= (valor de icms) issqn_cst= (código cst de issqn [tabela de cst issqn]) issqn_base= (valor de base de issqn) issqn_aliquota= (alíquota de issqn) issqn_valor= (valor de issqn) pis_cst= (código cst de pis [tabela de cst pis/cofins]) pis_base= (valor de base de pis) pis_aliquota= (alíquota de pis) pis_valor= (valor de pis)

13 cofins_cst= (código cst de cofins [tabela de cst pis/cofins]) cofins_base= (valor de base de cofins) cofins_aliquota= (alíquota de cofins) cofins_valor= (valor de cofins) cancelado= (indicador de cancelamento do produto [S/N]) supervisor_id= (chave de identificação do usuário supervisor [em casos de autorização de desconto ou cancelamento]) Seção de recebimento [recebimento xxx] (onde xxx é o número sequencial do recebimento) sequencia= (número de sequência do recebimento no ecf) recebimento= (nome do totalizador não fiscal de recebimento) valor= (valor do recebimento) desconto_cupom= (valor de desconto do cupom não fiscal rateado para o recebimento) acrescimo_cupom= (valor de acréscimo do cupom não fiscal rateado para o recebimento) Seção de pagamento [pagamento xxx] (onde xxx é o número sequencial do pagamento) sequencia= (número de sequência do pagamento no ecf) pagamento= (nome da forma de pagamento) valor= (valor do pagamento) cartao_parcelas= (quantidade de parcelas do cartão) cartao_rede= (número da rede autorizadora do cartão) cartao_tr= (tipo da transação do cartão [tabela de tipos de transação de cartão]) cartao_ct= (código da transação do cartão) cartao_nsu= (número sequencial único do cartão) cheque_documento= (documento[cfp/cnpj] 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_convenio_cliente_id= (chave de identificação do convênio do cliente) convenio_supervisor_id= (chave de identificação do usuário supervisor em caso de autorização de convênio) crediario_tipo= (tipo de crediário) crediario_vencimento= (data de vencimento do crediário)

14 Tabelas auxiliares Tabela de Tipos de Produto 00 Mercadoria para Revenda 01 Matéria-Prima 02 Embalagem 03 Produto em Processo 04 Produto Acabado 05 Subproduto 06 Produto Intermediário 07 Material de Uso e Consumo 08 Ativo Imobilizado 09 Serviços 10 Outros insumos 99 Outras Tabela de Origens 0-Nacional, exceto as indicadas nos códigos 3 a 5 1-Estrangeira - Importação direta, exceto a indicada no código 6 2-Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7 3-Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% 4-Nacional, cuja produção tenha sido feita em conformidade com os processos produtivos básicos de que tratam o Decreto-Lei nº 288/67, e as Leis nºs 8.248/91, 8.387/91, 10.176/01 e 11. 4 8 4 / 0 7 5-Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40% 6-Estrangeira - Importação direta, sem similar nacional, constante em lista de Resolução CAMEX 7-Estrangeira - Adquirida no mercado interno, sem similar nacional, constante em lista de Resolução CAMEX Tabela de Tributações I-Isento N-Não Tributado F-Substituição Tributária T-Tributado pelo ICMS S-Tributado pelo ISSQN Tabela CSOSN 101-Tributada pelo Simples Nacional com permissão de crédito 102-Tributada pelo Simples Nacional sem permissão de crédito 103-Isenção do ICMS no Simples Nacional para faixa de receita bruta 201-Tributada pelo Simples Nacional com permissão de crédito e com cobrança do ICMS por substituição tributária 202-Tributada pelo Simples Nacional sem permissão de crédito e com cobrança do ICMS por substituição tributária 203-Isenção do ICMS no Simples Nacional para faixa de receita bruta e com cobrança do ICMS por substituição tributária 300-Imune 400-Não tributada pelo Simples Nacional

15 500-ICMS cobrado anteriormente por substituição tributária (substituído) ou por antecipação 900-Outros Tabela CST ICMS 00-Tributada integralmente 10-Tributada e com cobrança do ICMS por substituição tributária 20-Com redução de base de cálculo 30-Isenta ou não tributada e com cobrança do ICMS por substituição tributária 40-Isenta 41-Não tributada 50-Suspensão 51-Diferimento 60-ICMS cobrado anteriormente por substituição tributária 70-Com redução de base de cálculo e cobrança do ICMS por substituição tributária 90-Outras Tabela CST ISSQN N-Normal R-Retida S-Substitutiva I-Isenta Tabela CST PIS/COFINS 01-Operação Tributável com Alíquota Básica 02-Operação Tributável com Alíquota Diferenciada 03-Operação Tributável com Alíquota por Unidade de Medida de Produto 04-Operação Tributável Monofásica Revenda a Alíquota Zero 05-Operação Tributável por Substituição Tributária 06-Operação Tributável a Alíquota Zero 07-Operação Isenta da Contribuição 08-Operação sem Incidência da Contribuição 09-Operação com Suspensão da Contribuição 49-Outras Operações de Saída 50-Operação com Direito a Crédito Vinculada Exclusivamente a Receita Tributada no Mercado Interno 51-Operação com Direito a Crédito Vinculada Exclusivamente a Receita Não Tributada no Mercado Interno 52-Operação com Direito a Crédito Vinculada Exclusivamente a Receita de Exportação 53-Operação com Direito a Crédito Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno 54-Operação com Direito a Crédito Vinculada a Receitas Tributadas no Mercado Interno e de Exportação 55-Operação com Direito a Crédito Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação 56-Operação com Direito a Crédito Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno, e de Exportação 60-Crédito Presumido Operação de Aquisição Vinculada Exclusivamente a Receita Tributada no Mercado Interno 61-Crédito Presumido Operação de Aquisição Vinculada Exclusivamente a Receita Não- Tributada no Mercado Interno

16 62-Crédito Presumido Operação de Aquisição Vinculada Exclusivamente a Receita de Exportação 63-Crédito Presumido Operação de Aquisição Vinculada a Receitas Tributadas e Não- Tributadas no Mercado Interno 64-Crédito Presumido Operação de Aquisição Vinculada a Receitas Tributadas no Mercado Interno e de Exportação 65-Crédito Presumido Operação de Aquisição Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação 66-Crédito Presumido Operação de Aquisição Vinculada a Receitas Tributadas e Não- Tributadas no Mercado Interno, e de Exportação 67-Crédito Presumido Outras Operações 70-Operação de Aquisição sem Direito a Crédito 71-Operação de Aquisição com Isenção 72-Operação de Aquisição com Suspensão 73-Operação de Aquisição a Alíquota Zero 74-Operação de Aquisição sem Incidência da Contribuição 75-Operação de Aquisição por Substituição Tributária 98-Outras Operações de Entrada 99-Outras Operações Tabela de Totalizadores I1-ICMS isento N1-ICMS não tributado F1-ICMS substituição tributária nntxxxx-icms aliquota (onde nn é o índice e xxxx é a alíquota, exemplo: 01T1700) DT-ICMS desconto AT-ICMS acréscimo Can-T-ICMS cancelamento IS1-ISSQN isento NS1-ISSQN não Tributado FS1-ISSQN substituição tributária nnsxxxx-issqn alíquota (onde nn é o índice e xxxx é a alíquota, exemplo: 02S0500) DS-ISSQN desconto AS-ISSQN acréscimo Canc-S-ISSQN cancelamento OPNF-operação não fiscal Tabela de Tipos de Transação de Cartão CCR-Cartão de Crédito CPR-Cartão Private Label CCV-Cartão Voucher CDB-Cartão de Débito