iopoint
Referência

Grupo econômico

Listar a matriz e as filiais acessíveis pelo token, com os CNPJs usados para mirar empresas específicas.

URL Base
https://api.iopoint.com.br/api

Endpoints

Listar empresas do grupo

GET/customer/v2/economic-group

Lista a matriz e as filiais do grupo econômico acessíveis pelo token. Para token de matriz, retorna a matriz e todas as filiais ativas; para token de filial, retorna apenas a própria empresa. Os CNPJs (`national_registry`) retornados aqui são os valores aceitos no parâmetro `company_national_registry` dos demais endpoints.

O vínculo de grupo econômico liga cada filial à sua matriz. Com o token da matriz, este endpoint é o ponto de partida para descobrir quais empresas você pode consultar e com quais CNPJs mirá-las individualmente.

Acesso ao grupo é exclusivo de tokens de matriz; filiais enxergam apenas a si mesmas.
Use o national_registry retornado aqui em company_national_registry para consultar uma empresa específica em qualquer endpoint GET, ou include_branches=1 para agregar o grupo todo.

Exemplos

Request
curl -X GET "https://api.iopoint.com.br/api/customer/v2/economic-group" \
  -H "apiIopointToken: SEU_TOKEN_AQUI"
Response200
{
  "data": [
    {
      "name": "Matriz LTDA",
      "trading_name": "Matriz",
      "national_registry": "12345678000199",
      "is_headquarter": true
    },
    {
      "name": "Filial São Paulo LTDA",
      "trading_name": "Filial SP",
      "national_registry": "12345678000288",
      "is_headquarter": false
    }
  ]
}

Respostas

200
{
  "data": [
    {
      "name": "Matriz LTDA",
      "trading_name": "Matriz",
      "national_registry": "12345678000199",
      "is_headquarter": true
    },
    {
      "name": "Filial São Paulo LTDA",
      "trading_name": "Filial SP",
      "national_registry": "12345678000288",
      "is_headquarter": false
    }
  ]
}