Référence interne

=> Voir aussi la procédure n° 264 (Compteurs documents)

Fonctionnement de la référence interne

Pour rappel, la saisie/attribution de la référence interne est soumise au paramétrage défini dans chaque nature de document (cf. Natures de document / Divers).

Comportement de la référence interne dans les différents cas d’utilisation - Tableau récapitulatif

Le principe d’attribution de la référence interne dans les saisies, l'import et les Web Services Y2 est décrit ci-après, sous la forme d'un tableau récapitulatif.

Création de document

Type	Attribution automatique désactivée	Attribution automatique activée
Y2	Saisie manuelle. Unique sur option.	Facultative en saisie. Unique sur option. Nouveau n° unique si non saisi.
Import	Obligatoire dans le fichier d’import. Unique suivant format d’import ($$_PIECEUNIQUE).	Facultative dans le fichier d’import. Si présente, unique suivant format d’import ($$_PIECEUNIQUE). Nouveau n° unique si non présent.
WS	Obligatoire dans le contrat. Unique ($$_PIECEUNIQUE forcé). Erreur si non présente.	Facultative dans le contrat. Unique si présente ($$_PIECEUNIQUE forcé). Nouveau n° unique si non présente.

Transformation de document

Type	Attribution automatique désactivée	Attribution automatique activée
Y2	Reprise du document précédent.	Non reprise du document précédent.
Import	Recherche document à transformer : Rejet si référence interne non unique. Document généré : Non reprise du doc précédent. Obligatoire dans fichier d’import. Unicité en fonction du format d’import ($$_PIECEUNIQUE).	Recherche document à transformer : Rejet si référence interne non unique. Document généré : Non reprise du document précédent. Facultative dans le fichier avec unicité en fonction du format d’import ($$_PIECEUNIQUE). Nouveau n° unique si non fourni dans le fichier.
WS	Recherche document à transformer : Identifié par sa clé. Document généré : Facultative dans le contrat avec contrôle d’unicité si présente. Reprise du document précédent si non transmise.	Recherche document à transformer : Identifié par sa clé. Document généré : Facultative dans le contrat avec contrôle d’unicité si présente. Nouveau n° unique si non présente.

Transformation partielle de document

Type	Attribution automatique désactivée	Attribution automatique activée
Y2	Reprise du document précédent. Modifiable manuellement. Unique sur option.	Non reprise du document précédent. Saisissable manuellement avec unicité en fonction de la nature de document. Nouveau n° unique systématique si non saisi.
Import	Recherche document à transformer : Rejet si référence interne non unique. Document généré : Non reprise du doc précédent. Obligatoire dans fichier d’import. Unicité en fonction du format d’import ($$_PIECEUNIQUE).	Recherche document à transformer : Rejet si référence interne non unique. Document généré : Non reprise du document précédent. Facultative dans le fichier avec unicité en fonction du format d’import ($$_PIECEUNIQUE). Nouveau n° unique si non fourni dans le fichier.
WS	Recherche document à transformer : Rejet si référence interne non unique. Document généré : Facultative dans le contrat. Reprise du document précédent si non transmise. Contrôle d’unicité systématique. => Rejet sur seconde transformation si non transmise.	Recherche document à transformer : Rejet si référence interne non unique. Document généré : Facultative dans le contrat. Nouveau n° unique si non présente. Contrôle d’unicité systématique.

A retenir :

• Une référence interne unique est imposée pour les créations ou transformations de document par WS.

• La transformation est impossible si la référence interne n'est pas unique sur le document d’origine.

• Ajout de la référence interne, facultative, en transformation de document par WS.

Comportement de la référence interne dans les différents cas d'utilisation - Explication détaillée

Concernant l’import ou les transformations partielles par WS, dans le cas où plusieurs documents vivants existent avec la même référence interne, un contrôle bloquant empêche la transformation du document.

Transformation globale par WS

Fonctionnement décrit ci-dessous (hors documents Omnicanal).

Attribution automatique activée :

• Si la référence est transmise dans le contrat, elle est utilisée.

• Si non transmise, attribution d’une nouvelle référence interne par incrémentation du chrono de la nature de document.

• Son unicité est systématique.

Attribution automatique non activée :

• Si la référence est transmise dans le contrat, elle est utilisée.

• Si non transmise, elle est reprise du document précédent.

• Son unicité est systématique.

Transformation partielle dans Y2

Attribution automatique activée :

• Si non saisie, attribution d’une nouvelle référence interne par incrémentation du chrono de la nature de document.

• Contrôle d’unicité en fonction de la nature de document.

Si saisie, la référence interne peut ne pas être unique. Dans ce cas, la transformation du document généré par import ou WS avec cette référence interne sera rejetée car correspondant à 2 documents.

Attribution automatique non activée :

• La référence interne reprise du document d’origine ne sera pas unique lors de la seconde transformation partielle. Si cette référence n’est pas modifiée manuellement (ex : ajout d’un indice), cette seconde transformation partielle sera refusée en fonction du paramétrage.

• Si la seconde transformation partielle permet de reprendre la même référence interne, la transformation du document généré par import ou WS avec cette référence interne sera rejetée car correspondant à 2 documents.

Transformation partielle par import

Attribution automatique activée :

• Si non fournie dans le fichier, attribution d’une nouvelle référence interne par incrémentation du chrono de la nature de document.

• Contrôle d’unicité en fonction du format d'import.

Attribution automatique non activée :

• Obligatoire dans le fichier d’import.

• Contrôle d’unicité en fonction du format d’import.

Dans tous les cas, si $_PIECEUNIQUE n’est pas positionnée dans le format d’import, la référence interne fournie dans le fichier peut ne pas être unique. Dans ce cas, la transformation du document généré par import ou WS avec cette référence interne sera rejetée car correspondant à 2 documents.

Transformation globale par Web Services

Attribution automatique activée :

• Si la référence est transmise dans le contrat, elle est utilisée.

• Si non transmise, attribution d’une nouvelle référence interne par incrémentation du chrono de la nature de document.

• Son unicité est systématique.

Attribution automatique non activée :

• Si la référence est transmise dans le contrat, elle est utilisée.

• Si non transmise, elle est reprise du document précédent.

• Son unicité est systématique.

La référence interne fournie en entrée peut ne pas être unique en fonction du paramétrage de document. Dans ce cas, la transformation du document par import ou WS avec cette référence interne sera rejetée car correspondant à 2 documents.

Transformation partielle par Web Services

Attribution automatique activée :

• Si la référence est transmise dans le contrat, elle est utilisée et doit être unique.

• Si non transmise, attribution d’une nouvelle référence interne par incrémentation du chrono de la nature de document.

Attribution automatique non activée :

• Si la référence est transmise dans le contrat, elle est utilisée.

• Si non transmise, elle est reprise du document précédent.

• Elle doit être unique pour le tiers et la nature de document.

Attention ! La seconde transformation partielle sera refusée. Dans ce cas, il est nécessaire que le logiciel tiers envoie une référence interne unique, ou bien que l’attribution automatique soit cochée dans Y2.

Gestion mono document suivant

RAS