A inclusão e alteração em massa de registros no Master Data pode ser feito tanto por API quanto por importação de planilha. Este documento tem como objetivo demonstrar o passo a passo necessário para a criação e importação da planilha com os dados novos e alterados.

A melhor maneira de obter a planilha de importação é realizando a exportação do formulário que deseja atualizar. A planilha de exportação é a mesma que deve ser utilizada na importação, porém com algumas alterações, como a retirada dos campos que são de preenchimento automático do sistema, como "accountId", "accountName", "dataEntityId", "createdBy", "createdIn", "updatedBy", "updatedIn", "lastInteractionBy", "lastInteractionIn", "followers" e "tags", por exemplo. Assim, sempre realizando uma exportação antes da importação, é garantido que a planilha utilizada está atualizada com possíveis alterações do formulário em questão.

1. É imprescindível que a exportação desses dados seja feita e que sejam alterados os dados desejados na planilha exportada.
2. Manter a coluna (id) com o valor do dado já existente.

Deixe o valor da coluna id vazio e será criado um novo registro.

Ao inserir os dados na planilha, certifique-se que o formato dos valores nas células corresponde ao formato esperado pela respectiva coluna. Exemplos de formatos são número, texto ou data.

Após a exportação e edição da planilha exportada, é hora de realizar a importação dos dados. Para isso, siga os pontos abaixo para realizar esta operação.

Mantenha o mesmo formato da planilha (xls) para realizar a importação com sucesso.

1. No Admin VTEX, acesse Configurações da loja > Storefront > Master Data.
2. Clique na aba Aplicações.
3. Clique no botão Importar.
4. Selecione a entidade de dados que deseja inserir ou atualizar registros (Aqui, você deve inserir a entidade de dados do formulário onde estão os registros que deseja inserir ou atualizar).
5. Escolha o arquivo.
6. Clique no botão Importar no canto inferior da tela.