Ir para o conteúdo

Dados, API e integrações

Formatos de importação e exportação CSV

As colunas exatas para importar clientes, imóveis e saldos iniciais, e para as exportações do quadro de participações e bancárias.

  • Atualizado
  • Para gestores

Regras gerais

  • Os arquivos são valores separados por vírgula em UTF-8 com uma linha de cabeçalho. Uma marca de ordem de bytes (BOM) é aceita.
  • As importações são verificadas por completo antes. Se alguma linha for inválida, nada é importado, e o relatório indica a linha e a coluna.
  • Escreva as datas como YYYY-MM-DD, por exemplo 2026-03-31.
  • Células que começam com =, +, - ou @ são escapadas nas exportações para que as planilhas não as executem como fórmulas.

Clientes (importação)

Baixe o modelo em Clientes, Importar. Você pode mapear os nomes das suas próprias colunas para estes campos na tela.

Colunas da importação de clientes
ColunaNotas
kindindividual ou entity.
first_name, last_namePara pessoas físicas.
legal_namePara pessoas jurídicas.
e-mailObrigatório e único entre os seus clientes.
phoneOpcional.
statusLead, prospect, ativo, inativo ou arquivado. O status ativo é limitado durante o teste.
classificaçãoVarejo, profissional, credenciado, qualificado ou institucional.
country, languageCódigo do país e idioma preferido.
tagsVárias tags em uma célula.
grupoO nome do grupo. Ele é criado se não existir.
assigned_member_emailO membro da equipe responsável pelo cliente.
notasUma nota adicionada ao cliente.

As colunas que correspondem pela chave a um dos seus campos personalizados são importadas para ele. As colunas de que você não precisa podem ser definidas como Ignorar na etapa de mapeamento.

Imóveis (importação)

Colunas da importação de imóveis
ColunaNotas
title, type, reference_codeO título e o tipo são obrigatórios. O código de referência é o que os saldos iniciais usam para encontrar o imóvel.
city, country, currencyObrigatório.
total_fractions, fraction_priceAs frações são obrigatórias. O preço é opcional e, se ausente, é calculado.
acquisition_price, acquisition_dateOpcional.
land_area_m2, built_area_m2, year_builtAs áreas são em metros quadrados.
statusRascunho ou ativo.

Até 5.000 linhas por arquivo.

Saldos iniciais (importação)

Colunas de saldos iniciais
ColunaNotas
property_reference_codeO código de referência de um imóvel existente.
client_emailO e-mail de um cliente existente.
fractionsUm número inteiro de frações.
cost_basisO valor que o cliente pagou.
currencyA moeda do custo de aquisição.
acquired_onA data de aquisição.

Exportações

Colunas de exportação
ExportarColunas
Quadro de participaçõesclient_id, client_name, fractions, ownership_pct, cost_basis, currency, first_acquired_on, current_value.
Lote bancárioline_id, client_name, iban_or_account, swift_bic, currency, amount, reference.

Não encontrou o que precisa?

Conte o que você estava tentando fazer. Respondemos por e-mail e sua pergunta nos ajuda a escrever o próximo guia. Nunca envie senhas, números de documentos ou dados bancários.