Skip to main content
POST
Cadastrar Prestador

Authorizations

Authorization
string
header
required

Authorization: Bearer nx_... com uma Chave de API, ou o JWT de sessão do painel (Supabase Auth). As duas credenciais representam a mesma Conta.

Body

application/json
cnpj
string
required

CNPJ do Prestador, só dígitos. Único no NotasX.

Pattern: ^\d{14}$
codigo_municipio
string
required

Código IBGE do município do Prestador (Natal/RN = 2408102).

Pattern: ^\d{7}$
op_simp_nac
enum<integer>
required

Situação no Simples Nacional: 1 não optante, 2 MEI, 3 ME/EPP.

Available options:
1,
2,
3
razao_social
string | null

Razão social, opcional (a Sefin usa a do cadastro do CNPJ).

Maximum string length: 300
inscricao_municipal
string | null

Inscrição municipal, se o município exigir.

Maximum string length: 15

Response

Successful Response

id
string<uuid>
required

Id do Prestador no NotasX.

cnpj
string
required

CNPJ, só dígitos.

razao_social
string | null
required

Razão social informada no cadastro.

codigo_municipio
string | null
required

Código IBGE do município.

inscricao_municipal
string | null
required

Inscrição municipal, se informada.

op_simp_nac
integer | null
required

1 não optante, 2 MEI, 3 ME/EPP do Simples Nacional.

ambiente
enum<string>
required

Ambiente das próximas Notas. Começa em homologacao; muda com ativar-producao.

Available options:
homologacao,
producao
ativo
boolean
required

true quando há Certificado ativo do próprio CNPJ.

certificado_valido_ate
string<date-time> | null
required

Validade do Certificado ativo; null sem Certificado.