Data Lake: Visão analítica e estrutura dos arquivos no formato Parquet por entidade

Este artigo apresenta a visão de Vendas, Estoque e Engajamento, explicando como os dados são organizados por visão, entidade, além de como são disponibilizados em arquivos no formato Parquet e XML para análise de faturamento, canais, meios de pagamento, produtos, descontos, taxas, acréscimos, cancelamentos, fiscal, engajamento. posição do estoque e financeiro. Contém detalhamento dos campos e formatos técnicos para integração e exploração dos dados.

Para saber como consultar os arquivos do Data Lake SW, siga as orientações da documentação da API através deste documento.

Estrutura geral

No Data Lake SW, os dados são estruturados por visão e segmentado por múltiplas entidades:

Visão	Entidade	Descrição
Vendas	`venda_movimento`	Cabeçalho da venda, reunindo dados gerais
	`venda_produto`	Itens de produtos vendidos
	`venda_pagamento`	Meios de pagamento utilizados, como dinheiro, cartão, voucher e Pix
	`venda_desconto`	Descontos aplicados, como combos, cupons e convênios (descontos cadastrados)
	`venda_acrescimo`	Acréscimos aplicados, como taxa de entrega, taxa de serviço e repiques
	`venda_cancelamento`	Informações sobre vendas canceladas e seus motivos
	`venda_fiscal`	Arquivos XML dos documentos fiscais emitidos pela SEFAZ
Estoque	`estoque_produto`	Posição do estoque
Estoque	`saida_produto`	Saídas de estoque e seus motivos
Engajamento	`engajamento_cupomdesconto`	Cupons de desconto aplicados nas vendas
Produção	`producao_tempopreparo`	Informações sobre o tempo de preparo
Financeiro	`financeiro_dre`	Demonstrativo do Resultado do Exercício (DRE)

Os registros de vendas são identificados por uma chave composta, formada pelos campos codigoloja + venda, permitindo a reconstrução de uma venda completa.

Detalhamento das entidades

Cada entidade representa uma dimensão específica das informações registradas, permitindo análises detalhadas:

Vendas

venda_movimento

Contém os dados consolidados de cada venda, como data, operador, valores totais e tipos de acréscimos e descontos. Ideal para análises gerais de faturamento, consumo, entregas e formas de pagamento.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
venda	STRING		Identificador único da venda na loja.
nrabertura	INT		Número da abertura de caixa.
pdv	INT		Código do ponto de venda (PDV) utilizado.
pdvnome	STRING		Nome do ponto de venda (PDV).
emissor	STRING	NFC-e	Tipo de documento fiscal emitido.
emissor_serie	INT		Código da série utilizada na emissão da nota fiscal.
emissor_numero	INT		Número sequencial da nota fiscal emitida.
emissor_chave	STRING		Código único de identificação da nota fiscal.
emissor_status	STRING	Autorizada Pendente	Status atual da nota fiscal.
setor	STRING	Balcão Entrega Mesa Cartão	Modo de operação em que ocorreu a venda.
aplicativo	STRING	Swfast Now iFood	Nome do sistema ou aplicativo em que a venda foi registrada.
idiomaaplicativo	STRING	Português Inglês Espanhol	Idioma utilizado no aplicativo.
tipoentrega	STRING	Despachar Retirar	Modo de entrega selecionado na venda.
tipoconsumo	STRING	Comer aqui Levar	Forma de consumo no local ou para viagem.
operador	STRING		Nome do operador de caixa.
nrcupom	INT		Número de identificação do cupom fiscal.
nrmesa	INT		Número da mesa, se houver.
idpedidoexterno	STRING		Código de identificação do pedido em aplicativos.
merchantpedidoexterno	STRING		Identificação da loja (marca delivery) os aplicativos parceiros.
qtdpessoas	INT		Quantidade de pessoas atendidas na venda.
qtdvendas	INT		Quantidade de vendas nesse registro.
data	DATE		Dia da venda com base na data de abertura do caixa. (Pode ser diferente de datatransacao e datahoratransacao).
datatransacao	DATE		Data em que a venda aconteceu, considerando o momento exato da operação.
datahoratransacao	STRING		Data e hora em que a venda aconteceu, considerando o momento exato da operação.
horatransacao	STRING		Hora da venda.
datadiasemana	STRING	1.Domingo 2.Segunda 3.Terça-feira 4.Quarta-feira 5.Quinta-feira 6.Sexta-feira 7.Sábado	Dia da semana da venda.
entregador	STRING		Nome do entregador, se houver.
qtdprodutos	FLOAT		Quantidade de produtos.
qtdpagamentos	INT		Quantidade de formas de pagamento utilizadas.
qtdcombos	INT		Quantidade de combos aplicados na venda.
valorprodutos	FLOAT		Valor bruto total dos produtos na venda.
valorrepiques	FLOAT		Valor de repique aplicado, se houver.
valortaxaservicos	FLOAT		Valor de taxa de serviço aplicada, se houver
valortaxaentregas	FLOAT		Valor da taxa de entrega aplicada, se houver.
valorcreditos	FLOAT		Valor de crédito (Assinadas) adicionado ao cliente.
valordescontos	FLOAT		Valor de desconto do tipo Convênio aplicado.
valorcombos	FLOAT		Valor de desconto do tipo Combo aplicado.
valorespeciais	FLOAT		Valor descontado da venda por itens especiais removidos.
valorassinadas	FLOAT		Valor debitado (Assinadas) do cliente.
valorcortesias	FLOAT		Valor de produtos oferecidos como cortesia.
valorfaturamento	FLOAT		Soma dos produtos, repiques, taxas de serviço/entrega e créditos (assinadas). Desconsidera descontos, combos, especiais e cortesias.
valortotal	FLOAT		Mesmo cálculo do faturamento.
valordiferenca	FLOAT		Diferença entre o total registrado e o valor de faturamento.
royaltyimpostoestimado	FLOAT		Percentual médio estimado do imposto a ser abatido dos royalties pagos à franquia.

venda_produto

Produtos vendidos por item, com detalhamento de grupo, subgrupo, promoção, quantidade, valor e regra de preço. Útil para identificar o desempenho de produtos.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
source_db	STRING		Uso interno SW.
partition_date	DATE		Uso interno SW.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
produto	STRING		Nome do produto no sistema SW.
produto_origemetapa	STRING		Nome do produto original ou promoção, caso o item esteja vinculado a uma etapa, promoção ou seja um adicional de outro produto.
grupo	STRING		Grupo em que o produto faz parte.
subgrupo	STRING		Subgrupo em que o produto faz parte.
unidademedida	STRING		Unidade de medida do produto.
fatorcompra	FLOAT		Fator de compra do produto.
unidademedidacompra	STRING		Unidade de medida de compra do produto.
venda	STRING		Identificador único da venda na loja.
nrabertura	INT		Número da abertura de caixa.
pdv	INT		Código do ponto de venda (PDV) utilizado.
pdvnome	STRING		Nome do ponto de venda (PDV).
emissor	STRING	NFC-e	Tipo de documento fiscal emitido.
setor	STRING	Balcão Entrega Mesa Cartão	Modo de operação em que ocorreu a venda.
aplicativo	STRING	Swfast Now iFood	Sistema ou aplicativo em que a venda foi registrada.
tipoentrega	STRING	Despachar Retirada	Modo de entrega selecionado na venda.
tipoconsumo	STRING	Comer aqui Levar	Forma de consumo no local ou para viagem.
operador	STRING		Nome do operador de caixa.
nrcupom	INT		Número de identificação do cupom fiscal.
nrmesa	INT		Número da mesa, se houver.
qtdpessoas	INT		Quantidade de pessoas informadas na venda.
nritem	INT		Ordem do item no cupom.
data	DATE		Dia da venda.
datatransacao	DATE		Data da venda.
datahoratransacao	STRING		Data e hora da venda.
horatransacao	STRING		Hora da venda.
datadiasemana	STRING	1.Domingo 2.Segunda 3.Terça-feira 4.Quarta-feira 5.Quinta-feira 6.Sexta-feira 7.Sábado	Dia da semana da venda.
atendente	STRING		Funcionário responsável pelo atendimento, se houver.
entregador	STRING		Nome do entregador, se houver.
codigoproduto	INT		Código do produto no sistema SW.
codigoproduto_origemetapa	INT		Código do produto original se estiver dentro de uma etapa.
promocao	STRING		Nome da promoção do produto, se houver.
qtdprodutos	FLOAT		Quantidade de produtos.
valorproduto	FLOAT		Valor bruto total do produto na venda.
regrapreco	STRING		Nome da regra de preço aplicada ao produto, se houver.
classificacaoroyalty	STRING		Classificação do produto usada no cálculo de royalty para a franquia.
codigoclassificacaoroyalty	INT		Código da classificação usada no cálculo de royalty para a franquia.

venda_pagamento

Registra os meios de pagamento utilizados em cada venda, com informações como valor pago, forma de pagamento, NSU, código de autorização e integração com apps. Essencial para conciliação financeira e análise de preferências de pagamento.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
formapagamento	STRING		Nome da forma de pagamento.
venda	STRING		Identificador único da venda na loja.
nrabertura	INT		Número da abertura de caixa.
pdv	INT		Código do ponto de venda (PDV) utilizado.
pdvnome	STRING		Nome do ponto de venda (PDV).
emissor	STRING	NFC-e	Tipo de documento fiscal emitido.
setor	STRING	Balcão Entrega Mesa Cartão	Modo de operação em que ocorreu a venda.
aplicativo	STRING	Swfast Now iFood	Sistema ou aplicativo em que a venda foi registrada.
idiomaaplicativo	STRING	Português Inglês Espanhol	Idioma utilizado no aplicativo.
tipoentrega	STRING	Despachar Retirar	Modo de entrega selecionado na venda.
tipoconsumo	STRING	Comer aqui Levar	Forma de consumo no local ou para viagem.
operador	STRING		Nome do operador de caixa.
nrcupom	INT		Número de identificação do cupom fiscal.
nrmesa	INT		Número da mesa, se houver.
idpedidoexterno	STRING		Código de identificação do pedido em aplicativos.
qtdpessoas	INT		Quantidade de pessoas informadas na venda.
data	DATE		Dia da venda.
datatransacao	DATE		Data da venda.
datahoratransacao	STRING		Data e hora da venda.
horatransacao	STRING		Hora da venda.
datadiasemana	STRING	1.Domingo 2.Segunda 3.Terça-feira 4.Quarta-feira 5.Quinta-feira 6.Sexta-feira 7.Sábado	Dia da semana da venda.
entregador	STRING		Nome do entregador, se houver.
codigoformapagamento	INT		Código da forma de pagamento.
valorpagamento	FLOAT		Valor pago com a forma de pagamento.
nsu	STRING		Número Sequencial Único da transação (usado para conciliação de cartões).
codigoautorizacao	STRING		Código de autorização da transação fornecido pela operadora.
bandeira	STRING		Bandeira utilizada no pagamento.
modalidade	STRING		Modalidade do pagamento eletrônico.
tef	STRING	Sim Não	Indica se a transação utilizou TEF.

venda_desconto

Contém os descontos aplicados na venda, seja por combos ou convênios. Inclui operador que aplicou o desconto, motivo, tipo e valores. Importante para avaliar o impacto de ações promocionais com combos e convênios.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
source_db	STRING		Uso interno SW.
partition_date	DATE		Uso interno SW.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
desconto	STRING		Nome do desconto aplicado.
venda	STRING		Identificador único da venda na loja.
nrabertura	INT		Número da abertura de caixa.
pdv	INT		Código do ponto de venda (PDV) utilizado.
pdvnome	STRING		Nome do ponto de venda (PDV).
emissor	STRING	NFC-e	Tipo de documento fiscal emitido.
setor	STRING	Balcão Entrega Mesa Cartão	Modo de operação em que ocorreu a venda.
aplicativo	STRING	Swfast Now iFood	Sistema ou aplicativo em que a venda foi registrada.
tipoentrega	STRING	Despachar Retirar	Modo de entrega selecionado na venda.
tipoconsumo	STRING	Comer aqui Levar	Forma de consumo no local ou para viagem.
operador	STRING		Nome do operador de caixa.
nrcupom	INT		Número de identificação do cupom fiscal.
nrmesa	INT		Número da mesa, se houver.
qtdpessoas	INT		Quantidade de pessoas atendidas na venda.
data	DATE		Dia da venda.
datatransacao	DATE		Data da venda.
datahoratransacao	STRING		Data e hora da venda.
horatransacao	STRING		Hora da venda.
datadiasemana	STRING	1.Domingo 2.Segunda 3.Terça-feira 4.Quarta-feira 5.Quinta-feira 6.Sexta-feira 7.Sábado	Dia da semana da venda.
operadordesconto	STRING		Operador que aplicou o desconto.
tipodesconto	STRING	Combos Convênios	Tipo de desconto aplicado na venda.
motivo	STRING		Motivo do desconto quando o tipo for Convênio.
codigoconvenio	INT		Código do convênio aplicado.
codigocombo	INT		Código do combo aplicado.
qtddescontos	FLOAT		Número de descontos aplicados.
valordesconto	FLOAT		Valor total dos descontos aplicados.
qtdprodutos	FLOAT		Quantidade de produtos.
valorprodutos	FLOAT		Valor bruto total dos produtos na venda.

venda_acrescimo

Exibe os acréscimos aplicados nas vendas, como taxas de entrega ou serviço. Informa o tipo, a quantidade e o valor total dos acréscimos. Ideal para análise das taxas de entrega, taxa de serviço e repiques.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
source_db	STRING		Uso interno SW.
partition_date	DATE		Uso interno SW.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
venda	STRING		Identificador único da venda na loja.
nrabertura	INT		Número da abertura de caixa.
pdv	INT		Código do ponto de venda (PDV) utilizado.
pdvnome	STRING		Nome do ponto de venda (PDV).
emissor	STRING	NFC-e	Tipo de documento fiscal emitido.
setor	STRING	Balcão Entrega Mesa Cartão	Modo de operação em que ocorreu a venda.
aplicativo	STRING	Swfast Now IFood	Nome do sistema ou aplicativo em que a venda foi registrada.
tipoentrega	STRING	Despachar Retirar	Modo de entrega selecionado na venda.
tipoconsumo	STRING	Comer aqui Levar	Forma de consumo no local ou para viagem.
operador	STRING		Nome do operador de caixa.
nrcupom	INT		Número de identificação do cupom fiscal.
nrmesa	INT		Número da mesa, se houver.
qtdpessoas	INT		Quantidade de pessoas atendidas na venda.
data	DATE		Dia da venda.
datatransacao	DATE		Data da venda.
datahoratransacao	STRING		Data e hora da venda.
horatransacao	STRING		Hora da venda.
datadiasemana	STRING	1.Domingo 2.Segunda 3.Terça-feira 4.Quarta-feira 5.Quinta-feira 6.Sexta-feira 7.Sábado	Dia da semana da venda.
atendente	STRING		Funcionário responsável pelo atendimento, se houver.
tipotaxa	STRING	Entrega Serviço	Tipo de acréscimo aplicado na venda.
qtdtaxas	INT		Número de taxas aplicadas.
valortaxa	FLOAT		Valor total das taxas aplicadas.

venda_cancelamento

Contém os cancelamentos de vendas ou produtos, permitindo identificar o que foi cancelado, por qual motivo, quando e por qual operador. É útil para identificar possíveis erros ocorridos durante o lançamento das vendas e analisar os motivos de cancelamento.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
source_db	STRING		Uso interno SW.
partition_date	DATE		Uso interno SW.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
produto	STRING		Nome do produto no sistema SW.
venda	STRING		Identificador único da venda na loja.
nrabertura	INT		Número da abertura de caixa.
pdv	INT		Código do ponto de venda (PDV) utilizado.
pdvnome	STRING		Nome do ponto de venda (PDV).
emissor	STRING	NFC-e	Tipo de documento fiscal emitido.
setor	STRING	Balcão Entrega Mesa Cartão	Modo de operação em que ocorreu a venda.
aplicativo	STRING	Swfast Now iFood	Sistema ou aplicativo em que a venda foi registrada.
tipoentrega	STRING	Despachar Retirada	Modo de entrega selecionado na venda.
tipoconsumo	STRING	Comer aqui Levar	Forma de consumo no local ou para viagem.
operador	STRING		Nome do operador de caixa.
nrcupom	INT		Número de identificação do cupom fiscal.
nrmesa	INT		Número da mesa, se houver.
qtdpessoas	INT		Quantidade de pessoas informadas na venda.
nritem	INT		Ordem do item no cupom.
data	DATE		Dia da venda.
datatransacao	DATE		Data da venda.
datahoratransacao	STRING		Data e hora da venda.
horatransacao	STRING		Hora da venda.
datadiasemana	STRING	1.Domingo 2.Segunda 3.Terça-feira 4.Quarta-feira 5.Quinta-feira 6.Sexta-feira 7.Sábado	Dia da semana da venda.
atendente	STRING		Funcionário responsável pelo atendimento, se houver.
nrnf	STRING		Numeração da nota fiscal (quando o emissor for NFC-e).
tipocancelamento	STRING	Total Item	Tipo de cancelamento, sendo da venda ou do produto.
operadorcancelamento	STRING		Nome do operador que registrou o cancelamento.
datahoracancelamento	STRING		Data e hora em que o cancelamento foi registrado.
motivocancelamento	STRING		Motivo do cancelamento informado no sistema.
codigoproduto	INT		Código do produto no sistema SW.
qtdprodutos	FLOAT		Quantidade de produtos.
valorproduto	FLOAT		Valor bruto total do produto na venda.

venda_fiscal

Contém os arquivos XML dos documentos fiscais emitidos pela SEFAZ.

Diferente das demais entidades, os documentos fiscais não são disponibilizados em formato Parquet. Os arquivos são organizados por data e loja, e disponibilizados em um arquivo compactado (.zip) contendo os XMLs das notas fiscais emitidas e canceladas.

Estrutura dos arquivos:

📦 venda_fiscal_<código da loja>_<data>.zip
└── 📁 <emissor>
└── 📁 <série>
├── 📄 <número da nota fiscal>-emissao.xml
└── 📄 <número da nota fiscal>-cancelamento.xml

Dica: A data é exibida no formato AAAAMMDD (ano, mês e dia).

Estoque

estoque_produto

Contém a posição de estoque dos produtos com base nas movimentações diárias, como entradas, saídas, produção e inventário, exibindo a quantidade final disponível.

Nome	Tipo	Descrição
id	STRING	Código de identificação do registro na entidade.
update_date	DATE	Data em que o registro foi atualizado.
source_db	STRING	Uso interno SW.
partition_date	DATE	Uso interno SW.
codigoloja_rede	INT	Código de identificação da loja na rede/franquia.
redeloja	STRING	Nome da rede/franquia da loja.
codigo_loja	INT	Uso interno SW.
codigoloja	INT	Código de identificação da loja no sistema SW.
loja	STRING	Nome da loja cadastrado no sistema SW.
uf	STRING	Sigla do estado da loja.
cidade	STRING	Cidade onde está localizada a loja.
grupo	STRING	Grupo em que o produto faz parte.
subgrupo	STRING	Subgrupo em que o produto faz parte.
codigoproduto	INT	Código do produto no sistema SW.
produto	STRING	Nome do produto no sistema SW.
fatorcompra	FLOAT	Fator de compra do produto.
unidade_venda	STRING	Unidade de medida de venda do produto.
unidade_compra	STRING	Unidade de medida de compra do produto.
vendivel	STRING	Indica se o produto pode ser vendido.
insumosagregados	STRING	Indica se o produto possui insumos agregados.
processado	STRING	Indica se o produto é processado (Produção de Produtos).
composto	STRING	Indica se o produto é composto por ingredientes.
data	DATE	Data da movimentação de estoque.
qtdinicial	FLOAT	Quantidade em estoque no início do dia, correspondente ao estoque final do dia anterior.
qtdcompra	FLOAT	Quantidade comprada do produto (entrada de nota).
qtdproducao	FLOAT	Quantidade produzida do produto (produção de produtos).
qtdvenda	FLOAT	Quantidade vendida do produto.
qtdinsumo	FLOAT	Quantidade utilizada como insumo agregado em outros produtos.
qtdsaida	FLOAT	Saída manual de estoque do produto, sem relação com a venda.
qtdprevisto	FLOAT	Estoque previsto, calculado como (qtdinicial+ qtdcompra + qtdproducao) – (qtdvenda+ qtdinsumo+ qtdsaida).
qtdinventario	FLOAT	Diferença entre a quantidade prevista (qtdprevisto) e a contada em inventário, se houver.
qtddiferenca	FLOAT	Diferença entre a quantidade final em estoque (qtdfinal) e a quantidade prevista (qtdprevisto).
qtdfinal	FLOAT	Quantidade consolidada em estoque ao final do dia.
valorcustounitario	FLOAT	Custo unitário de compra do produto.
valorvendaunitario	FLOAT	Preço unitário de venda do produto.

saida_produto

Registra movimentações de saída de estoque feitas através da funcionalidade de saída de produtos, incluindo a quantidade e o motivo.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
id_change	STRING		Uso interno SW.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
grupo	STRING		Grupo em que o produto faz parte.
subgrupo	STRING		Subgrupo em que o produto faz parte.
codigoproduto	INT		Código do produto no sistema SW.
produto	STRING		Nome do produto no sistema SW.
data	DATE		Data da movimentação de estoque.
hora	STRING		Hora da movimentação de estoque.
datadiasemana	STRING	1.Domingo 2.Segunda 3.Terça-feira 4.Quarta-feira 5.Quinta-feira 6.Sexta-feira 7.Sábado	Dia da semana da movimentação.
motivo	STRING		Motivo informado para a saída de estoque.
quantidade	FLOAT		Quantidade movimentada na saída de estoque.
custo	FLOAT		Custo de compra do produto.

Engajamento

engajamento_cupomdesconto

Exibe os cupons de desconto aplicados nas vendas, detalhando informações da transação e do cliente.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
setor	STRING	Balcão Entrega Mesa Cartão	Modo de operação em que ocorreu a venda.
aplicativo	STRING	Swfast Now iFood	Nome do sistema ou aplicativo em que a venda foi registrada.
cliente	STRING		Nome do cliente.
clientedocumento	STRING		Número do documento do cliente (CNPJ/CPF).
venda	STRING		Identificador único da venda na loja.
data	DATE		Data da venda.
datatransacao	DATE		Data em que a transação aconteceu, considerando o momento exato da operação.
datahoratransacao	STRING		Data e hora em que a transação aconteceu, considerando o momento exato da operação.
horatransacao	STRING		Hora da transação.
cupomnome	STRING		Nome do cupom de desconto utilizado.
cupommensagemproduto	STRING		Mensagem do cupom de desconto utilizado.
quantidadecupom	INT		Quantidade de cupons de desconto utilizados na venda.

Produção

producao_tempopreparo

Informações sobre o tempo de preparo dos produtos, incluindo os horários de início e fim, o produto e a faixa de tempo.

Nome	Tipo	Observações	Descrição
id	STRING		Código de identificação do registro na entidade.
update_date	DATE		Data em que o registro foi atualizado.
codigoloja_rede	INT		Código de identificação da loja na rede/franquia.
redeloja	STRING		Nome da rede/franquia da loja.
codigo_loja	INT		Uso interno SW.
codigoloja	INT		Código de identificação da loja no sistema SW.
loja	STRING		Nome da loja cadastrado no sistema SW.
uf	STRING		Sigla do estado da loja.
cidade	STRING		Cidade onde está localizada a loja.
data	DATE		Data da venda.
hora	STRING		Hora da venda, sem especificar minutos ou segundos.
datahorainicio	STRING		Data e hora de início da produção do item.
datahorafim	STRING		Data e hora de fim da produção do item.
segundos	INT		Tempo de preparo do item, em segundos.
minutos	FLOAT		Tempo de preparo do item, em minutos.
codigoproduto	INT		Código do produto no sistema SW.
produto	STRING		Nome do produto no sistema SW.
faixaindice	INT	1 = 00:01 - 04:00 2 = 04:01 - 08:00 3 = 08:01 - 12:00 4 = 12:01 - 16:00 5 = 16:01 em diante	Código que representa a faixa de tempo de preparo do item.
faixatempo	STRING	00:01 - 04:00 04:01 - 08:00 08:01 - 12:00 12:01 - 16:00 16:01 em diante	Tempo de preparo correspondente à faixa de tempo.

Financeiro

financeiro_dre

Informações sobre o Demonstrativo do Resultado do Exercício (DRE), incluindo o período de referência, grupos, linhas e respectivos valores.

Nome	Tipo	Descrição
id	STRING	Código de identificação do registro na entidade.
update_date	DATE	Data em que o registro foi atualizado.
codigoloja_rede	INT	Código de identificação da loja na rede/franquia.
redeloja	STRING	Nome da rede/franquia da loja.
codigo_loja	INT	Uso interno SW.
codigoloja	INT	Código de identificação da loja no sistema SW.
loja	STRING	Nome da loja cadastrado no sistema SW.
uf	STRING	Sigla do estado da loja.
cidade	STRING	Cidade onde está localizada a loja.
codigorelatorio	INT	Código de identificação do DRE.
relatorio	STRING	Nome do DRE.
ano	INT	Ano de referência do relatório.
mes	INT	Mês de referência do relatório.
periodo	STRING	Período de referência do relatório.
ordemgrupo	INT	Ordem de exibição do subgrupo no relatório.
grupo	STRING	Nome do subgrupo do relatório.
ordemlinha	INT	Ordem de exibição da linha no grupo.
linha	STRING	Nome do subgrupo ou do plano de conta nível 2.
valor	DOUBLE	Valor de acordo com a linha, podendo ser o totalizador do subgrupo ou o valor do plano de conta nível 2.

O DRE possui periodicidade mensal. Para consultar, utilize como referência o dia 1 de cada mês. Dessa forma, o sistema retorna os dados disponíveis referentes ao mês informado.

Ajude-nos a evoluir deixando seu feedback nos comentários e compartilhando sugestões para novos artigos!

Relativo a

Pesquisa

Central de Ajuda SW