Emissão de NFS-e

Valida uma NFS-e sem emitir

Exatamente a mesma validação e normalização de POST /v1/nfse, sem criar nota, sem reservar número de DPS e sem transmitir. Devolve a nota como ela seria emitida, os ajustes, todos os erros e a prontidão da empresa. valida só é true se não houver erro nem item de prontidão com bloqueio.

post/v1/nfse/validacoes

Request

Base URL: https://api.sudrel.com.br/api
URL: https://api.sudrel.com.br/api/v1/nfse/validacoes
Auth: HTTP bearer

Request body

empresa_idstring

Empresa emissora. Dispensado quando a chave de API é restrita a uma empresa.

referenciastring

Seu identificador para esta nota (pedido, contrato). Único por empresa; repetido é 409 com o id da nota existente.

modelostring

Nome ou id de um modelo de emissão salvo no painel. Preenche descrição, código de serviço e competência quando não enviados.

valorstring required

Texto decimal com ponto, sem separador de milhar. Número JSON é recusado (422 tipo_invalido).

Example request

{
  "tomador": {
    "documento": "11222333000181",
    "endereco": {
      "cep": "40020000"
    }
  },
  "valor": "1500.00",
  "servico": {
    "codigo_nacional": "010701",
    "competencia": "2026-09",
    "nbs": "1.1302.21.00",
    "obra": {
      "endereco": {
        "cep": "40020000"
      }
    }
  },
  "retencoes": {
    "pis": {
      "valor": "1500.00",
      "aliquota": "2.5"
    },
    "cofins": {
      "valor": "1500.00",
      "aliquota": "2.5"
    },
    "csll": {
      "valor": "1500.00",
      "aliquota": "2.5"
    },
    "irrf": {
      "valor": "1500.00",
      "aliquota": "2.5"
    },
    "inss": {
      "valor": "1500.00",
      "aliquota": "2.5"
    }
  },
  "apuracao_propria": {
    "pis": {
      "valor": "1500.00",
      "aliquota": "2.5"
    },
    "cofins": {
      "valor": "1500.00",
      "aliquota": "2.5"
    }
  },
  "iss": {
    "aliquota": "2.5"
  }
}

Response

Resultado da validação (válida ou não).

validaboolean

empresa_idstring nullable

referenciastring nullable

notaobject nullable

Mesmas seções de conteúdo de Nfse (valor, tomador, serviço, retenções, apuração própria, ISS).

Example response

{
  "ajustes": [
    {
      "campo": "/prestador/inscricao_municipal",
      "regra": "correcao.E0120"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.