API de pedidos: novos filtros por CPF e telefone disponíveis
O que há de novo?
Agora a API de pedidos permite buscar pedidos diretamente por CPF/CNPJ (identity) e telefone (phone), além de retornar slug e URL do produto em cada item do pedido.
O que mudou e como funciona
A integração com o Kllic Chat foi otimizada para reduzir chamadas e tornar a busca de pedidos mais direta e eficiente.
Antes dessa melhoria, era necessário:
- buscar o cliente
- depois buscar os pedidos
- e ainda consultar outra API para obter o link do produto
Agora:
- você busca pedidos diretamente por CPF/CNPJ ou telefone
- os itens do pedido já retornam com product_slug e product_url
Isso elimina chamadas extras e acelera o tempo de resposta da integração.
Novos filtros disponíveis
- identity: busca por CPF ou CNPJ do cliente
- phone: busca por telefone fixo ou celular
Os filtros podem ser combinados com outros já existentes, como status do pedido, datas e canal.
Novos campos no retorno
Dentro de cada item do pedido, agora você recebe:
- product_slug: identificador do produto
- product_url: URL pública do produto
Isso permite direcionar o cliente diretamente para o produto, sem depender de outra API.
Como utilizar
Buscar pedidos por CPF
GET /api/v1/orders/?identity=12345678900
Buscar pedidos por telefone
GET /api/v1/orders/?phone=47999998888
Combinar filtros
GET /api/v1/orders/?identity=12345678900&orderState=shipped
Buscar último pedido do cliente
GET /api/v1/orders/?identity=12345678900&sort[completedAt]=desc&limit=1
Benefício direto
- reduz chamadas na API
- melhora o tempo de resposta da integração
- simplifica o fluxo de atendimento no Kllic Chat
- permite direcionar o cliente direto para o produto comprado
- aumenta a eficiência na consulta de pedidos em tempo real
Observações importantes
- buscas por CPF e telefone utilizam LIKE, sem normalização
- formatos diferentes (com ou sem máscara) podem não retornar resultados
- pedidos anônimos não são considerados nesses filtros
- a URL do produto depende do domínio da requisição (atenção em cenários multi-canal)
Essa melhoria mantém total compatibilidade com integrações existentes e adiciona mais eficiência ao consumo da API.
