Resolver a recusa de item com produto que não existe ao gravar o documento

Ao gravar um documento dos portais, o sistema confere se o produto de cada item existe no cadastro de produtos. Se o produto não existe, a gravação é recusada com uma mensagem que diz qual item e qual produto causaram o problema.

Isso interessa principalmente a quem grava documentos por integração. Na tela, o produto do item vem de uma lista, então a situação não costuma acontecer.

A mensagem

A gravação é recusada com status 400 e esta mensagem:

Item N: o produto X não existe.

• N é a posição do item na lista, começando em 1.
• X é o código de produto informado.
• O código de recusa é DOCUMENTO_ITEM_PRODUTO_INEXISTENTE.

Antes desta correção, a mesma situação terminava em “Erro interno.”, sem dizer o motivo.

O que é recusado

• Um código de produto que não está no cadastro de produtos.
• Um código que não é número, como abc. Nesse caso a mensagem mostra o texto informado no lugar de X: “Item 1: o produto abc não existe.”
• Um código zero ou negativo.

Quando o texto informado é longo, a mensagem o mostra cortado em 24 caracteres.

O item que chega sem código de produto (vazio ou nulo) não passa por esta conferência. Ela só vale para o item que traz um código de produto.

Quando a conferência acontece

A conferência vale para todos os portais, tanto ao criar o documento quanto ao salvar o rascunho.

Ela acontece antes de a grade de itens ser regravada. Se um dos itens tem produto inexistente, o documento inteiro é recusado, mesmo que os outros itens estejam corretos, e a grade de itens não é alterada.

Como corrigir

1. Veja na mensagem a posição do item (N) e o código do produto (X).
2. Confira o código do produto nesse item.
3. Corrija o código, ou cadastre o produto se ele ainda não existe (veja Cadastrar um produto).
4. Grave o documento de novo.

No Portal de Vendas, a mensagem pode ser outra

No Portal de Vendas, o item que chega sem valor unitário (VLRUNIT) é conferido antes, na etapa de preço da tabela. Se o produto não existe e o item chega sem valor unitário, a mensagem pode ser esta:

Item N: o produto X não tem preço na tabela de preço vigente. Informe o valor unitário.

A mensagem “o produto X não existe” aparece quando o item traz o valor unitário. Em qualquer dos dois casos, confira primeiro se o código do produto está certo.

Para outras recusas ao gravar o documento, veja Informar o desconto do item e do documento e Resolver a recusa de natureza ou tipo de negociação.