Integration 2: Master Data

2. Create Master Data

POST /suppliers

Navigate to http://api.testsemine.no/swagger/ POST /suppliers and fill in the request body structure according to the required fields (denoted by *) in the schema.

NOTE: All POSTs are UPSERTS which means that if "code" is unique across all suppliers in a single client, the record is INSERTed. If "code" is already identical to an existing record, it is UPDATEd with the new values.

A minimal supplier request body looks like this:

[
    {
        "address": {
            "country": "NO"
        },
        "code": "1234",
        "name": "Supplier Name",
        "organizationNumber": "444444444",
        "status": "Active",
        "bankAccounts": [
            {
                "accountNumber": "66666666666",
                "bankName": "Bank Name",
                "status": "Active"
            }
        ]
    }
]

A successful insert looks like this. Note the response code 200 OK.

GET /suppliers

After running the request, you should now be able to verify that the supplier was inserted by runningGET /suppliers/1234. (i.e. GET /suppliers/<code> ) There is no UI for this now.

{
    "code": "1234",
    "name": "Supplier Name",
    "organizationNumber": "444444444",
    "organizationAuthorityCode": null,
    "address": {
        "street": null,
        "city": null,
        "zipcode": null,
        "phone": null,
        "email": null,
        "country": "NO"
    },
    "bankAccounts": [
        {
            "bankName": "Bank Name",
            "accountNumber": "66666666666",
            "ibanAccountNumber": null,
            "swiftCode": null,
            "status": "Inactive"
        }
    ],
    "status": 2,
    "defaultAccountingCode": null
}

NOTE

• Inactive status Run POST with "status" : "Inactive" to set the supplier temporarily inactive. The item will still be listed when running GET /suppliers/1234 but will not be used by Semine.
• Deleted status Run DELETE /suppliers/1234 to remove the item from any listing. GET /suppliers/1234 will only return 404 for any deleted item.

Import Minimum Master Data

Repeat this procedure for the following master data types to prepare Semine for the first invoice

• /accountingcodes - (GL Codes) - At least one accountingcode is needed.
• /currency - At least one currency has to be defined
• /vatcode - At least one VAT rate has to be defined

See Semine Integration API Definition  for details.

See Master Data Overview for more information of each master data type.

Submit Invoice >