> ## 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.
# RWS Connect
> Extraia de APIs SOAP, bancos de dados e arquivos, fontes sem conector nativo
## O que é o RWS Connect?
Com o RWS Connect, construímos um pipeline gerenciado que extrai da sua fonte e a expõe através da **API do RWS Connect**: uma API REST simples sobre sistemas mais antigos (APIs SOAP, bancos de dados e arquivos) que suas integrações extraem como qualquer outra API moderna.
## Por que ele existe
A RWS Integration conecta nativamente a APIs REST, webhooks e servidores SFTP/FTP. Mas muitos dados críticos de negócio vivem em lugares que nada disso alcança: um ERP que só fala SOAP, um banco de dados on-premise atrás de uma VPN, arquivos de texto posicionais depositados em um servidor toda noite. Em vez de forçar você a construir e operar código de extração personalizado, a RWS constrói e opera o pipeline para você, e suas integrações consomem o resultado através de uma única API REST consistente.
## Como funciona
1. **Você solicita um conector** para sua fonte ([Arquivos](/pt-br/features/connections/files), [Bancos de Dados](/pt-br/features/connections/databases) ou [APIs SOAP](/pt-br/features/connections/soap)) enviando um email para [connect@rwsintegration.com](mailto:connect@rwsintegration.com)
2. **A RWS constrói um pipeline gerenciado** que extrai da fonte no agendamento combinado e grava os dados em tabelas estruturadas
3. **Sua integração extrai da API do RWS Connect** usando uma [conexão Simple](/pt-br/features/connections/api#simple) padrão, e depois transforma e envia normalmente
Do ponto de vista da sua integração, o RWS Connect é só mais uma fonte de API: [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) se aplicam sem mudanças.
Suas tabelas ficam prontas em até **dois dias úteis** (SLA) após o acesso e as informações necessárias 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.
## Fontes suportadas
Texto posicional, CSV, arquivos delimitados, Excel, JSON e XML, de SFTP, FTP, S3, Drive e mais
Qualquer banco compatível com JDBC, onde quer que ele rode
Web services SOAP, unidos e achatados em registros limpos
## Seus dados como tabelas
* **Database**: o nome do seu tenant, fornecido durante o onboarding. Todas as suas tabelas vivem sob ele.
* **Table**: uma tabela por dataset, com o nome combinado quando o conector é solicitado.
* **Colunas**: planas, em `snake_case`, não importa quão aninhada ou fora de padrão seja a fonte.
Um único pipeline frequentemente combina vários endpoints ou tabelas de origem para construir um dataset completo. Nesse caso, cada coluna mantém um prefixo identificando de onde veio, e tudo chega junto em um único objeto JSON plano por registro:
```json theme={null}
{
"employees_employee_id": "1042",
"employees_name": "Ana Souza",
"contracts_position": "Sales Analyst",
"contracts_start_date": "2024-03-01",
"extraction_date": "2026-07-28"
}
```
Cada execução do pipeline adiciona um snapshot marcado com a data de extração, então as tabelas preservam histórico: você pode consultar o estado atual ou olhar qualquer execução passada.
Toda tabela também carrega estas colunas padrão:
| Coluna | Significado |
| ------------------------------ | ---------------------------------------------------- |
| `extracted_at` | Timestamp de quando o registro foi extraído |
| `extraction_date` | Data da execução do pipeline que produziu o registro |
| `extract_start_date_parameter` | Início da janela de datas que a execução extraiu |
| `extract_end_date_parameter` | Fim da janela de datas que a execução extraiu |
## Consultando seus dados
Sua integração consulta a API do RWS Connect com query parameters simples. Um exemplo comum, lendo o snapshot atual de uma tabela (o registro mais recente por funcionário, em páginas de 100):
```
GET https://connect.rwsintegration.com/
?database=acme
&table=employees
&filter[over_employee_id][extracted_at]=first
&page[size]=100
&page[number]=1
```
```json theme={null}
{
"Items": [
{
"employees_employee_id": "1042",
"employees_name": "Ana Souza",
"contracts_position": "Sales Analyst"
}
],
"Total": 1580
}
```
A API também suporta seleção de colunas, filtros com muitos operadores, comparações de data, agrupamento, agregações e ordenação. Veja [Consultando a API do RWS Connect](/pt-br/features/extract/connect-api) para todos os parâmetros.
## Atualização dos dados
As tabelas são atualizadas no agendamento do pipeline, tipicamente diário, combinado quando o conector é solicitado. Consultas idênticas repetidas podem ser servidas de um cache de curta duração (até 10 minutos).
## RWS Connect Live
As tabelas respondem perguntas sobre seus dados até a última atualização. Às vezes você precisa da resposta **agora**: toda admissão deste mês está mesmo na plataforma de RH, neste exato momento? Para isso, o **RWS Connect Live** lê o seu sistema em tempo real — uma chamada REST entra, uma chamada SOAP ao vivo chega ao seu sistema, um JSON limpo volta — usando a mesma api key.
O Live é o que alimenta o [monitoramento](/pt-br/core-concepts/monitoring) e as auditorias sobre sistemas legados, e qualquer integração que não pode trabalhar com os dados de ontem. Hoje ele suporta fontes SOAP. Veja o [guia do RWS Connect Live](/pt-br/guides/rws-connect-live) para construir sua primeira extração ao vivo.
## Próximos passos
Todos os parâmetros: select, filtros, agrupamento, agregações e paginação
Construa uma integração funcional sobre uma tabela do Connect
Leia seu sistema em tempo real, para monitoramento e além