Skip to main content
POST
Cadastrar empresa emissora

Authorizations

Authorization
string
header
required

Token JWT obtido via /v1/auth/login

Body

application/json
cnpj
string
required
name
string
required
Required string length: 1 - 150
tradeName
string
Maximum string length: 150
ie
string
im
string
crt
integer
Required range: -9007199254740991 <= x <= 9007199254740991
email
string<email>
Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
phone
string
cep
string
address
string
Maximum string length: 150
number
string
complement
string
neighborhood
string
Maximum string length: 150
city
string
Maximum string length: 150
state
string
ibgeCode
string
csc
string

Código de Segurança do Contribuinte (CSC) da NFC-e, gerado no portal da SEFAZ da UF. SEGREDO: cifrado em repouso e nunca devolvido pela API. Aceita apenas caracteres imprimíveis sem espaço: espaço, quebra de linha e caracteres invisíveis são recusados porque alterariam o hash do QR-Code (CStat 464). String vazia limpa o campo.

Pattern: ^(|[\x21-\x7E]+)$
cscId
string

Identificador do CSC (cIdToken do leiaute da NFC-e): numérico de 1 a 6 dígitos, como aparece ao lado do código no portal da SEFAZ. Entra no hash do QR-Code junto com o CSC, por isso tem que ser exatamente o par registrado na SEFAZ. String vazia limpa o campo.

Pattern: ^(|\d{1,6})$
cnae
string
segmento
string
mei
boolean
fiscalBrainEnabled
boolean
valorAproximadoTributosEnabled
boolean
canalPortaAPorta
boolean
cTribNacPadrao
string
Pattern: ^\d{6}$
servicoPadraoLc116
string
Pattern: ^\d{2}\.\d{2}$
pTotTribSNPadrao
number
Required range: x <= 100
pTotTribSNCompetencia
string
Pattern: ^\d{4}-(0[1-9]|1[0-2])$

Response

Empresa cadastrada. Corpo = cadastro (sem segredos) + prontoPara (readiness por documento) + avisos[] (vazio ou o aviso nomeado de município não aderente) + sugestoesServicoPadrao (só quando o CNAE tem 2+ opções não resolvidas).

id
string
required
cnpj
string
required
name
string
required
ambienteFiscal
number
required
avisos
object[]
required
tradeName
string | null
ie
string | null
im
string | null
crt
number
email
string | null
phone
string | null
cep
string | null
address
string | null
number
string | null
complement
string | null
neighborhood
string | null
city
string | null
state
string | null
ibgeCode
string | null
fiscalBrainEnabled
boolean
valorAproximadoTributosEnabled
boolean
canalPortaAPorta
boolean
createdAt
string<date-time>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updatedAt
string<date-time>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
prontoPara
object
sugestoesServicoPadrao
any[]