> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piposaude.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# buscar_membro

> Busca membros de uma empresa por CPF, centro de custo ou matrícula

Busca membros (colaboradores) dentro de uma empresa, por CPF, centro de custo ou matrícula.

<Warning>
  **Não é possível buscar por nome.** Use CPF, centro de custo ou matrícula. Pedir "me acha o João da Silva" não funciona.
</Warning>

## Parâmetros

| Parâmetro         | Obrigatório | Descrição                                                                   |
| ----------------- | ----------- | --------------------------------------------------------------------------- |
| `cnpj`            | Sim         | CNPJ da empresa onde o membro será buscado.                                 |
| `cpf`             | Não         | CPF do membro, com ou sem pontuação. Ex.: `123.456.789-09`.                 |
| `centro_de_custo` | Não         | Centro de custo para filtrar. Ex.: `TI`, `Financeiro`. Até 100 caracteres.  |
| `matricula`       | Não         | Matrícula (`employee-id`) para filtrar. Até 50 caracteres.                  |
| `tipo`            | Não         | `primary` ou `dependent`. Padrão `primary`. Usado quando a busca é por CPF. |
| `limite`          | Não         | Máximo de membros retornados. Padrão 50, máximo 500.                        |

<Note>
  Os filtros de CPF, centro de custo e matrícula são combinados por **OU**: qualquer um que bata traz resultado. O CNPJ, por ser o escopo da busca, é sempre exigido.
</Note>

<Warning>
  **A busca por CPF e as demais não têm o mesmo recorte.** Centro de custo e matrícula consideram somente membros **ativos**; a busca por CPF não aplica esse filtro e pode devolver um membro já desligado. Se o que importa é o vínculo vigente, confirme o status no resultado.
</Warning>

## Exemplos de perguntas

* "Busca o membro com CPF 123.456.789-09 dentro da empresa de CNPJ 12.345.678/0001-95"
* "Quais membros da empresa estão no centro de custo TI?"
* "Encontre o colaborador com matrícula 12345 nessa empresa"