Wat Amazon Connector toevoegt aan de leveringsbon van Voorraad: velden, knop en wanneer het actief wordt

Wat de module aan de leveringsbon toevoegt

De module breidt de standaardleveringsbon van de app Voorraad (Inventory) uit met een knop en een groep velden. De voorwaarde die de knop toont of verbergt is in Odoo 17, 18, 19 en 20 dezelfde.

Op het formulier van de leveringsbon voegt de module binnen de groep Amazon SP-API deze velden toe:

• Amazon SP-API Account: het SP-API-account dat aan de leveringsbon is gekoppeld.
• Amazon Order ID: de identificatie van de bestelling bij Amazon.
• Amazon Sync State: alleen-lezen. De waarden zijn Pending, Synced en Error; standaard is het Pending. Dat schrijft de code, niet jij.
• Last Amazon Sync: datum en tijd, alleen-lezen.
• Tracking sent to Amazon: alleen-lezen.
• Amazon confirmShipment sent at: datum en tijd, alleen-lezen. De help legt uit dat de automatische verzending, zodra dit is gemarkeerd, zich niet herhaalt, ook niet bij het wijzigen van de tracking of bij een nieuwe poging van de geplande taak; alleen een geforceerde handmatige verzending kan opnieuw versturen.
• Last Amazon error: tekst, alleen-lezen.
• Payload Amazon en Amazon Response: alleen-lezen, en alleen zichtbaar voor gebruikers met beheerrechten voor Instellingen.

De hele groep wordt verborgen als de module voor die leveringsbon geen Amazon-bestellings-ID vindt. Om die te zoeken kijkt de module eerst naar het veld Amazon Order ID van de leveringsbon zelf, daarna naar de gekoppelde verkooporder en tot slot naar andere gegevens van de leveringsbon. De knop Enviar tracking Amazon verdwijnt ook als de leveringsbon niet op Voltooid (Afgehandeld in Odoo 17.0) staat of niet van een Amazon-bestelling is.

Stap voor stap: wanneer de module actief wordt en wat je moet doen

1. Controleer de drie vinkjes van het account. Ze staan op het formulier van Accounts, op het tabblad Orders & Fulfillment, in de groep Order Sync. Auto sync on picking validation en Auto sync al cambiar tracking staan standaard aan; Send confirmShipment asynchronously (via cron) staat standaard uit. Elk veld van het account staat uitgelegd in de velden van het SP-API-account.
2. Maak de leveringsbon aan. Bij het aanmaken probeert de module de Amazon-bestelling te vinden en, als dat lukt, vult hij Amazon Order ID en Amazon SP-API Account in als ze leeg zijn. Voor het account gebruikt hij dat van de leveringsbon of dat van de verkooporder als het actief is; anders zoekt hij de actieve accounts van het bedrijf en, als er maar één is, gebruikt hij die. Zijn er meerdere, dan probeert hij af te leiden welke bij de bestelling hoort. Vindt hij geen Amazon-bestelling, dan vult hij niets in.
3. Valideer de leveringsbon of wijzig de tracking. Dit is het normale verloop en je hoeft niets te klikken. Bij het valideren probeert Odoo de verzending naar Amazon te bevestigen als Auto sync on picking validation aan staat. Bij het opslaan van een leveringsbon die al op Voltooid staat met een gewijzigde tracking, probeert hij dat als Auto sync al cambiar tracking aan staat. Staat het bijbehorende vinkje uit, dan doet die trigger niets.
4. Gebruik je de asynchrone modus, wacht dan op de nieuwe poging. Met Send confirmShipment asynchronously (via cron) aan, zet het valideren de leveringsbon alleen op Pending en is de geplande taak Amazon SP-API - Retry pending shipments (elke vijf minuten, standaard actief bij installatie) de enige die verstuurt. De help van het vinkje meldt dat die taak actief moet zijn.
5. Bekijk na het valideren de groep Amazon SP-API. Amazon Sync State laat zien waar de leveringsbon staat. Staat het op Pending, wacht dan op de volgende poging. Staat het op Error, lees dan Last Amazon error.
6. Verstuur handmatig alleen als het nodig is. De knop Enviar tracking Amazon verschijnt als de leveringsbon op Voltooid staat en van een Amazon-bestelling is. Die slaat de controle op "al verzonden" en op "al gesynchroniseerd met dezelfde tracking" over, die het automatische pad wel respecteert. De help van Amazon confirmShipment sent at legt uit dat die vergrendeling dubbele melding aan de koper voorkomt; overweeg dat goed voordat je hem omzeilt. Mislukt de verzending, dan stopt de knop met Error while syncing Amazon: ….
7. Controleer het resultaat. Na een geaccepteerde verzending vult de module Amazon Sync State, Last Amazon Sync, Tracking sent to Amazon en Amazon confirmShipment sent at in, en leegt hij Last Amazon error. Hij bewaart ook Payload Amazon en Amazon Response, die alleen zichtbaar zijn voor wie beheerrechten voor Instellingen heeft.

Wat de module controleert voordat hij verstuurt

In het automatische pad stopt de module vóór het verzenden stilletjes in deze gevallen:

• De leveringsbon is geen uitgaande levering: de module bevestigt bij Amazon alleen uitgaande leveringen, geen retouren.
• De leveringsbon staat niet op Voltooid.
• Hij vindt geen Amazon-bestellings-ID en geen passend actief account.
• Amazon confirmShipment sent at heeft al een waarde.
• De leveringsbon heeft geen trackingnummer. Staan er meerdere, gescheiden door spaties, komma's, puntkomma's of regeleinden, dan neemt de module de eerste.
• De leveringsbon staat al op Synced met dezelfde tracking.

Er is nog een geval: meldt Amazon de bestelling al als verzonden, dan verstuurt de module niet. Hij probeert de statusvelden dan in te vullen op basis van die externe status, maar alleen als deze leveringsbon de enige uitgaande bon van de bestelling is. Bij meerdere uitgaande leveringsbonnen voor dezelfde bestelling markeert hij niets op eigen houtje, omdat de externe status dubbelzinnig is. Die controle van Amazon geldt ook bij het indrukken van de knop.

Voor de vervoerder zoekt de module de koppeling van het account. Ontbreekt die, dan krijgt de verzending Other als vervoerderscode.

Pending, Error en opgeschorte dienst

Mislukt de automatische verzending, dan zet de module de leveringsbon op Error en bewaart de tekst in Last Amazon error. Ontbreken alleen de verzendgegevens (tracking of vervoerder), dan blijft de leveringsbon op Pending en wordt het veld van de laatste fout leeggemaakt, zodat het opnieuw wordt geprobeerd zodra de gegevens compleet zijn of Amazon de bestelling al als verzonden meldt.

Werkt het account via FlexigoTech Cloud en heeft de connector geen dienst, dan gaat het valideren van de leveringsbon door en blijft de bevestiging op Pending staan (tenzij ze al gesynchroniseerd of verzonden is). De herhalingstaak stuurt hem door zodra de dienst terugkomt, en er wordt niets als fout gemarkeerd. Zonder abonnement, of met een opgeschorte dienst, stopt wat het abonnement dekt; de gegevens blijven in je Odoo staan.

Abonnement en hulp van FlexigoTech

De module is een eenmalige betaling per Odoo-versie (17, 18, 19 en 20) en vereist het abonnement op FlexigoTech Cloud: het plan Conector kost € 49 per maand of € 490 per jaar, excl. btw. Je ziet het op de pagina van de module in Odoo Apps of op de pagina van de module. Ben je Odoo aan het implementeren en wil je de leveringsbonstroom met Amazon aanpassen, dan implementeert FlexigoTech Odoo 17, 18, 19 en 20 en ontwikkelt het connectors 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_amazon_seller_connector 20.0 (8c5900d9): models/fgt_cloud.py
• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8c5900d9): models/stock_picking.py
• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8c5900d9): views/stock_picking_views.xml
• Broncode van de module: flexigobe_amazon_seller_connector 20.0 (8c5900d9): models/amazon_spapi_account.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html