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.
/openapi/v2/empresastoken, 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 |
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
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) o10019004(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; enviarProducaoantes del cambio devuelve10004030(NF-e) o10019012(DC-e). Vea Entornos. - El régimen tributario se deriva de
meiyoptanteSimplesNacional; 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.
{"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.
{"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.
{"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.
{"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 (cámbielo en la consola, en «Datos tributarios») ni ambiente. Sin emissaoNFeProduto las series de NF-e quedan como están; con él, vea «Definir la numeración de NF-e» abajo. 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.
Empresas del registro automático. Para empresas creadas por Registrar empresa automáticamente la actualización también completa los pendientes: si la empresa está en borrador o rechazada y aún no tiene inscripción estatal, se guarda inscricaoEstadual; si el régimen está pendiente de confirmación, mei y optanteSimplesNacional pasan a definirlo (sin esa pendencia el régimen sigue sin actualizarse); un borrador que quede con los datos completos entra en análisis automáticamente; una rechazada solo vuelve a análisis, manual, cuando la actualización completa un campo que estaba pendiente (vale para cualquier borrador o rechazada de esta cuenta, incluidos los creados en la consola). Lo que falta aparece en camposPendentes de Consultar empresa.
Definir la numeración de NF-e
Para empresas sin serie de NF-e (como las del registro automático) o que cambian de serie o de próximo número. Si la serieNFe aún no tiene serie, se crea con sequencialNFe como próximo número; si ya existe, el próximo número pasa a ser sequencialNFe y una serie deshabilitada vuelve a quedar habilitada. Las demás series de NF-e de la empresa se deshabilitan, para que la emisión use solo esta.
sequencialNFe puede ir a menos o a más, y la responsabilidad es de quien llama: a menos, se emiten de nuevo números ya usados y la SEFAZ los rechaza como duplicados; a más, los números intermedios quedan saltados y no se inutilizan automáticamente (inutilícelos por su cuenta si corresponde). Los números de emisiones anteriores no autorizadas y menores que sequencialNFe se siguen usando primero. Por encima de 999999999 devuelve 400 10001001.
{"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" },"emissaoNFeProduto": { "ambienteProducao": { "sequencialNFe": 1501, "serieNFe": "10" } }}
id* | string | Identificador de la empresa |
* | object | Configuración de NF-e |
* Campo obligatorio
Habilitar DC-e después
Empresa registrada sin emissaoDCe. Si ninguna serie de DC-e está habilitada, se crea a partir de sequencialDCe / serieDCe.
{"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.
{"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.
{"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.
{"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
mei + optanteSimplesNacionalRégimen tributario de la empresa
No hay campo propio: el régimen sale de la combinación de los dos booleanos y se guarda como CRT. mei=true prevalece. Ninguna combinación da CRT 2 (exceso de sublímite), que se define en la consola; Lucro Presumido, Real o Arbitrado son todos CRT 3. Vea «Régimen tributario» en Empresas.
| Valores | Significado |
|---|---|
| mei=true | CRT 4, MEI, microemprendedor individual; optanteSimplesNacional se ignora; emissaoNFSe.regimeApuracaoSn no es necesario |
| mei=false, optanteSimplesNacional=true | CRT 1, Simples Nacional, ME o EPP; una empresa con exceso de sublímite también envía esto; con emissaoNFSe exige regimeApuracaoSn |
| mei=false, optanteSimplesNacional=false | CRT 3, Regime Normal, incluido Lucro Presumido, Real o Arbitrado; emissaoNFSe.regimeApuracaoSn no puede enviarse |
endereco.ufEstado 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.tipoEmitenteTipo 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.regimeApuracaoSnCá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.regimeEspecialTributacaoRé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. |
