TotaalVERS OCI-koppeling

In de koppeling met TotaalVERS worden de volgende onderdelen uitgewisseld:

OCI-koppeling (Profit neemt het winkelmandje van de webshop over naar InSite).
XML-order (Profit verstuurt de inkooporder in XML-formaat naar de leverancier

Overal waar hierna 'leverancier' staat, kun je TotaalVERS lezen.

Inhoud

Type koppeling

Type koppeling:

Inkoopaanvraag, koppeling niet aanpasbaar

Het overgenomen winkelmandje vanuit TotaalVERS is in InSite aanpasbaar. (De Profit-gebruiker kan het uit de webshop van TotaalVERS aanpassen in InSite). Raadpleeg de tabel om te zien welke wijzigingen mogelijk zijn.


Wijzigingen in inkoopaanvraag vanuit overgenomen winkelmandje mogelijk?
Regels wijzigbaar qua aantallen:	nee
Regels verwijderbaar:	nee
Regels toe te voegen in de aanvraag in InSite:	nee

Inrichting OCI-profiel

Let op:

Neem altijd contact op met de leverancier om de OCI-koppeling tot stand te brengen. Het kan zijn dat de leverancier in zijn systeem nog aanpassingen moet doen om de OCI-koppeling met jouw organisatie goed te laten werken.

Ook als je al een gebruikersnaam/wachtwoord hebt voor het bestellen via de huidige webshop moet je contact opnemen met de leverancier om te checken of alle instellingen goed staan.

Om de koppeling in gebruik te nemen moet je minimaal één OCI-profiel inrichten. Klik hier voor de algemene inrichting van OCI-profielen.

Voor TotaalVERS gelden bij de inrichting van het OCI-profiel de volgende aandachtspunten:

Veld	Instelling	Toelichting
URL OCI-koppeling	Niet wijzigbaar	Standaard URL.
Test URL beschikbaar	Nee	-
Gebruikersnaam OCI-koppeling	Verplicht	Op te vragen bij leverancier
Wachtwoord OCI-koppeling	Verplicht	Op te vragen bij leverancier
URL Export (XML-order)	Https	Https, niet aanpasbaar
Gebruikersnaam OCI-koppeling	Niet wijzigbaar	-
Wachtwoord OCI-koppeling	Niet wijzigbaar	-
Voorkeur artikelgroep	Verplicht	Vanuit de webshop stuurt de leverancier artikelgroepen mee. Deze kun je in het OCI-profiel koppelen aan de artikelgroepen in Profit. Er is altijd één voorkeur artikelgroep nodig, voor het geval er artikelgroepen vanuit de leverancier komen die niet gekoppeld zijn in Profit.

Zie ook:

Inrichten OCI-profiel met XML

Webshop Punchout

Na het vullen van de winkelwagen zal de leverancier via een HTTPS POST een bericht terug sturen naar InSite. De volgende velden worden meegestuurd:


OCI-Field		Omschrijving		Profit veld
NEW_ITEM-VENDORMAT	Vendormat – Itemcode van leverancier		Itemcode leverancier
NEW_ITEM-DESCRIPTION	Description - Omschrijving van product		Omschrijving
NEW_ITEM-QUANTITY	Quantity – Aantal van item		Aantal
NEW_ITEM-UNIT	Unit – Eenheid van item		Eenheid
NEW_ITEM-PRICE	Price – Prijs van item		Prijs
NEW_ITEM-MANUFACTMAT	MANUFACTMAT - Artikelnummer van de fabrikant van het item		-
NEW_ITEM-EXT_PRODUCT_ID	Ext_product_id – Unieke ID voor item in de catalogus van leverancier		-
NEW_ITEM-CURRENCY	Currency – Valuta van item		Valuta
NEW_ITEM-CUST_FIELD1	Cust_Field1 – Vrij veld, wordt bepaald door de gebruiker		BTW percentage
NEW_ITEM-CUST_FIELD2	Cust_Field2 – Vrij veld, wordt bepaald door de gebruiker		Opmerking . Type product vanuit TotaalVERS. Bepalend in wat in de opmerking komt te staan.
NEW_ITEM-CUST_FIELD3	Cust_Field3 – Vrij veld, wordt bepaald door de gebruiker		Gewenste leverdatum
NEW_ITEM-CUST_FIELD4	Cust_Field4 – Vrij veld, wordt bepaald door de gebruiker		-
NEW_ITEM-CUST_FIELD5	Cust_Field5 – Vrij veld, wordt bepaald door de gebruiker		Referentie inkooprelatie
NEW_ITEM-CUST_FIELD6	Cust_Field6 – Vrij veld, wordt bepaald door de gebruiker		Opmerking. Gewicht vanuit TotaalVERS.
NEW_ITEM-CUST_FIELD7	Cust_Field7 – Vrij veld, wordt bepaald door de gebruiker		-
NEW_ITEM-CUST_FIELD8	Cust_Field8 – Vrij veld, wordt bepaald door de gebruiker		Artikelgroep
NEW_ITEM-CUST_FIELD9	Cust_Field9 – Vrij veld, wordt bepaald door de gebruiker		Opmerking
NEW_ITEM-CUST_FIELD10	Cust_Field10 – Vrij veld, wordt bepaald door de gebruiker		Opmerking. Consumptiedatum van bestelde item

Artikel aanmaken

Profit voegt de artikelen die je besteld hebt in de webshop van de leverancier automatisch in Profit toe en doet dat o.a. als volgt:

Profit-veld	Verplicht/ Optioneel	Toelichting op hoe Profit de waarde voor het artikel bepaalt	XML-veld vanuit leverancier
Itemcode	V	Profit bepaalt de itemcode via Autonummering.	nvt
Omschrijving	V	Neemt Profit over van de webshop van de leverancier.	NEW_ITEM-Description
Eenheid	V	Als er maar één eenheid meekomt uit de webshop, neemt Profit die als eenheid.	NEW_ITEM-Unit
Inkooprelatie	V	Profit neemt de inkooprelatie uit het OCI-profiel over.	nvt
Itemcode inkooprelatie	V	Profit controleert dit veld om te zien of het artikel uit de webshop al in Profit voorkomt. Raadpleeg dit in het artikel.	NEW_ITEM-VendorMat
Omschrijving itemcode inkooprelatie	V	Profit neemt de omschrijving van het artikel uit de webshop over. De omschrijving van het artikel en Omschrijving itemcode inkooprelatie zijn dus hetzelfde.	NEW_ITEM-Description
Besteleenheid inkooprelatie	V	Dit neemt Profit over uit het Profit-veld ‘Eenheid’. Zie hierboven.	NEW_ITEM-Unit
Prijs per eenheid	V	Vanuit de webshop komt de actuele prijs mee die Profit vervolgens als inkoopprijs bij het artikel opslaat.	NEW_ITEM-Price
Land wetgeving	V	Profit bepaalt dit aan de hand van het Land wetgeving uit de administratie in de factureringsinstellingen.	nvt
Btw-tariefgroep	V	Profit bepaalt dit op basis van btw-percentage en Land wetgeving.	NEW_ITEM-Cust_Field1
Artikelgroep	nvt	TotaalVERS stuurt de artikelgroepen mee. Op basis van de inrichting van de artikelgroepen in het OCI-profiel bepaalt Profit vervolgens de artikelgroep.	NEW_ITEM-CUST_Field8

Artikelgroepen

Selecteer bij inrichting van het OCI-profiel bij het veld Voorkeur artikelgroep de artikelgroep waar Profit de artikelen die je via de webshop bestelt, aan moet koppelen. De artikelgroep bepaalt de grootboekrekeningen voor de financiële sturing.

Dit geldt qua artikelgroepen voor deze OCI-koppeling:

Vanuit de webshop worden de artikelgroepen meegestuurd. Als je niet wilt dat alle bestelde artikelen in de voorkeur artikelgroep terechtkomen, maak je een koppeling tussen de productgroepen van de inkooprelatie en je eigen artikelgroepen. Op deze manier bepaal je per artikelgroep in welke andere artikelgroepen de artikelen van de webshop terechtkomen en op welke rekening de kosten (rekening inkoop) geboekt worden.

Zie ook:

Artikelgroepen koppelen qua moment

Inkoopaanvraagregel aanmaken

Vanuit de webshop krijg je de gegevens van de leverancier en Profit maakt de bestelling als inkoopaanvraag in InSite aan. De artikelen die besteld zijn vormen de regels in de inkoopaanvraag. Op de inkoopaanvraagregel worden velden vastgelegd. In onderstaande tabel staan de velden met de belangrijkste aandachtspunten vanuit de koppeling met deze leverancier.

Veld	Verplicht/ optioneel	Toelichting	Veld vanuit leverancier	Vanaf welk niveau
Itemcode	V	Code van het aangemaakte artikel.		Vanuit artikel
Eenheid	V	Besteleenheid	NEW_ITEM-Unit	Vanuit artikel
Omschrijving	V	Standaard artikelomschrijving	NEW_ITEM-Description	Vanuit artikel
Aantal	V	Aantal van de bestelde eenheid	NEW_ITEM-Quantity	Vanuit bestelling
Besteleenheid inkooprelatie	V	Wordt overgenomen vanuit de eenheid.	NEW_ITEM-Unit	Vanuit artikel
Prijs per eenheid	V	Vanuit de webshop komt de actuele prijs mee die als inkoopprijs in de regel wordt toegevoegd.	NEW_ITEM-Price	Vanuit bestelling
Opmerking	O	In het Opmerkingen-veld wordt de toelichting van het artikel getoond.	Combinatie van Custom fields.	Vanuit bestelling

De kolom ‘Veld vanuit leverancier’ is toegevoegd ten behoeve van technische ondersteuning. De leveranciers sturen de waarde van een specifiek veld mee op dit veld.

Klik hier voor een algemeen voorbeeld van een inkoopaanvraag in InSite.

XML-order - Velden in de XML-inkooporder

Profit levert orders via XML bij VWR aan. De velden in de XML-inkooporder worden op de onderstaande manier gevuld.
Velden:


Head element	Subelement(s)		Field		Toelichting		Bron
Header
		From - Credential
				Identity		Debiteurnummer van de klant bij de leverancier. Verplicht bij de koppeling bij TotaalVERS. Zorg dat deze goed is ingevuld met de waarde die bekend is bij TotaalVERS		OCI-profiel in AFAS
		To - Credential
				Identity		Naam van de inkooprelatie		Naam van de inkooprelatie die is vastgelegd in Profit
		Sender - Credential
				Identity		Provider die de inkooporder verstuurd. Dit zal altijd AFAS zijn.		Vaste waarde in het cXML bestand

		Sender - UserAgent
				UserAgent		Omgeving waar de order vandaan komt.
Request
		OrderRequest - OrderRequestHeader
				orderID		Ordernummer van de verstuurde order		Kop van inkooporder
				orderDate		Besteldatum		Kop van inkooporder
				requestedDeliveryDate		Gewenste leverdatum		Kop van inkooporder
		OrderRequestHeader - Total
				Money		Totale waarde van inkooporder + valuta code. De valuta code zal altijd EUR zijn		Kop van inkooporder
		OrderRequestHeader - ShipTo
		\ShipTo - Address
				Address		Het ID en landcode van het afleveradres		Ingestelde afleveradres in AFAS. Hier kan gebruikt gemaakt worden van de koppeling op tabblad ''Afleveradres leverancier''
				Name		Omschrijving van het afleveradres		Ingestelde afleveradres in AFAS.
		\Address - PostalAddress
				DeliverTo		Naam van afleveradres		Ingestelde afleveradres in AFAS.
				Street		straatnaam van afleveradres		Ingestelde afleveradres in AFAS.
				City		Plaats van afleveradres		Ingestelde afleveradres in AFAS.
				PostalCode		Postcode van afleveradres		Ingestelde afleveradres in AFAS.
				Country		Land waar afleveradres zich in bevind		Ingestelde afleveradres in AFAS.
		\Address - Email
				Email
		\Address - Phone
		\Phone - TelephoneNumber
				CountryCode		Telefoonnumer		Ingestelde afleveradres in AFAS.
				AreaOrCityCode		N/A
				Number		Telefoonnumer van het afleveradres		Ingestelde afleveradres in AFAS.
		IdReference		IdReference		Referentie inkooprelatie		Kop van inkooporder

ItemOut
				Quantity		Aantal		Inkooporderregel
				lineNumber		regelnummer, volgnummer		Inkooporderregel
				requestedDeliveryDate		Gewenste leverdatum		Inkooporderregel
		\ItemID
				SupplierPartID		Itemcode inkooprelatie		Inkooporderregel
		\ItemDetail
		\ItemDetail - UnitPrice
				Money		Prijs per eenheid		Inkooporderregel
		\ItemDetail - Description		Description		Omschrijving		Inkooporderregel
		\ItemDetail - UnitofMeasure		UnitofMeasure		Eenheid		Inkooporderregel
		\ItemDetail - Comments		Comments		OCI veld 09		Inkooporderregel
		\ItemDetail - Classification		Classification		OCI veld 06		Inkooporderregel
		\ItemDeatil - Consumptiondate		Consumptiondate		OCI veld 10		Inkooporderregel

XML-order

Bij deze OCI-koppeling kunnen inkooporders via XML aangeleverd worden.

Voorbeeld XML-bestand

Raadpleeg hier een voorbeeldbestand van de cXML-inkooporder voor de OCI-koppeling met TotaalVERS.

Direct naar

OCI-koppelingen