Create Order

Endpoint

POST /v1/create-order

Creates a draft order. The body always has the same envelope: a customer object plus a products array. Each entry in products is a product-specific object (the 3 shapes below). The response returns the order id, status: "draft", a human description, the price in MDL, and currency.

Body Parameters

Name	Type	Required	Description
customer	object	yes	Customer details
customer.name	string	no	Customer name
customer.email	string	no	Customer email
customer.phone	string	yes	Customer phone
products	Product[]	yes	Order products

Product Parameters

1. Vignette (RO)

Name	Type	Required	Description
product	string	yes	Product vignette:ro
vehicle	string	yes	Vehicle Certificate Number
start_date	string	yes	Start date in yyyy-mm-dd format
duration	number	yes	Duration in days
category	string	yes	A, B, C, D, E, F, G, H

Request Body Examples

JSON

{
  "customer": {
    "name": "John Doe",
    "email": "john@doe.com",
    "phone": "+37379000000"
  },
  "products": [
    {
      "product": "vignette:ro",
      "vehicle": "1234567890", // 9 digits certificate number
      "start_date": "2024-01-25", // yyyy-mm-dd
      "duration": 10,
      "category": "A"
    }
  ]
}

Response Body Examples

JSON

{
  "id": "RO1231241GG",
  "status": "draft",
  "description": "Rovinieta, 10 zile, Categoria A, BMW X7 ABC123",
  "price": 69.98,
  "currency": "MDL"
}

2. Vignette (MD)

Name	Type	Required	Description
product	string	yes	Product vignette:md
identity_document	string	yes	IDNP or passport number
driver_full_name	string	yes	Driver full name
country	string	yes	Country ISO3 code
start_date	string	yes	Start date in yyyy-mm-dd format
period	string	yes	Validity period
vehicle_category	string	yes	M1, M2, M3, N1, N2, N3
registration_number	string	yes	Vehicle plate number

Validity period by category (same as get-offers):

• M1: 7_days, 15_days, 30_days, 90_days, 180_days, >180_days
• M2, M3, N1, N2, N3: 1_day, 7_days, 30_days, 90_days, 12_months

Request Body Examples

JSON

{
  "customer": {
    "name": "John Doe",
    "email": "john@doe.com",
    "phone": "+37379000000"
  },
  "products": [
    {
      "product": "vignette:md",
      "vehicle_category": "M1",
      "identity_document": "2002433727391",
      "driver_full_name": "John Doe",
      "country": "ROU",
      "start_date": "2024-01-25",
      "registration_number": "XXX999",
      "period": "7_days"
    }
  ]
}

Response Body Examples

JSON

{
  "id": "MDV517529SEW",
  "status": "draft",
  "description": "Vinieta MD",
  "price": 77.08,
  "currency": "MDL"
}

3. Vignette (EU)

European multi-country vignette. Take the country and validity from the matching get-offers response. Provide either vehicle (MD certificate — plate, VIN and car model are resolved automatically) or foreign_vehicle (for non-MD plates). The buyer becomes the vignette holder, so customer.name is used as the holder name.

Name	Type	Required	Description
product	string	yes	Product vignette:eu
country	string	yes	ISO2 destination country (e.g. ro, hu, bg)
validity	string	yes	Validity option id from the get-offers response
start_date	string	yes	Start date in yyyy-mm-dd format
vehicle	string	yes*	MD vehicle certificate number (*provide this or foreign_vehicle)
foreign_vehicle	object	yes*	Foreign vehicle payload (*use instead of vehicle for non-MD plates)

foreign_vehicle

Note this form requires more fields than the get-offers form: plate_number and vin are mandatory here.

Name	Type	Required	Description
registration_country	string	yes	ISO2 registration country (must not be MD)
category	string	yes	EU vehicle category (M1, N1, …)
plate_number	string	yes	Real vehicle plate number
vin	string	yes	Vehicle identification number (mandatory for ro)
make	string	no	Vehicle make
model	string	no	Vehicle model
max_authorized_mass	number	no	Max authorized mass in kg
places	number	no	Number of seats

Request Body Examples (MD vehicle)

JSON

{
  "customer": {
    "name": "John Doe",
    "email": "john@doe.com",
    "phone": "+37379000000"
  },
  "products": [
    {
      "product": "vignette:eu",
      "vehicle": "123456789", // 9 digits certificate number
      "start_date": "2026-06-10", // yyyy-mm-dd
      "country": "bg",
      "validity": "bg-7d"
    }
  ]
}

Request Body Examples (foreign vehicle)

JSON

{
  "customer": {
    "name": "John Doe",
    "email": "john@doe.com",
    "phone": "+37379000000"
  },
  "products": [
    {
      "product": "vignette:eu",
      "start_date": "2026-06-10", // yyyy-mm-dd
      "country": "bg",
      "validity": "bg-7d",
      "foreign_vehicle": {
        "registration_country": "ua",
        "category": "M1",
        "plate_number": "AA1234BB",
        "vin": "WVWZZZ1JZXW000001"
      }
    }
  ]
}

Response Body Examples

JSON

{
  "id": "EUV001002ABC",
  "status": "draft",
  "description": "Vinietă Europa, BG, 7 zile, BMW X7 ISG313",
  "start_date": "2026-06-10",
  "price": 179.15,
  "currency": "MDL"
}

Status Codes

Code	Description
200	Order created
400	Bad request
401	Unauthorized
403	Forbidden
500	Internal server error