Companies
Query company
Returns the company data, review status, enabled documents and certificate summary.
/openapi/v2/empresas/{empresaId}token, timestamp and sign signature headers, see Authentication.Registration fields have the same names as the Register company request, and nfceHabilitado / nfseHabilitado / dceHabilitado are the same as in the registration response. A company only issues with status Ativa and certificado.possuiCertificadoValido true. A company of another account answers exactly like a missing one, 10003000. Not billed.
For companies created by Register company automatically, use this query to follow up: in Rascunho or Rejeitada the response carries camposPendentes with what is missing; complete it with Register company (body with id) and, once everything is filled in, the company goes to review automatically. While the tax regime is pending confirmation, optanteSimplesNacional and mei are null and listed in camposPendentes.
The two booleans do not tell CRT 1 from CRT 2 (over the sublimit): both come back true / false. See "Tax regime" in Companies.
Path parameters
empresaId* | string | Company identifier |
* Required field
empresaId | string | Company identifier |
cnpj | string | CNPJ |
razaoSocial | string | Legal name |
nomeFantasia | string | Trade name |
inscricaoEstadual | string | State registration |
inscricaoMunicipal | string | Municipal registration |
optanteSimplesNacional | bool | Simples member |
mei | bool | MEI |
email | string | Contact e-mail |
telefoneComercial | string | Business phone |
| object | Address |
status | string | Company status |
motivoStatus | string | Rejection reason |
camposPendentes | array | Pending fields |
dataEnvioAprovacao | string | Sent for review |
dataAprovacao | string | Review completed |
ambienteEmissao | string | Issuing environment |
nfeHabilitado | bool | NF-e enabled |
nfceHabilitado | bool | NFC-e enabled |
nfseHabilitado | bool | NFS-e configured |
dceHabilitado | bool | DC-e enabled |
| object | A1 certificate summary |
dataCriacao | string | Registration time |
statusCompany status
| Values | Meaning |
|---|---|
| Rascunho | Saved and not yet sent for review; camposPendentes lists what is missing |
| AguardandoAprovacao | Under platform review; cannot issue yet |
| Ativa | Approved; can issue once a valid certificate is linked |
| Rejeitada | Refused at review; motivoStatus carries the reason. Fix and resubmit in the console; if it had fields in camposPendentes, completing them with Register company (body with id) sends it back to manual review |
| Inativa | Disabled; does not issue until re-enabled in the console |
camposPendentesPending fields
| Values | Meaning |
|---|---|
| inscricaoEstadual | State registration missing. Not required from a company that only issues NFS-e (NFS-e profile and no NF-e series) |
| optanteSimplesNacional | Tax regime pending confirmation; always comes together with mei. Send both to set the regime |
| mei | Tax regime pending confirmation; always comes together with optanteSimplesNacional |
| endereco.logradouro | Address street missing |
| endereco.numero | Address number missing |
| endereco.bairro | Address district missing |
| endereco.cep | Address postal code missing |
ambienteEmissaoEnvironment
| Values | Meaning |
|---|---|
| Homologacao | Homologation (testing); default for every newly registered company |
| Producao | Production; the switch is done by platform operations |
certificado.statusCertificate status
| Values | Meaning |
|---|---|
| Nenhum | No certificate linked |
| Valido | Certificate in force |
| ProximoVencimento | In force but expiring soon; still issues |
| Vencido | Expired; link a new certificate to issue again |
| Code | HTTP | |
|---|---|---|
| 10003000 | 404 | empresaId does not exist or belongs to another integrator account. |
| 10009005 | 403 | The application is not subscribed to this interface. Ask the platform to subscribe it. |
