Rota para consultar complemento do SPED

Nessa rota é possível consultar as informações complementares do SPED.

• Requisição

  • Método HTTP

  • Endpoint

  • Query string

  • Headers

  • Body

• Resposta
  • Retorno de sucesso
  • Retornos de erro

Requisição

Método HTTP

GET

Endpoint

https://app.plugstorage.com.br/api/v2/sped/complemento

Query string

Consulta por protocoloLote:

Consulta por codigoItem:

Consulta por período:

Cada consulta retorna 50 registros por página, sendo necessário realizar a paginação através do campo hashProximaPagina. Quando o valor retornado para esse campo for null, isso indica que não há mais registros a serem retornados.

Headers

Body

Nenhum.

Resposta

Retorno de sucesso

Status code 200

{
  "data": {
    "k200": [
      {
        "id": "682e106d2af82584a1f24e81",
        "codigoItem": "TESTE 01",
        "dataEstoque": "2025-04-01",
        "quantidade": 1,
        "indicadorEstoque": "1",
        "protocoloLote": "e82edd39-832e-497b-9347-4c4aa00f8871",
        "status": "SUCESSO",
        "mensagem": "Complemento do SPED armazenado com sucesso"
      },
      {
        "id": "682e106d2af82584a1f24e81",
        "codigoItem": "TESTE 02",
        "dataEstoque": "2025-04-01",
        "quantidade": 1,
        "indicadorEstoque": "1",
        "protocoloLote": "e82edd39-832e-497b-9347-4c4aa00f8871",
        "status": "SUCESSO",
        "mensagem": "Complemento do SPED armazenado com sucesso"
      }
    ]
  },
  "hashProximaPagina": null
}

{
  "data":{
  "h":[
    {
      "id":"68b9dbff5c3eda50fc8d1d80",
      "dataBloco":"2025-08-01",
      "protocoloLote":"02adf2a3-882d-458e-ad8c-254e5d0f6d76",
      "status":"SUCESSO",
      "mensagem":"Complemento do SPED armazenado com sucesso",
      "dadosBloco":{
      "h010":{
        "codigoProduto":"002-abc-teste12",
        "quantidade":"1",
        "valorUnidade":"0.10",
        "indicadorPropriedade":"0",
        "descricao":"h010 de teste - yasmin 2",
        "codigoContaContabil":"1",
        "valorItemIR":"0.01"
      },
     "h020":{
       "cstIcms":"00",
       "bcIcms":"0.01",
       "valorIcms":"0.01"
      },
     "h030":{
       "valorIcmsOp":"00",
       "valorBcIcmsSt":"0.01",
       "valorIcmsSt":"0.01",
       "valorFcp":"0.01"
      },
     "motivoInventario":"04"
     }
   }
  ]
},
"hashProximaPagina":null
}

{
  "data": {
        "bloco1601": [
            {
                "id": "000de3dcd5f50749fe6e7539",
                "protocoloLote": "00ca0bc0-b791-4278-0000-f00c0f0cd000",
                "status": "SUCESSO",
                "mensagem": "Complemento do SPED armazenado com sucesso",
                "dadosBloco": {
                    "competencia": "2026-02",
                    "cnpjInstituicaoTransferencia": "00005100000151",
                    "cnpjIntermediadorPagamento": "00004000000141",
                    "valorOutros": 1.91,
                    "valorTotalISS": 2.05,
                    "valorTotalVendas": 1.11
                }
            }
        ]
    }}

{
    "data": {
        "lmc": [
            {
                "id": "000247f4bd85476bd87abf45",
                "dataBloco": "2026-02-01",
                "protocoloLote": "000001-12a0-43c1-8eb3-222d777a8955",
                "status": "SUCESSO",
                "mensagem": "Complemento do SPED armazenado com sucesso",
                "dadosBloco": {
                    "competencia": "2026-02",
                    "registros": [
                        {
                            "registro": "1300",
                            "codigoProduto": "100",
                            "dataFechamento": "2026-01-21",
                            "estoqueAbertura": 21545,
                            "volumeEntrada": 0,
                            "volumeDisponivel": 215,
                            "volumeSaidas": 2040.278,
                            "estoqueEscritural": 104.722,
                            "valorPerda": 1.722,
                            "valorGanho": 0,
                            "indicadorFechamento": 0,
                            "dados": [
                                {
                                    "registro": "1310",
                                    "numeroTanque": 10,
                                    "estoqueAbertura": 21545,
                                    "volumeEntrada": 0,
                                    "volumeDisponivel": 21545,
                                    "volumeSaida": 2040.278,
                                    "estoqueEscritural": 14.722,
                                    "valorPerda": 1.722,
                                    "valorGanho": 0,
                                    "volumeFechamento": 19503,
                                    "capacidadeTanque": 50000
                                },
                                {
                                    "registro": "1310",
                                    "numeroTanque": 20,
                                    "estoqueAbertura": 21545,
                                    "volumeEntrada": 0,
                                    "volumeDisponivel": 21545,
                                    "volumeSaida": 2040.278,
                                    "estoqueEscritural": 14.722,
                                    "valorPerda": 1.722,
                                    "valorGanho": 0,
                                    "volumeFechamento": 19503,
                                    "capacidadeTanque": 50000
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

Retornos de erro

Status code 400

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

{
  "error": true,
  "message": "A data final não pode ser anterior à data inicial."
}

{
"error": true,
"message": "O intervalo entre dataInicio e dataFim não pode ser maior que 31 dias."
}

Status code 401

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