Informações utilizadas para gerar os relatórios de clientes

A tabela reports_tables_customer armazena o cadastro de clientes usado no relatório de clientes da plataforma: nome, telefone, e-mail, documentos, endereço, responsável e campos personalizados. Cada linha é um cliente, identificado por id. Com dados atualizados em H-1 (de hora em hora).

Exemplo

Um cliente cadastrado com telefone, responsável e dois campos personalizados fica assim:

• id = abc123, phone_country_code = 55, phone_area_code = 11 e created_at com a data do cadastro.

• accept_marketing = true: o cliente aceita receber mensagens de marketing.

• sales_person_id e sales_person_username indicam o usuário responsável pelo cliente.

• custom_fields = [{label: "Curso de interesse", value: "Administração"}, {label: "Unidade", value: "Centro"}].

custom_fields é uma lista de pares label e value, um para cada campo personalizado preenchido. Para ter um campo por linha, use explode (ex.: SELECT id, cf.label, cf.value FROM reports_tables_customer LATERAL VIEW explode(custom_fields) t AS cf).

A maior parte dos campos é opcional e vem vazia quando não foi preenchida, como CPF, e-mail e endereço. accept_marketing pode vir true, false ou vazio. leadSource vem sempre vazio. birth_date é texto com data e hora: use só a data (ex.: left(birth_date, 10)).

Atenção: Os registros desta tabela utilizam o fuso horário UTC, ou seja, para que as datas sejam referentes ao fuso horário brasileiro, é preciso inserir nas queries o fuso horário brasileiro.

SET TIME ZONE '-3:00';

select cus.address_state as uf

,count(cus.id) as qtd

from reports_tables_customer as cus

where cus.created_at >= '2025-06-01'

and cus.address_state is not null

and len(cus.address_state) = 2

group by all

order by qtd desc

;

Dicionário de dados

Variável	Tipo	Descrição	Obs
accept_marketing	boolean	Indica se o cliente aceita disparo de mensagem de marketing
address_complement	string	Complemento do endereço cadastrado do cliente
address_number	string	Número do endereço do cliente
address_state	string	UF cadastrado do cliente
address_street_name	string	Nome da rua cadastrada do cliente
birth_date	string	Data de nascimento do cliente
business_document	string	CNPJ da empresa informado
business_name	string	Nome da empresa informado
city	string	Cidade do endereço do cliente
country	string	País cadastrado para o endereço do cliente
cpf	string	Número do CPF cadastrado do cliente
created_at	timestamp	Data de cadastro do cliente
custom_fields	array	Campos personalizados do cliente: lista de itens com label (nome do campo) e value (valor)
email	string	E-mail do cliente do atendimento
id	string	Código identificador do cliente	Chave primária
last_name	string	Último sobrenome do cliente
leadSource	string	Canal de origem que o lead chegou no momento do cadastro	NULL
name	string	Nome do cliente
phone_area_code	string	Código de área (DDD) do telefone do cliente
phone_country_code	string	Código do país do telefone do cliente
phone_number	string	Número de telefone do cliente que gerou o pedido
retailer_id	string	Código identificador da loja. Em contas com mais de uma loja, separa os registros de cada uma	Chave estrangeira para a tabela dim_retailer
sales_person_id	string	Código identificador do usuário que efetuou o atendimento	Chave estrangeira para a tabela dim_user
sales_person_username	string	Nome de usuário do responsável pelo atendimento deste cliente
suburb	string	Nome do bairro cadastrado para o endereço do cliente
zip	string	CEP cadastrado no endereço do cliente