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.
Note : vous ne disposez pas de ces données dans votre catalogue produits ? Contactez le Support Lengow pour trouver ensemble une alternative.
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.
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.).
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 et prix.
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, que ce soit au niveau de la création des produits (flux produits) ou des mises à jour (flux offres).
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 qu'Otto fonctionne en mode différentiel pour les offres, ce qui signifie que seules les modifications sont envoyées au canal toutes les heures.
Cependant, des synchronisations complètes sont effectuées pendant la nuit pour envoyer l'intégralité des des offres.
Pour obtenir les rapports de diffusion des offres 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 des offres a lieu vers 03:40 CET
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 :
> 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.
- 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).
Contactez le diffuseur
- contact@otto.market
- FAQ
- partnerintegration@otto.market
- support@otto.market (Otto Customer Support)
Actualités du diffuseur
Retrouvez ici les dernières évolutions/communications du diffuseur et ce que vous devez faire dans Lengow :
- 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 receiptTypes, from 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.
- 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".
- 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.
- 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.
- 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.
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.