Problema com a emissão de NFS-e

Documentos Fiscais
1

Olá, equipe da Nuvem Fiscal,

Estou implementando a emissão de NFS-e utilizando a rota /nfse/dps com o método POST. No entanto, estou enfrentando um problema: recebo um erro com status code 400. Revisei a documentação várias vezes, mas ainda não consegui identificar a causa do problema.

Para facilitar a análise, segue abaixo o corpo da requisição que estou enviando:

{
  "ambiente": "homologacao",
  "provedor": "padrao",
  "infDPS": {
    "dhEmi": "2025-04-16T14:53:54.065Z",
    "prest": {
      "CNPJ": "53527882000104"
    },
    "serv": {
      "locPrest": {
        "cLocPrestacao": "3550308"
      },
      "cServ": {
        "cTribNac": "170101",
        "CNAE": "4789099",
        "xDescServ": "3x Serviço de limpeza completa, lubrificação dos rolamentos, ajuste da engrenagem, desobstrução de papel nas engrenagens, limpeza dos rolamentos, preventiva completa  |  3  |  R$ 250.00  |  R$ 750.00"
      }
    },
    "valores": {
      "vServPrest": {
        "vServ": 750
      },
      "trib": {
        "tribMun": {
          "tribISSQN": 2,
          "cLocIncid": "3550308"
        }
      }
    },
    "toma": {
      "orgaoPublico": false,
      "CNPJ": "16559342000186",
      "xNome": "CCY DO BRASIL LTDA CCY",
      "email": "comercial@ccy.com.br",
      "end": {
        "endNac": {
          "cMun": "3550308",
          "CEP": "01131000"
        },
        "xLgr": "Rua dos Italianos",
        "nro": "902",
        "xCpl": "SALA 02",
        "xBairro": "Bom Retiro"
      }
    }
  }
}

Poderiam, por favor, me orientar sobre os possíveis motivos desse erro? Existe algum parâmetro incorreto ou algum detalhe na estrutura do JSON que precise ser ajustado?

Agradeço desde já pela atenção e aguardo um retorno para que possamos solucionar essa questão.

Atenciosamente,

4

Bom dia, @marcelo1.

Entendemos que você está recebendo um erro HTTP 400 ao tentar emitir uma NFS-e pela rota /nfse/dps. Esse status indica que há algum problema de validação com os dados enviados na requisição.

Para identificar exatamente quais são os erros, é importante inspecionar o corpo da resposta que a API retorna junto com o código 400. A Nuvem Fiscal envia um JSON detalhado informando todos os erros encontrados durante a validação da sua solicitação.

Exemplo de resposta:

{
    "error": {
        "code": "ValidationFailed",
        "message": "Validation failed",
        "errors": [
            {
                "code": "InvalidFormat",
                "message": "O campo 'infDPS.prest.CNPJ' não corresponde ao formato esperado ^([0-9]{14})$"
            },
            {
                "code": "ValidationError",
                "message": "O campo 'infDPS.valores.trib.tribMun.tribISSQN' possui valor inválido: 6. O campo pode assumir um dos seguintes valores: 1, 2, 3, 4."
            }
        ]
    }
}

Recomendamos verificar o conteúdo dessa resposta diretamente no seu console de logs ou via ferramentas como Postman ou Insomnia, para entender quais ajustes são necessários no payload enviado.

Se tiver dificuldades para interpretar os erros retornados, fique à vontade para compartilhá-los aqui e te ajudamos com os próximos passos.

Ficamos à disposição!