Integração com Lojas - Arquivo txt
Integrações | Comercial
Visão geral
Este documento detalha o formato e a estrutura dos arquivos de texto (txt) que devem ser gerados para a importação de dados das lojas através do programa Leitura Arquivo de Lojas (CCVAL100).
Requisitos
Compatibilidade: 7.3 ou superiores do Consistem ERP.
Módulo: Comercial - Integração Lojas
Orientamos o acompanhamento da nossa equipe de consultores.
Geração dos arquivos conforme este leiaute.
Formato Geral dos Arquivos
Formato de Codificação: ASCII e/ou ANSI (notepad++)
Nome do Arquivo: LojaXXXXXX.txt, onde XXXXXX é um número sequencial de 6 dígitos que deve ser incrementado a cada novo arquivo gerado.
Exemplos de arquivo: Loja000001.txt, Loja000002.txt, entre outros.
Regras de formatação para os campos dos arquivos de importação
Numérico
Alinhado a direita, preenchido com zeros a esquerda
100
00000100
Alfanumérico
Alinhado a esquerda, preenchido com espaços a direita
Teste
Teste
Data
No formato DDMMAAAA
22/07/08
22072008
Valor
Tipo Numérico com DUAS casas Decimais
120,50
00012050
Quantidade
Tipo Numérico com TRÊS casas Decimais
55,000
00055000
1 - Dinheiro
0 - Sem Operadora
1 - A vista
2 - Cheques
1 - Banricompras
2 - Cheque
3 - Cartão
2 - Visa
3 - A vista Funcionário
3 - Redecard
4 - Cheque Funcionário
4 - Amex
5 - Brindes
5 - Ipercard
6 - Bonificação
7 - Romaneio
Estrutura dos Registros (Leiaute de Campos)
Cada linha do arquivo representa um registro, identificado por um código de 2 dígitos. O arquivo deve conter uma sequência desses registros, conforme a transação.
01
Documento Capa
02
Documento Itens
03
Documento Condições Venda
04
Troca / Devoluções - Itens
05
Cadastro de Clientes
06
Documento Anulação
09
Dados Adicionais da Nota Fiscal
10
Aceite de Nota Fiscal de Carga
11
Baixas de Títulos
Registro Tipo 01 - Documento Capa
Este registro contém os dados gerais de uma nota fiscal, cupom fiscal eletrônico (NFC-e) ou documento de venda.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 01
2
CNPJ da Empresa (Loja)
14
Numérico
3-16
CNPJ da filial que está emitindo o documento.
3
Data de Emissão
8
Data
17-24
Formato: DDMMAAAA
4
Tipo Documento
1
Numérico
25-25
1-NF (NF-e/NFC-e) 2-ECF
5
Número do Documento
14
Numérico
26-39
Para NF-e: Número da nota fiscal.
Para ECF: cód_loja+ECF+cupom.
6
Tipo Cliente
1
Numérico
40-40
1-CNPJ 2-CPF
7
CNPJ/CPF Cliente
14
Numérico
41-54
Para ECF = Zeros
8
Valor Líquido dos Produtos
12
Valor
55-66
2 casas decimais.
Ex: R$123,45 = 0000012345
9
Valor do Frete
12
Valor
67-78
2 casas decimais.
10
Valor do Seguro
12
Valor
79-90
2 casas decimais.
11
Valor do IPI
12
Valor
91-102
2 casas decimais.
12
Valor Total Desconto
12
Valor
103-114
2 casas decimais.
13
Valor Total da Nota
12
Valor
115-126
Cálculo:
Valor Líquido dos
Produtos - Valor Total Desconto
14
Base Substituição Tributária
12
Valor
127-138
15
Valor Substituição Tributária
12
Valor
139-150
16
Série Nota Fiscal
1
Numérico
151-151
17
Observação
30
Alfanumérico
152-181
Do documento.
18
Número do ECF
12
Numérico
182-193
Para NF que acobertaram ECF
19
Base ICMS
12
Valor
194-205
20
Valor ICMS
12
Valor
206-217
2 casas decimais.
21
Valor PIS
12
Valor
218-229
2 casas decimais.
22
Valor Cofins
12
Valor
230-241
2 casas decimais.
23
Modelo do Documento
2
Numérico
242-243
55 - NF-e 59 - CF-e SAT 65 - NFC-e
24
Chave NF-e/NFC-e
44
Numérico
244-287
Para que o sistema consiga importar o SPED corretamente, é obrigatório enviar a chave da nota fiscal eletrônica neste campo.
25
Número de Série Equipamento SAT
9
Numérico
288-296
Para Documentos Modelo 59 CF-e-SAT
26
Valor FCP Difal
12
Valor
297-308
27
Valor ICMS Interestadual UF Destino Difal
12
Valor
309-320
28
Valor ICMS Interestadual UF Remetente Difal
12
Valor
321-332
29
Situação da Nota
1
Numérico
333-333
0 - Emitida 1 - Cancelada 2 - Inutilizada
30
Motivo do cancelamento
80
Alfanumérico
334-413
31
Protocolo de Autorização
36
Alfanumérico
414-449
32
Protocolo de Cancelamento
36
Alfanumérico
450-485
33
Data do Cancelamento
8
Data
486-493
34
Hora do Cancelamento
4
Numérico
494-497
35
Valor Outras Despesas
12
Valor
498-509
36
Nota Fiscal de Complemento
1
Numérico
510-510
0 - Não
1 - Sim
37
Série Fiscal
3
Numérico
511-513
3 dígitos
38
Peso Líquido
9
Numérico
514-522
7 inteiros e 3 decimais
39
Peso Bruto
9
Numérico
523-531
7 inteiros e 3 decimais
40
Espécie de Volumes
20
Alfanumérico
532-551
41
Quantidade de Volumes
10
Numérico
552-561
Registro Tipo 02 - Documento Itens
Este registro detalha cada item de um documento fiscal.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 02
2
CNPJ da Empresa (Loja)
14
Numérico
3-16
3
Data de Emissão
8
Data
17-24
4
Tipo Documento
1
Numérico
25-25
1-NF 2-ECF
5
Número do Documento
14
Numérico
26-39
6
Código do Produto (TAG)
24
Alfanumérico
40-63
Código identificador do produto.
7
Quantidade
8
Quantidade
64-71
Quantidade vendida, com 3 casas decimais. Ex: 123,456 = 00123456
8
Preço Unitário Bruto
12
Valor
72-83
Preço unitário do item, com 2 casas decimais.
9
Valor Total do Item Líquido
12
Valor
84-95
12
Valor do IPI
12
Valor
96-107
13
Valor Desconto
12
Valor
108-119
Valor do desconto aplicado ao item, com 2 casas decimais.
14
CFOP
4
Numérico
120-123
15
Base ICMS
12
Valor
124-135
16
Alíquota ICMS
12
Valor
136-147
17
Valor ICMS
12
Valor
148-159
ICMS do item, com 2 casas decimais.
18
ICMS Isentas
12
Valor
160-171
19
ICMS Outras
12
Valor
172-183
20
Base IPI
12
Valor
184-195
21
Valor IPI
12
Valor
196-207
22
IPI Isentas
12
Valor
208-219
23
IPI Outras
12
Valor
220-231
26
Código Situação Tributária ICMS
2
Numérico
232-233
27
Código Situação Tributária IPI
2
Numérico
234-235
28
Valor substituição tributária
12
Valor
236-247
29
Base substituição tributária
12
Valor
248-259
30
Alíquota Substituição Tributária
4
Valor
260-263
31
Código Enquadramento Legal IPI
3
Numérico
264-266
32
Alíquota IPI
4
Numérico
267-270
33
Código Situação Tributária PIS
2
Numérico
271-272
34
Base PIS
12
Valor
273-284
35
Alíquota PIS
4
Valor
285-288
36
Valor PIS
12
Valor
289-300
PIS do item, com 2 casas decimais.
37
Código Situação Tributária COFINS
2
Numérico
301-302
38
Base COFINS
12
Valor
303-314
39
Alíquota COFINS
4
Valor
315-318
40
Valor Cofins
12
Valor
319-330
Cofins do item, com 2 casas decimais.
41
Valor FCP Difal
12
Valor
331-342
42
Valor ICMS Interestadual UF Destino Difal
12
Valor
343-354
43
Valor ICMS Interestadual UF Remetente Difal
12
Valor
355-366
44
Série Nota Fiscal
1
Numérico
367-367
45
Valor Outras Despesas Rateado
12
Valor
368-379
46
Valor Frete Rateado
12
Valor
380-391
47
Série Fiscal
3
Numérico
392-394
3 dígitos
48
Quantidade Decimais Preço Unitário
1
Numérico
395-395
Observação: O campo Quantidade Decimais Preço Unitário não é obrigatório. Por padrão, o preço unitário é enviado com duas casas decimais. Se for preciso utilizar mais casas decimais, informe a quantidade desejada neste campo. O valor no campo Preço Unitário Bruto deverá ser enviado sem a vírgula.
Exemplo: Se o campo Quantidade Decimais Preço Unitário for preenchido com 5, o preço de R$ 49,90 deve ser enviado como 4990000. Se o campo não for preenchido, o preço de R$ 49,90 deve ser enviado como 4990, utilizando o padrão de duas casas decimais.
Importante: A quantidade de casas decimais informada aqui deve ser a mesma configurada no Consistem ERP. Se for utilizado 5 casas decimais, a configuração no ERP também deverá ser de 5.
Registro Tipo 03 - Condições de Venda
Detalha as formas de pagamento do documento.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 03
2
CNPJ da Empresa (Loja)
14
Numérico
3-16
3
Data de Emissão
8
Data
17-24
4
Tipo Documento
1
Numérico
25-25
1-NF 2-ECF
5
Número do Documento
14
Numérico
26-39
Número do cheque ou do cartão.
6
Sequencial
2
Numérico
40-41
7
Valor da Parcela
12
Valor
42-53
2 casas decimais.
8
Data Vencimento
8
Data
54-61
Formato: DDMMAAAA
9
Código Recebimento
1
Numérico
62-62
1=Dinheiro 2=Cheque 3=Cartão
10
Código Operadora Cartão
2
Numérico
63-64
0=Sem operadora 1=Banricompras 2=Visa 3=Redecard 4=Amex 5=Ipercard
11
Série Nota Fiscal
1
Numérico
65-65
12
Portador
4
Numérico
66-69
13
Tipo de Cobrança
2
Numérico
70-71
14
Número Bancário
20
Alfanumérico
72-91
15
Carteira
3
Alfanumérico
92-94
16
Conta Bancária
10
Alfanumérico
95-104
17
Série Fiscal
3
Numérico
105-107
3 dígitos
Registro Tipo 04 - Troca / Devolução
Este registro é utilizado para movimentações de troca e devolução de mercadorias.
Integração com CSW: Para que o CSW processe corretamente as trocas e devoluções, o sistema da loja deve enviar a
Chave NF-e/NFC-enas posições 334 a 377 deste Registro 04.Processamento de Devoluções no CSW: O arquivo de integração deve conter o Registro 01 com os dados da nota de entrada de devolução. Em seguida, este Registro 04 deve vir com os dados financeiros e os itens/produtos da devolução. Isso permitirá que o CSW realize as devoluções financeiras e a entrada dos itens devolvidos no estoque.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 04
2
CNPJ da Empresa (Loja)
14
Numérico
3-16
3
Data de Emissão
8
Data
17-24
Formato DDMMAAAA
4
Tipo Documento
1
Numérico
25-25
1-Etiqueta 2-Romaneio
5
Número do Documento
14
Numérico
26-39
Número sequencial de arquivo para validação
6
Tipo Cliente
1
Numérico
40-40
1-CNPJ 2-CPF
7
CNPJ/CPF Cliente
14
Numérico
41-54
Informar no caso de romaneio.
8
Código do Produto (TAG)
24
Alfanumérico
55-78
9
Quantidade
8
Quantidade
79-86
Quantidade do produto devolvido ou trocado.
10
Preço Unitário Líquido
12
Valor
87-98
11
Valor Total do Item
12
Valor
99-110
2 casas decimais.
12
Tipo Movimento
1
Numérico
111-111
1-Troca 2-Devolução
13
CFOP
4
Numérico
112-115
14
Valor Desconto
12
Valor
116-127
15
Código Situação Tributária ICMS
2
Numérico
128-129
16
Base ICMS
12
Valor
130-141
17
Alíquota ICMS
4
Valor
142-145
18
Valor ICMS
12
Valor
146-157
2 casas decimais.
19
ICMS Isentas
12
Valor
158-169
20
ICMS Outras
12
Valor
170-181
21
Código Situação Tributária IPI
2
Numérico
182-183
22
Base IPI
12
Valor
184-195
23
Alíquota IPI
4
Numérico
196-199
24
Valor IPI
12
Valor
200-211
2 casas decimais.
25
IPI Isentas
12
Valor
212-223
26
IPI Outras
12
Valor
224-235
27
Código Situação Tributária PIS
2
Numérico
236-237
28
Base PIS
12
Valor
238-249
29
Alíquota PIS
4
Valor
250-253
30
Valor PIS
12
Valor
254-265
2 casas decimais.
31
Código Situação Tributária Cofins
2
Numérico
266-267
32
Base Cofins
12
Valor
268-279
33
Alíquota Cofins
4
Valor
280-283
34
Valor Cofins
12
Valor
284-295
2 casas decimais.
35
Valor FCP Difal
12
Valor
296-307
36
Valor ICMS Interestadual UF Destino Difal
12
Valor
308-319
37
Valor ICMS Interestadual UF Remetente Difal
12
Valor
320-331
38
Modelo do Documento
2
Numérico
332-333
39
Chave NF-e/NFC-e
44
Numérico
334-377
40
Base Substituição Tributária
12
Valor
378-389
41
Valor Substituição Tributária
12
Valor
390-401
42
Alíquota ICMS-ST
5
Numérico
402-406
43
Valor Frete
12
Valor
407-418
44
Data de Emissão da Nota Devolvida
8
Data
419-426
45
Número da Nota Devolvida
9
Numérico
427-435
Registro Tipo 05 - Cliente
Registro para cadastro ou atualização de informações de clientes.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 05
2
CNPJ da Loja
14
Numérico
3-16
3
Tipo Cliente
1
Numérico
17-17
1-CNPJ 2-CPF
4
CNPJ / CPF do Cliente
14
Numérico
18-31
Se o cliente não tiver CPF ou CNPJ, o campo deve ser preenchido com 00000000000000.
5
Inscrição Estadual
14
Alfanumérico
32-45
6
Nome
60
Alfanumérico
46-105
7
Endereço
60
Alfanumérico
106-165
8
Bairro
30
Alfanumérico
166-195
9
CEP
8
Numérico
196-203
10
Nome Fantasia
30
Alfanumérico
204-233
11
Telefone
15
Alfanumérico
234-248
12
Fax
15
Alfanumérico
249-263
13
40
Alfanumérico
264-303
14
Observação
60
Alfanumérico
304-363
15
Número Endereço
10
Alfanumérico
364-373
Registro Tipo 06 - Anulação de Venda
Utilizado para anular vendas realizadas após a data de exportação do arquivo.
Este registro só deve ser enviado para anular vendas que foram exportadas em arquivos anteriores. Vendas anuladas no mesmo dia da exportação não precisam deste registro, pois já devem constar como canceladas no Registro Tipo 01.
Registro Tipo 09 - Dados Adicionais da Nota Fiscal
Informações complementares que devem constar na nota fiscal.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 09
2
CNPJ da Empresa (Loja)
14
Numérico
3-16
3
Data de Emissão
8
Data
17-24
Formato DDMMAAAA
4
Tipo Documento
1
Numérico
25-25
1-NF 2-ECF
5
Número do Documento
14
Numérico
26-39
Para NF-e: Número da nota fiscal.
Para ECF: cód_loja+ECF+cupom.
6
Série Nota Fiscal
1
Numérico
40-40
7
Informações Complementares
1000
Alfanumérico
41-1040
Registro Tipo 10 - Aceite de Nota
Este registro é utilizado para registrar o aceite de uma nota fiscal.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 10
2
CNPJ da Empresa (Loja)
14
Numérico
3-16
3
Número Nota Aceite
9
Numérico
17-25
4
Data Aceite da Nota
8
Data
26-33
Formato DDMMAAAA
5
CNPJ do Emissor da Nota
14
Numérico
34-47
Registro Tipo 11 - Baixa de Títulos
Este registro é utilizado para comunicar o pagamento (baixa) de títulos em aberto.
1
Tipo Registro
2
Numérico
1-2
Valor fixo: 11
2
CNPJ da Empresa (Loja)
14
Numérico
3-16
3
Data de Emissão
8
Data
17-24
Formato DDMMAAAA
4
Número Nota
9
Numérico
25-33
5
Sequencial Parcela
2
Numérico
34-35
6
Valor Baixa
12
Valor
36-47
Valor do pagamento, com 2 casas decimais.
7
Valor Juros
12
Valor
48-59
8
Valor Desconto
12
Valor
60-71
2 casas decimais.
9
Data da Baixa
8
Data
72-79
Formato DDMMAAAA
10
Código Recebimento
1
Numérico
80-80
1 - Dinheiro 2 - Cheque
3 - Cartão
11
Código Operadora Cartão
2
Numérico
81-82
12
Série Fiscal
3
Numérico
83-85
Informações adicionais: Cancelamento de Vendas
No mesmo dia da exportação: A loja deve enviar os dados nos Registros Tipos 01 e 02, mas não deve incluir o Registro Tipo 03. A informação de cancelamento ou inutilização deve ser indicada na posição 333 (Situação da Nota) do Registro Tipo 01.
No dia seguinte à exportação: A loja deve enviar apenas o Registro Tipo 06, preenchido com as informações necessárias. Não é necessário enviar os Registros Tipos 01, 02 e 03 novamente, pois esses dados já foram enviados no dia anterior.
Atualizado