Page Comparison

Introduction

For integration purposes there are some APIs that are useful to import data into Plan & Go and also to be able to export.

...

For each session, first get authenticated with /auth/generate/login/v-1, then use the received token in the header for all the other calls. Like this:

# Example 1) Posting JSON (when logged in, we send the token in the header)
curl https://dev-api.planandgo.di.no/plexternal/apiplan/v-1/routePlancreate \
  -H "Content-Type:application/json" \
  -H "X-APIAuth-Token:olof:5f9a3609a5a295eff861d930a0c75bbee7991842" \
  -d "{ \
    \"companyId\": 1, \
    \"datedistrDate\": '\"2015-12-04T00:00:00.000+0100'04\", \
   \"name\": \"Asker\"
}"

API-methods

...

🔓

...

Fetches an login-token that the application can use to gain access to the API.

Get the username/password from DI.

...

distrNo\": 0,
    \"

...

name\": \"

...

{
	"token": "olof:5f9a3609a5a295eff861d930a0c75bbee7991842",
	"userId": 23432,
	"customerSystemId": 233,
	"roles: [...]
}

...

🔒

...

Create an empty route plan (for a given distribution date).

Create a route plan for each area (each plan has a given start-point).

...

{
    companyId: 1,
    date: '2015-12-04T00:00:00.000+0100',
    name: 'Asker'
}

...

{
	id: 344,
	date: '2015-12-04T00:00:00.000+0100',
	name: 'Asker',
	...
}

...

Create an empty file (prepare for a file-upload).

Step 1 in file upload.

...

{
    name: 'my-file-name.csv'
}

...

{
	id: 6722,
	name: 'my-file-name.csv',
	...
}

...

Upload the content of the file you have prepared.

Filetypes supported:

• .csv
• .xls
• .xlsx

Mimetype: multipart/form-data

Name the file-field: "file"

Step 2 in file upload.

...

{
	status: 'ok'
}

...

TODO

Fetch the published deliveries including the routename of each deliveries.

This will return deliveries across many routePlans, but only from published plans for the given distribution-date.

What should be the key to recognise each delivery?

...

List of deliveries

[
	{
		orderId: '12452',
		routeName: 'Asker'
	},
	{
		orderId: '12454',
		routeName: 'Asker'
	},
	...
	{
		orderId: '29452',
		routeName: 'Skøyen'
	},
	...
]

Utkjoring uke 9\" \
  }"


# Example 2) posting FILE (when logged in, we send the token in the header)
curl https://api.planandgo.di.no/external/plan/v-1/importOrderFile/1234/5678 \
  -H "Content-Type: multipart/form-data" \
  -H "X-Auth-Token: olof:5f9a3609a5a295eff861d930a0c75bbee7991842" \
  -F file=@my_import_file_in_this_dir.csv

Environment

• PROD: https://api.planandgo.di.no

Parameters you need

• companyId

• customerSystemId

• API-credentials (contact info@di.no to get access)

Most notable controllers

• Plan (importing a plan)

  • Posting a file: Check out the fileformat

• Order (extracting orders)

Usage

When the deliveries are ready on your end

• (Generate a token for the session)

• Repeat these steps for each transport company

  • Create an empty routeplan, to get a fresh routePlanId (do this for each area that has it's own starting point)

  Create an empty file, to get a fresh fileId

  • Generate a file (using our file-spec) and post it

  with the fresh fileId
• Look for status: 'ok' or handle errors

• • . Remember to fill out ORDER_ID (used as key when exporting optimized plans)

When the plan is optimized and published

...

(at a agreed time)

• (Generate a token for the session)

• Fetch the

  deliveries

  orders and extract the routename, estimater time etc from there (for a given customerSystem and distribution-date)

When the plan has been effectuated / performed

• (Generate a token for the session)

• Fetch the orders and extract the needed data (info about each order)

When a customer wants to be deleted from your system (GDPR)

• Assumes that you have a full history of the customer's orderIds

• Generate a token for the session

• Call "purgeOrders" given all the customer's orders (for a given customerSystem)