Bem-vindo(a) ao Suporte da Tecnospeed

Em que podemos ajudar? :)

Artigos nessa seção

Exibir mais

Método Consultar Notas Tomadas / Recebidas

Avatar
Pedro Chagas
  • Atualizado
Seguir

ConsultarNotasTomadas(aNomeCidade, aDocumentoTomador, aIMTomador, aDocumentoPrestadorConsulente, aIMPrestadorConsulente,
aDataInicial, aDataFinal, aPagina, aParams)

Consulta todas as notas tomadas / Recebidas contra o tomador do serviço em um determinado período para uma cidade especifica.

*Este recurso está disponível à todos os clientes do Componente NFSe da TecnoSpeed. Ainda não possui o Componente NFSe? Clique no banner abaixo e solicite um orçamento.

Banner_News_NFSes_Tomadas.png

 

 

Método

 

ConsultarNotasTomadas(const aNomeCidade, aDocumentoTomador, aIMTomador, aDocumentoPrestadorConsulente, aIMPrestadorConsulente, aDataInicial, aDataFinal: string; const aPagina : string=''; const aParams : string=''): 

 

Parâmetros

 

Argumento Tipo Detalhes
aNomeCidade String Nome da cidade do tomador sem espaços.
aDocumentoTomador String Cpf ou CNPJ do tomador do serviço.
aIMTomador String Inscrição municipal do tomador caso houver.
aDocumentoPrestadorConsulente String CNPJ do prestador do serviço ou Consulente.
aIMPrestadorConsulente String Inscrição municipal do prestador ou Consulente caso houver.
aDataInicial String Data inicial para formar o período em que as notas foram emitidas. (YYYY-MM-DD)
ADataFinal String Data final para formar o período em que as notas foram emitidas. (YYYY-MM-DD)
aPagina String Quando existem muitos registros naquele período informado é necessário paginar para trazer todos os registros.
aParams String Usado para informar os parâmetros extras, exemplo: Login=xxxxx;Senha=xxxxxxxxx

 

Retorno

 

Retorno na própria instância da NFSe que chamou o método ConsultarNotasTomadas, Exemplo:

NFSe.RetornoWSNotasTomadas.Items[0..N].Status;
NFSe.RetornoWSNotasTomadas.Items[0..N].CNPJ;
NFSe.RetornoWSNotasTomadas.Items[0..N].InscricaoMunicipal;
NFSe.RetornoWSNotasTomadas.Items[0..N].SerieRps;
NFSe.RetornoWSNotasTomadas.Items[0..N].NumeroRps;
NFSe.RetornoWSNotasTomadas.Items[0..N].NumeroNFSe;
NFSe.RetornoWSNotasTomadas.Items[0..N].DataEmissaoNFSe;
NFSe.RetornoWSNotasTomadas.Items[0..N].CodVerificacao;
NFSe.RetornoWSNotasTomadas.Items[0..N].Situacao;
NFSe.RetornoWSNotasTomadas.Items[0..N].DataCancelamento;
NFSe.RetornoWSNotasTomadas.Items[0..N].ChaveCancelamento;
NFSe.RetornoWSNotasTomadas.Items[0..N].Tipo;
NFSe.RetornoWSNotasTomadas.Items[0..N].Motivo;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorServicos;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorDeducoes;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorPis;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorCofins;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorInss;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorIr;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorCsll;
NFSe.RetornoWSNotasTomadas.Items[0..N].AliquotaIss;
NFSe.RetornoWSNotasTomadas.Items[0..N].ValorIss;
NFSe.RetornoWSNotasTomadas.Items[0..N].IssRetido;
NFSe.RetornoWSNotasTomadas.Items[0..N].DataAutorizacao;
NFSe.RetornoWSNotasTomadas.Items[0..N].RazaoSocialPrestador;
NFSe.RetornoWSNotasTomadas.Items[0..N].EnderecoPrestador;
NFSe.RetornoWSNotasTomadas.Items[0..N].NumeroPrestador;
NFSe.RetornoWSNotasTomadas.Items[0..N].ComplementoPrestador;
NFSe.RetornoWSNotasTomadas.Items[0..N].BairroPrestador;
NFSe.RetornoWSNotasTomadas.Items[0..N].CodigoCidadePrestador;
NFSe.RetornoWSNotasTomadas.Items[0..N].CepPrestador;
NFSe.RetornoWSNotasTomadas.Items[0..N].CpfCnpjTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].InscMunicipalTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].RazaoSocialTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].EnderecoTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].NumeroTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].ComplementoTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].BairroTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].CodigoCidadeTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].CepTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].EmailTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].TelefoneTomador;
NFSe.RetornoWSNotasTomadas.Items[0..N].ItemListaServico;
NFSe.RetornoWSNotasTomadas.Items[0..N].CodigoCNAE;
NFSe.RetornoWSNotasTomadas.Items[0..N].CodTributacaoMunicipio;
NFSe.RetornoWSNotasTomadas.Items[0..N].CodigoCidadePrestacao;
NFSe.RetornoWSNotasTomadas.Items[0..N].DiscriminacaoServico;
NFSe.RetornoWSNotasTomadas.Items[0..N].Xml;
NFSe.RetornoJsonTomadas;
NFSe.RetornoCSVTomadas;

 

Na mesma instância da NFSe contém uma função RetornoJsonTomadas que possui um Json de retorno da comunicação. Exemplo:

{
 "resposta":{
 "totalDeNotas":50,
 "notas":[
   {
     "prestador":{
       "endereco":{
       "endereco":"AVENIDA TESTE",
       "numero":"473",
       "complemento":"",
       "bairro":"Zona 08",
       "codigoCidade":"4115200",
       "cep":"87013180"
   },
   "razaoSocial":"TESTE TESTE",
   "cpfCnpj":"99999999999999",
   "inscricaoMunicipal":"9999"
 },
   "tomador":{
     "endereco":{
       "endereco":"Avenida Duque De Caxias",
       "numero":"882",
       "complemento":"SALA 1708 TORRE II",
       "bairro":"Novo Centro",
       "codigoCidade":"4115200",
       "cep":"87020025"
     },
     "razaoSocial":"TecnoSpeed S.A.",
     "cpfCnpj":"08187168000160",
     "inscricaoMunicipal":"",
     "email":"comercial@tecnospeed.com.br",
     "telefone":"4430379500"
   },
   "rps":{
     "serie":"9999",
     "numero":"999999",
     "tipo":"1",
     "dataEmissao":"2019-01-23T06:38:10"
   },
   "nfse":{
     "numero":"999999",
     "dataAutorizacao":"2019-01-23",
     "codigoVerificacao":"3A3094B1D",
     "dataCancelamento":"",
     "ChaveCancelamento":"99999|9999_99999_SRC00_1"
   },
   "iss":{
     "aliquota":"3",
     "retido":"2",
     "valor":"4.91",
     "itemListaServico":"1601",
     "codigoCNAE":"4921301",
     "codigoCidadePrestacao":"4115200"
   },
   "retencao":{
     "pis":"0.00",
     "cofins":"0.00",
     "inss":"0.00",
     "ir":"0.00",
     "csll":"0.00"
   },
   "situacao":"AUTORIZADA",
   "status":"SUCESSO",
   "motivo":"",
   "discriminacaoServico":"Produto: VT Urbano - Qtd: 42 - Vlr. Unitario: R$ 3,90",
   "codigoTributacaoMunicipio":"15357",
   "valorServicos":"163.8",
   "valorDeducoes":"0.00",
   "xml":"Xml da NFSe"
   }
  ]
 }
}

 

 

Ainda na mesma instância da NFSe contém uma função RetornoCSVTomadas que possui um CSV de retorno da comunicação. Exemplo:

SUCESSO;;99999999999999;;1;000;000;2020-07-10T00:00:00;2020-07-10T00:00:00;0000000;AUTORIZADA;;000;<ComplNfse><Nfse><InfNfse><Numero>000</Numero><CodigoVerificacao>0000000</CodigoVerificacao><DataEmissao>2020-07-10T20:20:13.830-03:00</DataEmissao><IdentificacaoRps><Numero>000</Numero><Serie>0</Serie><Tipo>0</Tipo></IdentificacaoRps><DataEmissaoRps>2020-07-10</DataEmissaoRps><NaturezaOperacao>1</NaturezaOperacao><OptanteSimplesNacional>2</OptanteSimplesNacional><Competencia>2020-07-01</Competencia><OutrasInformacoes>nota teste</OutrasInformacoes><Servico><Valores><ValorServicos>1.00</ValorServicos><ValorDeducoes>0</ValorDeducoes><ValorIr>0.10</ValorIr><IssRetido>2</IssRetido><ValorIss>0.10</ValorIss><BaseCalculo>1.00</BaseCalculo><Aliquota>3</Aliquota><ValorLiquidoNfse>1.00</ValorLiquidoNfse><DescontoCondicionado>0</DescontoCondicionado><DescontoIncondicionado>0</DescontoIncondicionado></Valores><ItemListaServico>1010</ItemListaServico><CodigoCnae>0000000</CodigoCnae><Discriminacao>nota de teste</Discriminacao><CodigoMunicipio>0000000</CodigoMunicipio></Servico><PrestadorServico><IdentificacaoPrestador><Cnpj>99999999999999</Cnpj><InscricaoMunicipal>1111</InscricaoMunicipal></IdentificacaoPrestador><RazaoSocial>TecnoSpeed S.A.</RazaoSocial><NomeFantasia>S.A.</NomeFantasia><Endereco><Endereco>AV XV DE NOVEMBRO</Endereco><Numero>1</Numero><Bairro>CENTRO</Bairro><CodigoMunicipio>0000000</CodigoMunicipio><Uf>PR</Uf><Cep>88888888</Cep></Endereco><Contato><Email>comercial@tecnospeed.com.br</Email></Contato></PrestadorServico><TomadorServico><IdentificacaoTomador><CpfCnpj><Cnpj>99999999999999</Cnpj></CpfCnpj></IdentificacaoTomador><RazaoSocial>TESTE TESTE</RazaoSocial><Endereco><Endereco>CAMPOS BICUDO</Endereco><Numero>00</Numero><Complemento/><Bairro>Zona 7</Bairro><CodigoMunicipio>0000000</CodigoMunicipio><Uf>PR</Uf><Cep>88888888</Cep></Endereco><Contato><Telefone>999999999</Telefone><Email>comercial@tecnospeed.com.br</Email></Contato></TomadorServico><IntermediarioServico/><OrgaoGerador><CodigoMunicipio>0000000</CodigoMunicipio><Uf>PR</Uf></OrgaoGerador><ConstrucaoCivil/></InfNfse></Nfse></ComplNfse>;1;

 

Exemplos

 

Delphi

 

NFSe.ConsultarNotasTomadas('NomeDaCidade', 'Documento do tomador', 'Inscrição Municipal do Tomador', 'Documento do prestador ou Consulente', 'Inscrição municipal do Prestador ou Consulente', 'Data inicial das emissão das notas', 'Data final da emissão das notas', 'Número da pagina para trazer os registros', 'Parâmetros extras, exemplo: Login=xxxxxx,Senha=xxxxxxx');

image__12_.png

 

C#

 

retorno = NFSe.ConsultarNotasTomadas("NomeDaCidade", "Documento do tomador", "Inscrição Municipal do Tomador", "Documento do prestador ou Consulente", "Inscrição municipal do Prestador ou Consulente", "Data inicial das emissão das notas", "Data final da emissão das notas", "Número da pagina para trazer os registros", "Parâmetros extras, exemplo: Login=xxxxxx,Senha=xxxxxxx");

 

Visual Basic 6

 

retorno = NFSe.ConsultarNotasTomadas"NomeDaCidade", "Documento do tomador", "Inscrição Municipal do Tomador", "Documento do prestador ou Consulente", "Inscrição municipal do Prestador ou Consulente", "Data inicial das emissão das notas", "Data final da emissão das notas", "Número da pagina para trazer os registros", "Parâmetros extras, exemplo: Login=xxxxxx,Senha=xxxxxxx"

 

PHP

 

$retorno = $NFSe->ConsultarNotasTomadas("NomeDaCidade", "Documento do tomador", "Inscrição Municipal do Tomador", "Documento do prestador ou Consulente", "Inscrição municipal do Prestador ou Consulente", "Data inicial das emissão das notas", "Data final da emissão das notas", "Número da pagina para trazer os registros", "Parâmetros extras, exemplo: Login=xxxxxx,Senha=xxxxxxx");

 

Importante

É importante ressaltar que este método não está disponível para todos os padrões suportados pelo componente NFSe, é necessário consultar a documentação do padrão no link: https://atendimento.tecnospeed.com.br/hc/pt-br/sections/360001602793-Documenta%C3%A7%C3%A3o-t%C3%A9cnica para conferir se o padrão possuí suporte ou não para esse método. Esse método é utilizado para consultar as notas fiscais de serviços emitidas contra o tomador do serviço.

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.