Thatiana G.

Projetos (Aguardando Propostas):

• Especialista em Shopify e GraphQL Admin API - inconsistência por ProductID

  Desenvolvimento Web | Orçamento: Aberto | Publicado: | Propostas: 10

  Buscamos um desenvolvedor freelancer experiente em Shopify e GraphQL Admin API para diagnosticar e resolver um problema crítico de inconsistência na consulta de produtos por ProductID. O profissional deverá identificar a causa raiz, implementar a correção e validar os resultados em ambiente de produção (em uma plataforma de marketplace).
  
  Modalidade: freelancer, 100% remoto, curto prazo.
  
  Descrição do problema que o profissional precisará corrigir:
  
  Identificamos uma inconsistência na Shopify GraphQL Admin API ao consultar produtos individualmente por ProductID:
  
  - Na listagem de produtos (query de coleção/catálogo), os produtos são retornados corretamente com seus dados completos.
  - Ao consultar o detalhe do mesmo produto usando o ProductID retornado na listagem (ex.: gid://shopify/Product/10052248011074), a API retorna "product": null.
  - O comportamento afeta a obtenção de metafields, preço e disponibilidade de estoque via consulta direta.
  - Suspeita-se que a causa seja divergência de publicação do produto em determinados canais de vendas (o produto existe, mas pode não estar publicado no canal utilizado pela API).
  
  Evidência técnica: a query GraphQL retorna HTTP 200 OK com "product": null, confirmando que o ID é reconhecido, mas o acesso está sendo bloqueado por alguma restrição de visibilidade ou permissão de canal.
  
  O profissional contratado deverá executar as seguintes atividades:
  
  1. Diagnóstico
  - Analisar a query GraphQL e as variáveis utilizadas (gid://shopify/Product/...).
  - Verificar as permissões do token de acesso (Admin API) e os escopos concedidos.
  - Identificar se os produtos estão publicados no canal de vendas correto (ex.: Online Store, API, etc.).
  - Verificar restrições por Sales Channel e App Context na API.
  
  2. Correção
  - Ajustar a query ou o contexto de publicação para que os produtos retornem corretamente na consulta por ID.
  - Caso o problema seja de publicação por canal, orientar e executar a correção nos produtos afetados.
  - Garantir que metafields, preço e disponibilidade sejam acessíveis via consulta direta.
  
  3. Validação e documentação
  - Testar a solução com múltiplos ProductIDs para confirmar consistência.
  - Documentar a causa raiz encontrada e as alterações realizadas.
  - Entregar relatório resumido com explicação técnica da correção.
  
  Requisitos técnicos
  - Experiência comprovada com Shopify GraphQL Admin API.
  - Conhecimento sólido em Sales Channels, publicação de produtos e permissões de API no Shopify.
  - Experiência com ferramentas de teste de API (Postman, Insomnia ou similar ? vide evidência em Insomnia/Bruno na imagem).
  - Capacidade de trabalhar com ambientes de produção com cuidado e responsabilidade.
  
  Entregáveis esperados:
  - Diagnóstico documentado da causa raiz.
  - Resolver o problema e validá-lo em produção.
  - Relatório técnico resumido (pode ser via e-mail ou documento simples).
  - Disponibilidade para suporte por até 7 dias após a entrega para eventuais dúvidas.
  
  Remuneração: a combinar com o profissional.