Integration 1: Requirements

You will need login credentials for a user with Integration Role , organizationId and clientId for your SEMINE client. Install Postman in order to easily perform all requests that will part of the final integration with your ERP system.

Contact your local admin to receive credentials for the integration user. Depending on your role you may also receive admin access to facilitate creation of additional users and clients within your organization.

Get from local administrator

• Getting ClientID and OrganizationID
• Access Groups - Administration Get integrator access.

Installing Postman

Go to https://www.postman.com/downloads/  to download Postman for your operating system.

Import Prepared Postman Collection

This collection has been prepared for easier use in Postman. All URLs have been set up with environment variables and all request descriptions have been shortened to allow for easier browsing and reading.

Semine_Integration_API.postman_collection.json

We recommend importing the collection directly from https://api.semine.no/swagger to get the most current version

Import Prepared Postman Environment

All relevant variables have been set up for all requests in this collection in order to allow a quick start. Simply import the postman environment and fill in your login credentials, organizationId and clientId to get started.

Semine_Integration_API.postman_environment.json

Enter values for all variables

Enter the values you should have received from Semine API Support in the "Current Value" column

• Oauth2ClientId: <Oauth2ClientSecret> (Assigned by [e-mail] )
• Oauth2ClientSecret: <Oauth2ClientSecret> (Assigned by [e-mail] )
• Username: <An username for the integration user> (Assigned by your local admin)
• Password: < A password for the integration user > (Set on first login)
• organizationId: <A 36 character organizationId> (Found in URL)
• clientId: <A 36 character clientId> ( Found in URL of invoice upload )

Example

Check network access

Select GET /health and run it by clicking on Send (Ctrl + Enter)You should see 200 OK and the word "Alive" in the Response pane.

This means that you have basic network access to https://api.semine.no/health/  . You can also try the link directly in an internet browser.

Check user access

Locate the postman request called /connect/token URL: login.semine.no/connect/token
You should see the following result if login is successful.

• 200 OK
  

  If correct username and password is used.
  
  
  
  

• 401 Unauthorized
  

  You are not yet authenticated. Please log in.
  
  
  

• 400 Bad Request
  

  If password has expired --> Go to my.semine.no and get a new password
  
  

• 400 Bad Request
  { 
      "error": "invalid_scope" 
  }
  

  Check the value in the "scope" parameter in form-data
  
  

• 400 Bad Request
  {
      "error": "invalid_grant",
      "error_description": "Invalid username or password"
  }

  Check that you have not misspelled username or password.
  
  
  

• 400 Bad Request
  {
      "error": "unsupported_grant_type"
  }

  grant_type should be "password" in form-data
  
  

• 405 Method Not Allowed
  

  Multiple possibilities:
  • If max login attempts have been reached --> Go to my.semine.no and get a new password.
  • The Oauth 2 Client Id may be wrong. This alphanumeric string is assigned by [e-mail] Please verify that you have the correct one

GET /organizations

List available organizationsRight-click one of the IDs, select Integration API Environment --> organizationId to set up the Postman environment variable.

GET /clients

List all clientId available for the selected organizationId

NOTE: Use Postman variables for enhanced security

Initial values are shared when you share a collection or environment. Current values are local and not synced or shared. Use {{postman_variables}} with only current values filled in to prevent sharing or syncing private data.See Sharing and persisting data  for more on local vs synced variables.

Master Data >