Autorisatie Import

Korte omschrijving

Met autorisaties kan zeer gedetailleerd worden bepaald welke artikelen klanten mogen zien in de shop. Dit gebeurt met behulp van autorisatieprofielen. Zowel klanten als artikelen worden gekoppeld aan één of meer van dergelijke profielen. Een klant ziet vervolgens uitsluitend de artikelen die zijn gekoppeld aan minstens één van de profielen waar die klant zelf ook is gekoppeld.

Wanneer autorisatie wordt geactiveerd kan er een keuze worden gemaakt tussen Basic Authorization (waarbij uitsluitend standaard systeem autorisatieprofielen worden gebruikt) en Advanced Authorization (waarin ook custom profielen kunnen worden gedefinieerd).

Het systeemprofiel met profielcode PUB is gereserveerd voor het Publieke autorisatieprofiel. Dit profiel is altijd aanwezig. Wanneer Basic Authorization actief is krijgt een niet-ingelogde gebruiker automatisch dit profiel.

Het systeemprofiel met profielcode DEB is gereserveerd voor het Debiteuren autorisatieprofiel. Wanneer Basic Authorization actief is en dit profiel is geactiveerd, krijgt een ingelogde gebruiker waaraan geen custom autorisatieprofiel is toegekend, automatisch dit profiel.

Als er gebruik wordt gemaakt van Advanced Authorization kunnen ook eigen autorisatieprofielen worden gedefinieerd. Hiermee kan worden bereikt dat verschillende groepen van ingelogde gebruikers, of zelfs individuele gebruikers, verschillende assortimenten zien.

Wanneer gebruik wordt gemaakt van Advanced Authorization moet in de klantenimport worden meegegeven aan welke autorisatieprofielen een klant is gekoppeld. Bij Basic Authorization wordt gebruik gemaakt van systeemprofielen en is dat niet nodig. In beide gevallen is het uiteraard wel noodzakelijk om met een autorisatie-import artikelen te koppelen aan autorisatieprofielen.

Als gebruik wordt gemaakt van eigen autorisatieprofielen komen deze in de plaats van de DEB en PUB systeemprofielen. Wanneer het is gewenst dat gebruikers met een eigen autorisatie-profiel ook alle artikelen zien die een niet-ingelogde gebruiker kan zien, dient het PUB profiel expliciet aan de gebruiker te worden gekoppeld.

Autorisaties worden als volgt afgehandeld in de shop:

  • Een niet ingelogde gebruiker krijgt het systeemprofiel PUB

  • Een ingelogde gebruiker krijgt de autorisatieprofielen die zijn gedefinieerd bij de User, of indien die er niet zijn van de Customer waartoe de User behoort

  • Een ingelogde gebruiker waarvoor geen profiel is gedefinieerd krijgt het systeemprofiel DEB indien dat actief is, en anders het systeemprofiel PUB.

Onderdeel van de definitie van een autorisatieprofiel is de AccessMode. Deze laatste definieert of de in het autorisatie bestand aangeleverde artikelen default tot dit profiel behoren of niet. De Accessmode heeft twee mogelijke waardes: Allow en Deny. Accessmode Allow wordt incidenteel gebruikt voor zeer specifieke doelstellingen. Voor standaard situaties dient uitsluitend de Accessmode Deny te worden gebruikt.

Binnen een autorisatieprofiel met Accessmode Deny wordt bereikt dat artikelen niet zichtbaar zijn, totdat bij een artikel expliciet wordt aangegeven dat het artikel wél zichtbaar moet zijn voor een profiel. Door in de Allow node binnen de Authorization node van een artikel autorisatieprofielcodes op te nemen, wordt het artikel zichtbaar voor alle gebruikers waaraan die autorisatieprofielen zijn gekoppeld.

Het importbestand bevat een lijst van autorisatieprofielen, en vervolgens bij elk artikel een opsomming van de autorisatieprofielen die het artikel mogen zien.

Aanleverwijze

Update Frequentie: Batch minimaal 1x per dag Incrementeel of complete set: Incrementeel Bestandtype: Zipped XML

Bestandsbenaming: [SHOPNAME]_Authorizations_[INDEXNUMBER].xml Transport: over FTPS, FTPS Vendisto server wordt gehost door INTEGRACE, bestand wordt door ERP partij neergezet op FTPS server.

Location within FTP root: \Vendisto\Integration\

Structuur XML

<?xml version="1.0" encoding="utf-8"?>
<Import>
    <ImportSettings>
        <Importer>Authorizations</Importer>
        <Version>1.0</Version>
    </ImportSettings>
    <AuthorizationProfiles>
        <AuthorizationProfile>
            <Name> </Name>
            <Code> </Code>
            <DefaultAccess> </DefaultAccess>
        </AuthorizationProfile>
    </AuthorizationProfiles>
    <Articles>
        <Article>
            <Number></Number>
            <Authorizations>
                <Allow>
                    <Profile></Profile>
                    <Profile></Profile>
                </Allow>
                <Deny>
                    <Profile></Profile>
                </Deny>
            </Authorizations>
        </Article>
    </Articles>
</Import>

Velden XML

Import element:

Name

Description

Type

Required/Optional

ImportSettings

Container element for importsettings

Element

Optional

AuthorizationProfiles

Container element for AuthorizationProfile data

Element

Required

Articles

Container element for Article data

Element

Required

ImportSettings element:

Name

Description

Type

Required/Optional

Importer

Name of the importer. Should be Authorization.

Text,

default Authorization

Optional

Version

Version of the import xml. To be used for backward compatibility issues.

Text, default 1.0

Optional

AuthorizationProfile element:

Name

Description

Type

Required/Optional

Name

Descriptive name of the authorization profile

Text

Required

Code

Code of the authorization profile

Char[3]

Required

DefaultAccess

Default behavior of authorization profile

AccessMode

Required

Article element:

Name

Description

Type

Required/Optional

Number

Article number

Text

Required

Authorizations

Container element

Element

Optional

Authorizations element:

Name

Description

Type

Required/Optional

Allow

Container for list of allowed profiles

Element

Optional

Deny

Container for list of denied profiles

Element

Optional

Allow element:

Name

Description

Type

Required/Optional

Profile

Profile code

Text

Optional

Deny element:

Name

Description

Type

Required/Optional

Profile

Profile code

Text

Optional

Types:

Type

Values

AccessMode

Allow, D

Last updated