Errors

Formato

{
  "success": false,
  "message": "IMEI já vinculado a outro financiamento ativo.",
  "timestamp": "2026-07-23T14:32:10.412Z",
  "requestId": "7f3c1e8a-2b44-4d19-9f0e-51a2c8d7b6e3",
  "data": null,
  "error": {
    "code": "imei_already_financed",
    "legacyCode": "LF0031",
    "message": "IMEI já vinculado a outro financiamento ativo.",
    "details": [{ "field": "imei", "issue": "already_linked" }],
    "docsUrl": "https://developer.levfone.com/errors/imei_already_financed"
  }
}

code é o identificador estável — nunca muda entre versões. legacyCode é alias numérico para abertura de chamado no suporte.

---

Faixas de numeração

Faixa	Domínio
LF0001–LF0099	Autenticação e autorização de acesso
LF0100–LF0199	Validação de requisição
LF0200–LF0299	Catálogo (planos, produtos, serviços)
LF0300–LF0399	Estoque e IMEI
LF0400–LF0499	Autorização de venda e crédito
LF0500–LF0599	Faturamento e cancelamento
LF0900–LF0999	Infraestrutura e limites

---

Autenticação — LF00xx

code	legacy	HTTP	Descrição
missing_token	LF0001	401	Header Authorization ausente.
invalid_token	LF0002	401	Token malformado ou assinatura inválida.
expired_token	LF0003	401	Token expirado. Reemita via /oauth/token.
insufficient_scope	LF0004	403	Token válido, mas sem o escopo exigido.
invalid_client	LF0005	401	client_id ou client_secret inválido.
invalid_seller_credentials	LF0010	401	Login ou senha do vendedor incorretos.
seller_inactive	LF0011	403	Vendedor existe, mas está inativo.
seller_session_expired	LF0012	401	Sessão do vendedor expirada.
store_context_required	LF0013	400	storeId obrigatório e ausente.

Validação — LF01xx

code	legacy	HTTP	Descrição
malformed_json	LF0101	400	Corpo não é JSON válido.
missing_required_field	LF0102	422	Campo obrigatório ausente. Ver details.
invalid_field_format	LF0103	422	Campo com formato inválido. Ver details.
missing_request_id	LF0104	400	X-Request-Id ausente.
missing_correlation_id	LF0105	400	X-Correlation-Id ausente.
missing_idempotency_key	LF0106	400	Idempotency-Key ausente.
idempotency_key_conflict	LF0107	409	Chave reutilizada com corpo diferente.
invalid_tax_id	LF0110	422	CPF inválido (dígito verificador).
invalid_imei_format	LF0111	422	IMEI fora do padrão de 15 dígitos.
unsupported_currency	LF0120	422	Apenas BRL é aceito.
invalid_amount	LF0121	422	Valor deve ser inteiro em centavos, não negativo.

Catálogo — LF02xx

code	legacy	HTTP	Descrição
store_not_found	LF0201	404	Loja não existe ou não pertence ao parceiro.
plan_not_found	LF0202	404	Plano não existe ou não está ativo na loja.
product_not_found	LF0203	404	SKU não encontrado na loja.
barcode_not_found	LF0204	404	Código de barras não localizado.
service_not_found	LF0205	404	Serviço não encontrado.
service_not_applicable	LF0206	422	Serviço não é aplicável ao SKU informado.
catalog_unavailable	LF0210	503	Catálogo temporariamente indisponível.

Estoque e IMEI — LF03xx

code	legacy	HTTP	Descrição
imei_not_found	LF0301	404	IMEI não localizado no estoque do parceiro.
imei_wrong_store	LF0302	422	IMEI pertence a outra loja.
imei_out_of_stock	LF0303	422	IMEI já vendido ou indisponível.
imei_blocked	LF0304	422	IMEI bloqueado por restrição operacional.
product_out_of_stock	LF0310	422	SKU sem saldo em estoque.
imei_already_financed	LF0331	409	IMEI já vinculado a financiamento ativo.

Autorização e crédito — LF04xx

Estes códigos aparecem em declineReason com HTTP 200, não como erro.

code	legacy	HTTP	Descrição
proposal_not_found	LF0401	200	Não há proposta aprovada para o CPF na loja.
proposal_expired	LF0402	200	Proposta aprovada, mas fora do prazo de validade.
proposal_already_used	LF0403	200	Proposta já consumida por outra venda.
proposal_reuse_window_expired	LF0404	200	Troca fora da janela de 7 dias da aprovação original.
proposal_reuse_amount_exceeded	LF0405	200	Novo total da troca acima do valor aprovado.
proposal_reuse_limit_reached	LF0406	200	Proposta já reutilizada uma vez.
plan_mismatch	LF0410	200	Plano do carrinho difere do plano da proposta.
product_not_eligible	LF0411	200	Produto não contemplado pela proposta.
service_not_eligible	LF0412	200	Serviço não contemplado pela proposta.
total_mismatch	LF0420	200	Total do carrinho difere do valor aprovado.
total_inconsistent	LF0421	422	grandTotal não bate com a soma dos itens.
credit_limit_exceeded	LF0430	200	Valor acima do limite aprovado.
authorization_not_found	LF0440	404	authorizationId não existe.
authorization_expired	LF0441	409	Autorização venceu o TTL.
authorization_already_confirmed	LF0442	409	Autorização já confirmada.
authorization_cancelled	LF0443	409	Autorização já cancelada.

Faturamento e cancelamento — LF05xx

code	legacy	HTTP	Descrição
sale_not_found	LF0501	404	Venda não localizada por CPF ou IMEI.
invalid_nfe_key	LF0502	422	Chave de acesso da NF-e fora do padrão de 44 dígitos.
sale_not_cancellable	LF0510	409	Venda em estado que não permite cancelamento.
cancellation_not_confirmed	LF0511	409	Cancelamento notificado, mas não confirmado na consulta do PDV.
search_criteria_required	LF0520	422	Informe exatamente um entre CPF e IMEI.

Infraestrutura — LF09xx

code	legacy	HTTP	Descrição
rate_limit_exceeded	LF0901	429	Limite de requisições excedido. Ver Retry-After.
partner_timeout	LF0902	504	PDV Parceiro não respondeu no prazo.
partner_unavailable	LF0903	503	PDV Parceiro indisponível.
internal_error	LF0999	500	Erro interno. Informe o requestId ao suporte.

---

Como reportar

Ao abrir chamado, informe sempre:

1. requestId da resposta
2. X-Correlation-Id da jornada
3. code ou legacyCode
4. Timestamp em UTC

Suporte: https://developer.levfone.com/support