AFAS: Producten ophalen uit AFAS

De naam van de categorie die APIcenter als standaard gebruikt. Bij het versturen van producten naar AFAS is dit de artikelgroep waarin een product wordt aangemaakt; elk nieuw artikel heeft een artikelgroep nodig, dus gebruik de naam van een bestaande artikelgroep in AFAS. Bij het ophalen van producten uit AFAS is het de categorie die producten zonder categorie krijgen. Standaard: Import API Center.

Staat deze instelling aan, dan gebruikt APIcenter altijd de standaardcategorie, ook als het product al een categorie heeft. Bij het ophalen van producten uit AFAS krijgt elk product dan de standaardcategorie in plaats van de eigen artikelgroep. Bij het versturen van producten naar AFAS wordt elk product in de standaard artikelgroep aangemaakt. Staat ze uit (standaard), dan wordt de standaard alleen gebruikt als een product geen categorie heeft.

Zet deze instelling aan om een standaardcategorie te gebruiken als een product of variant geen categorie heeft. Bij het versturen van producten naar AFAS wordt de standaard gebruikt als artikelgroep van nieuwe artikelen. De naam vul je in bij Set the value for the default article group, en met de instelling om te forceren pas je hem op alle producten toe. Standaard staat deze instelling uit.

Bedoeld om een variant altijd de categorie van het hoofdproduct te geven, ook als de variant zelf een categorie heeft. De AFAS-flows gebruiken deze instelling op dit moment niet, dus aanpassen heeft geen effect. Laat hem op de standaardwaarde (uit) staan.

Bedoeld om een variant de categorie van het hoofdproduct te geven als de variant zelf geen categorie heeft. De AFAS-flows gebruiken deze instelling op dit moment niet, dus aanpassen heeft geen effect. Laat hem op de standaardwaarde (uit) staan.

Hiermee codeer je de waarden in het adres (de URL) van de bronapplicatie, dus bij flows die gegevens ophalen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Hiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Zet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.

Zet dit aan als een artikel in AFAS in meer dan één categorie kan vallen. APIcenter leest dan elk categorieveld dat de GetConnector voor producten in AFAS levert, in plaats van alleen het hoofdcategorieveld. Staat dit uit (standaard), dan krijgt elk product alleen zijn hoofdcategorie.

Zet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

Hier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Set the administration ID that we use for sending the orders towards gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.

Vul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.

Vul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.

Kies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.

Zet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.

De AFAS-prijslijst die APIcenter als basisprijslijst gebruikt bij het ophalen van producten en prijslijsten uit AFAS. De standaardwaarde ***** (vijf sterretjes) is de standaard AFAS-prijslijst exclusief btw. Pas dit alleen aan als je een andere prijslijst in AFAS als basisprijs gebruikt.

Staat dit aan, dan haalt APIcenter elk AFAS-artikel op als een los, enkelvoudig product en worden varianten niet gecombineerd met hun hoofdartikel. Gebruik dit als je in AFAS niet met configureerbare producten werkt, of als de andere applicatie elk artikel apart moet krijgen. Staat dit uit (standaard), dan wordt een artikel dat in het veld Hoofdartikel naar een ander artikel verwijst, verstuurd als variant van dat hoofdartikel.

Dit is het maximale aantal klanten of items dat de flow in één run uit QuickBooks ophaalt. De standaardwaarde is 5 voor klanten en voorraad en 10 voor producten. De instelling is verplicht.

Hier staat het moment waarop de flow voor het laatst is gestart. APIcenter vult dit zelf in na elke run en gebruikt het om te bepalen wanneer de flow weer mag draaien. Je hoeft dit normaal niet te wijzigen. De standaardwaarde is 1980-01-01T00:00:01: de flow heeft dan nog niet gedraaid.

Dit is het maximale aantal pagina's dat de flow in één run ophaalt. Het aantal items per pagina stel je in bij Use page size. De standaardwaarde is 20.

Dit is het aantal items dat de flow overslaat bij het ophalen. APIcenter werkt de waarde zelf bij na een run: is het aantal opgehaalde items gelijk aan Amount to process, dan wordt de waarde met dat aantal verhoogd, anders wordt hij teruggezet. Wijzig dit alleen als je de flow opnieuw vanaf een bepaald punt wilt laten ophalen. De standaardwaarde is 0.

Hier kies je vaste tijden van de dag waarop de flow ook moet starten. Je kunt meerdere tijden kiezen, in stappen van 15 minuten. Er is geen standaardwaarde.

De datum en tijd vanaf wanneer de flow records uit AFAS ophaalt, op basis van hun wijzigingsdatum: bijvoorbeeld artikelen, debiteuren, prijslijsten, voorraad, betalingen of zendingen die na dit moment zijn gewijzigd. APIcenter schuift deze datum na elke run automatisch op, zodat de volgende run verdergaat waar de vorige stopte. Zet de datum terug in de tijd om records opnieuw te versturen, bijvoorbeeld alle voorraad na een magazijntelling, omdat AFAS een voorraadcorrectie niet als wijziging ziet. Voor AFAS is de standaardwaarde 1 januari 2025.

Dit is het aantal items dat de flow per API-verzoek ophaalt. Samen met Maximum number of pages to retrieve bepaalt dit hoeveel items één run kan ophalen. De standaardwaarde is 50.