Rota Consulta Notas Recebidas - SPED – Central de Atendimento

Nessa rota é possível consultar as Notas Recebidas.

Requisição

Método HTTP

GET

Endpoint

https://sped.plugstorage.com.br/api/v2/sped/notasrecebidas

Query string

Nome	Descrição
token	Token de identificação da Software House.
chave	Chave da nota para consulta de notas individuais
dataInicio	Data em formato (yyyy-mm-dd) de início da busca
dataFim	Data em formato (yyyy-mm-dd) de fim da busca
limite	(opcional) quantidade limite de notas consultadas (padrão 10)
pagina	(opcional) número da página de consulta (padrão 1)
destinacao	(opcional) filtro para retornar apenas notas que contenham destinação apresentada
semDestinacao	(opcional) filtro para retornar notas com ou sem destinação. Utilize "true" para retornar notas em que um dos itens não contem destinação e "false" para retornar notas em que um dos itens contem destinação.

A consulta deve ser feita por chave OU por período, preenchendo de acordo a dataInicio e a dataFim.

Headers

Nome	Valor
Authorization	Basic encode64(email:senha)==

Body

Nenhum.

Resposta

Retornos de sucesso

Status code 200

{
    "sucesso": true,
    "notas": [
        {
            "id": "68b5f475ffce22eeb71cef1b",
            "chave": "35250961264974000177550015500009371000029376",
            "tipo": "nfe",
            "emissaoData": "2025-09-01T00:00:00.000Z",
            "entradaData": "2025-09-20T00:00:00.000Z",
            "itens": [
                {
                    "destinacao": "R",
                    "nItem": "1"
                },
                {
                    "destinacao": "R",
                    "nItem": "2"
                },
                {
                    "destinacao": "R",
                    "nItem": "3"
                },
                {
                    "destinacao": "R",
                    "nItem": "4"
                }
            ]
        },
        {
            "id": "68b5f475ffce22eeb71cef1c",
            "chave": "35250944650451000140550040000738506647474285",
            "tipo": "nfe",
            "emissaoData": "2025-09-01T00:00:00.000Z",
            "entradaData": "2025-09-20T00:00:00.000Z",
            "itens": [
                {
                    "destinacao": "R",
                    "nItem": "1"
                }
            ]
        }
    ],
    "paginaAtual": 1,
    "totalPaginas": 3,
    "totalRegistros": 5,
    "temProximaPagina": true
}

Exemplo de retorno usando o parâmetro "semDestinacao" com o valor "true"

{
    "sucesso": true,
    "notas": [
        {
            "id": "68b722cde478bde006b01a50",
            "chave": "35250905396424000130550010000093871996397605",
            "tipo": "nfe",
            "emissaoData": "2025-09-01T00:00:00.000Z",
            "itens": [
                {
                    "nItem": "1"
                },
                {
                    "nItem": "2"
                }
            ]
        },
        {
            "id": "68b9f122e6347b8334ae58c5",
            "chave": "35250951319555000131550010000000521686770480",
            "tipo": "nfe",
            "emissaoData": "2025-09-04T00:00:00.000Z",
            "itens": [
                {
                    "nItem": "1"
                }
            ]
        }
    ],
    "paginaAtual": 1,
    "totalPaginas": 44,
    "totalRegistros": 88,
    "temProximaPagina": true
}

Retornos de erro

Status code 400

{
"error": true,
"message": "Nenhum(a) nota localizado(a) com os parâmetros informados."
}

Consulte essa documentação para saber os possíveis retornos de erros de autenticação.