Mise à jour du compteur sur un matériel / équipement

L'action pour la mise à jour du compteur sur une fiche matériel : maj_cpt_equipement

Balise de paramètres (parameters)	Niveau	Contenu	Obligatoire	Remarques
dos	1	Dossier achat-vente	NON	Par défaut selon utilisateur

Balise du corps (data)	Niveau	Contenu	Obligatoire	Remarques
COUNTER	2	Balise ouvrante pour décrire une section ‘une mise à jour compteur’	OUI
EQUIPEMENTCODE	3	Code matériel / équipement	OUI
COUNTERCODE	3	Code compteur	OUI	Si le code compteur n’existe pas, un nouveau compteur sera crée
ADDEDVALUEFLAG		Balise indiquant le comportement attendu sur le compteur (ajout à la valeur ou remplacement de la valeur)	NON	ADDEDVALUEFLAG : TRUE → prendre en compte la balise COUNTERADDEDVALUE (valeur ajoutée compteur) FALSE ->prendre en compte la balise COUNTERVALUE (valeur compteur) La valeur par défaut est FALSE
COUNTERADDEDVALUE	3	Valeur ajoutée au compteur si ADDEDVALUEFLAG est FALSE	NON	En lien avec ADDEDVALUEFLAG
COUNTERVALUE	3	Valeur du compteur si ADDEDVALEURFLAG est TRUE	NON	En lien avec ADDEDVALUEFLAG
CONTRACTREFERENCE	3	Référence du contrat. Deux modes possibles : contrat actif ou contrat choisi	NON	Soit on donne la référence du contrat, pour faire le lien entre le relevé de compteur et le contrat. Fonctionne avec plusieurs contrats. Soit on donne le mot clé “ACTIVE_CONTRACT” dans cette balise, et le contrat actif est recherché pour faire le lien entre le relevé de compteur et le contrat. Attention, ce mode ne fonctionne que s’il n’y a qu’un seul contrat actif lié au matériel
STATEMENTDATE	3	Date de relevé sous forme AAAAMMJJ
{“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”}	3	Liste des champs avec leur nom de champ et la valeur	OUI	Peut être le nom du champ ou son mapping

Mapping de champs de la table GMCPTDT


EQUIPEMENTCODE	RMCOD	Code matériel / équipement (obligatoire)
COUNTERCODE	CPTCOD	Code compteur
CHRONONUMBER	RMNO	Numéro interne de matériel
STATEMENTDATE	RELDT	Date de relevé compteur
COUNTERADDEDVALUE	CPTVALAJ	Valeur ajoutée

Exemple de corps : compteur forcé, pour le contrat indiqué

'data':
  {
  'COUNTER': 
    {
    'EQUIPEMENTCODE':'PER120',
    'COUNTERCODE':'JOUR',
    'CONTRACTREFERENCE ':'MATERIELCROMBE',
    'ADDEDVALUEFLAG ':'FALSE',
    'COUNTERVALUE ':'5',
    'STATEMENTDATE  ':'20220701'
    }
  }

Exemple de corps : compteur augmenté, pour le contrat actif

'data':{
  'COUNTER':
    {
    'EQUIPEMENTCODE':'PER120',
    'COUNTERCODE':'JOUR',
    'CONTRACTREFERENCE ':'ACTIVE_CONTRACT',
    'ADDEDVALUEFLAG ':'TRUE',
    'COUNTERVALUE ':'1',
    'STATEMENTDATE  ':'20220701'
    }
  }

Exemple complet flux JSON

{ 
    "action":"WEB_SERVICE_INFINITY",
    "access_token":"{{TOKEN}}",
    "param":"
        {
        'action': 
            {
            'swinfinity': 'maj_cpt_equipement',
            'parameters': {'dos': '998'}
            },
          'data':
            {
            'COUNTER': 
              {
              'EQUIPEMENTCODE':'PER120',
              'COUNTERCODE':'JOUR',
              'CONTRACTREFERENCE ':'MATERIELCROMBE',
              'ADDEDVALUEFLAG ':'FALSE',
              'COUNTERVALUE ':'5',
              'STATEMENTDATE  ':'20220701'
              }
            }
        }"
}

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 txterr indique 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

Exemple de réponse

{
    "error": 0,
    "result": "{\"label\": \"infinity\",\"codeScript\": \"maj_cpt_equipement\",\"resultType\": \"JSON\",\"result\":{,\"response\": {\"EQUIPEMENTCODE\":\"156456\",\"EQUIPEMENTNUMBER\": \"25\", \"COUNTERCODE\": \"KM\"}}}",
    "txterr": "",
    "infos": ""
}

[INTERNE] Mise à jour compteur matériel / équipement (V10.8) (JSON)

Mise à jour du compteur sur un matériel / équipement

Exemple de corps : compteur forcé, pour le contrat indiqué

Exemple de corps : compteur augmenté, pour le contrat actif

Exemple complet flux JSON