> ## 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.

# APIs SOAP

> Extraia dados de web services SOAP através do RWS Connect

Muitos ERPs e sistemas de RH/folha expõem seus dados apenas através de web services SOAP: envelopes XML, contratos WSDL, headers de autenticação personalizados e payloads sensíveis à ordem dos elementos. Fontes SOAP são atendidas pelo **RWS Connect**: construímos um pipeline gerenciado que extrai dos seus serviços SOAP 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.

## Quando usar

* O sistema de origem só oferece web services SOAP (comum em ERPs de RH, folha e fiscais)
* Obter um registro completo exige chamar várias operações SOAP e combinar os resultados
* O serviço retorna XML profundamente aninhado que seria doloroso consumir diretamente
* Você precisa tanto de um feed agendado de mudanças quanto de um backfill de dados históricos

## Como funciona

1. **O RWS Connect chama as operações SOAP por você**, com autenticação, paginação e retries inclusos
2. **O pipeline combina e achata os resultados**: dados de múltiplas operações são unidos em registros completos, e o XML aninhado vira colunas planas
3. **Sua integração extrai a tabela** através da API do RWS Connect, como qualquer outra fonte REST

O pipeline roda no agendamento combinado (tipicamente diário) e também pode fazer backfill do histórico em um intervalo de datas, para sua tabela começar completa em vez de vazia.

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                                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Endpoints               | As URLs dos serviços SOAP, e o WSDL quando disponível                                                                                                                    |
| Credenciais             | O que a autenticação do serviço exigir (usuário/senha, identificadores de tenant, etc.)                                                                                  |
| Envelopes de exemplo    | Um exemplo de requisição **e** de resposta para cada operação. A maioria dos serviços SOAP é rigorosa com ordem de elementos e namespaces, então exemplos reais importam |
| Operações e campos      | Quais operações chamar e quais campos você precisa no resultado                                                                                                          |
| Janelas de filtro       | Como os dados são filtrados por execução (por exemplo, registros modificados em um intervalo de datas)                                                                   |
| Acesso de rede          | [Configuração de VPN](/pt-br/features/connections/vpn), se o serviço não for acessível publicamente                                                                      |
| Cadência de atualização | Com que frequência os dados devem ser atualizados                                                                                                                        |
| 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.

<Info>
  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.
</Info>

## Como seus dados aparecem

* Uma tabela por dataset, com o nome combinado no ticket
* Estruturas XML aninhadas achatadas em colunas `snake_case`
* Cada coluna recebe o prefixo da operação ou endpoint de onde veio (por exemplo `employees_name` e `contracts_start_date`), 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. Um backfill único pode carregar períodos passados
* Colunas padrão em toda tabela: `extracted_at`, `extraction_date`, `extract_start_date_parameter`, `extract_end_date_parameter`

## Próximos passos

<CardGroup cols={2}>
  <Card title="RWS Connect" icon="plug-circle-bolt" href="/pt-br/core-concepts/rws-connect">
    Entenda como o RWS Connect funciona
  </Card>

  <Card title="Consultando a API do RWS Connect" icon="magnifying-glass" href="/pt-br/features/extract/connect-api">
    Filtros, agregações, paginação e mais
  </Card>
</CardGroup>