omnicado-mall-proxy

Generate labels for MALL Delivery orders

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://mall-api-proxy.documentation.omnicado.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "omnicado-mall-proxy MCP server": {
    "url": "https://mall-api-proxy.documentation.omnicado.com/mcp"
  }
}
Close
POST /orders/labels
Client Application name

You can create order labels needed for order delivery by MALL transports. Number of parcels is required for label creation. Response contains base64 representation of PDF/ZPL labels.

You can generate parcel labels when the order is set to status shipping or shipped. When order is set to shipped you cannot change parcel_count anymore and the last number of labels always applies.

Headers

  • X-Application-Name string

Query parameters

  • client_id string Required

    Client identifier

application/json

Body Required

  • labels_type string

    Values are pdf or zpl.

  • first_position integer

    Minimum value is 1.

  • labels_per_page number
  • labels array[object]
    Hide labels attributes Show labels attributes object
    • order_id integer
    • parcel_count integer

      Maximum value is 100.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • data object
      Hide data attributes Show data attributes object
      • orders array[object]
        Hide orders attributes Show orders attributes object
        • order_id integer
        • barcodes array[string]
      • labels_raw string

        base64 representation of PDF or ZPL labels

    • result object
      Hide result attributes Show result attributes object
      • code integer(int)
      • status string
POST /orders/labels 
curl \
 --request POST 'https://mpapi.proxy.omnicado.com/v1/orders/labels?client_id=yourClientId&client_id=api_token_value' \
 --header "Content-Type: application/json" \
 --header "X-Application-Name: myApplicationName" \
 --data '{"labels_type":"pdf","first_position":1,"labels_per_page":4,"labels":[{"order_id":123456,"parcel_count":4}]}'
Request examples 
# Headers
X-Application-Name: myApplicationName

# Payload
{
  "labels_type": "pdf",
  "first_position": 1,
  "labels_per_page": 4,
  "labels": [
    {
      "order_id": 123456,
      "parcel_count": 4
    }
  ]
}
Response examples (200) 
{
  "data": {
    "orders": [
      {
        "order_id": 223424231402,
        "barcodes": [
          "14IS12361223*001004",
          "14IS12361223*002004",
          "14IS12361223*003004"
        ]
      }
    ],
    "labels_raw": "JVBERi0xLjMNCiXi48/TDQoNCjEgMCBvYmoNCjw8DvUGFnZXMgMyAwIFINCj...MjcxNA0KJSVFT0YNCg=="
  },
  "result": {
    "code": 200,
    "status": "OK"
  }
}