Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Parameters

ParameterTypeDescription

Requirements

nameString

Name of cost cente

• The attribute is required

• The attribute value is unique within the organization

• Maximum length 255 characters

descriptionString

Cost center description

• The attribute is required

MPK resource - cost center - user-defined dictionary value, principally refers e.g. to the department which has generated the cost (e.g. sent the shipment) - Marketing Department, Logistics Department etc. The values may be freely defined. MPK (cost center) number should be unique. MPK (cost center) number to be assigned to the shipment so that it does not change after changing the cost center name in the historical data.

For the purposes of settlements of cost centers, COD Report can be used..


Panel
bgColor#f0f0f0
titleBGColor#f0f0f0
titleOn this page

Table of Contents
minLevel2
 


The MPK (cost center) resource has the following attributes:

AttributeType

Description

nameString

Name of cost center

descriptionString

Cost center description


Sample MPK resource in the JSON format:

Code Block
{
    "href": "https://api-shipx-pl.easypack24.net/v1/mpks/1",
    "id": 1,
    "name": "Nazwa miejsca powstania kosztów",
    "description": "Opis miejsca powstania kosztów",
    "created_at": "2018-05-15T21:58:49.427+02:00",
    "updated_at": "2018-05-17T10:35:59.644+02:00"
}


Authentication

Access to the resource requires provision of the correct and valid access token for the Organization.

Downloading the collection of cost centers

Collecting lists of all cost centers for the selected organization.

Code Block
GET /v1/organizations/:organization_id/mpks

 


(info) The resource is paged.

Parameters

Parameter

Description

sort_by

Determines the attribute on which the results are to be sorted.

sort_order

Determines the sorting type - descending(desc) or ascending (asc).


Sample request

Code Block
GET /v1/organizations/:organization_id/mpks HTTP/1.1
Host: api-shipx-pl.easypack24.net
Content-Type: application/json
 


Response

In the response the server will return collections with the MPK (cost center) list and HTTP 200 OK code

Code Block
HTTP/1.1 200 OK
Content-Type: application/json
 
{
    "href": "http://api-shipx-pl.easypack24.net:3000/v1/organizations/1/mpks",
    "count": 3,
    "page": 1,
    "per_page": 30,
    "items": [
        {
            "href": "https://api-shipx-pl.easypack24.net/v1/mpks/3",
            "id": 3,
            "name": "First",
            "description": "Some New Description 1",
            "created_at": "2018-05-16T13:36:28.332+02:00",
            "updated_at": "2018-05-16T13:36:28.332+02:00"
        },
        {
            "href": "https://api-shipx-pl.easypack24.net/v1/mpks/2",
            "id": 2,
            "name": "Second",
            "description": "Some New Description 2",
            "created_at": "2018-05-16T13:33:03.745+02:00",
            "updated_at": "2018-05-17T09:56:11.500+02:00"
        },
        {
            "href": "https://api-shipx-pl.easypack24.net/v1/mpks/1",
            "id": 1,
            "name": "Third",
            "description": "Some New Description 3",
            "created_at": "2018-05-15T21:58:49.427+02:00",
            "updated_at": "2018-05-15T22:31:04.316+02:00"
        }
    ]
}


Creating a cost center

Code Block
POST /admin/v1/organizations/organization_id/mpks

The server will return a HTTP response with the 201 Created status. 


Parameters

ParameterTypeDescriptionRequirements
nameString

Name of cost center

• The attribute is required           

• The attribute value is unique within the organization     

• Maximum length 255 characters

descriptionString

Cost center description

• The attribute is required


Sample request 

Code Block
POST /v1/organizations/:organization_id/mpks HTTP/1.1
Host: api-shipx-pl.easypack24.net
Content-Type: application/json
 
{
  "name": "Nazwa miejsca powstania kosztów",
  "description": "Opis miejsca powstania kosztów"
}


Sample response

Code Block
HTTP/1.1 201 Created
Location: https://api-shipx-pl.easypack24.net/v1/mpks/3
Content-Type: application/json
 
{
    "href": "https://api-shipx-pl.easypack24.net/v1/mpks/3",
    "id": 3,
    "name": "Nazwa miejsca powstania kosztów",
    "description": "Opis miejsca powstania kosztów",
    "created_at": "2018-05-16T13:36:28.332+02:00",
    "updated_at": "2018-05-16T13:36:28.332+02:00"
}


Errors:

  • resource_not_found - the organization with the stated ID does not exist

Updating the place of collection order

Code Block
PUT /v1/mpks/:mpk_id
 


Parameters

ParameterType

Description

Requirements

nameString

Name of cost center

• The attribute is required           

• The attribute value is unique within the organization     

• Maximum length 255 characters

descriptionString

Cost center description

• The attribute is required

 


Sample request

Code Block
PUT /v1/mpks/:mpk_id HTTP/1.1
Host: api-shipx-pl.easypack24.net
Content-Type: application/json
 
{
  "name": "Nazwa miejsca powstania kosztów",
  "description": "Opis miejsca powstania kosztów",
}


Response

After completing the request correctly, the server will return a response containing the mpk object with the changed data, with HTTP 200 OK code.

Code Block
HTTP/1.1 200 OK
Content-Type: application/json
 
{
    "href": "https://api-shipx-pl.easypack24.net/admin/v1/mpks/1",
    "id": 1,
    "name": "Nazwa miejsca powstania kosztów",
    "description": "Opis miejsca powstania kosztów",
    "created_at": "2018-05-15T21:58:49.427+02:00",
    "updated_at": "2018-05-17T10:35:59.644+02:00"
}


Errors:

  • resource_not_found - webhook with the stated ID does not exist,
 


Downloading a single object

Code Block
GET /v1/mpks/1


Sample request

Code Block
GET /v1/mpks/1 HTTP/1.1
Host: api-shipx-pl.easypack24.net
Content-Type: application/json
X-ShipX-OrganizationId: 1


Response

Code Block
HTTP/1.1 200 No Content
Content-Type: application/json
 
{
    "href": "https://api-shipx-pl.easypack24.net/v1/mpks/1",
    "id": 1,
    "name": "Nowa nazwa miejsca powstania kosztów",
    "description": "Nowy opis miejsca powstania kosztów",
    "created_at": "2018-05-15T21:58:49.427+02:00",
    "updated_at": "2018-05-15T22:31:04.316+02:00"
}