buscar_membro - Pipo Public API

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

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.

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.

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.

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.

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”