Wat «Publiceren (upsert)» doet in Octopia Connector, stap voor stap

Waar staat de knop en wanneer zie je hem

De aanbiedingen open je via het menu Octopia › Aanbiedingen › Aanbiedingen. Het onderdeel Octopia vraagt het recht Octopia-gebruiker: heb je dat niet, dan zie je dit onderdeel niet.

De knop Publiceren (upsert) staat in de weergave van de aanbieding en is altijd zichtbaar, in Odoo 17, 18, 19 en 20. De knop Geselecteerde publiceren staat in het scherm Aanbiedingen en bestaat in de versies 17, 18, 19 en 20. Als je op Geselecteerde publiceren klikt, werkt dezelfde publicatiemethode, en die wordt hieronder uitgelegd.

Het label van de knop hangt af van de taal van je Odoo:

De twee velden waarmee de publicatie wordt verdeeld

Elke aanbieding heeft een veld Account en een veld Verkoopkanaal. Beide zie je in het formulier van Aanbiedingen, in de groep Listing, en ook in de lijst met aanbiedingen. Met deze gegevens groepeert de module de aanbiedingen: publiceer je er meerdere tegelijk, dan wordt elke combinatie van account en kanaal als een aparte groep behandeld.

Stap voor stap: wat gebeurt er als je klikt

1. Open de lijst via Octopia › Aanbiedingen › Aanbiedingen, vink de gewenste aanbiedingen aan en klik op Geselecteerde publiceren. Vanuit het formulier van één aanbieding heb je Publiceren (upsert).
2. De module groepeert de aanbiedingen per account en per verkoopkanaal. Elke groep wordt apart gepubliceerd.
3. Voor elke groep kiest de module het publicatiekanaal. Staat het account in testmodus, dan gaan alle publicaties naar het sandbox-kanaal SELLZZ, welk kanaal de aanbieding ook heeft ingesteld. Anders gebruikt de module het kanaal van de aanbieding.
4. Hij controleert of de groep het maximumaantal aanbiedingen van één pakket niet overschrijdt. Als dat wel zo is, stopt de actie.
5. Bij het publicatietype upsert, dat standaard wordt gebruikt, controleert hij of elke aanbieding belastingen, verzendwijzen en een voorbereidingstijd groter dan nul heeft. Ontbreekt er iets bij een aanbieding, dan stopt de actie en toont de melding maximaal 15 referenties van de getroffen aanbiedingen.
6. Ook bij upsert controleert hij of elke aanbieding de belastingcomponenten EcoTax en DeaTax bevat, ook als ze nul zijn. In de code staat dat het Franse kanaal van SELLZZ aanbiedingen afwijst waarin een van beide ontbreekt. Daarom controleert de module dit vóór het versturen in plaats van op de afwijzing te wachten. Ontbreken ze, dan stopt de actie en toont de melding maximaal 15 referenties van de getroffen aanbiedingen.
7. Hij controleert of er geen dubbele aanbiedingsreferenties in hetzelfde pakket zitten: één enkele dubbele referentie zou ervoor zorgen dat alle verzoeken van het pakket worden afgewezen. Zijn die er wel, dan stopt de actie en krijg je ze in een lijst te zien.
8. Heeft het account de verzendwijzen opgeslagen waarop de verkoper is geabonneerd en gebruikt een aanbieding een wijze die niet in die lijst staat, dan gaat de publicatie toch door en wordt de beslissing aan Octopia overgelaten.
9. Slagen alle controles, dan verstuurt de module de aanbiedingen naar Octopia en slaat hij het pakket op in Odoo.

Wat er daarna in Odoo verandert

Voor elke gepubliceerde groep maakt de module een pakket aan met het account, de pakketidentificatie, het publicatietype, de kanaalcode, de status klaar en de datum en tijd van verzending.

Voor elke aanbieding in het pakket maakt hij een regel aan met de referentie, de prijs en de hoeveelheid op het moment dat de verzending werd opgebouwd. De code doet dit bewust zo: de hoeveelheid is een live berekening en de prijs kan veranderen terwijl het pakket in behandeling is, en als verzonden telt wat daadwerkelijk is verstuurd.

Tot slot komt de aanbieding in afwachting van synchronisatie te staan.

Als een controle je tegenhoudt

De controles van stap vier tot en met zeven gebeuren voordat het pakket van de groep wordt verstuurd en opgeslagen; houdt een controle je tegen, dan stopt de actie. Corrigeer de aanbiedingen die in de melding staan of, als de groep het maximum overschrijdt, publiceer minder aanbiedingen tegelijk, en klik daarna opnieuw op de knop.

Wat je beter bij de hand hebt voordat je klikt

Bij het type upsert heeft elke aanbieding belastingen, verzendwijzen, een voorbereidingstijd groter dan nul en de componenten EcoTax en DeaTax nodig, ook als die nul zijn. Bovendien mag de referentie van een aanbieding niet dubbel voorkomen in hetzelfde pakket. Twijfel je over welk account of kanaal bij welke aanbieding hoort, kijk dat dan eerst na in de velden Account en Verkoopkanaal van de lijst.

Kosten en hulp

De module is een eenmalige aankoop per Odoo-versie (17, 18, 19 en 20; de prijs van elke versie staat op de productpagina) en vereist het abonnement op FlexigoTech Cloud, plan Conector: € 49 per maand of € 490 per jaar excl. btw, tot 3 accounts. De verbinding loopt via FlexigoTech Cloud, dat de inloggegevens versleuteld opslaat.

Ben je Odoo aan het implementeren en wil je de aanbiedingen en de koppeling met Octopia klaarzetten, dan implementeren wij bij FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelen we connectoren en integraties op maat.

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_offer_views.xml
• Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_offer.py
• Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): models/octopia_account.py
• Broncode van de module: flexigobe_octopia_connector 20.0 (4848da6a): views/octopia_completeness2_views.xml
• apps.odoo.com/apps/modules/20.0/flexigobe_octopia_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html