De connectoren instellen
Een essentiële en cruciale stap tijdens de installatie van de AFAS ApiCenter applicatie is ervoor te zorgen dat uw AFAS-omgeving klaar is om gegevens te verzenden en ontvangen die nodig zijn voor de ApiCenter-stromen.
Deze handleiding helpt je bij het correct instellen van de AFAS-connectoren voor ApiCenter-gebruik, maar let goed op de details. Omdat de connectoren erg spellings- en hoofdlettergevoelig zijn. Elke stap van de handleiding is vereist om een succesvolle verbinding tot stand te brengen.
Deze handleiding gaat ervan uit dat u weet hoe u connectoren moet bewerken en dat u bekend bent met hoe configuratie in connectoren werkt.
Stap 1: Download de nieuwste connectorset
Hier vind je de nieuwste connector-set die je nodig hebt om de omgeving correct in te richten in je Profit AFAS. Met toekomstige updates zal de connectorset ook van tijd tot tijd worden bijgewerkt. Blijf zeker op de hoogte voor eventuele updates. Wanneer een update wordt uitgebracht, komt er een document beschikbaar over hoe u de huidige connectorset kunt aanpassen aan de nieuwe connectorset.
Stap 2: Importeer de connectorset in Profit AFAS.
Bij het downloaden van de connectorset. Open je AFAS-omgeving en open het GetConnector Beheer, in het volgende menu: Algemeen -->Uitvoer-->Beheer-->GetConnector.
- Selecteer in dit menu de optie Importeren.
Als deze knoppen ontbreken, lees dan het volgende artikel: FAQ: ontbrekende knoppen
- Selecteer alle connectorbestanden uit de connectorset en importeer deze in de AFAS-omgeving. Als alles correct is geïmporteerd, zou het resultaat eruit moeten zien als de onderstaande schermafbeelding.
Stap 3: Pas de connectorset aan uw omgeving aan
In deze stap leiden we je door de verschillende connectoren en vertellen we je wat je moet aanpassen zodat je applicatie soepel kan draaien. De connectoren zijn niet plug-and-play. Het zal enige aanpassing vereisen om ervoor te zorgen dat informatie daadwerkelijk kan worden verzonden.
Stap 3a: De productconnector (ApiCenter_Article)
- AFAS kent slechts 2 inhoudsvelden, description, en extra description. De meeste webshops gebruiken 3 inhoudsvelden. U kunt kiezen welke woning waarvoor wordt gebruikt. De derde kan worden aangevuld met een extra vrij veld maar is optioneel. Alle drie de inhoudsvelden zijn standaard geconfigureerd voor bestaande AFAS-velden, maar niet per se de juiste. Zorg ervoor dat u deze 3 vervangt voor de juiste beschrijvingen.
- Standaard biedt de connector een optie om de zichtbaarheid van het product op bijvoorbeeld de webshop te bepalen. In de connectorset is deze geconfigureerd naar een vrij veld. Dit betekent dat het veld niet zal bestaan in uw omgeving. Als u van deze functionaliteit gebruik wilt maken, vervangt u dit veld. Als u deze functionaliteit niet wilt gebruiken, verwijdert u dit veld uit de connector.
- Standaard is er de mogelijkheid om de SEO-informatie op te nemen, dit is echter niet standaard in AFAS. Indien u deze informatie nodig heeft kunt u deze velden specificeren. Zo niet, verwijder deze velden dan uit de configuratie.
- Heeft u een hard filter nodig, bijvoorbeeld een identifier voor alleen webshop producten. Het voordeel van een hard filter is om te voorkomen dat producten naar ApiCenter worden gestuurd. Ja, ApiCenter kan producten achteraf filteren, maar dit is niet effectief en kost nog steeds API-aanroepen.
Gebruik dan dit volgende extra veld hiervoor. Dit kan elk vrij veld zijn. Als u geen harde filter wilt gebruiken, verwijder deze dan van de connector.
Als u dit veld correct gebruikt, moet het als volgt worden toegevoegd aan de filterinstellingen van de connector:
- Heb je meerdere storeviews op je webshop, zorg er dan voor dat je dit volgende veld instelt, zodat de connector weet naar welke winkel het product moet gaan.
Stap 3b: De categorie (ApiCenter_Categories_AG) connector
- Standaard ondersteunen we categorieën die uit meerdere lagen bestaan. In deze gids; Bijlage C; er wordt uitgelegd hoe je meerlaagse categorieën instelt in je AFAS-omgeving. Als je ervoor kiest om meerlaagse categorieën in te schakelen, vervang dan de dummy velden door de vrije velden uit je eigen AFAS-omgeving. Als u ervoor kiest om deze functionaliteit niet te gebruiken, verwijdert u deze twee velden gewoon.
Stap 3c: De afmetingen (ApiCenter_Dimensions) connector
Alleen de eigenschap weight is standaard in AFAS. Als de klant ook de andere dimensies nodig heeft, moeten er vrije velden worden gemaakt en moeten de dummy-velden in de connector worden vervangen. Als u ervoor kiest om deze functionaliteit niet te gebruiken, verwijder dan de dummy velden uit de connector.
Stap 3d: De features (ApiCenter_Features) connector
- Naast de standaard basisinformatie kan een product praktisch veel extra functies bevatten. Bijvoorbeeld een functie om te geven waar het product is gemaakt, of een functie om de materialen op te sommen waarvan een product is gemaakt. Deze extra functies zijn niet variabel. Dit betekent dat de functies moeten worden toegevoegd aan eenvoudige producten van aan hoofdproducten. De functies zijn niet bedoeld voor varianten. Meer informatie over het instellen van varianten/configureerbare producten vindt u hier: Bijlage A; voor de feature connector is het belangrijk om de velden toe te voegen die nooit 'variabel' zijn. U kunt zoveel functies toevoegen als u wilt, de twee voorbeeld dummy velden vervangen en/of ze vervangen door uw eigen functies.
- Wanneer u de functies hebt toegevoegd/vervangen die u in uw doeltoepassing wilt implementeren. Zorg ervoor dat u ze toevoegt in de instelling in ApiCenter, zodat de integratie weet dat ze aan uw dataset moeten worden toegevoegd.
- Als u ervoor kiest om de variant/configureerbare productlogica te gebruiken, vervang dan het booleaanse dummy-veld 'IsMainProduct' door het representatieve vrije veld van uw omgeving. Als u deze functionaliteit niet nodig heeft, verwijdert u het veld uit de connector:
Stap 3e: De variant (ApiCenter_VariantAttributes)-connector
- Naast kenmerken kan een product ook producten bevatten met variabele condities. Aangezien AFAS voor deze situaties geen default heeft, dient de klant de informatie door middel van vrije velden aan te leveren. Meer informatie over het instellen van varianten/configureerbare producten vindt u hier: Bijlage A: voor de Variant-connector moet u eerst het dummy-veld vervangen dat een verwijzing naar uw 'Hoofdproduct' bevat.
- Ten tweede moet u de attributen van een product die 'variabel' kunnen zijn, vervangen/verwijderen. Dit is belangrijk, omdat veel applicaties moeten weten welke velden variabel gemaakt kunnen worden. In tegenstelling tot functies kunnen deze eigenschappen dus verschillende waarden bevatten voor elke variant van een product.
Stap 3f: De Afbeeldingen (ApiCenter_Image)-connector
AFAS levert de afbeeldingen voor een product niet als leesbare array, dus elke afbeelding moet apart aan het eindpunt worden toegevoegd. Omdat sommige applicaties meer informatie wensen dan AFAS kan bieden, kunnen extra vrije velden worden toegevoegd om deze informatie weer te geven. Er kunnen in totaal 7 afbeeldingen worden aangeleverd met AFAS en deze hebben allemaal de mogelijkheid om vrije velden toe te voegen. In het uiterste geval zullen dit 28 vrije velden zijn.
Onze verwachting is dat alleen vrije velden worden toegevoegd voor welke functionaliteit de klant zal kiezen om te gebruiken. Bijvoorbeeld; de tweede afbeelding is de 'thumbnail' afbeelding op de webshop. In dit geval hoeft u alleen het ene vrije veld voor de tweede afbeelding toe te voegen. De overige vrije veld 'dummy' velden zullen verwijderd moeten worden. Voeg alleen toe wat nodig is.
Er zijn 4 'mogelijke' velden per afbeelding, verwijder de velden die niet worden gebruikt.
Step3f-2: Video-ondersteuning op de Afbeeldingen (ApiCenter_Image)-connector
Met versie V.2022.01 van de Connector-set ( Connector-set v.2022.01 ) kunnen video's worden ondersteund.
Voeg de volgende velden, met de precieze naam, toe aan de connector en je video's kunnen worden opgehaald met het product uit AFAS.
Stap 3g: De Stock (ApiCenter_StockItem) connector
AFAS heeft meerdere manieren om voorraadinformatie weer te geven. Voor een tellertoepassing kan het van belang zijn om gereserveerde voorraad in de berekening te gebruiken in plaats van de werkelijke weergave van de voorraad, aangezien AFAS de inkomende voorraad zou kunnen doorrekenen naar de totalen. Standaard wordt de ActualStock gebruikt door de integratie.
Net als de product connector heeft de stock connector de mogelijkheid om een hard filter in de connector te voorzien. Als u ervoor kiest om het filter te gebruiken, vervang dan het vrije veld door de overeenkomstige veld(en) in uw omgeving. Als dit niet het geval is, verwijdert u het dummyveld.
Stap 3h: De Unit (ApiCenter_Unit) connector
Stap 4: Rond de installatie af in de App Connector.
- Open het gedeelte Algemeen. Ga dan naar de Beheeropties en selecteer opnieuw de 'App connector'.
- Dubbelklik op de APICenter App Connector om de App Connector-eigenschappen te openen.
- Onder het gedeelte GetConnector kunt u nieuwe Connectors toevoegen door op de hieronder gemarkeerde 'Nieuw'-knop te drukken.
- Markeer vervolgens alle ApiCenter-connectoren en druk op Voltooien (Voltooien).
- Onder de sectie UpdateConnectoren kunt u nieuwe Connectors toevoegen door op de hieronder gemarkeerde 'Nieuw'-knop te drukken.
- Selecteer vervolgens de volgende rijen: Contact, Organisatie, Persoon, Verkooprelatie organisatie, Verkooprelatie persoon, Verkooporder en druk op Voltooien:
-
- Dit laat over aan de volgende set Connectors in de UpdateConnector (zie onderstaande afbeelding), druk op Ok.
Offertes
Als je offertes naar AFAS wilt sturen, moet je ook de FbSalesQuotation update connector toevoegen met bovenstaande methode.