> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rwsintegration.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Arquivos
> Extraia dados de arquivos de texto posicionais, CSVs, arquivos delimitados, planilhas Excel, JSON e XML através do RWS Connect
Muitos sistemas ainda entregam dados em arquivos: exportações de texto de largura fixa de ERPs legados, CSVs depositados em um servidor SFTP, planilhas Excel mantidas por um time de back-office, exportações em JSON ou XML. Fontes de arquivo são atendidas pelo **RWS Connect**: construímos um pipeline gerenciado que extrai dos seus arquivos e os expõe através da **API do RWS Connect**, uma API REST simples que suas integrações extraem como qualquer outra API moderna.
## Formatos suportados
| Formato | Descrição | Informações de layout que precisamos |
| ----------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| **Texto posicional (largura fixa)** | Cada campo ocupa posições fixas de coluna em cada linha | Nomes dos campos, posições iniciais e larguras |
| **CSV** | Arquivos de valores separados por vírgula | Variante do separador (vírgula ou ponto e vírgula), encoding e se há linha de cabeçalho |
| **Texto delimitado** | Campos separados por qualquer outro delimitador: pipe, tab, personalizado | Delimitador, encoding e se há linha de cabeçalho |
| **Excel** | Planilhas `.xls` / `.xlsx` | Nome(s) da(s) aba(s) e posição da linha de cabeçalho |
| **JSON** | Documentos JSON ou arquivos JSON Lines | O caminho até os registros dentro do documento |
| **XML** | Documentos XML | O elemento que representa um registro |
## Quando usar
* Um ERP legado ou sistema de folha só produz exportações em arquivo, geralmente em layouts de largura fixa
* Um parceiro entrega CSVs ou outros arquivos delimitados em um servidor SFTP ou FTP periodicamente
* Um time mantém dados em planilhas Excel que precisam alimentar uma integração
* Um sistema exporta documentos JSON ou XML em vez de expor uma API
* Arquivos bancários, fiscais ou governamentais com layouts posicionais
## Como funciona
1. **Seus arquivos ficam onde estão**: SFTP, FTP, Amazon S3, Google Drive, ou onde quer que vivam hoje
2. **O RWS Connect os coleta** no agendamento combinado, interpreta o layout e grava os registros em uma tabela estruturada
3. **Sua integração extrai a tabela** através da API do RWS Connect, como qualquer outra fonte REST
Tudo o que a plataforma oferece para extrações de API funciona sem mudanças: [paginação](/pt-br/features/extract/pagination), [parâmetros dinâmicos](/pt-br/features/extract/dynamic-parameters), [regras de negócio](/pt-br/features/business-rules/overview) e [agendamento](/pt-br/features/extract/scheduling).
## O que você fornece
| Item | Detalhes |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Localização e acesso aos arquivos | Onde os arquivos vivem (SFTP, FTP, S3, Google Drive, etc.) e credenciais para lê-los |
| Especificação do layout | Nomes dos campos mais, por formato: posições e larguras (posicional), separador e encoding (CSV e delimitado), aba e linha de cabeçalho (Excel), caminho ou elemento do registro (JSON e XML) |
| Arquivo de exemplo | Um arquivo real e recente para validarmos o layout |
| Cadência de atualização | Com que frequência novos arquivos chegam e como são nomeados |
| Nome da tabela | O nome que você quer para a tabela resultante |
## Solicitando o conector
Envie um email para [connect@rwsintegration.com](mailto:connect@rwsintegration.com) com os itens acima para abrir um ticket.
Sua tabela fica pronta em até **dois dias úteis** (SLA) após o acesso e as informações acima serem fornecidos. Se o acesso exigir VPN, a [configuração da VPN](/pt-br/features/connections/vpn) leva mais dois dias úteis antes da construção do pipeline.
## Como seus dados aparecem
* Uma tabela por layout de arquivo, com o nome combinado no ticket
* Colunas em `snake_case`
* Quando um pipeline combina mais de um arquivo ou layout em um único dataset, cada coluna recebe o prefixo da fonte de onde veio, e cada registro é entregue como um único objeto JSON plano (veja [Prefixos de coluna](/pt-br/features/extract/connect-api#prefixos-de-coluna))
* Cada execução adiciona um snapshot marcado com a data de extração, preservando o histórico
* Colunas padrão em toda tabela: `extracted_at`, `extraction_date`, `extract_start_date_parameter`, `extract_end_date_parameter`
## Próximos passos
Entenda como o RWS Connect funciona
Filtros, agregações, paginação e mais