GHX OCI-koppeling

Hierbij vind je de beschrijving van de specifieke OCI-koppeling met inkooprelatie: GHX.

GHX is een portal naar andere webshops die vaak gebruikt wordt in de Zorg. Eindgebruikers bestellen via GHX bij verschillende onderliggende webshops zonder die te zien. Facturatie en levering vindt vervolgens weer plaats vanuit de onderliggende webshops.

Afwijkend van de andere OCI-koppelingen gebruikt Profit niet GHX als inkooprelatie, maar de inkooprelatie van de onderliggende webshop.

Dit wordt in werking gesteld met behulp van het veld Afwijkende inkooprelatie toepassen.

Stappen:

Voeg GHX toe als inkooprelatie in Profit en neem contact met hen op.
Voeg in Profit de inkooprelaties toe van wie je de artikelen wilt afnemen via de GHX-webshop.
Het nummer van de crediteur/inkooprelatie die je hebt toegevoegd in Profit, gebruikt GHX in de terugkoppeling.
Voeg voor GHX het OCI-profiel toe. Vink in het profiel Afwijkende inkooprelatie toepassen aan.
Vervolgens kun je bestellen.

Inhoud

Type koppeling

Type koppeling:

Inkoopaanvraag alles aanpasbaar.

Het overgenomen winkelmandje vanuit GHX is in InSite aanpasbaar.


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

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 deze leverancier gelden bij de inrichting van het OCI-profiel de volgende aandachtspunten:

Veld	Instelling	Toelichting
URL OCI-koppeling	Niet wijzigbaar	URL van de webshop
Test URL beschikbaar	Nee	Niet beschikbaar
Gebruikersnaam OCI-koppeling	Verplicht	Gebruikersnaam van het OCI-account
Wachtwoord OCI-koppeling	Verplicht	Wachtwoord van het OCI-account
Gebruikersnaam Export-URL	Nvt
Wachtwoord Export-URL	Nvt
Debiteurnummer leverancier	Verplicht	Klantnummer inkooprelatie.
Voorkeur artikelgroep	Verplicht	Vanuit de webshop stuurt de leverancier artikelgroepen mee. Alle producten die worden besteld via de OCI-koppeling worden gekoppeld aan de ingestelde artikelgroep.

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	Vendorformat	Itemcode van de leverancier
NEW_ITEM-DESCRIPTION	Description	Omschrijving van het product
NEW_ITEM-QUANTITY	Quantity	Aantal besteld
NEW_ITEM-UNIT	Unit	Eenheid
NEW_ITEM-PRICE	Price	Prijs
NEW_ITEM-CURRENCY	Currency	Valuta
NEW_ITEM-MATGROUP	Artikelgroep	Artikelgroep
NEW_ITEM-LEADTIME	Aantal dagen levertijd	Aantal dagen levertijd
NEW_ITEM-CUST_FIELD1	CUST_FIELD1	Btw-percentage
NEW_ITEM-CUST_FIELD2	CUST_FIELD2	Gewenste leverdatum
NEW_ITEM-CUST_FIELD3	CUST_FIELD3	Referentie inkooprelatie
NEW_ITEM-LONGTEXT_132	Opmerking	Opmerking

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.	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-VENDORFORMAT
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
Btw-tariefgroep	V	Profit bepaalt dit op basis van btw-percentage en Land wetgeving.	NEW_ITEM-CUST_FIELD1
Artikelgroep	V	Er wordt een artikelgroep meegestuurd	NEW_ITEM-CUST_FIELD2

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
Gewenste leverdatum	O	Gewenste leverdatum komt uit de webshop mee en wordt overgenomen	NEW_ITEM-CUST_FIELD2	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.

Velden in de XML-inkooporder

Profit levert orders via XML bij de webshop 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	Het klantnummer wat bekend is bij de leverancier.	OCI-profiel in AFAS
	To - Credential
		Identity	Naam van de inkooprelatie	Naam van de inkooprelatie.
	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	Afkomstig uit de orderkop in AFAS
		orderDate	Besteldatum	Afkomstig uit de orderkop in AFAS
	OrderRequestHeader - Total
		Money	Totale waarde van inkooporder + valuta code. De valuta code zal altijd EUR zijn	Afkomstig uit de orderkop in AFAS
	OrderRequestHeader - ShipTo
	\ShipTo - Address
		Address	Het ID en landcode van het afleveradres	Ingestelde afleveradres in AFAS. Indien niet gekozen zal er volgens een schema een afleveradres worden bepaald. Zie ''Afleveradres bepalen'' onderaan het artikel.
		Name	Omschrijving van het afleveradres	Ingestelde afleveradres in AFAS.
	\Address - PostalAddress
		DeliverTo	Naam van afleveradres	Ingestelde afleveradres in AFAS.
		Street
		City
		PostalCode
		Country
	\Address - Email
		Email
	\Address - Phone
	\Phone - TelephoneNumber
		CountryCode	Telefoonnummer	Landcode die is gekoppeld aan het ingestelde afleveradres
		AreaOrCityCode	N/A
		Number	Telefoonnummer van het afleveradres	Ingestelde afleveradres in AFAS.

	OrderRequestHeader - BillTo
	\Billto - Address
		Address	Het ID en landcode van het afleveradres	Ingestelde afleveradres in AFAS. Indien niet gekozen zal er volgens een schema een factuuradres worden bepaald. Zie ''Afleveradres bepalen'' onderaan het artikel.
		Name	Omschrijving van het afleveradres	Ingestelde factuuradres in AFAS.
	\Address - PostalAddress
		DeliverTo	Naam van afleveradres	Ingestelde afleveradres in AFAS.
		Street	Straatnaam
		City	Stad
		PostalCode	Postcode
		Country	Land
	\Address - Email
		Email
	\Address - Phone
	\Phone - TelephoneNumber
		CountryCode	Telefoonnummer	Landcode die is gekoppeld aan het ingestelde afleveradres
		AreaOrCityCode	N/A
		Number	Telefoonnummer van het afleveradres	Ingestelde afleveradres in AFAS.
	\OrderRequestHeader - Costcentre	costcentre	Kostenplaats
	\OrderRequestHeader - SupplierOrderInfo OrderID	Referentie	Referentie	Referentie inkooprelatie. Kop van de inkooporder.
	\OrderRequestHeader -\Projectnummer	Projectnummer	Nummer van gekoppelde project	Projectnummer
	\OrderRequestHeader -Projectfase	Projectfase	Fase van het gekoppelde project	Projectfase
	\OrderRequestHeader -Contract	Contractnummer	Nummer van gekoppelde contract	Contract
ItemOut
		Quantity	Aantal	Aantal artikelen in inkooporderregel
		lineNumber	regelnummer, volgnummer	Volgnummer van de inkooporderregel
		requestedDeliveryDate	Gewenste leverdatum	Opgegeven gewenste leverdatum van het artikel
	\ItemID
		SupplierPartID	Itemcode inkooprelatie	Itemcode van de inkooprelatie in de eigenschappen van het artikel
	\ItemDetail
	\ItemDetail - UnitPrice
		Money	Prijs per eenheid	Prijs per eenheid van artikel in de inkooporderregel
	\ItemDetail - Description	Description	Omschrijving	Omschrijving van het artikel in de inkooporderregel
	\ItemDetail - UnitofMeasure	UnitOfMeasure	Eenheid	Eenheid
	\ItemDetail - Opmerking	Opmerking	Opmerking	Opmerking
	\ItemDetail - Projectnummer	Projectnummer	Nummer van gekoppelde project	Projectnummer
	\ItemDetail - Projectfase	Projectfase	Fase van het gekoppelde project	Projectfase
	\ItemDetail - VerbijzonderingscodeAs1	VerbijzonderingscodeAs1	Code van verbijzonderingsas 1	Ingestelde verbijzonderingsas bij inkooporderregel
	\ItemDetail - VerbijzonderingscodeAs2	VerbijzonderingscodeAs2	Code van verbijzonderingsas 2	Ingestelde verbijzonderingsas bij inkooporderregel
	\ItemDetail - VerbijzonderingscodeAs3	VerbijzonderingscodeAs3	Code van verbijzonderingsas 3	Ingestelde verbijzonderingsas bij inkooporderregel
	\ItemDetail - VerbijzonderingscodeAs4	VerbijzonderingscodeAs4	Code van verbijzonderingsas 4	Ingestelde verbijzonderingsas bij inkooporderregel
	\ItemDetail - VerbijzonderingscodeAs5	VerbijzonderingscodeAs5	Code van verbijzonderingsas 5	Ingestelde verbijzonderingsas bij inkooporderregel

Voorbeeld XML-bestand

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

Direct naar

OCI-koppelingen