Intégration et interrogation affaire

L'action pour l’interrogation ou l’intégration d’une affaire : integration_affaire

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
deal	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éer

Balise du corps (data)	Niveau	Contenu	Obligatoire	Remarques
deal	2	Liste des champs avec leur nom de champ et la valeurpos	OUI
deal	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

Exemple de corps pour un GET

'data': {
    'deal':
        {
        'DEAL': 'E0501'
        }
    }

Exemple de corps pour un INSERT

'data':
    {
    'deal':
        {       
        'MODEL':'ABOLIC',
        'DEAL': 'PR000113',
        'DESCRIPTION': 'Projet affaire',
        'DEALSTEPTYPE': 'OPPORTUNITY',
        'DEALSTEP': 'PRJ_CHIF',
        'THIRDPARTYCLIENT':'C0000001',
        'SITECODE':'SIEGENEB',
        'WAREHOUSE':'1',
        'BUDGETLINKSFLAG' :'YES',
        'BUDGETFLAG' :'YES',
        'NEEDSFLAG' :'YES',
        'EVENTSFLAG' :'YES',
        'RUBRICSFLAG' :'YES',
        'ACTIVITIESFLAG' :'YES',
        'CONSTRAINTFLAG' :'YES',
        'TECFLAG' :'YES'
        }
    }

Exemple complet flux JSON pour un GET

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

Exemple complet flux JSON pour un INSERT

{ 
    "action":"WEB_SERVICE_INFINITY",
    "access_token":"{{TOKEN}}",
    "param":"
        {
        'action': {
            'swinfinity': 'integration_affaire',
            'parameters': {'dos': '998', 'actiontyp':'INSERT'}
            },
        'data':
            {
            'deal':
                {       
                'MODEL':'ABOLIC',
                'DEAL': 'PR000113',
                'DESCRIPTION': 'Projet affaire',
                'DEALSTEPTYPE': 'OPPORTUNITY',
                'DEALSTEP': 'PRJ_CHIF',
                'THIRDPARTYCLIENT':'C0000001',
                'SITECODE':'SIEGENEB',
                'WAREHOUSE':'1',
                'BUDGETLINKSFLAG' :'YES',
                'BUDGETFLAG' :'YES',
                'NEEDSFLAG' :'YES',
                'EVENTSFLAG' :'YES',
                'RUBRICSFLAG' :'YES',
                'ACTIVITIESFLAG' :'YES',
                'CONSTRAINTFLAG' :'YES',
                'TECFLAG' :'YES'
                }
            }
        }"
}

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 pour un GET

{
    "error": 0,
    "result": "{\"label\": \"infinity\",\"codeScript\": \"integration_affaire\",\"resultType\": \"JSON\",\"result\":{,\"response\":{\"DATA\":{\"DEAL\":{\"DEAL\": \"E0501\",\"DESCRIPTION\": \"Implantation ERP Papet' Services\",\"DEALSTEPTYPE\": \"DEAL\",\"DEALSTEP\": \"AFF_LIVR\",\"DESCRIPTIONDEALSTEP\": \"En livraison\",\"THIRDPARTY\": \"C0000022\",\"THIRDPARTYNAME\": \"PAPET'SERVICES\",\"DEALFAMILY\": \"IERP\",\"DESCRIPTIONDEALFAMILY\": \"Implémentation d'ERP\",\"WAREHOUSE\": \"1\",\"DESCRIPTIONWAREHOUSE\": \"Dépôt principal\",\"CURRENCY\": \"EUR\",\"DESCRIPTIONCURRENCY\": \"Euro\"}}}}}",
    "txterr": "",
    "infos": ""
}

Exemple de réponse pour un INSERT

{
    "error": 0,
    "result": "{\"label\": \"infinity\",\"codeScript\": \"integration_affaire\",\"resultType\": \"JSON\",\"result\":{\"common\":{\"resultcode\": \"0\",\"errormessage\": \"\"},\"response\":\"Affaire\": \"PR000113\"}}",
    "txterr": "",
    "infos": ""
}

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

Intégration et interrogation affaire

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