> 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/lojas.md). # Lojas Integração | Comercial ### Visão geral A integração entre o sistema de Lojas (softwares de PDV e frente de caixa de terceiros, como Total e Links) e o Consistem ERP (CSW) tem por objetivo automatizar e centralizar o gerenciamento comercial, fiscal e financeiro das vendas originadas nas lojas físicas. Essa aplicação permite integrar ao ERP as emissões de notas fiscais (NF-e/NFC-e), cupons fiscais (SAT/ECF), recebimentos, movimentações de inventário e compras de funcionários com desconto direto em folha de pagamento. Da mesma forma, possibilita a exportação contínua de dados cadastrais e operacionais do ERP para os terminais das lojas - tais como produtos, clientes, fornecedores, tabelas de preço, notas de transferência, títulos pagos, saldo de estoque e movimentação de Tags da confecção. ### Requisitos

Consistem ERP	Lojas
Compatibilidade: 7.5 ou superiores do Consistem ERP. Módulos: Comercial - Integração Lojas, Financeiro e Recursos Humanos. Consistem API Licença: Aquisição de licença VAR ativa junto à Consistem. Orientamos o acompanhamento da nossa equipe de consultores.	Sistema de Frente de Caixa (PDV): Aplicação ativa nos caixas locais com suporte à exportação de arquivos planos ou consumo de APIs REST (JSON).
Acesso a Webservice: Para comunicação via API, os serviços REST devem estar ativos no servidor com tokens de autenticação parametrizados por usuário/serviço.	Padrão e Formato dos Arquivos: Caso utilize arquivos de texto, estes devem ser gerados obrigatoriamente na codificação ASCII e/ou ANSI.
	Geração de Arquivos: Capacidade do PDV em gerar arquivos rigorosamente dentro do leiaute Consistem.

Consistem ERP

Lojas

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulos: Comercial - Integração Lojas, Financeiro e Recursos Humanos.

Consistem API

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

Orientamos o acompanhamento da nossa equipe de consultores.

Sistema de Frente de Caixa (PDV): Aplicação ativa nos caixas locais com suporte à exportação de arquivos planos ou consumo de APIs REST (JSON).

Acesso a Webservice: Para comunicação via API, os serviços REST devem estar ativos no servidor com tokens de autenticação parametrizados por usuário/serviço.

Padrão e Formato dos Arquivos: Caso utilize arquivos de texto, estes devem ser gerados obrigatoriamente na codificação ASCII e/ou ANSI.

Geração de Arquivos: Capacidade do PDV em gerar arquivos rigorosamente dentro do leiaute Consistem.

### Configuração da integração #### No Consistem ERP: 1. Acesse o programa [Configuração de E-mail e Notificação da Loja (CCVAL000)](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/configuracoes-da-loja/configuracao-de-email-e-notificacao-da-loja.md), defina a leitura (por produto ou por TAG de confecção), e-mails de notificação e a integração com a Central de Notificações do ERP. É possível ativar alertas a cada importação bem-sucedida para garantir visibilidade sobre a rotina. 2. Na tela de [Configuração da Loja (CCVAL010)](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/configuracoes-da-loja/configuracao-da-loja.md), parametrize os representantes, caminhos de diretórios (para arquivos `.txt`), tipos de notas e diferenciação das séries de **Devolução Própria** e **Devolução de Cliente**. 3. Na [Configuração de Dados para Transferência entre Lojas (CCVAL011)](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/configuracoes-da-loja/configuracao-de-dados-para-transferencia-entre-lojas.md), parametrize as regras para o recebimento e aceite de notas de transferência entre lojas do mesmo grupo. 4. Acesse a [Configuração de Tipo de Nota por Tipo de Documento (CCVAL020)](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/configuracoes-da-loja/configuracao-de-tipo-de-nota-por-tipo-de-documento.md), mapeie os tipos de documentos emitidos pelo PDV (NFC-e, SAT, Cupom Fiscal), suas CFOPs e os tipos de notas correspondentes no ERP. 5. Acesse o programa [Configuração para Geração de Vales (CCRHB230)](/modulos/rh/manuais-de-telas/rh-folha-de-pagamento/lancamento-de-vales/configuracao-para-geracao-de-vales.md), parametrize as rubricas de desconto em folha, limite de comprometimento salarial por funcionário e defina o portador dos títulos dos colaboradores. 6. No [Agendamento de Tarefas (CSTASK015)](/modulos/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md), configure a Task automatizada para execução do programa de [Leitura Arquivo de Lojas (CCVAL100)](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/leitura-arquivo-de-lojas.md) em segundo plano (background) em intervalos regulares. #### Na integração Lojas: 1. **Integração via Arquivo Texto (`.txt`):** Configure o caminho de exportação no diretório compartilhado. 1. Ajuste a nomenclatura padrão do arquivo para `LojaXXXXXX.txt`, onde `XXXXXX` é um número sequencial de 6 dígitos incrementado a cada geração.

Exemplo:

Loja000001.txt
Loja000002.txt

2. Garanta a formatação dos campos no leiaute da Consistem: 1. Numérico: Alinhado à direita, preenchido com zeros à esquerda.

Exemplo:

00000100

2. Alfanumérico: Alinhado à esquerda, preenchido com espaços à direita. 3. Data: Formato `DDMMAAAA.`

Exemplo:

22072026

4. Valor: Tipo numérico com 2 casas decimais implícitas.

Exemplo:

R$ 120,50 = 00012050

5. Quantidade: Tipo numérico com 3 casas decimais implícitas.

Exemplo:

55,000 = 00055000

2. **Integração via API REST:** Cadastre as URLs base dos webservices (`/api`) e parametrize as credenciais no Header das requisições (`empresa` e `Authorization` via Token Bearer gerado por usuário no ERP). ### Como a integração funciona A comunicação entre a frente de caixa das lojas e o Consistem ERP ocorre através de duas modalidades: **Arquivos Planos (TXT)** ou **Serviços API REST (JSON)**. 1. **Formato Geral dos Arquivos (`.txt`)** 1. Codificação: ASCII e/ou ANSI (notepad++). 2. Nome do Arquivo: `LojaXXXXXX.txt` (sequencial numérico de 6 dígitos). 2. **Estrutura dos Registros (Leiaute de Campos):**\ Cada linha do arquivo representa um registro no leiaute Consistem, identificado pelos seus primeiros 2 dígitos: 1. [Registro 01 (Documento Capa)](#registro-tipo-01-documento-capa): Dados gerais do documento fiscal/venda. 2. [Registro 02 (Documento Itens)](#registro-tipo-02-documento-itens): Detalhamento dos produtos/itens vendidos. 3. [Registro 03 (Condições de Venda)](#registro-tipo-03-condicoes-de-venda): Formas de pagamento, vencimentos e parcelas. 4. [Registro 04 (Troca / Devolução)](#registro-tipo-04-troca-devolucao): Detalhamento das devoluções e trocas de produtos. 5. [Registro 05 (Cliente)](#registro-tipo-05-cliente): Cadastro ou atualização de dados dos clientes. 6. [Registro 06 (Anulação de Venda)](#registro-tipo-06-anulacao-de-venda): Anulação de vendas exportadas em arquivos anteriores. 7. [Registro 09 (Dados Adicionais)](#registro-tipo-09-dados-adicionais-da-nota-fiscal): Informações complementares do documento fiscal. 8. [Registro 10 (Aceite de Nota)](#registro-tipo-10-aceite-de-nota): Confirmação de recebimento de cargas/transferências. 9. [Registro 11 (Baixa de Títulos)](#registro-tipo-11-baixa-de-titulos): Comunicação de recebimentos e pagamento de carnês. 3. **Codificação de Domínios de Pagamento no Leiaute**\ Para a correta identificação dos pagamentos nos Registros [Tipo 03 (Condições de Venda)](#registro-tipo-03-condicoes-de-venda) e [Tipo 11 (Baixa de Títulos)](#registro-tipo-11-baixa-de-titulos), o sistema de loja deve enviar códigos específicos nos campos correspondentes: 1. Código de Recebimento: Define a modalidade de pagamento utilizada no caixa, sendo representado por **1** para **Dinheiro**, **2** para **Cheques** e **3** para **Cartão**. 2. Código de Operadora de Cartão: Quando o recebimento for via **Cartão** (código **3**), deve-se informar a operadora correspondente, utilizando **0** para **Sem Operadora**, **1** para **Banricompras**, **2** para **Visa**, **3** para **Redecard**, **4** para **Amex** e **5** para **Ipercard**. 3. Parâmetros de Desconto: Define o tipo de operação financeira ou comercial associada à venda, identificados por **1** (**À vista**), **2** (**Cheque**), **3** (**À vista Funcionário**), **4** (**Cheque Funcionário**), **5** (**Brindes**), **6** (**Bonificação**) e **7** (**Romaneio**). 4. **Validações e Regras de Consistência:** 1. Consistência Capa x Item: O somatório dos itens, impostos (ICMS, PIS, Cofins) e descontos deve coincidir rigorosamente com os valores declarados no cabeçalho do documento. 2. Coerência Fiscal: Exigência de preenchimento da base de cálculo de PIS/Cofins sempre que houver valor retido e correto detalhamento das bases de ICMS (creditada, isenta ou outras) para permitir a escrituração no SPED. 3. Travas do ERP: O sistema rejeita lançamentos em períodos contábeis/estoque fechados, códigos de produtos inválidos e operações que resultem em saldo negativo de estoque não permitido. 5. **Gerenciamento de Pendências:** Se o registro contiver inconsistências, a gravação nas tabelas oficiais de vendas (`FTNF`) é bloqueada e o evento é retido na global de pendências (`CLJBP`). Através do [Monitor de Pendências de Importação de Dados da Loja (CCVAL620)](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/monitor-de-pendencias-de-importacao-de-dados-da-loja.md), a equipe responsável pode: 1. Consultar os registros retidos divididos por abas ([Documentos Fiscais](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/monitor-de-pendencias-de-importacao-de-dados-da-loja/aba-documentos-fiscais.md), [Devoluções](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/monitor-de-pendencias-de-importacao-de-dados-da-loja/aba-devolucoes.md), [Clientes](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/monitor-de-pendencias-de-importacao-de-dados-da-loja/aba-clientes.md), [Aceite Nota](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/monitor-de-pendencias-de-importacao-de-dados-da-loja/aba-aceite-nota.md) e [Baixa de Títulos](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/monitor-de-pendencias-de-importacao-de-dados-da-loja/aba-baixa-de-titulos.md)). 2. Baixar o arquivo original `.txt` ou o *payload* JSON recebido para auditoria. 3. Editar os valores incorretos diretamente na interface em grid (Capa, Itens e Duplicatas) e reprocessar o documento no próprio ERP sem precisar regerar o arquivo na loja. 6. **APIs Webservice Disponibilizadas:** Para integrações via webservice em tempo real, a Consistem disponibiliza endpoints específicos: 1. O que a Consistem Recebe (POST/PUT): 1. `PUT /documentoFiscal` - Importação de cupons de venda e notas fiscais. 2. `PUT /devolucaoNotaLoja` - Registro de devoluções e trocas efetuadas na loja. 3. `PUT /cancelamentoNota` - Processamento de cancelamentos de documentos de venda. 4. `PUT /baixaTitulos` - Liquidação e baixa de crediário/carnês recebidos no caixa. 5. `PUT /aceiteNota` - Registro do aceite de notas de transferência enviadas à loja. 2. O que a Consistem Envia para a Loja (GET): 1. Consultas de Cadastros de Produtos, Clientes, Fornecedores, Tabelas de Preço, Notas de Transferência, Títulos Pagos e Movimentação de Tags do PCP. ### Fluxo do processo O fluxo de trabalho da integração descreve o caminho da informação desde a loja física até a contabilização central no ERP, utilizando o leiaute padrão da Consistem: 1. **Efetivação Comercial na Loja:** A venda, devolução, troca ou recebimento de carnê é realizado fisicamente no caixa (PDV) da loja. 2. **Geração no Leiaute Consistem:** 1. *Via Arquivo:* O PDV gera o arquivo `LojaXXXXXX.txt` contendo a sequência dos registros no leiaute Consistem ([Tipo 01 - Capa](#registro-tipo-01-documento-capa), [Tipo 02 - Itens](#registro-tipo-02-documento-itens), [Tipo 03 - Condições de Venda](#registro-tipo-03-condicoes-de-venda), [Tipo 04 - Troca/Devolução](#registro-tipo-04-troca-devolucao), [Tipo 05 - Cliente](#registro-tipo-05-cliente), [Tipo 09 - Dados Adicionais](#registro-tipo-09-dados-adicionais-da-nota-fiscal), [Tipo 10 - Aceite de Carga](#registro-tipo-10-aceite-de-nota), [Tipo 11 - Baixas](#registro-tipo-11-baixa-de-titulos)) e o deposita no diretório mapeado. 2. *Via API:* O PDV envia uma requisição HTTP nos endpoints REST estruturada no leiaute JSON. 3. **Recepção e Cópia de Segurança:** O Consistem ERP recebe os dados via Task agendada ([Agendamento de Tarefas (CSTASK015)](/modulos/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md)) ou chamada de API e grava uma cópia de segurança em *stream*. 4. **Validação Automática:** O ERP submete a mensagem às regras fiscais e tributárias do leiaute Consistem. 5. **Tratativa de Exceções:** Se houver erros, o documento fica retido no [Monitor de Pendências de Importação de Dados da Loja (CCVAL620)](/modulos/comercial/manuais-de-telas/comercial-integracao-lojas/loja/monitor-de-pendencias-de-importacao-de-dados-da-loja.md) e um alerta é emitido na Central de Notificações/e-mail. A TI/Suporte ajusta as informações e dispara a reimportação. 6. **Efetivação e Desdobramentos nos Módulos:** 1. Vendas e Estoque: O documento e os itens são gravados oficialmente, dando baixa no estoque da loja e atualizando o faturamento. 2. Baixa Multi-loja e Prestação de Contas: Recebimentos de carnês gerados em outras lojas são integrados à [Prestação de Contas das Lojas (CCCC170)](/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/prestacao-de-contas/prestacao-de-contas-das-lojas.md). 3. Aceite de Transferências: A mercadoria enviada pela fábrica só entra no estoque da loja após o envio do aceite ([Registro Tipo 10](#registro-tipo-10-aceite-de-nota)). 4. Desconto em Folha (RH): Vendas realizadas a funcionários (identificadas pelo portador exclusivo do funcionário) geram a baixa do título e criam automaticamente o lançamento da rubrica na folha de pagamento ativa ([Geração de Desconto em Folha (CCRHV100)](/modulos/rh/manuais-de-telas/rh-folha-de-pagamento/lancamento-de-vales/geracao-de-desconto-em-folha.md)), respeitando a margem limite configurada. 5. Devolução Intercompany (Cargas): No retorno de mercadorias para a matriz ([Saldos da Conferência via Sugestão (CCPVC151)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/conferencia-da-carteira-de-pedidos/saldos-da-conferencia-via-sugestao.md)), o ERP valida o ponteiro de entrada (CPVC13B) e bloqueia a leitura do produto se a loja de destino não corresponder à filial de origem. ### Tabela de Registros do Leiaute #### **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. {% hint style="warning" %} *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. {% endhint %} {% hint style="info" %} 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. {% endhint %} #### **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**](#registro-tipo-04-troca-devolucao). * **Processamento de Devoluções no CSW:** O arquivo de integração deve conter o [**Registro 01**](#registro-tipo-01-documento-capa) com os dados da nota de entrada de devolução. Em seguida, este [**Registro 04**](#registro-tipo-04-troca-devolucao) 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-01-documento-capa). #### **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**](#registro-tipo-01-documento-capa) **e** [**02**](#registro-tipo-02-documento-itens), mas não deve incluir o **Registro** [**Tipo 03**](#registro-tipo-03-condicoes-de-venda). A informação de cancelamento ou inutilização deve ser indicada na posição 333 (Situação da Nota) do **Registro** [**Tipo 01**](#registro-tipo-01-documento-capa). * **No dia seguinte à exportação:** A loja deve enviar apenas o **Registro** [**Tipo 06**](#registro-tipo-06-anulacao-de-venda), preenchido com as informações necessárias. Não é necessário enviar os **Registros** [**Tipos 01**](#registro-tipo-01-documento-capa)**,** [**02**](#registro-tipo-02-documento-itens) **e** [**03**](#registro-tipo-03-condicoes-de-venda) 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/lojas.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.