Códigos de erro

Valores de details[].code nas respostas de erro (veja Respostas e erros). Em Criar e Atualizar promoção, cada regra recusada vira um item de details, com o motivo em issue.

`details[].code`	Significado	Como corrigir
`VALIDATION_FAILED`	Campo ou parâmetro inválido: JSON malformado, tipo errado, objeto obrigatório ausente (`generalInformation`, `couponInformation`), texto acima do limite, brinde selecionável inválido, filtros de listagem fora da faixa. O campo vem em `field`.	Corrija o campo indicado.
`NAME_IS_REQUIRED`	Nome vazio.	Informe `generalInformation.name`.
`MISSING_ARGUMENTS`	Argumento numérico ou booleano com vírgula ou com mais de um valor; filtro de clientes inválido.	Veja Convenções e Condição de clientes específicos.
`REUSE_SAME_COUPON_CONFIG_REQUIRES_MULTIPLE_COUPONS`	Reutilização de cupom configurada com um cupom ou menos.	Use `allowCustomerToReuseSameCoupon: false` ou informe vários cupons.
`START_DATE_IS_REQUIRED`	Data de início ausente.	Informe `startDate`.
`END_DATE_IS_REQUIRED`	Data de término ausente.	Informe `endDate`.
`PRIVATE_API_VALIDATION`	Recusa na etapa de gravação: regra de negócio, promoção não encontrada (`404`) ou falha interna. `issue` traz o motivo (pode ter várias linhas). Use o status HTTP para distinguir os casos.	Veja as mensagens frequentes abaixo.
`ACTION_VS_ARGUMENTS_INCOMPATIBILITY`	“Ignorar produtos remarcados” em um desconto ou condição que não aceita esse argumento.	Use o argumento apenas nos descontos % em categorias, % no subtotal (`999` = `"false"`), % e R$ em marcas, e na condição de subtotal.
`CONDITION_VS_ARGUMENTS_INCOMPATIBILITY`	Condição de subtotal com “ignorar remarcados” sem marcas.	Informe o argumento `22` (marcas).
`LIMIT_OF_USERSLINKED_CONDITION_REACHED`	Mais de 80 mil clientes na condição de clientes específicos.	Restrinja os filtros.
`PROGRESSIVE_DISCOUNT_LADDER_INVALID`	Faixas do desconto progressivo inválidas.	Ao menos 2 faixas, crescentes, percentuais em (0, 100].
`NTH_ITEM_DISCOUNT_RULES_INVALID`	Regras do desconto no N-ésimo item inválidas.	N inteiro > 0 e único; percentuais em (0, 100].
`CONDITION_GROUP_VALIDATION`	Grupo de condições sem nome ou sem condições (com 2 ou mais grupos).	Nomeie todos os grupos e inclua ao menos uma condição em cada.
`ACCUMULATION_LINK_INVALID`	Escopo de acúmulo inexistente ou lista de acúmulo inválida.	Veja as regras em Acúmulo.
`ENTITY_RULE_DUPLICATED`	Regra adicional repetida.	Veja Regras adicionais.
`DISCOUNT_PERCENTAGE_OUT_OF_RANGE`	Percentual de desconto fora de (0, 100] ou não numérico.	Informe um percentual maior que 0 e no máximo 100.

Mensagens frequentes (`PRIVATE_API_VALIDATION`)

Mensagem	Causa
Data final não pode ser menor que a Data inicial	`endDate` menor ou igual a `startDate`.
Data final não pode ser menor que data atual	`endDate` no passado — inclusive ao editar uma promoção expirada.
Já existe(m) cupom(ns) cadastrado(s)…	Código de cupom em uso por outra promoção.
Valor do cupom não pode ser vazio ou nulo	Código de cupom vazio em `couponCodes`.
… não permite a associação a lógica …	Operador não aceito pela condição. Consulte `logicOperators` na estrutura de condições.
Condição/Critério com Id … não existe · Ação/Desconto com Id … não existe	Tipo de condição ou desconto não disponível nesta loja.
… permite N argumentos mas, foram incluídos M argumentos · Argumento com Id … não foi encontrado …	Argumentos a mais ou com ID errado para a condição ou desconto.
Argumento … não corresponde ao tipo requerido …	Valor no formato errado (ex.: texto em campo numérico, vários IDs onde só cabe um).
Selo com Id … não existe · Parceiro com Id … não existe	ID de selo ou parceiro inválido.
Ordem deve ser nula, zero ou positiva	`order` negativo.
Selecione ao menos uma promoção…	`accumulationLinks: []`, ou escopo `1`/`2` sem vínculos. Veja Acúmulo.
Não é permitido cadastrar produtos de reseller como brinde…	Brinde com produto de seller.
Regras com o tipo de validação Apenas Inclusos ou Exceto Inclusos precisam ter o argumento preenchido	Regra adicional com `validationId` 3 ou 4 sem `arguments`.
Esta promoção não pode ser definida como "não acumular"…	Outras promoções citam esta no acúmulo delas.

Updated about 2 hours ago