Catalogue de produits

Le catalogue marchand décrit les offres que Revclic peut présenter aux acheteurs. La gestion s'effectue depuis la web-app ou avec les opérations GraphQL ci-dessous.

Lister les produits

Utilisez merchantProducts(merchantId, page, perPage) pour récupérer une page d'offres. L'identifiant marchand est obligatoire.

Créer une offre

La mutation createProduct reçoit merchantId et CreateProductInput.

mutation CreateOffer($merchantId: ID!, $input: CreateProductInput!) {
  createProduct(merchantId: $merchantId, input: $input) {
    id
    price
    url
  }
}

{
  "merchantId": "1",
  "input": {
    "name": { "fr": "Casque audio", "es": "Auriculares" },
    "description": { "fr": "Casque sans fil", "es": "Auriculares inalámbricos" },
    "price": "79.90",
    "pricingType": "ONE_TIME_PURCHASE",
    "url": "https://merchant.example/products/casque-audio",
    "imageUrls": ["https://merchant.example/images/casque-audio.jpg"],
    "targetedMarkets": ["FR", "ES"],
    "categoryIds": ["12"]
  }
}

Le nom traduit et le prix sont obligatoires. Les valeurs disponibles pour pricingType peuvent être obtenues avec la requête productPricingTypes.

Mettre à jour une offre

updateProduct(id, input) accepte un UpdateProductInput. Seuls les champs fournis sont modifiés. Utilisez l'identifiant du produit, et non celui du marchand.

Supprimer une offre

deleteProduct(id) retire l'offre du catalogue. Cette action doit être réservée aux offres qui ne seront plus commercialisées.

Recommandations

• Utilisez des URLs HTTPS stables et directement accessibles.
• Fournissez des traductions françaises et espagnoles lisibles.
• Envoyez des prix sous forme de chaîne décimale, sans symbole monétaire.
• Maintenez les images, catégories et marchés ciblés à jour.
• Vérifiez le résultat de chaque mutation avant de considérer la synchronisation comme terminée.

Consultez les pages dédiées de createProduct, updateProduct et deleteProduct pour tous les paramètres.