VWR OCI-koppeling
In de koppeling met VWR 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 VWR lezen.
Inhoud |
Type koppeling
Type koppeling: |
Inkoopaanvraag, koppeling niet aanpasbaar |
Het overgenomen winkelmandje vanuit VWR is in InSite aanpasbaar. (De Profit-gebruiker kan het uit de webshop van VWR aanpassen in InSite). Raadpleeg de tabel om te zien welke wijzigingen mogelijk zijn.
Wijzigingen in inkoopaanvraag vanuit overgenomen winkelmandje mogelijk? |
|
Regels wijzigbaar qua aantallen: |
ja |
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 VWR gelden bij de inrichting van het OCI-profiel de volgende aandachtspunten:
Veld |
Instelling |
Toelichting |
URL OCI-koppeling |
Niet wijzigbaar |
Niet aanpasbaar. Ingesteld in OCI-definitie. |
Test URL beschikbaar |
Ja |
Niet aanpasbaar. Ingesteld in OCI-definitie. |
Gebruikersnaam OCI-koppeling |
Verplicht |
Op te vragen bij leverancier |
Wachtwoord OCI-koppeling |
Verplicht |
Op te vragen bij leverancier |
URL Export (XML-order) |
FTPs |
Niet aanpasbaar. Ingesteld in OCI-definitie. |
Gebruikersnaam OCI-koppeling |
Verplicht |
Niet aanpasbaar. Ingesteld in OCI-definitie. |
Wachtwoord OCI-koppeling |
Verplicht |
Niet aanpasbaar. Ingesteld in OCI-definitie. |
Debiteurnummer leverancier |
Verplicht (bij uitgaande orders) |
Onderdeel van de From credential in de header van de inkooporder (cXML) |
Voorkeur artikelgroep |
Verplicht |
Vanuit de webshop stuurt de leverancier geen artikelgroepen mee. Alle producten die worden besteld via de OCI-koppeling worden gekoppeld aan de ingestelde artikelgroep. |
Zie ook:
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_ITEMATTACHMENT_PURPOSE |
Itemattachment _purpose – Doel van bijlage |
- |
|||
NEW_ITEM-DESCRIPTION |
Description - Omschrijving van product |
Omschrijving |
|||
NEW_ITEM-QUANTITY |
Quantity – Aantal van item |
Aantal besteld |
|||
NEW_ITEM-UNIT |
Unit – Eenheid van item |
Eenheid |
|||
NEW_ITEM-PRICE |
Price – Prijs van item |
Prijs |
|||
NEW_ITEM-CURRENCY |
Currency – Valuta van item |
Valuta |
|||
NEW_ITEM-LEADTIME |
Leadtime – levertijd van item in dagen |
- |
|||
NEW_ITEM-VENDORMAT |
Vendormat – Itemcode van leverancier |
Itemcode leverancier |
|||
NEW_ITEM-MANUFACTMAT |
MANUFACTMAT - Artikelnummer van de fabrikant van het item |
- |
|||
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 |
- |
Regels kunnen niet worden verwijderd. De regel moet dan op 0 gezet worden in de inkoopaanvraag.
Let op!
Er kunnen geen artikelen worden toegevoegd, alleen Aantallen kunnen worden gewijzigd (of op 0-gezet of verwijderd)
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_Field4 |
Artikelgroep |
nvt |
VWR stuurt geen artikelgroepen mee. |
NEW_ITEM-MATGROUP |
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 |
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 |
Het klantnummer wat bekend is bij de leverancier. |
OCI-profiel in AFAS |
|
|
To - Credential |
|
|
|
|
|
|
Identity |
Naam van de inkooprelatie |
Vaste waarde in de cXML |
|
|
Sender - Credential |
|
|
|
|
|
|
Identity |
Het klantnummer wat bekend is bij de leverancier. |
OCI-profiel in AFAS |
|
|
|
Shared Secret |
Het Shared secret wat is afgesproken tussen AFAS en de leverancier. |
OCI-profiel in AFAS |
|
|
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 |
|
|
|
requestedDeliveryDate |
Gewenste leverdatum |
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 |
1. Landcode van afleveradres 2.Combinatie van debiteurnummer van de klant bij VWR en Profit ID van afleveradres |
|
|
|
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 |
|
|
|
|
|
|
E-mailadres van de besteller |
Het e-mail adres en telefoon nummer in de order in de <ShipTo> tag komt uit het “Contactpersoon afleveradres” dat gekozen is. |
||
|
\Address - Phone |
|
Telefoonnummer van de besteller |
|
|
|
\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 |
1. Landcode van factuuradres 2.Combinatie van debiteurnummer van de klant bij VWR en Profit ID van factuuradres. |
|
|
|
Name |
Omschrijving van het afleveradres |
Ingestelde factuuradres in AFAS. |
|
|
\Address - PostalAddress |
|
|
|
|
|
|
DeliverTo |
Naam van afleveradres |
Ingestelde afleveradres in AFAS. |
|
|
|
Street |
Straatnaam |
Ingestelde afleveradres in AFAS. |
|
|
|
City |
Stad |
Ingestelde afleveradres in AFAS. |
|
|
|
PostalCode |
Postcode |
Ingestelde afleveradres in AFAS. |
|
|
|
Country |
Land |
Ingestelde afleveradres in AFAS. |
|
|
\Address - 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. |
|
ItemOut |
|
|
|
|
|
|
|
Quantity |
Aantal |
Aantal besteld 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 |
|
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 VWR.
Direct naar |