A integração com o produto Plugnotas ocorre através de um arquivo com a extensão '.json'.
Este arquivo é enviado pelo seu software e deverá estar de acordo com a Documentação API PlugNotas que contém todos os campos necessários para que o PlugNotas consiga converter o JSON em XML e enviá-lo para a Sefaz. Por isso, quando um campo ou um grupo é informado indevidamente no arquivo, ocorre a Falha na validação do JSON de NFe/NFCe.
Lembrando que os campos obrigatórios estão marcados na Documentação API PlugNotas com as orientações de como deverá ser enviado e com o texto required na cor vermelho. Segue abaixo um exemplo:
Como Resolver
Quando enviar um JSON com erro, a API retornará dentro do nó 'fields' o campo que está ocasionando o erro. Veremos alguns exemplos abaixo:
Exemplo 1
{
"error": {
"message": "Falha na validação do JSON de NFe",
"data": {
"fields": {
"documento[0].itens[0].cest": "Tamanho mínimo (sem máscara): 7"
}
}
}
}
Identificando o campo que está incorreto
Ao obter este retorno, vamos percorrer o caminho (documento[0].itens[0].cest) indicado no campo 'fields' para localizar o erro:
- documento[0]: o documento que está ocasionando o erro, ocupa a posição 0 (zero) dentro do array de documentos;
- itens[0]: o erro está no item que ocupa a posição 0 (zero) dentro do array de itens;
- cest: o erro está no campo cest, que não está atendendo ao padrão requerido pela API: Tamanho mínimo (sem máscara): 7.
Como resolver: informar o campo cest com pelo menos 7 caracteres (sem máscara).
Exemplo 2
{
"error": {
"message": "Falha na validação do JSON de NFe",
"data": {
"fields": {
"documento[0].itens[1].tributos.icms.baseCalculo.valor": "Preenchimento obrigatório"
}
}
}
}
Identificando o campo que está incorreto
Ao obter este retorno, vamos percorrer o caminho (documento[0].itens[1].tributos.icms.baseCalculo.valor) indicado no campo 'fields' para localizar o erro:
- documento[0]: o documento que está ocasionando o erro, ocupa a posição 0 (zero) dentro do array de documentos;
- itens[1]: o erro está no item que ocupa a posição 1 (um) dentro do array de itens;
- tributos: o erro está dentro do nó "tributos";
- icms: o erro está dentro do nó "icms";
- baseCalculo: o erro está dentro do nó "baseCalculo";
- valor: o erro está no campo valor que não está atendendo ao padrão requerido pela API: campo obrigatório.
Como resolver: Informar o campo valor que é obrigatório no nó 'baseCalculo'.
Exemplo 3
{
"error": {
"message": "Falha na validação do JSON de NFe",
"data": {
"fields": {
"documento[0].itens[0].tributos.icms": "campo 'desoneracao' não esperado para esse CST"
}
}
}
}
Identificando o campo que está incorreto
Ao obter este retorno, vamos percorrer o caminho (documento[0].itens[1].tributos.icms.baseCalculo.valor) indicado no campo 'fields' para localizar o erro:
- documento[0]: o documento que está ocasionando o erro, ocupa a posição 0 (zero) dentro do array de documentos;
- itens[0]: o erro está no item que ocupa a posição 1 (um) dentro do array de itens;
- tributos: o erro está dentro do nó "tributos";
- icms: o erro está dentro do nó "icms", onde foi informado o campo "desoneracao" que não é esperado para o CST utilizado.
Como resolver: Verificar quais os campos permitidos para o CST utilizado no item e remover os campos não permitidos. No exemplo, seria necessário remover o campo 'desoneracao' do item.
Comentários
0 comentário
Por favor, entre para comentar.