Rota Adicionar Saldo SPED Contribuições – Central de Atendimento

Nessa rota é possível salvar o saldo contribuições 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/saldo/contribuicoes

Query string

Nome	Descrição
token	Token de identificação da Software House.

Headers

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

Body

Nome	Tipo	Obrigatório	Descrição
ano	String	Sim.	Ano da competência.
mes	String	Sim.	Mês da competência.
tipo	String	Sim.	Tipo do saldo contribuições. Valores aceitos para `tipo`: PIS. COFINS.
cnpjPJ	String	Apenas se credito.origem for igual a `02`.	CNPJ da pessoa jurídica sucedida.
credito	Credito	Sim.	Crédito do saldo contribuições.

Credito

Nome	Tipo	Obrigatório	Descrição
ano	String	Sim.	Ano da apuração do crédito.
mes	String	Sim.	Mês da apuração do crédito.
origem	String	Sim.	Origem do crédito. Valores aceitos para `origem`: 01: Crédito decorrente de operações próprias. 02: Crédito transferido por pessoa jurídica sucedida.
codigo	String	Sim.	Código do crédito.
valor	String	Sim.	Valor do crédito.
valorDesconto	String	Não.	Valor de desconto do crédito..

Exemplo:

{
  "ano": "2025",
  "mes": "05",
  "tipo": "PIS",
  "cnpjPJ": "99999999999999",
  "credito": {
    "ano": "2025",
    "mes": "05",
    "origem": "01",
    "codigo": "01",
    "valor": "100,00",
    "valorDesconto": "25.00"
  }
}

Resposta

Retorno de sucesso

Status code 201

{
  "message": "Saldo contribuições do SPED recebido. Armazenamento em andamento.",
  "id": "0dd20208-4de6-4f85-93c1-5305b4f9e6f5"
}

Retornos de erro

Status code 400

{
  "error": true,
  "message": "Já existe um SPED com situação FECHADA para o CNPJ 99999999999999 no período de 05/2025."
}

{
  "error": true,
  "message": "Já existe um(a) saldo contribuições com os parâmetros informados."
}

Status code 401

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