O tratamento eficaz de erros é fundamental para manter a confiabilidade e garantir uma experiência fluida e transparente para o usuário. Esta seção fornece a lista dos códigos de erro retornados pelo Storefront API, inicialmente focado apenas nas operações utilizadas nas páginas de Checkout, Login e MinhaConta. Separados por área de ocorrência do erro, cada código é acompanhado por uma breve descrição para facilitar a identificação rápida e sua resolução. Os erros também poderão ser retornados em inglês, conforme definido o idioma na configuração "Storefront - Idioma das mensagens de erro da API" dentro do painel administrativo da loja.
Confira abaixo os códigos de erro e suas descrições:
| Código | Descrição do Erro |
|---|
| CKT100 | Sem permissão para usar metadados privados |
| CKT101 | Erro ao criar um novo carrinho |
| CKT102 | Id de produto não encontrado |
| CKT103 | Erro ao obter o carrinho com o checkoutId especificado |
| CKT104 | Erro genérico no serviço de Checkout |
| CKT105 | Erro ao obter carrinho simples com o checkoutId especificado |
| CKT107 | Erro ao adicionar produtos ao carrinho |
| CKT108 | Erro ao remover produtos do carrinho |
| CKT109 | Erro ao adicionar metadados no carrinho |
| CKT110 | Erro ao adicionar metadados ao produto variante especificado |
| CKT111 | Erro ao tentar associar um usuário a um carrinho que já possui um usuário |
| CKT112 | Loja não encontrada |
| CKT113 | Carrinho não encontrado |
| CKT114 | Usuário não encontrado |
| CKT115 | Endereço não encontrado |
| CKT116 | Erro ao clonar o carrinho |
| CKT117 | Erro ao tentar fechar um carrinho que já foi fechado |
| CKT118 | Erro ao fechar um pedido |
| CKT119 | O usuário enviado está bloqueado |
| CKT120 | Quantidade mínima de compra do produto não atingida |
| CKT121 | Valor mínimo do pedido não atingido |
| CKT122 | Erro de frete não selecionado ao tentar fechar um carrinho |
| CKT123 | Erro de usuário não associado ao tentar fechar um carrinho |
| CKT124 | Erro ao obter vendedores de marketplace para os produtos do carrinho |
| CKT125 | Erro ao atualizar saldo de conta corrente do carrinho especificado |
| CKT126 | Id de pedido não pertence ao carrinho especificado |
| CKT127 | O usuário autenticado não é o mesmo que está associado ao carrinho |
| CKT128 | O carrinho especificado está aberto em uma operação que espera um carrinho que já foi fechado |
| CKT200 | Timeout na requisição |
| CKT301 | Erro ao remover metadados do carrinho |
| Código | Descrição do Erro |
|---|
| PRM100 | Erro ao adicionar cupom |
| PRM101 | Erro ao aplicar promoções no fechamento do pedido |
| PRM102 | Erro ao remover cupom |
| PRM103 | Erro ao obter brindes |
| PRM104 | Erro ao selecionar variante de brinde |
| PRM105 | Erro ao buscar cupom |
| PRM106 | Cupom não existente |
| PRM107 | O cupom não atende às regras promocionais |
| PRM108 | Erro genérico no serviço de promoções |
| PRM109 | Produto brinde não encontrado no carrinho |
| PRM200 | Erro de timeout na requisição |
| Código | Descrição do Erro |
|---|
| CST100 | Erro ao remover personalizações dos produtos do carrinho |
| CST101 | Erro ao obter personalizações dos produtos do carrinho |
| CST102 | Erro ao adicionar personalizações nos produtos do carrinho |
| CST103 | Erro genérico no serviço de personalizações |
| CST104 | Erro ao atualizar a quantidade do produto especificado |
| CST105 | Erro ao atualizar a quantidade do produto |
| CST106 | Erro ao remover a quantidade do produto especificado |
| CST107 | Erro ao remover a quantidade do produto |
| CST108 | Id de personalização inválido |
| CST200 | Erro de timeout na requisição |
| Código | Descrição do Erro |
|---|
| SUB100 | Erro ao remover assinatura de produtos no carrinho |
| SUB101 | Erro ao obter assinaturas do usuário |
| SUB102 | Erro ao obter a forma de pagamento da assinatura |
| SUB103 | Erro ao obter a assinatura especificada |
| SUB104 | Erro ao atualizar o status da assinatura especificada |
| SUB105 | Erro genérico no serviço de assinaturas |
| SUB106 | Erro ao obter as recorrências de assinaturas disponíveis para o carrinho |
| SUB107 | Erro ao adicionar assinatura para o produto variante especificado |
| SUB108 | Erro ao obter dados de assinatura do carrinho |
| SUB109 | Erro ao obter as assinaturas ativas do endereço especificado |
| SUB110 | Id de assinatura inválido (deve ser maior que 0) |
| SUB111 | Assinatura não encontrada para o usuário especificado |
| SUB112 | Usuário não encontrado |
| SUB200 | Erro de timeout na requisição |
| SUB300 | Erro ao atualizar o endereço de entrega da assinatura especificada |
| SUB302 | Erro ao adicionar o produto à assinatura |
| SUB304 | O produto não pertence ao grupo de assinatura especificado |
| SUB305 | Assinatura não encontrada |
| SUB306 | Erro ao remover o produto da assinatura |
| Código | Descrição do Erro |
|---|
| JMT101 | Erro ao definir informações adicionais de retirada de loja |
| JMT102 | Erro genérico no serviço de fretes |
| JMT103 | Erro ao selecionar a cotação de frete especificada |
| JMT104 | Erro ao obter cotações de frete por centro de distribuição |
| JMT105 | Endereço não encontrado |
| JMT200 | Erro de timeout na requisição |
| Código | Descrição do Erro |
|---|
| SHI100 | Erro ao obter dados de retirada em loja |
| SHI101 | Erro genérico de frete |
| SHI102 | Erro ao selecionar a cotação de frete especificada |
| SHI103 | Erro ao selecionar a cotação de frete agendada especificada |
| SHI104 | Erro ao atualizar informações adicionais de frete |
| SHI105 | Erro ao obter a cotação de frete |
| SHI106 | Endereço não encontrado |
| SHI200 | Erro de timeout na requisição |
| Código | Descrição do Erro |
|---|
| GTW100 | Erro ao processar a forma de pagamento selecionada |
| GTW101 | Não foi possível processar a forma de pagamento selecionada |
| GTW102 | Erro ao deletar um cartão |
| GTW103 | Erro ao selecionar uma forma de pagamento |
| GTW104 | Erro genérico no serviço de pagamentos |
| GTW105 | Erro ao selecionar parcelamentos |
| GTW107 | Erro ao obter a forma de pagamento selecionada do carrinho |
| GTW108 | Forma de pagamento selecionada não encontrada |
| GTW110 | Erro ao redefinir dados de pagamento |
| GTW200 | Erro de timeout na requisição |
| Código | Descrição do Erro |
|---|
| LOG100 | Falha ao autenticar o usuário (e-mail e/ou senha incorretos) |
| LOG101 | E-mail inválido |
| LOG102 | E-mail já existente |
| LOG103 | Loja não encontrada |
| LOG104 | A senha deve ter, pelo menos, 6 caracteres |
| LOG105 | A senha deve atender, pelo menos, 2 das condições de segurança |
| LOG106 | A senha deve atender, pelo menos, 3 das condições de segurança |
| LOG107 | A senha deve atender a todas as condições de segurança |
| LOG108 | CPF já existente |
| LOG109 | CPF inválido |
| LOG110 | Data de nascimento é obrigatória no cadastro (configuração do admin) |
| LOG111 | Data de nascimento inválida |
| LOG112 | CNPJ já existente |
| LOG113 | CNPJ inválido |
| LOG114 | Telefone inválido |
| LOG115 | Erro genérico no serviço de login |
| LOG116 | Erro ao obter as informações do usuário |
| LOG117 | Login conhecido não está disponível |
| LOG118 | Valor de entrada é obrigatório |
| LOG119 | Entrada inválida, deve ser e-mail ou CPF |
| LOG120 | Usuário bloqueado |
| LOG121 | Excedeu o número de tentativas de login conhecidas |
| LOG122 | E-mail é obrigatório |
| LOG123 | CPF é obrigatório |
| LOG124 | Cliente não existe |
| LOG125 | Entrada inválida no Nome Corporativo |
| LOG126 | Entrada inválida no Nome Completo |
| LOG127 | Entrada inválida no Gênero |
| LOG128 | Entrada inválida no RG |
| LOG129 | Por favor, insira seu nome e sobrenome |
| LOG130 | Entrada inválida no Nome da Empresa |
| LOG131 | Entrada inválida na Inscrição Estadual |
| LOG132 | Entrada inválida no Telefone Principal |
| LOG133 | Entrada inválida no Telefone Secundário |
| LOG134 | Chave incorreta |
| LOG135 | Erro ao carregar o contexto da loja |
| LOG136 | Usuário não encontrado |
| LOG137 | Entrada inválida no DDD do Telefone Principal |
| LOG138 | Entrada inválida no DDD do Telefone Secundário |
| LOG139 | O DDD do Telefone Principal precisa conter 2 dígitos |
| LOG140 | O DDD do Telefone Secundário precisa conter 2 dígitos |
| Código | Descrição do Erro |
|---|
| PAR100 | Credenciais inválidas |
| PAR101 | Erro ao associar o parceiro especificado ao carrinho |
| PAR102 | Erro ao desassociar o parceiro especificado do carrinho |
| PAR103 | Parceiro não encontrado |
| PAR104 | Não é permitido enviar id de região e CEP na mesma solicitação |
| PAR105 | É necessário enviar um id de região ou CEP na requisição |
| PAR106 | Não foi possível pesquisar a região do parceiro |
| Código | Descrição do Erro |
|---|
| CTM100 | Usuário não encontrado |
| CTM101 | Não há dados para atualizar (os dados enviados são os mesmos já cadastrados) |
| CTM102 | Endereço do usuário não encontrado |
| CTM103 | Erro ao adicionar o endereço ao usuário |
| CTM104 | Erro genérico de usuário |
| CTM105 | Erro ao remover um endereço do usuário por conter uma assinatura ativa |
| CTM106 | Não foi possível remover o endereço por ser o único endereço cadastrado do usuário |
| Código | Descrição do Erro |
|---|
| SEA100 | Não foi possível buscar pedidos do usuário |
| SEA101 | Erro ao buscar produtos |
| SEA102 | Erro genérico no serviço de busca |
| SEA103 | Erro ao criar o registro dos termos buscados |
| SEA104 | A query de busca não deve ser vazia |
| Código | Descrição do Erro |
|---|
| CCT100 | Erro ao obter o saldo de conta corrente do usuário |
| CCT200 | Erro de timeout na requisição |
| Código | Descrição do Erro |
|---|
| INF100 | Erro ao atualizar os valores do grupo de informações do usuário |
| INF101 | Erro ao inserir os valores do grupo de informações ao usuário |
| INF102 | Erro ao buscar os campos do grupo de informações especificado |
| INF103 | O campo indicado é de preenchimento obrigatório |
| INF104 | O valor pré definido para o campo indicado é obrigatório |
| INF105 | Id do campo do grupo de informações é inválido |
| Código | Descrição do Erro |
|---|
| VAL100 | Sem permissão para usar metadados privados |
| VAL101 | O campo Email é obrigatório |
| VAL102 | Formato de email inválido |
| VAL103 | Id de produto variante deve ser maior que 0 |
| VAL104 | Preço deve ser maior que 0 |
| VAL105 | O campo URL é obrigatório |
| VAL106 | URL inválida |
| VAL107 | O campo AdditionalInfo deve conter menos de 500 caracteres |
| VAL108 | O input Types não pode ser vazio |
| VAL109 | O campo Name é obrigatório |
| VAL110 | O campo indicado deve conter ao menos x caracteres |
| VAL111 | O campo indicado está vazio |
| VAL112 | O campo indicado contém caracteres inválidos |
| Código | Descrição do Erro |
|---|
| TKN100 | CustomerAccessToken inválido ou expirado |
| TKN101 | CustomerAccessToken inválido para esta loja |
| TKN102 | PartnerAccessToken inválido ou expirado |
| TKN103 | É necessário um customerAccessToken com cadastro completo |
| TKN104 | Apenas customerAccessToken autenticado é permitido para esta operação |
| TKN105 | O customerAccessToken não possui a origem do login |
| TKN106 | O tipo do customerAccessToken deve ser NEW para esta operação |
| TKN107 | O customerAccessToken não pertence a um usuário master |
| Código | Descrição do Erro |
|---|
| GOI100 | Id de centro de distribuição inválido |
| GOI101 | Id de endereço inválido |
| GOI102 | Id de forma de pagamento inválida |
| Código | Descrição do Erro |
|---|
| EVT100 | Erro ao obter informações do evento especificado |
| EVT101 | Erro ao obter a listagem de tipos de eventos da loja |
| EVT102 | Erro ao obter a listagem de eventos da loja |
| EVT103 | Apenas os donos da lista podem adicionar produtos ao evento |
| EVT104 | Erro de lista de produtos do evento vazia |
| EVT105 | Erro ao adicionar o produto variante especificado à lista de eventos |
| EVT106 | Erro genérico em lista de eventos |
| EVT107 | Erro ao obter produtos da lista de eventos |
| Código | Descrição do Erro |
|---|
| EML101 | A configuração 'Email Para formulário genérico' pode estar não preenchida no painel do admin |
| EML102 | O corpo do email não pode ser vazio |
| EML103 | Verifique se a configuração 'E-mail 'De' formulário genérico' possui valor definido no painel do admin |
| Código | Descrição do Erro |
|---|
| ORD101 | Id de pedido inválido |
| ORD102 | Erro ao obter produtos digitais |
| Código | Descrição do Erro |
|---|
| PRD100 | Erro ao adicionar um alerta de preço |
| PRD101 | Erro ao adicionar um alerta de estoque |
| PRD102 | Um id de produto ou de lista de compra deve ser enviado |
| PRD103 | Erro ao adicionar a recomendação de produto amigo |
| PRD104 | Erro genérico de produto |
| PRD105 | Erro ao enviar a contra proposta |
| Código | Descrição do Erro |
|---|
| REC100 | Token reCAPTCHA suspeito |
| REC101 | Erro ao buscar chave reCAPTCHA |
| REC102 | A loja não possui uma chave reCAPTCHA ativa em produção e do tipo esperado |
