web
Du er frakoblet. Dette er en skrivebeskyttet versjon av siden.
close
  • Hjem
  • partnerportal

Partnerportal

Welcome to the FAQ for our Partner Portal!

Below you will hopefully find answers to your questions, but if not do not hesitate to contact us via our Self Service Portal.If you do not have a user at this portal, call us and we will make one for you. Check out our Help pages (in Norwegian), where you also will find the link to our Self Service Portal.

What is the Partner Portal?

In brief, this is a portal where our customers’ partners will be able to administrate and maintain their products.

 

How do I get access to the Partner Portal?

New Partners:

If you want to become a Partner, have a look at our Partner information page and navigate to “Ny tilgang”.

 

Existing Partners:

All Partners should have a registered contact person in our system. This person must use their registered e-mail address to access the portal via the relevant environments below.

Production: https://partnerportal.vitecnext.no

Test: https://partnerportal.qa.vitecnext.no

If you don’t receive an e-mail or you are not sure if you are registered as the contact person, do not hesitate to contact us.

If you are not the contact person, but know who this is, you should contact them as they can grant you access.

 

How do I give other access to the portal?

When logged in to the portal you go to

  1. Users
  2. Add the user’s e-mail and
  3. Hit Submit-button:

 

What is (Vitec Megler) HUB?

HUB is the API for Vitec Next.

The API can be used for fetching information in real-time, or to synchronize information, to another sytsem.

Follow this URL for more technical information about HUB: https://hub.megler.vitec.net/

 

How do I get access to HUB?

New Partners:

If you want to become a Partner, have a look at our Partner information page and navigate to “Ny tilgang”.

Existing Partners:

When you became a partner, you received the necessary credentials to the production environment, and if requested, also to the test environment.

If you, as a registered user, don’t have access to these details, do not hesitate to contact us.

 

How do we access HUB?

Have a look at the HUB’s technical documentation: https://hub.megler.vitec.net/

 

Do Partners have access to a test environment?

Yes, in most cases.

https://hub.qa.vitecnext.no/

Normally you get access to both test and production environment.

If the customer you are developing an integration for, does not have their own Next test environment it is possible to use the common environment for our partners, Next Partner. Contact us for more information about this environment and ordering access to it.

 

Product

What is a Product?

A Product is what we call the collection of necessary API functions and settings for your solution / integration to work with Next.

There are two types of products:

  • Order Integration Product (No: Ordreintegrasjon)
    • An order needs to be triggered/started from a sales object before the Partner can collect information about it.
  • Product with functions only (No: Rettighetsprodukt)
    • Integration works mostly “behind the scenes”

How do I build a product?

First you will have to create the “shell” by

  1. Go to Product
  2. Click “New product”
  3. Give it a name. NB! If you consider a generic name (i.e., Sellers insurance) you should also add your company name.
  4. Fill out the fields relevant for your product.
  5. Click “Add”

How to set credentials?
New feature from autumn ’23 is that you can now sett your own credentials on product level yourself.
Previously this was predefined by Vitec on account level. Old setup will work, but we highly recommend you to change to product controlled credentials.

In the product preview area you fint the the link to where you set your wanted credentials:

 

Make sure you read and understand the instructions and if you have any questions do not hesitate to contact customer service.

How to add functions?
  1. Click “Change Functions”
  2. Search for wanted function
  3. Click on the function
  4. Tick off “Require access to function”
  5. Tick off necessary filtering (if any)
  6. Click “Save Changes”

Continue step 2-6 until you have all necessary functions.

When you are ready, activate your product and it will be available for activation in Next for the customer(s), depending on the availability you chose under “Access and Security”.

NB! If in testing phase and you want the product to be activated in Next Partner (MSVPAR) contact us and we will activate it for you.

This is how it looks like in the Partner Portal when your product has been activated both in the portal and in a Next installation.

 

How do I set up Push?
NB! Your push receiver service needs to up and running before push can be set up in the portal.

For some functions it is possible to set up push:

  1. Open “Change Functions”
  2. Find the function you want to push and click “Create subscription”
  3. Fill out the form
  4. Save with “Add”

 

 

How to edit a product?

You can edit anything you want under “Edit” without having to create a new version.

If you must add new functions, you will have to create a new version of the product.

What is a Version?

NB! In Test and if Next Partner is the only installation that has activated your product you don’t have to create a new version. This is an exception we have made to make testing easier.

If your product is activated in a customer environment and you must add one or more functions, you must create a new version (1) and repeat the steps for adding a function (see above).

This is how it looks like before functions are added:

And after:

When ready, hit “Activate” on the new version and customers who has the previous version installed can upgrade.

How do customers upgrade?

A few minutes after you have hit “Activate” on a new version an Administrator in the customer’s environment will get a notification that your product is ready to upgrade:

  1. Click the Administration wheel
  2. Click the “Leverandør” card
  3. Click the card for the relevant product

As you see, upgradable products will end up at the top of the list.

  1. A panel to the right will open and at the bottom the user will get the choice to upgrade or leave as is.
  2. Click “Videre” (Next) to get to the next panel.
  3. The user will be able to check the changes and grant you access by clicking “Oppdater produkt” (Upgrade product).

What is Legacy access?

The list you see under “Legacy access – Permissions without product” are traces of our old work process.

Previously partners were given direct access to a customer manually, customer by customer, function by function. We took note that our partners increasingly needed the same collection of functions across several customers, and started to work with products (i.e. one product can be activated by several customers) and now the future is product only.

NB! If your list is long, you might have to do a cleanup. Gather the API functions you need into a product or update your current one if some are missing in the product but exist in the legacy list. When the list is redundant let us know and we will remove the direct access and clean up the legacy list.

Is the product available for all customers?

You can choose if your product should be available for all customers or restricted to specific installations.

Edit your product and scroll to the bottom to “Access and security”:

  1. Choose if you want the product to be available for everyone or restrict it to certain installations.
  2. If you restrict it, you also need to insert the customer’s InstallationID. (Contact the customer for this information)

In test environment all products are default restricted to Next Partner (MSVPAR).