Manual de Integração de Dados – ASP PAF-ECF
ASP DESENVOLVIMENTO DE SOFTWARES LTDA
MANUAL DE INTEGRAÇÃO DE DADOS
VERSÃO 2.4
02/2014
ASP PAF – ECF
X
SISTEMA DE RETAGUARDA
ASP Desenvolvimento de Softwares Ltda
Página 1
Manual de Integração de Dados – ASP PAF-ECF
DADOS TÉCNICOS PARA GERAÇÃO DO ARQUIVO ELETRÔNICO
DA COMUNICAÇÃO ENTRE O SISTEMA DE FRENTE DE CAIXA (ASP PAF-ECF) COM O
SISTEMA DE RETAGUARDA
1
- LOCAL DE GRAVAÇÃO:
1.1 O ASP PAF ira gerar o arquivo de sincronização e posteriormente gravá-lo no disco rígido
do computador do usuário, no local previamente configurado no ASP PAF-ECF para a a
gravação do mesmo. A configuração deste local se dá pelo arquivo asp.ini, onde é
informado o endereço da pasta de sincronização no Item “PAF_EnviaGestao.”, grupo
“Sincronizacao”. Este campo é pré-configurado pelo instalador, e só deve ser mudado caso
haja real necessidade.
Exemplo:
../Sistema/Config/asp.ini
[Sincronizacao]
PAF_RecebeGestao=..
PAF_EnviaGestao= C:\ASP Softwares\EnviaGestao
Caso haja necessidade de alteração do local de gravação do arquivo, mudar somente o
conteúdo após o símbolo de igual (=).
2
- NOME DO ARQUIVO
2.1 O ASP PAF gera em sua pasta de envio arquivos com o nome “SINCROPAF_data_hora”,
em que os subcaracteres “SINCROPAF” devem ser usados para reconhecimento do
arquivo, e os demais caracteres “_data_hora” são na verdade a data e hora da geração do
arquivo. A automação de retaguarda deve ordenar os arquivos gerados pelo ASP PAF de
forma que o primeiro arquivo gerado pelo mesmo seja o primeiro a ser sincronizado pela
automação. Qualquer outro arquivo com um formato diferente desde apresentado deve ser
ignorado e apagado.
OBS: é de responsabilidade total do sistema de retaguarda a sincronização e a
exclusão do arquivo “SINCROPAF_data_hora”, sendo que imediatamente após a
sincronização a automação deve excluí-lo da pasta de envio do ASP PAF.
3
- REGISTROS:
3.1 - Tipo: texto não delimitado;
3.2 - Tamanho: indeterminado, acrescido de CR/LF (Carriage return/Line feed) ao final de cada
registro;
3.3 - Organização: seqüencial;
3.4 - Codificação: ANSI.
4
- FORMATO DOS CAMPOS:
4.1 - Numérico (N): sem sinal, não compactado, alinhado à esquerda, já contendo a vírgula e
sem pontos decimais, com as posições não significativas em branco;
Ex: ’10,5
‘
4.2 - Alfanumérico (X): alinhado à esquerda, com as posições não significativas em branco;
Ex: ‘Nome Sobrenome
’
- Data (D): Formato (DD/MM/AAAA) sem espaços não significativos.
Ex: ’10/12/2009’
4.3 - Hora (H): Formato (HH:MM).
Ex: ’10:23’
ASP Desenvolvimento de Softwares Ltda
Página 2
Manual de Integração de Dados – ASP PAF-ECF
A linha acima exemplificada ficaria assim:
10,5
5
Nome Sobrenome
10/12/200910:23
- PREENCHIMENTO DOS CAMPOS
5.1 Todos os campos devem, na ausência de informação, ser preenchidos com espaços em
brancos.
Obs.: cada linha informada no arquivo será lida por inteira, ou seja, a falta de
qualquer campo resultará na falta da informação deste na tabela a que corresponde,
mesmo que tal informação já tenha sido passada em um arquivo anterior. Desta
forma, deixando claro que, sempre que houver uma atualização de um ou mais
campos de um registro, todos os campos devem ser informados no arquivo de
sincronização.
6
- ESTRUTURA DO ARQUIVO:
6.1 - As colunas das tabelas a seguir descrevem:
• Nº: Sequencia de campos de uma tabela;
• Campo: Nome do campo;
• Descrição: Descrição curta da função de cada campo;
• Tipo: Símbolo que representa se o campo é Numérico (N), Alfanumérico (X), Data (D)
ou Hora (H);
• Inicio: Coluna ou posição de inicio do campo na linha do arquivo;
• Tam: Tamanho do campo, ou seja , número de caracteres que forma o campo.
6.2 Alguns itens serão informados com um caractere especial a mais, junto com a
informação do tamanho, para informar algumas obrigatoriedades: Ex 10* / 10#
• * - Campo Obrigatório – O sistema de retaguarda deverá informar este campo
para manter a integridade do banco de dados.
• # - Campo Obrigatório para atender os requisitos do PAF-ECF (Fisco) – O sistema
de retaguarda deverá informar este campo para manter a integridade do banco de
dados e cumprir com os requisitos do PAF-ECF.
6.3 Campo Registro Tipo: campo de identificação da tabela. Corresponde ao primeiro
caractere e informa ao ASP PAF a qual tabela se destina as informações de uma linha. Se
este caractere não pertencer à lista de “Registros Tipo” que são reconhecidos, a linha que
corresponde será ignorada.
6.4 Demais Campos: os demais campos são atributos específicos de cada tabela abaixo
informada, devendo ser observada a obrigatoriedade de alguns deles:
Tabela
a.
b.
c.
d.
1 – Bancos
Quantidade de Caracteres da Linha – 61;
Registro do Tipo “1” - Bancos;
Relação 1/1;
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na seqüência
indicada e classificados em ordem ascendente de acordo com o campo de classificação
abaixo:
ASP Desenvolvimento de Softwares Ltda
Página 3
Manual de Integração de Dados – ASP PAF-ECF
Nº
1
2
3
4
5
Campo
Registro Tipo
CódigoBanc
Nome
NumAgencia
NumBanco
Descrição
1
Código identificador do registro
Descrição do Banco
Número referente a Agência do Banco
Número referente ao Banco informado
Tipo
X
N
X
X
X
Inicio
1
2
12
42
52
Tam
01
10*
30
10
10
* Campo Chave de identificação de Registro - Obrigatório
Tabela
e.
f.
g.
h.
Nº
1
2
3
4
5
6
7
8
9
2 – Contas Bancárias
Quantidade de Caracteres da Linha – 97;
Registro do Tipo “2” - Bancos;
Relação 1/N (Tabela 1);
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na seqüência
indicada e classificados em ordem ascendente de acordo com o campo de classificação
abaixo:
Campo
Registro Tipo
CódigoCBanc
CódigoBanc
Saldo Inicial
Nome
Senha
NumConta
DataSaldo
Ativo
Descrição
2
Código identificador do registro
Identificação do Banco (Nº 2 / Tabela 1)
Valor do saldo inicial da Conta
Descrição da Conta bancária
Senha da Conta Bancária
Número da Conta Bancária
Data de inicio do Saldo da Conta
‘S’ para Conta ativa, ‘N’ para conta Inativa
Tipo
X
N
X
N
X
X
X
D
X
Inicio
1
2
12
22
32
62
68
88
98
Tam
01
10*
10*
10
30
06
20
10
01
* Campo Chave de identificação de Registro – Obrigatório
Tabela
a.
b.
c.
d.
Nº
1
2
3
3 – Formas de Pagamento
Quantidade de Caracteres da Linha – 41;
Registro do Tipo “3” – Formas de Pagamento;
Relação 1/1;
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na seqüência
indicada e classificados em ordem ascendente de acordo com o campo de classificação
abaixo:
Campo
Registro Tipo
CódigoFpagto
Nome
Descrição
3
Código identificador do registro
Descrição da Forma de Pagamento
Tipo
X
N
X
Inicio
1
2
12
Tam
01
10*
30
* Campo Chave de identificação de Registro – Obrigatório
Tabela 4 – Venda – Frente de Caixa
a. Quantidade de Caracteres da Linha – 592;
b. Registro do Tipo “4” – Vendas;
c. Relação 1/1;
d. O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o campo
de classificação abaixo:
ASP Desenvolvimento de Softwares Ltda
Página 4
Manual de Integração de Dados – ASP PAF-ECF
Nº
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
Campo
Registro Tipo
CodigoVenda
CodigoCliente
VlrTotal
PercDesconto
Desconto
Acrescimo
VlrEntrada
CódigoFunc
PercComissao
NumeroCartao
CódigoTPagto
VlrCVale
CódigoCliTit
ValorFPagto
ValorTroco
ValorPago
NumeroPV
ChqValor
Usuario
Cancelada
Autorizacao
ContraVale
Fatura
NumeroDAV
Finalizada
TemTEF
TemCheque
ChqBanco
ChqNumero
ChqConta
ChqNome
ChqCPFCNPJ
NumCOO
Hora
Data
CodigoCPagto
Local
UsaPontos
PontosGanhos
PontosUtilizad
ValorProdutos
ValorServiços
CodigoCBanc
NomeCliente
CPFCNPJ
ChaveOrigem
Descrição
4
Código identificador da Venda
Código identificador do Cliente
Valor Total da Venda
Percentual de Desconto da Venda
Valor do Desconto da Venda
Valor do Acréscimo da Venda
Valor da Entrada da Venda (Dinheiro)
Código Identificador do Funcionário
Percentual de Comissão do Funcionário
Número de Cartão Fidelidade
Código Identificador da Forma de Pagto
Valor do Contra Vale
Código do Cliente Titular
Valor da Segunda Forma de Pagamento
Valor do Troco
Valor Pago pelo Cliente
Numero da Pré-Venda
Valor do Cheque
Nome do Usuário
Venda Cancelada (S/N)
Nome de quem autorizou a Venda
Tem contravale (S/N)
Tem Fatura (S/N)
Número do DAV (Doc Aux de Venda)
Venda Finalizada
Tem TEF (S/N)
Tem Cheque (S/N)
Banco do Cheque
Numero do Cheque
Número da Conta do Cheque
Emitente do Cheque
CPF ou CNPJ do Cheque
Contador de Ordem de Operação do ECF
Hora da Venda e do ECF
Data da Venda
Identificador da Condição de Pagamento
Terminal de Venda
Venda com Pontos
Quantidade de Pontos Ganhos
Quantidade de pontos Utilizados
Valor total dos produtos da venda
Valor total dos serviços da venda
Código da Conta Bancária destinada
Nome do Cliente da Venda
Cpf ou Cnpj do Cliente da Venda
Chave Informada pelo Gestão
ASP Desenvolvimento de Softwares Ltda
Tipo
X
N
N
N
N
N
N
N
N
N
X
N
N
N
N
N
N
N
N
X
X
X
X
X
N
X
X
X
X
X
X
X
X
X
X
D
N
X
X
N
N
N
N
N
X
N
N
Inicio
1
2
12
22
32
42
52
62
72
82
92
122
132
142
152
162
172
182
192
202
217
218
238
239
240
255
256
257
258
278
293
308
368
388
394
399
409
419
434
435
445
455
465
475
485
545
560
Tam
01
10*
10*
10
10
10
10
10
10*
10
30
10*
10
10*
10
10
10
10
10
15
1
20
1
1
15
1
1
1
20
15
15
60
20
6
5
10
10*
15
1
10
10
10
10
10*
60
15
10
Página 5
Manual de Integração de Dados – ASP PAF-ECF
47
48
NFabricacao
NumECF
Número de fabricação do ECF utilizado
Número Sequencial do ECF
X
X
570
590
20
3
* Campo Chave de identificação de Registro – Obrigatório
Tabela 5 – Produtos/Serviços da Venda – Frente de Caixa
a. Quantidade de Caracteres da Linha – 144;
b. Registro do Tipo “5” – Produtos/Serviços;
c. Relação 1/N (Tabela 4);
d. O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o campo
de classificação abaixo:
Nº
1
2
3
4
5
6
7
8
9
10
11
12
Campo
Registro Tipo
CodigoItem
CodigoProd
CodigoVenda
Qtde
Desconto
VlrVenda
ItemECF
PercDesconto
Acrescimo
Cancelado
CodigoFunc
13
14
Comissao
SitTribut
15
16
17
Aliquota
PercAcrescimo
Tipo
18
VlrCusto
Descrição
5
Código identificador do Item da Venda
Código identificador do Produto
Código ident da Venda (Nº 2 / Tab 4)
Quantidade de Produtos
Valor do Desconto sobre o Produto
Valor de Venda do Produto
Número do Item do ECF
Percentual de Desconto do Produto
Acrescimo sobre o Produto
Produto Cancelado na Venda (S/N)
Código do Funcionário que incluiu o
produto na venda.
Comissão Sobre o produto Vendido
Situação Tributária do Item
T = Tributado ICMS
F = Substituição Tributária
I = Isento
N = Não Tributado
Alíquota de ICMS aplicada
Percentual de Acréscimo do Produto
Tipo da venda do produto:
V = Varejo
A = Atacado
Valor de custo no momento da venda
Tipo
X
N
N
N
N
N
N
N
N
N
X
N
Inicio
1
2
12
22
32
42
52
62
72
82
92
93
Tam
01
10*
10*
10*
10
10
10
10
10
10
1
10*|
N
X
103
113
10
1
N
N
X
114
124
134
10
10
1
N
135
10
* Campo Chave de identificação de Registro – Obrigatório
ASP Desenvolvimento de Softwares Ltda
Página 6
Manual de Integração de Dados – ASP PAF-ECF
Tabela 6 – Financeiro da Venda – Frente de Caixa – Venda a Prazo (Carnê)
a. Quantidade de Caracteres da Linha – 422;
b. Registro do Tipo “6” – Venda a Prazo (Financeiro da Venda – Carnê);
c. Relação 1/N (Tabela 4);
d. O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o campo
de classificação abaixo:
Nº
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Campo
Registro Tipo
CodigoFinanc
CodigoVenda
Parcela
Valor
Juros
Multa
Desconto
CodigoCBanc
CodigoTPagto
ValorPago
NCheque
ChqBanco
ChqConta
ChqNome
ChqCPFCNPJ
Vencto
Cancelado
Obs
Descrição
6
Código identificador do Financeiro
Código ident da Venda (Nº 2 / Tab 4)
Número da Parcela
Valor da Parcela
Valor dos Juros
Valor da Multa
Valor do Desconto
Código da Conta Bancária destinada
Código da Forma de Pagamento
Valor Pago da Parcela
Numero do Cheque
Banco do Cheque
Número da Conta do Cheque
Emitente do Cheque
CPF ou CNPJ do Cheque
Data de Vencimento da Parcela
Indica o cancelamento da parcela
Observações relativas ao cancelamento
Tipo
X
N
N
N
N
N
N
N
N
N
N
N
X
X
X
X
D
X
X
Inicio
1
2
12
22
32
42
52
62
72
82
92
102
117
137
152
192
212
222
223
Tam
01
10*
10*
10
10
10
10
10
10*
10*
10
15
20
15
40
20
10
1
200
* Campo Chave de identificação de Registro - Obrigatório
Tabela 7 – Pagamento das Parcelas do Financeiro da Venda – Frente de Caixa – Venda a
Prazo (Carnê)
a.
b.
c.
d.
Nº
Quantidade de Caracteres da Linha – 123;
Registro do Tipo “6” – Venda a Prazo (Financeiro da Venda – Carnê);
Relação 1/N (Tabela 6);
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o
campo de classificação abaixo:
1
2
Campo
Registro Tipo
CodigoPagto
3
4
5
6
7
8
CodigoFinanc
Valor
CódigoTPagto
CodigoCBanc
Juros
Multa
Descrição
7
Código identificador do pagamento das
parcelas
Código do Financeiro
Valor pago pela Parcela
Código Identificador da Forma de Pagto
Código da Conta Bancária destinada
Valor dos Juros
Valor da Multa
ASP Desenvolvimento de Softwares Ltda
Tipo
X
N
Inicio
1
2
Tam
01
10*
N
N
N
N
N
N
12
22
32
42
42
52
10*
10
10*
10*
10
10
Página 7
Manual de Integração de Dados – ASP PAF-ECF
9
10
11
12
13
14
Desconto
Usuario
ImprRecibo
NumCOO
DataLancto
Pagto
Valor do Desconto
Nome do Usuário
Recibo impresso (S/N)
Número do COO do Cupom não fiscal
Data do lançamento
Data do pagamento
N
X
N
N
D
D
62
92
97
98
104
114
10
15
01
6
10
10
Tabela 8 – Lançamentos de Débitos/Créditos Diversos como Sangria e Suprimento de Caixa
a.
b.
c.
d.
Nº
1
2
3
4
5
6
7
8
9
10
11
Quantidade de Caracteres da Linha – 219;
Registro do Tipo “8” – Lançamentos de Sangria e Suprimento de Caixa;
Relação 1/1;
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o
campo de classificação abaixo:
Campo
Registro Tipo
CodigoLancto
CodigoCBanc
Valor
Historico
NumDocFiscal
Operacao
TipoOperacao
Realizado
DataLancto
DataRealiza
Descrição
8
Código identificador do Lançamento
Código da Conta Bancária destinada
Valor do Lançamento
Histórico do Lançamento
Número do Documento Fiscal
Operação (C/D)
Tipo de Operação (S/R) Sangria / Suprim.
Foi Realizado (S/N)
Data do Lançamento
Data da Realização
Tipo
X
N
N
N
X
X
X
X
X
D
D
Inicio
1
2
12
22
32
182
197
198
199
200
210
Tam
01
10*
10*
10
150
15
1
1
1
10
10
* Campo Chave de identificação de Registro - Obrigatório
Tabela 9 – Lançamentos de Transferências entre Contas Bancárias
a.
b.
c.
d.
Nº
1
2
3
4
5
6
7
8
Quantidade de Caracteres da Linha – 1061;
Registro do Tipo “9” – Registros de Transferência entre Contas;
Relação 1/1;
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o
campo de classificação abaixo:
Campo
Registro Tipo
CodigoLancto
ContaOrigem
ContaDestino
Valor
DataRealiaz
DataLancto
Obs
Descrição
9
Código identificador do Lançamento
Código da Conta bancária de Origem
Código da Conta bancária de Destino
Valor transferido
Data da Realização do Movimento
Data do Lançamento do Movimento
Observações
Tipo
X
N
N
N
N
D
D
X
Inicio
1
2
12
22
32
42
52
62
Tam
01
10*
10
10
10
10
10
1000
* Campo Chave de identificação de Registro - Obrigatório
ASP Desenvolvimento de Softwares Ltda
Página 8
Manual de Integração de Dados – ASP PAF-ECF
Tabela A – Reduções Z Emitidas
a.
b.
c.
d.
Nº
1
2
3
4
5
6
7
8
9
Quantidade de Caracteres da Linha – 82;
Registro do Tipo “A” – Registros de Reduções Z Emitidas;
Relação 1/1;
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o
campo de classificação abaixo:
Campo
Registro Tipo
DataMovimento
NumECF
CRZ
COO Inicial
GT Inicial
GT Final
NFabricação
CRO
Descrição
A
Data do Movimento da Redução Z
Número Sequencial do ECF
Contador de Reduções Z
Contador de Ordem de Operação Inicial
Grande Total Incial
Grande Total Final
Numero de Fabricação do ECF da
Redução Z
Contador de Reinício de Operação
Tipo
X
X
X
X
X
N
N
X
Inicio
1
2
12
15
21
27
42
57
Tam
01
10
3
6
6
15
15
20
N
77
6
* Campo Chave de identificação de Registro – Obrigatório
Tabela B – Documento Fiscal Manual
a.
b.
c.
d.
Nº
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Quantidade de Caracteres da Linha – 161;
Registro do Tipo “B” – Registros de Documentos Fiscais Manuais;
Relação 1/1;
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o
campo de classificação abaixo:
Campo
Registro Tipo
CodigoDoc
CodigoCliente
CódigoTPagto
CodigoCPagto
VlrTotal
Desconto
Acrescimo
BaseCalcICMS
VlrICMS
Aliquota
NumOrdem
Serie
SubSerie
Hora
Data
Descrição
B
Código identificador do Documento
Código identificador do cliente
Código Identificador da Forma de Pagto
Identificador da Condição de Pagamento
Valor Total do Documento
Valor do Desconto do documento
Valor do Acréscimo do documento
Base de calculo do ICMS do documento
Valor do ICMS do documento
Aliquota do ICMS do documento
Numero da Ordem do documento
Serie do documento
Subserie do documento
Hora de emissão do documento
Data de emissão do documento
Tipo
X
N
N
N
N
N
N
N
N
N
N
X
X
X
H
D
Inicio
1
2
12
22
32
42
52
62
72
82
92
102
117
132
147
152
Tam
01
10*
10*
10*
10*
10
10
10
10
10
10
15
15
15
5
10
* Campo Chave de identificação de Registro - Obrigatório
ASP Desenvolvimento de Softwares Ltda
Página 9
Manual de Integração de Dados – ASP PAF-ECF
Tabela C – Produtos / Serviços do Documento Fiscal Manual
a.
b.
c.
d.
Nº
Quantidade de Caracteres da Linha – 51;
Registro do Tipo “C” – Produtos/Serviços;
Relação 1/1;
O arquivo deverá ser composto pelos seguintes conjuntos de registros, na
seqüência indicada e classificados em ordem ascendente de acordo com o
campo de classificação abaixo:
1
2
Campo
Registro Tipo
CodigoItem
3
CodigoDoc
4
5
6
CodigoProd
Qtde
VlrUnitario
Descrição
C
Código identificador do Item do
Documento
Código identificador do documento (Nº 2
/ Tab B)
Código identificador do Produto
Quantidade de Produtos
Valor Unitario do Produto
Tipo
X
N
Inicio
1
2
Tam
01
10*
N
12
10*
N
N
N
22
32
42
10*
10
10
* Campo Chave de identificação de Registro - Obrigatório
Suporte ASP Softwares
Fones: (49) 3223-0649 / 9121-0660
www.aspsoftwares.com.br
Alexandre
[email protected]
André
[email protected]
ASP Desenvolvimento de Softwares Ltda
Página 10