Nessa rota é possível solicitar a escrituração das notas recebidas.
Requisição
Método HTTP
POST
Endpoint
https://app.plugstorage.com.br/api/sped/escriturarNotasRecebidas
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 |
---|---|---|---|
chave | String | Sim. | Chave da nota |
dataEntradaTipo | String | Sim. | Define como a data de entrada será preenchida. |
entradaData | String | Apenas se dataEntradaTipo for igual a 2 . |
Data fixa de entrada do produto. |
destinacao | String | Sim. | Código que indica a destinação do item. |
Valores aceitos para dataEntradaTipo
:
-
1: A data de emissão será utilizada como a data de entrada. Nesse caso, o campo
entradaData
não deve ser informado. -
2: A data de entrada utilizada será o valor fornecido. Nesse caso, o campo
entradaData
deve ser informado.
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:
{
"escrituracao": [
{
"chave": "11111111111111111111111111111111111111111111",
"dataEntradaTipo": "2",
"entradaData": "12/12/2024",
"destinacao": "C"
},
{
"chave": "22222222222222222222222222222222222222222222",
"dataEntradaTipo": "1",
"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.
Comentários
0 comentário
Por favor, entre para comentar.