Carga de Vendas — v2¶

Layout v2 dos arquivos de carga de vendas — o padrão obrigatório da plataforma Rock Conecta.

Layout v2

Este é o novo padrão da plataforma Rock Conecta. Para o layout original (3 arquivos, nomenclatura por mês), consulte a especificação v1.

A carga de vendas na v2 é composta por 4 arquivos interdependentes, relacionados entre si pelo campo idVenda:

Venda (VENDA_) — dados gerais da venda.
Itens (ITEM_) — produtos que compõem cada venda.
Pagamentos (PAGAMENTO_) — formas de pagamento de cada venda.
Descontos (DESCONTOS_) — descontos/cupons aplicados na venda.

Os arquivos são depositados no local designado ao varejista. Após o envio, o sistema processa automaticamente os dados e os integra às APIs internas da plataforma.

Regra crítica de agrupamento

O processamento de um lote só inicia quando os 4 arquivos estão presentes e com o mesmo timestamp no nome. Sem descontos na venda? Envie DESCONTOS_ apenas com o cabeçalho.

Regras gerais¶

Formato do arquivo¶

Regra	Especificação
Extensão	`.csv` (obrigatório)
Encoding	UTF-8
Delimitador	Barra vertical `\\|` (pipe)
Aspas	Não usar aspas simples ou duplas
Cabeçalho	Obrigatório na primeira linha
Linhas vazias	Não permitidas no meio do arquivo

Nomenclatura¶

O nome segue o padrão PREFIXO_TIMESTAMP.csv, onde PREFIXO é o tipo do arquivo e TIMESTAMP tem 14 dígitos no formato YYYYMMDDHHmmss.

VENDA_20260713143022.csv
ITEM_20260713143022.csv
PAGAMENTO_20260713143022.csv
DESCONTOS_20260713143022.csv

Mesmo lote = mesmo timestamp

Os 4 arquivos de um mesmo lote devem compartilhar exatamente o mesmo timestamp no nome.

Exemplos inválidos de nomenclatura:

Inválido	Motivo
`venda_2026...csv`	Prefixo em minúsculo
`VENDA_2026071314.csv`	Timestamp com 10 dígitos (deve ter 14)
`VENDA_...143022_v2.csv`	Sufixo extra
`VENDA_...143022.txt`	Extensão errada
`VENDAS_...csv`	Prefixo errado
`20260713_VENDA.csv`	Ordem invertida

Valores numéricos¶

Tipo	Formato	Válido	Inválido
Monetários	Ponto decimal	`29.99000000`	`29,99`
Quantidades	Ponto decimal	`2.00000000`	`2,00000000`
Inteiros	Sem separador de milhar	`1000`	`1.000`

Casas decimais

Padronizar valores e quantidades em 8 casas decimais (ex: 29.99000000). O sistema aceita qualquer número dentro desse formato.

Datas¶

Formato	Exemplo
`yyyy-MM-dd HH:mm:ss`	`2026-07-13 14:30:22`
`yyyy-MM-dd'T'HH:mm:ss`	`2026-07-13T14:30:22`

Timezone

Fuso horário: America/Sao_Paulo (UTC-3). Quando não houver hora, usar 00:00:00.

CPF e CNPJ¶

Campo	Regra
CPF	11 dígitos. Ex: `12345678901`
CNPJ	14 dígitos. Ex: `12345678000199`

Venda não identificada

Quando não houver identificação do cliente, informar cpfcnpj = 00000000000.

Validação de colunas e campos opcionais¶

Cada arquivo tem um número fixo de colunas. Linhas com contagem incorreta de colunas são rejeitadas individualmente (não invalidam o arquivo inteiro).
Campos opcionais podem vir vazios — a coluna precisa existir, apenas sem valor: valor1||valor3|valor4.
Um campo obrigatório vazio não causa rejeição por si só; a validação é por contagem de colunas.

Arquivo de Venda — `VENDA_`¶

Prefixo: VENDA_ · Colunas: 10

#	Coluna	Tipo	Obrigatório	Descrição
1	`idVenda`	Texto	Sim	Identificador único da venda
2	`operador`	Texto	Sim	Código do operador/caixa
3	`codigoexternoloja`	Texto	Sim	Código externo da loja
4	`data`	Data/Hora	Sim	Data/hora (`yyyy-MM-dd HH:mm:ss`)
5	`numerocupom`	Inteiro	Sim	Número do cupom fiscal
6	`pdv`	Texto	Sim	Código do PDV
7	`cpfcnpj`	Texto	Não	CPF/CNPJ. Não identificada: `00000000000`
8	`codigoorigemvenda`	Texto	Não	Código de origem
9	`valor`	Decimal	Sim	Valor líquido total
10	`valordesconto`	Decimal	Não	Desconto. Vazio = `0`

Exemplo¶

20260713000110001111|1|1|2026-07-13 14:30:22|100001|1|12345678901|1|150.00000000|0.00000000

Arquivo de Itens — `ITEM_`¶

Prefixo: ITEM_ · Colunas: 6

#	Coluna	Tipo	Obrigatório	Descrição
1	`idVenda`	Texto	Sim	Referência ao `VENDA_`
2	`codigoproduto`	Texto	Sim	Código de barras ou interno
3	`descricao`	Texto	Sim	Descrição do produto
4	`quantidade`	Decimal	Sim	Quantidade (ex: `2.00000000`)
5	`valorunitario`	Decimal	Sim	Valor unitário líquido
6	`valordesconto`	Decimal	Não	Desconto. Vazio = `0`

Exemplo¶

20260713000110001111|1000001|Produto A|2.00000000|50.00000000|0.00000000

Arquivo de Pagamentos — `PAGAMENTO_`¶

Prefixo: PAGAMENTO_ · Colunas: 4

#	Coluna	Tipo	Obrigatório	Descrição
1	`idVenda`	Texto	Sim	Referência ao `VENDA_`
2	`codigoformapagamento`	Texto	Sim	Código da forma de pagamento
3	`valor`	Decimal	Sim	Valor líquido pago
4	`codigobin`	Texto	Não	BIN do cartão (6 dígitos)

Exemplo¶

20260713000110001111|1|150.00000000|412345

Arquivo de Descontos — `DESCONTOS_`¶

Prefixo: DESCONTOS_ · Colunas: 5

#	Coluna	Tipo	Obrigatório	Descrição
1	`idVenda`	Texto	Sim	Referência ao `VENDA_`
2	`idDesconto`	Inteiro	Sim	ID do desconto
3	`Status`	Texto	Sim	Status (ex: `UTILIZADO`)
4	`codigobarra`	Texto	Sim	Código de barras do cupom
5	`quantidade`	Decimal	Sim	Quantidade (ex: `1.00000000`)

Exemplo¶

20260713000110001111|101|UTILIZADO|1000001|1.00000000

Regras de agrupamento¶

Os 4 tipos de arquivo são interdependentes e devem ser enviados com o mesmo timestamp:

Arquivo	Obrigatório
`VENDA_{ts}.csv`	Sim
`ITEM_{ts}.csv`	Sim
`PAGAMENTO_{ts}.csv`	Sim
`DESCONTOS_{ts}.csv`	Sim

Regra crítica

O processamento só inicia com todos os 4 arquivos presentes.

Venda sem descontos

Se não houver descontos, envie o DESCONTOS_ apenas com o cabeçalho (sem linhas de dados).

Consistência de dados¶

Recomendações

As regras abaixo são recomendações. O sistema não rejeita dados inconsistentes na importação — mas a inconsistência pode gerar dados incorretos na plataforma.

Recomendação	Descrição
`idVenda`	Deve existir no `VENDA_` do mesmo timestamp.
Valor	`valor` da venda = soma de (`quantidade` × `valorunitario`) dos itens.
Pagamentos	Soma dos pagamentos = `valor` do `VENDA_`.

Unicidade: cada idVenda deve ser único e não repetir entre envios.
Reprocessamento: a idempotência é por nome do arquivo. Para correções, envie um novo timestamp.

Tratamento de erros¶

Situação	Comportamento
Prefixo desconhecido	Arquivo não processado
Colunas incorretas	Linha rejeitada
Valor inválido	Linha rejeitada
Data inválida	Linha rejeitada
Arquivo corrompido	Não processado

Relatório de rejeições

Consulte o suporte Rock Conecta para obter o relatório de rejeições de um envio.

Checklist de validação¶

[ ] Extensão .csv
[ ] Nome no padrão PREFIXO_YYYYMMDDHHmmss.csv
[ ] Encoding UTF-8
[ ] Delimitador pipe |
[ ] Sem aspas
[ ] Cabeçalho na 1ª linha
[ ] Colunas corretas (conforme cada tipo)
[ ] Valores com ponto decimal
[ ] CPF/CNPJ apenas com dígitos
[ ] Datas no formato yyyy-MM-dd HH:mm:ss
[ ] 4 arquivos com o mesmo timestamp
[ ] Soma dos itens = valor da venda
[ ] Soma dos pagamentos = valor da venda
[ ] Sem linhas vazias

Resumo dos prefixos¶

Prefixo	Colunas	Descrição
`VENDA_`	10	Dados da venda
`ITEM_`	6	Itens da venda
`PAGAMENTO_`	4	Pagamentos
`DESCONTOS_`	5	Descontos

Carga de Vendas — v2¶

Regras gerais¶

Formato do arquivo¶

Nomenclatura¶

Valores numéricos¶

Datas¶

CPF e CNPJ¶

Validação de colunas e campos opcionais¶

Arquivo de Venda — VENDA_¶

Exemplo¶

Arquivo de Itens — ITEM_¶

Exemplo¶

Arquivo de Pagamentos — PAGAMENTO_¶

Exemplo¶

Arquivo de Descontos — DESCONTOS_¶

Exemplo¶

Regras de agrupamento¶

Consistência de dados¶

Tratamento de erros¶

Checklist de validação¶

Resumo dos prefixos¶

Arquivo de Venda — `VENDA_`¶

Arquivo de Itens — `ITEM_`¶

Arquivo de Pagamentos — `PAGAMENTO_`¶

Arquivo de Descontos — `DESCONTOS_`¶