1. Configurações de NFS-e
  2. Atualizar configurações de NFS-e
PUT
/organizations/settings-nfse
curl --request PUT \
     --url https://api.treeunfe.com.br/api/v1/organizations/settings-nfse \
     --header 'x-api-key: <api-key>' \
     --header 'x-api-key: <x_api_key>' \
     --header 'Content-Type: application/json' \
     --data '{
  "tpAmb": "<string>",
  "CRT": "<string>",
  "IM": "<string>",
  "regEspTrib": "<string>",
  "regApTribSN": "<string>",
  "serieHomologacao": 123.45,
  "nDPSHomologacao": 123.45,
  "serieProducao": 123.45,
  "nDPSProducao": 123.45,
  "ultimoNsuDistribuicao": 123.45,
  "maxNsuDistribuicao": 123.45,
  "autoSendEmailEnabled": true
}'

Atualiza as configurações fiscais de NFS-e. Envie só os campos que mudaram.

Esta rota não cria configuração nova. Se a empresa ainda não tem configurações de NFS-e, faça a configuração inicial no emissor.

​
Autenticação

x-api-key
required
string

API Key da empresa.

​
Body

application/json

tpAmb
string

Ambiente de emissão: HOMOLOGACAO ou PRODUCAO.

CRT
string

Regime tributário: NORMAL, SN (Simples Nacional), SN_EXC (Simples com excesso de sublimite) ou MEI.

IM
string

Inscrição municipal.

regEspTrib
string

Regime especial de tributação: NENHUM, ATO_COOPERADO_COOPERATIVA, ESTIMATIVA, MICROEMPRESA_MUNICIPAL, NOTARIO_OU_REGISTRADOR, PROFISSIONAL_AUTONOMO, SOCIEDADE_DE_PROFISSIONAIS ou OUTROS.

regApTribSN
string

Regime de apuração no Simples Nacional: REGIME_SN_INTEGRAL, REGIME_SN_FED_ISS_FORA ou REGIME_FORA_SN.

serieHomologacao
number

Série da DPS em homologação.

nDPSHomologacao
number

Último número de DPS usado em homologação.

serieProducao
number

Série da DPS em produção.

nDPSProducao
number

Último número de DPS usado em produção.

ultimoNsuDistribuicao
number

Último NSU baixado da ADN. A próxima distribuição continua a partir dele.

maxNsuDistribuicao
number

Maior NSU disponível na ADN na última consulta. Pode ser null.

autoSendEmailEnabled
boolean

true envia a NFS-e por e-mail automaticamente depois de autorizada.

​
Respostas

StatusDescrição
200Configurações atualizadas.
400A empresa ainda não tem configurações de NFS-e. Configure no emissor.
401x-api-key ausente ou inválida.
curl -X PUT "https://api.treeunfe.com.br/api/v1/organizations/settings-nfse" \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tpAmb": "HOMOLOGACAO",
    "autoSendEmailEnabled": true
  }'