Empresas

Qué es una empresa

Una empresa (empresa) es la entidad legal en cuyo nombre se emiten los documentos: el vendedor de un marketplace, una transportadora o un integrador que emite para sí mismo. Toda empresa se identifica por el empresaId devuelto por Registrar empresa, que es la variable de ruta de todos los endpoints de emisión, consulta y cancelación.

Ciclo de vida

1. Registro: una llamada exitosa a Registrar empresa coloca la empresa en la cola de aprobación de la plataforma. Registrar el mismo CNPJ de nuevo devuelve 10003002; reutilice el empresaId original o envíe una actualización con id.
2. Certificado: vincule el certificado A1. El certificado debe pertenecer al CNPJ de la empresa (10003010), estar vigente (10003011) y ser distinto del actualmente activo (10003012); una contraseña incorrecta devuelve CER0005. Un envío exitoso reemplaza el certificado anterior.
3. Aprobación: operaciones aprueba la empresa. La empresa solo emite después de que operaciones la apruebe y el certificado esté vinculado. Emitir antes devuelve 10004004 para NF-e (DCe00008 para DC-e, 10017004 para CT-e). Consulte el avance de la aprobación con operaciones de la plataforma.
4. Entorno: toda empresa tiene un entorno actual, pruebas Homologacao o producción Producao. Las empresas recién registradas comienzan en pruebas; el cambio a producción es una acción de operaciones, sin API. El valor de entorno en toda solicitud de emisión (ambienteEmissao para NF-e y CT-e, ambiente para DC-e) debe coincidir con el entorno actual de la empresa; una discrepancia devuelve 10004030 (NF-e), 10017010 (CT-e) o DCe00004 (DC-e), una protección estricta contra documentos de prueba emitidos en producción. Vea Entornos.

Nota: una actualización (cuerpo con id) nunca vuelve a enviar la empresa a revisión ni cambia su estado o entorno.

Una empresa, tres tipos de documento

El mismo empresaId, el mismo certificado y el mismo webhook atienden todos los tipos de documento. Lo que cambia es la serie de numeración que cada tipo exige:

• emissaoNFeProduto y emissaoDCe son cada uno opcional, pero al menos uno es obligatorio. Una empresa solo de NF-e envía el primero, una empresa solo de DC-e puede omitirlo (no se crea ninguna serie del modelo 55) y enviar ambos habilita los dos tipos. Omitir ambos devuelve 400 10001001.
• La serie y el próximo número enviados en el registro son los que se usan en la emisión; después la plataforma gestiona la secuencia.
• La emisión de CT-e exige además que el CNPJ esté habilitado para CT-e en la SEFAZ estatal; sin ello la SEFAZ rechaza con 230 - IE do emitente não cadastrada, lo que la plataforma no puede resolver.

Derivación del régimen tributario

El régimen de la empresa se deriva de dos booleanos enviados en el registro y no puede cambiarse mediante actualización:

El régimen determina la familia de código tributario que un ítem de NF-e puede usar (CSOSN para Simples / MEI, CST para el régimen normal); vea NF-e. inscricaoEstadual es obligatoria en esta plataforma: si falta devuelve 10003006.

Habilitar DC-e

El DC-e (modelo 99) se habilita con el bloque emissaoDCe:

"emissaoDCe": {
  "ambienteProducao": {
    "tipoEmitente": "Marketplace",
    "sequencialDCe": 1,
    "serieDCe": "1",
    "siteMarketplace": "https://loja.exemplo.com.br"
  }
}

• tipoEmitente es Marketplace (una plataforma que emite en nombre de vendedores no contribuyentes / personas físicas) u OwnIssuer (una empresa que emite para sí misma). Carrier puede registrarse, pero la emisión se rechaza con 10019013 hasta que se publique el nuevo paquete de schema. siteMarketplace es obligatorio para Marketplace.
• Una empresa registrada sin emissaoDCe no queda habilitada para DC-e: el registro se acepta, la respuesta trae dceHabilitado=false y la emisión devuelve DCe00004. Verifique ese campo justo después de registrar.
• Para habilitar DC-e después, reenvíe el payload de registro con id y el bloque emissaoDCe. La serie del modelo 99 solo avanza: sequencialDCe puede elevar el próximo número, pero nunca reducirlo (400 10001001), y cambiar serieDCe mientras la serie anterior sigue habilitada se rechaza (400 10001001, pase por operaciones).

Códigos de error relacionados

La lista completa está en Códigos de error.