Naar de AFAS KnowledgeBase Terug naar de zoekresultaten

Andere artikelen

Vervolgactie: Incident insturen:

Heeft dit jouw vraag beantwoord?

Bedankt voor jouw feedback!

Ja Nee
Inkoopaanvraag via eigen OCI-koppeling inrichten (Profit-definitie) PROFIT 9

Inkoopaanvraag via eigen OCI-koppeling inrichten (Profit-definitie)

AFAS levert standaard OCI-koppelingen uit met verschillende leveranciers. Het activeren van zo'n koppeling is een kwestie van je gebruikersnaam en wachtwoord invullen en je kunt gaan bestellen.

Staat jouw leverancier niet in de lijst met standaardkoppelingen? Dan kun je je leverancier vragen om een koppeling met InSite te maken.

Profit kent een standaard OCI-definitie (de Profit-definitie) die bedoeld is voor koppelingen die niet door AFAS onderhouden worden.

Een OCI-koppeling ontwikkelen op basis van de standaard Profit OCI-definitie bestaat uit drie stappen:

  1. De gebruiker vanuit InSite automatisch aanmelden in de webshop van de leverancier
  2. De gebruiker terugsturen naar InSite met daarbij de details van het winkelmandje
  3. De definitieve inkooporder exporteren naar de leverancier via een XML-bestand

Hieronder leggen we per stap uit hoe je dit kunt ontwikkelen.

New_Beschikbaar vanaf Profit Update

 

In dit artikel is nieuwe gave functionaliteit verwerkt die beschikbaar is vanaf Profit 10.

Raadpleeg een voorbeeld van het cXML-bestand hier.

Zie ook:

Inhoud

1. De gebruiker vanuit InSite automatisch aanmelden in de webshop van de leverancier

Vanuit InSite kan een gebruiker automatisch aangemeld worden in de webshop van de leverancier. Hiervoor leg je in het OCI-profiel vast wat de aanmeld-URL van de leverancier is en welke gebruikersnaam en wachtwoord daarbij gebruikt moeten worden.

De aanmeld-URL leg je vast in de velden Productie-URL en Test-URL in de eigenschappen van het OCI-profiel.

Een voorbeeld van een aanmeld-URL is als volgt:

https://www.leverancier.demo/webshop/login?USERNAME={gebruikersnaam}&PASSWORD={wachtwoord}

De aanmeld-URL kent twee parameters die automatisch door Profit gevuld worden:

  • {gebruikersnaam}: De gebruikersnaam die in het OCI-profiel ingericht is.
  • {wachtwoord}: Het wachtwoord dat in het OCI-profiel ingericht is.

    Het is mogelijk om in het Profit OCI-profiel het debiteurnummer als variabele in de URL mee te geven als hier door de leverancier om wordt gevraagd. Deze waarde wordt uit het profiel opgehaald op het tabblad 'Voorkeurwaarden' bij het veld 'Nr. debiteur (leverancier)'.

Zodra de gebruiker naar de webshop van de leverancier gestuurd wordt, wordt automatisch de parameter HOOK_URL toegevoegd aan de URL. Dit is de URL van InSite waarnaar de gebruiker teruggestuurd moet worden in stap 2. De definitieve URL waarmee de gebruiker aankomt bij de webshop van de leverancier kan er dus als volgt uitzien:

https://www.leverancier.demo/webshop/login?USERNAME=gebruikersnaam&PASSWORD=wachtwoord&HOOK_URL=https://insite.afas.online/postdatacallback/demo2c0b7045b14412e43b2a70f1c1a69Fst

De webshop van de leverancier kan vervolgens de gebruikersnaam en het wachtwoord valideren en daarmee de gebruiker automatisch aanmelden.

2. De gebruiker terugsturen naar InSite met daarbij de details van het winkelmandje

Nadat de gebruiker het winkelmandje gevuld heeft is het zaak om de details van het winkelmandje terug te sturen naar InSite. Daar wordt een inkoopaanvraag gemaakt die goedgekeurd kan worden door een budgethouder of leidinggevende. Dit gebeurt door de gebruiker via een HTTPS POST naar de hook_url uit stap 1 terug te sturen.

Die HTTPS POST wordt vergezeld van een gegevensverzameling van productspecificaties. Bij terugkomst in InSite vindt aan de hand van de token in de hook_url een validatie plaats ten behoeve van veiligheid en integriteit.

De volgende velden worden per product ondersteund bij de gegevensverzameling van productspecificaties:

- NEW_ITEM-VENDORMAT: artikelcode van de leverancier

- NEW_ITEM-DESCRIPTION: omschrijving

- NEW_ITEM-MATGROUP: productgroep van de leverancier

- NEW_ITEM-QUANTITY: aantal eenheden

- NEW_ITEM-UNIT: eenheidscode

- NEW_ITEM-PRICE: prijs per eenheid

- NEW_ITEM-CUST_FIELD1: btw-percentage

Een eenvoudige manier om via HTML het HTTPS POST-verzoek te initiëren is via onderstaande code:

<form method="post" action="https://insite.afas.online/postdatacallback/demo2c0b7045b14412e43b2a70f1c1a69Fst">

<input type="hidden" name="NEW_ITEM-VENDORMAT[1]" value="oci603524" />

<input type="hidden" name="NEW_ITEM-DESCRIPTION[1]" value="OCI punch out import item oci603524" />

<input type="hidden" name="NEW_ITEM-MATGROUP[1]" value="MATGROUP187" />

<input type="hidden" name="NEW_ITEM-QUANTITY[1]" value="614" />

<input type="hidden" name="NEW_ITEM-UNIT[1]" value="PCS" />

<input type="hidden" name="NEW_ITEM-PRICE[1]" value="178.59" />

<input type="hidden" name="NEW_ITEM-CUST_FIELD1[1]" value="21.0" />

<input type="submit" value="Bestellen in ERP-systeem" />

</form>

3. De definitieve inkooporder exporteren naar de leverancier via een XML-bestand

Nadat de inkoopaanvraag via de workflow in InSite goedgekeurd is, kunnen we de gegenereerde inkooporder via een XML-bestand in een HTTPS POST exporteren naar de leverancier. Op die manier kan de bevestigde order automatisch in de backoffice van de leverancier ingelezen worden.

De export-URL leg je vast in het veld Export-URL op de eigenschappen van het OCI-profiel.

Let op:

Alle communicatie naar onbekende URL's standaard wordt geblokkeerd op AFAS Online. Stuur daarom een supportincident in om je export-URL op onze whitelist te laten plaatsen.

Het XML-bestand dat verstuurd wordt is opgemaakt conform de cXML-standaard.

Direct naar

  1. Inkooporders via OCI-koppeling inrichten
  2. Inkooporder via website inkooprelatie (OCI) via mail/pdf inrichten
  3. Inkooporder via website inkooprelatie (OCI) met XML inrichten
  4. Inkooporder via website per specifieke OCI-koppeling van inkooprelatie inrichten
  5. Inkooporder via website via Profit-OCI-koppeling inrichten