Awb API
Calculate price
Example
Request:
curl --request PUT 'https://test.bauexpress.ro/api/awbs/quotes' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${access_token}' \
--data '${awb}'
Response:
[
{
"uuid": "b59803ca-e1cb-4545-be29-83aa7c1af814",
"courier": "FAN",
"shippingService": "Standard",
"price": {
"netAmount": 34.33,
"grossAmount": 40.85
},
"currency": "RON",
"timestamp": "2023-10-12T10:10:43.357944133Z"
},
{
"uuid": "905b0df5-42fc-4437-ba6c-fe2feec58f95",
"courier": "DPD",
"shippingService": "Classic",
"price": {
"netAmount": 161.55,
"grossAmount": 192.24
},
"currency": "RON",
"timestamp": "2023-10-12T10:10:43.810927916Z"
}
]
Create awb
Example
Request:
curl --request POST 'https://test.bauexpress.ro/api/awbs' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ${access_token}' \
--data '${awb}'
awb model:
{
"quoteRequest": {
"sender": {
"existingCustomer": {
"uuid": "91e6bfbb-847e-4bd8-b205-a37661f17d5b",
"active": true,
"type": "INDIVIDUAL",
"firstName": "Ion",
"lastName": "Ionescu",
"ssn": "54544654",
"vatPayer": false,
"displayName": "Ion Ionescu",
"phone": "0741852963",
"email": "ion.ion@gmail.com",
"contractEnabled": false,
"shippingPriceCoefficient": 1.4,
"address": {
"uuid": "734c792c-77f5-4497-8662-e12eaf6927b6",
"streetNumber": "34",
"postalCode": "515100",
"street": {
"name": "Abrudelului",
"postalCode": "515100"
},
"locality": {
"uuid": "2f90ed5e-a3ef-11ed-9428-0242ac130002",
"name": "Abrud",
"displayName": "Abrud",
"postalCode": "515100"
},
"county": {
"uuid": "2f04678a-a3ef-11ed-9428-0242ac130002",
"code": "AB",
"name": "Alba"
},
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
}
}
},
"existingPerson": null,
"name": "Ion Ionescu",
"phone": "0741852963",
"email": "ion.ion@gmail.com",
"address": {
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
},
"county": {
"uuid": "2f04678a-a3ef-11ed-9428-0242ac130002",
"code": "AB",
"name": "Alba"
},
"locality": {
"uuid": "2f90ed5e-a3ef-11ed-9428-0242ac130002",
"name": "Abrud",
"displayName": "Abrud",
"postalCode": "515100"
},
"street": {
"name": "Abrudelului",
"postalCode": "515100"
},
"streetNumber": "34",
"postalCode": "515100"
},
"contact": "Ion Ionescu"
},
"receiver": {
"existingCustomer": {
"uuid": "00d1657e-a415-4120-8740-0fca7a1e66fd",
"active": true,
"type": "INDIVIDUAL",
"firstName": "George",
"lastName": "Georgescu",
"ssn": "234234234",
"vatPayer": false,
"displayName": "George Georgescu",
"phone": "0741852963",
"email": "geo@gmail.com",
"contractEnabled": false,
"shippingPriceCoefficient": 1.4,
"address": {
"uuid": "e52bcf93-b8be-4691-9000-9c1c79ce0195",
"streetNumber": "434",
"postalCode": "600001",
"street": {
"name": "Abatorului",
"postalCode": "600001"
},
"locality": {
"uuid": "2f99b521-a3ef-11ed-9428-0242ac130002",
"name": "Bacau",
"displayName": "Bacau",
"postalCode": "600001"
},
"county": {
"uuid": "2f046dcf-a3ef-11ed-9428-0242ac130002",
"code": "BC",
"name": "Bacau"
},
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
}
}
},
"existingPerson": null,
"name": "George Georgescu",
"phone": "0741852963",
"email": "geo@gmail.com",
"address": {
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
},
"county": {
"uuid": "2f046dcf-a3ef-11ed-9428-0242ac130002",
"code": "BC",
"name": "Bacau"
},
"locality": {
"uuid": "2f99b521-a3ef-11ed-9428-0242ac130002",
"name": "Bacau",
"displayName": "Bacau",
"postalCode": "600001"
},
"street": {
"name": "Abatorului",
"postalCode": "600001"
},
"streetNumber": "434",
"postalCode": "600001"
},
"contact": "George Georgescu"
},
"envelopes": 0,
"parcels": 1,
"shipmentParcels": [
{
"weight": 1,
"height": null,
"width": null,
"length": null
}
],
"reference": null,
"content": null,
"observations": null,
"value": 0,
"pickupDate": "2023-10-12T09:52:44.726Z",
"ramburs": {
"enabled": false,
"amount": null,
"shippingPriceIncluded": null
},
"options": {
"checkOnDelivery": false,
"saturdayDelivery": false,
"morningDelivery": false,
"branchDelivery": false,
"signPaper": false,
"returnDocument": false,
"fragile": false,
"insurance": false,
"rambursAmountShippingIncluded": false
},
"customer": {
"uuid": "91e6bfbb-847e-4bd8-b205-a37661f17d5b",
"active": true,
"type": "INDIVIDUAL",
"firstName": "Ion",
"lastName": "Ionescu",
"ssn": "54544654",
"vatPayer": false,
"displayName": "Ion Ionescu",
"phone": "0741852963",
"email": "ion.ion@gmail.com",
"contractEnabled": false,
"shippingPriceCoefficient": 1.4,
"address": {
"uuid": "734c792c-77f5-4497-8662-e12eaf6927b6",
"streetNumber": "34",
"postalCode": "515100",
"street": {
"name": "Abrudelului",
"postalCode": "515100"
},
"locality": {
"uuid": "2f90ed5e-a3ef-11ed-9428-0242ac130002",
"name": "Abrud",
"displayName": "Abrud",
"postalCode": "515100"
},
"county": {
"uuid": "2f04678a-a3ef-11ed-9428-0242ac130002",
"code": "AB",
"name": "Alba"
},
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
}
}
}
},
"quoteResponse": {
"uuid": "b59803ca-e1cb-4545-be29-83aa7c1af814",
"courier": "FAN",
"shippingService": "Standard",
"price": {
"netAmount": 34.33,
"grossAmount": 40.85
},
"currency": "RON",
"timestamp": "2023-10-12T10:10:43.357944133Z"
}
}
Response:
{
"uuid": "51c5f3ab-4806-46ce-a983-bc7f39e4777d",
"courier": "FAN",
"awbNumber": "4285300016991",
"barcode": "4285300016991",
"sender": {
"uuid": "9ab40508-2c6e-4087-9dcf-4c2d45e9909f",
"name": "Ion Ionescu",
"email": "ion.ion@gmail.com",
"contact": "Ion Ionescu",
"phone": "0741852963",
"address": {
"uuid": "b3d87bf4-a5a0-46dd-a1a7-bf34727baadc",
"streetNumber": "34",
"postalCode": "515100",
"street": {
"name": "Abrudelului",
"postalCode": "515100"
},
"locality": {
"uuid": "2f90ed5e-a3ef-11ed-9428-0242ac130002",
"name": "Abrud",
"displayName": "Abrud",
"postalCode": "515100"
},
"county": {
"uuid": "2f04678a-a3ef-11ed-9428-0242ac130002",
"code": "AB",
"name": "Alba"
},
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
}
}
},
"receiver": {
"uuid": "ade66e6e-d4fe-4b86-ad78-cb2773d43204",
"name": "George Georgescu",
"email": "geo@gmail.com",
"contact": "George Georgescu",
"phone": "0741852963",
"address": {
"uuid": "4bfba959-0799-4bb6-ad3e-c609ab599f13",
"streetNumber": "434",
"postalCode": "600001",
"street": {
"name": "Abatorului",
"postalCode": "600001"
},
"locality": {
"uuid": "2f99b521-a3ef-11ed-9428-0242ac130002",
"name": "Bacau",
"displayName": "Bacau",
"postalCode": "600001"
},
"county": {
"uuid": "2f046dcf-a3ef-11ed-9428-0242ac130002",
"code": "BC",
"name": "Bacau"
},
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
}
}
},
"shipmentPayer": "SENDER",
"shippingService": "Standard",
"envelopes": 0,
"parcels": 1,
"weight": 1,
"height": 0,
"width": 0,
"length": 0,
"value": 0,
"pickupDate": "2023-10-12T09:52:44Z",
"pickupBy": "COURIER",
"deliveryDate": "2023-10-13T09:52:44Z",
"ramburs": false,
"rambursType": "ACCOUNT",
"branchDelivery": false,
"saturdayDelivery": false,
"morningDelivery": false,
"checkOnDelivery": false,
"signPaper": false,
"returnDocument": false,
"fragile": false,
"insurance": false,
"createdBy": "andrey_groza",
"customer": {
"uuid": "91e6bfbb-847e-4bd8-b205-a37661f17d5b",
"active": true,
"type": "INDIVIDUAL",
"firstName": "Ion",
"lastName": "Ionescu",
"ssn": "54544654",
"vatPayer": false,
"displayName": "Ion Ionescu",
"phone": "0741852963",
"email": "ion.ion@gmail.com",
"contractEnabled": false,
"shippingPriceCoefficient": 1.4,
"address": {
"uuid": "734c792c-77f5-4497-8662-e12eaf6927b6",
"streetNumber": "34",
"postalCode": "515100",
"street": {
"name": "Abrudelului",
"postalCode": "515100"
},
"locality": {
"uuid": "2f90ed5e-a3ef-11ed-9428-0242ac130002",
"name": "Abrud",
"displayName": "Abrud",
"postalCode": "515100"
},
"county": {
"uuid": "2f04678a-a3ef-11ed-9428-0242ac130002",
"code": "AB",
"name": "Alba"
},
"country": {
"uuid": "dd0311e7-0c31-11ea-8086-0242ac110002",
"code": "RO",
"name": "ROMANIA"
}
}
},
"price": {
"uuid": "a8dbe894-aac0-4726-9d7f-977f1f940a31",
"netPrice": 34.33,
"grossPrice": 40.85,
"vatAmount": 6.52,
"vatPercentage": 19,
"currency": "RON"
},
"lastTracking": {
"uuid": "fc80d2d6-0fd1-4e42-8444-506859314414",
"date": "2023-10-12T10:11:34.584359098Z",
"status": "Creat in sistem",
"cancelable": true,
"deletable": false
}
}
Get awb tracking
Example
Request:
curl --request GET 'https://test.bauexpress.ro/api/awbs/${uuid}/tracking' \
--header 'Authorization: Bearer ${access_token}'
Response:
[
{
"uuid": "9f9fcf16-21fa-4bd7-af00-8ae2583e0293",
"date": "2023-08-01T16:11:43Z",
"status": "Creat in sistem",
"cancelable": true,
"deletable": false
},
{
"uuid": "12bfe867-4ddc-44b6-a653-2e4fde92be3a",
"date": "2023-08-01T16:15:00Z",
"status": "AWB-ul a fost inregistrat de catre clientul expeditor.",
"cancelable": true,
"deletable": false
}
]
Cancel awb
Cancels the awb.
This operation is available only if cancelable flag from last awb tracking is true.
Example
Request:
curl --request POST 'https://test.bauexpress.ro/api/awbs/${uuid}/cancel' \
--header 'Authorization: Bearer ${access_token}'
Delete awb
Cancels the awb then deletes it.
This operation is available only if deletable flag from last awb tracking is true.
Example
Request:
curl --request DELETE 'https://test.bauexpress.ro/api/awbs/${uuid}' \
--header 'Authorization: Bearer ${access_token}'
Find awbs with tracking
Example
Request:
curl --request GET 'https://test.bauexpress.ro/api/awbs/trackings?awbNumbers=80299018575&awbNumbers=80299018450' \
--header 'Authorization: Bearer ${access_token}'
Response:
[
{
"awb": {
"courier": "FAN",
"awbNumber": "80299018575"
},
"awbTrackings": [
{
"uuid": "85daf3ef-5c66-4929-8a21-d5edc57191ae",
"date": "2023-10-09T06:43:58Z",
"status": "Creat in sistem",
"cancelable": true,
"deletable": false
},
{
"uuid": "9a2d8dc2-e531-4738-84ce-0f3b50e22a37",
"date": "2023-10-09T06:45:00Z",
"status": "AWB-ul a fost inregistrat de catre clientul expeditor.",
"cancelable": true,
"deletable": false
}
]
},
{
"awb": {
"courier": "DPD",
"awbNumber": "80299018450"
},
"awbTrackings": [
{
"uuid": "85daf3ef-5c66-4929-8a21-d5edc57191ae",
"date": "2023-10-09T06:43:58Z",
"status": "Creat in sistem",
"cancelable": true,
"deletable": false
},
{
"uuid": "9a2d8dc2-e531-4738-84ce-0f3b50e22a37",
"date": "2023-10-09T06:45:00Z",
"status": "AWB-ul a fost inregistrat de catre clientul expeditor.",
"cancelable": true,
"deletable": false
}
]
}
]
Export awb to pdf
Example
Request:
curl --request GET 'https://test.bauexpress.ro/api/awbs/${uuid}/pdf' \
--header 'Authorization: Bearer ${access_token}' \
--output awb.pdf
Export awbs to excel
Example
Request:
curl --request GET 'https://test.bauexpress.ro/api/awbs/export/excel' \
--header 'Authorization: Bearer ${access_token}' \
--output awbs.xlsx