Brandbrand
Plan een gesprek
Brandbrand
Een telefoon op een houten tafel met het logo van Shopify op het scherm

Tinx Customer Portal staat in de Shopify App Store, na één reviewronde

Sinds 11 november staat Tinx Customer Portal, de app die wij voor Tinx-IT bouwden, in de Shopify App Store. Hoe we hem van eerste versie tot listing brachten, en het ene punt waarop de review hem terugstuurde.

Wat de app doet

Tinx Customer Portal verbindt het klantaccount van een Shopify-winkel met Microsoft Dynamics 365 Business Central.

Een zakelijke klant logt in op de webshop en ziet daar zijn eigen orders, facturen, leveringen, retouren, creditnota's en offertes, live uit Business Central. Hij downloadt de pdf en bestelt opnieuw vanuit een eerder document. Mailen of bellen is niet meer nodig.

De winkelier kiest welke onderdelen, velden en labels de klant ziet, en kan eigen API-pagina's uit Business Central toevoegen. De app werkt in het Engels, Nederlands, Duits en Frans, en is gratis. Wel heeft de winkelier Business Central nodig met de extensie van Tinx-IT.

Hoe het klantaccount en het beheer eruitzien, zie je in de case.

Eén winkel of de App Store

Een app voor één winkel installeer je met een link, zonder review. In september kozen we samen met Tinx-IT voor de App Store: elke winkelier met Business Central moet de portal zelf kunnen installeren.

Die keuze maak je bij Shopify één keer, en ze bepaalt hoe je bouwt. Er is geen vaste winkel meer om in te stellen. Elke winkelier vult in de app zijn eigen koppeling met Business Central in, en het geheim daarvan wordt versleuteld opgeslagen.

De app leest gegevens van klanten, dus Shopify moet ook die toegang goedkeuren. Dat gebeurt niet los, maar samen met de review van de listing. We bouwden de app in Laravel, zoals al onze Shopify-apps.

Wat we klaarzetten voor de reviewer

Een reviewer van Shopify installeert de app op een eigen testwinkel en probeert elke functie. Dat moet lukken zonder dat hij ons iets hoeft te vragen. Daarom zetten we dit klaar:

  • Zeven beelden van 1600 bij 900. Zonder nagemaakte browserbalk, want Shopify weigert beelden met een browservenster, en geen twee die te veel op elkaar lijken.
  • Een Engelse screencast. Van de installatie tot elke functie, stap voor stap.
  • Een testomgeving. Een sandbox van Business Central met een testklant, zodat de reviewer echte documenten ziet.
  • Een zelfreview vooraf. Shopify heeft een AI-check die de app langs de eisen van de App Store legt. Die gaf 30 punten groen, geen fout en één punt om naar te kijken.

De registratie voor de App Store en het noodcontact deed Tinx-IT zelf. Het is hun app en hun verklaring, en de registratie vraagt om een betaalmethode van de organisatie.

Waar het hing vóór het indienen

Op 12 oktober stond alles klaar. Toch bleef de knop om in te dienen grijs. Twee automatische checks gingen niet op groen: of de app App Bridge van Shopify laadt, en of hij inlogt met sessietokens. Beide klopten in de code.

Shopify leest die checks uit meetgegevens die de admin naar Shopify terugstuurt. Vanuit onze eigen Chrome kwamen die niet aan, want iets op de Mac blokkeerde ze. Ook na een sessie in Safari bleven de checks open. Na contact met Partner Support gingen ze een paar dagen later op groen, en konden we indienen.

Het scherm zegt nergens dat die meetgegevens ontbreken. Blijven de checks hangen terwijl je code klopt, kijk dan eerst of die gegevens aankomen, en schakel Partner Support op tijd in.

Van keuze tot App Store

  1. September: we kiezen voor de App Store. Elke winkelier installeert de app zelf en koppelt zijn eigen Business Central.
  2. 12 oktober: listing, screencast en testomgeving staan klaar. Twee automatische checks houden de knop nog dicht.
  3. Na contact met Partner Support gaan de checks op groen en dienen we in.
  4. 29 oktober: de review pauzeert op één punt. Op 31 oktober dienen we opnieuw in.
  5. 11 november: Tinx Customer Portal staat in de App Store.

De ene ronde terug

Op 29 oktober kwam de review terug. De reviewer had zich in de winkel aangemeld als een eigen testklant. Die klant had geen klantnummer uit Business Central, dus de portal wist niet welke documenten bij hem hoorden. Hij zag "Information unavailable" en een menu met alleen Orders en Profile.

Voor Shopify is dat een extensie die niet af is (eis 5.6.1), en de inzending werd gepauzeerd tot 31 oktober. In onze logs stond geen enkele fout. De app deed precies wat hij moest doen bij een klant zonder koppeling, alleen wist de reviewer dat niet.

We losten het op twee plekken op:

  • In de app. De Quick Start kreeg een stap waarin de winkelier een klant koppelt aan zijn klantnummer.
  • In de testinstructies. Het koppelen van de eigen testklant werd een verplichte stap voordat de reviewer inlogt. Het veld daarvoor neemt maximaal 2.800 tekens, de onze telden er 2.753.

Op 31 oktober dienden we opnieuw in. Op 11 november stond de app in de App Store.

Ons standpunt

Wij dienen een app pas in als hij werkt voor iemand die hem nog nooit zag.
Remco, CTO bij Brandbrand

Wat dit voor jou betekent

Wil je een eigen app in de App Store, reken dan op meer dan de bouw. Bij deze app zat er een maand tussen klaar om in te dienen en live. De review zelf was één ronde.

  • Test als een vreemde. De reviewer kent je data niet en heeft geen klant die al gekoppeld is. Wat er dan op het scherm staat, beoordeelt hij.
  • Je testinstructies horen bij de app. Schrijf ze als stappenplan, met elke stap die de reviewer nodig heeft voordat hij iets ziet.
  • Kies de route vooraf. Eén winkel of de App Store is een keuze die je bij Shopify niet terugdraait, en ze bepaalt hoe je bouwt.

Wij doen het van a tot z: de app bouwen, de listing en de screencast maken, en de review begeleiden tot de app live staat. Lees meer over custom Shopify-apps, of bekijk wat een custom app kost. De portal zelf vind je in de App Store.