Notas de serviço,
integradas ao seu sistema.

Autenticação

Cada conta cria e gerencia suas chaves no painel. Envie a chave no cabeçalho Authorization em todas as chamadas. O token completo aparece uma vez; guarde-o no cofre da sua integração.

Emitir uma NFS-e

O serviço deve estar previamente configurado no emitente com os códigos de tributação municipal e nacional, alíquota e retenção confirmados pelo contador. A referência é única por emitente: repetir uma chamada não cria outra nota.

Corpo da requisição

curl --request POST 'https://nf.iasolux.com.br/v1/nfse' \
  --header "Authorization: Bearer $CHAVE_NFE" \
  --header 'Content-Type: application/json' \
  --data @- <<JSON
{
  "emitenteId": 12,
  "referencia": "venda-90814",
  "servico": "ipbx",
  "valor": "89.90",
  "descricao": "Plano de telefonia em nuvem, competência do mês",
  "tomador": {
    "documento": "${CPF_TOMADOR}",
    "nome": "${NOME_TOMADOR}",
    "email": "${EMAIL_TOMADOR}"
  }
}
JSON

Se IBS/CBS estiver configurado com indDest=1, inclua destinatario no pedido com documento e nome do destinatário. Esse dado é obrigatório quando ele difere do tomador.

Resposta autorizada · HTTP 201

{
  "ok": true,
  "repetida": false,
  "nfse": {
    "id": 38,
    "referencia": "venda-90814",
    "status": "autorizada",
    "chaveAcesso": "chave retornada pela Sefin Nacional",
    "numero": "número nacional",
    "pdf": "https://nf.iasolux.com.br/v1/nfse/38/pdf",
    "xml": "https://nf.iasolux.com.br/v1/nfse/38/xml"
  }
}

Uma referência já recebida retorna a nota existente e repetida: true, sem novo envio ao governo.

Consultar uma NFS-e

Consulte pelo identificador devolvido na emissão. Os links de PDF e XML continuam protegidos pela mesma chave.

curl 'https://nf.iasolux.com.br/v1/nfse/38' \
  --header "Authorization: Bearer $CHAVE_NFE"

Para localizar notas pela referência externa:

A situação pode ser processando, autorizada, rejeitada, cancelada, ambigua ou em_cancelamento.

Cancelar uma nota

Envie um pedido de cancelamento de NFS-e autorizada. O evento recebe assinatura XMLDSig do A1 do emitente e segue para a Sefin Nacional em Produção Restrita.

curl --request POST 'https://nf.iasolux.com.br/v1/nfse/38/cancelar' \
  --header "Authorization: Bearer $CHAVE_NFE" \
  --header 'Content-Type: application/json' \
  --data '{"codigo":"2","motivo":"O serviço não foi prestado ao tomador."}'

Webhook

Cadastre uma URL HTTPS no painel. A cada alteração de situação, enviaremos um JSON e a assinatura HMAC-SHA256 no cabeçalho X-IaSolux-Assinatura. Compare a assinatura em tempo constante usando os bytes exatos recebidos.

{
  "evento": "autorizada",
  "id": 38,
  "referencia": "venda-90814",
  "status": "autorizada",
  "chaveAcesso": "chave retornada pela Sefin Nacional",
  "numero": "número nacional",
  "valor": "89.90"
}

Eventos disponíveis: autorizada, rejeitada, ambigua, cancelada e em_cancelamento. Falhas recebem novas tentativas com intervalo crescente.

Códigos de erro