Rota para enviar complemento do SPED

Nessa rota é possível enviar 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

POST

Endpoint

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

Query string

Headers

Body

Bloco k200

Bloco 1601

Bloco H

H010

H020

H030

Bloco LMC:

Registro 1300

Registro 1310

Exemplo K200:

{
  "k200": [
    {
      "codigoItem": "019",
      "dataEstoque": "2024-10-21",
      "quantidade": 101,
      "indicadorEstoque": "1"
    },
    {
      "codigoItem": "018",
      "dataEstoque": "2024-10-31",
      "quantidade": 201,
      "indicadorEstoque": "1"
    }
  ]
}

Exemplo H:

{
  "h": [
    {
      "motivoInventario": "01",
      "competencia": "2025-07",
      "h010": {
        "codigoProduto": "1234",
        "valorUnidade": "0.10",
        "indicadorPropriedade": "0",
        "quantidade": "1",
        "descricao": "h010 de teste",
        "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"
      }
    },
  ]
}

Exemplo 1601:

 {
    "1601": [
        {
            "competencia": "2026-05",
            "cnpjInstituicaoTransferencia": "30005600000191",
            "cnpjIntermediadorPagamento": "00009398000105",
            "valorTotalVendas": 1.19,
            "valorTotalISS": 2.05,
            "valorOutros": 1.91
        }
    ]
}

Exemplo LMC:

{
    "lmc": [
        {
            "competencia": "2026-03",
            "registros": [
                {
                    "registro": "1300",
                    "codigoProduto": "277890",
                    "dataFechamento": "2026-03-17",
                    "estoqueAbertura": 21545,
                    "volumeEntrada": 0,
                    "volumeDisponivel": 215,
                    "volumeSaidas": 2040.278,
                    "estoqueEscritural": 104.722,
                    "valorPerda": 1.722,
                    "valorGanho": 0,
                    "indicadorFechamento": 0,
                    "dados": [
                        {
                            "registro": "1310",
                            "numeroTanque": 12,
                            "estoqueAbertura": 21545,
                            "volumeEntrada": 0,
                            "volumeDisponivel": 21545,
                            "volumeSaida": 2040.278,
                            "estoqueEscritural": 14.722,
                            "valorPerda": 1.722,
                            "valorGanho": 0,
                            "volumeFechamento": 19503,
                            "capacidadeTanque": 50000,
                            "dados": [
                                {
                                    "registro": "1320",
                                    "numeroBico": 2,
                                    "numeroIntervencao": 1,
                                    "motivoIntervencao": "teste",
                                    "nomeIntervencao": "teste",
                                    "cnpjIntervencao": "1234567890123",
                                    "cpfIntervencao": "12345678901",
                                    "leituraAbertura": 1.369,
                                    "leituraFechamento": 1.544,
                                    "volumeAferido": 0,
                                    "volumeVendas": 700.825
                                }
                            ]
                        }
                    ]
                },
                {
                    "registro": "1350",
                    "serieEquipamento": "YL 556820",
                    "fabricante": "DO BRASIL SA EQUIPAMENTOS",
                    "modelo": "SM 1097/90",
                    "tipoMedicao": 0,
                    "dados": [
                        {
                            "registro": "1360",
                            "numeroLacre": "I05 74437-4",
                            "dataAplicacao": "2025-03-15"
                        },
                        {
                            "registro": "1370",
                            "numeroBico": 2,
                            "codigoItem": "546548",
                            "numeroTanque": 2
                        }
                    ]
                }
            ]
        }
    ]
}

OBS: Apenas os complementos não existentes em nossa base de dados serão salvos. Caso seja enviado um complemento já armazenado anteriormente, ele será ignorado.

Resposta

Retorno de sucesso

Status code 201

{
  "message": "Complemento do SPED recebido. Armazenamento em andamento.",
  "protocoloLote": "67f67-1-cda2769de-6d8fsdkahsfkaskf8fa12"
 }

Retornos de erro

Status code 401

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