Viking Netherlands OCI-koppeling

In de koppeling met Viking Netherlands 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 Viking Netherlands lezen.

Inhoud

Type koppeling

Type koppeling:

Inkoopaanvraag, koppeling niet aanpasbaar

Het overgenomen winkelmandje vanuit Viking Netherlands is in InSite aanpasbaar. (De Profit-gebruiker kan het uit de webshop van Viking Netherlands aanpassen in InSite). Artikelen kunnen worden toegevoegd als de juiste itemcode van de leverancier bekend is in Profit (itemcode inkooprelatie).

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

Niet aanpasbaar. Ingesteld in OCI-definitie.

Test URL beschikbaar

Niet van toepassing

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.

Gebruikersnaam Export

Verplicht

Niet aanpasbaar. Ingesteld in OCI-definitie.

Wachtwoord (Export)

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

OCI-Field

Omschrijving

Profit veld

NEW_ITEM-DESCRIPTION

Description - Omschrijving van product

Omschrijving

NEW_ITEM-MATNR

Matnr - SRM code van item

-

NEW_ITEM-MATGROUP

Matgroup – Artikelgroep van item

-

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

Priceunit – Prijs per eenheid

Prijs per eenheid

NEW_ITEM-CURRENCY

Currency – Valuta van item

Valuta

NEW_ITEM-LEADTIME

Leadtime – levertijd van item in dagen

Gewenste leverdatum

NEW_ITEM-VENDOR

Vendor – SRM nummer van leverancier

-

NEW_ITEM-VENDORMAT

Vendormat – Itemcode van leverancier

Itemcode leverancier

NEW_ITEM-MANUFACTCODE

Manufactcode – SRM nummer van item van fabrikant

-

NEW_ITEM-MANUFACTMAT

MANUFACTMAT - Artikelnummer van de fabrikant van het item

-

NEW_ITEM-CONTRACT

Contract – Verwijzing naar gekoppelde contract

-

NEW_ITEM-CONTRACT_ITEM

Contract_Item - item binnen het SRM-contract

-

NEW_ITEM-SERVICE

Service – Aanduiding als Item is een service is

-

NEW_ITEM-EXT_QUOTE_ID

 

 -

NEW_ITEM-EXT_QUOTE_item

 

 -

NEW_ITEM-EXT_PRODUCT_ID

Ext_product_id – Unieke ID voor item in de catalogus van leverancier

-

NEW_ITEM-LONGTEXT

Longtext – Tekst veld voor item

Opmerking

NEW_ITEM-ATTACHMENT

Attachment – Bijlage bij item

-

NEW_ITEMATTACHMENT_TITLE

Itemattachment _title – Titel van bijlage

-

NEW_ITEMATTACHMENT_PURPOSE

Itemattachment _purpose – Doel van bijlage

-

NEW_ITEMEXT_SCHEMA_TYPE

Itemext_Schema_Type - Naam van een schema waarmee het is geïmporteerd

in de SRM-server van leverancier

-

NEW_ITEMEXT_CATEGORY_ID

Itemext_Category_Id – Unieke ID voor een externe category van het schema op de SRM-server. Dit is onafhankelijk van het schema dat wordt gebruikt.

-

NEW_ITEM-EXT_CATEGORY

Ext_Category – Unieke ID voor een externe category van het schema op de SRM-server. Dit is afhankelijk van het schema dat wordt gebruikt.

-

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

-

NEW_ITEM-CUST_FIELD3

Cust_Field3 – Vrij veld, wordt bepaald door de gebruiker

Referentie inkooprelatie

NEW_ITEM-CUST_FIELD4

Cust_Field4 – Vrij veld, wordt bepaald door de gebruiker

-

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

Deleverancier stuurt de artikelgroepen mee. Op basis van de inrichting van de artikelgroepen in het OCI-profiel bepaalt Profit vervolgens de artikelgroep.

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

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

Let op!

Het is uiterst belangrijk dat de afleveradressen van Profit worden gekoppeld met de adres ID’s zoals die bekend zijn bij de Office Depot. Neem daarom ook contact op om de juiste Office Depots adres ID’s te koppelen met de Profit adres ID’s.

Lees meer informatie over hoe je deze koppeling legt in dit artikel: Afleveradressen koppelen in OCI-profiel


Velden:

Head element

Subelement(s)

Field

Toelichting

Bron

Header

 

 

 

 

 

From - Credential

 

 

 

 

 

Identity

Klantnummer bij leverancier. Verplicht in de koppeling met Office Depot

OCI-profiel in AFAS

 

To - Credential

 

 

 

 

 

Identity

Naam van de inkooprelatie

Naam van crediteur in de kop van de inkooporder.

 

Sender - Credential

 

 

 

 

 

Identity

Versturende partij - AFAS

Vaste waarde in de cXML.

 

Sender - UserAgent

 

 

 

 

 

UserAgent

Omgeving en huidige versie van Profit waar de order vandaan komt.

Profit omgeving

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

Adres ID van het afleveradres. Hier moet gebruikt gemaakt worden van de koppeling met de tabel Afleveradressen leverancier in het OCI-profiel

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

Name

Omschrijving van het afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

\Address - PostalAddress

 

 

 

 

 

DeliverTo

Naam van afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

Street

Straatnaam van afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

City

Plaatsnaam van afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

PostalCode

Postcode van afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

Country

Land van afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

\Address - Email

 

 

 

 

 

Email

E-mail van het afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

\Address - Phone

 

 

 

 

\Phone - TelephoneNumber

 

 

 

 

 

CountryCode

Telefoonnummer

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

AreaOrCityCode

N/A

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

Number

Telefoonnummer van het afleveradres

Ingestelde afleveradres in AFAS (Kop inkooporder)

 

 

 

 

 

 

OrderRequestHeader - BillTo

 

 

 

 

\Billto - Address

 

 

 

 

 

Address

Het ID en landcode van het factuuradres

Ingestelde factuuradres in AFAS.

 

 

Name

Omschrijving van het factuuradres

Ingestelde factuuradres in AFAS.

 

\Address - PostalAddress

 

 

 

 

 

DeliverTo

Naam van factuuradres

Ingestelde afleveradres in AFAS.

 

 

Street

Straatnaam van factuuradres

Ingestelde afleveradres in AFAS.

 

 

City

Stad van factuuradres

Ingestelde afleveradres in AFAS.

 

 

PostalCode

Postcode van factuuradres

Ingestelde afleveradres in AFAS.

 

 

Country

Land van factuuradres

Ingestelde afleveradres in AFAS.

 

\Address - Email

 

 

 

 

 

Email

 

 

 

\Address - Phone

 

 

 

 

\Phone - TelephoneNumber

 

 

 

 

 

CountryCode

Telefoonnummer

Landcode die is gekoppeld aan het ingestelde afleveradres

 

 

AreaOrCityCode

N/A

 

 

 

Number

Telefoonnummer van het factuuradres

Ingestelde afleveradres in AFAS.

 

</Billto

 

 

 

 

 

 

 

 

 

Comments

comments

Opmerking

Kop van de inkooporder

 

SupplierOrderInfo

SupplierOrderInfo

Leveringsreferentie

Kop van inkooporder

 

IdentityFrom

IdentityFrom

Extra From veld

OCI-Profiel in AFAS

 

IdentityTo

IdentityTo

Extra To veld

OCI-Profiel in AFAS

 

BTW

BTW

BTW identificatienummer

Factuuradres

 

Projectnummer

Projectnummer

Nummer van gekoppelde project

Kop van inkooporder

 

Projectfase

Projectfase

Fase van het gekoppelde project

Kop van inkooporder

 

Contractnummer

Contractnummer

Nummer van gekoppelde contract

Kop van inkooporder

ItemOut

 

 

 

 

 

 

Quantity

Aantal besteld

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

Inkoopaanvraagsregel

 

\ItemDetail - Description

Description

Omschrijving

OCI Description, niet omschrijving van de inkoopaanvraagsregel

 

\ItemDetail - UnitofMeasure

UnitOfMeasure

Eenheid

Inkoopaanvraagsregel

 

\ItemDetail - Barcode

Barcode

Barcode van itemcode inkooprelatie

Itemcode van de inkooprelatie in de eigenschappen van het artikel

 

\ItemDetail - Opmerking

Opmerking

Opmerking in de regel

Inkoopaanvraagsregel

 

\ItemDetail - Projectnummer

Projectnummer

Nummer van gekoppelde project

Inkoopaanvraagsregel

 

\ItemDetail - Projectfase

Projectfase

Fase van het gekoppelde project

Inkoopaanvraagsregel

 

\ItemDetail - VerbijzonderingscodeAs1

VerbijzonderingscodeAs1

Code van verbijzonderingsas 1

Inkoopaanvraagsregel

 

\ItemDetail - VerbijzonderingscodeAs2

VerbijzonderingscodeAs2

Code van verbijzonderingsas 2

Inkoopaanvraagsregel

 

\ItemDetail - VerbijzonderingscodeAs3

VerbijzonderingscodeAs3

Code van verbijzonderingsas 3

Inkoopaanvraagsregel

 

\ItemDetail - VerbijzonderingscodeAs4

VerbijzonderingscodeAs4

Code van verbijzonderingsas 4

Inkoopaanvraagsregel

 

\ItemDetail - VerbijzonderingscodeAs5

VerbijzonderingscodeAs5

Code van verbijzonderingsas 5

Inkoopaanvraagsregel

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 Viking Netherlands.

Direct naar

  1. OCI-koppelingen