Intégration et interrogation 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

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

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
deal	3	code affaire	NON	Code affaire à interroger

Le cas INSERT pour créée

Balise du corps (data)	Niveau	Contenu	Obligatoire	Remarques
dealcontract	2	Liste des champs avec leur nom de champ et la valeurpos	OUI
dealcontrac	3	code affaire	NON	si pas renseigné le code affaire sera incrémenté automatiquement	description	3	libellé affaire	OUI
dealsteptype	3	Etat de l’affaire	OUI	(opportunity/deal/model) par défaut = opportunity
dealstep	3	étape d’affaire	OUI
thirdpartyclient	3	code client si le type de tiers est client	OUI si le type de tiers est client
thirdpartprospect	3	code prospect si le type de tiers est prospect	OUI si le type de tiers est prospect
dealfamily	3	famille d’affaire	NON
sitecode	3	code site	NON
agencycode	3	code agence	NON	optionnel
warehouse	3	dépôt	NON	optionnel
currency	3	devise	NON	optionnel
model	3	code affaire modèle	NON	si création d’un affaire à partir d’un affaire modèle
needsflag	3	indicateur copier besoins	NON	valeurs possibles : YES/NO
eventsflag	3	indicateur copier évènements	NON	valeurs possibles : YES/NO
rubricsflag	3	indicateur copier rubriques	NON	valeurs possibles : YES/NO
activitiesflag	3	indicateur copier activités	NON	valeurs possibles : YES/NO
constraintflag	3	indicateur copier contraintes	NON	valeurs possibles : YES/NO
tecflag	3	indicateur copier données techniques	NON	valeurs possibles : YES/NO

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

(Ici des exemples prêts à copier. Exemple = que la zone data, complet= tout)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

Bloc de code

language	json

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

Exemple de corps pour un INSERT

Bloc de code

language	json

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

Exemple

...

complet flux JSON pour un

...

GET

Bloc de code

language	json

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

Exemple complet flux JSON pour un

...

INSERT

Bloc de code

language	json

...

Bloc de code

language	json

{ 
    "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 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

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

Exemple de réponse GET

Bloc de code

language	json

{
    "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

Bloc de code

language	json

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

Comparaison des versions

Ancienne version 1

Nouvelle version 2

Légende

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

Comparaison de pages

Comparaison des versions

Ancienne version 1

Nouvelle version 2

Légende

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