Ajouter une carte personnalisée aux colis FRED

FRED propose une carte postale A6, 105 × 148 mm en portrait ou 148 × 105 mm en paysage, imprimée au recto sur papier 260 g/m² à finition lisse. Le verso reste blanc. Une bordure blanche de 4 mm est ajoutée à l’impression. Fournissez une image 1240 × 1748 px (portrait) ou 1748 × 1240 px (paysage), au format PNG, JPEG ou WebP, sans animation. L’orientation est détectée automatiquement et conservée dans l’aperçu et le PDF de fabrication.

Vous pouvez enregistrer plusieurs designs nommés par marque. Une carte enregistrée n’est jamais ajoutée automatiquement : choisissez son insert_id pour la commande.

Personnaliser un modèle depuis le dashboard

Sélectionnez votre marque dans le sélecteur, puis ouvrez Réglages → Inserts → Carte postale A6 → Configurer la carte A6. Pour ce type d’insert, vous pouvez Importer une carte ou Parcourir les modèles. Dix styles sont proposés : Studio orange, Pop damier, Confetti pastel, Courrier rose, Atelier botanique, Minuit doré, Édition indépendante, Signal néon, Club électrique et Terre & encre. Neuf polices sont incluses dans le studio : Lilita One, Fredoka, Caveat, Space Grotesk, DM Serif Display, Space Mono, Bungee, Anton et Cormorant Garamond. Vous pouvez modifier les textes, polices et couleurs, déplacer ou redimensionner les éléments, changer leur ordre et importer votre logo. Le mode portrait et le mode paysage sont disponibles. L’enregistrement conserve le visuel prêt à imprimer et le design modifiable ; Modifier rouvre vos éléments.

L’API renvoie ce design dans design pour les cartes créées avec le studio. Un remplacement du visuel sans nouveau design retire les anciens éléments modifiables de la nouvelle version, afin qu’ils ne contredisent pas le visuel imprimé.

Créer une carte et obtenir son identifiant

Retrouvez votre brand_id dans Réglages → Branding, après avoir sélectionné la marque. Une clé limitée à cette marque ne peut ni consulter ni modifier les cartes d’une autre marque. L’envoi demande les scopes brands:manage et files:write.

curl https://api.fredpod.com/v1/brands/brand_exemple/inserts/upload \
  -H "X-API-Key: $FRED_API_KEY" \
  -F 'name=Merci pour votre commande' \
  -F 'file=@carte-1240x1748.png;type=image/png'

La réponse 201 contient la carte enregistrée, notamment id, name, brand_id, artwork_url, version et specification. Conservez son id (ins_…). L’enregistrement ne déclenche aucun paiement. L’identifiant est retourné dans la réponse API ; il est également copiable depuis le dashboard.

Retrouver et modifier vos designs

• GET /v1/brands/{brand_id}/inserts : les cartes actives de cette marque.
• GET /v1/brands/{brand_id}/inserts/{insert_id} : une carte et ses caractéristiques.
• PATCH /v1/brands/{brand_id}/inserts/{insert_id} : modifier le nom ou le visuel. La modification crée une nouvelle version, avec un nouvel id. Utilisez ce nouvel identifiant pour vos prochaines commandes.
• DELETE /v1/brands/{brand_id}/inserts/{insert_id} : archiver un design.

Les commandes existantes conservent leur version, même après modification ou archivage. Le dashboard propose l’import, l’aperçu avec bordure, le nom et l’archivage dans Réglages → Inserts → Carte postale A6.

Ajouter la carte à une commande

Une carte coûte 2,50 € HT par commande, soit 3,00 € TTC avec la TVA de 20 % actuellement appliquée, quel que soit le nombre d’objets. Ce supplément s’ajoute au total du devis d’impression et de livraison. Le champ max_total_cents doit couvrir le total avec la carte.

{
  "quote_id": "est_exemple",
  "brand_id": "brand_exemple",
  "insert_id": "ins_exemple",
  "max_total_cents": 2000,
  "shipping_address": {
    "name": "Camille Dupont",
    "line1": "10 rue de la Paix",
    "postal_code": "34000",
    "city": "Montpellier",
    "country": "FR"
  }
}

Envoyez ce JSON à POST /v1/storefront/orders avec votre Idempotency-Key habituel. insert_id fonctionne aussi pour une commande directe avec product_id. Si vous omettez insert_id, FRED reprend la carte enregistrée dans le devis ou le produit. Envoyez explicitement insert_id: null pour commander sans carte.

La réponse commande indique insert_id, insert_cents et le total_cents réellement retenu. Un design archivé ou appartenant à une autre marque est refusé.

Fabricants compatibles

Les options de devis indiquent supplier.postcard_a6. Si vous choisissez vous-même option_id, retenez un fabricant pour lequel ce champ vaut true. Sinon, FRED sélectionne une option disponible compatible avec la carte.

L’atelier reçoit un PDF A6 prêt à imprimer avec la version choisie. Il confirme la présence de la carte lors de l’emballage, avant de créer l’étiquette de livraison.