Batch imports
Batch imports are designed for logistics, ERP and warehouse systems that need to send multiple targets at once. Ordinavo processes each item independently. A batch can be partially successful.
POST
/inbound/targets/batch
Required scope: inbound.targets.batch.write
{
"sourceSystem": "logistics_erp",
"batchId": "BATCH-2026-06-25-AM",
"operation": "upsert",
"targets": [
{
"externalId": "DEL-2026-000918",
"title": "Delivery to Rhein-Ruhr Medical Supply",
"address": {
"street": "Hachestrasse 12",
"postalCode": "45127",
"city": "Essen",
"country": "DE",
"latitude": 51.4513,
"longitude": 7.0116
},
"planning": {
"routeDate": "2026-06-25",
"estimatedWorkMinutes": 25,
"priority": "High"
},
"businessValue": {
"expectedRevenue": 2500
}
},
{
"externalId": "DEL-2026-000919",
"title": "Pickup at City Pharmacy",
"address": {
"street": "Kettwiger Strasse 35",
"postalCode": "45127",
"city": "Essen",
"country": "DE",
"latitude": 51.4564,
"longitude": 7.0123
},
"planning": {
"routeDate": "2026-06-25",
"estimatedWorkMinutes": 20,
"priority": "Medium"
}
}
]
}Partial failure response
{
"importJobId": 185,
"status": "PartiallyFailed",
"totalItems": 3,
"createdItems": 2,
"updatedItems": 0,
"cancelledItems": 0,
"rejectedItems": 1,
"warningItems": 0,
"items": [
{ "externalId": "DEL-2026-000918", "status": "Created", "targetId": 991, "warnings": [] },
{ "externalId": "DEL-2026-000919", "status": "Created", "targetId": 992, "warnings": [] },
{ "externalId": "", "status": "Rejected", "errorCode": "missing_external_id", "errorMessage": "ExternalId is required." }
]
}Partial success
A rejected item does not roll back successfully imported items. Use ImportJob details to inspect each item.