> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/comercial/integracao-com-lojas-arquivo-txt.md). # Integração com Lojas - Arquivo txt ## 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)](/comercial/manuais-de-telas/comercial-integracao-lojas/loja/leitura-arquivo-de-lojas.md). ## Requisitos ***

Consistem ERP	Lojas
Compatibilidade: 7.5 ou superiores do Consistem ERP. Módulo: Comercial - Integração Lojas Aquisição de licença VAR ativa junto à Consistem. Orientamos o acompanhamento da nossa equipe de consultores.	Geração dos arquivos conforme este leiaute.

Consistem ERP

Lojas

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulo: Comercial - Integração Lojas

Aquisição de licença VAR ativa junto à Consistem.

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

Formato	Descrição	Exemplo Conteúdo	Exemplo Arquivo
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

| Código Recebimento | Código Operadora Cartão | Parâmetros de Desconto | | ------------------ | ----------------------- | ----------------------- | | 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.

Tipo de Registro	Tabela
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.

Campo	Descrição	Tam	Formato	Posição	Observação
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 3-Exterior
7	CNPJ/CPF Cliente	14	Numérico	41-54	Para ECF = Zeros \| Para Exterior repassar o código RUC.
8	Valor Bruto 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 3 - Contingência
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 2 decimais
39	Peso Bruto	9	Numérico	523-531	7 inteiros e 2 decimais
40	Espécie de Volumes	20	Alfanumérico	532-551
41	Quantidade de Volumes	10	Numérico	552-561
42	Valor FCP/FECOEP ICMS			562-573	10 inteiros e 2 decimais
43	Valor FCP/FECOEP do ST			574-585	10 inteiros e 2 decimais

### **Registro Tipo 02 - Documento Itens** Este registro detalha cada item de um documento fiscal.

Campo	Descrição	Tamanho	Formato	Posição	Observação
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
9	Valor Total do Item Bruto	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	Este campo não é obrigatório. Por padrão, o Preço Unitário Bruto é assumido com 2 casas decimais implícitas (ex: R$ 49,90 enviado como 4990). Se precisar de maior precisão, informe neste campo o número total de casas decimais utilizado. O preço unitário deve ser enviado sem ponto/vírgula, considerando esta quantidade de casas. Ex: se informado 5, R$ 49,90 deve ser enviado como 4990000. Importante: O número de casas decimais utilizado aqui DEVE ser o mesmo configurado no Consistem ERP.
49	Percentual FECOEP ICMS	4	Numérico	396-399	2 inteiros e 2 decimais
50	Valor FCP/FECOEP ICMS	12	Numérico	400-411	10 inteiros e 2 decimais
51	Percentual FECOEP do ST	4	Numérico	412-415	2 inteiros e 2 decimais
52	Valor FCP/FECOEP do ST	12	Numérico	416-427	10 inteiros e 2 decimais
53	Base IBS/CBS	12	Valor	428-439
54	Alíquota IBS Estadual	4	Valor	440-443
55	Valor IBS Estadual	12	Valor	444-455
56	Alíquota IBS Municipal	4	Valor	456-459
57	Valor IBS Municipal	12	Valor	460-471
58	Alíquota CBS	4	Valor	472-475
59	Valor CBS	12	Valor	476-487
60	cClassTrib IBS/CBS	6	Alfanumérico	488-493
61	CST IBS/CBS	3	Alfanumérico	494-496
62	Base IS	12	Valor	497-508
63	Alíquota IS	4	Valor	509-512
64	Valor IS	12	Valor	513-524

**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.

Campo	Descrição	Tam	Formato	Posição	Observação
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-e` nas 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.

Campo	Descrição	Tam	Formato	Posição	Observação
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
46	Tipo de Devolução 0 – Própria / 1 – Cliente	1	Numérico	436-436	Caso o cliente tenha emitido a devolução, deverá ser passado 1 neste campo e também ser informada a série para registro.
47	Série Fiscal	3	Numérico	437-439	Para devolução de cliente é obrigatório. Para nota própria, caso seja passada, o sistema registra a entrada nessa série, caso contrário busca da Configuração da Loja (CCVAL010).
48	Valor FCP ICMS	12	Numérico	440-451
49	Valor FCP do ST	12	Numérico	452-463

### **Registro Tipo 05 - Cliente** Registro para cadastro ou atualização de informações de clientes.

Campo	Descrição	Tam	Formato	Posição	Observação
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 3-Exterior
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	E-mail	40	Alfanumérico	264-303
14	Observação	60	Alfanumérico	304-363
15	Número Endereço	10	Alfanumérico	364-373
16	Descrição País/Cidade	40	Numérico	374-413	Somente quando exterior
17	Código RUC	20	Alfanumérico	414-433	Somente quando exterior
18	Código BACEN	4	Alfanumérico	434-437	Somente quando exterior

### **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.

Campo	Descrição	Tam	Formato	Posição	Observação
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.

Campo	Descrição	Tam	Formato	Posição	Observação
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
6	Transferência entre Lojas	1	Numérico	48-48	A emissão de notas fiscais pela Loja deve ser indicada com o valor 1 (Sim). Caso a nota não tenha sido emitida pela Loja e, portanto, o campo seja preenchido com 0 (Não), o sistema será instruído a procurar uma pendência obrigatória no módulo de aceite do Consistem ERP .

### **Registro Tipo 11 - Baixa de Títulos** Este registro é utilizado para comunicar o pagamento (baixa) de títulos em aberto.

Campo	Descrição	Tam	Formato	Posição	Observações
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
13	Número Título	12	Alfanumérico	86-97	O sistema prioriza a busca de títulos em aberto através do Número de Título. Se esse número for fornecido, a busca será realizada exclusivamente por ele, e os dados de Nota Fiscal contidos nos campos 3, 4, 5 e 12 serão automaticamente desconsiderados. Portanto, ao informar o Número de Título, não é necessário preencher os campos 3, 4, 5 e 12.
14	CNPJ da Empresa do Título	14	Numérico	98-111	Informe o CNPJ do Emissor apenas quando o título pago for proveniente de outra loja. Se o campo for deixado em branco, o sistema assumirá que a emissão e o pagamento são referentes à sua loja.

### 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.

Esse conteúdo foi útil?

Sim Não

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/comercial/integracao-com-lojas-arquivo-txt.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.