/api/v1/orders/upsert
POST
https://api-test.spotgo.eu/api/v1/orders/upsert
Uniqueness checked by orderNumber if the carrier information changed VATCode the unique link will be regenerated.
Always returns the link to the documents upload site.
Request
Body Params application/json; x-api-version=1.0
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api-test.spotgo.eu/api/v1/orders/upsert' \
--header 'Content-Type: application/json; x-api-version=1.0' \
--data '{
"orderNumber": "string",
"manager": {
"name": "string",
"email": "string"
},
"carrier": {
"name": "string",
"email": "string",
"vatCode": "string"
},
"internalComments": "string",
"details": {
"weight": 0,
"licensePlates": [
"string"
]
},
"pricing": {
"totalAmount": 1250.0,
"currency": "EUR"
},
"locations": [
{
"sequence": 0,
"type": "Loading",
"startDate": "2019-08-24T14:15:22.123Z",
"endDate": "2019-08-24T14:15:22.123Z",
"name": "string",
"countryCode": "st",
"postalCode": "string",
"city": "string",
"street": "string",
"position": {
"latitude": 0,
"longitude": 0
},
"weight": 24000,
"requiredDocuments": []
},
{
"sequence": 1,
"type": "Unloading",
"startDate": "2019-08-25T10:00:00.000Z",
"endDate": "2019-08-25T10:00:00.000Z",
"name": "string",
"countryCode": "st",
"postalCode": "string",
"city": "string",
"street": "string",
"position": {
"latitude": 0,
"longitude": 0
},
"weight": 24000,
"requiredDocuments": [
{
"internalId": "d4e5f6a7-b8c9-0123-def0-234567890123",
"type": "pod"
},
{
"internalId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"type": "cmr"
}
]
}
]
}'Response Response Example
200 - Example 1
{
"created": true,
"updated": true,
"linkChanged": true,
"order": {
"sequenceId": 0,
"status": "Succeeded",
"message": "string",
"errorCode": "string",
"data": {
"orderNumber": "string",
"orderDate": "2019-08-24T14:15:22.123Z",
"referenceNumber": "string",
"sentNumber": "string",
"licensePlates": [
"string"
],
"trailerTypes": [
"string"
],
"payer": {
"name": "string",
"vatCode": "string",
"country": "string",
"postalCode": "string",
"city": "string",
"street": "string",
"contactPerson": {
"name": "string",
"email": "string",
"phone": "string"
},
"internalId": "string",
"drivers": [
{
"name": "string",
"phone": "string"
}
]
},
"customer": {
"name": "string",
"vatCode": "string",
"country": "string",
"postalCode": "string",
"city": "string",
"street": "string",
"contactPerson": {
"name": "string",
"email": "string",
"phone": "string"
},
"internalId": "string",
"drivers": [
{
"name": "string",
"phone": "string"
}
]
},
"carrier": {
"name": "string",
"vatCode": "string",
"country": "string",
"postalCode": "string",
"city": "string",
"street": "string",
"contactPerson": {
"name": "string",
"email": "string",
"phone": "string"
},
"internalId": "string",
"drivers": [
{
"name": "string",
"phone": "string"
}
]
},
"customerBranch": {
"name": "string",
"vatCode": "string",
"country": "string",
"postalCode": "string",
"city": "string",
"street": "string",
"contactPerson": {
"name": "string",
"email": "string",
"phone": "string"
},
"internalId": "string",
"drivers": [
{
"name": "string",
"phone": "string"
}
]
},
"locations": [
{
"sequence": 0,
"group": 0,
"type": "Loading",
"startDate": "2019-08-24T14:15:22.123Z",
"endDate": "2019-08-24T14:15:22.123Z",
"fixTime": true,
"countryCode": "string",
"city": "string",
"normalizedCity": "string",
"postalCode": "string",
"street": "string",
"normalizedStreet": "string",
"name": "string",
"normalizedName": "string",
"refrenceNumbers": [
"string"
],
"notes": "string",
"coordinates": {
"latitude": 0,
"longitude": 0
},
"cargo": [
{
"cargoType": "string",
"weight": 0,
"ldm": 0,
"pallets": 0,
"palletsExchange": true,
"adr": true,
"stackable": true,
"temeratureFrom": 0,
"temeratureTo": 0,
"refrigeratorUnitMode": "Off",
"straps": 0,
"matts": 0,
"length": 0,
"width": 0,
"height": 0,
"units": "string",
"volume": 0,
"ftl": true,
"vin": "string",
"color": "string",
"cargoPlate": "string",
"productCode": "string"
}
],
"totalWeight": 0,
"totalQuantity": 0,
"containerNumber": "string",
"containerType": "string",
"tasCode": "string",
"tarCode": "string",
"tarValidity": "string"
}
],
"payments": {
"price": 0,
"basePrice": 0,
"additionalCharges": 0,
"paymentDays": 0,
"currency": "string",
"isVatInPln": true,
"totalNetAmount": 0,
"paymentMethod": "Card",
"priceBreakdown": [
{
"type": "string",
"quantity": 0,
"unitPrice": 0,
"amount": 0
}
]
},
"distance": "string",
"emptyDistance": "string",
"documentSubmissionMethods": [
"string"
],
"comments": "string",
"accountingComments": "string",
"driverComments": "string",
"invoiceEmail": "string",
"links": [
"string"
],
"penalties": "string",
"capabilities": [
"string"
],
"cargoValue": {
"value": 0,
"currency": "string"
},
"subcontractorPrice": 0,
"vehiclesLicensePlates": [
"string"
],
"trailersLicensePlates": [
"string"
],
"incoterms": "string"
},
"metadata": {
"property1": "string",
"property2": "string"
},
"orderSubType": "Regular"
}
}Modified at 2026-06-01 05:23:13