Certas Mysite API Documentation

Version: 1.6

post /api/customer/create

Request Body Fields

name string required

The company name.

sap_customer_number string required

This is a unique identifier.

parent_customer_number string optional

customer_group string optional

identification_number string

VAT ID or personal identification ID if private client. If not provided an UUID v4 will be generated and used.

is_active boolean optional

True by default. If false the customer will be hidden in My Page.

street_address string optional

postal_code string optional

postal_area string optional

email string optional

mobile string optional

phone string optional

Request Body Example

{
    "name": "Edge Branding",
    "customer_number": "101498",
    "sap_customer_number": "4300009915",
    "is_active": true,
    "parent_customer_number": "",
    "customer_group": "ZL10",
    "identification_number": "980429849",
    "street_address": "Dokkvegen 11",
    "postal_code": "3920",
    "postal_area": "Porsgrunn",
    "email": "hei@edgebranding.no",
    "mobile": "90099000",
    "phone": "35505000"
}

Success Response (200)

{
  "status": "OK"
}

Response code 409 if the user already exists, and 422 if the request does not validate.

patch /api/customer/update/{customer_number}

Request Parameters

customer_number string required

This field must contain SAP Customer Number.

Request Body Fields

parent_customer_number string optional

customer_group string optional

name string optional

The company name.

identification_number string optional

VAT ID or personal identification ID if private client.

is_active boolean optional

If false the customer will be hidden in My Page.

street_address string optional

postal_code string optional

postal_area string optional

email string optional

mobile string optional

phone string optional

Request Body Example

{
    "name": "Edge Branding AS",
    "customer_number": "4500009915",
    "identification_number": "980429849",
    "is_active": false,
    "street_address": "Dokkvegen 11",
    "postal_code": "3920",
    "postal_area": "Porsgrunn",
    "email": "hei@edgebranding.no",
    "mobile": "90099000",
    "phone": "35505000",
    "parent_customer_number": "4700009915",
    "customer_group": "ZL10",
}

Success Response (200)

{
  "status": "OK"
}

Response code 404 if customer could not be found or 400 if customer number not specified. Response code 422 if the request does not validate.

post /api/listprice/create

Request Parameters

material_code string required

The material code identifying the product. Max 10 characters.

description string required

The product description.

price_per_100l decimal required

The list price per 100 litres.

valid_from date required

The date from which this price is valid (YYYY-MM-DD).

valid_to date required

The date until which this price is valid (YYYY-MM-DD). Must be on or after valid_from.

Request Body Example

[
    {
        "material_code": "F410",
        "description": "Diesel",
        "price_per_100l": 1842.50,
        "valid_from": "2026-01-01",
        "valid_to": "2026-03-31"
    },
    {
        "material_code": "F910",
        "description": "HVO100",
        "price_per_100l": 2150.00,
        "valid_from": "2026-01-01",
        "valid_to": "2026-03-31"
    }
]

Accepts either a single record object or an array of record objects. Records are matched on material_code + valid_from — existing records are updated, new combinations are created.

Success Response (200)

{
  "status": "OK"
}

Response code 401 if API token is missing or invalid; 422 if validation fails (includes per-record error details).