# Mapeamentos e arquivos de integração

Relacione campos, traduza opções e importe ou exporte dados com limites e identificação claros.

Versão 1.1.0

**Integrações → Arquivos** começa desativada. Abra **Configurar**, ative **Usar Arquivos** e salve. A configuração pertence somente a essa extensão. Quando desativada, **Operações → Arquivos** fica oculta e transferências de arquivos não são executadas. Desativar preserva os mapeamentos; API e Webhook continuam com suas configurações próprias.

Arquivos utiliza os mesmos mapeamentos de API e Webhook. Um mapeamento relaciona campos de uma tabela e sentido; não cria novos campos livres no produto. A aba **Mapeamentos** mantém essas correspondências; **Importar** permite escolher destino e mapeamento, e **Exportar** extrai dados. Em **Operações → Arquivos**, a execução começa por um mapeamento de entrada já cadastrado, que fixa o destino da transferência.

## Criar um mapeamento

1. Use **+ Mapeamento**, informe Nome e escolha Receber dados no Askora ou Enviar dados do Askora.
2. Selecione Área, Página e Tabela; Suborganizações também exige a organização.
3. Preencha o nome externo apenas nos campos que serão relacionados.
4. Abra Opções para obrigatoriedade, padrão, formato ou correspondência de valores.
5. Confira um exemplo e salve. Depois selecione o mapeamento na transferência ou conexão.

Tabela e sentido ficam fixos na edição. Durante a criação, trocar a combinação preserva rascunhos enquanto o formulário estiver aberto; recarregar não salva esses rascunhos. Mapeamentos diferentes podem atender a mesma tabela.

## Valores, referências e formatos

Uma correspondência pode traduzir Venda = V e Devolução = D. Com correspondências definidas, códigos desconhecidos geram erro; valor padrão atende campo ausente, não código desconhecido. Zeros iniciais e maiúsculas são significativos.

**Consultar opções do Askora** permite escolher referências cadastradas por nome. É uma correspondência explícita do perfil, diferente dos identificadores externos com validade. Campos temporariamente desligados são preservados no mapeamento, mas não podem ser usados como se estivessem disponíveis.

Conversões incluem texto, número, inteiro, booleano, data, decimal brasileiro e JSON. Listas de produtos podem ser copiadas na estrutura permitida, sem transformar automaticamente cada elemento ou expandir uma linha em vários documentos. São até 100 regras e 100 correspondências por campo.

**Conferir com um exemplo** transforma a amostra; não valida sozinho todas as regras do cadastro de destino. Uma transformação correta ainda pode conter referência inativa, parcela incompatível ou período fechado.

## Importar e retomar

CSV, XLSX e JSON aceitam até dois MB, 100 linhas e 100 colunas; Excel usa uma planilha sem fórmulas. Confira formato, separador, mapeamento e comportamento Criar/Atualizar/Criar ou atualizar.

Valide o arquivo antes de confirmar. Mudanças invalidam a prévia. Após iniciar a execução, mantenha código do lote, conteúdo e configuração para retentar sem duplicar. Alterar o mapeamento exige novo lote depois de nova conferência, preservando Pedido/código externo para identificar atualizações.

O resultado informa linhas concluídas e erros; baixe o relatório. O sistema não oferece uma biblioteca visual de todos os arquivos enviados. O fluxo de execução também está em [Operações → Arquivos](/spm/manual/importacoes-operacionais/#selecionar-e-validar).

## Exportar

Escolha tabela, formato e mapeamento de saída. **Exportar primeira página** baixa até 100 registros. Continue em Exportar próxima página até a indicação de conclusão; Voltar à primeira página reinicia a leitura.

A exportação é paginada sobre o estado atual, não uma fotografia imutável de toda a empresa. CSV/Excel protegem conteúdo interpretável como fórmula; JSON preserva os dados originais. Permissões e configuração do destino delimitam o que é oferecido.

## Disponibilidade

Gestão, importação e exportação ficam no web, exclusivas do Master nas páginas de Integrações. O aplicativo não possui essa interface. Métricas, Pagamentos, lotes e Fechamentos usam ações próprias e não aceitam criação genérica por planilha.