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.
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');
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.
Comentários
0 comentário
Por favor, entre para comentar.