Mensagens de erro e o que fazer

Uma mensagem pode aparecer junto ao campo do formulário, em Fila, nos eventos de uma nota em Histórico > Detalhes ou no e-mail operacional. Leia primeiro a mensagem principal e, quando houver, o código e os detalhes técnicos.

Nos eventos com erro, o botão Perguntar à SKAIA abre o assistente com o contexto já preenchido. Revise a pergunta antes de enviar. A SKAIA explica o uso do sistema, mas não define códigos, alíquotas ou regras fiscais.

Ao emitir a nota

• Há campos do formulário que precisam ser revisados antes da emissão. (VALIDACAO) O que significa: um ou mais dados obrigatórios estão ausentes ou em formato inválido. O que fazer: volte a Emitir NFS-e, confira os campos destacados e tente novamente depois de corrigir todos eles.

• Corpo JSON inválido. O que significa: os dados enviados não formam uma solicitação válida. O que fazer: em uma integração, revise o corpo enviado; na tela, recarregue Emitir NFS-e uma vez e, se persistir, fale com o suporte.

• tomadorTipo é obrigatório e deve ser CNPJ, CPF ou ESTRANGEIRO., tomadorDoc é obrigatório. ou tomadorNome é obrigatório. O que significa: falta a identificação básica do tomador ou o tipo informado não é aceito. O que fazer: em Emitir NFS-e > Tomador, selecione o tipo e preencha documento e nome.

• País do tomador estrangeiro é obrigatório e deve ter 2 letras (código ISO). ou Motivo de ausência do NIF deve ser 0, 1 ou 2. O que significa: os dados internacionais do tomador estão incompletos ou fora do formato exigido. O que fazer: em Emitir NFS-e > Tomador, revise país e NIF; confirme a informação fiscal correta com o contador.

• intermediarioTipo é obrigatório..., intermediarioDoc é obrigatório., intermediarioNome é obrigatório. ou variantes de país e NIF do intermediário O que significa: a emissão informa um intermediário, mas os dados obrigatórios dele estão incompletos. O que fazer: em Emitir NFS-e > Intermediário, complete identificação, país e NIF ou desmarque a presença de intermediário quando isso estiver correto.

• descricaoServico é obrigatório. O que significa: a descrição do serviço não foi informada. O que fazer: preencha Emitir NFS-e > Serviço > Descrição do serviço antes de emitir.

• dataCompetencia é obrigatória no formato AAAA-MM. O que significa: a competência está vazia ou não representa ano e mês no formato esperado. O que fazer: em Emitir NFS-e > Serviço, selecione a competência correta no formato de mês e ano.

• valorServico deve ser maior que zero. ou mensagens de desconto, dedução, IBPT e alíquota que exigem valor maior ou igual a zero O que significa: um valor monetário ou percentual está negativo, vazio ou inválido. O que fazer: revise os valores em Emitir NFS-e > Valores e tributos e confirme parâmetros fiscais com o contador.

• Tipo de retenção de ISS inválido. O que significa: a opção de retenção não corresponde a um valor aceito pelo sistema. O que fazer: em Emitir NFS-e > Valores e tributos, selecione novamente a retenção definida pelo contador.

• O certificado digital A1 não está configurado ou está inválido. (CERT001) O que significa: o arquivo A1, a senha ou a validade do certificado impede a assinatura. O que fazer: acesse Empresas > Editar > Certificado A1 e envie um arquivo .pfx válido com a senha correta.

• O endereço do tomador (ou do prestador) está ausente ou incompleto. (E0234) O que significa: a prefeitura exige dados de endereço que não foram enviados por completo. O que fazer: complete CEP, logradouro, número, bairro, município e UF em Emitir NFS-e > Tomador ou em Empresas > Editar.

• A inscrição municipal informada é inválida ou está ausente. O que significa: a inscrição não corresponde ao cadastro municipal do prestador. O que fazer: confira o cadastro da prefeitura e atualize Empresas > Editar > Dados fiscais; confirme com o contador antes de substituir o valor.

• A configuração do emissor está incompleta ou incorreta. (CONFIG) O que significa: CNPJ, inscrição municipal ou dados fiscais da emissora não permitem a transmissão. O que fazer: revise Empresas > Editar > Dados fiscais e tente emitir novamente.

• O XML da NFS-e não passou na validação técnica exigida pelo padrão nacional. O que significa: o documento gerado não atendeu ao esquema ou à assinatura exigida. O que fazer: revise os campos obrigatórios em Emitir NFS-e; se persistir, envie ao suporte o código e a descrição técnica do evento.

• A data de emissão ou competência não é aceita pela prefeitura. O que significa: a data informada é futura ou não está no período aceito pelo município. O que fazer: confira Emitir NFS-e > Serviço > Competência e use uma data válida.

• O documento do tomador ou do prestador está inválido. O que significa: o CPF ou CNPJ está incompleto ou não passou na validação. O que fazer: confira o documento em Emitir NFS-e > Tomador ou em Empresas > Editar e corrija números trocados.

• O código de serviço ou de tributação não é aceito para esta emissão. O que significa: o código nacional, municipal ou item da lista não é aceito para a emissora. O que fazer: revise Emitir NFS-e > Serviço e peça ao contador os códigos corretos antes de reenviar.

• A alíquota de ISSQN informada não é aceita para este serviço. O que significa: a alíquota diverge do cadastro municipal, regime ou serviço selecionado. O que fazer: confirme a alíquota com o contador e ajuste Emitir NFS-e > Valores e tributos ou o Perfil tributário usado.

• O município informado não é válido ou o prestador não está habilitado nele. O que significa: o código IBGE não é reconhecido ou a emissora não está autorizada naquele município. O que fazer: confira o município em Empresas > Editar e, se o cadastro estiver correto, fale com o suporte.

• A integração deste município está sendo homologada com a prefeitura. (MUNICIPIO_EM_VALIDACAO) O que significa: a cidade ainda está em validação pela equipe junto à prefeitura. O que fazer: conclua Empresas > Editar e aguarde o acompanhamento da equipe na primeira emissão da cidade.

• O regime tributário informado é incompatível com o cadastro do emissor. O que significa: o regime enviado não corresponde ao cadastro fiscal reconhecido. O que fazer: confirme o enquadramento com o contador e atualize Empresas > Editar > Dados fiscais.

• A emissão foi enviada para um ambiente diferente do esperado. O que significa: produção e homologação não correspondem à configuração usada na transmissão. O que fazer: confira o endereço acessado e a configuração em Empresas > Editar antes de tentar novamente.

• Esta DPS ou NFS-e parece já ter sido emitida anteriormente. O que significa: a prefeitura identificou duplicidade ou uma numeração já utilizada. O que fazer: consulte Histórico e Fila antes de reenviar; não crie outra nota sem confirmar o estado da primeira.

• Não foi possível comunicar com o serviço da prefeitura no momento. O que significa: houve timeout, conexão interrompida ou indisponibilidade temporária da prefeitura ou SEFIN. O que fazer: aguarde alguns minutos e acompanhe Fila; reprocese somente quando o botão estiver disponível.

• Ocorreu um erro interno ao processar a emissão. (INTERNO) O que significa: uma falha interna impediu a conclusão. O que fazer: tente novamente uma vez; se persistir, fale com o suporte informando tela, horário, código e descrição técnica.

No boleto

• A instituição financeira informou que já existe um boleto registrado com este número. O que significa: o banco encontrou um título anterior com a mesma identificação. O que fazer: abra Histórico > Detalhes > Boleto; o sistema reaproveita o registro quando possível e, se continuar sem registro, use Continuar processo.

• A instituição financeira rejeitou os dados do boleto. O que significa: valor, vencimento ou dados do tomador foram recusados pelo banco. O que fazer: confira a nota em Histórico > Detalhes e corrija tomador, valor ou vencimento antes de gerar novamente.

• Falha de autenticação com a instituição financeira ao gerar o boleto. O que significa: ambiente ou credenciais bancárias foram recusados. O que fazer: acesse Empresas > Editar > Integração bancária, confira ambiente e credenciais e tente novamente.

• Cadastro da integração bancária incompleto. O que significa: faltam dados necessários para usar o provedor de boleto. O que fazer: complete Empresas > Editar > Integração bancária.

• A instituição financeira está temporariamente indisponível. O que significa: o banco não respondeu e a tentativa pode ter sido reagendada automaticamente. O que fazer: aguarde alguns minutos e acompanhe Histórico > Detalhes > Histórico de eventos.

• Não foi possível gerar o boleto. Tente novamente ou continue sem boleto. O que significa: ocorreu uma falha que não pôde ser classificada com segurança. O que fazer: em Histórico > Detalhes, use Continuar processo; persistindo, copie Detalhes técnicos para o suporte.

No lote (CSV)

• CSV vazio. ou CSV sem cabeçalho. O que significa: o arquivo não contém dados ou não possui a primeira linha com nomes de colunas. O que fazer: abra Emissão em lote, baixe o modelo e mantenha o cabeçalho antes de importar.

• Colunas desconhecidas: ... O que significa: há nomes de colunas que não fazem parte do modelo aceito. O que fazer: compare o arquivo com o modelo em Emissão em lote e renomeie ou remova as colunas listadas.

• CSV sem colunas obrigatórias: ... O que significa: uma ou mais colunas exigidas não estão no cabeçalho. O que fazer: baixe o modelo em Emissão em lote e acrescente exatamente as colunas indicadas.

• CSV inválido: aspas não fechadas. O que significa: um campo iniciado com aspas não foi encerrado corretamente. O que fazer: corrija as aspas na linha correspondente e valide novamente em Emissão em lote.

• Erro ao ler CSV. O que significa: o arquivo não pôde ser interpretado. O que fazer: salve-o novamente como CSV e reenvie em Emissão em lote; se persistir, fale com o suporte.

Na assinatura e nos limites do plano

• Seu período de teste expirou. Assine um plano para continuar. (TRIAL_EXPIRADO) O que significa: o período gratuito terminou e a operação está bloqueada. O que fazer: um ADMIN deve abrir Assinatura e contratar ou regularizar um plano.

• TRIAL_JA_UTILIZADO O que significa: a conta ou empresa já utilizou o período de teste disponível. O que fazer: abra Assinatura para escolher um plano ou use o contato comercial exibido na solicitação Scale.

• Upgrade disponível após o início da cobrança, quando seu período de teste terminar. (TRIAL_BLOQUEADO) O que significa: durante o teste, a troca para um plano superior ainda não pode ser cobrada. O que fazer: acompanhe a data em Assinatura e faça o upgrade depois do início da cobrança.

• Nenhuma assinatura ou contrato vigente. Assine um plano para continuar. (SEM_ASSINATURA) O que significa: não há vínculo comercial ativo para liberar a operação. O que fazer: um ADMIN deve abrir Assinatura e contratar ou regularizar o plano.

• Limite do plano (... NFS-e/mês) atingido. (LIMITE_ATINGIDO) O que significa: a franquia mensal de emissões foi consumida. O que fazer: consulte Assinatura para fazer upgrade ou aguarde a próxima competência.

• Teto de segurança (... NFS-e/mês) atingido. Faça upgrade do plano para continuar emitindo. (TETO_EXCEDENTE) O que significa: o uso com excedente chegou ao teto de segurança do plano. O que fazer: abra Assinatura e faça upgrade ou aguarde a próxima competência.

• Limite de uso da SKAIA do seu plano foi atingido este mês. (LIMITE_IA_ATINGIDO) O que significa: todas as interações mensais da assistente foram usadas. O que fazer: abra Assinatura para conferir o plano ou peça a um ADMIN; a mensagem informa a renovação do limite.

• A competência possui ... notas. O limite por pacote é de 2000. (LIMITE_NOTAS_FECHAMENTO) O que significa: o fechamento solicitado excede o tamanho máximo de um pacote. O que fazer: em Histórico > Fechamento mensal, gere por empresa ou escolha um período menor.

No acesso e na conta

• O endereço de e-mail do destinatário foi recusado pelo serviço de envio. O que significa: o endereço informado não foi aceito pelo provedor de e-mail. O que fazer: confira o destinatário em Histórico > Detalhes > Notificação por e-mail e reenvie depois de corrigir.

• O arquivo PDF da NFS-e ainda não estava disponível para o envio. O que significa: o DANFSe ainda não havia sido gerado quando o e-mail foi processado. O que fazer: aguarde e acompanhe Histórico > Detalhes > Histórico de eventos; persistindo, fale com o suporte.

• O serviço de envio demorou mais que o esperado para responder. ou O envio não foi concluído por uma falha temporária. O que significa: o provedor de e-mail ficou indisponível ou a falha não pôde ser detalhada. O que fazer: tente Histórico > Detalhes > Reenviar e-mail mais tarde e, se persistir, fale com o suporte.

• O serviço de envio recusou a autenticação configurada. O que significa: as credenciais do serviço de e-mail não foram aceitas. O que fazer: um ADMIN deve revisar Configurações > E-mail; se a configuração estiver correta, fale com o suporte.

Na API e nas integrações

• VALIDACAO — HTTP 400 O que significa: o corpo ou os parâmetros da chamada não passaram na validação. O que fazer: leia erro.mensagem, corrija o payload conforme Integrações > Documentação da API e envie novamente.

• CONFIG O que significa: a empresa emissora ou sua configuração obrigatória está incompleta. O que fazer: revise Empresas > Editar e repita a chamada somente depois da correção.

• REJEICAO_FISCAL — HTTP 422 O que significa: a prefeitura rejeitou a emissão e o código original permanece nos detalhes. O que fazer: consulte detalhes[0].codigo, abra Histórico > Detalhes e confirme os parâmetros fiscais com o contador.

• IDEMPOTENCIA_CONFLITO ou IDEMPOTENCIA_MODO — HTTP 409 O que significa: a mesma chave de idempotência foi reutilizada com outro corpo ou em outro modo de emissão. O que fazer: recupere a resposta da operação original ou gere uma nova chave para uma nova operação; não repita a emissão às cegas.

• NAO_ENCONTRADO — HTTP 404 O que significa: o recurso não existe ou não pertence à conta associada à chave. O que fazer: confira identificador, URL e conta em Integrações antes de repetir a chamada.

• NAO_AUTORIZADO — HTTP 401 O que significa: a chave está ausente, inválida, inativa ou expirada. O que fazer: confira o header de autenticação e, se necessário, gere e copie uma nova chave em Integrações; nunca envie a chave ao suporte.

• ESCOPO_INSUFICIENTE — HTTP 403 O que significa: a chave não possui o escopo exigido pela operação. O que fazer: em Integrações, use uma chave com escopo EMISSAO para emitir ou mantenha LEITURA para consultas.

• PLANO_SEM_INTEGRACOES — HTTP 403 O que significa: a assinatura ou o plano atual não inclui acesso à API. O que fazer: um ADMIN deve abrir Assinatura e regularizar ou atualizar o plano antes de tentar novamente.

• HTTP 402 O que significa: a emissão foi bloqueada por assinatura, trial ou limite de uso. O que fazer: leia o código do envelope e siga a orientação correspondente em Assinatura.

• HTTP 422 O que significa: o conteúdo foi entendido, mas uma validação ou rejeição impediu a operação. O que fazer: leia o código e os detalhes; corrija dados operacionais ou leve parâmetros fiscais ao contador.

Fale com o suporte quando houver falha técnica persistente, indisponibilidade ou configuração correta que ainda não funciona; fale com o contador sempre que a correção exigir decidir código, alíquota, retenção, regime ou outra regra fiscal.