# Exportar e importar dados

> No Odoo, às vezes é necessário exportar ou importar dados para a execução de relatórios ou para a modificação de dados.

Fonte: https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/

No Odoo, às vezes é necessário exportar ou importar dados para a execução de relatórios ou para a modificação de dados. Este documento aborda a exportação e a importação de dados para e do Odoo.

Importante

Às vezes, os usuários se deparam com um erro de "tempo excedido", ou um registro não é processado devido ao seu tamanho. Isso pode ocorrer com grandes exportações ou nos casos em que o arquivo de importação é muito grande. Para contornar essa limitação relativa ao tamanho dos registros, processe as exportações ou importações em lotes menores.

[]()

## Exportar dados do Odoo

Ao trabalhar com um banco de dados, às vezes é necessário exportar dados em um arquivo distinto. Fazer isso pode auxiliar em relatórios sobre atividades, embora o Odoo forneça uma ferramenta de relatórios precisa com cada aplicativo disponível.

Com o Odoo, os valores podem ser exportados de qualquer campo em qualquer registro. Para fazer isso, ative a visualização de lista ☷ **(Lista)**, nos itens que precisam ser exportados e, em seguida, selecione os registros que devem ser exportados. Para selecionar um registro, marque a caixa de seleção ao lado do registro correspondente. Por fim, clique no botão **Ação** e selecione fa-upload **Exportar**.

![View of the different things to enable/click to export data.](https://docs.kmee.com.br/odoo/referencias-18.0/img/applications/essentials/export_import_data/list-view-export.png)

Ao clicar em fa-upload **Exportar**, uma janela pop-over **Exportar Dados** aparece, com várias opções para os dados a exportar:

![Overview of options to consider when exporting data in Odoo.](https://docs.kmee.com.br/odoo/referencias-18.0/img/applications/essentials/export_import_data/export-data-overview.png)

1. Com a opção **Quero atualizar dados (exportação compatível com importação)** marcada, o sistema mostra apenas os campos que podem ser importados. Isso é útil no caso em que [registros existentes precisam ser atualizados](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-update-data). Isso funciona como um filtro. Deixar a caixa desmarcada oferece muito mais opções de campo porque mostra todos os campos, não apenas os que podem ser importados.
2. Ao exportar, há a opção de exportar em dois formatos: `.csv` e `.xls`. Com o `.csv`, os itens são separados por vírgula, enquanto o `.xls` contém informações sobre todas as planilhas em um arquivo, incluindo o conteúdo e a formatação.
3. Estes são os itens que podem ser exportados. Use o ícone > **Mostrar subcampos** para exibir mais opções de subcampos. Use a barra **Pesquisar** para encontrar campos específicos. Para usar a opção **Pesquisar** de forma mais eficiente, clique em todos os ícones > **Mostrar subcampos** para exibir todos os campos.
4. O botão de ícone + **Selecionar campo** está presente para adicionar campos à lista **Campos a exportar**.
5. O ícone ^v **Ordenar** à esquerda dos campos selecionados pode ser usado para mover os campos para cima e para baixo, para alterar a ordem em que são exibidos no arquivo exportado. Arraste e solte usando o ícone ^v **Ordenar**.
6. O ícone ⌫ **Remover campo** é usado para remover campos. Clique no ícone ⌫ **Remover campo** para remover o campo.
7. Para relatórios recorrentes, é útil salvar predefinições de exportação. Selecione todos os campos necessários e clique no menu suspenso de modelo. Uma vez lá, clique em **Novo modelo** e dê um nome exclusivo ao modelo de exportação. Clique no ícone fa-floppy-o **disquete** para salvar a configuração. Na próxima vez que a mesma lista precisar ser exportada, selecione o modelo relacionado que foi salvo anteriormente no menu suspenso.

Dica

É útil conhecer o identificador externo do campo; por exemplo, **Empresa relacionada** na interface do usuário de exportação é igual a *parent_id* (identificador externo). Assim, os únicos dados exportados são os que devem ser modificados e reimportados.

[]()

## Importar dados para o Odoo

A importação de dados para o Odoo é extremamente útil durante a implementação ou em momentos em que os dados precisam ser [atualizados em massa](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-update-data). A documentação a seguir aborda como importar dados para uma base de dados do Odoo.

Aviso

As importações são permanentes e **não podem** ser desfeitas. No entanto, é possível usar filtros (`criado em` ou `última modificação`) para identificar registros alterados ou criados pela importação.

Dica

Ativar [modo de desenvolvedor](https://docs.kmee.com.br/odoo/18.0/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/#developer-mode) altera as configurações de importação visíveis no menu esquerdo. Isso revela um menu **Avançado**. Nesse menu avançado estão incluídas duas opções: **Monitorar histórico durante a importação** e **Permitir correspondência com subcampos**.

![Advanced import options when developer mode is activated.](https://docs.kmee.com.br/odoo/referencias-18.0/img/applications/essentials/export_import_data/advanced-import.png)

Se o modelo usar o openchatter, a opção **Monitorar histórico durante a importação** configurará assinaturas e enviará notificações durante a importação, mas levará a uma importação mais lenta.

Se a opção **Permitir correspondência com subcampos** for selecionada, todos os subcampos de um campo serão usados para fazer a correspondência com o **Campo do Odoo** durante a importação.

[]()

### Comece agora

Os dados podem ser importados em qualquer objeto de negócios do Odoo usando os formatos Excel (`.xlsx`) ou CSV (`.csv`). Isso inclui: contatos, produtos, extratos bancários, lançamentos no diário e pedidos.

Abra a visualização do objeto para o qual os dados devem ser importados/preenchidos, clique no ícone ⚙ **Ação** e, no menu suspenso, selecione fa-upload **Importar registros**.

![Action menu revealed with the import records option highlighted.](https://docs.kmee.com.br/odoo/referencias-18.0/img/applications/essentials/export_import_data/import-button.png)

Clique em fa-upload**Importar modelo para clientes** no centro da página para baixar um [modelo](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-export-import-data-adapt-a-template) e preenchê-lo com os próprios dados da empresa. Tais modelos podem ser importados com um clique, pois o mapeamento de dados já está pré-configurado.

Para carregar o modelo baixado ou um arquivo existente, siga os próximos passos:

1. Clique em **Carregar o arquivo de dados** e selecione o arquivo desejado.
2. Ajuste as opções **Formatação** conforme necessário (somente para arquivos CSV).
3. Certifique-se de que todos os dados na **Coluna de arquivos** estejam corretamente mapeados para o **campo do Odoo** apropriado e sem erros.
4. (Opcional) Clique em **Carregar arquivo de dados** para recarregar o mesmo arquivo ou carregar um arquivo diferente.
5. Clique em **Testar** para verificar se os dados são válidos.
6. Clique em **Importar**.

Nota

As opções **Formatação** não aparecem ao importar o tipo de arquivo proprietário do Excel (ou seja, `.xls` ou `.xlsx`).

[]()

### Adaptar um modelo

Os modelos de importação são fornecidos na ferramenta de importação dos dados mais comuns a serem importados (contatos, produtos, extratos bancários, etc.). Abra-os com qualquer software de planilha eletrônica (*Microsoft Office*, *OpenOffice*, *Google Drive*, etc.).

Depois de fazer o download do modelo, siga estas etapas:

- Adicione, remova e classifique colunas para melhor se adequar à estrutura de dados.
- É altamente recomendável **não** remover a coluna **ID externo** (ID) (veja o motivo na próxima seção).
- Defina um ID exclusivo para cada registro arrastando para baixo a sequência de IDs na coluna **ID externo** (ID).

![An animation of the mouse dragging down the ID column, so each record has a unique ID.](https://docs.kmee.com.br/odoo/referencias-18.0/img/applications/essentials/export_import_data/dragdown.gif)

Nota

Quando uma nova coluna é adicionada, o Odoo pode não ser capaz de mapeá-la automaticamente se o seu rótulo não se enquadrar em nenhum campo do Odoo. No entanto, novas colunas podem ser mapeadas manualmente quando a importação for testada. Procure o campo correspondente no menu suspenso.

![Drop-down menu expanded in the initial import screen on Odoo.](https://docs.kmee.com.br/odoo/referencias-18.0/img/applications/essentials/export_import_data/field-list.png)

Em seguida, use o rótulo desse campo no arquivo de importação para garantir que as importações futuras sejam bem-sucedidas.

Dica

Outra maneira útil de descobrir os nomes corretos das colunas para importar é exportar um arquivo de amostra usando os campos a serem importados. Dessa forma, se não houver um modelo de importação de amostra, os nomes são precisos.

[]()

### Importar de outro aplicativo

O **ID externo** (ID) é um identificador exclusivo para um item de linha. É possível usar um **ID externo** (ID) de software anterior para facilitar a transição para o Odoo.

A definição de um ID não é obrigatória na importação, mas ajuda em muitos casos:

- [Atualizar importações](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-update-data): importe o mesmo arquivo várias vezes sem criar duplicatas.
- [Importar campos relacionais](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#export-import-data-relation-fields).

Para recriar relações entre registros diferentes, o identificador exclusivo do aplicativo original deve ser usado para mapeá-lo para a coluna **ID externo** (ID) no Odoo.

Quando outro registro for importado e vinculado ao primeiro, use **XXX/ID** (XXX/ID externo) para o identificador exclusivo original. Esse registro também pode ser encontrado pelo nome.

Aviso

Observe que ocorrerão conflitos se dois (ou mais) registros tiverem o mesmo *ID externo*.

### Campo ausente para mapear a coluna

Odoo tenta heuristicamente encontrar o tipo de campo para cada coluna dentro do arquivo importado, com base nas primeiras dez linhas dos arquivos.

Por exemplo, se houver uma coluna contendo apenas números, somente os campos com o tipo *inteiro* serão apresentados como opções.

Embora esse comportamento possa ser benéfico na maioria dos casos, também é possível que falhe ou que a coluna seja mapeada para um campo que não é proposto por padrão.

Se isso acontecer, marque a opção **Mostrar campos de campos relacionais (avançado)**; então, uma lista completa de campos ficará disponível para cada coluna.

![Searching for the field to match the tax column.](https://docs.kmee.com.br/odoo/referencias-18.0/img/applications/essentials/export_import_data/field-list.png)

### Alterar o formato de importação de dados

Nota

O Odoo consegue detectar automaticamente se uma coluna é uma data e tenta adivinhar o formato da data a partir de um conjunto de formatos de data mais comumente usados. Embora esse processo possa funcionar para muitos formatos de data, alguns formatos não são reconhecíveis. Isso pode causar confusão, devido a inversões dia-mês; é difícil adivinhar qual parte de um formato de data é o dia e qual parte é o mês, em uma data, como `01-03-2016`.

Ao importar um arquivo CSV, o Odoo fornece opções de **Formatação**.

Para ver qual formato de data o Odoo encontrou no arquivo, verifique o **Formato de data** que é mostrado ao clicar em opções no seletor de arquivos. Se esse formato estiver incorreto, altere-o para o formato preferido usando *ISO 8601*.

Importante

*ISO 8601* é um padrão internacional que abrange a troca mundial, juntamente com a comunicação de dados relacionados a data e hora. Por exemplo, o formato de data deve ser `AAAA-MM-DD`. No caso de 24 de julho de 1981, deve ser escrito como `1981-07-24`.

Dica

Ao importar arquivos do Excel (`.xls`, `.xlsx`), considere o uso de *células de data* para armazenar datas. Isso mantém os formatos de data locais para exibição, independentemente de como a data é formatada no Odoo. Ao importar um arquivo CSV, use a seção **Formatação** do Odoo para selecionar as colunas de formato de data a serem importadas.

### Importar números com sinais de moeda

O Odoo suporta totalmente números com parênteses para representar sinais negativos, bem como números com sinais de moeda anexados a eles. O Odoo também detecta automaticamente qual é o separador de milhar/decimal. Se for usado um símbolo de moeda desconhecido para o Odoo, ele não será reconhecido como um número e a importação falhará.

Nota

Ao importar um arquivo CSV, o menu **Formatação** é exibido na coluna da esquerda. Nessas opções, o **Separador de milhares** pode ser alterado.

Exemplos de números suportados (com "trinta e dois mil" como numeral):

- 32.000,00
- 32000,00
- 32,000.00
- -32000.00
- (32000.00)
- US$ 32.000,00
- (€ 32000.00)

Exemplo que não funciona:

- ABC 32.000,00
- US$ (32.000,00)

Importante

Um **() (parêntese)** ao redor do número indica que o número é um valor negativo. O símbolo de moeda **deve** ser colocado dentro do parêntese para que o Odoo o reconheça como um valor de moeda negativo.

### A tabela de pré-visualização de importação não é exibida corretamente

Por padrão, a pré-visualização da importação é definida com vírgulas como separadores de campo e aspas como delimitadores de texto. Se o arquivo CSV não tiver essas configurações, modifique as opções **Formatação** (exibidas na barra de arquivos **Importar** CSV depois de selecionar o arquivo CSV).

Importante

Se o arquivo CSV tiver uma tabulação como separador, o Odoo **não** detectará as separações. As opções de formato de arquivo precisam ser modificadas no aplicativo de planilha. Consulte a seguinte seção [Alterar formato do arquivo CSV](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#export-import-data-change-csv).

[]()

### Alterar o formato do arquivo CSV no aplicativo de planilha

Ao editar e salvar arquivos CSV em aplicativos de planilha, as configurações regionais do computador são aplicadas para o separador e o delimitador. A Odoo sugere o uso do *OpenOffice* ou do *LibreOffice*, pois ambos os aplicativos permitem modificações nas três opções (no aplicativo *LibreOffice*, vá para **caixa de diálogo 'Salvar como' -> Marque a caixa 'Editar configurações de filtro' -> Salvar**).

O Microsoft Excel pode modificar a codificação ao salvar (**caixa de diálogo 'Salvar como' -> menu suspenso 'Ferramentas' -> aba Codificação**).

[]()

### Diferença entre ID da base de dados e ID externo

Alguns campos definem uma relação com outro objeto. Por exemplo, o país de um contato é um link para um registro do objeto "País". Quando esses campos são importados, o Odoo precisa recriar os links entre os diferentes registros. Para ajudar a importar esses campos, o Odoo oferece três mecanismos.

Importante

**Apenas um** mecanismo deve ser usado por campo importado.

Por exemplo, para fazer referência ao país de um contato, o Odoo propõe três campos diferentes para importar:

- **País**: o nome ou código do país
- **País/ID da base de dados**: o ID exclusivo do Odoo para um registro, definido pela coluna ID PostgreSQL
- **País/ID externo**: o ID desse registro referenciado em outro aplicativo (ou o arquivo `.XML` que o importou)

Para Bélgica, por exemplo, use uma destas três maneiras de importar:

- **País**: `Bélgica`
- **Identificação do país/base de dados**: `21`
- **País/ID externo**: `base.be`

De acordo com a necessidade da empresa, use uma dessas três maneiras para fazer referência a registros em relações. Aqui está um exemplo de quando uma ou outra deve ser usada, de acordo com a necessidade:

- Usar **País**: essa é a maneira mais fácil quando os dados são provenientes de arquivos CSV que foram criados manualmente.
- Usar **País/ID da base de dados**: isso raramente deve ser usado. É usado principalmente por desenvolvedores, pois a principal vantagem é nunca ter conflitos (pode haver vários registros com o mesmo nome, mas eles sempre têm um ID de base de dados exclusivo)
- Usar **País/ID externo**: use *ID externo* ao importar dados de um aplicativo de terceiros.

Ao usar *IDs externos*, importe arquivos CSV com a coluna **ID externo** (ID) definindo o *ID externo* de cada registro importado. Em seguida, é possível fazer uma referência a esse registro com colunas, como `Campo/ID externo`. Os dois arquivos CSV a seguir fornecem um exemplo de produtos e suas categorias.

- [Arquivo CSV para categorias](https://docs.kmee.com.br/odoo/referencias-18.0/arquivos/applications/essentials/export_import_data/External_id_3rd_party_application_product_categories.csv)
- [Arquivo CSV para produtos](https://docs.kmee.com.br/odoo/referencias-18.0/arquivos/applications/essentials/export_import_data/External_id_3rd_party_application_products.csv)

[]()

### Importar campos relacionais

Um objeto Odoo está sempre relacionado a muitos outros objetos (por exemplo, um produto está vinculado a categorias de produtos, atributos, fornecedores, etc.). Para importar essas relações, os registros do objeto relacionado primeiro precisam ser importados a partir de seu próprio menu de lista.

É possível fazer isso usando o nome ou o ID do registro relacionado, dependendo das circunstâncias. É esperado usar o ID quando dois registros têm o mesmo nome. Nesse caso, adicione `/ ID` no final do título da coluna (por exemplo, para atributos de produto: `Atributos de produto / Atributo / ID`).

#### Opções para múltiplas correspondências em campos

Se, por exemplo, houver duas categorias de produtos com o nome secundário `Vendável` (por exemplo, `Diversos. Produtos/Vendável` e `Outros produtos/Vendável`), a validação será interrompida, mas os dados ainda poderão ser importados. No entanto, a Odoo recomenda que os dados não sejam importados porque todos eles serão vinculados à primeira categoria `Vendável` encontrada na lista *Categoria de produto* (`Diversos. Produtos/Vendável`). Em vez disso, o Odoo recomenda modificar um dos valores da duplicata ou a hierarquia da categoria do produto.

No entanto, se a empresa não quiser alterar a configuração das categorias de produtos, o Odoo recomenda o uso do *ID externo* para esse campo, 'Categoria'.

#### Importar campos relacionais many2many

Os marcadores devem ser separados por vírgula, sem espaçamento. Por exemplo, se um cliente precisar ser vinculado a ambos os marcadores: `Fabricante` e `Varejista`, então 'Fabricante, Varejista' precisa ser codificado na mesma coluna do arquivo CSV.

- [Arquivo CSV para Fabricante, Varejista](https://docs.kmee.com.br/odoo/referencias-18.0/arquivos/applications/essentials/export_import_data/m2m-customers-tags.csv)

#### Importar relações one2many

Se uma empresa quiser importar um pedido de venda com várias linhas de pedido, uma linha específica **deve** ser reservada no arquivo CSV para cada linha de pedido. A primeira linha de pedido é importada na mesma linha que as informações relativas ao pedido. Todas as linhas adicionais precisam de uma linha adicional que não tenha nenhuma informação nos campos relativos ao pedido.

Exemplo

Uma empresa importa orçamentos usando um arquivo CSV, baseado em dados de demonstração:

- [Arquivo para alguns orçamentos](https://docs.kmee.com.br/odoo/referencias-18.0/arquivos/applications/essentials/export_import_data/o2m-quotations-order-lines.csv)

Uma empresa importa ordens de compra com suas respectivas linhas de ordem de compra usando um arquivo CSV:

- [Ordens de compra com suas respectivas linhas de ordem de compra](https://docs.kmee.com.br/odoo/referencias-18.0/arquivos/applications/essentials/export_import_data/o2m-purchase-order-lines.csv)

Uma empresa importa clientes e seus respectivos contatos usando um arquivo CSV:

- [Clientes e seus respectivos contatos](https://docs.kmee.com.br/odoo/referencias-18.0/arquivos/applications/essentials/export_import_data/o2m-customers-contacts.csv)

### Importar arquivos de imagem

Para importar arquivos de imagem junto com o arquivo CSV ou Excel [uploaded](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-export-import-data-get-started), siga as próximas etapas:

1. Adicione os nomes dos arquivos de imagem à coluna **Imagem** relevante no arquivo de dados.
2. [Upload the data file](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-export-import-data-get-started) or reload it by clicking **Load Data File**.
3. Clique em **Carregar seus arquivos** na seção **Arquivos a importar**.
4. Selecione os arquivos de imagem relevantes. O número de arquivos selecionados aparece ao lado do botão.
5. Clique em **Testar** para verificar se todos os dados são válidos.
6. Clique em **Importar**. Durante o processo de importação, o Odoo executa uma verificação de arquivo para vincular automaticamente as imagens carregadas ao arquivo de dados importado. Se não houver correspondência, o arquivo de dados será importado sem nenhuma imagem.

Nota

- A seção **Arquivos a importar** é habilitada se o modelo de produto tiver uma coluna **Imagem** com todos os campos preenchidos.
- Os nomes dos arquivos de imagem no arquivo de dados devem corresponder aos arquivos de imagem carregados.
- Ao importar um grande número de imagens, especifique o tamanho máximo do lote em megabytes e defina um atraso para evitar que o sistema fique sobrecarregado. Para fazer isso, [ative o modo de desenvolvedor](https://docs.kmee.com.br/odoo/18.0/modulos/administracao/modo-de-desenvolvedor-modo-de-depuracao/) e preencha os campos **Tamanho máximo por lote** e **Atraso após cada lote** na seção **Arquivos a importar**. Por padrão, o atraso atende ao limite de chamadas RPC/API definido na [Política de Uso Aceitável do Odoo Cloud](https://www.odoo.com/acceptable-use).

### Importar registros diversas vezes

Se um arquivo importado contiver uma das colunas: **ID externo** ou **ID da base de dados**, os registros que já foram importados serão modificados, em vez de serem criados. Isso é extremamente útil, pois permite que os usuários importem o mesmo arquivo CSV várias vezes, mesmo tendo feito algumas alterações entre as duas importações.

O Odoo se encarrega de criar ou modificar os registros.

Esse recurso permite que uma empresa use a ferramenta *Importar/Exportar* no Odoo para modificar um lote de registros em um aplicativo de planilha.

### Valor não fornecido para um campo específico

Se todos os campos não estiverem definidos no arquivo CSV, o Odoo atribui o valor padrão para cada campo não definido. No entanto, se os campos estiverem definidos com valores vazios no arquivo CSV, o Odoo define o valor vazio no campo, em vez de atribuir o valor padrão.

### Exportar/importar tabelas diferentes de um aplicativo SQL para o Odoo

Se os dados precisarem ser importados de tabelas diferentes, as relações deverão ser recriadas entre os registros pertencentes a tabelas diferentes. Por exemplo, se empresas e pessoas forem importadas, o vínculo entre cada pessoa e a empresa para a qual ela trabalha precisará ser recriado.

Para gerenciar relações entre tabelas, use os recursos de `ID externo` do Odoo. O `ID externo` de um registro é o identificador exclusivo desse registro em outro aplicativo. O `ID externo` deve ser único em todos os registros de todos os objetos. É uma boa prática prefixar esse `ID externo` com o nome do aplicativo ou da tabela. (por exemplo, 'empresa_1', 'pessoa_1' - em vez de '1')

Como exemplo, suponha que haja uma base de dados SQL com duas tabelas que devem ser importadas: empresas e pessoas. Cada pessoa pertence a uma empresa, portanto, o vínculo entre uma pessoa e a empresa para a qual ela trabalha deve ser recriado.

Teste esse exemplo, com uma [amostra de uma base de dados PostgreSQL](https://docs.kmee.com.br/odoo/referencias-18.0/arquivos/applications/essentials/export_import_data/database_import_test.sql).

Primeiro, exporte todas as empresas e seus *IDs externos*. No PSQL, escreva o seguinte comando:

```sh
> copy (select 'company_'||id as "External ID",company_name as "Name",'True' as "Is a Company" from companies) TO '/tmp/company.csv' with CSV HEADER;
```

Esse comando SQL cria o seguinte arquivo CSV:

```text
External ID,Name,Is a Company
company_1,Bigees,True
company_2,Organi,True
company_3,Boum,True
```

Para criar o arquivo CSV para pessoas vinculadas a empresas, use o seguinte comando SQL no PSQL:

```sh
> copy (select 'person_'||id as "External ID",person_name as "Name",'False' as "Is a Company",'company_'||company_id as "Related Company/External ID" from persons) TO '/tmp/person.csv' with CSV
```

Ele produz o seguinte arquivo CSV:

```text
External ID,Name,Is a Company,Related Company/External ID
person_1,Fabien,False,company_1
person_2,Laurence,False,company_1
person_3,Eric,False,company_2
person_4,Ramsy,False,company_3
```

Nesse arquivo, Fabien e Laurence estão trabalhando para a empresa Bigees (`company_1`), e Eric está trabalhando para a empresa Organi. A relação entre pessoas e empresas é feita usando o *ID externo* das empresas. O *ID externo* é prefixado pelo nome da tabela para evitar um conflito de ID entre pessoas e empresas (`pessoa_1` e `empresa_1`, que compartilhavam o mesmo ID 1 no banco de dados original).

Os dois arquivos produzidos estão prontos para serem importados para o Odoo sem nenhuma modificação. Depois de importar esses dois arquivos CSV, há quatro contatos e três empresas (os dois primeiros contatos estão vinculados à primeira empresa). Lembre-se de importar primeiro as empresas e depois as pessoas.

[]()

## Atualizar dados no Odoo

Os dados existentes podem ser atualizados em massa por uma importação de dados, desde que o [ID externo](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-external-id) permaneça consistente.

### Preparar exportação de dados

Para atualizar dados por meio de uma importação, primeiro navegue até os dados a serem atualizados e selecione o ícone ☷ **(Lista)** para ativar a visualização em lista. No lado esquerdo da lista, marque a caixa de seleção para qualquer registro a ser atualizado. Em seguida, clique no botão **Ações** e selecione fa-upload **Exportar** no menu suspenso.

Na janela pop-up **Exportar dados** resultante, marque a caixa de seleção rotulada como **Quero atualizar os dados (compatibilidade com importação e exportação)**. Isso inclui automaticamente o *ID externo* na exportação. Além disso, limita a lista **Campos a exportar** a **somente** incluir campos que possam ser importados.

Nota

O campo **ID externo** não aparece na lista **Campos a exportar** a menos que seja adicionado manualmente, mas ainda assim é incluído na exportação. No entanto, se a caixa de seleção **Quero atualizar os dados (compatibilidade com importação e exportação)** estiver marcada, ele será incluído na exportação.

Select the required fields to be included in the export using the [options](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-export-import-data-export-data) on the pop-up window, then click **Export**.

### Importar dados atualizados

After exporting, make any necessary changes to the data file. When the file is ready, it can be [imported](https://docs.kmee.com.br/odoo/18.0/modulos/primeiros-passos/exportar-e-importar-dados/#essentials-export-import-data-import-data) by following the same process as a normal data import.

Perigo

Ao atualizar os dados, é extremamente importante que o *ID externo* permaneça consistente, pois é assim que o sistema identifica um registro. Se um ID for alterado ou removido, o sistema poderá adicionar um registro duplicado, em vez de atualizar o existente.
