Skip to main content
Qargo

Orders – meerdere verpakte items aan orders toevoegen.

Itemdetails voor niet-ADR-lading aan laadeenheden toevoegen en per pallet of verpakkingseenheid omschrijvingen, gewichten, afmetingen en barcodes bijhouden.

Inhoudsopgave
  1. Inleiding
  2. Terminologie
  3. De functie inschakelen
  4. Structuur van lading in Qargo
  5. Verpakte items aan een lading toevoegen
  6. Verpakte items via de externe API
  7. Prijsberekening met verpakte items
  8. Gebruiksscenario’s
  9. Beperkingen
  10. Probleemoplossing

Inleiding

  • Wat is deze functie?

    • Qargo ondersteunt nu gedetailleerde gegevens op itemniveau voor afzonderlijke laadeenheden (lading), naast de ADR-gegevens. Elke lading kan meerdere verpakte items bevatten. Elk item heeft velden voor omschrijving, hoeveelheid, gewicht, volume, afmetingen (lengte, breedte, hoogte), barcodes en verpakkingstype. Zo kunnen transportbedrijven precies vastleggen wat er op elke pallet of verpakkingseenheid staat.
  • Waarom is deze functie ingevoerd?

    • Transportbedrijven krijgen van klanten vaak gedetailleerde informatie over de inhoud van elke pallet. Dat gaat niet alleen over gevaarlijke goederen, maar ook over productomschrijvingen, gewichten en hoeveelheden. Vroeger waren itemdetails op laadeenheden beperkt tot ADR-lading. Gebruikers moesten informatie over niet-ADR-items daardoor buiten Qargo beheren of de beperking omzeilen met aangepaste velden. Deze functie brengt volledige tracking op itemniveau in het standaard werkproces voor lading.
  • Hoe werkt het?

    • De functie wordt ingeschakeld via de functievlag Verpakkingsitems op tenantniveau (alleen Qargo admin).
    • Zodra de functie actief is, verschijnt een sectie Verpakte items bij niet-ADR-lading tijdens de orderinvoer en op de detailpagina van de order. Items kunnen manueel in de webapp worden toegevoegd of via de externe API worden geïmporteerd. Daarnaast is er een nieuwe metriek voor prijsberekening, Hoeveelheid verpakte items, beschikbaar voor de configuratie van prijslijsten.

Terminologie

Term Definitie
Lading Een regel op een order die een verzameling laadeenheden voorstelt, bijvoorbeeld “3 europallets”. Bepaalt het verpakkingstype, de totale hoeveelheid, het gewicht en het volume.
Laadeenheid (Cargo Trace) Eén fysieke eenheid binnen een lading, bijvoorbeeld één afzonderlijke pallet. Laadeenheden kunnen barcodes hebben en worden automatisch aangemaakt op basis van de hoeveelheid van de lading.
Verpakt item (ladingitem) De inhoud van een laadeenheid, bijvoorbeeld “10 dozen elektronica” op één pallet. Vroeger beperkt tot ADR-items; nu worden ook niet-ADR-items ondersteund. In sommige contexten ook cargo sub item genoemd.
ADR-item Een verpakt item met gegevens over gevaarlijke goederen (UN-nummer, classificatie, verpakkingsgroep). Vóór deze functie waren ADR-items het enige ondersteunde type ladingitem.
Verpakkingstype Het type verpakking van de lading, bijvoorbeeld europallet, halve pallet of rolcontainer. Wordt in de systeemconfiguratie als vooraf gedefinieerde verpakkingsgrootte vastgelegd.
Functievlag Een toggle in de configuratie op tenantniveau waarmee specifieke functionaliteit wordt in- of uitgeschakeld. De functievlag Verpakkingsitems moet ingeschakeld zijn om deze functie te laten verschijnen.\
Activering door een Qargo admin is vereist. Voor hulp contact opnemen met Qargo support of de accountmanager.
Hoeveelheid verpakte items Een nieuwe metriek voor prijsberekening op prijslijsten. Stelt het totale aantal verpakte items voor over alle ladingen op een order.

De functie inschakelen

De functie Verpakkingsitems zit achter een functievlag en staat standaard uit. De functie moet op tenantniveau worden ingeschakeld (alleen Qargo admin) voordat velden voor verpakte items zichtbaar worden.

De functievlag activeren (alleen Qargo admin)

  1. Navigeren naar Configuratie > Instellingen organisatie > Functies
  2. De vlag Verpakkingsitems in de lijst zoeken.
  3. De toggle inschakelen om de functie voor de tenant te activeren.
  4. Klikken op Opslaan.

Na het inschakelen verschijnt de sectie Verpakte items bij alle niet-ADR-lading tijdens de orderinvoer en op bestaande detailpagina’s van orders.


Structuur van lading in Qargo

De ladingstructuur met drie niveaus is essentieel om met verpakte items te werken:

Niveau 1: lading

Het bovenste niveau stelt een verzameling laadeenheden voor. Bijvoorbeeld: 3 europallets, totaalgewicht 1.500 kg. Dit niveau is zichtbaar in het overzicht van de order en de meeste gebruikers werken ermee bij het aanmaken van orders.

Niveau 2: laadeenheid (Cargo Trace)

Elke afzonderlijke fysieke eenheid binnen een lading. Bijvoorbeeld: pallet 1 van 3. Laadeenheden worden automatisch aangemaakt op basis van de hoeveelheid van de lading en kunnen een barcode voor tracking hebben.

Niveau 3: verpakt item (ladingitem)

De inhoud van een laadeenheid. Bijvoorbeeld: 5 dozen met laptops, gewicht 250 kg. Deze functie breidt dit niveau uit: vroeger was het beperkt tot ADR-items, nu ondersteunt het ook algemene productinformatie.


Verpakte items aan een lading toevoegen

Bij het aanmaken van een order

  1. Het invoerformulier van de order openen en een lading met het gewenste verpakkingstype en de gewenste hoeveelheid toevoegen.

  2. De lading uitklappen om de sectie Verpakte items te tonen (alleen zichtbaar als de functievlag ingeschakeld is).

  3. Klikken op de knop Item toevoegen om een nieuwe rij voor een verpakt item aan te maken.

  4. De relevante velden voor het item invullen:

    • Omschrijving: een tekstuele omschrijving van de inhoud van het item
    • Hoeveelheid: het aantal eenheden van dit item
    • Gewicht: het gewicht van het item
    • Volume: het volume van het item
  5. Dit naar wens herhalen voor extra items op dezelfde lading.

Op een bestaande order

  1. Navigeren naar de detailpagina van de order.
  2. De relevante lading in de sectie Lading uitklappen.
  3. Klikken op Item toevoegen in de subsectie Verpakte items.
  4. De itemdetails invoeren en opslaan.


Verpakte items via de externe API

Gegevens van verpakte items worden volledig ondersteund via de externe API. Zo kunnen itemdetails op orders automatisch worden geïmporteerd en geëxporteerd.

De volgende velden zijn via de API beschikbaar voor verpakte items:

  • description: omschrijving van het item
  • quantity: aantal eenheden
  • weight: gewicht van het item
  • volume: volume van het item
  • unit_height_m: hoogte in meter
  • unit_width_m: breedte in meter
  • unit_length_m: lengte in meter
  • barcodes: array met barcodewaarden
  • packaging_type: classificatie van de verpakking

Deze velden kunnen worden gebruikt bij het aanmaken of bijwerken van orders via de API. Zo kunnen integratiepartners en geautomatiseerde werkprocessen gegevens op itemniveau rechtstreeks invullen.


Prijsberekening met verpakte items

Een nieuwe metriek voor prijsberekening, Hoeveelheid verpakte items, kan op prijslijsten worden gebruikt. Deze metriek stelt het totale aantal verpakte items voor over alle ladingen op een order. Zo zijn regels voor prijsberekening mogelijk op basis van het aantal items, en niet alleen op basis van het aantal laadeenheden.

De metriek configureren

  1. Navigeren naar de configuratie van de prijslijst.
  2. Een nieuwe berekening of voorwaarde toevoegen.
  3. De metriek Hoeveelheid verpakte items selecteren in de lijst met beschikbare metrieken.
  4. De regel voor prijsberekening naar wens configureren (bv. een toeslag per item of een gestaffelde prijsstructuur).


Gebruiksscenario’s

Palletinhoud bijhouden voor trips met meerdere ladingen

Als lading niet in één vrachtwagen kan worden vervoerd, kan elk verpakt item afzonderlijk worden gevolgd om op te volgen wanneer en hoe het wordt vervoerd. Dit is vooral nuttig bij deelladingen, waarbij verschillende pallets met verschillende voertuigen of via verschillende routes kunnen worden vervoerd.

Gedetailleerde ladinginformatie van klanten

Sommige klanten geven per pallet details op itemniveau, bijvoorbeeld “Pallet 1: 500 kg van product A; pallet 2: 1.000 kg van product B”. Met verpakte items kan deze informatie rechtstreeks in Qargo worden vastgelegd in plaats van in spreadsheets of externe systemen.

Gedifferentieerde ladingomschrijvingen

Lading kan nu worden opgedeeld in specifiekere onderdelen met gedetailleerde informatie per item. Zo is de exacte inhoud eenvoudiger te communiceren aan chauffeurs, onderaannemers en ontvangers van de levering.


Beperkingen

  • De functie zit achter de functievlag Verpakkingsitems: die moet per tenant worden ingeschakeld voordat velden voor verpakte items zichtbaar worden. (Qargo admin)
  • Verpakte items worden nog niet in alle delen van de applicatie getoond (ze verschijnen bijvoorbeeld niet in de kolommen van de orderlijst).
  • De functie geldt alleen voor niet-ADR-lading. ADR-lading blijft het bestaande werkproces voor ADR-items gebruiken.
  • Lading omzetten tussen het formaat laadeenheid en het formaat verpakt item wordt nog niet ondersteund.
  • De metriek Hoeveelheid verpakte items ondersteunt nog geen prijsberekening per item (PER_GOOD_ITEM). Ze is alleen beschikbaar als metriek voor de totale hoeveelheid.

Probleemoplossing

Probleem Oplossing
De sectie Verpakte items is niet zichtbaar bij lading Contact opnemen met Qargo support of de accountmanager om te bevestigen dat de functievlag Verpakkingsitems op tenantniveau ingeschakeld is, onder Configuratie > Functievlaggen. De sectie verschijnt alleen als de vlag actief is.
Sommige velden (bv. afmetingen, barcodes) zijn niet zichtbaar bij verpakte items Bepaalde velden zijn standaard uitgeschakeld. De configuratie van de standaardvelden controleren om extra velden voor verpakte items in te schakelen.
Verpakte items verschijnen niet na een import via de API Controleren of het API-verzoek de juiste veldnamen bevat (unit_height_m, unit_width_m, unit_length_m, barcodes, packaging_type). Nagaan of de functievlag op de doeltenant ingeschakeld is.
De metriek Hoeveelheid verpakte items is niet beschikbaar op prijslijsten Deze metriek wordt beschikbaar zodra de functievlag ingeschakeld is. Als de vlag pas geactiveerd is, de configuratiepagina van de prijslijst vernieuwen.
Verpakte items zijn zichtbaar bij ADR-lading Dit is niet de bedoeling. Verpakte items horen alleen bij niet-ADR-lading te verschijnen. Als ADR-lading een sectie voor verpakte items toont, controleren of de ADR-classificatie van de lading correct ingesteld is.
Verpakte items toevoegen gaat traag of reageert niet Een groot aantal verpakte items op één lading kan de prestaties beïnvloeden. Bij problemen kan een opsplitsing van de items over meerdere ladingen helpen, als dat operationeel zinvol is.