Getting Started

This guide shows how to make your first successful call against the test environment.

1. Prerequisites

• VIP Post user_id
• a valid Bearer token
• an HTTPS client supporting JSON and multipart/form-data

2. Create a test consignment

curl -X POST 'https://vipposta.mk:3030/v2/consignment/create' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -F 'name=Test Recipient' \
  -F 'phone=071123456' \
  -F 'city=Skopje' \
  -F 'street=Test Address 1' \
  -F 'note=Integration test' \
  -F 'payer=И-Ф' \
  -F 'type=7' \
  -F 'price=0' \
  -F 'identifier=ORDER-10001' \
  -F 'user_id=183'

3. Inspect the response

{
  "error": 0,
  "message": "Data Inserted Successfully.",
  "consignment_id": "103079"
}

4. Next steps

Store the consignment_id, retrieve the consignment by ID and generate its waybill through the Waybill endpoint.