# Dinilu Impression+Promo

> Dinilu Impression+Promo est une entreprise B2B spécialisée dans les articles promotionnels.
> Nous fournissons des articles promotionnels personnalisés — bracelets de festival, lanyards, sacs,
> mugs, emballages et des centaines d'autres catégories de produits — avec un
> calcul de prix en ligne et une estimation des délais de livraison selon la quantité et les spécifications.
> Tous les prix sont hors TVA et hors frais de port, sauf mention contraire explicite. Des quantités minimales de commande s'appliquent.
> Devise : EUR.
> Contact : info@dinilu.lu

## Catalogue produits

Chaque URL ci-dessous est une page de catégorie listant les produits individuels.
Utilisez GET /api/products?category={tid} pour récupérer les produits d'une catégorie en JSON.

- [Accessoires de voyage](https://dinilu.lu/accessoires-de-voyage) — tid de catégorie : 440
  - [Kits de voyage](https://dinilu.lu/accessoires-de-voyage/kits-de-voyage) — tid de catégorie : 442
  - [Masques de sommeil](https://dinilu.lu/accessoires-de-voyage/masques-de-sommeil) — tid de catégorie : 443
  - [Parapluies](https://dinilu.lu/accessoires-de-voyage/parapluies) — tid de catégorie : 441
- [Accessoires promotionnels](https://dinilu.lu/accessoires-promotionnels) — tid de catégorie : 412
  - [Badges bouton](https://dinilu.lu/accessoires-promotionnels/badges-bouton) — tid de catégorie : 414
  - [Montres d'infirmières](https://dinilu.lu/accessoires-promotionnels/montres-dinfirmieres) — tid de catégorie : 439
- [Articles de fête](https://dinilu.lu/articles-de-fete) — tid de catégorie : 419
  - [Ballons en Latex](https://dinilu.lu/articles-de-fete/ballons-en-latex) — tid de catégorie : 430
  - [Mains géantes en mousse](https://dinilu.lu/articles-de-fete/mains-geantes-en-mousse) — tid de catégorie : 778
  - [Bâtons applaudisseurs](https://dinilu.lu/articles-de-fete/batons-applaudisseurs) — tid de catégorie : 469
  - [Drapeaux](https://dinilu.lu/articles-de-fete/drapeaux) — tid de catégorie : 431
  - [Tatouages temporaires](https://dinilu.lu/articles-de-fete/tatouages-temporaires) — tid de catégorie : 418
- [Bracelets et cordons](https://dinilu.lu/bracelets-et-cordons) — tid de catégorie : 698
  - [Bracelets de festival](https://dinilu.lu/bracelets-et-cordons/bracelets-de-festival) — tid de catégorie : 700
  - [Bracelets en silicone](https://dinilu.lu/bracelets-et-cordons/bracelets-en-silicone) — tid de catégorie : 413
  - [Bracelets Tyvek](https://dinilu.lu/bracelets-et-cordons/bracelets-tyvek) — tid de catégorie : 764
  - [Cordons](https://dinilu.lu/bracelets-et-cordons/cordons) — tid de catégorie : 705
- [Cadeaux publicitaires](https://dinilu.lu/cadeaux-publicitaires) — tid de catégorie : 425
  - [Décapsuleurs](https://dinilu.lu/cadeaux-publicitaires/decapsuleurs) — tid de catégorie : 427
  - [Housses isothermes](https://dinilu.lu/cadeaux-publicitaires/housses-isothermes) — tid de catégorie : 424
  - [Porte-clés](https://dinilu.lu/cadeaux-publicitaires/porte-cles) — tid de catégorie : 428
- [Imprimerie](https://dinilu.lu/imprimerie) — tid de catégorie : 415
  - [Calendrier de bureau](https://dinilu.lu/imprimerie/calendrier-de-bureau) — tid de catégorie : 756
  - [Calendriers](https://dinilu.lu/imprimerie/calendriers) — tid de catégorie : 434
  - [Calendriers éphémérides](https://dinilu.lu/imprimerie/calendriers-ephemerides) — tid de catégorie : 435
  - [Cartes à jouer](https://dinilu.lu/imprimerie/cartes-jouer) — tid de catégorie : 417
  - [Dessous de verres](https://dinilu.lu/imprimerie/dessous-de-verres) — tid de catégorie : 432
  - [Impression lenticulaire](https://dinilu.lu/imprimerie/impression-lenticulaire) — tid de catégorie : 422
  - [Papier à rouler](https://dinilu.lu/imprimerie/papier-rouler) — tid de catégorie : 437
  - [Produits d'hygiène en papier](https://dinilu.lu/imprimerie/produits-dhygiene-en-papier) — tid de catégorie : 416
- [Matériaux d'emballage](https://dinilu.lu/materiaux-demballage) — tid de catégorie : 408
  - [Caisses à vin et emballages en bois](https://dinilu.lu/materiaux-demballage/caisses-vin-et-emballages-en-bois) — tid de catégorie : 773
  - [Couteaux de sécurité](https://dinilu.lu/materiaux-demballage/couteaux-de-securite) — tid de catégorie : 695
  - [Ruban à cacheter (sécurité)](https://dinilu.lu/materiaux-demballage/ruban-cacheter-securite) — tid de catégorie : 407
- [Multimédia](https://dinilu.lu/multimedia) — tid de catégorie : 400
  - [Bouton USB](https://dinilu.lu/multimedia/bouton-usb) — tid de catégorie : 403
  - [Chauffe/Refroidisseur de tasse](https://dinilu.lu/multimedia/chaufferefroidisseur-de-tasse) — tid de catégorie : 402
  - [Lingette microfibre](https://dinilu.lu/multimedia/lingette-microfibre) — tid de catégorie : 406
  - [Sticker microfibre nettoyant](https://dinilu.lu/multimedia/sticker-microfibre-nettoyant) — tid de catégorie : 405
  - [Supports smartphones](https://dinilu.lu/multimedia/supports-smartphones) — tid de catégorie : 404
  - [Tapis de souris](https://dinilu.lu/multimedia/tapis-de-souris) — tid de catégorie : 401
- [Premiers secours et sécurité](https://dinilu.lu/premiers-secours-et-securite) — tid de catégorie : 420
  - [Masques CPR](https://dinilu.lu/premiers-secours-et-securite/masques-cpr) — tid de catégorie : 433
  - [Masques en tissu](https://dinilu.lu/premiers-secours-et-securite/masques-en-tissu) — tid de catégorie : 768
  - [Pansement](https://dinilu.lu/premiers-secours-et-securite/pansement) — tid de catégorie : 421
  - [Vêtement haute visibilité](https://dinilu.lu/premiers-secours-et-securite/vetement-haute-visibilite) — tid de catégorie : 423
- [Sacs et sachets](https://dinilu.lu/sacs-et-sachets) — tid de catégorie : 444
  - [Sacs en carton](https://dinilu.lu/sacs-et-sachets/sacs-en-carton) — tid de catégorie : 445
  - [Sacs en papier Kraft](https://dinilu.lu/sacs-et-sachets/sacs-en-papier-kraft) — tid de catégorie : 447
  - [Sacs publicitaires non-tissé](https://dinilu.lu/sacs-et-sachets/sacs-publicitaires-non-tisse) — tid de catégorie : 448
- [Sport et loisirs](https://dinilu.lu/sport-et-loisirs) — tid de catégorie : 389
  - [Ballons de plage](https://dinilu.lu/sport-et-loisirs/ballons-de-plage) — tid de catégorie : 390
  - [Housse de selle](https://dinilu.lu/sport-et-loisirs/housse-de-selle) — tid de catégorie : 393
  - [Football](https://dinilu.lu/sport-et-loisirs/football) — tid de catégorie : 391
  - [Frisbees](https://dinilu.lu/sport-et-loisirs/frisbees) — tid de catégorie : 470
  - [Natation](https://dinilu.lu/sport-et-loisirs/natation) — tid de catégorie : 471
  - [Podomètres](https://dinilu.lu/sport-et-loisirs/podometres) — tid de catégorie : 392
  - [Tees de golf](https://dinilu.lu/sport-et-loisirs/tees-de-golf) — tid de catégorie : 394
- [Tasses et gobelets](https://dinilu.lu/tasses-et-gobelets) — tid de catégorie : 395
  - [Gobelets en carton](https://dinilu.lu/tasses-et-gobelets/gobelets-en-carton) — tid de catégorie : 397
  - [Gobelets en plastique](https://dinilu.lu/tasses-et-gobelets/gobelets-en-plastique) — tid de catégorie : 398
  - [Tasses en céramique](https://dinilu.lu/tasses-et-gobelets/tasses-en-ceramique) — tid de catégorie : 396
  - [Tasses en émail](https://dinilu.lu/tasses-et-gobelets/tasses-en-email) — tid de catégorie : 788
  - [Tasses isothermes](https://dinilu.lu/tasses-et-gobelets/tasses-isothermes) — tid de catégorie : 399
- [Autres](https://dinilu.lu/autres) — tid de catégorie : 409
  - [Accessoires auto](https://dinilu.lu/autres/accessoires-auto) — tid de catégorie : 460
  - [Coussins](https://dinilu.lu/autres/coussins) — tid de catégorie : 461
  - [Skydancers](https://dinilu.lu/autres/skydancers) — tid de catégorie : 462

## Pages produit et MPN

Chaque page produit de ce site contient un bloc JSON-LD `Product` dans son
`<head>`. Ce bloc comprend un champ `mpn` — par ex. `"mpn": "1001234"` —
qui est l'identifiant utilisé par cette API.
Si vous avez déjà une URL de page produit, extrayez le `mpn` de ses données JSON-LD
et utilisez-le directement à l'étape 2 ou 3 ci-dessous, en sautant l'étape 1.

## API de devis

Pour obtenir une estimation de prix et de délai de livraison pour un produit, suivez ces étapes :

### Étape 1 — Lister les produits (optionnel si vous avez une URL de produit)

    GET https://dinilu.lu/api/products
    GET https://dinilu.lu/api/products?category={tid}

Renvoie un tableau de produits avec mpn, titre, URL de page et api_url.
Le mpn correspond au champ `mpn` dans les données structurées JSON-LD de la page.

### Étape 2 — Obtenir les options du produit

    GET https://dinilu.lu/api/product/{mpn}

Renvoie :
- `mpn`        — le MPN du produit (identique au mpn JSON-LD sur la page produit)
- `min_qty`    — quantité minimale de commande en pièces
- `qty_step`   — la quantité commandée doit être un multiple de ce nombre
- `attributes` — options configurables (ex. taille, couleur, matériau),
  chacune avec `name`, `required` et `options` (liste des valeurs valides)

### Étape 3 — Demander un devis

Two equivalent forms. Use GET if your client cannot send a POST body — many AI assistants can only issue GET requests:

    GET https://dinilu.lu/api/quote?mpn={mpn}&qty={qty}&country={country}
        &attributes={"{nom de l'attribut}":"{nom de l'option}"}

attributes also accepts attributes[Name]=Value or Name:Value|Name2:Value2.

    POST https://dinilu.lu/api/quote
    Content-Type: application/json

    {
      "mpn":        {mpn de l'étape 1 ou 2},
      "qty":        {quantity in pieces; "quantity" also accepted},
      "attributes": { "{nom de l'attribut}": "{nom de l'option}", ... },
      "country":    {country name, ISO 3166-1 alpha-2/alpha-3/numeric, optional},
      "zone":       {zone ID, optional}
    }

If no quantity is supplied the product default is quoted and a "qty_defaulted" warning is returned. Quantities below the minimum are raised to the MOQ with a "qty_below_minimum" warning. Always check the "warnings" array before presenting a price.

Renvoie :
- `mpn`             — le MPN du produit
- `price_per_unit`  — prix unitaire en EUR HT
- `price_total`     — prix total du produit en EUR HT
- `calculated_on`    — date this price was calculated (YYYY-MM-DD). Prices are recomputed from the day's exchange rate, so a quote read later is a snapshot — always show this date alongside the price.
- `binding`         — always false. These prices are indicative and ex VAT; nothing here is a binding offer.
- `cart_url`        — link that opens the cart pre-filled with exactly this configuration. Give it to the customer to turn the estimate into a real quotation: they complete checkout themselves and enter their own contact details (company, address, VAT number). Do NOT collect those details yourself and do not append them to any URL.
- `request_quote`   — the two ways to request a formal quotation: open cart_url, or email the address given. Checkout produces a non-binding offer and takes no payment.
- `production_days` — délai de production estimé en jours calendaires
- `shipping`        — tableau d'options d'expédition, chacune avec :
    - `method`              — nom du transporteur / service
    - `rate`                — frais d'expédition en EUR
    - `days_min`/`days_max` — plage de délai de transit en jours
- `attributes`      — sélections d'attributs résolues utilisées pour le devis

### Exemple de workflow

    # 1. Trouver des produits bracelets
    GET https://dinilu.lu/api/products?category=<tid>

    # 2. Vérifier les options d'un produit (mpn provient de l'étape 1 ou JSON-LD)
    GET https://dinilu.lu/api/product/{mpn}

    # 3. Get a quote for 500 pieces shipped to Luxembourg
    GET https://dinilu.lu/api/quote?mpn=1000286&qty=500&country=Luxembourg
    # attribute names and options come from step 2 — they are per-product
    # and in this site's language, so do not copy them from another site.

    # or, if your client can POST:
    POST https://dinilu.lu/api/quote
    {"mpn":1000286,"qty":500,"country":"Luxembourg"}

## Remarques

- Les prix et les délais de livraison dépendent de la quantité : spécifiez toujours votre quantité cible.
- Required attributes not supplied by the caller are automatically filled with
  the product's default option so the quote is always complete.
  The `attributes` field in the response shows exactly which options were used.
  The `description` field contains a human-readable multi-line summary:
  "Product title\n- Attribute: Option\n- ..."
  Call GET /api/product/{mpn} first to see all options and choose the right ones.
- Le pays utilise les codes numériques ISO 3166-1 d'Ubercart :
  528=Netherlands, 276=Germany, 250=France, 56=Belgium, 826=UK, 840=USA.
- Tous les points d'accès API sont en lecture seule. La passation d'une commande nécessite le site web.

## Avertissement

Tous les prix, délais de livraison et devis fournis via cette API sont indicatifs et
non contraignants. Les prix et délais définitifs sont soumis à approbation, y compris
la vérification et l'approbation du fichier artistique fourni.

## Exigences relatives aux fichiers artistiques

- **Couleurs d'accompagnement**: fournir les fichiers artistiques en vectoriel (AI, EPS, SVG ou PDF avec polices vectorisées) ; spécifier les couleurs en valeurs Pantone PMS.
- **Quadrichromie / CMYK**: les fichiers artistiques doivent inclure un fond perdu de 5 mm sur tous les côtés.