Listar relacionamentos de uma empresa (ambas as direções)

Retorna os relacionamentos onde a empresa é principal OU relacionada, com
direction (principal/relacionada) + empresa_nome_fantasia/empresa_cnpj
da outra empresa.

⚠️ Status do relacionamento — por padrão devolve ATIVOS + INATIVOS

PATCH /:id/inactivate seta ativo=false no relacionamento (inativação
reversível, não é soft-delete). Esta listagem mantém o histórico — cada
item carrega o campo ativo pra você distinguir.

Quer ver	Use
só os ativos (consumo "limpo", picker, integrações)	`?onlyActive=true`
tudo (auditoria, telas de gestão)	sem query string (default)

A empresa do outro lado do JOIN é sempre filtrada por deleted_at IS NULL
(empresa hard/soft-deletada não vai aparecer em nenhum dos modos).

⚠️ Diferença entre `id` e `id_empresa_*` no retorno

id = ID do registro de relacionamento (use em PATCH /:id/type, PATCH /:id/inactivate, DELETE /:id).

id_empresa_principal / id_empresa_relacionada = IDs das empresas (linha em empresa.id).

Path param

{idEmpresa} = id da empresa (campo empresa.id).

Respostas

🟢200OK

application/json

Resposta no envelope padrão da API ({ ok, data }). data é a lista de
relacionamentos (vazia se a empresa não tem nenhum). Cada item carrega
direction (principal/relacionada em relação à empresa consultada)

dados da empresa do outro lado.

Bodyapplication/json

Examples

Sem `?onlyActive` (default) — devolve ativos + inativosCom `?onlyActive=true` — só os ativosEmpresa sem relacionamentos

Empresa 1 tem 3 relacionamentos. O id=7 está inativo
(ativo: false) e ainda aparece — é o comportamento default
(visão de auditoria/histórico). Pra esconder o inativo, mande
?onlyActive=true.

{
    "ok": true,
    "data": [
        {
            "id": 7,
            "id_empresa_principal": 1,
            "id_empresa_relacionada": 4,
            "tipo_de_relacionamento": "subsidiaria",
            "ativo": false,
            "direction": "principal",
            "empresa_nome_fantasia": "liber fantasia",
            "empresa_cnpj": "12890301829083",
            "created_by": 23,
            "updated_by": 9800
        },
        {
            "id": 6,
            "id_empresa_principal": 1,
            "id_empresa_relacionada": 3,
            "tipo_de_relacionamento": "filial",
            "ativo": true,
            "direction": "principal",
            "empresa_nome_fantasia": "Midiahub fantasia",
            "empresa_cnpj": "22222222222222",
            "created_by": 23,
            "updated_by": null
        },
        {
            "id": 5,
            "id_empresa_principal": 1,
            "id_empresa_relacionada": 2,
            "tipo_de_relacionamento": "filial",
            "ativo": true,
            "direction": "principal",
            "empresa_nome_fantasia": "Comtexto fantasia",
            "empresa_cnpj": "22222222000122",
            "created_by": 23,
            "updated_by": null
        }
    ]
}

🟠401Não Autorizado

Listar relacionamentos de uma empresa (ambas as direções)

⚠️ Status do relacionamento — por padrão devolve ATIVOS + INATIVOS

⚠️ Diferença entre `id` e `id_empresa_*` no retorno

Path param

Requisição

Códigos de solicitação

Respostas

Listar relacionamentos de uma empresa (ambas as direções)

⚠️ Status do relacionamento — por padrão devolve ATIVOS + INATIVOS#

⚠️ Diferença entre id e id_empresa_* no retorno#

Path param#

Requisição

Códigos de solicitação

Respostas

⚠️ Status do relacionamento — por padrão devolve ATIVOS + INATIVOS

⚠️ Diferença entre `id` e `id_empresa_*` no retorno

Path param