Mediq/Medeco OCI-koppeling

In de koppeling met Mediq/Medeco 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 Mediq/Medeco lezen.

De Mediq-koppeling is een kopie van de Medeco-koppeling met een aantal kleine aanpassingen. Mediq heeft per 2022 een aangepaste server in gebruik genomen (MedBis 2.0), voor die server is deze koppeling aangepast. T.z.t. zal de Medeco-koppeling komen te vervallen.

Het is voor een OCI-koppeling met Mediq (Medeco) ook mogelijk om gebruik te maken van de optie om onder één OCI-profiel meerdere afleveradressen aan te maken en hier Mediq-codes (GO-nummmer) aan te koppelen

Mediq/Medeco kent twee type koppelingen:

  • OCI-1 - Eén OCI-koppeling waarbij de afleveradressen met het juiste GO-nummer handmatig toegevoegd worden aan de koppeling.
  • OCI-2 - Voor elk van de afleverlocaties (GO-nummers) een aparte OCI-koppeling.

Je kunt zelf kiezen welke koppeling het beste bij de organisatie past.

Inhoud

Type koppeling

Type koppeling:

Inkoopaanvraag niet aanpasbaar

Het overgenomen winkelmandje vanuit Mediq/Medeco is in InSite aanpasbaar. 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 Mediq/Medeco 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)

HTTPs

Niet aanpasbaar. Ingesteld in OCI-definitie.

Test URL Export (XML-order)

HTTPs

Niet aanpasbaar. Ingesteld in OCI-definitie. *

Gebruikersnaam Export- URL

Verplicht

Niet aanpasbaar. Ingesteld in OCI-definitie.

Wachtwoord Export-URL

Verplicht

Niet aanpasbaar. Ingesteld in OCI-definitie.

Debiteurnummer leverancier

Verplicht

De leverancier heeft per afdeling een apart nummer.** Zie opmerking bovenaan dit artikel.

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.

*) Omdat credentials vast in de definitie zitten en (op dit moment) er verschillende credentials zijn voor Productie en Acceptatie geeft de keuze "Export-Test-URL toepassen" een foutmelding bij het versturen van de cXML order.

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-MANUFACTMAT

MANUFACTMAT - Artikelnummer van de fabrikant van het item

-

NEW_ITEM-QUANTITY

QUANTITY– Aantal van item

Aantal

NEW_ITEM-PRICE

PRICE – Prijs van item

Prijs

NEW_ITEM-PRICEUNIT

PRICEUNIT – Prijs per eenheid

-

NEW_ITEM-CURRENCY

CURRENCY – Valuta van item

Valuta

NEW_ITEM-UNIT

UNIT – Eenheid van item

Basis eenheid. UOM - Veld in cXML inkooporder

NEW_ITEM-VENDOR

VENDOR – SRM nummer van leverancier

-

NEW_ITEM-VENDORMAT

VENDORMAT – Itemcode van leverancier

Itemcode leverancier

NEW_ITEM-DESCRIPTION

DESCRIPTION - Omschrijving van product

Omschrijving

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

Artikelgroep

NEW_ITEM-CUST_FIELD3

CUST_FIELD3 – Vrij veld, wordt bepaald door de gebruiker

-

NEW_ITEM-CUST_FIELD4

CUST_FIELD4 – Vrij veld, wordt bepaald door de gebruiker

Bestel eenheid

NEW_ITEM-CUST_FIELD5

CUST_FIELD5 – Vrij veld, wordt bepaald door de gebruiker

Opmerking

NEW_ITEM-CUST_FIELD6

CUST_FIELD6 – Vrij veld, wordt bepaald door de gebruiker

Referentie inkooprelatie

NEW_ITEM-CUST_FIELD7

CUST_FIELD7 – Vrij veld, wordt bepaald door de gebruiker

ExtraDeliveryInformation - Veld in cXML inkooporder

NEW_ITEM-CUST_FIELD8

CUST_FIELD8 – Vrij veld, wordt bepaald door de gebruiker

OrderlineOCIinformation- Veld in cXML inkooporder

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-CUST_FIELD5

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-CUST_FIELD5

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

Mediq/Medeco stuurt de artikelgroepen mee. Koppel deze dan ook correct in de eigenschappen van het OCI-profiel

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-CUST_FIELD5

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

Komt niet mee vanuit de webshop

n.v.t.

n.v.t.

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 Mediq/Medeco aan. De velden in de XML-inkooporder worden op de onderstaande manier gevuld.

Velden:

Head element

Subelement(s)

Field

Toelichting

Bron

orderenvelop

 

 

 

 

 

 

sender

Versturende partij

Vaste waarde in de cXML

 

 

receiver

Ontvangende partij

Vaste waarde in de cXML

PO

 

 

 

 

 

orderheader

 

 

 

 

 

customer

Naam van afleveradres

Naam van het afleveradres.

 

 

debnr

Debiteurnummer leverancier

OCI-profiel in AFAS

 

 

gonr

Omschrijving afleveradres

Kop van inkooporder

 

 

orderdatum

Datum van order

Kop van inkooporder

 

 

bestelnr

Ordernummer

Kop van inkooporder

 

orderitems - artikel

 

 

 

 

 

nummer

Itemcode inkooprelatie

Inkooporderregel

 

 

aantal

Aantal

Inkooporderregel

 

 

uom

Eenheid, afkomsting uit OCI record

Inkooporderregel

 

 

ExtraDeliveryInformation

OCI Field 07

Inkooporderregel

 

 

OrderlineOCIInformation

OCI Field 08

Inkooporderregel

*Lees voor meer informatie over de algemene bepaling van het OCI afleveradres het volgende artikel: OCI Afleveradres - Algemene bepaling

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 Mediq/Medeco.

Direct naar

  1. OCI-koppelingen