pconnector

Documentatie

Een pCon-koppeling beheren

Geschreven voor de twee mensen die ermee moeten leven: wie de shop of de offertes draait, en wie de installatie onderhoudt. Wat de onderdelen zijn, wat je in welke volgorde regelt, elke instelling en wat hij werkelijk verandert, en wat een bepaald symptoom meestal betekent.

Begin bij welke van de twee je hebt

pconnector is twee producten die een connector delen en verder vrijwel niets. Ze draaien op verschillende pCon-licenties, autoriseren op een andere manier, en de handleidingen hebben weinig gemeen. De verkeerde kiezen kost een middag.

Op pCon.ui

Webshop

Je importeert de fabrikantcatalogus in je eigen shop en de klant configureert op je productpagina. WooCommerce, Magento 2 en Shopware 6.

  • Catalogusimport vanuit je eigen admin
  • De configurator in een iframe op je domein
  • In winkelwagen via een gesigneerde webhook

Op pCon.basket

ERP

Je verkoper configureert vanuit de offerte en de artikelen komen terug als offerteregels. Vandaag is dat Odoo.

  • Geen catalogusimport, geen domeinwhitelist
  • Een gelicenseerde plek en een interactieve login
  • De configuratie reist mee met de order

De rest van de handleiding

Begrippen

Wat OFML is, wat pCon.ui en pCon.basket zijn, wat een gatekeeper doet en wie welk deel levert. Eén keer lezen en de rest leest sneller.

Updates

Drie kanalen die elk bij hun platform passen, wat een gepubliceerde release daarna niet meer kan, en wat er gebeurt als een abonnement afloopt.

Problemen oplossen

Eerst het symptoom, dan wat het meestal is. De meeste hiervan lijken een fout in je eigen configuratie en zijn dat niet, en precies daarom kosten ze tijd.

Wat hier niet staat, en waarom

Dit is een handleiding om de koppeling te bedienen, geen specificatie om er een te bouwen. De binnenkant blijft er met opzet uit: de volgorde waarin de connector EAIWS aanroept, hoe het webhook-token wordt opgebouwd en gecontroleerd, de veld-voor-veld-vorm van de catalogus-endpoints, en het berichtcontract dat de ERP-bridge spreekt. Dat bestaat allemaal en het is vastgelegd, het is alleen niet gepubliceerd.

Bouw je een adapter voor een platform dat we nog niet dekken, dan is dat materiaal precies wat je onder afspraak krijgt, en dat is een echt gesprek en geen afwimpeling. De drie contracten zijn versioneerd, hun vormen liggen vast in tests, en elk antwoord draagt de versie waartegen het gebouwd is, zodat een adapter kan zien dat de grond onder hem verschoven is.

Wat je hier wel vindt is alles wat je nodig hebt om een verbinding te bedienen, te onderzoeken en te onderhouden zonder ons erbij, en dat is het deel dat bepaalt of dit prettig is om te hebben.

De huidige contractversies. Catalogus catalog/1, bridge bridge/1, updates updates/1. Elk antwoord van de gate draagt zijn versie in een header. Velden toevoegen mag binnen een versie, hernoemen of weghalen betekent een nieuwe. Deze nummers worden bij het bouwen van deze pagina rechtstreeks uit de draaiende configuratie gelezen, dus ze kunnen niet stilletjes achterlopen.

Mis je iets in de handleiding?

Als je hier een antwoord kwam zoeken en het niet vond, is dat een gat dat we willen horen. Het is meestal sneller om de pagina te repareren dan om dezelfde vraag twee keer te beantwoorden.

Of mail naar info@bewisesolutions.com