Skip to main content
Skip table of contents

Consultar NFS-e Emitido - Por Filtro

GET /api/NFSeEmissao/buscarPorFiltro 

Após enviar uma nota de serviço para emissão, é possível realizar a consulta do status do processamento do mesmo utilizando como filtro os dados do CNPJ, Série, Número e Inscrição Municipal. 

Para realizar a consulta, basta passar os parâmetros “CNPJ”, “Numero”, “Serie” e “InscricaoMunicipal” 

Exemplo de Requisição:

CODE
api/NFSeEmissao/buscarPorFiltro?CNPJ=99999999999999&Numero=19&Serie=33&InscricaoMunicipal=123123

Exemplo de Retorno:

CODE
{ 

  "TipoRetorno": 1, 

  "Autorizado": { 

    "NumeroProtocolo": "string", 

    "Documento": "string", 

    "NumeroRPS": 0, 

    "NumeroRPSOriginal": 0, 

    "SerieRPS": "string", 

    "NumeroNFSe": 0, 

    "DataEmissao": "2023-08-11T12:55:50.051Z", 

    "CodigoVerificacao": "string", 

    "Motivo": "string", 

    "StatusCode": 0 

  } 

}

Observação

A estrutura da API V1 possui particularidades de parâmetros no retorno conforme natureza do tipo de documentos.

Exemplo

Com o tipo de documentos NFS-e - Nota fiscal de Serviço, usando um dos modelos de consulta GET, você terá o retorno com os documentos apresentando os seguintes campos:

  • Tipo de retorno: Código que indica o tipo do documento retornado (Envio= 1\ Evento= 2\ Inutilização= 3\ Outro= 10\ Em Processamento= 11\ Erro= 99. Obs.: Cancelamento é considerado como sendo um Evento).

  • Número de protocolo: GUID gerado aleatoriamente que realiza o vínculo do processo com a nota de envio, sendo único para cada envio 1 - 1, independente se é um documento autorizado, cancelado etc.

  • Documento: XML Retornado do Processamento.

  • NumeroRPS: Número informado no envio da RPS.

  • NumeroRPSOriginal: Valor original do número RPS enviado, utilizado para verificar situações quando ocorre controle sequencial.

  • SerieRPS: Série da NFS-e.

  • NumeroNFSe: Número gerado pela prefeitura após autorização do documento.

  • DataEmissao: Data da emissão da RPS.

  • CodigoVerificação: Código para confirmação da autenticidade da nota.

  • StatusCode: Retorno referente ao status do documento (45 - Autorizado / Aprovado conforme retorno da Prefeitura, 46 - Rejeitado conforme retorno da Prefeitura, 47 - Validado conforme retorno da Prefeitura, 48 - Inválido conforme retorno da NDD).

Em caso de dúvidas sobre algum termo utilizado, acesso o nosso Glossário.

{{component-feedback-article}}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.