OTTO

OTTO-Market-Logo_neu.png

Contactez la marketplace pour savoir si vous êtes éligible et autorisé à publier vos produits sur leur site.

Pour diffuser vos produits sur leur place de marché, vérifiez également que votre catalogue produits contient les données habituellement requises par Lengow. 

Seuls les vendeurs ayant leur siège social allemand + numéro de TVA sont autorisés à utiliser cette place de marché. Plus d'infos ici.

Matching EAN

Otto ne permet PAS le matching EAN, c'est-à-dire qu'il ne vous sera pas possible depuis Lengow de rattacher vos offres aux pages produits déjà existantes sur ce diffuseur. 

Ajoutez un catalogue diffuseur

Ajoutez le catalogue diffuseur dans votre compte Lengow.

Nous recommandons de définir un Segment dans votre catalogue produits afin de configurer et d'envoyer uniquement les produits que vous souhaitez publier sur ce diffuseur.

Effectuez le Matching Catégories

Effectuez la correspondance entre vos catégories et celles du diffuseur avec le "Matching Catégories".

Réalisez le Matching Attributs

Associez les champs de votre catalogue produits aux champs attendus par le diffuseur, selon la définition proposée. Si besoin, renseignez des valeurs en dur, utilisez des fonctions et/ou affinez les valeurs en créant des règles.
Pour les champs avec des valeurs valides, sélectionnez la valeur proposée ou faîtes la correspondance avec les valeurs de votre catalogue produits. Si une valeur est manquante, contactez le chargé(e) de compte diffuseur pour lui demander la création de la valeur concernée.

Certains champs sont obligatoires, vous devez les renseigner pour publier vos produits. D'autres sont optionnels et ne freineront pas la mise en ligne de vos produits. Ce diffuseur recommande cependant d'en renseigner un maximum pour améliorer la visibilité de vos offres.

1. Paramétrez vos promotions / soldes

Otto demande des informations sur la devise et la TVA pour chaque prix standard que vous envoyez. 

Complétez les attributs obligatoires >suivants dans Lengow pour vos prix standard :

  • pricing.standardPrice.amount: prix standard, utilisez la virgule décimale pour exprimer les cents. Exemple: 10.50 
  • pricing.standardPrice.currency: La devise de votre prix exprimée sous forme de raccourci selon ISO 4217. Ex: EUR 
  • pricing.vat: La taxe sur la valeur ajoutée qui est incluse dans le prix de vente, valeurs proposées FULL ou REDUCE

Prix réduits 

  • pricing.sale.salePrice.amount: prix réduit, utilisez la virgule décimale pour exprimer les cents. Exemple: 5.50
  • pricing.sale.salePrice.currency: La devise de votre prix exprimée sous forme de raccourci selon ISO 4217. Ex: EUR 
  • pricing.sale.startDate: date de début de l'offre de réduction. Ex: 2019-10-19T10:00:15.000+0100 
  • pricing.sale.endDate: date de fin de l'offre de remise. Ex: 2019-10-19T10:00:15.000+0100

2. Modes et frais de livraison

Les attributs de livraison Otto suivants doivent être renseignés dans Lengow:

delivery.type
Le type de livraison. Les valeurs proposées sont :

  • PARCEL : colis avec étiquette de retour. Un returntrackingnumber est demandé
  • FORWARDER_PREFERREDLOCATION : relais_colis (voir avec Otto pour les emplacements spécifiques)
  • FORWARDER_CURBSIDE : service de pickup, récupération de la commande en magasin ou depuis son véhicule. (Voir avec Otto pour plus de précisions sur ce mode de livraison)
  • FORWARDER_HEAVYDUTY: Transport par camion lourd.
  • delivery.deliveryTime 
    Le délai de livraison en jours, avec des valeurs autorisées de 1 à 999.

3. Les valeurs de déclinaisons

OTTO accepte les déclinaisons. 
Pour gérer vos variations dans Lengow :

  • Dans l'attribut "productReference", entrez l'identifiant parent de vos produits, qui doit être identique pour tous les produits d'une variation, et cet identifiant ne doit jamais être modifié.
  • Les produits d'une même déclinaison doivent avoir la même catégorie.
  • Les attributs "productDescription.bulletPoints" sont utilisés pour créer les puces, de sorte que les valeurs peuvent être différentes d'un variant à l'autre (idem pour la description).
  • Les produits avec des variations doivent avoir des informations qui permettent de différencier les produits (par exemple, la couleur, la taille, etc.).
Les produits parents doivent être exclus du flux envoyé à OTTO, si votre catalogue en contient.

4. Paramétrages spécifiques

  • "Energieeffizienzklasse"

Le champ Energieeffizienzklasse attend une valeur située sur une échelle d'unités (une lettre entre A et G).

  • "sku"

Le "sku" est l'identifiant unique de votre produit. OTTO demande que le SKU soit une valeur statique, car il ne peut pas être modifié après avoir été importé avec succès dans leurs systèmes.

Gérez vos Exclusions

Suivez les consignes habituelles liées à l'exclusion, vous devez exclure pour ce diffuseur.

Vos produits sont déclinés ? Vérifiez si les produits parents doivent être exclus ou non dans l'étape dédiée aux déclinaisons. 

Prévisualisez vos données

Vérifiez les données que vous vous apprêtez à transmettre au diffuseur avec l' "Aperçu".

Renseignez vos Options

Paramétrez les différentes options avant d'envoyer votre catalogue produits au diffuseur.

Concernant les identifiants que vous devez remplir : 

  • Otto API login
  • Otto API password

Ces informations d'identification vous seront envoyées par Otto via e-mail après votre intégration avec eux.

Envoyez le catalogue diffuseur

Deux flux distincts sont envoyés au diffuseur par l'API :

  • Flux Produits :
    Il permet l'intégration et la création des produits.  Les prix sont également contenus dans ce flux.
    Il est transmis au diffuseur toutes les 4 heures.
  • Flux Offres :
    Il permet la mise à jour des stocks.
    Il est envoyé au diffuseur toutes les heures.

Consultez les Rapports d'Intégration

Consultez les rapports de diffusion produits et offres pour vérifier que vos produits sont bien paramétrés. Ces rapports ne contiennent que les articles rejetés par le diffuseur. Pour chacun de vos produits en erreur, le diffuseur vous spécifie la raison du rejet.

Les rapports d’intégration produits et offres sont visibles et téléchargeables depuis Lengow : onglet "Diffuseurs" > sélectionnez le diffuseur > cliquez sur "Activité"

 Veuillez noter que les anomalies de produits disponibles sur Otto dans l'onglet "Produktanalyzen" (mis à jour chaque nuit par Otto) ou directement dans le menu "Produktübersicht" ne sont pas récupérées dans Lengow.

Otto fonctionne en mode différentiel, ce qui signifie que seules les modifications sont envoyées au diffuseur durant la journée.
Cependant, des synchronisations complètes sont effectuées pendant la nuit pour envoyer l'intégralité du catalogue.

Pour obtenir les rapports de diffusion offres ou produits contenant l'ensemble des erreurs, assurez-vous de télécharger les rapports correspondant à ces synchronisations complètes dans la section "Historique des rapports" :

  • La synchronisation complète des offres a lieu vers 03:40 CET
  • La synchronisation complète des produits (prix inclus) a lieu vers 03:00 CET
    Conseil : si vos prix ne sont pas à jour, assurez-vous de contrôler ce rapport.

Principales erreurs et leur résolution

  • 700001 - MOIN_ALREADY_KNOWN
    Cette erreur signifie qu'un produit similaire est déjà proposé sur Otto par un autre partenaire. Il vous faut vérifier avec l'URL fournie que le produit indiqué correspond exactement à votre produit : 
    • Si ce n'est pas le même produit, vous devrez ouvrir un ticket auprès d'Otto afin qu’une analyse puisse être réalisée de leur coté. 
    • Si c'est le même produit, l'offre doit être validée dans votre backoffice Otto - ceci ne peut pas être effectué automatiquement depuis Lengow. Vous devrez ensuite transmettre l'identifiant MOIN du produit dans l'attribut "moin" dans Lengow.
  • mediaAssets.location: URL is not valid

    Cette erreur survient lorsque vous envoyez une valeur dans le champ "mediaAssets.type" alors que le champ "mediaAssets.location" correspondant (contenant votre URL image) est vide.
    Pour éviter cela, mettez en place une règle sur le champ "mediaAssets.type", qui le vide lorsque le champ "mediaAssets.location" n'est pas renseigné.

Modifiez une fiche produit

Il n'y a pas de recommandation particulière pour ce diffuseur.

N'hésitez pas à consulter nos guides si besoin :

  • Modifiez les "données produit"
  • Modifiez les "données offre" : Les données sont mises à jour automatiquement à chaque envoi du flux offres (la fréquence d'envoi est indiquée à l'étape "Envoyez votre catalogue diffuseur").

Dépubliez / Supprimez une offre

Pour dépublier une offre du site diffuseur, suivez nos conseils habituels.

Traitez vos commandes 

Vous pouvez traiter vos commandes depuis la plateforme Lengow.

1. Récupération des commandes

Lengow récupère les commandes Otto toutes les 15 minutes.

2. Traitement des commandes

Les commandes passent par différents statuts dans Lengow au cours de leur traitement.

Pour Otto, voici les statuts Lengow que vous pouvez rencontrer sur vos commandes :

✅  "waiting_shipment" correspond aux statuts Otto :  

  • "CONFIRMED"
  • "PROCESSABLE"

Actions possibles sur vos commandes à ce statut : 

 
- ship (expédier). L'action ship requiert d'indiquer le transporteur (carrier) et le numéro de tracking (tracking_number - à noter que pour DHL, un numéro de tracking à 20 chiffres est requis, incluant les zéros initiaux).

   > Si le mode de livraison choisit par le client est "parcel", indiquez également le transporteur pour le retour (return_carrier) et le code de tracking retour (return_tracking_number).

   > 
 Si le mode de livraison choisit par le client est "forwarder...", les champs return_carrier et return_tracking_number sont optionnels.
Dans tous les cas, vous pouvez également préciser l'adresse d'expédition ("from_address_city", "from_address_country_code" et "from_address_postal_code"), la ligne produit expédiée (line).

- cancel (annuler). Vous pouvez préciser la ligne produit à annuler.

✅ "shipped" correspond au statut Otto : 

  • "SENT"

✅  "canceled" correspond aux statuts Otto : 

  • "CANCELLED_BY_CUSTOMER"
  • "CANCELLED_BY_MARKETPLACE"
  • "CANCELLED_BY_PARTNER"

✅  "refunded"  correspond au statut Otto :  

  • "RETURNED"

✅  "waiting_acceptance" correspond au statut Otto :  

  • "ANNOUNCED"  

3. Récupération de l'ancien matériel électronique de l'acheteur final

En tant que vendeur, si vous devez récupérer l'ancien équipement électronique de l'acheteur final, l'information sera disponible :

  • Dans Lengow > Dans l'onglet "Commandes" > via l'export CSV des commandes
  • Dans le module Lengow > dans le champ "extra"
  • Via l'API Lengow > dans la balise "weee_pickup" de l'API Lengow (dans order_line_meta), avec l'info true ou false.
    Exemple : "order_line_meta": {​"weee_pickup": true,}

4. Facture Otto

Pour chaque commande, Otto fournit un justificatif d'achat. Il est mis à votre disposition via l'API Lengow, ainsi que dans la plateforme Lengow, dans le détail de la commande (voir capture d'écran).

otto

Contactez le diffuseur

Actualités du diffuseur

Retrouvez ici les dernières évolutions/communications du diffuseur et ce que vous devez faire dans Lengow :

22 juin 2023 - Migration to V3 of Otto's Receipts API
  • En résumé

Otto migre actuellement de la version V2 de sa Receipts API à la version V3. Lengow passe sur cette nouvelle version le 22 juin 2023.

Les informations de facturation fournies via l'API sont modifiées comme détaillé dans la communication d'Otto ci-dessous. Les factures disponibles dans Lengow évoluent en conséquence.

Aucune action n'est requise dans Lengow. Toutefois, si vous récupérez vos commandes Otto par API, assurez-vous de prendre en compte les modifications.

  • Message original

We are proudly introducing our receipts API v3 with a lot of changes compared to v2, that we will describe here. v2 will be supported until 11th of July 2023. After this date, the receipts interface will reject requests via v2.

Changed
sales_order_id query parameter filter has been renamed to salesOrderId for /receipts endpoint
type has been renamed to receiptType
originalReceiptNumber has been renamed to linkedReceiptNumber
originalCreationDate has been renamed to linkedCreationDate
lineItems was used for only item positions previously, now there is a sub structure that cares about all bill objects
partner.name has been renamed to partner.partnerName
partner.legalRepresentatives has been renamed to partner.representedBy
-partner.registerNumber has been renamed to partner.commercialRegisterNumber
customer.street will not contain house number for newly created receipts
-articleNumber will contain promotion as suffix
lineItems.dimensions has been renamed to lineItems.itemPositions.variationAttributes
amountDue will contain the actual amount due from customer
shippingCost has been renamed to deliveryCost
vatRate has been renamed to taxRate
vat has been renamed to tax

Added
- Introduce receiptTypesfrom and to new query parameter filters for /receipts endpoint
isRealReceipt will indicate whether its a real invoice or technical invoice
customer.houseNumber will contain house number of the customer
deliveryAddress.houseNumber will contain house number of the delivery address
- Introduce totals to contains total amount per tax type and tax rate
- Introduce totalsGrossAmount as summation of total receipt amount including all tax type

Removed
url and priceToPay has been removed
type query parameter filter has been removed for /receipts endpoint

More changes can be found on swagger documentation.

Mars 2023 - Migration vers la V3 de l'API Otto
  • En résumé

Otto déploie actuellement la version V3 de son API produits. Lengow migrera vers cette nouvelle version en mars 2023 (date à préciser). 

Dans la nouvelle version de son API, Otto a de nouvelles exigences concernant certains attributs (lire ci-dessous). Assurez-vous de faire les ajustements nécessaires afin de conserver vos produits en ligne.

  • Ce que vous devez faire dans Lengow

A l'étape du Matching Attributs de votre flux Otto, adaptez vos valeurs aux nouvelles exigences d'Otto : 

    • La seule devise ("currency") autorisée sera l'Euro (code : EUR).
    • Les attributs suivants seront limités à 70 caractères (suggestion : la fonction TRUNC permet de limiter la longueur d'un champ) :
      • "productLine"
      • "Besondere Merkmale"
      • "Set-Info"
    • Dans les champs "mediaAssets.location", les liens URL seront limités à 2083 caractères.
    • Les attributs suivants seront supprimés : "offeringStartDate", "UPC" et "ISBN".
31 août 2022 - Mise à jour des categories
  • En résumé

Le 31 août 2022, Otto met à jour ses catégories et supprime environ 400 catégories. Elles sont remplacées par de nouvelles catégories ayant un nouveau nom et un nouvel ID de catégorie. 

  • Ce que vous devez faire dans Lengow

Ces nouvelles catégories sont d'ores et déjà disponibles dans Lengow. Nous vous recommandons de vous assurer que votre matching catégories est bien complet sur votre flux Otto dans Lengow.

25 Avril 2022 - Migration d'attributs
  • En résumé

Les envois produits vers Otto échouent pour certains flux, car la dénomination d'attributs envoyés à Otto pour certaines catégories sont erronées (non valide pour les envois en JSON vers Otto). Un script de migration est lancé lundi 25 avril pour corriger les attributs concernés.
(Ex: l’attribut 3D-Brillen.productDescription.attributes.UN-Test 38.3 Lithiu“ deviendra "3D-Brillen.productDescription.attributes.UN-Test 38\.3 Lithi”)

  • Ce que vous devez faire dans Lengow

Ce changement est totalement transparent, il est cependant recommandé de vérifier votre matching attributs.

Septembre 2021 - Suppression de catégories
  • En résumé

Otto fait évoluer ses catégories. Aussi des mises à jour sont à réaliser dans votre compte Lengow.
La nouvelle nomenclature pour les catégories et les attributs liés seront disponibles dans la journée du 4 Octobre 2021 sur Lengow, assurez-vous ensuite de vérifier vos paramètres sur votre flux Otto dans Lengow.

  • Ce que vous devez faire dans Lengow

Dans votre flux Otto sur Lengow, vérifiez les étapes du Matching Catégories et du Matching Attibuts si vous avez réalisé des paramétrages sur les catégories concernées.

Retrouvez dans cette liste des catégories les catégories impactées.

  • Message original

Deletion of certain product categories as of 04.10.2021

Over the past few months, we have frequently informed partners about deletions of duplicate/incomprehensible product categories. [...] The deletion will now take place on 04.10.21. The partner must therefore adjust the product category here accordingly if they use one of these 371 product categories. Please find attached an Excel of the affected product categories.  

Juillet 2021 - TVA - Législation

Vous devez définir votre numéro de TVA pendant le processus d'intégration dans votre KYC et dans le backend OTTO.

Aucune action n'est requise dans Lengow pour ce sujet.

-

Articles dans cette section

Nos horaires de support :
9h00 - 18h30 CET du lundi au vendredi