Verbinden met AFAS (bèta)
This content is not available in your language yet.
Voor AFAS werkt SamenstelFlow met een app-connector: een koppeling die je in AFAS Profit aanmaakt en waaraan je een token koppelt. Naast dat token heb je je deelnemersnummer nodig, het vijfcijferige nummer van je AFAS Online-omgeving.
Wat je nodig hebt
Section titled “Wat je nodig hebt”Deelnemersnummer. Vijf cijfers, bijvoorbeeld 12345. SamenstelFlow gebruikt het om de juiste AFAS-omgeving te bereiken. Vult je iets anders in, dan meldt het scherm dat het deelnemersnummer uit vijf cijfers moet bestaan.
App-connectortoken. Je maakt de app-connector aan in AFAS Profit onder App-connectoren, en genereert daar het token. Plak het token in zijn geheel over, inclusief de omringende tekens: SamenstelFlow verwacht het token precies zoals AFAS het uitgeeft.
Welke gegevens de app-connector moet vrijgeven
Section titled “Welke gegevens de app-connector moet vrijgeven”Een app-connector geeft alleen toegang tot de GetConnectors die je er expliciet aan koppelt. SamenstelFlow gebruikt er vier verplichte en vier optionele:
- DDI_Profit_Administraties: de lijst met administraties. Zonder deze werkt het koppelen niet, want dit is meteen de controle of je gegevens kloppen.
- Speedbooks_Grootboek: het grootboek.
- Speedbooks_Financiele_mutaties: de financiële mutaties.
- Profit_Period_balance: de periodesaldi.
- DDI_Profit_Bedrijfsgegevens (optioneel): de eigen bedrijfsgegevens van elke administratie (naam, KvK-nummer, btw-nummer, adres en contactgegevens van de gekoppelde organisatie). SamenstelFlow vult daarmee bij het koppelen en bij Gegevens ophalen de lege bedrijfsgegevens. De connector heeft precies deze veld-ID’s:
Administratienummer,Naam,KvkNummer,Vestigingsnummer,BtwNummer,Straat,Huisnummer,Toevoeging,Postcode,Woonplaats,Land,EmailenTelefoon. - DDI_Profit_Relaties (optioneel): de debiteuren en crediteuren met naam, KvK-nummer en IBAN. SamenstelFlow gebruikt dit bij het inlezen om relaties volledig te vullen. De connector heeft precies deze veld-ID’s:
Administratie,Soort,Nummer,Naam,KvkNummerenIban.Soortheeft de waardeDebiteurofCrediteur;Nummeris het debiteuren- of crediteurennummer. - DDI_Profit_Bankrekeningen (optioneel): de eigen bankrekeningen van de administratie. De connector heeft precies deze veld-ID’s:
Administratie,GrootboekrekeningenIban. - DDI_Profit_OpenPosten (optioneel): de openstaande posten van debiteuren en crediteuren, zoals AFAS ze vandaag zelf berekent (dezelfde cijfers als de AFAS-rapportage Controlelijst crediteurensaldi). SamenstelFlow bouwt daarmee de lijsten met openstaande debiteuren en crediteuren op de peildatum op. De connector heeft precies deze veld-ID’s:
Administratie,Soort,Nummer,Naam,Factuurnummer,Boekingsdatum,Factuurdatum,Omschrijving,FactuurbedragenOpenstaand.Soortheeft de waardeDebiteurofCrediteur;Nummeris hetzelfde debiteuren- of crediteurennummer als bij DDI_Profit_Relaties;Openstaandis het bedrag dat vandaag nog openstaat.
Elke optionele connector die een veld Administratie noemt, moet dat veld ook echt bevatten: SamenstelFlow filtert daarop, zodat een AFAS-omgeving met meerdere administraties alleen de gegevens van de gekoppelde administratie oplevert. Een connector zonder dit veld wordt niet gebruikt. Andere velden die je er zelf aan toevoegt worden niet gelezen en niet opgeslagen.
Een optionele GetConnector aanmaken en koppelen
Section titled “Een optionele GetConnector aanmaken en koppelen”- Ga in AFAS Profit naar Algemeen > Beheer > GetConnector en klik op Nieuw.
- Kies de gegevensverzameling: voor DDI_Profit_Relaties een verzameling met de debiteuren en crediteuren van de administratie, voor DDI_Profit_Bankrekeningen een met de eigen bankrekeningen en hun grootboekrekening, voor DDI_Profit_OpenPosten een met de openstaande posten van debiteuren en crediteuren (de bron van de AFAS-rapportage Controlelijst crediteurensaldi).
- Geef de connector precies de naam uit de lijst hierboven, hoofdlettergevoelig.
- Voeg alleen de genoemde velden toe en zet bij elk veld het veld-ID precies zoals hierboven, ook hoofdlettergevoelig. Bij DDI_Profit_Relaties en DDI_Profit_OpenPosten levert
Soortper rijDebiteurofCrediteur. - Sla op en open onder Algemeen > Beheer > App connector de app-connector van SamenstelFlow. Voeg op het tabblad GetConnectoren de nieuwe connector toe.
- Lees de administratie opnieuw in. Relaties krijgen dan KvK-nummer en IBAN, en de eigen IBAN’s komen binnen. DDI_Profit_OpenPosten hoeft niet opnieuw ingelezen te worden: de export leest die connector zelf, dus start de export opnieuw.
Ontbreekt een van de drie Speedbooks- en Profit-connectoren, dan kun je de administratie wel koppelen maar zullen werkstukken later leeg blijven of mislukken. Ontbreekt DDI_Profit_Bedrijfsgegevens, dan werkt het koppelen gewoon; je vult de bedrijfsgegevens dan zelf in of haalt ze via de KvK op. Ontbreken DDI_Profit_Relaties en DDI_Profit_Bankrekeningen, dan gaat het inlezen gewoon door: relaties krijgen dan naam en soort uit de financiële mutaties, zonder KvK-nummer en IBAN, en eigen IBAN’s ontbreken. De codestraat heeft dan geen KvK-nummer en IBAN van relaties en geen eigen bank-IBAN’s, dus Skills die die gegevens nodig hebben doen alleen voorstellen. Ontbreekt DDI_Profit_OpenPosten, dan werkt het inlezen en de export ook: de lijsten met openstaande debiteuren en crediteuren (werkstukken A.3 en B.2) worden dan teruggerekend uit de boekingen, en de export meldt dat met een blokkerende waarschuwing. Koppel de connector en start de export opnieuw; opnieuw inlezen is niet nodig. SamenstelFlow leest alleen; er wordt niets naar AFAS teruggeschreven.
Invoeren en administraties selecteren
Section titled “Invoeren en administraties selecteren”- Ga naar Dashboard en klik op Administratie importeren.
- Kies bij Boekhoudpakket de optie AFAS (Beta).
- Vul je Deelnemersnummer in en plak het token in het veld AFAS-token.
- Klik op Verbinden.
- Vink aan welke administraties je wilt overnemen en klik op Koppelen.
De administraties staan in de lijst met hun naam en hun administratienummer erachter. Het verdere verloop van de wizard staat in Administraties importeren.
Veelvoorkomende fouten
Section titled “Veelvoorkomende fouten”- AFAS accepteert de koppeling niet. SamenstelFlow vraagt je het deelnemersnummer en het app-connectortoken te controleren, en wijst naar AFAS Profit > App-connectoren. Controleer of het token bij dit deelnemersnummer hoort en of de app-connector nog actief is.
- Het deelnemersnummer wordt afgekeurd. Het moet uit precies vijf cijfers bestaan.
- AFAS is niet bereikbaar. Je krijgt de melding dat de verbinding mislukte en dat je het later opnieuw kunt proberen. Dat ligt niet aan jouw gegevens.
- De lijst blijft leeg. De app-connector werkt, maar geeft geen administraties terug. Controleer of DDI_Profit_Administraties aan de connector hangt.
- «Koppel DDI_Profit_Bedrijfsgegevens aan de app-connector om bedrijfsgegevens op te halen». Deze melding zie je bij Gegevens ophalen als de optionele connector niet aan de app-connector hangt. Het koppelen zelf is wel gelukt; alleen het automatisch invullen van de bedrijfsgegevens slaat SamenstelFlow over. Koppel de connector met de veld-ID’s hierboven en klik opnieuw op Gegevens ophalen.
- Relaties hebben geen KvK-nummer of IBAN, of eigen IBAN’s ontbreken. Koppel de optionele connectoren DDI_Profit_Relaties en DDI_Profit_Bankrekeningen aan de app-connector, met de veld-ID’s hierboven, en lees opnieuw in. Hiervoor verschijnt geen foutmelding: zonder de connectoren werkt alles, met minder relatiegegevens.
- De export meldt dat de app-connector DDI_Profit_OpenPosten niet vrijgeeft. De lijst met openstaande debiteuren of crediteuren (A.3 of B.2) is dan teruggerekend uit de boekingen. Vraag de AFAS-beheerder de optionele connector DDI_Profit_OpenPosten aan de app-connector te koppelen, met de veld-ID’s hierboven, en start de export opnieuw. Opnieuw inlezen is niet nodig.
- De relaties of eigen IBAN’s komen niet binnen, terwijl de connector wel gekoppeld is. Controleer of het veld
Administratiein de connector zit, en ofSoortalleenDebiteurofCrediteurbevat. Dat geldt ook voor DDI_Profit_OpenPosten.
Wat “bèta” hier betekent
Section titled “Wat “bèta” hier betekent”De AFAS-koppeling draagt in de app het label Beta. Dat betekent dat de koppeling nieuwer is en op minder verschillende AFAS-omgevingen beproefd dan die van Yuki. Het is geen uitgeklede versie: de werkstukken die AFAS ondersteunt staan gewoon in de export, inclusief de IC-matrix die alleen bij AFAS bestaat. Zie Werkstukken per pakket.
Twee dingen om te weten bij het beoordelen van de uitvoer. AFAS levert geen aangiftegegevens via deze connectoren, dus de BTW-rondrekening is opgebouwd uit de boekingen en geen formeel indieningsbewijs. En de auditfile is samengesteld uit de financiële mutaties, het is geen XAF-bestand dat AFAS zelf uitgeeft.
Wat we je in ruil vragen: kom je iets tegen dat niet klopt in de cijfers of in een werkstuk, meld het dan met de administratie, het boekjaar en het werkstuk erbij. Zie Support vragen.
Een verlopen token vervangen
Section titled “Een verlopen token vervangen”Een token voer je alleen in tijdens het importeren, en een administratie die al gekoppeld is wordt daar geweigerd. Is het app-connectortoken bij AFAS vervangen of ingetrokken, dan kun je de nieuwe waarde dus niet zelf in SamenstelFlow zetten. Neem contact op via Support vragen.
Volgende stap
Section titled “Volgende stap”Bekijk wat je per administratie kunt instellen: Administratie-instellingen.