listar_empresas - Pipo Public API

Lista as empresas acessíveis à sua conta, preservando a hierarquia devolvida pela Pipo. As empresas no nível principal são matrizes. Dentro de cada matriz aparecem:

filiais: as subsidiárias da matriz;
PJs: empresas vinculadas ao contrato de serviço.

Parâmetros

Parâmetro	Obrigatório	Descrição
`relacao`	Não	Filtra por tipo: `matriz`, `filial` ou `pj`.
`matriz`	Condicional	Matriz por nome, CNPJ ou UUID. Obrigatório ao filtrar por `filial` ou `pj`.
`produto`	Não	Nome do produto, por exemplo `Plano Essencial`. Aceita parte do nome.

O filtro por produto procura o nome do produto na matriz, identifica o produto correspondente e devolve a matriz junto com as filiais e PJs que o possuem.

Exemplos de perguntas

“Quais empresas eu tenho acesso na Pipo?”
“Quais são as filiais da Acme Inc.?”
“Quais PJs estão vinculadas a esta matriz?”
“Quais empresas têm o produto Plano Essencial?”