Commander vos produits et variantes enregistrés dans FRED

Récupérer le produit

Depuis un devis, utilisez Enregistrer comme produit pour conserver le fichier, la matière, les couleurs par emplacement, les tailles, les réglages de fabrication et l’insert de la marque. Le dernier coût estimé par objet est conservé à titre indicatif et affiché « À partir de… » : fabrication, préparation et service FRED, hors insert et livraison. L’adresse de livraison n’est pas enregistrée dans le produit. Chaque nouveau devis ou commande recalcule son tarif.

Les choix enregistrés s’appliquent lorsque les champs correspondants sont omis. Une valeur explicite remplace le choix enregistré ; insert_id: null retire l’insert pour cette commande.

Dans Produits du dashboard, ouvrez le produit puis Utiliser dans mon site. Copiez son product_id. Le produit doit être actif et appartenir au compte de votre clé API. Une variante optionnelle possède son propre product_variant_id.

Pour une figurine générée spécialement pour chaque acheteur, envoyez le nouveau fichier avec /v1/storefront/quotes/upload. Pour une collection de modèles déjà préparés, réutilisez leurs identifiants produit.

Afficher le prix avant de commander

curl https://api.fredpod.com/v1/storefront/quotes \
  -H "X-API-Key: $FRED_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: devis-produit-panier-1042" \
  -d '{
    "product_id":"prod_abc123",
    "quantity":1,
    "color":"black",
    "destination":{"country":"FR","postal_code":"34000"}
  }'

Vous obtenez le même format que pour un fichier envoyé : fabricants, prix, transport et délais. Commandez ensuite avec le quote_id retourné et, si souhaité, un option_id précis.

Commander directement avec le product_id

Pour une intégration qui connaît déjà son budget :

curl https://api.fredpod.com/v1/storefront/orders \
  -H "X-API-Key: $FRED_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: commande-produit-1042" \
  -d '{
    "product_id":"prod_abc123",
    "quantity":1,
    "color":"black",
    "max_total_cents":2500,
    "external_ref":"BOUTIQUE-1042",
    "shipping_address":{
      "name":"Camille Dupont",
      "line1":"10 rue de la Paix",
      "postal_code":"34000",
      "city":"Montpellier",
      "country":"FR"
    }
  }'

Ici, vous autorisez au maximum 25 € livrés. FRED calcule le prix, sélectionne son fabricant recommandé et crée la commande si toutes les conditions sont réunies. Un prix supérieur renvoie 409 price_limit_exceeded, sans commande ni débit. Pour comparer les alternatives vous-même, utilisez d’abord le devis.

Si le calcul est en cours, l’appel retourne 202 :

{
  "object":"order_request",
  "status":"processing",
  "quote_id":"est_abc123",
  "poll_url":"/v1/storefront/quotes/est_abc123",
  "next_action":"retry_same_request"
}

Aucune commande n’existe à cette étape. Attendez que le devis soit prêt, puis répétez le même appel de commande, avec la même clé et le même corps. Il reprend la demande et ne crée qu’une commande. La fabrication n’est jamais déclenchée par la simple lecture du devis.

Variantes et personnalisation

material, color, quantity, height_mm, product_variant_id et personalization sont facultatifs pour une commande directe de produit. Utilisez GET /v1/materials pour choisir une gamme exacte et une de ses couleurs. La disponibilité dépend du stock, du tarif et du profil qualifié du fabricant. Les champs de personalization doivent être définis sur le produit, par exemple {"prenom":"Léa"} si le produit prévoit réellement ce champ. Un texte arbitraire ne crée pas une nouvelle géométrie.

Avec un quote_id, la configuration vient du devis : n’envoyez pas de nouveaux champs de couleur, quantité ou personnalisation dans la commande. Recalculez le prix si la configuration change.