Retornos
A emissão de uma Nota Fiscal de Serviço Eletrônica (NFS-e) não é um processo unilateral; ela trata-se de um diálogo constante entre o seu sistema (ERP), o InvoiCy e os servidores das Prefeituras. Nesse ecossistema, o conceito de "Retorno" é fundamental para garantir a integridade fiscal e o sucesso da operação.
Basicamente, um retorno é a resposta que o InvoiCy entrega após processar uma solicitação de emissão ou consulta. Ele atua como um "diagnóstico" imediato da transação, informando se o documento foi autorizado com sucesso, se está em processamento ou se houve alguma rejeição por parte do município.
O InvoiCy padroniza essas comunicações para simplificar a integração, mas é essencial conhecer os códigos específicos que a plataforma utiliza para reportar o status de cada envio. Abaixo, listamos todos os possíveis retornos mapeados pelo InvoiCy referentes ao processo de NFS-e, detalhando o significado de cada situação em seus respectivos artigos:
- NFS-e: [#inv0301] – O código do município informado não existe ou não foi encontrado.
- NFS-e: [#inv0302] – Este município ainda não está preparado para emitir NFS-e
- NFS-e: [#inv0303] – O município informado não possui ambiente de homologação!
- NFS-e: [#inv0304] – Uma exceção ocorreu na comunicação com a prefeitura. O processamento foi interrompido
- NFS-e: [#inv0305] – Para filtrar municípios por data de inicialização informe APENAS o campo [DataInicializacao]
- NFS-e: [#inv0306] – Nenhum município inicializado a partir desta data
- NFS-e: [#inv0308] – Não foi possível carregar os dados de emissão: Padrão de NFS-e
- NFS-e: [#inv0311] – Número de RPS enviado anteriormente com status REJEITADO
- NFS-e: [#inv0312] - Envie apenas um tipo de RPS...
- NFS-e: [#inv0313] - Este RPS não será enviado, pois já se encontra com status efetivado.
- NFS-e: [#inv0314] - Este RPS não será enviado, pois já se encontra com status cancelado.
- NFS-e: [#inv0315] - Este RPS não será enviado, pois já se encontra com status inutilizado.
- NFS-e: [#inv0316] - Este município não permite substituição de RPS.
- NFS-e: [#inv0317] - Este município não permite inutilização de numeração de RPS.
- NFS-e: [#inv0318] - Número máximo de documentos ultrapassado.
- NFS-e: [#inv0319] - Tipo de evento não suportado.
- NFS-e: [#inv0320] - Somente documentos autorizados podem ser cancelados.
- NFS-e: [#inv0321] - Arquivo de importação não informado ou não suportado.
- NFS-e: [#inv0323] - RPS importado pelo InvoiCy.
- NFS-e: [#inv0324] - Não foi possível realizar a formatação dos dados de RPS.
- NFS-e: [#inv0325] - Tamanho do campo discriminação ultrapassa o limite de 7000 caracteres.
- NFS-e: [#inv0326] - Não foi possível gerar o HASH pois o certificado não foi encontrado
- NFS-e: [#inv0328] - Mensagem retornada pela prefeitura
- NFS-e: [#inv0329] - Cadeia de Caracteres gerada
- NFS-e: [#inv0330] - Iniciando o serviço de Recepção com a prefeitura de São Paulo
- NFS-e: [#inv0331] - Neste município é permitido realizar a impressão apenas de notas efetivadas
- NFS-e: [#inv0332] - PDF do espelho do RPS não encontrado
- NFS-e: [#inv0333] - Os web services ainda não estão configurados para a ação Envio/ Consulta/ Cancelamento/ Substituição
- NFS-e: [#inv0334] - Atualizando documento para cancelado
- NFS-e: [#inv0335] - Atualizando documento para efetivado
- NFS-e: [#inv0336] - Atualizando documento para rejeitado
- NFS-e: [#inv0337] - Atualizando documento para Em Processamento
- NFS-e: [#inv0338] - Atualizando arquivo de impressão da prefeitura
- NFS-e: [#inv0339] - Nenhum retorno da prefeitura para o serviço Recepção/ Consulta Situação do lote/ Consulta lote/ Consulta NFSe por RPS/ Cancelamento/ Substituição
- NFS-e: [#inv0341] - Layout XML de envio inválido
- NFS-e: [#inv0342] - Layout XML de retorno inválido
- NFS-e: [#inv0343] - Erro ao gerar XML de envio
- NFS-e: [#inv0344] - Código do serviço inválido.
- NFS-e: [#inv0345] - XML de retorno inválido
- NFS-e: [#inv0346] - Registro inserido na fila do processo assíncrono com status Pendente Envio/ Pendente Consulta/ Pendente Cancelamento
- NFS-e: [#inv0347] - Não foi possível executar o serviço Recepção/ Consulta Situação do lote/ Consulta lote/ Consulta NFSe por RPS/ Cancelamento
- NFS-e: [#inv0348] - Atualizando documento para Inutilizado
- NFS-e: [#inv0349] - O cancelamento da NFS-e é possível somente no portal da prefeitura. A NFS-e selecionada foi marcada como cancelada
- NFS-e: [#inv0350] - Somente documentos autorizados podem ser cancelados.
- NFS-e: [#inv0351] - Tipo de Comunicação WebService inválida.
- NFS-e: [#inv0354] - Documento saiu da fila assíncrona
- NFS-e: [#inv0355] - Não foi possível carregar os detalhes do documento
- NFS-e: [#inv0356] - Não foi possível transferir o espelho RPS para o diretório de exportação