Empresas

Registrar empresa

Registra la empresa emisora (o la actualiza cuando el cuerpo lleva `id`) y devuelve el `empresaId` usado por todos los demás endpoints.

POST/openapi/v2/empresas

Requiere las cabeceras de firma token, timestamp y sign, vea Autenticación.

Envíe los datos de la empresa del vendedor; la respuesta trae el empresaId, variable de ruta de todos los endpoints siguientes. Los bloques emissaoNFeProduto, emissaoNFeConsumidor, emissaoDCe y emissaoNFSe son cada uno opcional, pero al menos uno es obligatorio: envíe el bloque de cada tipo de documento que la empresa va a emitir; omitir todos devuelve 400 10001001. Un cuerpo con id se trata como actualización, vea la sección correspondiente más abajo.

Cuerpo de la petición

`id*` Obligatorio para actualizar.	string	Identificador de la empresa
`cnpj*`	string	CNPJ de la empresa
`inscricaoMunicipal`	string	Inscripción municipal
`inscricaoEstadual*` Obligatoria para NF-e / NFC-e / DC-e.	string	Inscripción estatal
`razaoSocial*`	string	Razón social
`nomeFantasia`	string	Nombre comercial
`optanteSimplesNacional*`	bool	Optante del Simples Nacional
`mei*`	bool	Microemprendedor individual
`email*`	string	Correo de contacto
`telefoneComercial*`	string	Teléfono comercial
`*`	object	Dirección de la empresa
`*` Al menos uno entre emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe.	object	Configuración de NF-e
`*` Al menos uno entre emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe.	object	Configuración de NFC-e
`*` Al menos uno entre emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe.	object	Configuración de DC-e
`*` Al menos uno entre emissaoNFeProduto / emissaoNFeConsumidor / emissaoDCe / emissaoNFSe.	object	Configuración de NFS-e

* Campo obligatorio

200

Registro aceptado y colocado en la cola de aprobación (o actualización aplicada). Se devuelve el mismo formato en ambos casos.

`empresaId`	string	Identificador de la empresa
`dceHabilitado`	bool	DC-e habilitado
`nfseHabilitado`	bool	NFS-e habilitado
`nfceHabilitado`	bool	NFC-e habilitada

El registro entra en la cola de aprobación de la plataforma; la empresa emite solo después de que operaciones la apruebe y el certificado esté vinculado (Vincular certificado). Emitir antes devuelve 10004004 (NF-e) o 10019004 (DC-e). Consulte el avance con operaciones de la plataforma.
Tras el registro la empresa queda en el entorno de certificación: integre con ambienteEmissao=Homologacao (NF-e) / ambiente=Homologacao (DC-e). El cambio a producción es una acción de operaciones, sin API; enviar Producao antes del cambio devuelve 10004030 (NF-e) o 10019012 (DC-e). Vea Entornos.
El régimen tributario se deriva de mei y optanteSimplesNacional; no hay campo propio.

Envíe el bloque de configuración de cada tipo de documento que la empresa va a emitir. Los datos de la empresa son siempre los mismos; cada escenario muestra solo lo que cambia.

Solo NF-e

El caso más común. inscricaoEstadual obligatoria.

json

{
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFeProduto": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "10" } }
}

`inscricaoEstadual*`	string	Inscripción estatal
`*`	object	Configuración de NF-e

* Campo obligatorio

NF-e y NFC-e

Tienda que vende en mostrador y también factura a empresas. La serie de la NFC-e es distinta de la serie de la NF-e. inscricaoEstadual obligatoria.

json

{
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFeProduto": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "10" } },
  "emissaoNFeConsumidor": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "1" } }
}

`inscricaoEstadual*`	string	Inscripción estatal
`*`	object	Configuración de NFC-e

* Campo obligatorio

Solo NFS-e

Empresa de servicios sin inscripción estatal. inscricaoMunicipal es la inscripción en la alcaldía; en São Paulo es el CCM.

json

{
  "cnpj": "14422279000106",
  "inscricaoMunicipal": "999999",
  "razaoSocial": "Servicos teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "servicos-teste@exemplo.com.br",
  "telefoneComercial": "1133334444",
  "endereco": { "pais": "Brasil", "uf": "SP", "cidade": "Sao Paulo", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" },
  "emissaoNFSe": { "serieDps": "1", "sequencialDps": 1, "regimeApuracaoSn": 1 }
}

`inscricaoMunicipal`	string	Inscripción municipal
`*`	object	Configuración de NFS-e

* Campo obligatorio

NF-e y DC-e como marketplace

Plataforma que emite DC-e por terceros. siteMarketplace es obligatorio; Carrier puede registrarse, pero no emite.

json

{
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFeProduto": { "ambienteProducao": { "sequencialNFe": 1, "serieNFe": "10" } },
  "emissaoDCe": { "ambienteProducao": { "tipoEmitente": "Marketplace", "sequencialDCe": 1, "serieDCe": "1", "siteMarketplace": "https://loja.exemplo.com.br" } }
}

*

object

Configuración de DC-e

* Campo obligatorio

El mismo endpoint con id en el cuerpo es una actualización: reenvíe el payload de registro añadiendo id, pues los demás campos siguen validándose con las reglas de registro. No actualiza cnpj, razaoSocial, inscricaoEstadual, inscricaoMunicipal, régimen tributario ni ambiente; emissaoNFeProduto se ignora. Cambiar de municipio (uf / cidade) devuelve 400 10001001 y pasa por operaciones. La actualización no reenvía la empresa a aprobación ni cambia su estado; la respuesta es la misma que en el registro.

Habilitar DC-e después

Empresa registrada sin emissaoDCe. Si ninguna serie de DC-e está habilitada, se crea a partir de sequencialDCe / serieDCe.

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoDCe": { "ambienteProducao": { "tipoEmitente": "OwnIssuer", "sequencialDCe": 1, "serieDCe": "1" } }
}

`id*`	string	Identificador de la empresa
`*`	object	Configuración de DC-e

* Campo obligatorio

Elevar el próximo número del DC-e

Misma serie, sequencialDCe mayor que el próximo número actual. Igual al actual no cambia nada; menor devuelve 400 10001001. Los números saltados nunca se emiten. Cambiar serieDCe con la anterior habilitada también devuelve 400 10001001.

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoDCe": { "ambienteProducao": { "tipoEmitente": "OwnIssuer", "sequencialDCe": 500, "serieDCe": "1" } }
}

`id*`	string	Identificador de la empresa
`*`	object	Configuración de DC-e

* Campo obligatorio

Corregir contacto y dirección

Solo cambian nomeFantasia, email, telefoneComercial y los campos de dirección dentro del mismo municipio. Los campos vacíos no borran el valor guardado.

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "nomeFantasia": "Loja Teste",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "financeiro@exemplo.com.br",
  "telefoneComercial": "3133334444",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Nova", "numero": "10", "complemento": "Sala 2", "bairro": "Centro", "cep": "30110000" }
}

`id*`	string	Identificador de la empresa
`nomeFantasia`	string	Nombre comercial
`email`	string	Correo de contacto
`telefoneComercial`	string	Teléfono comercial
`*`	object	Dirección

* Campo obligatorio

Crear o sustituir el perfil de NFS-e

Enviar emissaoNFSe sustituye el perfil entero; los campos omitidos vuelven al valor por defecto. La serie ya creada no cambia: sequencialDps solo vale cuando la serie aún no existe.

json

{
  "id": "1934811222334455",
  "cnpj": "14422279000106",
  "inscricaoEstadual": "999999",
  "razaoSocial": "Empresa teste LTDA",
  "optanteSimplesNacional": true,
  "mei": false,
  "email": "empresa-teste@exemplo.com.br",
  "telefoneComercial": "6122222222",
  "endereco": { "pais": "Brasil", "uf": "MG", "cidade": "Belo Horizonte", "logradouro": "Rua Teste", "numero": "999", "bairro": "Bairro Teste", "cep": "85100000" },
  "emissaoNFSe": { "serieDps": "1", "sequencialDps": 120, "regimeApuracaoSn": 1, "regimeEspecialTributacao": 0 }
}

`id*`	string	Identificador de la empresa
`*`	object	Configuración de NFS-e

* Campo obligatorio

`endereco.uf`Estado de la empresa

Valores	Significado
AC	Acre
AL	Alagoas
AP	Amapá
AM	Amazonas
BA	Bahia
CE	Ceará
DF	Distrito Federal
ES	Espírito Santo
GO	Goiás
MA	Maranhão
MT	Mato Grosso
MS	Mato Grosso do Sul
MG	Minas Gerais
PA	Pará
PB	Paraíba
PR	Paraná
PE	Pernambuco
PI	Piauí
RJ	Rio de Janeiro
RN	Rio Grande do Norte
RS	Rio Grande do Sul
RO	Rondônia
RR	Roraima
SC	Santa Catarina
SP	São Paulo
SE	Sergipe
TO	Tocantins

`emissaoDCe.ambienteProducao.tipoEmitente`Tipo de emisor del DC-e

Sin distinguir mayúsculas.

Valores	Significado
Marketplace	Plataforma de e-commerce que emite por terceros; exige `siteMarketplace`
OwnIssuer	Empresa que emite por sí misma
EmissorProprio	Igual que `OwnIssuer`
Carrier	Transportista; registro aceptado, emisión rechazada con `10019013`
Transportadora	Igual que `Carrier`

`emissaoNFSe.regimeApuracaoSn`Cálculo en el Simples Nacional

Solo para ME/EPP: optanteSimplesNacional=true y mei=false.

Valores	Significado
1	Tributos federales y municipal por el Simples Nacional
2	Federales por el Simples Nacional; ISS en valor fijo municipal
3	Federales por el Simples Nacional; ISS por la alícuota normal del municipio

`emissaoNFSe.regimeEspecialTributacao`Régimen especial de tributación

Omitido vale 0.

Valores	Significado
0	Ninguno
1	Acto cooperativo
2	Estimación
3	Microempresa municipal
4	Notarial y registral
5	Profesional autónomo
6	Sociedad de profesionales

Código	HTTP
10003002	400	CNPJ ya registrado. La empresa existe: use el `empresaId` original o actualice con `id`.
10003000	404	Actualización: `id` no existe o no pertenece a esta aplicación.
10003006	400	Falta un dato obligatorio: `inscricaoEstadual` en empresa de NF-e / DC-e, o `siteMarketplace` con `tipoEmitente=Marketplace`. El mensaje nombra el campo.
10003004	400	Ciudad y estado no se resuelven a un código IBGE. Verifique `endereco.uf` y `endereco.cidade`.
10001001	400	Falló la validación de campos, una entrada por campo, o error de contrato: ningún bloque de configuración, `tipoEmitente` inválido, actualización cambiando `cnpj` o municipio, `sequencialDCe` menor que el actual, cambio de serie. Corrija según `mensagem`.

Registrar empresa

Parámetros

Cuerpo de la petición

Respuestas

Reglas de registro

Escenarios de registro4 bloques

Solo NF-e

NF-e y NFC-e

Solo NFS-e

NF-e y DC-e como marketplace

Actualización (cuerpo con id)4 bloques

Habilitar DC-e después

Elevar el próximo número del DC-e

Corregir contacto y dirección

Crear o sustituir el perfil de NFS-e

Enumeraciones4 tablas

endereco.ufEstado de la empresa

emissaoDCe.ambienteProducao.tipoEmitenteTipo de emisor del DC-e

emissaoNFSe.regimeApuracaoSnCálculo en el Simples Nacional

emissaoNFSe.regimeEspecialTributacaoRégimen especial de tributación

Errores5 ítems

`endereco.uf`Estado de la empresa

`emissaoDCe.ambienteProducao.tipoEmitente`Tipo de emisor del DC-e

`emissaoNFSe.regimeApuracaoSn`Cálculo en el Simples Nacional

`emissaoNFSe.regimeEspecialTributacao`Régimen especial de tributación