Emissão de NFS-e provedor Centi (Itaberaí-GO

batista.solucoes.tec · Setembro 9, 2025, 5:46pm

Relatório de Bug - Mapeamento Incorreto entre APIs Nuvem Fiscal → Centi

Provedor: Nuvem Fiscal
Ambiente: Homologação
Endpoint: /nfse/dps
Data/Hora: 09/09/2025 17:42:38

Descrição do Problema

Ao emitir uma NFSe via API Nuvem Fiscal utilizando o provedor “padrão” (que mapeia para Centi), está ocorrendo erro de validação no XML gerado internamente pela Nuvem Fiscal para a API da Centi.

Erro Retornado

{
  "error": {
    "code": "ValidationFailed",
    "errors": [{
      "code": "X800",
      "message": "Erro de Validação: --> 1871 - Element '{http://www.centi.com.br/files/nfse.xsd}Valores': Missing child element(s). Expected is one of ( {http://www.centi.com.br/files/nfse.xsd}ValorDeducoes, {http://www.centi.com.br/files/nfse.xsd}ValorPis, {http://www.centi.com.br/files/nfse.xsd}ValorCofins, {http://www.centi.com.br/files/nfse.xsd}ValorInss, {http://www.centi.com.br/files/nfse.xsd}ValorIr, {http://www.centi.com.br/files/nfse.xsd}ValorCsll, {http://www.centi.com.br/files/nfse.xsd}OutrasRetencoes, {http://www.centi.com.br/files/nfse.xsd}ValorIss, {http://www.centi.com.br/files/nfse.xsd}Aliquota )."
    }]
  }
}

Análise Técnica

O erro indica que o XML gerado pela Nuvem Fiscal para a API Centi não contém os elementos obrigatórios no nó <Valores>. Segundo o schema XSD da Centi, pelo menos um dos seguintes elementos deve estar presente:

ValorDeducoes
ValorPis
ValorCofins
ValorInss
ValorIr
ValorCsll
OutrasRetencoes
ValorIss
Aliquota

Payload Enviado (Padrão Nacional)

{
  "provedor": "padrao",
  "ambiente": "homologacao", 
  "referencia": "OS-8-1757439757495",
  "infDPS": {
    "valores": {
      "vServPrest": {
        "vServ": 310
      },
      "trib": {
        "tribMun": {
          "tribISSQN": 1,
          "vBC": 310,
          "pAliq": 0,
          "vISSQN": 0,
          "tpRetISSQN": 1,
          "vLiq": 310
        },
        "tribFed": {
          "piscofins": {
            "CST": "01",
            "vBCPisCofins": 310,
            "vPis": 0,
            "vCofins": 0
          },
          "vRetCP": 0,
          "vRetIRRF": 0,
          "vRetCSLL": 0
        }
      }
    }
  }
}

Problema Identificado

O mapeamento interno da Nuvem Fiscal do padrão nacional para o schema específico da Centi não está convertendo corretamente os valores da estrutura tribMun e tribFed para os elementos XML esperados pela Centi.

Mapeamento esperado:

tribMun.vISSQN → <ValorIss>
tribMun.pAliq → <Aliquota>
tribFed.vPis → <ValorPis>
tribFed.vCofins → <ValorCofins>
tribFed.vRetCP → <ValorInss>
tribFed.vRetIRRF → <ValorIr>
tribFed.vRetCSLL → <ValorCsll>

Solicitação

Solicitamos correção no mapeamento interno da Nuvem Fiscal para garantir que a conversão do padrão nacional para o schema da Centi inclua pelo menos os elementos obrigatórios no nó <Valores>, mesmo quando os valores sejam zero.

Informações Adicionais

Município: Itaberaí-GO (código IBGE: 5212501)
Prestador CNPJ: 22955938000106
Tomador CNPJ: 55657166000177
Valor do Serviço: R$ 310,00

suporte345 · Setembro 10, 2025, 10:44am

Bom dia, @batista.solucoes.tec. Seja bem-vindo à Nuvem Fiscal.

Analisando o schema XSD do provedor Centi, verificamos que a única tag obrigatória (mesmo que zerada) é a <Aliquota>:

Fizemos a alteração agora para que ela seja incluída no XML sempre.

Favor testar e nos reportar caso ainda tenha algum problema na emissão.

batista.solucoes.tec · Setembro 24, 2025, 2:51pm

Agora estou recebendo outro erro:

[
          {
            "code": "X800",
            "message": "Erro de Validação:  --> 1832 - Element '{http://www.centi.com.br/files/nfse.xsd}ItemListaServico': [facet 'maxLength'] The value has a length of '7'; this exceeds the allowed maximum length of '5'."
          }
        ]

{
   "provedor":"padrao",
   "ambiente":"homologacao",
   "referencia":"OS-4-nfse-1758726198192-3002",
   "infDPS":{
      "tpAmb":2,
      "dhEmi":"2025-09-24T15:03:18.989Z",
      "dCompet":"2025-09-24",
      "prest":{
         "CNPJ":"22955938000106",
         "regTrib":{
            "regEspTrib":6
         }
      },
      "toma":{
         "orgaoPublico":false,
         "xNome":"BATISTA SOLUCOES EM TECNOLOGIA LTDA",
         "CNPJ":"55657166000177",
         "email":"pedro.042013@gmail.com",
         "end":{
            "endNac":{
               "cMun":"5212501",
               "CEP":"76630000"
            },
            "xLgr":"Rua 15",
            "nro":"SN",
            "xBairro":"Residencial Vitoria"
         }
      },
      "serv":{
         "locPrest":{
            "cLocPrestacao":"5212501"
         },
         "cServ":{
            "cTribNac":"4732600",
            "cTribMun":"1401",
            "xDescServ":"Ordem de Serviço: 4 - Veículo: SIK4G19 - Ordem de serviço #4"
         }
      },
      "valores":{
         "vServPrest":{
            "vServ":70
         },
         "trib":{
            "tribMun":{
               "tribISSQN":1,
               "vBC":70,
               "pAliq":2.01,
               "vISSQN":1.41,
               "tpRetISSQN":1,
               "vLiq":68.59
            },
            "tribFed":{
               "piscofins":{
                  "CST":"01",
                  "vBCPisCofins":70,
                  "vPis":0,
                  "vCofins":0
               },
               "vRetCP":0,
               "vRetIRRF":0,
               "vRetCSLL":0
            }
         }
      }
   }
}

suporte345 · Setembro 24, 2025, 3:51pm

Boa tarde, @batista.solucoes.tec.

O campo cTribNac deverá conter um valor com 4 dígitos correspondente a um item da LC 116/2003.

Faça essa correção e tente emitir novamente.

batista.solucoes.tec · Setembro 26, 2025, 6:48pm

Consegui emtir, obrigado.

Porém agora todas NFSe são rejeitadas com esse erro:

{
			"id": "nfs_3a1c9ea77c19455bbd21bfe025f03d00",
			"created_at": "2025-09-26T18:41:11.690Z",
			"status": "erro",
			"ambiente": "homologacao",
			"referencia": "OS-4-nfse-1758912070433-5320",
			"DPS": {
				"serie": "1",
				"nDPS": "1642"
			},
			"mensagens": [
				{
					"descricao": "Cód. erro :0"
				},
				{
					"descricao": "(Servico.MunicipioIncidencia) Código do município incidência não encontrado."
				}
			]
		}

Aparentemente meu envio está correto:

{
      "ambiente":"homologacao",
      "endpoint":"/nfse/dps",
      "level":"info",
      "operation":"emitNfse",
      "payload":{
         "ambiente":"homologacao",
         "infDPS":{
            "dCompet":"2025-09-26",
            "dhEmi":"2025-09-26T17:44:31.120Z",
            "prest":{
               "CNPJ":"22955938000106",
               "regTrib":{
                  "regEspTrib":6
               }
            },
            "serv":{
               "cServ":{
                  "cTribMun":"1401",
                  "cTribNac":"5102",
                  "xDescServ":"Ordem de Serviço: 4 - Veículo: SIK4G19 - Ordem de serviço #4"
               },
               "locPrest":{
                  "cLocPrestacao":"5210406",
                  "cPaisPrestacao":"1058"
               }
            },
            "toma":{
               "CNPJ":"55657166000177",
               "IE":"201618621",
               "IM":"10123",
               "cNaoNIF":null,
               "email":"pedro.042013@gmail.com",
               "end":{
                  "endNac":{
                     "CEP":"76630000",
                     "cMun":"5210406"
                  },
                  "nro":"SN",
                  "xBairro":"Residencial Vitoria",
                  "xLgr":"Rua 15"
               },
               "fone":"62981156421",
               "orgaoPublico":false,
               "xNome":"BATISTA SOLUCOES EM TECNOLOGIA LTDA"
            },
            "tpAmb":2,
            "valores":{
               "trib":{
                  "tribFed":{
                     "piscofins":{
                        "CST":"01",
                        "vBCPisCofins":70,
                        "vCofins":0,
                        "vPis":0
                     },
                     "vRetCP":0,
                     "vRetCSLL":0,
                     "vRetIRRF":0
                  },
                  "tribMun":{
                     "pAliq":2.01,
                     "tpRetISSQN":1,
                     "tribISSQN":1,
                     "vBC":70,
                     "vISSQN":1.41,
                     "vLiq":68.59
                  }
               },
               "vServPrest":{
                  "vServ":70
               }
            }
         },
         "provedor":"padrao",
         "referencia":"OS-4-nfse-1758908671111-1318"
      }

batista.solucoes.tec · Outubro 6, 2025, 2:50pm

Consegue me ajudar @suporte345 ?

suporte345 · Outubro 7, 2025, 11:47am

Bom dia, @batista.solucoes.tec.

A mensagem de rejeição indica que o município de incidência do ISSQN não foi informado.

Para corrigir, envie essa informação no campo infDPS.valores.trib.tribMun.cLocIncid: