Nessa rota é possível solicitar a escrituração das notas recebidas.

• Requisição
  • Método HTTP
  • Endpoint
  • Query string
  • Headers
  • Body
• Resposta
  • Retornos de sucesso
  • Retornos de erro

Requisição

Método HTTP

POST

Endpoint

https://app.plugstorage.com.br/api/sped/notasrecebidas/escriturar

Query string

Headers

Body

Item

Valores aceitos para destinacao:

• A: Ativo Imobilizado.
• B: Brindes.
• C: Uso e Consumo.
• FD: Formulação Direta.
• I: Industrialização / Insumo / Embalagem.
• O: Outros.
• R: Revenda.
• S: Aplicado à Serviço.
• T: Revenda ST.

Exemplo:

[
{
"chave":"35250259599555000144550010001009321129208095",
"entradaData":"2025-02-20",
"destinacao":"I"
},
{
"chave":"35241007175867000208550000000771991685135844",
"itens":[
{
"nItem":"1",
"vinculoProduto":"ASDFG2",
"destinacao":"A"
}
]
}
]

Resposta

Retornos de sucesso

Status code 201

Essa mensagem será retornada quando todas as notas forem escrituradas com sucesso.

{
    "message": "Escrituração de notas recebidas concluída com sucesso."
}

Status code 207

Essa mensagem será retornada quando parte das notas forem escrituradas com sucesso, mas parte das notas apresentarem erro.

{
    "message": "Escrituração de notas recebidas concluída parcialmente. Algumas chaves apresentaram erro, verifique e tente novamente.",
    "errors": [
        {
            "chave": "11111111111111111111111111111111111111111111",
            "message": "Nenhum item localizado com os parâmetros informados."
        },
        {
            "chave": "22222222222222222222222222222222222222222222",
            "message": "O CNPJ diverge do registrado no destinatário da nota."
        },
        {
            "chave": "33333333333333333333333333333333333333333333",
            "message": "Já existe um SPED com situação FECHADA para o CNPJ 99999999999999 no período de 12/2024."
        }
    ]
}

Retornos de erro

Status code 400

Essa mensagem será retornada quando todas as notas apresentarem erro.

{
    "error": true,
    "message": "Falha ao escriturar notas recebidas. Verifique os erros e tente novamente.",
    "errors": [
        {
            "chave": "11111111111111111111111111111111111111111111",
            "message": "Nenhum item localizado com os parâmetros informados."
        },
        {
            "chave": "22222222222222222222222222222222222222222222",
            "message": "O CNPJ diverge do registrado no destinatário da nota."
        },
        {
            "chave": "33333333333333333333333333333333333333333333",
            "message": "Já existe um SPED com situação FECHADA para o CNPJ 99999999999999 no período de 12/2024."
        }
    ]
}

Status code 401

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