Création de pièce commerciale
L'action pour la création de pièce commerciale : integration_piece
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 |
|---|---|---|---|---|
ipar, ient, imouvtb, …etc | 1 | La balise indique le groupe de données de l’intégration de pièce concerné. Voir plus bas | OUI | |
{“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”} | 2 | Liste des champs avec leur nom de champ et la valeur | OUI | Le le type de champs dépend du dictionnaire de données. |
La structure JSON est strictement identique à celle d’un fichier l’intégration de pièce (GTFI GTPP150) avec une mise à plat au format JSON des balises.
Chaque pièce à créer est décrite à l'aide de la structure d'un fichier GTFI, mais il faut appliquer une correspondance entre l’entité et le nom de balise à transmettre
Code balise JSON | Entité intégration correspondante | Obligatoire | Niveau imbrication | Remarque |
|---|---|---|---|---|
ipar | IPAR | OUI | aucun | Un seul IPAR par demande |
ient | ENT | OUI | aucun | Entête de pièce, un seul par demande |
ientcplext | ENTCPLEXT | NON | aucun | Entête de pièce complément, un seul par demande |
ieec | EEC | NON | aucun | Echéances multiples |
itxttb et itxt | ITXT | NON | aucun | Intégration de texte. itxttb doit être utilisé pour indiquer un tableau de itxt |
ieadtb et iead | EAD | NON | aucun | Adresse. ieadtb doit être utilisé pour indiquer un tableau de iiead |
imouvtb et imouv | MOUV | OUI | aucun | Mouvement de pièce. imouvtb doit être utilisé pour indiquer un tableau de imouv |
imouvtaxtb et imouvtax | MOUVTAX | NON | imouvtb | Taxe de mouvement de pièce. imouvtaxtb doit être utilisé pour indiquer un tableau de imouvtax |
imouvcliretb et imouvclire | MOUVCLIRE | NON | imouvtb | Remise client de mouvement de pièce. imouvcliretb doit être utilisé pour indiquer un tableau de imouvclire |
imvtltb et imvtl | MVTL | NON | imouvtb | Ventilation de mouvement de pièce. imvtltb doit être utilisé pour indiquer un tableau de imvtl |
Les balises ‘tableau’ (imouvtb par exemple) impliquent l’utilisation de [ ], même pour la transmission d’un seul élément
Exemples avec imouvtb
Exemple de corps
'data':
{
'ipar':
{
'TRAIT':'C',
'DOS' :'998',
'TICOD':'C',
'PICOD':'1'
},
'ient':
{
'ETATPIECE' :'1',
'TIERS':'C0000001',
'OP' :'C',
'REFPIECE':'Test pièce sw json',
'DEPOT' :'1'
},
'imouvtb':
[
{
'imouv':
{
'CE2' :'1',
'REF' :'ALB0001',
'DVQTE':'3'
}
}
]
}
Exemple complet flux JSON : devis simple
{
"action":"WEB_SERVICE_INFINITY",
"access_token":"{{TOKEN}}",
"param":"
{
'action': {'swinfinity': 'integration_piece'},
'data':
{
'ipar':
{
'TRAIT':'C',
'DOS' :'998',
'TICOD':'C',
'PICOD':'1'
},
'ient':
{
'ETATPIECE' :'1',
'TIERS':'C0000001',
'OP' :'C',
'REFPIECE':'Test pièce sw json',
'DEPOT' :'1'
},
'imouvtb':
[
{
'imouv':
{
'CE2' :'1',
'REF' :'ALB0001',
'DVQTE':'3'
}
}
]
}
}"
}
Exemple complet flux JSON : devis avancé
{
"action":"WEB_SERVICE_INFINITY",
"access_token":"{{TOKEN}}",
"param":"
{
'action': {'swinfinity': 'integration_piece'},
'data':
{
'ipar':
{
'TRAIT':'C',
'DOS' :'998',
'ETB' :'1',
'TICOD':'C',
'PICOD':'1'
},
'ient':
{
'ETATPIECE' :'1',
'TIERS':'C0000001',
'OP' :'C',
'REFPIECE':'Test SWINFINiTY',
'DEPOT' :'1'
},
'ieadtb':
[
{
'iead':
{
'ADRNO':'3',
'NOM' :'CHEZ PARTICULIER',
'CPOSTAL':'17000',
'VIL' :'LA ROCHELLE'
}
},
{
'iead':
{
'ADRNO':'4',
'NOM' :'COMPTABILITE',
'CPOSTAL':'17138',
'VIL' :'PUILBOREAU'
}
}
],
'ieec':
{
'REGL(1)' :'C',
'ECHVTL(1)':'1/3',
'REGL(2)' :'T30',
'ECHVTL(2)':'S'
},
'itxttb':
[
{
'itxt':
{
'TXTNAT':'2',
'TXTTYP':'1',
'TXTTRAIT':'1',
'TEXTE':'Ceci est la note entete'
}
},
{
'itxt':
{
'TXTNAT' :'2',
'TXTTYP' :'2',
'TXTTRAIT' :'1',
'TEXTE' :'Ceci est le texte entete'
}
}
],
'imouvtb':
[
{
'imouv':
{
'CE2' :'1',
'REF' :'ALB0001',
'DVQTE':'3'
},
'imouvtaxtb':
[
{'imouvtax':
{
'TAXCOD':'ECO018',
'DEEEPU':'1.15',
'LIB' :'taxe 018'
}
},
{'imouvtax':
{
'TAXCOD':'ECO034',
'DEEEPU':'1.30',
'LIB' :'taxe 034'
}
}
]
},
{
'imouv':
{
'CE2' :'1',
'REF' :'ALB0002',
'QTEDEVIS':'5'
},
'imvtltb':
[
{'imvtl':
{
'QTE' :'3',
'DELDEMDT' :'20210401'
}
},
{'imvtl':
{
'QTE' :'2',
'DELAIDEMANDE' :'20210301'
}
}
],
'itxttb':
[
{
'itxt':
{
'TXTNAT' :'2',
'TXTTYP' :'4',
'TXTTRAIT' :'1',
'TEXTE' :'Ceci est la note ligne ALB0002'
}
},
{
'itxt':
{
'TXTNAT' :'2',
'TXTTYP' :'5',
'TXTTRAIT' :'1',
'TEXTE' :'Ceci est le texte ligne ALB0002'
}
}
]
}
]
}
}"
}
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
La |
Exemple de réponse
{
"error": 0,
"result": "{\"label\": \"infinity\",\"codeScript\": \"integration_piece\",\"result\":{\"common\":{\"resultcode\": \"0\",\"errormessage\": \"\"},\"response\":{\"pino\": \"10000125\",\"prefpino\": \" \"}}}",
"txterr": "",
"infos": ""
}