Technische Unie OCI-koppeling
In de koppeling met Technische Unie 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 Technische Unie lezen.
Inhoud |
Type koppeling
Type koppeling: |
Inkoopaanvraag met Concept ordernummer leverancier, koppeling aanpasbaar |
Het overgenomen winkelmandje vanuit Technische Unie is in InSite aanpasbaar. (De Profit-gebruiker kan het uit de webshop van Technische Unie aanpassen in InSite). Raadpleeg de tabel om te zien welke wijzigingen mogelijk zijn.
Het winkelmandje wordt bevestigd met het concept ordernummer leverancier dat vanuit de webshop meekomt.
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 Technische Unie 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 |
Een combinatie van je klantnummer en gebruikersnaam. Bijvoorbeeld 001/2943942. |
Wachtwoord OCI-koppeling |
Verplicht |
|
URL Export (XML-order) |
HTTPS |
Standaard URL |
Gebruikersnaam Export |
nvt |
Standaard credentials |
Wachtwoord (Export) |
nvt |
Standaard |
Debiteurnummer leverancier |
Verplicht |
Vul hier je het GLN nummer in. |
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:
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:
Let op!
Niet alle velden worden in Profit verwerkt.
OCI-Field |
Omschrijving |
Profit veld |
NEW_ITEM-EXT_PRODUCT_ID |
Ext_Product_Id |
Itemcode leverancier |
NEW_ITEM-VENDORMAT |
Vendormat |
temcode van leverancier |
NEW_ITEM-QUANTITY |
Quantity |
Aantal besteld |
NEW_ITEM-PRICE |
Price |
Prijs per eenheid |
NEW_ITEM-DESCRIPTION |
Description |
Omschrijving van product |
NEW_ITEM-UNIT |
Unit |
Eenheid |
NEW_ITEM-MATGROUP |
Matgroup |
Artikelgroep |
NEW_ITEM-CURRENCY |
Currency |
Valuta |
NEW_ITEM_CUST_FIELD3 |
Cust_Field3 |
GTIN nummer van het artikel |
NEW_ITEM_CUST_FIELD4 |
Cust_Field4 |
Percentage belasting |
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 |
Basiseenheid bij gebruik meerdere eenheden |
nvt |
Profit gebruikt dit bij Technische Unie niet. Er wordt altijd gewerkt met één eenheid per artikel. |
nvt |
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 |
Technische Unie stuurt de artikelgroepen mee. Koppel deze dan ook correct in de eigenschappen van het OCI-profiel |
NEW_ITEM-MATGROUP |
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 |
Custom field2 |
|
GTIN nummer van het product |
NEW_ITEM-Cust_Field2 |
|
Opmerking |
nvt |
In het opmerkingen-veld wordt de toelichting van het artikel getoond, deze bevat: toelichting, bijlage en kortingsgroep. |
NEW_ITEM-Longtext |
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 Technische Unie aan. De velden in de XML-inkooporder worden op de onderstaande manier gevuld.
De XML die wordt verstuurd is in de INSBOU003 opmaak.
Velden:
Head element |
Subelement(s) |
Field |
Toelichting |
Bron |
Order |
|
|
|
|
|
OrderType |
|
Vaste waarde ''220'' ingesteld. |
De waarde ''220'' staat vast in de opmaak van het bericht. |
|
OrderNumber |
|
Ordernummer van de verstuurde order. |
Afkomstig uit de orderkop in AFAS. |
|
OrderDate |
|
Datum van moment van versturen in yyyy-mm-dd notatie. |
(Huidige datum/tijd) |
|
OrderTime |
|
Datum/tijd moment van versturen in yyyy-mm-dd notatie. (Huidige datum/tijd) |
(Huidige datum/tijd) |
|
ScenarioTypeCode |
|
Vaste waarde ''X2'' ingesteld. |
De waarde ''X2'' staat hard gecodeerd in de programmatuur van dit bericht. |
|
ProjectNumber |
|
Het projectId van gekoppelde project aan de inkooporder. Als er geen project is gekoppeld wordt dit veld niet meegestuurd. |
Afkomstig uit de orderkop in AFAS. |
|
FreeText |
|
Opmerkingen |
Afkomstig uit de orderkop in AFAS. |
|
DeliveryDateTimeInformation |
|
|
|
|
|
RequiredDeliveryDate |
Leverdatum in yyyy-mm-dd notatie. |
Afkomstig uit de orderkop in AFAS. |
|
Buyer |
|
|
|
|
|
GLN |
Het GLN nummer van besteller |
Het veld Debiteurnummer leverancier in het OCI-profiel. |
|
Supplier |
|
|
|
|
|
GLN |
Het GLN nummer van de leverancier |
Het GLN nummer van Technische Unie staat vast in de opmaak van het bericht |
|
|
Name |
Naam van de leverancier |
De naam van Technische Unie staat vast in de opmaak van het bericht. |
|
|
City |
Hoofdvestiging van leverancier |
De hoofdvestiging van Technische Unie staat vast in de opmaak van het bericht. |
|
Deliveryparty |
|
|
|
|
|
Name |
Naam van het afleveradres |
|
|
|
StreetAndNumber |
Straat en huisnummer van afleveradres |
Afleveradres ingesteld in Profit |
|
|
City |
Plaatsnaam van afleveradres |
Afleveradres ingesteld in Profit |
|
|
PostalCode |
Postcode van afleveradres |
Afleveradres ingesteld in Profit |
|
|
Country |
Land van afleveradres |
Afleveradres ingesteld in Profit |
|
Deliveryparty - Contactgegevens |
|
|
|
|
|
ContactPersonName |
Naam van contactpersoon |
Ingevulde waarde van Omschrijving afleveradres |
|
|
Phonenumber |
Telefoonnummer van contactpersoon |
Telefoonnummer van contactpersoon |
|
|
EmailAddress |
Email van contactpersoon |
Email van contactpersoon |
|
OrderLine |
|
|
|
|
|
LineNumber |
Volgnummer van het artikel in de order |
|
|
|
OrderedQuantity |
Aantal besteld |
|
|
|
LineIdentification |
Volgnummer van het artikel in de order |
|
|
Orderline - TradeItemIdentification |
|
|
|
|
|
GTIN |
GTIN nummer van artikel |
Afkomstig uit AfasFbOCIField03 |
|
|
SuppliersTradeItemIdentification |
Itemcode inkooprelatie |
Itemcode van de leverancier in Profit |
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 Technische Unie.
Direct naar |