Topbloemen OCI-koppeling

In de koppeling met Topbloemen.nl 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 Topbloemen.nl lezen.

Inhoud

Type koppeling

Type koppeling:

Inkoopaanvraag met Concept ordernummer leverancier, koppeling niet aanpasbaar

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:

nee

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 Topbloemen.nl 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

 

Wachtwoord OCI-koppeling

Verplicht

 

URL Export (XML-order)

HTTPS

Voor elke klant een apart https adres. Deze is verkrijgbaar via Topbloemen.nl

Gebruikersnaam OCI-koppeling

n.v.t.

 

Wachtwoord OCI-koppeling

n.v.t.

 

Debiteurnummer leverancier

Verplicht

Vul hier het GLN nummer in

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_ITEM-DESCRIPTION

Description - Omschrijving van product

Omschrijving

NEW_ITEM-QUANTITY

Quantity – Aantal van item

Aantal besteld

NEW_ITEM-PRICE

Price – Prijs van item

Prijs

NEW_ITEM-EXT_PRODUCT_ID

Ext_product_id – Unieke ID voor item in de catalogus van leverancier

Itemcode leverancier

NEW_ITEM-VENDORMAT

Vendormat – Itemcode van leverancier

Referentie inkooprelatie

NEW_ITEM-VENDOR

Vendor – SRM nummer van leverancier

-

NEW_ITEM-CURRENCY

Currency – Valuta van item

Valuta

NEW_ITEM-UNIT

Unit – Eenheid van item

Eenheid

NEW_ITEM-VATPERCENTAGE

-

-

NEW_ITEM-CUST_FIELD3

Cust_Field3 – Vrij veld, wordt bepaald door de gebruiker

BTW percentage

NEW_ITEM-CUST_FIELD4

Cust_Field4 – Vrij veld, wordt bepaald door de gebruiker

Gewenste leverdatum

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-V Ext_Product_ID

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_Field3

Artikelgroep

nvt

Topbloemen.nl stuurt geen artikelgroepen mee.

-

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:

Omdat de leverancier geen artikelgroepen meestuurt worden alle bestelde artikelen gekoppeld aan de artikel groep die is ingesteld.

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

Referentie inkooprelatie

V

Referentie waarmee gematcht wordt bij het versturen van de inkooporder

NEW_ITEM-Vendormat

Vanuit bestelling

Gewenste leverdatum

V

Datum waarop de bestelling geleverd moet worden

NEW_ITEM-CUST_FIELD04

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 Topbloemen.nl 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

Combinatie van naam factuuradres en debiteurnummer in oci-profiel

Factuuradres + OCI-profiel

 

To - Credential (Domein = debiteurnummer leverancier)

 

 

 

 

 

Identity

Naam van de inkooprelatie

Kop van de inkooporder

 

Sender - Credential (domein = Combinatie van naam factuuradres en debiteurnummer in OCI-profiel)

 

 

 

 

 

Identity

Provider die de inkooporder verstuurd. Dit zal altijd AFAS zijn.

 

 

 

 

 

 

 

 

 

 

 

Sender - UserAgent

 

 

 

 

 

UserAgent

Omgeving waar de order vandaan komt.

 

Request

 

 

 

 

 

OrderRequest - OrderRequestHeader

 

 

 

 

 

orderID

Referentie inkooprelatie

Kop van de inkooporder

 

 

afasOrderId

Ordernummer van de verstuurde order

Kop van de inkooporder

 

 

orderDate

Besteldatum

Kop van de inkooporder

 

 

 

 

 

 

OrderRequestHeader - Total

 

 

 

 

 

Money

Totale waarde van inkooporder + valuta code. De valuta code zal altijd EUR zijn

 

OrderRequestHeader - ShipTo

 

 

 

 

\ShipTo - Address

 

 

 

 

 

Address

Koppeling met afleveradres in OCI-profiel

 

 

 

Name

Omschrijving van het afleveradres

 

 

\Address - PostalAddress

 

 

 

 

 

DeliverTo

Naam van afleveradres

Ingestelde afleveradres in de inkooporder

 

 

Street

Adresregel 1 van afleveradres

Ingestelde afleveradres in de inkooporder

 

 

City

Stad gekoppeld aan afleveradres

Ingestelde afleveradres in de inkooporder

 

 

PostalCode

Postcode van afleveradres

Ingestelde afleveradres in de inkooporder

 

 

Country

Landcode van afleveradres

Ingestelde afleveradres in de inkooporder

 

\Address - Email

 

 

 

 

 

Email

e-mail

Ingestelde afleveradres in de inkooporder

 

\Address - Phone

 

 

 

 

\Phone - TelephoneNumber

 

 

 

 

 

CountryCode

Landcode van afleveradres

Ingestelde afleveradres in de inkooporder

 

 

AreaOrCityCode

N/A

 

 

 

Number

Telefoonnumer van het afleveradres

Ingestelde afleveradres in de inkooporder

 

 

 

 

 

 

OrderRequestHeader - BillTo

 

 

 

 

\Billto - Address

 

 

 

 

 

Address

Het ID en landcode van het afleveradres

Ingestelde factuuradres

 

 

Name

Omschrijving van het afleveradres

Ingestelde factuuradres

 

\Address - PostalAddress

 

 

 

 

 

DeliverTo

Naam van afleveradres

Ingestelde factuuradres

 

 

Street

Straatnaam

Ingestelde factuuradres

 

 

City

Stad

Ingestelde factuuradres

 

 

PostalCode

Postcode

Ingestelde factuuradres

 

 

Country

Land

Ingestelde factuuradres

 

\Address - Email

 

 

 

 

 

Email

 

 

 

\Address - Phone

 

 

 

 

\Phone - TelephoneNumber

 

 

 

 

 

CountryCode

Telefoonnumer

Ingestelde factuuradres

 

 

AreaOrCityCode

N/A

 

 

 

Number

Telefoonnumer van het afleveradres

Ingestelde factuuradres

ItemOut

 

 

 

 

 

 

Quantity

Aantal

Inkooporderregel

 

 

lineNumber

regelnummer, volgnummer

Inkooporderregel

 

 

requestedDeliveryDate

Gewenste leverdatum

Inkooporderregel

 

\ItemID

 

 

 

 

 

SupplierPartID

Itemcode inkooprelatie

Eigenschappen van het artikel, bijhorende inkooprelatie.

 

\ItemDetail

 

 

 

 

\ItemDetail - UnitPrice

 

 

 

 

 

Money

Prijs per eenheid

Inkooporderregel

 

\ItemDetail - Description

Description

Omschrijving

Inkooporderregel

 

\ItemDetail - UnitofMeasure

Unit of measure

Eenheid

Inkooporderregel

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 Topbloemen.nl.

Direct naar

  1. OCI-koppelingen