Mise à jour compteur matériel / équipement (V10.8) (JSON)
- Bertrand Littel
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 :
|
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 |
result | Détail du résultat fonctionnel de l’appel du service web
|
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": ""
}