Como resolver Falha na validação do JSON de NFe/NFCe?

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:

1. documento[0]:  o documento que está ocasionando o erro, ocupa a posição 0 (zero) dentro do array de documentos;
2. itens[0]: o erro está no item que ocupa a posição 0 (zero) dentro do array de itens;
3. 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"
            }
        }
    }
}

{
    "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"
            }
        }
    }
}