Intégration et interrogation contrat

L'action pour l’interrogation ou l’intégration d’un contrat : Integration_contrat

Balise de paramètres (parameters)

Niveau

Contenu

Obligatoire

Remarques

dos

1

Dossier achat-vente

NON

Par défaut selon utilisateur

actiontyp

1

Type d’action attendue:

“GET” pour interroger
“INSERT” pour créer
“UPDATE” pour modifier

OUI

Le cas GET pour interroger

Balise du corps (data)	Niveau	Contenu	Obligatoire	Remarques
contract	2	Liste des champs avec leur nom de champ et la valeurpos	OUI

Le cas INSERT pour créée

Balise du corps (data)	Niveau	Contenu	Obligatoire	Remarques
contract	2	Liste des champs avec leur nom de champ et la valeurpos	OUI
contrac	3	code affaire	NON	si pas renseigné le code affaire sera incrémenté automatiquement

Le cas UPDATE pour modification

Balise du corps (data)	Niveau	Contenu	Obligatoire insert
deal	2	Liste des champs avec leur nom de champ et la valeurpos	OUI
deal	3	code affaire	NON
{“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”}	2	Liste des champs à modifier avec leurs noms de champ et la valeurs	NON

A FINIR, INFOS DE LA PAGE R&D

{“thirdparty”:”C0000001”,”Contractnumber”:testref”,”contractcod”:LOC”,”ContratFam”:ABOREVUE”,”GENERCALPREV”:2”}

2

Liste des champs avec leur nom de champ et la valeur

OUI

si GENERCALPREV = 2 pour générer le calendrier

sinon 1.

EQUIPTB : [ { “MATERIAL“: { “CODEMATERIAL“:”Q0005”}}]

2

CEACONTRAT

NON

pour rattacher les matériels avec le contrat

Exemple de corps pour un GET

'data':
    {
        'contract': {'CONTRACTNUMBER':'NEWCONTRACT01'}
    }

Exemple de corps pour un INSERT

'data':
        {
        'contract':
            {       
                'CONTRATREF':'NEWCONTRACT01',
                'THIRDPARTY': 'C0000010',
                'CONTRACTCODE': 'ENTRET',
                'LABEL': 'C0000010',
                'STARTDATE': '20230101',
                'ENDDATE': '20231231',
                'GENERCALPREV': '2',
                'CONTRACTFAM': 'ABOREVUE'
            }
        }

Exemple complet flux JSON pour un GET

{ 
    "action":"WEB_SERVICE_INFINITY",
    "access_token":"{{TOKEN}}",
    "param":"
        {
        'action': {
            'swinfinity': 'integration_contrat',
            'parameters': {'dos': '998', 'actiontyp':'GET'}
            },            
        'data':
            {
                'contract': {'CONTRACTNUMBER':'NEWCONTRACT01'}
            }
        }"
}

Exemple complet flux JSON pour un INSERT

{ 
    "action":"WEB_SERVICE_INFINITY",
    "access_token":"{{TOKEN}}",
    "param":"
        {
        'action': {
            'swinfinity': 'integration_contrat',
            'parameters': {'dos': '998', 'actiontyp':'INSERT'}
            },
        'data':
            {
            'contract':
                {       
                    'CONTRATREF':'NEWCONTRACT01',
                    'THIRDPARTY': 'C0000010',
                    'CONTRACTCODE': 'ENTRET',
                    'LABEL': 'C0000010',
                    'STARTDATE': '20230101',
                    'ENDDATE': '20231231',
                    'GENERCALPREV': '2',
                    'CONTRACTFAM': 'ABOREVUE'
                }
            }
        }"
}

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

Le CONTRATREF est retourné dans la response ainsi que le numéro de contrat dans CONTRATNO

Exemple de réponse GET

{
    "error": 0,
    "result": "{\"label\": \"infinity\",\"codeScript\": \"integration_contrat\",\"resultType\": \"JSON\",\"result\":
    {\"common\":{\"resultcode\": \"0\",\"errormessage\": \"\"},\"response\":{\"CONTRACTNUMBER\": \"NEWCONTRACT01\",\"tierstyp\": \"2\",\"THIRDPARTY\": \"C0000010\",\"CONTRACTFAM\": \"ABOREVUE\",\"LABEL\": \"C0000010\",\"dureetyp\": \"2\",\"STARTDATE\": \"20230101\",\"ENDDATE\": \"20231231\",\"DURATION\": \"12\",\"TYPEFREQUENCYRENEWAL\": \"2\",\"TERMINATIONDEADLINE\": \"1\",\"renouvprevdt\": \"20240101\",\"TYPEFREQUENCYTERMINATION\": \"2\",\"TYPEFREQUENCY\": \"3\",\"TACITAGREEMENT\": \"1\",\"TYPEFREQUENCYRENEWAL\": \"3\",\"CONTRACTCODE\": \"ENTRET\",\"AMOUNT\": \"1200,00\",\"AMOUNTTYPE\": \"1\",\"LABORINCLUDED\": \"2\",\"PIECEINCLUDED\": \"2\",\"LOCATIONINCLUDED\": \"2\",\"BILLINGGROUPINGMODE\": \"1\",\"INDEXATIONTYPE\": \"4\",\"MATURITYTYPE\": \"2\"}}}",
    "txterr": "",
    "infos": ""
}

Exemple de réponse INSERT

{
    "error": 0,
    "result": "{\"label\": \"infinity\",\"codeScript\": \"integration_contrat\",\"resultType\": \"JSON\",\"result\":
        {\"common\":{\"resultcode\": \"0\",\"errormessage\": \"\"},\"response\":{\"CONTRATREF\": \"NEWCONTRACT01\",\"CONTRATNO\": \"16\"}}}",
    "txterr": "",
    "infos": ""
}

Intégration et interrogation contrat (V10.9) (JSON)

Intégration et interrogation contrat

Exemple de corps pour un GET

Exemple de corps pour un INSERT

Exemple complet flux JSON pour un GET

Exemple complet flux JSON pour un INSERT