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.

SOMMAIRE

Sommaire
stylenone

Intégration de règlements

...

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.7 11 -> Gérer ses règlements > Utilitaires et traitements du module règlement

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

Table RGLTJNLENT (EnteteReglement)

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

Table RGLTJNLENT (EnteteReglement)

Nom de balise

Nom de champ

Obligatoire

Remarque

PAYMENTTYPE

reglttyp

OUI

ENCASHMENT=1, DISBURSEMENT=2

THIRDPARTY

tiers

OUI

AMOUNT

MtDev

OUI

Montant en devise

LABEL

LibEcr

Libellé de l'écriture associée à la transaction crée

DATE

transacDt

Date de la transaction. Si absente date de traitement du fichier

CURRENCY

Dev

OUI

FINALSTATEMENT

EtatFin

OUI

Etat final

CHECK=C30, CHECKINBANK=C50, TRANSFERT=V30, TRANSFERTINBANK=V50, SEPATRANSFERT=S30, SEPATRANSFERTINBANK=S50, INTERNATIONALVIREMENT=I30, INTERNATIONALVIREMENTINBANK=I50, DIRECTDEBIT=D30, DIRECTDEBITINBANK=D50

CHGETAT

CHGETAT

OUI

Code du changement d'état à utiliser

TRANSAC

Voir le chapitre dédié plus bas. Attention usage selon règlement (factures ou remise en banque)

NOORDRE

Table RGLTJNLDET (DetailReglement)

Nom de balise

Nom de champ

Obligatoire

Remarque

THIRDPARTY

tiers

OUI

AMOUNT

MTDEVFIN

OUI

OPERATION

NatureOperation

OUI

PAYMENT=(blank), RegltDiff=WDR, ChangeDiff=WDC, Escompte=WE, Acompte=WAR, PARTIALPAYMENT=WPA

PREFIX

PrefPiece

OUI

Obligatoire si gestion des prefixes

PIECE

Piece

OUI

DUEDATE

EchOriDt

Exemple de corps

...

languagejson

...

TRANSAC

Voir le chapitre dédié plus bas. Attention usage selon règlement (factures ou remise en banque)

NOORDRE

Intégration de facture

La constitution d’une fichier d’intégration de facture doit suivre les règles métier.

Quelques précisions

  • La somme des détails doit toujours être égal au montant de l'échéance d’origine de la facture

  • Le NatureOperation = ' ' dans un détail indique de prendre la nature du règlement prévu

  • Les champs TRANSAC et NOORDRE de l’entête de règlement ont un impact fort sur l’intégration

    • Un numéro TRANSAC différent (par exemple 1 puis 2) donnera un traitement distinct des transactions pour obtenir des écritures séparées

    • Un numéro NOORDRE permet d’indiquer une chronologie au sein d’un même TRANSAC

Exemple de corps
Bloc de code
languagejson
'data':{
	'EnteteReglementtb': 
	[
		{
		'EnteteReglement': 
			{
			'ETB'			: '',
			'TRANSACDT'	: '20210320',
			'DEV'			: 'EUR',
			'TIERS'		: 'C0000007',
			'MTDEV'			: '5995',
			'LIB'			: 'Règlement',	
			'RegltTyp'	: '1',		
			'ChgEtat'	: 'PORCHQ',
			'EtatFin'	: 'C30',
			'DetailReglementtb': 
				[
					{
					'DetailReglement': 
						{
						'MTDEVFIN'			: '3595',
						'PREFPIECE'			: ' ',
						'PIECE'				: '87',	
						'TIERS'				: 'C0000007',
						'NatureOperation'	: ' '
						}
					},
					{
					'DetailReglement': 
						{
						'MTDEVFIN'			: '2400',
						'PREFPIECE'			: ' ',
						'PIECE'				: '86',	
						'TIERS'				: 'C0000007',
						'NatureOperation'	: ' '
						}
					},
					{
					'DetailReglement': 
						{
						'MTDEVFIN'			: '5',
						'PREFPIECE'			: ' ',
						'PIECE'				: '87',	
						'TIERS'				: 'C0000007',
						'NatureOperation'	: 'WDR'
						}
					}
				]
					
			}
		},
		{
		'EnteteReglement': 
			{
			'ETB'			: '',
			'TRANSACDT'	: '20210320',
			'DEV'			: 'EUR',
			'TIERS'		: 'C0000003',
			'MTDEV'			: '5000',
			'LIB'			: 'Règlement',	
			'RegltTyp'	: '1',		
			'ChgEtat'	: 'PORCHQ',
			'EtatFin'	: 'C30',
			'DetailReglementtb': 
				[
					{
					'DetailReglement': 
						{
						'MTDEVFIN'			: '5000',
						'PREFPIECE'			: ' ',
						'PIECE'				: '',	
						'TIERS'				: 'C0000003',
						'NatureOperation'	: 'WAR'
						}
					}
				]				
			}
		}
	]
}

Exemple complet flux JSON
Bloc de code
languagejson
{ 
    "action":"WEB_SERVICE_INFINITY",
    "access_token":"{{TOKEN}}",
    "param":"
        {
        'action': {
			'swinfinity': 'integration_reglement',
			'parameters': 
              {
				'doscpt': '998',
				'dos': '998',
                			  'etb': '1'}
			    }
       
			},
     
  'data':
            {
                {
		'EnteteReglementtb': 
		[
			{
			'EnteteReglement': 
				{
				'ETB'			: '',
				'TRANSACDT'	: '20210320',
				'DEV'			: 'EUR',
				'TIERS'		: 'C0000007',
				'MTDEV'			: '5995',
 [
                    {
                    'EnteteReglement': 
                        {
                        'ETB				'LIB'			: 'Règlement',	
				'RegltTyp'	: '1',		
				'ChgEtat'	: 'PORCHQ',
				'EtatFin'	: 'C30',
				'DetailReglementtb': 
					[
						{
						'DetailReglement': 
							{
							'MTDEVFIN'			: '3595',
							'PREFPIECE'			: ' ',
                        'TRANSACDT'	: '20210320',
                        'DEV'			: 'EUR',
                        'TIERS'		: 'C0000007',
                        'MTDEV							'PIECE'				: '87',	
							'TIERS'				: 'C0000007',
							'NatureOperation'	: ' '
							}
						},
						{
						'DetailReglement': 
							{
							'MTDEVFIN'			: '59952400',
							'PREFPIECE'			: '                       'LIB'',
							'PIECE'				: 'Règlement86',	
                        'RegltTyp'	: '1',		
                        'ChgEtat'	: 'PORCHQ',
                        'EtatFin'	: 'C30',
                        'DetailReglementtb': 
                            [
                       							'TIERS'				: 'C0000007',
							'NatureOperation'	: ' '
							}
						},
						{
						'DetailReglement': 
							{
							'MTDEVFIN'			: '5',
							'PREFPIECE'			: ' ',
							'PIECE'				: '87',	
							'TIERS'				: 'C0000007',
							'NatureOperation'	: 'WDR'
							}
						}
					]
						
				}
			},
			{
			'EnteteReglement': 
				{
				'ETB'			: '',
				'TRANSACDT'	: '20210320',
				'DEV'			: 'EUR',
				'TIERS'		: 'C0000003',
				'MTDEV'			: '5000',
				'LIB'			: 'Règlement',	
				'RegltTyp'	: '1',		
				'ChgEtat'	: 'PORCHQ',
				'EtatFin'	: 'C30',
				'DetailReglementtb': 
					[
						{
						'DetailReglement': 
							{
							'MTDEVFIN'			: '5000',
							'PREFPIECE'			: ' ',
							'PIECE'				: '',	
							'TIERS'				: 'C0000003',
							'NatureOperation'	: 'WAR'
							}
						}
					]				
				}
			}
		]
      }
 {                                 'DetailReglement': 
                                    {
                    }"
}

Compléments intégration facture - règlement multiple

Exemple d’utilisation TRANSAC et NOORDRE

Dans le cas de 2 entêtes de règlement dans le même fichier JSON pour régler une même facture, par exemple 1900€ à régler avec 1000€ espèce et 900 par chèque, il faudra

  • Regrouper nécessairement les 2 entêtes dans un même numéro TRANSAC

  • Utiliser le NOORDRE pour imposer l’ordre de traitement (donc 1 puis 2)

  • Donner le premier entête avec le premier règlement (dans l’exemple 1000€ espèce) ET un reste WPA de l'écart au montant de l'échéance d’origine (ici 900€ de WPA)

  • Donner le second entête avec le second règlement (dans l’exemple 900€ chèque)

Exemple flux complet JSON pour deux règlements
Bloc de code
languagejson
{
'action': {'swinfinity': 'integration_reglement',
'parameters': 
        {
	'doscpt':     'MTDEVFIN'			'998',
	'dos': '3595998',
          'etb': '1'
    }        
},
  'data':
      {
  'PREFPIECE'			: ' ',        'EnteteReglementtb': 
          [
              {
              'PIECEEnteteReglement'				: 
'87',	                  {
                  'TIERSETB'				: 'C0000007',
                  'TRANSACDT'	: '20241020',
                  'NatureOperationDEV'			: ' EUR',
                  'TIERS'		: 'C0000004',
                }      'MTDEV'			: '1000',
                  'LIB'			: 'Règlement 1',	
     },             'RegltTyp'	: '1',		
                  {
'ChgEtat'	: 'PORESP',
                  'EtatFin'	: 'E30',
				  'Transac'	: '1',
				  'Noordre'	: '1',
   'DetailReglement':               'DetailReglementtb': 
                     { [
                          {
        'MTDEVFIN'			: '2400',                  'DetailReglement': 
                      'PREFPIECE'			: ' ',      {
                              'PIECEMTDEVFIN'				: '861000',	
 
                                  'TIERSPREFPIECE'				: 'C0000007 ',
    
                               'NatureOperationPIECE'				: ' 10002797',	
                              'TIERS'				: 'C0000004',
    }                          'NatureOperation'	: ' '
     },                         }
       {                   },
             'DetailReglement':             {
                          'DetailReglement': 
                        {      {
                              'MTDEVFIN'			: '5900',
     
                              'PREFPIECE'			: ' ',
     
                              'PIECE'				: '8710002797',	

                                   'TIERS'				: 'C0000007C0000004',
                                    'NatureOperation'	: 'WDRWPA'
                              }
     }                     },
           }           ]
                 ]         
                  }
              },
              }{
              'EnteteReglement': 
    },              {
      {            'ETB'			: '',
       'EnteteReglement':           'TRANSACDT'	: '20241020',
             {     'DEV'			: 'EUR',
                  'ETBTIERS'			: 'C0000004',
     
                  'TRANSACDTMTDEV'			: '20210320900',
   
                    'DEVLIB'			: 'EURRèglement 2',	
                        'TIERS'RegltTyp'		: 'C00000031',
     		
                  'MTDEVChgEtat'			: '5000PORCHQ',
                  'EtatFin'	: 'C30',
				    'LIBTransac'			: 'Règlement1',
				     'Noordre'	: '2',
                   'RegltTypDetailReglementtb'	: '1',		
                      [
 'ChgEtat'	: 'PORCHQ',                        {
'EtatFin'	: 'C30',                         'DetailReglementtbDetailReglement': 
                            [  {
                              {
 'MTDEVFIN'			: '900',
                              'DetailReglementPREFPIECE'			: ' ',
                                   {'PIECE'				: '10002797',	
                                     'MTDEVFIN''TIERS'				: '5000C0000004',
     
                              'PREFPIECENatureOperation'			: ' ',
                              }
     'PIECE'				: '',	                      }
              'TIERS'				: 'C0000003',       ]				
                  }
          'NatureOperation'	: 'WAR'   }
          ]
      }
  }
Exemple flux complet JSON pour deux règlements avec escompte

A noter que dans ce exemple, le TRANSAC est différent, ce qui donnera 2 transactions distinctes

Bloc de code
  {
  'action': {'swinfinity': 'integration_reglement',
  'parameters': 
 }   {
	'doscpt': '998',
	'dos': '998',
          'etb': '1'
    }        
},
  'data':
      {
          'EnteteReglementtb': 
      ]				    [
              {
                'EnteteReglement': 
                  {
        }          'ETB'			: '',
         }         'TRANSACDT'	: '20241020',
       ]           'DEV'			: 'EUR',
   }         }"
}

Format de la réponse :

...

Balise

...

Contenu

...

error

Anomalie technique de l’appel du service web

0 = pas n’anomalie, autre valeur = anomalie

...

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

...

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": ""
}

Intégration de remise en banque

Intégration par fichier JSON de transaction de type remise en banque est disponible. Exemple opération de type C30 → C50 (remise en banque de chèques en portefeuille)

  • à partir de la version X.7 service pack 217e

  • à partir de la version X.9 service pack 219c

  • à partir de la version X.10 service pack 220b

  • à partir de la version X.11 service pack 221a

Si l'état final de type n’est pas un virement et est associé à un bordereau, il faudra passer par l'étape de confection du bordereau pour générer l'écriture associée à la transaction créée.
Si l'état final de type remise est un virement ou n'est pas associé à un bordereau, l'écriture associée à la transaction créée est générée lors du traitement du fichier JSON .

Donnée à mettre dans le fichier JSON

Dans RGLTJNLENT (EnteteReglement) on doit définir

  • La devise et le montant total de la transaction à effectuer (Facultatif ). Si présent le total des transactions (DetailReglement) sera comparé à ce montant.

  • Le type de règlement (PAYMENTTYPE) 1 Encaissement, 2 décaissement. (Obligatoire)

  • le code du changement d'état à utilisé (Obligatoire)

  • la banque de destination (Obligatoire)

Dans RGLTJNLDET (DetailReglement)

Il faut renseigner

  • soit un n° de transaction correspondant à le remise en portefeuille

    • TRANSAC : le n° de la transaction qui à permis la passage de la position 1 à la position 2 (Ex : transaction de remise en portefeuille de chèque)

    • NOORDRE : le n° d’ordre n’est pas obligatoire (N° 1 pris par défaut)

  • soit des informations permettant de retrouver la transaction. SI plusieurs transactions correspondent aux critères fournis on prend celle avec le N° le plus petit

    • TIERS (THIRDPARTY) : Code tiers

    • ETATORI : Etat des règlements à traiter. Doit correspondre à un des état d’entrées possible pour le changement d'état précisé dans l’entête

    • MTORI : Montant de la transaction en devise du dossier

    • ou MTDEVORI (AMOUNT) montant en devise et DEV (CURRENCY) : devise

Exemple de fichier

Avec N° de transaction

...

Sans n° de transaction

...

      'TIERS'		: 'C0000004',
                  'MTDEV'			: '980',
                  'LIB'			: 'Règlement 1',	
                  'RegltTyp'	: '1',		
                  'ChgEtat'	: 'PORESP',
                  'EtatFin'	: 'E30',
				  'Transac'	: '1',
				  'Noordre'	: '1',
                  'DetailReglementtb': 
                      [
                          {
                          'DetailReglement': 
                              {
                              'MTDEVFIN'			: '980',
                              'PREFPIECE'			: ' ',
                              'PIECE'				: '10002797',	
                              'TIERS'				: 'C0000004',
                              'NatureOperation'	: ' '
                              }
                          },
                          {
                          'DetailReglement': 
                              {
                              'MTDEVFIN'			: '918.20',
                              'PREFPIECE'			: ' ',
                              'PIECE'				: '10002797',	
                              'TIERS'				: 'C0000004',
                              'NatureOperation'	: 'WPA'
                              }
                          },
                          {
                          'DetailReglement': 
                              {
                              'MTDEVFIN'			: '20',
                              'PREFPIECE'			: ' ',
                              'PIECE'				: '10002797',	
                              'TIERS'				: 'C0000004',
                              'NatureOperation'	: 'WE'
                              }
                          }
                      ]
                          
                  }
              },
              {
              'EnteteReglement': 
                  {
                  'ETB'			: '',
                  'TRANSACDT'	: '20241020',
                  'DEV'			: 'EUR',
                  'TIERS'		: 'C0000004',
                  'MTDEV'			: '918.20',
                  'LIB'			: 'Règlement 2',	
                  'RegltTyp'	: '1',		
                  'ChgEtat'	: 'PORCHQ',
                  'EtatFin'	: 'C30',
				  'Transac'	: '2',
				  'Noordre'	: '1',
                  'DetailReglementtb': 
                      [
                          {
                          'DetailReglement': 
                              {
                              'MTDEVFIN'			: '918.20',
                              'PREFPIECE'			: ' ',
                              'PIECE'				: '10002797',	
                              'TIERS'				: 'C0000004',
                              'NatureOperation'	: ''
                              }
                          }
                      ]				
                  }
              }
          ]
      }
  }

Compléments intégration facture - règlement en devises (V10.11)

Le règlement en devises par l’intégration de règlements suit quelques règles

  • Gestion des montants total du règlement dans l’entête du règlement (EnteteReglement)

    • Si le règlement est en devise différente de la devise du dossier, le montant total du règlement en devise MTDEV dans l’entête est obligatoire.

    • Si le montant total dans la devise du dossier MT est renseigné, on considère le règlement à taux de change bloqué et il sera égal au rapport entre les montants. Si le règlement n’est pas dans la devise des factures, il faut obligatoirement faire le traitement à devise bloquée.

    • Sinon, le taux de change sera récupéré dans la table des taux de change

  • Gestion des montants dans les détails de règlement(DetailReglement)

    • Description des champs montants

      • MTDEVREGLE est le montant effectif du règlement dans la devise du règlement

      • MTREGLE est le montant effectif du règlement dans la devise du dossier

      • AMOUNT est le montant dans la devise de la facture que l’on va régler

    • Cas 1 : le règlement est à taux de change bloqué

      • Les montants effectifs du règlement (MTDEVREGLE, MTREGLE) sont obligatoires

    • Cas 2 : le règlement n’est pas à taux de change bloqué

      • On considère dans ce cas là que la devise du règlement est dans la devise de la facture. Et donc le montant du règlement est égal au montant à régler (MTDEVREGLE = AMOUNT) et le montant à régler dans la devise du dossier est calculé en automatique à partir du taux de change à date.

  • Si le règlement est dans la devise du dossier, alors l’un des deux champs MTDEVREGLE ou MTREGLE suffit (l'autre sera copié à l’identique), mais dans tous les cas les deux champs MTREGLE et MTDEVREGLE doivent être égaux (erreur si différents ou non renseignés)

 

Exemple flux complet JSON pour règlement en devise

Dans l’exemple, règlement de 2400 TND pour 2 factures en TND avec un escompte pour chaque facture

Bloc de code
languagejson
	'action': {
		'swinfinity': 'integration_reglement',
		'parameters': {
			'withlog': '1',
			'doscpt': '998',
			'dos': '998',
			'etb': ''
		}
	},
	'data':
		{'EnteteReglementtb': 
		[
			{
			'EnteteReglement': 
				{
				'ETB'			: ' ',
				'TRANSACDT'		: '20231010',
				'currency'		: 'TND',
				'THIRDPARTY'	: 'C0000004',
				'MtDev'			: '2400',
				'Mt'			: '1920',
				'LABEL'			: 'Règlement de 2400 TND de 2 factures en TND avec un escompte pour chaque facture ',	
				'PAYMENTTYPE'	: 'ENCASHMENT',		
				'FINALSTATEMENT'	: 'CHECK',
				'BQC'	: 'BNP',
				'DetailReglementtb': 
					[
						{
						'DetailReglement': 
							{
							'amount'			: '960',
							'mtDevregle'		: '960',
							'mtregle'			: '768',
							'PREFIX'			: '',
							'PIECE'				: '394',	
							'THIRDPARTY'		: 'C0000004',
							'OPERATION'			: 'PAYMENT'
							}
						},
						{
						'DetailReglement': 
							{
							'amount'			: '1440',
							'mtDevregle'		: '1440',
							'mtregle'			: '1152',
							'PREFIX'			: '',
							'PIECE'				: '395',	
							'THIRDPARTY'		: 'C0000004',
							'OPERATION'			: 'PAYMENT'
							}
						},
						{
						'DetailReglement': 
							{
							'amount'			: '40',
							'PREFIX'			: '',
							'PIECE'				: '394',	
							'THIRDPARTY'		: 'C0000004',
							'OPERATION'			: 'WE'
							}
						},
						{
						'DetailReglement': 
							{
							'amount'			: '60',
							'PREFIX'			: '',
							'PIECE'				: '395',	
							'THIRDPARTY'		: 'C0000004',
							'OPERATION'			: 'WE'
							}
						}
					]
						
				}
			}
		]
	}
}	

Format de la réponse :

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

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": ""
}

Intégration de remise en banque

L’intégration par fichier JSON de transaction de type remise en banque est disponible, par exemple une opération de type C30 → C50 (remise en banque de chèques en portefeuille)

  • à partir de la version X.7 service pack 217e

  • à partir de la version X.9 service pack 219c

  • à partir de la version X.10 service pack 220b

  • à partir de la version X.11 service pack 221a

Si l'état final de type n’est pas un virement et est associé à un bordereau, il faudra passer par l'étape de confection du bordereau pour générer l'écriture associée à la transaction créée.
Si l'état final de type remise est un virement ou n'est pas associé à un bordereau, l'écriture associée à la transaction créée est générée lors du traitement du fichier JSON .

Le mécanisme général est identique à l’intégration ci-dessus, mais voici quelques précisions pour le cas de la remise en banque

Donnée à mettre dans le fichier JSON

Dans RGLTJNLENT (EnteteReglement) on doit définir

  • La devise et le montant total de la transaction à effectuer (Facultatif ). Si présent le total des transactions (DetailReglement) sera comparé à ce montant.

  • Le type de règlement (PAYMENTTYPE) 1 Encaissement, 2 décaissement. (Obligatoire)

  • le code du changement d'état à utilisé (Obligatoire)

  • la banque de destination (Obligatoire)

Dans RGLTJNLDET (DetailReglement) Il faut renseigner

  • soit un n° de transaction existant correspondant à le remise en portefeuille

    • TRANSAC : le n° de la transaction qui à permis la passage de la position 1 à la position 2 (Ex : transaction de remise en portefeuille de chèque)

    • NOORDRE : le n° d’ordre n’est pas obligatoire (N° 1 pris par défaut)

  • soit des informations permettant de retrouver la transaction. Si plusieurs transactions correspondent aux critères fournis on prend celle avec le N° le plus petit

    • TIERS (THIRDPARTY) : Code tiers

    • ETATORI : Etat des règlements à traiter. Doit correspondre à un des état d’entrées possible pour le changement d'état précisé dans l’entête

    • MTORI : Montant de la transaction en devise du dossier

    • ou MTDEVORI (AMOUNT) montant en devise et DEV (CURRENCY) : devise

Exemple de fichier

Remise en banque avec N° de transaction

...

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

...