---
title: Sinqia Previdência
slug: sinqia-previdencia
docTags: 
createdAt: 2025-07-21T23:28:20.239Z
---

## Objetivo

Este conector permite acessar as APIs do sistema da Sinqia, facilitando a integração com o módulo **Cadastro**, que expõe operações para participantes, beneficiários e pessoas físicas.

## Criando um fluxo

Para usar o conector Sinqia em um fluxo da Fluid:

1. Acesse a plataforma Fluid.
2. Crie um novo fluxo e adicione um bloco de Ação.
3. Selecione o conector **Sinqia**.

## Criando conexão

Para autenticar a conexão com a API Sinqia, forneça as seguintes credenciais:

- **Nome**: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório);
- **Descrição**: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão;
- **Chave do Cliente**  – obrigatório
- **Chave Publica**  – obrigatório
- **Basic** – obrigatório

::Image[]{src="https://api.archbee.com/api/optimize/6zyQV3JyrHcB2oHBu_Kh0/INyjHk_mV90ar9AGIRZob_image.png" size="70" width="788" height="708" position="center" darkWidth="788" darkHeight="708" showCaption="false"}

## Configurando fluxo

Crie um fluxo (passo a passo [Criar Fluxo](#)) e arraste o conector Sinqia para o canvas.

::Image[]{src="https://api.archbee.com/api/optimize/6zyQV3JyrHcB2oHBu_Kh0/KCFUHo0hcSJ5ZMgftkA79_image.png" size="70" width="1542" height="726" position="center" darkWidth="1542" darkHeight="726" showCaption="false"}

Este conector possui uma estrutura hierárquica de configuração com três níveis:

1. **Módulo**: atualmente disponível apenas o módulo **Cadastro**
2. **Recurso**: entidade específica do módulo selecionado
3. **Operação**: ação a ser realizada no recurso

## Módulos, Recursos e Operações




### Módulo: Cadastro

Recurso: Participante

- **Busca por Plano**
  - Requer: plan (ID do plano do participante)
- **Busca por CPF**
  - Requer: cpf (CPF do participante)
- **Listar Participantes da SCAF Plus**
  - Requer: 
    - versão
    - página: obrigatório, maior que zero
    - tamanho da página: quantidade de registros por página (1-50)

Recurso: Beneficiário

- **Busca por CPF**
  - Requer: cpf (CPF do beneficiário)

Recurso: Plano

- **Lista de planos da pessoa física**
  - Requer: cpf (CPF da pessoa física)

Recurso: Pessoa Física

- **Listar**
  - Requer:
    - page: Número da página (ex: 1)
    - size: Tamanho da página (ex: 10)

### Módulo: Arrecadação

Recurso: Contribuição

- **Busca Históricos de Valores**
  - Requer: cpf (CPF do participante)
- **Busca contribuições por período**
  - Requer:
    - cpf: CPF do participante
    - startDate: Data inicial (formato: YYYY-MM-DD)
    - endDate: Data final (formato: YYYY-MM-DD)

## Na prática

Neste tópico criaremos um fluxo utilizando o conector Sinqia. O fluxo terá somente um passo que buscará o cadastro de um participante por CPF.

![](https://api.archbee.com/api/optimize/6zyQV3JyrHcB2oHBu_Kh0/-GgwI5vH2G3U2Zjhbci4k_image.png)

### Passo participante

Assim ficará a `Parametrização` do nosso primeiro e unico passo:

::Image[]{src="https://api.archbee.com/api/optimize/6zyQV3JyrHcB2oHBu_Kh0/emg8b_1WPY1rBl5ysX0CL_image.png" size="72" width="418" height="613" position="center" darkWidth="418" darkHeight="613" showCaption="false"}

Na aba `Propriedades` informamos o nome do passo e a conexão criada para o Sinqia:

::Image[]{src="https://api.archbee.com/api/optimize/6zyQV3JyrHcB2oHBu_Kh0/axtTsE3G_C7Vuu-PSa4R3_image.png" size="60" width="420" height="686" position="center" darkWidth="420" darkHeight="686" showCaption="false"}

### Disparando o Fluxo

Com os passos configurados basta disparar o fluxo. Nesse caso não precisaremos informar um payload de entrada, pois os dados que estamos usando no exemplo estão fixos no conector. Após o disparo, o resultado do fluxo será apresentado em tempo real no canvas:

![](https://api.archbee.com/api/optimize/6zyQV3JyrHcB2oHBu_Kh0/-0DvYr0j6Ywh6vWpBGa3P_image.png)

![](https://api.archbee.com/api/optimize/6zyQV3JyrHcB2oHBu_Kh0/36rX59p2DaE5_3liA3sCa_image.png)

## Conclusão

O conector Sinqia simplifica a integração com a API previdenciária, oferecendo operações diretas para consulta de dados sensíveis com segurança e flexibilidade.