Clientes

Um registro de Cliente armazena as informações de contato de um comprador, estatísticas de pedidos, tags e consentimento de marketing.
Com o DataEase você pode:

• Adicionar novos compradores em massa (ótimo para movimentações B2B).
• Atualizar telefones, e-mails, tags ou endereços em milhares de linhas.
• Limpar registros antigos ou mesclar duplicados rapidamente.

Guia de clientes do Shopify aqui.

---

Índice

1. Exportar
2. Importar
3. Referência de campos
4. Filtros

---

2. Exportar

1. Escolha CSV ou Excel.
2. Selecione Cliente como a entidade.
3. Selecione os campos que você precisa - email, tags, addressPhone, etc.
4. Execute e baixe o arquivo. Veja os passos completos no Guia de Exportação.

---

3. Importar

Comandos de cliente (coluna command): CREATE, UPDATE, REPLACE, DELETE, IGNORE
Comandos de linha de endereço (coluna itemCommand): CREATE, UPDATE, MERGE, DELETE, IGNORE

Regras:

• Para CREATE forneça pelo menos email ou phone.
• Cada alteração de endereço, contato ou atualização de tag está em sua própria linha (topRow = FALSE).
• Combine primeiro por id, depois email, depois phone.
• UPDATE ignora células em branco; REPLACE sobrescreve apenas com as colunas presentes.
• A exportação inclui todos os endereços de um cliente (uma linha cada) — não há mais um limite de 250 endereços por cliente.

Passos:

1. Baixe o arquivo de exemplo: Customer-import-sample.xlsx
2. Preencha ou edite as linhas.
3. Mapeie as colunas no DataEase, faça o upload e inicie. Ajuda completa: Guia de Importação.

---

4. Referência de campos

Colunas de controle

• row — Mantém a ordem original das linhas. (Importação & Exportação)

• topRow — TRUE para a linha principal do cliente; FALSE para linhas de endereço. (Importação & Exportação)

Básico (linha principal)

• id — ID do Cliente. Necessário para UPDATE, REPLACE ou DELETE.

• command — CREATE, UPDATE, REPLACE, DELETE, IGNORE.

• email — Email usado para notificações e importação de pedidos.

• firstName — Primeiro nome.

• lastName — Sobrenome.

• phone — Número de telefone (E.164).

• tags — Lista de tags separadas por vírgula. Veja o guia de tags.

• tagsCommand — ADD, REMOVE ou REPLACE tags para este cliente.

• taxExempt — true se o cliente nunca paga imposto.

• taxExemption — Lista de códigos de isenção de impostos. Tabela completa nos documentos de Tax Exemptions.

• locale — Código de idioma preferido (por exemplo, en).

• note — Nota privada.

Consentimento de marketing

• emailMarketingState — ACCEPTED, DECLINED ou PENDING.

• emailMarketingOptInLevel — SINGLE_OPT_IN ou CONFIRMED_OPT_IN.

• emailMarketingConsentUpdatedAt — Última alteração no consentimento de email.

• smsMarketingState — ACCEPTED, DECLINED ou PENDING.

• smsMarketingOptInLevel — CONFIRMED_OPT_IN ou SINGLE_OPT_IN.

• smsMarketingConsentUpdatedAt — Última alteração no consentimento de SMS.

Linhas de endereço (topRow = FALSE)

• itemCommand — CREATE, UPDATE, MERGE, DELETE, IGNORE para este endereço.

• addressId — ID do endereço (necessário para UPDATE, DELETE).

• address1 — Linha 1 do endereço.

• city — Cidade.

• countryCode — Código do país com duas letras.

• provinceCode — Código do estado/província.

• zip — CEP ou código postal.

• defaultAddress — true para tornar este o endereço de envio padrão.

(outros campos de endereço seguem o mesmo padrão e são importáveis)

Opções somente de importação

• checkoutToDraft — TRUE transforma checkouts em pedidos rascunho. (Somente importação)

• editableShippingAddress — Permitir que o cliente edite o endereço de envio. (Somente importação)

• billingSameAsShipping — Copiar envio para faturamento quando TRUE. (Somente importação)

Metafields

• metafields — Campos personalizados extras. Veja o guia de Metafields.

---

5. Filtros

• Id — Exporte um cliente por id.

• Email — Correspondência parcial ou total de email.

• Phone — Correspondência por número de telefone.

• UpdatedAt — Escolha um intervalo de datas de última atualização.

---

Precisa de ajuda? Nossa equipe de suporte responde em até 24 horas.

Campos adicionais

Mais colunas que o DataEase suporta para esta entidade:

• createdAt — Data e hora em que a conta do cliente foi criada.
• numberOfOrders — Número total de pedidos feitos pelo cliente.
• verifiedEmail — Indica se o email do cliente está verificado.
• State — Estado atual da conta do cliente (por exemplo, habilitado, desabilitado).
• MultipassIdentifier — Identificador para clientes usando login Multipass.
• UnsubscribeUrl — URL para o cliente cancelar a inscrição de emails. Vazio para clientes sem endereço de email. O link é gerado pelo Shopify e pode variar entre exportações.
• LifetimeDuration — Duração da vida útil da conta do cliente.
• spentAmount — Valor total gasto pelo cliente.
• LastOrderId — ID do último pedido do cliente.
• LastOrderName — Nome ou número do último pedido do cliente.
• LastOrderProcessedAt — Data e hora em que o último pedido foi processado.
• LastOrderAmount — Valor total do último pedido do cliente.
• LastOrderCurrencyCode — Código da moeda do último pedido do cliente.
• SmsConsentCollectedFrom — Fonte de onde o consentimento de SMS foi coletado.
• address2 — Linha de endereço adicional para o endereço do cliente.
• addressFirstName — Primeiro nome associado ao endereço do cliente.
• addressLastName — Sobrenome associado ao endereço do cliente.
• addressCompanyName — Nome da empresa associado ao endereço do cliente.
• addressPhone — Número de telefone associado ao endereço do cliente.
• province — Província ou estado do endereço do cliente.
• country — País do endereço do cliente.