Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Info

Retrouvez également des informations dans la page du traitement d’intégration des règlements concernant les règles métier : Espace produit (par exemple Divalto infinity 10.11 -> Gérer ses règlements > Utilitaires et traitements du module règlement

Astuce

Selon votre version et service pack, l’utilitaire ERP prend en entrée un fichier au format JSON qui correspond uniquement aux informations métier du service web ou le format complet.

Versions à partir de 2025 : L’utilitaire sait traiter les 2 formats

Versions avant 2025 : La zone technique (action, acces_token, param) n’est pas traitée, et ne doit pas être donnée. C'est directement le contenu de “param” qui est attendu par cet utilitaire

image-20241122-101114.pngImage Added

Un mapping existe entre les noms de champs du dictionnaire et les noms de balise à utiliser

...

Balise

Contenu

error

Anomalie technique de l’appel du service web

0 = pas n’anomalie, autre valeur = anomalie

Dans ce cas la balise txterrindique le message d’erreur

result

Détail du résultat fonctionnel de l’appel du service web

resultcode= 0 => pas d’anomalie fonctionnelle la demande est bien traitée

resultcode<>0 => anomalie fonctionnelle/métier dont la raison est indiquée dans errormessage

La response contient notamment la réponse avec les éventuelles erreurs errormessage et la transaction générée dans transactionId

Exemple de réponse

...

languagejson
Bloc de code
languagejson
{
    "error": 0,
    "result": "{\"label\": \"infinity\",\"codeScript\": \"integration_reglement\",\"result\":{\"common\":{\"resultcode\": \"0\",\"errormessage\": \"Intégration règlements des échéances terminée |Consultez le livre de bord"},\"response\":\"transactionId\": \"1354\"}}",
    "txterr": "",
    "infos": ""
}

...

Remise en banque sans n° de transaction

...

Retour d’erreur multiples (V10.12)

Jusqu’en version 10.12, le retour (dans la réponse) se faisait dans un format unique, c’est à dire que seul une seule information remontait, par exemple le dernier numéro de transaction ou un message d’erreur unique en cas d’anomalie.

La version 10.12 introduit une modification

  • dans la réponse, qui retourne un TABLEAU JSON dans la “response”

  • dans la demande, qui peut indiquer un numéro pour faire le lien entre une demande et la réponse

Lors de la demande, la balise “REGLEMENTNUM” (numérique) peut être ajoutée dans l’entête EnteteReglement. Son utilisation aura pour effet

  • d'être sauvegardé dans l’entête de journal de la transaction générée dans l’onglet Identifiant sous le nom “N° de règlement JSON”

  • d'être retourné dans la réponse

Info

Le numéro REGLEMENTNUM doit au minimum être un incrément d’unicité à l’intérieur d’une demande JSON ; idéalement un numéro chrono chez l’appelant permet une meilleure traçabilité

Exemple de corps de demande avec REGLEMENTNUM en entête (ici 17 et 18)

Bloc de code
languagejson
'data':
	{
		'EnteteReglementtb': 
	[
		{
		'EnteteReglement': 
			{
			'PAYMENTTYPE'	:'ENCASHMENT',
			'CHGETAT'		:'REMCDI',
			'BQC'			:'BNP',
			'REGLEMENTNUM'	:'17',
			'LABEL'			:'Traitement sans N° transac',
			'DetailReglementtb': 
				[
					{
					'DetailReglement': 
						{
						'MTORI'			: '3400',
						'ETATORI'		: 'C30',
						'TIERS'			: 'C0000001'
						}
					},
					{
					'DetailReglement': 
						{
						'MTORI'			: '2400',
						'ETATORI'		: 'C30',
						'TIERS'			: 'C0000001'
						}
					}
				]
					
			}
		},
		{
		'EnteteReglement': 
			{
			'PAYMENTTYPE'	:'ENCASHMENT',
			'CHGETAT'		:'REMCDI',
			'BQC'			:'BNP',
			'REGLEMENTNUM'	:'18',
			'LABEL'			:'Traitement avec N° transac',
			'DetailReglementtb': 
				[
					{
					'DetailReglement': 
						{
						'TRANSAC'			: '661'
						}
					},
					{
					'DetailReglement': 
						{
						'TRANSAC'			: '508'
						}
					}
				]
					
			}
		}
	]
	}

Exemple de réponse à ce REGLEMENTNUM en entête (ici deux erreurs sur 17 et 18)

Le message est sous la forme :

  • Réussite : Règlement n°$1 : OK - La transaction $2 a été générée.

  • Echec : Règlement n°$1 : message d’erreur

...