API RF SCE_GE_001

  Version ACE : 1.4

Package : Standard

Sous-programme Basic : gnc_sce_ge_001

Fonctionnalité :SCE Mobile
Schémas d’entrée et de sortie : voir en fin de document.

Cette API permet de charger une unité d'expédition dans une tournée d'expédition.

API imbriquées : aucune.

Contraintes et limites de fonctionnement (hors périmètre)

RAS.

Paramétrage (PPE)

RAS.

Cas d'erreur

CODE PARAMÈTRE DESCRIPTION
0/ELT_PASTRO ltrn.typtie, ltrn.sigtie, ltrn.idtrn The expedition tour does not exist.
0/ELT_PASTRO lcol.typtie, lcol.sigtie, lcol.idobjcol The parcel does not exist.
0/ERR_MODIF Ltrn, ltrn.typtie, ltrn.sigtie, ltrn.idtrn The expedition tour is not modified.
0/ERR_MODIF Lcol, lcol.typtie, lcol.sigtie, lcol.idobjcol The parcel is not modified.

Détail de l'API

Read the expedition tour data (LTRN), which corresponds to the input parameters (‘typdep’, ‘sigdep’, ‘idtrn’).

If the corresponding data does not exist, the API returns an error message “ELT_PASTRO” and an error code 0.

Read the parcel data (LCOL), which corresponds to the input parameters (‘typdep’, ‘sigdep’, ‘idobjcol’).

If the corresponding data does not exist, the API returns an error message “ELT_PASTRO” and an error code 0.

If the parcel does not belong to the expedition tour (LCOL.idtrn !=LTRN.idtrn).

If the parcel belongs to a different expedition tour (LCOL.idtrn != 0).

/* Deallocate the parcel from that expedition tour. */

Read the expedition tour data (LTRN), which corresponds to the parcel (‘typdep’, ‘sigdep’ and idtrn = LCOL.idtrn).

If the expedition tour does not exist, the API returns an error message “ELT_PASTRO” and an error code 0.

If the parcel data corresponds to an expedition unit of parcel type (lcol.flgcolis = '1').

Update the theoretical cumulative fields ‘weight’ and ‘volume’ for the expedition tour (poids -= lcol.poidstheo, volume -= lcol.volume).

Update the real cumulative fields ‘weight’ and ‘volume’ for the expedition tour (poidsreel -= LCOL.poidsreel, volumereel -= LCOL.volume).

If the stock level code of the parcel is not empty, decrease the real numbers of the homogeneous and heterogeneous pallets with 1 (ltrn2.nbpalhomreel -= 1, ltrn2.nbpalhetreel -= 1).

If the parcel data corresponds to an expedition unit (lcol.flgue = '1').

Update the number of the expedition units and the real number of the expedition units for the expedition tour (ltrn2.nbue -= 1, ltrn2.nbureel -= 1).

If the update of the expedition tour data related to the parcel is not successful, the API returns an error message “ERR_MODIF” and an error code 0

/* Assign the parcel to the expedition tour received as an input parameter (idtrn). */

If the parcel data corresponds to an expedition unit of parcel type (LCOL.flgcolis = '1').

Update the theoretical cumulative fields ‘weight’ and ‘volume’ for the expedition tour (ltrn2.poids += lcol.poidstheo, ltrn2.volume += lcol.volume).

Update the real cumulative fields ‘weight’ and ‘volume’ for the expedition tour (ltrn2.poidsreel += lcol.poidsreel, ltrn2.volumereel += lcol.volume).

If the stock level code of the parcel is not empty, increase the real numbers of the homogeneous and heterogeneous pallets with 1 (ltrn2.nbpalhomreel += 1, ltrn2.nbpalhetreel += 1).

If the parcel data corresponds to an expedition unit (lcol.flgue = '1').

Update the number of the expedition units and the real number of the expedition units for the expedition tour (ltrn2.nbue += 1, ltrn2.nbureel += 1).

If the update of the expedition tour data related to the input parameter ‘idtrn’ is not successful, the API returns an error message “ERR_MODIF” and an error code 0

Update the expedition tour identifier for the parcel (LCOL.idtrn).

If the modification is not successful, the API returns an error message “ERR_MODIF” and an error code 0.

Paramètres en entrée

NOM DU PARAMÈTRE FORMAT OBL O/N REMARQUE
typdep Char(3) O Depot type
sigdep Char(12) O Depot ID
idtrn Number O Expedition tour ID
idobjcol Char(18) O Parcel object ID

Paramètres en sortie

Aucun.