OCI koppeling AFAS

Een AFAS OCI koppeling bestaat uit drie delen

AFAS beschrijft een OCI-koppeling als drie onderdelen: de instellingen, de mapping van het winkelmandje (PunchOut) en de mapping van de digitale order (cXML Order). Het winkelmandje komt binnen via OCI, de order gaat uit via cXML. Een leverancier die van een AFAS-klant de vraag om een OCI koppeling krijgt, bouwt dus twee protocollen.

Elk van de drie onderdelen heeft bij AFAS een eigen versienummer. Wijzigt er één, dan verhoogt Profit het versienummer van de definitie. De koppeling werkt alleen met InSite: de inkoper start vanuit het inkoopportaal en komt daar terug met zijn winkelmand.

Dit is de AFAS-uitwerking van de stroom die op OCI en PunchOut in het algemeen staat. De techniek van de sessie zelf staat in wat is een OCI koppeling. De gewone gegevensstromen met AFAS, zoals artikelen, voorraad en verkooporders via de connectoren van Profit, staan op AFAS webshop koppeling.

Wat AFAS van je vraagt voor het winkelmandje

Voor de eerste stap vraagt AFAS drie dingen van de leverancier: de URL van het winkelmandje, een gebruikersnaam en wachtwoord, en eventueel een klantnummer. De beheerder van je klant zet ze in het OCI-profiel. Het inlogadres is een URL met vaste plekken die Profit bij elke sessie invult:

https://webshop.example.nl/oci/login?USERNAME={gebruikersnaam}&PASSWORD={wachtwoord}
  &CUSTOMER={debiteurnummer}&CART={uniqueid}
  &NAME={aanvrager_naam}&EMAIL={aanvrager_e-mail}

De namen voor het isgelijkteken kies je zelf; de waarden tussen accolades zijn van AFAS. InSite plakt er HOOK_URL achter: het adres waar de winkelmand naartoe moet, in het voorbeeld van AFAS een adres op insite.afas.online met een token erin. {uniqueid} is bij elke aanroep een nieuwe GUID, zodat twee inkopers die met dezelfde gebruikersnaam binnenkomen elk een eigen winkelmand krijgen. De gebruikersnaam en het wachtwoord staan in de URL. Gebruik daarom een apart OCI-account dat niets anders kan dan deze sessie starten.

De winkelmand gaat terug als HTTPS POST naar HOOK_URL. Bij terugkomst controleert InSite het token. De Profit-definitie leest per regel deze velden:

Uit die velden maakt Profit vier dingen aan: het artikel met eenheid en prijs, de artikelgroep, de inkoopaanvraag en later de inkooporder. Een artikel dat Profit nog niet kent, wordt aangemaakt. De artikelgroep bepaalt bij je klant op welke grootboekrekening de inkoop wordt geboekt. Een productgroep die niet gekoppeld is, valt in de voorkeursartikelgroep van het profiel.

Wat AFAS van je vraagt voor de order

Voor de tweede stap vraagt AFAS vier dingen: de URL van je backoffice, een gebruikersnaam en wachtwoord, het klantnummer met het afleveradres, en een shared secret als je die gebruikt. Na goedkeuring van de inkoopaanvraag maakt Profit een cXML-order en stuurt die naar de Export-URL in het OCI-profiel. Dat adres mag HTTP of HTTPS zijn, en ook FTPS of SFTP.

Zo ziet de order voor de eerste regel van de winkelmand eruit, ingekort:

<OrderRequestHeader orderID="01885" orderDate="2026-10-02 00:00:00" type="new">
  <Total><Money currency="EUR">521.71</Money></Total>
  <ShipTo><Address isoCountryCode="NL" addressID="1280">...</Address></ShipTo>
  <SupplierOrderInfo orderID="WM-004417" />
</OrderRequestHeader>
<ItemOut quantity="12" lineNumber="1" requestedDeliveryDate="2026-10-06">
  <ItemID><SupplierPartID>10482</SupplierPartID></ItemID>
  <ItemDetail>
    <UnitPrice><Money currency="EUR">17.08</Money></UnitPrice>
    <Description xml:lang="en_US">Wandcontactdoos 2-voudig met randaarde,</Description>
    <UnitOfMeasure>PCE</UnitOfMeasure>
  </ItemDetail>
</ItemOut>

Drie waarden verbinden de order met wat er eerder gebeurde. orderID is het inkoopordernummer van je klant; dat nummer wil hij terugzien op je factuur. SupplierPartID is het artikelnummer dat jij in NEW_ITEM-VENDORMAT meegaf. SupplierOrderInfo bevat de referentie die jij in NEW_ITEM-CUST_FIELD3 aan de winkelmand hing, hier WM-004417.

De shared secret is een extra wachtwoord van maximaal 255 tekens. Profit zet hem in het Sender-deel van de kop van het bericht. Bij de Profit-definitie is hij optioneel.

Twee dingen houden de eerste order tegen. Profit blokkeert standaard alle verkeer naar onbekende adressen: je klant dient een supportincident in bij AFAS om jouw Export-URL met poortnummer op de allowlist te laten zetten. En het communicatieprofiel Digitale inkooporders moet door de beheerder zijn gedeblokkeerd.

Welk systeem is leidend, per gegeven

Drie typen koppeling

Het type bepaalt wat de inkoper na terugkeer in InSite nog aan de inkoopaanvraag mag wijzigen.

Bij de laatste twee typen slaat de leverancier het winkelmandje zelf op. De webshop heeft dan opgeslagen winkelmanden nodig en een eigen nummering voor concepten, en de koppeling zoekt bij elke binnenkomende order de winkelmand met dat nummer erbij. Wijkt de order af van de bewaarde winkelmand, bijvoorbeeld 10 stuks in plaats van 12, dan is dat een verschil dat iemand moet zien. De koppeling verwerkt die order niet stil: het verschil staat in het dashboard en de order wacht op jouw goedkeuring.

De Profit-definitie of een gecertificeerde koppeling

AFAS heeft twee soorten definities. De Profit-definitie is de algemene: een leverancier die zich aan dat formaat houdt, heeft geen eigen definitie nodig. Daarnaast onderhoudt AFAS definities per leverancier. Op 3 oktober 2026 staan er 68 leveranciers op die lijst, waaronder ARP, Manutan en Technische Unie. AFAS schrijft erbij dat dit allemaal leveranciers zijn bij wie de mapping van het winkelmandje of de order afwijkt.

Voor een webshop die nog geen OCI heeft, is de Profit-definitie de route: de velden uit de tabel hierboven en de standaardopbouw van de cXML-order. Bij de Profit-definitie vult de klant de Productie-URL, de Test-URL en de Export-URL zelf in; bij een leveranciersdefinitie staan die vast. Alleen de Profit-definitie heeft de vrije velden NEW_ITEM-CUST_FIELD16 tot en met 20. De klant koppelt ze in zijn OCI-profiel aan eigen vrije velden van het type tekst of memo, en ze komen in de order terug als Cust_Field16 tot Cust_Field20. Leveranciers met vragen over een nieuwe koppeling verwijst AFAS naar oci@afas.nl.

Waar het op vastloopt

Het laatste punt volgt uit hoe Profit verzendt. Krijgt Profit geen foutmelding terug, dan staat het bericht als succesvol verzonden in het communicatielog en ligt de fout volgens AFAS bij de ontvanger. Een adres dat 200 OK antwoordt en de order daarna kwijtraakt omdat het ERP niet bereikbaar was, heeft een order gemist die volgens je klant geplaatst is. De koppeling bewaart daarom elke order zodra hij binnenkomt en zet hem in een wachtrij; lukt het aanmaken in je ERP niet, dan volgt een nieuwe poging en blijft de order zichtbaar in het dashboard.

Testen loopt via de beheerder van je klant. Een openbare testomgeving is er niet: in het OCI-profiel staan de velden Test-URL en Export-Test-URL, en zolang die zijn aangevinkt gaan de sessie en de order naar jouw testadressen. Welke assen van de kostenverdeling in de order meekomen, verschilt per definitie: de Profit-definitie stuurt de verbijzonderingscodes van as 1 tot en met 5 mee, en AFAS documenteert een leveranciersdefinitie waarbij alleen as 1 meegaat.

Verstuurt je klant ook facturen en verzendberichten elektronisch, dan loopt dat buiten deze koppeling. Zie AFAS EDI koppeling en OCI of cXML. Wat je webshop zelf moet kunnen voor de sessie, staat per platform op OCI koppeling webshop.

Vertel op welk platform je webshop draait en welke klant om de koppeling vraagt, dan hoor je wat er voor de Profit-definitie nodig is.