Create new order

curl --request POST \
  --url https://reit.connectors.aicoflow.com/api/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "vehicle_details": {
    "number_plate": "<string>",
    "vin": "<string>",
    "makeID": 123,
    "modelID": 123,
    "first_registration": "<string>",
    "kba": "<string>",
    "hu_au": "<string>",
    "engine": "<string>",
    "engine_size": "<string>",
    "curb_weight": "<string>",
    "gross_weight": "<string>",
    "engine_power": "<string>",
    "last_registration": "<string>",
    "km_stand": "<string>",
    "engine_code": "<string>",
    "all_details": true
  },
  "person": "<string>",
  "phone": "<string>",
  "email": "<string>",
  "customer_category": 123,
  "damage": "<string>",
  "repair_date": "<string>",
  "shop_date": "<string>",
  "est_hours_karo": 123,
  "est_hours_lack": 123,
  "appointment_date": "<string>",
  "service_advisor": "<string>",
  "pickup_service": "<string>",
  "remarks": "<string>",
  "parts_delivery_date": "<string>",
  "paint_date": "<string>",
  "shop_back_date": "<string>",
  "repair_date_time_from": "<string>",
  "repair_date_time_to": "<string>",
  "estimate_date": "<string>",
  "return_date_time": "<string>",
  "type_of_date": "0",
  "damage_description": "<string>",
  "workshop_distribution": "<string>",
  "parts_needed": "<string>",
  "rental_car_deductible": "<string>",
  "rental_car_type": "<string>",
  "rental_car_motor": "<string>",
  "rental_car_transmission": "<string>",
  "rental_car_navi": "<string>",
  "rental_car_bluetooth": "<string>",
  "rental_car_hitch": "<string>",
  "rental_car_isofix": "<string>",
  "external_calculation": "<string>",
  "external_calculation_done": "<string>",
  "express_link": "<string>",
  "insurance_adjuster": "<string>",
  "activate_invoice": "<string>",
  "deductible": "<string>",
  "pickup_location": "<string>",
  "distance": "<string>",
  "pickup_company": "<string>",
  "address_notes": "<string>",
  "vehicle_class": "<string>",
  "complaint": "<string>"
}
'

{
  "success": true,
  "message": "",
  "order_id": 123,
  "project_number": "<string>"
}

Orders

Create new order

Create a new order/appointment in PlanSo.

Required Fields

vehicle_details: Complete vehicle information (VIN, plate, make/model, registration)
person: Customer name
phone: Customer phone number
email: Customer email address
customer_category: Customer category ID
damage: Damage classification (e.g., ‘KL 2-3’)
repair_date: Scheduled repair date (DD.MM.YYYY)
shop_date: Workshop date (DD.MM.YYYY)
est_hours_karo: Estimated body shop hours
est_hours_lack: Estimated paint shop hours

The newly created order is automatically synced to the local database.

POST

api

orders

Create new order

curl --request POST \
  --url https://reit.connectors.aicoflow.com/api/orders \
  --header 'Content-Type: application/json' \
  --data '
{
  "vehicle_details": {
    "number_plate": "<string>",
    "vin": "<string>",
    "makeID": 123,
    "modelID": 123,
    "first_registration": "<string>",
    "kba": "<string>",
    "hu_au": "<string>",
    "engine": "<string>",
    "engine_size": "<string>",
    "curb_weight": "<string>",
    "gross_weight": "<string>",
    "engine_power": "<string>",
    "last_registration": "<string>",
    "km_stand": "<string>",
    "engine_code": "<string>",
    "all_details": true
  },
  "person": "<string>",
  "phone": "<string>",
  "email": "<string>",
  "customer_category": 123,
  "damage": "<string>",
  "repair_date": "<string>",
  "shop_date": "<string>",
  "est_hours_karo": 123,
  "est_hours_lack": 123,
  "appointment_date": "<string>",
  "service_advisor": "<string>",
  "pickup_service": "<string>",
  "remarks": "<string>",
  "parts_delivery_date": "<string>",
  "paint_date": "<string>",
  "shop_back_date": "<string>",
  "repair_date_time_from": "<string>",
  "repair_date_time_to": "<string>",
  "estimate_date": "<string>",
  "return_date_time": "<string>",
  "type_of_date": "0",
  "damage_description": "<string>",
  "workshop_distribution": "<string>",
  "parts_needed": "<string>",
  "rental_car_deductible": "<string>",
  "rental_car_type": "<string>",
  "rental_car_motor": "<string>",
  "rental_car_transmission": "<string>",
  "rental_car_navi": "<string>",
  "rental_car_bluetooth": "<string>",
  "rental_car_hitch": "<string>",
  "rental_car_isofix": "<string>",
  "external_calculation": "<string>",
  "external_calculation_done": "<string>",
  "express_link": "<string>",
  "insurance_adjuster": "<string>",
  "activate_invoice": "<string>",
  "deductible": "<string>",
  "pickup_location": "<string>",
  "distance": "<string>",
  "pickup_company": "<string>",
  "address_notes": "<string>",
  "vehicle_class": "<string>",
  "complaint": "<string>"
}
'

{
  "success": true,
  "message": "",
  "order_id": 123,
  "project_number": "<string>"
}

Body

application/json

Request to create a new order/appointment.

vehicle_details

VehicleDetailsModel · object

required

Complete vehicle information

Show child attributes

person

string

required

Customer/driver name

Minimum string length: 1

phone

string

required

Customer phone number

Minimum string length: 1

string

required

Customer email address

Minimum string length: 1

customer_category

integer

required

Customer category ID

damage

string

required

Damage class/type (e.g., 'KL 2-3')

repair_date

string

required

Repair date (DD.MM.YYYY)

shop_date

string

required

Workshop date (DD.MM.YYYY)

est_hours_karo

number

required

Body shop estimated hours

est_hours_lack

number

required

Paint shop estimated hours

appointment_date

string | null

Appointment created timestamp (DD.MM.YYYY HH:MM:SS)

service_advisor

string | null

Service advisor initials/name

pickup_service

string | null

Pick-up/delivery service (e.g., 'kommt', 'bringt')

remarks

string | null

Additional comments/remarks

parts_delivery_date

string | null

Parts delivery date (DD.MM.YYYY)

paint_date

string | null

Paint date (DD.MM.YYYY)

shop_back_date

string | null

Shop return date (DD.MM.YYYY)

repair_date_time_from

string | null

Repair time slot start

repair_date_time_to

string | null

Repair time slot end

estimate_date

string | null

Estimate date

return_date_time

string | null

Return date/time

type_of_date

string | null

default:0

Type of date

damage_description

string | null

Detailed damage description

workshop_distribution

string | null

Workshop distribution

parts_needed

string | null

Parts needed description

rental_car_deductible

string | null

Rental car deductible

rental_car_type

string | null

Rental car type

rental_car_motor

string | null

Rental car motor type

rental_car_transmission

string | null

Rental car transmission

rental_car_navi

string | null

Rental car navigation

rental_car_bluetooth

string | null

Rental car bluetooth

rental_car_hitch

string | null

Rental car tow hitch

rental_car_isofix

string | null

Rental car ISOFIX

external_calculation

string | null

External calculation reference

external_calculation_done

string | null

External calculation completion status

express_link

string | null

Express link status

insurance_adjuster

string | null

Insurance adjuster

activate_invoice

string | null

Invoice activation status

deductible

string | null

Deductible amount

pickup_location

string | null

Pickup location

distance

string | null

Distance

pickup_company

string | null

Pickup company name

address_notes

string | null

Address notes/hints

vehicle_class

string | null

Vehicle class

complaint

string | null

Complaint/reclamation flag

Response

Created order ID and project number

Response after creating an order.

success

boolean

required

message

string

default:""

order_id

integer | null

project_number

string | null

Query orders Get order details

⌘I

Authentication

Sync

Orders

Parts

Health

Create new order

Required Fields

Body

Response