Adicionar uma consulta de notas – Central de Atendimento

Essa rota realiza a consulta de notas tomadas emitidas contra um CNPJ.

Rota da API

POST

api.nfse.tecnospeed.com.br/v1/tomadas

Parâmetros

Headers

Argumento	Tipo	Detalhes
Content-Type	String	application/json
token_sh	String	Token obtido no cadastro do Tecno Account em: https://conta.tecnospeed.com.br/
cpfCnpjSoftwareHouse	String	CPF ou CNPJ da Software House que está desenvolvendo o controle das notas tomadas
cpfCnpjTomador	String	CPF ou CNPJ do tomador do serviço das notas

Body

{
 "codigoCidade": "4115200", //Código IBGE da cidade que será realizada a consulta de notas tomadas(cidade de prestação do serviço).
 "prestador": {
   "cpfCnpj": "99999999999999",
   "inscricaoMunicipal": "99999"
 },
 "destinatario": {
   "cpfCnpj": "29062609000177",
   "inscricaoMunicipal": "99999"
 },
 "periodo": {
   "inicial": "2020-03-01",
   "final": "2020-03-20"
 }
}

Atenção! Caso o município tenha autenticação por Login e Senha será necessário que esses parâmetros sejam enviados na requisição dentro do grupo "autenticacao" conforme exemplo abaixo:

{
 "codigoCidade": "4115200",
 "prestador": {
   "cpfCnpj": "99999999999999",
   "inscricaoMunicipal": "99999"
 },
 "destinatario": {
   "cpfCnpj": "29062609000177",
   "inscricaoMunicipal": "99999",
   "autenticacao": {
     "login": "teste",
     "senha": "12345"
   }
 },
 "periodo": {
   "inicial": "2020-03-01",
   "final": "2020-03-20"
 }
}

Raw	Tipo	Detalhes
codigoCidade	String	Código IBGE da cidade que será realizada a consulta de notas tomadas.
Prestador: CpfCNPJ	String	*CPF/CNPJ do Prestador do serviço, ou seja, quem emitiu as notas contra o Tomador do serviço.
Prestador: InscricaoMunicipal	String	*Inscrição municipal do prestador do serviço.
Destinatario: CpfCNPJ	String	CPF/CNPJ do Tomador dos serviços, ou seja, CNPJ que teve as notas emitidas contra ele.
Destinatario:InscricaoMunicipal	String	Inscrição municipal do tomador dos serviços.
Autenticacao: login	String	Login do usuário cadastrado no município
Autenticacao: senha	String	Senha do usuário cadastrado no município
Periodo: Inicial	String	Data inicial das notas emitidas
Periodo: Final	String	Data final das notas emitidas

Atenção! Exigibilidade dos parâmetros InscricaoMunicipal e CpfCNPJ do prestador varia de município para município. Para consultaras exigências de cada município na consulta de tomadas, acesse: Lista de municípios homologados ou utilize a rota: Consultar cidades homologadas.

Retorno

{

    "acoes": {

        "consultaProtocolo": {

            "rota": "https://api.nfse.tecnospeed.com.br/v1/tomadas/741fd8ee-982d-4041-94ce-5d6eaad299cs",

            "metodo": "GET",

            "descricao": "Consulta de situação do protocolo."

        }

    },

    "resposta": {

        "mensagem": "Nota(as) em processamento",

        "protocolo": "741fd8ee-982d-4041-94ce-5d6eaad299cs"

    }

}

< Antes Próximo >