Ir para o conteúdo

Carga de Vendas — v1

Esta página especifica o layout v1 dos arquivos de carga de vendas.

Layout v1

Esta é a versão original do layout. Ela continua válida. Para o novo padrão Rock Conecta (4 arquivos, nomenclatura por timestamp, UTF-8 e 8 casas decimais), consulte a especificação v2.

A carga de vendas é composta por 3 arquivos distintos que se relacionam entre si através do campo idvenda, um código único usado para agrupar cada venda com seus respectivos itens e pagamentos:

  • Venda — dados gerais da venda (documentado abaixo).
  • Itens da Venda — produtos que compõem cada venda.
  • Pagamentos da Venda — formas de pagamento de cada venda (documentado abaixo).

Os três arquivos devem ser enviados obrigatoriamente, seguindo a documentação de cada um.

Arquivo de Itens da Venda

A documentação de Itens da Venda ainda não foi incorporada a este portal. Assim que o layout for disponibilizado, esta página será atualizada.

Definições gerais

  • Os arquivos devem ser gerados no formato .CSV.
  • O caractere delimitador deve ser a barra vertical (|).
  • Os campos devem seguir a ordem de definição especificada para cada arquivo.
  • Os arquivos devem ser fornecidos separados por mês — cada mês tem seus próprios arquivos, seguindo as nomenclaturas especificadas.
  • Todos os campos de valores e quantidades devem ter as casas decimais separadas por ponto, com até 4 casas decimais.

Formato de valores

  • 1000.1000 → mil reais e dez centavos
  • 850.4500 → oitocentos e cinquenta reais e quarenta e cinco centavos

Origem da venda

A origem da venda apenas será registrada caso já esteja pré-cadastrada no sistema. Antes da carga, é necessário que algumas entidades já estejam registradas para que a carga seja realizada completamente — esses arquivos base devem ser enviados uma única vez.

Arquivo de Venda

Dados gerais de cada venda.

  • Nome do arquivo: VENDA_{{ANO}}_{{MES}}.csv — o ano e o mês correspondem ao período das vendas presentes no arquivo.
  • Exemplo: VENDA_2023_07.csv

Definição dos campos

A ordem das colunas abaixo é a ordem exata em que os campos devem aparecer no arquivo.

# Nome Detalhe Tipo Tamanho Obrigatório
1 idvenda Código único da venda do varejista, ou a combinação de Data (yyyyMMdd) + Loja + PDV + Número do Cupom. String 50 Sim
2 operador Código do operador do PDV. String 50 Sim
3 codigoexternoloja Código externo da loja. String 30 Sim
4 data Data/hora da realização da venda. Formato: YYYY-MM-DD HH:mm:ss. Timestamp — Sim
5 numerocupom Número do cupom da venda. Numeric 19 Sim
6 pdv Código do PDV. Numeric 18 Sim
7 cpfcnpj CPF ou CNPJ do cliente. Caso não haja identificação do cliente, informar o valor 00000000000. String 14 Sim
8 codigoorigemvenda Código externo da origem da venda. String 50 Não
9 valor Valor total da venda, sendo a soma da multiplicação dos itens por suas quantidades. Decimal Até 4 casas decimais Sim

Exemplo de arquivo

20230701LOJA01PDV05000123|OP007|LOJA01|2023-07-01 14:32:10|123|5|00000000000|ORIG01|150.9000
20230701LOJA01PDV05000124|OP007|LOJA01|2023-07-01 14:35:22|124|5|12345678900|ORIG01|89.5000

Arquivo de Pagamentos da Venda

Formas de pagamento de cada venda.

  • Nome do arquivo: PAGAMENTO_{{ANO}}_{{MES}}.csv — o ano e o mês correspondem ao período das vendas presentes no arquivo.
  • Exemplo: PAGAMENTO_2023_07.csv

Definição dos campos

A ordem das colunas abaixo é a ordem exata em que os campos devem aparecer no arquivo.

# Nome Detalhe Tipo Tamanho Obrigatório
1 idvenda Código único da venda do varejista, ou a combinação de Data (yyyyMMdd) + Loja + PDV + Número do Cupom. Deve corresponder ao idvenda do arquivo de Venda. String 50 Sim
2 codigoformapagamento Código externo da forma de pagamento. String 50 Sim
3 valor Valor do pagamento. Decimal Até 4 casas decimais Sim

Exemplo de arquivo

20230701LOJA01PDV05000123|PIX|150.9000
20230701LOJA01PDV05000124|CARTAO_CREDITO|89.5000