Skip to main content
Uma importação CSV cria insumos novos em lote. Ela nunca atualiza nem exclui insumos existentes. Uma exportação CSV baixa o catálogo inteiro em um arquivo, com custos apenas para quem pode vê-los.

​
Quem pode fazer

A importação e a exportação são marcadas como ações sensíveis. Na versão atual o segundo fator (MFA) é opcional e não as bloqueia; se o console algum dia mostrar Verifique sua identidade para continuar., confirme com o seu aplicativo autenticador e tente de novo. Veja Segurança da conta e Funções e permissões.

​
Onde

Não existe uma lista de importações anteriores. Guarde o endereço da página Status da importação se quiser consultá-la depois.

​
Prepare o arquivo

A tela Importar CSV (Adicione insumos de um arquivo CSV. Os insumos existentes não são atualizados.) inclui um guia, Prepare seu arquivo, com:
  • Colunas obrigatórias e Colunas opcionais.
  • Unidades aceitas e Criticidades aceitas, com os códigos.
  • Baixar modelo de colunas: um arquivo chamado muveya-catalog-template.csv só com a linha de cabeçalho.
  • IDs de categorias para seu CSV: cada Nome da categoria ao lado do seu categoryId, com Copiar ID da categoria.

​
Formato do arquivo

  • CSV simples com vírgula como separador. Campos que contêm vírgulas, aspas duplas ou quebras de linha ficam entre aspas duplas, e uma aspa dupla dentro deles é escrita duas vezes ("").
  • Codificado em UTF-8, com ou sem marca de ordem de bytes. Em uma planilha, salve como “CSV UTF-8”.
  • O primeiro registro é o cabeçalho. Os nomes das colunas são os nomes em inglês abaixo, escritos exatamente (maiúsculas contam), em qualquer ordem.
  • Colunas que o muveya não conhece são ignoradas. Se uma coluna aparece duas vezes, vale a primeira, exceto unitOfMeasure, cost, currency e as colunas de metadados de custo: uma duplicata de qualquer uma delas recusa o arquivo inteiro.
  • Linhas vazias são ignoradas. Os espaços em volta de cada valor são removidos.
Planilhas configuradas em português ou espanhol costumam salvar CSV com ponto e vírgula. O muveya lê esse arquivo como uma única coluna, e a importação falha com O arquivo não contém as colunas CSV obrigatórias. Salve com vírgulas.

​
Colunas

Exemplo:
A segunda linha não tem custo: cost e currency estão vazios.

​
Limites

​
Importar insumos

1

Prepare as categorias

Crie antes as categorias que faltam e copie os identificadores em IDs de categorias para seu CSV. Veja Categorias.
2

Escolha o arquivo

Em Importar CSV, clique em Arquivo CSV e escolha o seu arquivo .csv.
3

Envie

Clique em Importar insumos. Quando o arquivo é aceito, o console abre Status da importação.
4

Acompanhe o andamento

A página se atualiza sozinha enquanto a importação aguarda processamento ou está em andamento. Atualizar status consulta de novo quando você quiser.
5

Revise o resultado

Leia os totais e as linhas rejeitadas. Corrija essas linhas em um arquivo novo e clique em Importar outro arquivo.
6

Ative os novos insumos

Os insumos importados ficam em rascunho. Abra cada um e ative-o quando estiver pronto para ser pedido. Não existe ativação em lote. Veja Insumos do catálogo.

​
Status da importação

Ao terminar, a página mostra Linhas de dados, Criados e Rejeitados. Se alguma linha foi rejeitada, ela acrescenta Algumas linhas foram rejeitadas. Revise os motivos antes de enviar um arquivo corrigido. e uma tabela com Linha de dados e Motivo. Cada linha é independente: uma linha rejeitada nunca interrompe as outras, e as linhas criadas antes de uma rejeição continuam criadas.

​
Números de linha

São contados registros de dados, sem o cabeçalho; um registro CSV pode ocupar várias linhas de texto. A linha de dados 1 é o primeiro registro depois do cabeçalho. Linhas vazias não contam, e um valor entre aspas com quebras de linha conta como uma única linha, então o número da linha de dados pode ser diferente do número de linha que o seu editor mostra.

​
Falhas do arquivo inteiro

​
Linhas rejeitadas

Para corrigir linhas rejeitadas, monte um arquivo novo só com essas linhas, já corrigidas. Deixe de fora as linhas que foram criadas: agora elas seriam rejeitadas com Este SKU já existe.

​
Importações nunca atualizam insumos

  • Uma importação só cria insumos. Uma linha cujo SKU já existe é rejeitada, sejam quais forem os outros valores. Para mudar insumos existentes, edite-os no console.
  • Dentro de um arquivo, a primeira linha com um SKU é criada e as seguintes com o mesmo SKU são rejeitadas.
  • Enviar o mesmo arquivo duas vezes não cria nada na segunda vez: todas as linhas são rejeitadas por SKU existente.
  • Se o processamento for interrompido e retomado, o muveya lembra quais linhas já criou e não as cria de novo.
  • O custo de uma linha passa a ser o custo vigente do insumo, confirmado para a unidade de medida importada. Veja Custos.
1

Inicie a exportação

Em Catálogo, clique em Exportar CSV. O arquivo é gerado na hora.
2

Baixe

Clique em Baixar CSV. Abaixo do link, O link expira: mostra a data e a hora.
O link vale por 5 minutos. Depois disso, o console mostra Este link expirou. Gere uma nova exportação.; clique de novo em Exportar CSV. Se o console não conseguir verificar o link, mostra Não foi possível verificar o link de download. Gere uma nova exportação.

​
Conteúdo da exportação

O arquivo se chama catalog.csv e contém todos os insumos da clínica odontológica, em todos os status, do mais antigo ao mais recente.
  • Valores opcionais vazios são células vazias; as colunas de rastreabilidade valem true ou false; cost e currency ficam vazios quando o custo é unset.
  • O arquivo está em UTF-8 com marca de ordem de bytes, separado por vírgulas e com quebras de linha do Windows, para que as planilhas abram corretamente os nomes com acentos.
  • Um valor que começa com =, +, - ou @ é gravado com um apóstrofo (') na frente, para que a planilha não o execute como fórmula.
  • As categorias aparecem como categoryId, não pelo nome. Apresentações, códigos de embalagem e estoque não são exportados.

​
Reimportar um arquivo exportado

Uma exportação tem os mesmos nomes de coluna da importação, então você pode usá-la como ponto de partida, por exemplo para carregar o mesmo catálogo em outra clínica odontológica. Antes de enviar:
  • Troque cada categoryId pelos identificadores da clínica odontológica de destino.
  • Remova o apóstrofo que a exportação colocou na frente dos valores que começam com =, +, - ou @.
  • A coluna status é ignorada: todo insumo é criado como rascunho.
  • Se o arquivo tiver as colunas de custo, o costStatus de cada linha decide o que acontece:
    • unset: as demais células de custo precisam estar vazias.
    • verified: costUnitOfMeasure precisa ser igual a unitOfMeasure, costMeasurementVersion um número inteiro a partir de 1, costQuantityProtocol precisa ser base_number_v1, cost um número inteiro e currency três letras maiúsculas. Caso contrário, a linha é rejeitada com Revise os campos desta linha.
    • review_required ou invalid: a linha é rejeitada com O custo registrado precisa de revisão. Confirme a unidade e o valor antes de importar esta linha.
    • Vazio ou qualquer outro valor: a linha é rejeitada com Revise os campos desta linha.
  • Reimportar na mesma clínica odontológica não cria nada, porque todos os SKUs já existem.

​
O que o sistema registra

A importação também guarda, para cada linha de dados, se ela foi criada e o motivo quando não foi. Esse resumo nunca guarda valores de custo. A versão atual não tem uma tela para consultar a auditoria.

​
O que pode dar errado ao enviar ou exportar

A API pública não importa nem exporta o catálogo. Para lê-lo a partir de outro sistema, use GET /v1/catalog/items. Veja API para desenvolvedores.

​
Páginas relacionadas

Insumos do catálogo

Regras dos campos e ativação.

Categorias

Crie categorias e encontre os identificadores.

Custos

Unidades menores e estados do custo.

Funções e permissões

Funções que podem importar e exportar.