Documentație API
Remăsurători
Curierii cântăresc și măsoară coletele în depozit. Când rezultatul diferă de ce ai declarat, se înregistrează o remăsurătoare — iar prețul se poate corecta.
Lista remăsurătorilor
/expedition/remeasurementsBearer JWTParametri de interogare
| Câmp | Tip | Cerut | Descriere |
|---|---|---|---|
page | number | opțional | Numărul paginii, de la 1. |
limit | number | opțional | Câte înregistrări pe pagină. |
Rezultatele sunt ordonate descrescător după data înregistrării, deci cele mai noi apar primele. Fiecare înregistrare poartă expediția întreagă și măsurătorile pe fiecare pachet.
{
"data": [
{
"id": "e4a7c1b9-2d36-4f85-91c0-7b3e5a2d8f61",
"expeditionId": "9d1e5b77-4a02-4c31-8f6d-5b7e2a1c9043",
"declaredWeight": 2.4,
"measuredWeight": 3.1,
"declaredChargeableWeight": 4,
"isVolumetric": true,
"declaredPrice": 18.95,
"measuredPrice": 18.95,
"invoiceId": "f20c8a15-...",
"createdAt": "2026-10-29T03:12:00.000Z",
"updatedAt": "2026-10-29T03:12:00.000Z",
"parcelMeasurements": [
{
"id": "aa31...",
"weight": 3.1,
"length": 41,
"width": 30,
"height": 21,
"gravimetricWeight": 3.1,
"volumetricWeight": 4.3,
"createdAt": "2026-10-29T03:12:00.000Z"
}
]
}
],
"meta": { "total": 1, "page": 1, "limit": 50, "totalPages": 1 }
}Câmpurile care contează
| Câmp | Tip | Cerut | Descriere |
|---|---|---|---|
expeditionId | string | mereu | Expediția remăsurată. Există cel mult o remăsurătoare pe expediție. |
declaredWeight | number | mereu | Greutatea fizică declarată de tine, în kg. |
measuredWeight | number | null | opțional | Greutatea măsurată de curier. Null cât timp curierul nu a raportat-o. |
declaredChargeableWeight | number | null | opțional | Greutatea taxabilă pe care s-a calculat cotația: per pachet max(greutate, L×l×h/6000), însumată. Null pe înregistrările mai vechi. |
isVolumetric | boolean | mereu | True când cotația a fost calculată pe volum, nu pe greutatea fizică — adică greutatea taxabilă declarată a depășit-o pe cea fizică. |
declaredPrice | number | null | opțional | Prețul din cotația pe care ai acceptat-o, în RON. |
measuredPrice | number | null | opțional | Prețul recalculat pe măsurătorile curierului. Diferența față de declaredPrice este ce se corectează. |
invoiceId | string | null | opțional | Factura pe care a ajuns diferența. Null cât timp nu a fost încă facturată. |
parcelMeasurements | array | mereu | Măsurătorile pe pachet: weight, length, width, height, plus gravimetricWeight și volumetricWeight — cele două candidate dintre care se ia maximul. |
Citirea unei diferențe
Compară prețurile, nu greutățile. O greutate măsurată mai mare nu înseamnă automat un cost mai mare: dacă cotația a fost calculată pe volum, greutatea fizică poate crește fără să schimbe intervalul de tarifare.
// Diferența facturată este pe preț, nu pe greutate.
const delta = (m.measuredPrice ?? 0) - (m.declaredPrice ?? 0);
if (delta > 0) {
// Curierul a taxat mai mult decât cotația: diferența se facturează.
} else if (delta < 0) {
// Curierul a taxat mai puțin: diferența se întoarce la tine.
}
// measuredPrice null înseamnă "încă nu avem prețul de la curier",
// nu "zero". Tratează-l separat.Greutatea măsurată pe expediție
Dacă vrei doar greutatea finală a unei expediții, nu ai nevoie de ruta aceasta: GET /expedition/{id} poartă content.measuredTotalWeight. Ruta de remăsurători este pentru cazul în care te interesează detaliul și diferența de preț.
Explicația procesului, cu cum se calculează greutatea volumetrică și cum eviți diferențele, este în ghidul de recântărire.
Ai nevoie de ajutor?
Dacă o diferență de preț nu îți pare corectă, trimite-ne AWB-ul — putem arăta exact ce a raportat curierul.
Contactează-ne