Rota Escriturar Notas Recebidas – Central de Atendimento

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/v2/sped/notasrecebidas/escriturar

Query string

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

Headers

Nome	Valor
Authorization	Basic encode64(email:senha)==
content-type	application/json

Body

Nome	Tipo	Obrigatório	Descrição
chave	String	Sim.	Chave da nota
dataEntrada	String	Não	Caso não seja preenchida, a escrituração utilizará a data de emissão da nota
destinacao	String	Não	Código que indica a destinação de todos os itens da nota (obrigatorio em caso de não informar array de itens).
itens	Array<Item>	Não	Array com itens

Item

Nome	Tipo	Obrigatório	Descrição
nItem	String	Sim.	nItem no Item informado no xml
vinculoProduto	String	Não	Valor do código do produto
destinacao	String	Não	Código que indica a destinação do 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.
CT: Consumo Industrialização.
T: Revenda ST.

Observação: o array do payload deve incluir até 20 objetos por requisição.

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": "Ocorreu um erro na apuração. Aguarde alguns minutos e tente novamente.",
    "errors": [
        {
            "chave": "11111111111111111111111111111111111111111111",
            "message": "Nota fiscal não pode ser escriturada (operação não escriturável)"
        },
        {
            "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.