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