Neste passo abordamos como deve ser feita a consulta das notas destinadas. Basicamente a busca se dá com a criação de um protocolo de consulta, informando o período da busca com uma data inicial e outra final, onde o intervalo máximo de dias entre a data inicial e final é de 31 dias, podendo ser consultadas notas de até 6 meses retroativos.
Também é possível consultar NFe's pela chave, clique aqui e veja como fazer.
Rota:
POST https://api.nfe.tecnospeed.com.br/destinadas/v1/protocolos
Parâmetros
Headers
Atributo | Tipo | Descrição |
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 |
cpfCnpjDestinatario | String | CPF ou CNPJ do destinatário das notas fiscais |
Body
{
"periodo": {
"dataInicial": "2020-09-01",
"dataFinal": "2020-09-30"
}
}
Atenção: lembre-se que é necessário que o destinatário já esteja cadastrado juntamente com o certificado digital.
Atributo | Tipo | Descrição |
periodo | Objeto | Objeto contendo dois campos, "dataInicial" e "dataFinal" |
periodo.dataInicial | String | Data inicial do período de filtro das notas |
periodo.dataFinal | String | Data final do período de filtro das notas |
ultimoNsu | String | Ultimo NSU salvo por você num outro software. Nesta API você não precisa controlar este campo pois fazemos isso por você, portanto este é um parâmetro opcional. |
Retorno
{
"id": "000000000000000000000000",
"situacao": "PROCESSANDO",
"cpfCnpjSoftwareHouse": "0000000000000",
"cpfCnpjDestinatario": "0000000000000",
"periodo": {
"dataInicial": "2020-09-01T00:00:00.000Z",
"dataFinal": "2020-09-30T00:00:00.000Z"
},
"criadoEm": "2020-09-28T00:27:33.376Z",
"atualizadoEm": "2020-09-28T00:27:33.376Z"
}
A partir deste momento, nossa API irá buscar todas as notas disponíveis no ambienta nacional da SEFAZ, fazer a ciência da nota e disponibiliza-la para você fazer o download de seu XML. Porém só é possível consultar as notas quando a situação do protocolo estiver em "CONCLUIDO". Confira o próximo passo como consultar a situação do protocolo.
Comentários
0 comentário
Por favor, entre para comentar.