Send operational targets into Ordinavo
Use the Inbound Target API to send operational jobs, delivery stops, pickup orders, service visits or field tasks into Ordinavo.
POST
/inbound/targets
Required scope: inbound.targets.write
{
"sourceSystem": "logistics_erp",
"externalId": "DEL-2026-000918",
"externalType": "DeliveryOrder",
"operation": "upsert",
"templateKey": "delivery_stop",
"title": "Delivery to Rhein-Ruhr Medical Supply",
"description": "Medical supplies delivery for priority customer.",
"customer": {
"name": "Rhein-Ruhr Medical Supply",
"contactName": "Anna Weber",
"phone": "+49 201 123456",
"email": "anna.weber@example.com"
},
"address": {
"street": "Hachestrasse 12",
"postalCode": "45127",
"city": "Essen",
"country": "DE",
"latitude": 51.4513,
"longitude": 7.0116
},
"planning": {
"routeDate": "2026-06-25",
"dueAtUtc": "2026-06-25T10:00:00Z",
"timeWindowStartUtc": "2026-06-25T08:00:00Z",
"timeWindowEndUtc": "2026-06-25T13:00:00Z",
"estimatedWorkMinutes": 25,
"priority": "High",
"fixedTime": false
},
"businessValue": {
"expectedRevenue": 2500,
"customerTier": "A",
"closeProbability": 75
},
"customFields": {
"delivery_weight_kg": "120",
"package_count": "8",
"temperature_sensitive": "true",
"delivery_note": "Use rear entrance."
}
}{
"importJobId": 184,
"status": "Completed",
"totalItems": 1,
"createdItems": 1,
"updatedItems": 0,
"cancelledItems": 0,
"rejectedItems": 0,
"warningItems": 0,
"items": [
{
"externalId": "DEL-2026-000918",
"status": "Created",
"targetId": 991,
"warnings": []
}
],
"links": {
"importJob": "/import-jobs/184"
}
}Operations
| Operation | Behavior |
|---|---|
create | Creates a new Target. Fails if the externalId already exists. |
update | Updates an existing Target. Fails if the externalId is unknown. |
upsert | Creates the Target if externalId is new and updates it if it already exists. Recommended default. |
cancel | Cancels an imported Target when an external order or stop is cancelled. |
{
"sourceSystem": "logistics_erp",
"externalId": "DEL-2026-000918",
"operation": "cancel",
"title": "Cancelled delivery"
}