Wat de knop Rapporten ophalen van Octopia Connector doet, stap voor stap

Waar de knop staat en wanneer je hem ziet

De knop Rapporten ophalen staat in het scherm Productpakketten (Product Packages), dat je opent via het menu Octopia › Catalogus › Integratiepakketten. Om het onderdeel Octopia van het menu te zien heb je het recht Octopia-gebruiker nodig.

Met de standaardwaarden is de knop zichtbaar. Hij verdwijnt zodra het veld Status van het pakket de eindstatus bereikt, dezelfde die de knop zelf zet wanneer hij klaar is (dat zie je in de laatste stap). De knop zit in de gepubliceerde branches van de module: Odoo 17, 18, 19 en 20.

Met Odoo in het Nederlands heet de knop Rapporten ophalen. Het volgende schema toont hoe de knop in andere gepubliceerde talen van de module heet.

In het formulier van het pakket zijn vier velden belangrijk:

• Account: staat ook in de lijst met pakketten.
• Taal: staat ook in de lijst, alleen-lezen. Je vult het niet zelf in: de module vult het bij het indienen met Geselecteerde indienen of Indienen bij Octopia, zoals het artikel over die knop uitlegt. De waarden zijn Frans (fr-FR), Engels (en-US) en Spaans (es-ES).
• Regels: de regels van het pakket.
• Laatste polldatum: alleen-lezen, wordt door de knop ingevuld.

Wat de knop doet, in volgorde

Voor elk pakket waarop hij werkt, doorloopt de knop deze stappen:

1. Hij maakt de verbinding met Octopia klaar voor het account dat je bij Account ziet.
2. Hij vraagt de integratierapporten van dat pakket op, in de taal die bij Taal staat, per honderd. Hij blijft pagina's opvragen zolang het antwoord aangeeft dat er een volgende is en de vorige pagina rapporten bevatte.
3. Met alle rapporten samen koppelt hij elk rapport aan een regel van het pakket: eerst op de productreferentie van de verkoper en, als die niet past, op de GTIN, waarbij voorloopnullen nooit worden verwijderd. Een rapport dat bij geen enkele regel past, wordt genegeerd.
4. Hij schrijft in de regel de status van het rapport, het type bewerking, de volledigheidsgraad van de publicatie (nul als het rapport die niet meegeeft) en de berichten. De berichten bundelen fouten, waarschuwingen en informatie, en elk bericht heeft zijn code en het veld waarop het betrekking heeft.
5. Als de regel een gekoppeld product heeft, werkt hij dat bij met de gegevens van het rapport: type bewerking, volledigheid, of het verhandelbaar was, of het bewerkt kon worden, of het verrijkt kon worden, de berichten van het laatste rapport en de datum. Als de status van het rapport overeenkomt met een productstatus, verandert ook de status, en als het rapport de identificatie van het geïntegreerde product meegeeft, slaat hij die op.
6. Hij schrijft Laatste polldatum met het huidige moment.
7. Als het pakket regels heeft en ze allemaal al een status hebben, zet hij de Status van het pakket op de eindstatus en verdwijnt de knop.

Een voorbeeld: het pakket dat terugkomt met een afgewezen regel

Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.

Hogar Norte, een verzonnen bedrijf dat huishoudartikelen verkoopt op Cdiscount, heeft vanuit Odoo al een productpakket naar Octopia gestuurd. Het opent Octopia › Catalogus › Integratiepakketten en gaat het pakket in: de regels hebben nog geen status en de knop Rapporten ophalen is zichtbaar.

Het klikt op de knop. De module vraagt de rapporten van dat pakket op in de taal die Taal toont. Twee rapporten komen overeen met de productreferentie van de verkoper van een regel. Het derde komt alleen met de GTIN en wordt ook gekoppeld, omdat de module de GTIN ongewijzigd vergelijkt, voorloopnullen inbegrepen.

Aan het eind toont elke regel de status van haar rapport en haar berichten met code en veld. Eén van de regels heeft een afwijzingsstatus, en haar berichten leggen uit waarom. Als die regel een gekoppeld product heeft, wordt dat bijgewerkt met de gegevens van het rapport. Laatste polldatum is ingevuld. Omdat alle regels nu een status hebben, gaat de Status van het pakket naar de eindstatus en verdwijnt de knop.

Als er daarentegen een regel zonder rapport was gebleven, zou het pakket open blijven en de knop zichtbaar, zodat Hogar Norte er opnieuw op kon klikken.

Welke problemen de knop zichtbaar maakt

• Berichten in de regel. Wat Octopia als fout, waarschuwing of informatie meldt, staat in de regel, met code en veld. Dat is het eerste wat je moet lezen om een product te corrigeren.
• Regels die niet worden gekoppeld. Een rapport waarvan referentie en GTIN bij geen enkele regel passen, wordt genegeerd en die regel blijft zonder status. Zolang een regel geen status heeft, gaat het pakket niet naar de eindstatus.
• Pakket afgesloten met afwijzingen. Het pakket gaat naar de eindstatus wanneer alle regels een status hebben, welke dan ook. Ook een afgewezen regel telt mee, dus de knop kan verdwijnen terwijl er nog producten te corrigeren zijn: bekijk daarom de berichten van elke regel.
• Voorloopnullen van de GTIN. Het koppelen op GTIN verwijdert de voorloopnullen niet. Als een regel niet van status verandert, controleer dan of haar productreferentie van de verkoper of haar GTIN exact overeenkomt met die van het rapport.
• Verbinding. De poll loopt via de verbinding van het account, die via FlexigoTech Cloud gaat: die bewaart de inloggegevens versleuteld, bewaakt de synchronisatie en waarschuwt per e-mail als er iets misgaat. Zonder abonnement, of met de dienst opgeschort, stopt wat het abonnement levert; de gegevens blijven in je Odoo.

Wat je van het voorbeeld leert

• De knop is zichtbaar zolang de Status van het pakket niet de eindstatus is, en die zet de knop zelf zodra alle regels een status hebben.
• Het formulier laat bij Laatste polldatum zien wanneer er voor het laatst is opgehaald.
• Een status op alle regels betekent niet dat alles is geaccepteerd: lees de berichten van elke regel.

Versies en kosten

Octopia Connector (Cdiscount & Octopia Marketplaces) is gepubliceerd in Odoo Apps voor Odoo 17, 18, 19 en 20. Het is een module met eenmalige betaling per versie (de prijs van elke versie staat op de productpagina) en vereist het abonnement op FlexigoTech Cloud: het plan Connector kost € 49 per maand of € 490 per jaar, excl. btw, met maximaal drie accounts van het platform.

Als je hulp nodig hebt

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Als je Cdiscount-catalogus een aanpassing nodig heeft die de module niet dekt, kunnen we erover praten.

Lees verder

Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen

• Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_product_views.xml
• Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_product.py
• apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html