# Estabelecimentos

Os estabelecimentos de uma Empresa são identificados pelo CNPJ, e considera-se estabelecimento todo complexo de bens organizado para exercício da empresa por empresários.

Esta consulta centraliza todos os dados disponíveis na Receita Federal, Simples Nacional e Cadastro de Contribuintes em um local único.

Por padrão, apenas os dados do cadastro na Receita serão retornados. Para adicionar informações de outros portais, refira-se aos parâmetros de query e exemplos a seguir.

Ao definir um valor para maxAge, os dados de todos os portais serão atualizados de forma inteligente. Ou seja, a consulta será feita online, e seus créditos deduzidos, apenas para os que não atenderem seu critério tempo.


# Consulta CNPJ

GET /office/:taxId

Parâmetro Descrição
taxId
Obrigatório
CNPJ sem pontuação

Query

Parâmetro Descrição
simples Informe true para receber informações de opção pelo Simples Nacional e SIMEI
simplesHistory Informe true para adicionar o histórico de períodos anteriores do Simples e SIMEI
registrations Sigla das UFs, separadas por vírgula, para consultar as Inscrições Estaduais. Exemplos:
BR : Todos os estados brasileiros
AC,AP,AM,PA,RO,RR,TO : Região Norte
AL,BA,CE,MA,PB,PI,PE,RN,SE : Região Nordeste
DF,GO,MT,MS : Região Centro-Oeste
ES,MG,RJ,SP : Região Sudeste
PR,RS,SC : Região Sul
AM : Apenas o Amazonas
links Tipos de link, separados por vírgula, para receber um URL pública de consulta:
RFB_CERTIFICATE: Comprovante da Receita Federal
SIMPLES_CERTIFICATE: Comprovante do Simples Nacional
OFFICE_MAP: Mapa dos Arredores
OFFICE_STREET: Visão da Rua
strategy Ver Estratégias de Cache
maxAge Ver Estratégias de Cache
maxStale Ver Estratégias de Cache

# Exemplos

Consulta básica:

/office/37335118000180
{
  "updated": "2021-08-30T04:06:56Z",
  "taxId": "37335118000180",
  "alias": "CNPJA",
  "founded": "2020-06-05",
  "head": true,
  "company": {
    "id": 37335118,
    "name": "CNPJA TECNOLOGIA LTDA",
    "equity": 1000,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 1,
      "acronym": "ME",
      "text": "Microempresa"
    },
    "members": [
      {
        "since": "2020-06-05",
        "person": {
          "id": "1fd8f317-7dd5-4717-ae0c-4a8d52bbe779",
          "name": "Camila Pedrosa Alves",
          "type": "NATURAL",
          "taxId": "***708668**",
          "age": "21-30"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        }
      },
      {
        "since": "2020-06-05",
        "person": {
          "id": "b1afb655-695f-4ca5-b673-e1a0d23a467c",
          "name": "Etienne Rodrigues Bechara",
          "type": "NATURAL",
          "taxId": "***538418**",
          "age": "31-40"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      }
    ]
  },
  "statusDate": "2020-06-05",
  "status": {
    "id": 2,
    "text": "Ativa"
  },
  "address": {
    "municipality": 3550308,
    "street": "Avenida Brig Faria Lima",
    "number": "2369",
    "details": "Conj 1102",
    "district": "Jardim Paulistano",
    "city": "São Paulo",
    "state": "SP",
    "zip": "01452922",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "41",
      "number": "96869828"
    }
  ],
  "emails": [
    {
      "address": "meucnpj@contabilizei.com.br",
      "domain": "contabilizei.com.br"
    }
  ],
  "mainActivity": {
    "id": 6311900,
    "text": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "sideActivities": [
    {
      "id": 6201501,
      "text": "Desenvolvimento de programas de computador sob encomenda"
    },
    {
      "id": 6201502,
      "text": "Web design"
    },
    {
      "id": 6202300,
      "text": "Desenvolvimento e licenciamento de programas de computador customizáveis"
    },
    {
      "id": 6203100,
      "text": "Desenvolvimento e licenciamento de programas de computador não-customizáveis"
    },
    {
      "id": 6204000,
      "text": "Consultoria em tecnologia da informação"
    },
    {
      "id": 6209100,
      "text": "Suporte técnico, manutenção e outros serviços em tecnologia da informação"
    },
    {
      "id": 6319400,
      "text": "Portais, provedores de conteúdo e outros serviços de informação na internet"
    },
    {
      "id": 6399200,
      "text": "Outras atividades de prestação de serviços de informação não especificadas anteriormente"
    },
    {
      "id": 8599603,
      "text": "Treinamento em informática"
    }
  ]
}

Adicionando Simples e CCC:

/office/37335118000180?simples=true&registrations=BR
{
  "updated": "2021-08-28T04:50:30Z",
  "taxId": "37335118000180",
  "alias": "CNPJA",
  "founded": "2020-06-05",
  "head": true,
  "company": {
    "id": 37335118,
    "name": "CNPJA TECNOLOGIA LTDA",
    "equity": 1000,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 1,
      "acronym": "ME",
      "text": "Microempresa"
    },
    "simples": {
      "optant": true,
      "since": "2020-06-05"
    },
    "simei": {
      "optant": false,
      "since": null
    },
    "members": [
      {
        "since": "2020-06-05",
        "person": {
          "id": "1fd8f317-7dd5-4717-ae0c-4a8d52bbe779",
          "name": "Camila Pedrosa Alves",
          "type": "NATURAL",
          "taxId": "***708668**",
          "age": "21-30"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        }
      },
      {
        "since": "2020-06-05",
        "person": {
          "id": "b1afb655-695f-4ca5-b673-e1a0d23a467c",
          "name": "Etienne Rodrigues Bechara",
          "type": "NATURAL",
          "taxId": "***538418**",
          "age": "31-40"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      }
    ]
  },
  "statusDate": "2020-06-05",
  "status": {
    "id": 2,
    "text": "Ativa"
  },
  "address": {
    "municipality": 3550308,
    "street": "Avenida Brig Faria Lima",
    "number": "2369",
    "details": "Conj 1102",
    "district": "Jardim Paulistano",
    "city": "São Paulo",
    "state": "SP",
    "zip": "01452922",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "41",
      "number": "96869828"
    }
  ],
  "emails": [
    {
      "address": "meucnpj@contabilizei.com.br",
      "domain": "contabilizei.com.br"
    }
  ],
  "mainActivity": {
    "id": 6311900,
    "text": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na internet"
  },
  "sideActivities": [
    {
      "id": 6201501,
      "text": "Desenvolvimento de programas de computador sob encomenda"
    },
    {
      "id": 6201502,
      "text": "Web design"
    },
    {
      "id": 6202300,
      "text": "Desenvolvimento e licenciamento de programas de computador customizáveis"
    },
    {
      "id": 6203100,
      "text": "Desenvolvimento e licenciamento de programas de computador não-customizáveis"
    },
    {
      "id": 6204000,
      "text": "Consultoria em tecnologia da informação"
    },
    {
      "id": 6209100,
      "text": "Suporte técnico, manutenção e outros serviços em tecnologia da informação"
    },
    {
      "id": 6319400,
      "text": "Portais, provedores de conteúdo e outros serviços de informação na internet"
    },
    {
      "id": 6399200,
      "text": "Outras atividades de prestação de serviços de informação não especificadas anteriormente"
    },
    {
      "id": 8599603,
      "text": "Treinamento em informática"
    }
  ],
  "registrations": []
}

Consulta básica:

/office/02860160008463
{
  "updated": "2021-08-31T02:32:25Z",
  "taxId": "02860160008463",
  "alias": null,
  "founded": "2005-10-04",
  "head": false,
  "company": {
    "id": 2860160,
    "name": "BGN MERCANTIL E SERVICOS LTDA",
    "equity": 57388030,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "members": [
      {
        "since": "2018-05-07",
        "person": {
          "id": "23b43f1f-0ace-46ab-a198-fdfde57f1bff",
          "name": "Silvio Leonardo Dias Pereira",
          "type": "NATURAL",
          "taxId": "***775077**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2012-09-11",
        "person": {
          "id": "63380908-bd06-4e29-b2af-feaca2b03f11",
          "name": "Antonio Nuno Henriques Cardoso Vercas",
          "type": "NATURAL",
          "taxId": "***462078**",
          "age": "41-50"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      },
      {
        "since": "2018-06-04",
        "person": {
          "id": "e51cd958-5e46-4d55-9b3e-21ac18607c2d",
          "name": "Nuno Miguel Ferreira Parente",
          "type": "NATURAL",
          "taxId": "***231008**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2016-06-23",
        "person": {
          "id": "f6677feb-2571-4538-bbc5-d9372c781531",
          "name": "BANCO CETELEM S.A.",
          "type": "LEGAL",
          "taxId": "00558456000171"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "63380908-bd06-4e29-b2af-feaca2b03f11",
            "name": "Antonio Nuno Henriques Cardoso Vercas",
            "type": "NATURAL",
            "taxId": "***462078**",
            "age": "41-50"
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      }
    ]
  },
  "statusDate": "2005-10-04",
  "status": {
    "id": 1,
    "text": "Nula"
  },
  "reason": {
    "id": 34,
    "text": "Anulação De Inscrição Indevida"
  },
  "address": {
    "municipality": 3306305,
    "street": "Rua Norival de Freitas",
    "number": "86",
    "details": null,
    "district": "Jardim Paraiba",
    "city": "Volta Redonda",
    "state": "RJ",
    "zip": "27215100",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "21",
      "number": "25184334"
    }
  ],
  "emails": [],
  "mainActivity": {
    "id": 6499999,
    "text": "Outras atividades de serviços financeiros não especificadas anteriormente"
  },
  "sideActivities": []
}

Adicionando Simples e CCC:

/office/02860160008463?simples=true&registrations=BR
{
  "updated": "2021-08-31T02:32:23Z",
  "taxId": "02860160008463",
  "alias": null,
  "founded": "2005-10-04",
  "head": false,
  "company": {
    "id": 2860160,
    "name": "BGN MERCANTIL E SERVICOS LTDA",
    "equity": 57388030,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "simples": {
      "optant": false,
      "since": null
    },
    "simei": {
      "optant": false,
      "since": null
    },
    "members": [
      {
        "since": "2018-05-07",
        "person": {
          "id": "23b43f1f-0ace-46ab-a198-fdfde57f1bff",
          "name": "Silvio Leonardo Dias Pereira",
          "type": "NATURAL",
          "taxId": "***775077**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2012-09-11",
        "person": {
          "id": "63380908-bd06-4e29-b2af-feaca2b03f11",
          "name": "Antonio Nuno Henriques Cardoso Vercas",
          "type": "NATURAL",
          "taxId": "***462078**",
          "age": "41-50"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      },
      {
        "since": "2018-06-04",
        "person": {
          "id": "e51cd958-5e46-4d55-9b3e-21ac18607c2d",
          "name": "Nuno Miguel Ferreira Parente",
          "type": "NATURAL",
          "taxId": "***231008**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2016-06-23",
        "person": {
          "id": "f6677feb-2571-4538-bbc5-d9372c781531",
          "name": "BANCO CETELEM S.A.",
          "type": "LEGAL",
          "taxId": "00558456000171"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "63380908-bd06-4e29-b2af-feaca2b03f11",
            "name": "Antonio Nuno Henriques Cardoso Vercas",
            "type": "NATURAL",
            "taxId": "***462078**",
            "age": "41-50"
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      }
    ]
  },
  "statusDate": "2005-10-04",
  "status": {
    "id": 1,
    "text": "Nula"
  },
  "reason": {
    "id": 34,
    "text": "Anulação De Inscrição Indevida"
  },
  "address": {
    "municipality": 3306305,
    "street": "Rua Norival de Freitas",
    "number": "86",
    "details": null,
    "district": "Jardim Paraiba",
    "city": "Volta Redonda",
    "state": "RJ",
    "zip": "27215100",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "21",
      "number": "25184334"
    }
  ],
  "emails": [],
  "mainActivity": {
    "id": 6499999,
    "text": "Outras atividades de serviços financeiros não especificadas anteriormente"
  },
  "sideActivities": [],
  "registrations": []
}

Consulta básica:

/office/00507533000164
{
  "updated": "2021-08-31T02:31:43Z",
  "taxId": "00507533000164",
  "alias": "MEDLABOR",
  "founded": "1978-04-28",
  "head": true,
  "company": {
    "id": 507533,
    "name": "LABORATORIO IMUNO LTDA",
    "equity": 1556208,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "members": [
      {
        "since": "2006-12-07",
        "person": {
          "id": "0885423f-804c-450c-87d9-71a196327868",
          "name": "Luiz Gastao Mange Rosenfeld",
          "type": "NATURAL",
          "taxId": "***077268**",
          "age": "71-80"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2009-09-22",
        "person": {
          "id": "5976bdc4-8321-4eee-b32d-40ee3e097dad",
          "name": "Rodrigo Perazzi Musiello",
          "type": "NATURAL",
          "taxId": "***338347**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2009-09-22",
        "person": {
          "id": "5bac9828-aacf-429e-9999-c36c65761ce1",
          "name": "Ronaldo Azevedo de Carvalho",
          "type": "NATURAL",
          "taxId": "***108206**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-12-07",
        "person": {
          "id": "5f3abcb1-dc7c-4978-aaa8-ed3e48ae245c",
          "name": "Maria Cristina Funck",
          "type": "NATURAL",
          "taxId": "***707528**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-08-02",
        "person": {
          "id": "6c12ea90-0151-4700-90e7-a2dd24bc7245",
          "name": "DIAGNOSTICOS DA AMERICA S.A .",
          "type": "LEGAL",
          "taxId": "61486650000183"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "6071057b-cc09-40fa-b4dd-39169c6481f7",
            "name": "Marcelo Marques Moreira Filho",
            "type": "NATURAL",
            "taxId": "***796407**",
            "age": null
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      },
      {
        "since": "2008-12-19",
        "person": {
          "id": "8ce73578-76d7-4a9f-8855-832b135d63b6",
          "name": "Marcelo Noll Barboza",
          "type": "NATURAL",
          "taxId": "***694220**",
          "age": "51-60"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2007-05-22",
        "person": {
          "id": "c41ab307-7db7-44a8-9e09-1c6dc7c06dd4",
          "name": "DASA REAL ESTATE EMPREENDIMENTOS IMOBILIARIOS LTDA.",
          "type": "LEGAL",
          "taxId": "08158019000172"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "6071057b-cc09-40fa-b4dd-39169c6481f7",
            "name": "Marcelo Marques Moreira Filho",
            "type": "NATURAL",
            "taxId": "***796407**",
            "age": null
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      },
      {
        "since": "2006-08-02",
        "person": {
          "id": "e67b6fdf-6647-4f0c-a39e-625241726417",
          "name": "Rui Siqueira Nunes",
          "type": "NATURAL",
          "taxId": "***200932**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2008-10-29",
        "person": {
          "id": "ec762c56-575e-4f8b-96eb-90ede5df313b",
          "name": "Fernando Janikian",
          "type": "NATURAL",
          "taxId": "***572438**",
          "age": "51-60"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-08-02",
        "person": {
          "id": "eca74680-9ac4-4b2b-8dbb-6ef8c8e376fe",
          "name": "Antonio Carlos Gaeta",
          "type": "NATURAL",
          "taxId": "***847958**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-12-07",
        "person": {
          "id": "f868cb22-9b12-44df-8f8e-e6a29c39b160",
          "name": "Mauricio Viecili",
          "type": "NATURAL",
          "taxId": "***044908**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      }
    ]
  },
  "statusDate": "2012-05-16",
  "status": {
    "id": 3,
    "text": "Suspensa"
  },
  "reason": {
    "id": 21,
    "text": "Pedido De Baixa Indeferida"
  },
  "address": {
    "municipality": 5300108,
    "street": "Setor Seup Sul Eq. 712/912 Conjunto b Bloco 04",
    "number": "S/N",
    "details": "Sala 308",
    "district": "Asa Sul",
    "city": "Brasília",
    "state": "DF",
    "zip": "70390125",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "61",
      "number": "34333203"
    }
  ],
  "emails": [],
  "mainActivity": {
    "id": 8640202,
    "text": "Laboratórios clínicos"
  },
  "sideActivities": []
}

Adicionando Simples e CCC:

/office/00507533000164?simples=true&registrations=BR
{
  "updated": "2021-08-31T02:31:41Z",
  "taxId": "00507533000164",
  "alias": "MEDLABOR",
  "founded": "1978-04-28",
  "head": true,
  "company": {
    "id": 507533,
    "name": "LABORATORIO IMUNO LTDA",
    "equity": 1556208,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "simples": {
      "optant": false,
      "since": null
    },
    "simei": {
      "optant": false,
      "since": null
    },
    "members": [
      {
        "since": "2006-12-07",
        "person": {
          "id": "0885423f-804c-450c-87d9-71a196327868",
          "name": "Luiz Gastao Mange Rosenfeld",
          "type": "NATURAL",
          "taxId": "***077268**",
          "age": "71-80"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2009-09-22",
        "person": {
          "id": "5976bdc4-8321-4eee-b32d-40ee3e097dad",
          "name": "Rodrigo Perazzi Musiello",
          "type": "NATURAL",
          "taxId": "***338347**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2009-09-22",
        "person": {
          "id": "5bac9828-aacf-429e-9999-c36c65761ce1",
          "name": "Ronaldo Azevedo de Carvalho",
          "type": "NATURAL",
          "taxId": "***108206**",
          "age": "41-50"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-12-07",
        "person": {
          "id": "5f3abcb1-dc7c-4978-aaa8-ed3e48ae245c",
          "name": "Maria Cristina Funck",
          "type": "NATURAL",
          "taxId": "***707528**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-08-02",
        "person": {
          "id": "6c12ea90-0151-4700-90e7-a2dd24bc7245",
          "name": "DIAGNOSTICOS DA AMERICA S.A .",
          "type": "LEGAL",
          "taxId": "61486650000183"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "6071057b-cc09-40fa-b4dd-39169c6481f7",
            "name": "Marcelo Marques Moreira Filho",
            "type": "NATURAL",
            "taxId": "***796407**",
            "age": null
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      },
      {
        "since": "2008-12-19",
        "person": {
          "id": "8ce73578-76d7-4a9f-8855-832b135d63b6",
          "name": "Marcelo Noll Barboza",
          "type": "NATURAL",
          "taxId": "***694220**",
          "age": "51-60"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2007-05-22",
        "person": {
          "id": "c41ab307-7db7-44a8-9e09-1c6dc7c06dd4",
          "name": "DASA REAL ESTATE EMPREENDIMENTOS IMOBILIARIOS LTDA.",
          "type": "LEGAL",
          "taxId": "08158019000172"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "6071057b-cc09-40fa-b4dd-39169c6481f7",
            "name": "Marcelo Marques Moreira Filho",
            "type": "NATURAL",
            "taxId": "***796407**",
            "age": null
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      },
      {
        "since": "2006-08-02",
        "person": {
          "id": "e67b6fdf-6647-4f0c-a39e-625241726417",
          "name": "Rui Siqueira Nunes",
          "type": "NATURAL",
          "taxId": "***200932**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2008-10-29",
        "person": {
          "id": "ec762c56-575e-4f8b-96eb-90ede5df313b",
          "name": "Fernando Janikian",
          "type": "NATURAL",
          "taxId": "***572438**",
          "age": "51-60"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-08-02",
        "person": {
          "id": "eca74680-9ac4-4b2b-8dbb-6ef8c8e376fe",
          "name": "Antonio Carlos Gaeta",
          "type": "NATURAL",
          "taxId": "***847958**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      },
      {
        "since": "2006-12-07",
        "person": {
          "id": "f868cb22-9b12-44df-8f8e-e6a29c39b160",
          "name": "Mauricio Viecili",
          "type": "NATURAL",
          "taxId": "***044908**",
          "age": "61-70"
        },
        "role": {
          "id": 5,
          "text": "Administrador"
        }
      }
    ]
  },
  "statusDate": "2012-05-16",
  "status": {
    "id": 3,
    "text": "Suspensa"
  },
  "reason": {
    "id": 21,
    "text": "Pedido De Baixa Indeferida"
  },
  "address": {
    "municipality": 5300108,
    "street": "Setor Seup Sul Eq. 712/912 Conjunto b Bloco 04",
    "number": "S/N",
    "details": "Sala 308",
    "district": "Asa Sul",
    "city": "Brasília",
    "state": "DF",
    "zip": "70390125",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "61",
      "number": "34333203"
    }
  ],
  "emails": [],
  "mainActivity": {
    "id": 8640202,
    "text": "Laboratórios clínicos"
  },
  "sideActivities": [],
  "registrations": [
    {
      "state": "DF",
      "number": "0731064400187",
      "enabled": false
    }
  ]
}

Consulta básica:

/office/12086512000282
{
  "updated": "2021-08-31T02:31:09Z",
  "taxId": "12086512000282",
  "alias": "CRUZ E MAR CONSTRUTORA",
  "founded": "2010-08-10",
  "head": false,
  "company": {
    "id": 12086512,
    "name": "CRUZ E MAR CONSTRUTORA LTDA",
    "equity": 1015000,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "members": [
      {
        "since": "2010-06-02",
        "person": {
          "id": "ca029f42-03c7-4955-8d5d-b95f7f1ca840",
          "name": "Ronaldo Silveira de Souza",
          "type": "NATURAL",
          "taxId": "***229647**",
          "age": "61-70"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        }
      },
      {
        "since": "2010-06-02",
        "person": {
          "id": "fca12094-6e68-4e04-a539-4da82f8a2748",
          "name": "Mario Antonio Pimentel da Cruz",
          "type": "NATURAL",
          "taxId": "***075747**",
          "age": "61-70"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      }
    ]
  },
  "statusDate": "2018-11-28",
  "status": {
    "id": 4,
    "text": "Inapta"
  },
  "reason": {
    "id": 63,
    "text": "Omissão De Declarações"
  },
  "address": {
    "municipality": 3305752,
    "street": "Rua Manoel Joao Goncalves",
    "number": "115",
    "details": "Sala 106",
    "district": "Centro",
    "city": "Tanguá",
    "state": "RJ",
    "zip": "24890000",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "22",
      "number": "27654147"
    },
    {
      "area": "21",
      "number": "27472365"
    }
  ],
  "emails": [
    {
      "address": "crupocruz@yahoo.com.br",
      "domain": "yahoo.com.br"
    }
  ],
  "mainActivity": {
    "id": 4120400,
    "text": "Construção de edifícios"
  },
  "sideActivities": [
    {
      "id": 4213800,
      "text": "Obras de urbanização - ruas, praças e calçadas"
    },
    {
      "id": 4292801,
      "text": "Montagem de estruturas metálicas"
    },
    {
      "id": 4311801,
      "text": "Demolição de edifícios e outras estruturas"
    },
    {
      "id": 4311802,
      "text": "Preparação de canteiro e limpeza de terreno"
    },
    {
      "id": 4321500,
      "text": "Instalação e manutenção elétrica"
    },
    {
      "id": 4322301,
      "text": "Instalações hidráulicas, sanitárias e de gás"
    },
    {
      "id": 4322302,
      "text": "Instalação e manutenção de sistemas centrais de ar condicionado, de ventilação e refrigeração"
    },
    {
      "id": 4322303,
      "text": "Instalações de sistema de prevenção contra incêndio"
    },
    {
      "id": 4329103,
      "text": "Instalação, manutenção e reparação de elevadores, escadas e esteiras rolantes"
    },
    {
      "id": 4329105,
      "text": "Tratamentos térmicos, acústicos ou de vibração"
    }
  ]
}

Adicionando Simples e CCC:

/office/12086512000282?simples=true&registrations=BR
{
  "updated": "2021-08-31T02:31:00Z",
  "taxId": "12086512000282",
  "alias": "CRUZ E MAR CONSTRUTORA",
  "founded": "2010-08-10",
  "head": false,
  "company": {
    "id": 12086512,
    "name": "CRUZ E MAR CONSTRUTORA LTDA",
    "equity": 1015000,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "simples": {
      "optant": false,
      "since": null
    },
    "simei": {
      "optant": false,
      "since": null
    },
    "members": [
      {
        "since": "2010-06-02",
        "person": {
          "id": "ca029f42-03c7-4955-8d5d-b95f7f1ca840",
          "name": "Ronaldo Silveira de Souza",
          "type": "NATURAL",
          "taxId": "***229647**",
          "age": "61-70"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        }
      },
      {
        "since": "2010-06-02",
        "person": {
          "id": "fca12094-6e68-4e04-a539-4da82f8a2748",
          "name": "Mario Antonio Pimentel da Cruz",
          "type": "NATURAL",
          "taxId": "***075747**",
          "age": "61-70"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      }
    ]
  },
  "statusDate": "2018-11-28",
  "status": {
    "id": 4,
    "text": "Inapta"
  },
  "reason": {
    "id": 63,
    "text": "Omissão De Declarações"
  },
  "address": {
    "municipality": 3305752,
    "street": "Rua Manoel Joao Goncalves",
    "number": "115",
    "details": "Sala 106",
    "district": "Centro",
    "city": "Tanguá",
    "state": "RJ",
    "zip": "24890000",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "22",
      "number": "27654147"
    },
    {
      "area": "21",
      "number": "27472365"
    }
  ],
  "emails": [
    {
      "address": "crupocruz@yahoo.com.br",
      "domain": "yahoo.com.br"
    }
  ],
  "mainActivity": {
    "id": 4120400,
    "text": "Construção de edifícios"
  },
  "sideActivities": [
    {
      "id": 4213800,
      "text": "Obras de urbanização - ruas, praças e calçadas"
    },
    {
      "id": 4292801,
      "text": "Montagem de estruturas metálicas"
    },
    {
      "id": 4311801,
      "text": "Demolição de edifícios e outras estruturas"
    },
    {
      "id": 4311802,
      "text": "Preparação de canteiro e limpeza de terreno"
    },
    {
      "id": 4321500,
      "text": "Instalação e manutenção elétrica"
    },
    {
      "id": 4322301,
      "text": "Instalações hidráulicas, sanitárias e de gás"
    },
    {
      "id": 4322302,
      "text": "Instalação e manutenção de sistemas centrais de ar condicionado, de ventilação e refrigeração"
    },
    {
      "id": 4322303,
      "text": "Instalações de sistema de prevenção contra incêndio"
    },
    {
      "id": 4329103,
      "text": "Instalação, manutenção e reparação de elevadores, escadas e esteiras rolantes"
    },
    {
      "id": 4329105,
      "text": "Tratamentos térmicos, acústicos ou de vibração"
    }
  ],
  "registrations": [
    {
      "state": "RJ",
      "number": "79169617",
      "enabled": false
    }
  ]
}

Consulta básica:

/office/24407389000314
{
  "updated": "2021-08-31T02:27:34Z",
  "taxId": "24407389000314",
  "alias": "PROPAO - LOJA N. 03",
  "founded": "2010-08-05",
  "head": false,
  "company": {
    "id": 24407389,
    "name": "PROPAO PRODUTOS PARA PANIFICACAO LTDA",
    "equity": 1000002,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "members": [
      {
        "since": "2021-05-14",
        "person": {
          "id": "5b22e8ce-aa92-4436-a831-bcd5af9d8c83",
          "name": "F JORDAO HOLDING LTDA",
          "type": "LEGAL",
          "taxId": "41014654000151"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "690d3ef9-0b73-41af-8379-bac3eabce962",
            "name": "Jose Humberto Neves Jordao",
            "type": "NATURAL",
            "taxId": "***484534**",
            "age": "41-50"
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      },
      {
        "since": "2000-08-10",
        "person": {
          "id": "690d3ef9-0b73-41af-8379-bac3eabce962",
          "name": "Jose Humberto Neves Jordao",
          "type": "NATURAL",
          "taxId": "***484534**",
          "age": "41-50"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      },
      {
        "since": "1998-12-07",
        "person": {
          "id": "f83b6b69-1112-4b34-82c7-88fb6c957a91",
          "name": "Francisco Vasconcelos Jordao",
          "type": "NATURAL",
          "taxId": "***747464**",
          "age": "71-80"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      }
    ]
  },
  "statusDate": "2021-01-21",
  "status": {
    "id": 8,
    "text": "Baixada"
  },
  "reason": {
    "id": 1,
    "text": "Extinção Por Encerramento Liquidação Voluntária"
  },
  "address": {
    "municipality": 2612505,
    "street": "Rua Artur Correia de Araujo (lot m Morais)",
    "number": "363",
    "details": null,
    "district": "Sao Cristovao",
    "city": "Santa Cruz do Capibaribe",
    "state": "PE",
    "zip": "55194130",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "81",
      "number": "37279400"
    }
  ],
  "emails": [
    {
      "address": "propao@propao.com.br",
      "domain": "propao.com.br"
    }
  ],
  "mainActivity": {
    "id": 4637199,
    "text": "Comércio atacadista especializado em outros produtos alimentícios não especificados anteriormente"
  },
  "sideActivities": []
}

Adicionando Simples e CCC:

/office/24407389000314?simples=true&registrations=BR
{
  "updated": "2021-08-31T02:27:32Z",
  "taxId": "24407389000314",
  "alias": "PROPAO - LOJA N. 03",
  "founded": "2010-08-05",
  "head": false,
  "company": {
    "id": 24407389,
    "name": "PROPAO PRODUTOS PARA PANIFICACAO LTDA",
    "equity": 1000002,
    "nature": {
      "id": 2062,
      "text": "Sociedade Empresária Limitada"
    },
    "size": {
      "id": 5,
      "acronym": "DEMAIS",
      "text": "Demais"
    },
    "simples": {
      "optant": false,
      "since": null
    },
    "simei": {
      "optant": false,
      "since": null
    },
    "members": [
      {
        "since": "2021-05-14",
        "person": {
          "id": "5b22e8ce-aa92-4436-a831-bcd5af9d8c83",
          "name": "F JORDAO HOLDING LTDA",
          "type": "LEGAL",
          "taxId": "41014654000151"
        },
        "role": {
          "id": 22,
          "text": "Sócio"
        },
        "agent": {
          "person": {
            "id": "690d3ef9-0b73-41af-8379-bac3eabce962",
            "name": "Jose Humberto Neves Jordao",
            "type": "NATURAL",
            "taxId": "***484534**",
            "age": "41-50"
          },
          "role": {
            "id": 5,
            "text": "Administrador"
          }
        }
      },
      {
        "since": "2000-08-10",
        "person": {
          "id": "690d3ef9-0b73-41af-8379-bac3eabce962",
          "name": "Jose Humberto Neves Jordao",
          "type": "NATURAL",
          "taxId": "***484534**",
          "age": "41-50"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      },
      {
        "since": "1998-12-07",
        "person": {
          "id": "f83b6b69-1112-4b34-82c7-88fb6c957a91",
          "name": "Francisco Vasconcelos Jordao",
          "type": "NATURAL",
          "taxId": "***747464**",
          "age": "71-80"
        },
        "role": {
          "id": 49,
          "text": "Sócio-Administrador"
        }
      }
    ]
  },
  "statusDate": "2021-01-21",
  "status": {
    "id": 8,
    "text": "Baixada"
  },
  "reason": {
    "id": 1,
    "text": "Extinção Por Encerramento Liquidação Voluntária"
  },
  "address": {
    "municipality": 2612505,
    "street": "Rua Artur Correia de Araujo (lot m Morais)",
    "number": "363",
    "details": null,
    "district": "Sao Cristovao",
    "city": "Santa Cruz do Capibaribe",
    "state": "PE",
    "zip": "55194130",
    "country": {
      "id": 76,
      "name": "Brasil"
    }
  },
  "phones": [
    {
      "area": "81",
      "number": "37279400"
    }
  ],
  "emails": [
    {
      "address": "propao@propao.com.br",
      "domain": "propao.com.br"
    }
  ],
  "mainActivity": {
    "id": 4637199,
    "text": "Comércio atacadista especializado em outros produtos alimentícios não especificados anteriormente"
  },
  "sideActivities": [],
  "registrations": [
    {
      "state": "PE",
      "number": "040942988",
      "enabled": false
    }
  ]
}
/office/96845456000121
{
  "code": 404,
  "message": "tax id not registered at revenue service"
}

# Tipagem

Propriedade Tipo Descrição
taxId string CNPJ do estabelecimento
alias string Nome fantasia
founded string Data de abertura
head boolean Indica se o estabelecimento é a matriz
company Company Empresa cujo estabelecimento faz parte
statusDate string Data da situação cadastral
status Status Situação cadastral
reason
Se status.id != 2
Reason Motivo da situação cadastral
specialDate string Data da situação especial em formato ISO
special
Se specialDate != null
Special Situação cadastral especial
address Address Endereço de cadastro
phones Phone[] Telefones de cadastro
emails Email[] E-mails de cadastro
mainActivity Activity Atividade econômica principal
sideActivities Activity[] Atividades econômicas secundárias
registrations Registration[] Inscrições estaduais
links Link[] Links públicos para visualização de arquivos

# Gera Mapa Aéreo

GET /office/:taxId/map

Parâmetro Descrição
taxId
Obrigatório
CNPJ sem pontuação

Query

Parâmetro Descrição
type Tipo do mapa:
roadmap : Rodovias
terrain : Terreno
satellite : Satélite
hybrid : Satélite e rodovias
width Largura em pixels de 80 a 640
height Altura em pixels de 80 a 640
scale Multiplicador de densidade de 1 a 2
zoom Nível de ampliação de 1 a 20

# Exemplos

Variações de type

Variações de width x height

Variações de scale

Variações de zoom


# Gera Visão da Rua

GET /office/:taxId/street

Parâmetro Descrição
taxId
Obrigatório
CNPJ sem pontuação

Query

Parâmetro Descrição
width Largura em pixels de 80 a 640
height Altura em pixels de 80 a 640
fov Campo de visão em graus de 60 a 120

# Exemplos

Variações de width x height

Variações de fov