listar_aniversariantes_empresa - Pipo Public API

Lista os membros ativos de uma empresa que fazem aniversário em um determinado mês, junto com a idade que completarão naquele ano. O resultado traz nome, dia do aniversário, idade nova, ano de referência e o ID do membro, este último útil para cruzar com outras consultas.

Por proteção de dados, a data de nascimento completa e o CPF não são retornados. Você recebe apenas o dia do mês e a idade nova.

Parâmetros

Parâmetro	Obrigatório	Descrição
`cnpj`	Sim	CNPJ da empresa, com ou sem pontuação.
`mes`	Não	Mês do aniversário, de 1 a 12. Se omitido, usa o mês atual.
`limite`	Não	Máximo de linhas retornadas. Padrão 50, máximo 500.

Limites e omissões

A lista é montada cruzando a busca de membros com a data de nascimento de cada um, e esse cruzamento tem tetos:

a busca para em 100 páginas de 500 membros;
a consulta de data de nascimento para em 1 000 membros;
membros sem data de nascimento cadastrada, ou cujo detalhe não pôde ser consultado, são omitidos do resultado.

Sempre que algum desses tetos é atingido, a resposta diz explicitamente o que ficou de fora. Uma lista de aniversariantes não é, portanto, garantia de completude em empresa grande.

O ano de referência é sempre o ano corrente (fuso de São Paulo), inclusive ao pedir um mês já passado. Perguntar pelos aniversariantes de março em setembro devolve a idade que cada um completou em março deste ano, não de um ano anterior.

Exemplos de perguntas

“Quais membros ativos fazem aniversário este mês na empresa de CNPJ 12.345.678/0001-95?”
“Liste os aniversariantes de setembro e a idade nova deles”
“Quem muda de faixa etária em agosto?”