Intégration d'écritures comptables (V10.7) (JSON)

Intégration d'écritures comptables

L'action pour l'intégration d’écritures comptables : integration_ecriture

Balise de paramètres (parameters)

Niveau

Contenu

Obligatoire

Remarques

Balise de paramètres (parameters)

Niveau

Contenu

Obligatoire

Remarques

dos

1

Dossier achat-vente

NON

Par défaut selon utilisateur

doscpt

1

Dossier comptable

NON

Par défaut selon utilisateur

Balise du corps (data)

Niveau

Contenu

Obligatoire

Remarques

Balise du corps (data)

Niveau

Contenu

Obligatoire

Remarques

EntryTable

1

Balise ouvrante tableau des écritures

OUI

 

EntryLigneTable

2

Balise ouvrante tableau des lignes d'écriture

OUI

 

EntryLigne

3

Une ligne d'écriture

OUI

 

key : {“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”}

4

Liste des champs C8 avec leur nom de champ et la valeur

OUI

 

AnalyticalLigneTable

4

Balise ouvrante tableau des lignes de détail d’axe analytique

NON

 

AnalyticalLigne

5

Une ligne de détail d’axe analytique

NON

 

key : {“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”}

6

Liste des champs CX avec leur nom de champ et la valeur

NON

 

VATLigneTable

4

Balise ouvrante tableau des lignes de détail TVA

NON

 

VATLigne

5

Une ligne de détail TVA

NON

 

key : {“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”}

6

Liste des champs CTAX avec leur nom de champ et la valeur

NON

 

PaymentTermsLigneTable

4

Balise ouvrante tableau des lignes de détail pièce et échéances

NON

 

PaymentTermsLigne

5

Une ligne de détail pièce et échéance

NON

 

key : {“nomChamp1”:”valeur1”,”nomChamp2”:valeur2”}

6

Liste des champs CP avec leur nom de champ et la valeur

NON

 

 

Un mapping existe entre les noms de champs du dictionnaire et les noms de balise à utiliser, mais pour rappel les nom du champ du dictionnaire sont utilisables directement

Table C8 (=EntryLigne)

Nom de balise

Nom de champ

Version

Remarque

Nom de balise

Nom de champ

Version

Remarque

FOLDER

Dos

10.7

Dossier achat-vente

ESTABLISHMENT

Etb

Dossier comptable

ACCOUNT

Cpt

 

ENTRYDATE

Ecrdt

 

DESCRIPTION

Lib

 

CONFIDENTIALITY

Conf

 

JOURNAL

Jnl

 

ENTRYNO

Ecr

 

ASSOCIATEDENTRYNO

EcrA

 

ORIGINALENTRYNO

Ecrl

 

VALIDATEDENTRYNO

EcrValNo

 

CONTRAACCOUNT

Cp

 

PAYMENTMODE

Reg

 

LETTERINGCODE

Lett

 

CHECKINGCODE

Point

 

EXISTENCEBATCHCODE

LotCod

 

BATCHNO

Lot

 

ACCOUNTINGDOCUMENTPREFIX

PrefPiece

 

ACCOUNTINGDOCUMENT

Piece

 

DUEDATE

EchDt

 

CHEQUENO

ChqNo

 

CURRENCY

Dev

 

PAYMENTTYPE

RegTyp

 

THIRDPARTYDOCUMENTNO

PinoTiers

 

CHECKINGTICKET

TicketPoint

 

COLLECTIVEACCOUNT

CptCol

 

NATUREOFPAYMENT

NatPai

 

AMOUNT

Mt

 

FOREIGNCURRENCYTAMOUNT

MtDev

 

SECONDARYCURRENCY

MtBis

 

AMOUNT2

Mt2

 

FLOW

Sens

DEBIT=1, CREDIT=2

LETTERINGDATE

LettDt

 

CHECKINGDATE

PointDt

 

NATUREOFAMOUNT2

Mt2Nat

 

ESTIMATEDBANKTRANSACTIONDATE

BqeDt

 

VALUEDATE

ValDt

 

BANKTRANSACTIONDATE

OpeDt

 

EXCHANGERATE

DevP

 

CHECHINGAMOUNT

PointMt

 

DOCUMENTDATE

PieceDt

 

ENTRYVALIDATIONDATE

ValidDt

 

CALCULATIONMETHOD

Formule

 

DATAHUBNO

DHBNo

 

ANALYTICALKEY

CleRep

 

ASSOCIETEDLIGNENO

EcrLgLiee

 

DISCOUNTINDICATOR

EscompteFl

 

ACCOUNTINGCPTDOCUMENT

FullpieceCpt

 

ACCOUNTSTATEMENTCODE

ReleveCd

 

ACCOUNTSTATEMENTNO

ReleveNo

 

DAS2CODE

CodeDas2

 

RULECODE

RegleCod

 

DAYOFF

ArreteDt

 

UNCOLLECTIBLEVATFLAG

RecTvaFl

 

PURCHASEANDSALEFOLDER

DosG3

 

THIRDPARTYTYPE

TiersType

 

FINALSTATEMENT

 

CUSTOMER=1, VENDOR=2

THIRDPARTYCODE

Tiers

 

PURCHASEANDSALETHIRDPARTY

TiersG3

 

THIRDPARTYPAYER

TiersPayer

 

THIRDPARTYGROUP

TiersGrp

 

RELAUNCHTHIRDPARTY

RelTiers

 

 

Table CP (PaymentTermsLigne)

Nom de balise

Nom de champ

Version

Remarque

Nom de balise

Nom de champ

Version

Remarque

FOLDER

Dos

10.7

 

ESTABLISHMENT

Etb

 

ENTRYNO

Ecr

 

 

LIGNENO

MaskLg

 

 

ACCOUNT

Cpt

 

 

ACCOUNTINGDOCUMENTPREFIX

PrefPiece

 

 

ACCOUNTINGDOCUMENT

Piece

 

 

DUEDATE

EchDt

 

 

LETTERINGCODE

Lett

 

 

ENTRYTYPE

EcrTyp

 

 

PAYMENTMODE

Reg

 

 

CURRENCY

Dev

 

 

AMOUNT

Mt

 

 

FLOW

Sens

 

DEBIT=1, CREDIT=2

LETTERINGDATE

LettDt

 

 

FOREIGNCURRENCYTAMOUNT

MtDev

 

 

SECONDARYCURRENCY

MtBis

 

 

DISCOUNTINDICATOR

EscompteFl

 

 

SETTLEMENTSTATUS

EtatReg

 

 

PAIDENTRY

RegleFl

 

 

TRANSACTIONWORK

TransacWrk

 

 

ACCOUNTSTATEMENTCODE

ReleveCd

 

 

ACCOUNTSTATEMENTNO

ReleveNo

 

 

GROUPENTRY

RegrEcrM

 

 

DEFAULTPURCHASEBANK

Bqca

 

 

PRIORITY

Priorite

 

 

ACCOUNTSTATEMENTDATE

ReleveDt

 

 

PAYAUTHORIZATIONSIGNATORY

BapInter

 

 

PAYAUTHORIZATIONMANAGEMENTOFMETHOD

BapCod

 

 

LETTREDENTRY

FullPieceLt

 

 

BICCODE

Bic

 

 

CONTRACTCODE

MndtCod

 

 

IBAN

Iban

 

 

INTERNATIONALDISCOUNTTYPE

RemVirIntCod

 

 

DEBITDISCOUNTTYPE

DebVirIntCod

 

 

DOMICILIATION

RibDo

 

 

UNCOLLECTIBLEVATFLAG

RecTvaFl

 

 

PAYAUTHORIZATIONRETURNDATE

BapDt

 

 

DAILLYCESSION

CesCod

 

 

BANKACCOUNT

Bqc

 

 

CESSIONDATE

CesDt

 

 

PURCHASEANDSALEFOLDER

DosG3

 

 

THIRDPARTYTYPE

TiersType

 

 

FINALSTATEMENT

 

 

CUSTOMER=1, VENDOR=2

THIRDPARTYCODE

Tiers

 

 

PURCHASEANDSALETHIRDPARTY

TiersG3

 

 

ORIGINALSETTLEMENTSTATUS

EtatRegIni

 

 

ORIGINALAMOUNT

MtIni

 

 

ORIGINALFOREIGNCURRENCYTAMOUNT

MtDevIni

 

 

DAS2CODE

CodeDas2

 

 

RULECODE

RegleCod

 

 

DAYOFF

ArreteDt

 

 

UNCOLLECTIBLEVATFLAG

RecTvaFl

 

 

PURCHASEANDSALEFOLDER

DosG3

 

 

THIRDPARTYTYPE

TiersType

 

 

#VALEUR!

#VALEUR!

 

 

#VALEUR!

#VALEUR!

 

 

THIRDPARTYCODE

Tiers

 

 

PURCHASEANDSALETHIRDPARTY

TiersG3

 

 

THIRDPARTYPAYER

TiersPayer

 

 

THIRDPARTYGROUP

TiersGrp

 

 

RELAUNCHTHIRDPARTY

RelTiers

 

 

 

Table CTAX (VATLigne)

Nom de balise

Nom de champ

Version

Remarque

Nom de balise

Nom de champ

Version

Remarque

FOLDER

Dos

10.7

 

ESTABLISHMENT

Etb

 

ENTRYNO

Ecr

 

 

THIRDPARTYVAT

TvaTie

 

 

ITEMVAT

tvaArt

 

 

ACCOUNTINGDOCUMENTPREFIX

PrefPiece

 

 

ACCOUNTINGDOCUMENT

Piece

 

 

PAYABILITYDATE

ExDt

 

 

AMOUNTEXTAXES

MtHt

 

 

VATAMOUNT

MtTva

 

 

VATONDEBITORCREDIT

TvaTyp

 

 

FLOW

Sens

 

DEBIT=1, CREDIT=2

VATREVERSECHARGEINDICATOR

FlTvaAL

 

 

TAXATIONLIABILITYCOEFFICIENT

CoeAss

 

 

TAXATIONCOEFFICIENT

CoeTax

 

 

ADMISSIONCOEFFICIENT

CoeAdm

 

 

DATEOFEFFECT

EffetDt

 

 

AMOUNTEXTAXESTOVENTILATE

MtHtVtl

 

 

VATAMOUNTTOVENTILATE

MtTvaVtl

 

 

AMOUNTEXTAXESREMAINING

MtHtRes

 

 

REMAININGVATAMOUNT

MtTvaRes

 

 

VATFIXEDASSETS

ImmoFl

 

 

 

Table CX (AnalyticalLigne)

Nom de balise

Nom de champ

Version

Remarque

Nom de balise

Nom de champ

Version

Remarque

FOLDER

Dos

10.7

 

ESTABLISHMENT

Etb

 

ENTRYNO

Ecr

 

 

LIGNENO

MaskLg

 

 

AXISTABLE

AxeTb

 

 

AXIS

Axe

 

AXIS1=Axe(1) à AXIS4=axe(4)

ACCOUNT

Cpt

 

 

JOURNAL

Jnl

 

 

ENTRYTYPE

EcrTyp

 

 

ENTRYDATE

Ecrdt

 

 

CURRENCY

Dev

 

 

AMOUNT

Mt

 

 

FLOW

Sens

 

DEBIT=1, CREDIT=2

FOREIGNCURRENCYTAMOUNT

MtDev

 

 

SECONDARYCURRENCY

MtBis

 

 

TRANSACTION

Transac

 

 

LEVEL

Niv

 

 

LEVELOFTHEKEY

NivCle

 

 

ANALYTICALDUMPKEY

DvAncleCod

 

 

Exemple de corps
'data': { 'EntryTable':[{ 'EntryLigneTable': [{ 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2', 'CURRENCY' : 'EUR', 'ACCOUNT' : 'C0000002', 'AMOUNT' : '1200', 'FOREIGNCURRENCYTAMOUNT' : '1200', 'FLOW' : 'DEBIT', 'ACCOUNTINGDOCUMENT' : '55994', 'DESCRIPTION' : 'facture nebout' } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2 ', 'CURRENCY' : 'EUR', 'ACCOUNT' : '70700000', 'AMOUNT' : '1000', 'FOREIGNCURRENCYTAMOUNT' : '1000', 'FLOW' : 'CREDIT', 'ACCOUNTINGDOCUMENT' : '55994', 'DESCRIPTION' : 'facture nebout', 'AnalyticalLigneTable': [{ 'AnalyticalLigne': { 'CURRENCY' : 'EUR', 'AMOUNT' : '600', 'FOREIGNCURRENCYTAMOUNT': '600', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '11', 'AXIS2': '12', 'AXIS3': '13', 'AXIS4': '' } } ] } }, { 'AnalyticalLigne': { 'CURRENCY': 'EUR', 'AMOUNT' : '400', 'FOREIGNCURRENCYTAMOUNT': '400', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '11', 'AXIS2': '12', 'AXIS3': '13', 'AXIS4': '' } } ] } } ], 'VATLigneTable': [{ 'VATLigne': { 'ITEMVAT': '1', 'THIRDPARTYVAT': '0', 'AMOUNTEXTAXES' : '1000', 'VATAMOUNT' : '200', 'VATONDEBITORCREDIT': '1' } } ], 'PaymentTermsLigneTable':[{ 'PaymentTermsLigne':{ 'PAYMENTMODE' :'C', 'SETTLEMENTSTATUS':'C10', 'DUEDATE' :'20210301', 'AMOUNT' : '1000', 'FOREIGNCURRENCYTAMOUNT' : '1000' } } ] } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2 ', 'CURRENCY' : 'EUR', 'ACCOUNT' : '44571000', 'AMOUNT' : '200', 'FOREIGNCURRENCYTAMOUNT' : '200', 'ACCOUNTINGDOCUMENT' : '55994', 'FLOW' : 'CREDIT', 'DESCRIPTION' : 'facture nebout' } } ] }, { 'EntryLigneTable': [{ 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2', 'CURRENCY' : 'EUR', 'ACCOUNT' : 'C0000003', 'AMOUNT' : '1200', 'FOREIGNCURRENCYTAMOUNT' : '1200', 'FLOW' : 'DEBIT', 'ACCOUNTINGDOCUMENT' : '5599', 'DESCRIPTION' : 'facture nebout' } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2 ', 'CURRENCY' : 'EUR', 'ACCOUNT' : '70700000', 'AMOUNT' : '1000', 'FOREIGNCURRENCYTAMOUNT' : '1000', 'FLOW' : 'CREDIT', 'ACCOUNTINGDOCUMENT' : '5599', 'DESCRIPTION' : 'facture nebout', 'AnalyticalLigneTable': [{ 'AnalyticalLigne': { 'CURRENCY' : 'EUR', 'AMOUNT' : '600', 'FOREIGNCURRENCYTAMOUNT': '600', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '12', 'AXIS2': '21', 'AXIS3': 'PARIS', 'AXIS4': '' } } ] } }, { 'AnalyticalLigne': { 'CURRENCY': 'EUR', 'AMOUNT' : '400', 'FOREIGNCURRENCYTAMOUNT': '400', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '12', 'AXIS2': '21', 'AXIS3': 'PARIS', 'AXIS4': '' } } ] } } ], 'VATLigneTable': [{ 'VATLigne': { 'ITEMVAT': '1', 'THIRDPARTYVAT': '0', 'AMOUNTEXTAXES' : '1000', 'VATAMOUNT' : '200', 'VATONDEBITORCREDIT' : '1' } } ] } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2', 'CURRENCY' : 'EUR', 'ACCOUNT' : '44571000', 'AMOUNT' : '200', 'FOREIGNCURRENCYTAMOUNT' : '200', 'ACCOUNTINGDOCUMENT' : '5599', 'FLOW' : 'CREDIT', 'DESCRIPTION' : 'facture nebout' } } ] } ] }



Exemple complet flux JSON
{ "action":"WEB_SERVICE_INFINITY", "access_token":"{{TOKEN}}", "param":" { 'action': {'swinfinity': 'integration_ecriture', 'parameters': { 'doscpt': '998', 'dos': '998', 'etb': '1' } }, 'data': { 'EntryTable':[{ 'EntryLigneTable': [{ 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2', 'CURRENCY' : 'EUR', 'ACCOUNT' : 'C0000002', 'AMOUNT' : '1200', 'FOREIGNCURRENCYTAMOUNT' : '1200', 'FLOW' : 'DEBIT', 'ACCOUNTINGDOCUMENT' : '55994', 'DESCRIPTION' : 'facture nebout' } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2 ', 'CURRENCY' : 'EUR', 'ACCOUNT' : '70700000', 'AMOUNT' : '1000', 'FOREIGNCURRENCYTAMOUNT' : '1000', 'FLOW' : 'CREDIT', 'ACCOUNTINGDOCUMENT' : '55994', 'DESCRIPTION' : 'facture nebout', 'AnalyticalLigneTable': [{ 'AnalyticalLigne': { 'CURRENCY' : 'EUR', 'AMOUNT' : '600', 'FOREIGNCURRENCYTAMOUNT': '600', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '11', 'AXIS2': '12', 'AXIS3': '13', 'AXIS4': '' } } ] } }, { 'AnalyticalLigne': { 'CURRENCY': 'EUR', 'AMOUNT' : '400', 'FOREIGNCURRENCYTAMOUNT': '400', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '11', 'AXIS2': '12', 'AXIS3': '13', 'AXIS4': '' } } ] } } ], 'VATLigneTable': [{ 'VATLigne': { 'ITEMVAT': '1', 'THIRDPARTYVAT': '0', 'AMOUNTEXTAXES' : '1000', 'VATAMOUNT' : '200', 'VATONDEBITORCREDIT': '1' } } ], 'PaymentTermsLigneTable':[{ 'PaymentTermsLigne':{ 'PAYMENTMODE' :'C', 'SETTLEMENTSTATUS':'C10', 'DUEDATE' :'20210301', 'AMOUNT' : '1000', 'FOREIGNCURRENCYTAMOUNT' : '1000' } } ] } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2 ', 'CURRENCY' : 'EUR', 'ACCOUNT' : '44571000', 'AMOUNT' : '200', 'FOREIGNCURRENCYTAMOUNT' : '200', 'ACCOUNTINGDOCUMENT' : '55994', 'FLOW' : 'CREDIT', 'DESCRIPTION' : 'facture nebout' } } ] }, { 'EntryLigneTable': [{ 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2', 'CURRENCY' : 'EUR', 'ACCOUNT' : 'C0000003', 'AMOUNT' : '1200', 'FOREIGNCURRENCYTAMOUNT' : '1200', 'FLOW' : 'DEBIT', 'ACCOUNTINGDOCUMENT' : '5599', 'DESCRIPTION' : 'facture nebout' } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2 ', 'CURRENCY' : 'EUR', 'ACCOUNT' : '70700000', 'AMOUNT' : '1000', 'FOREIGNCURRENCYTAMOUNT' : '1000', 'FLOW' : 'CREDIT', 'ACCOUNTINGDOCUMENT' : '5599', 'DESCRIPTION' : 'facture nebout', 'AnalyticalLigneTable': [{ 'AnalyticalLigne': { 'CURRENCY' : 'EUR', 'AMOUNT' : '600', 'FOREIGNCURRENCYTAMOUNT': '600', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '12', 'AXIS2': '21', 'AXIS3': 'PARIS', 'AXIS4': '' } } ] } }, { 'AnalyticalLigne': { 'CURRENCY': 'EUR', 'AMOUNT' : '400', 'FOREIGNCURRENCYTAMOUNT': '400', 'AXISTABLE': [{ 'AXIS': { 'AXIS1': '12', 'AXIS2': '21', 'AXIS3': 'PARIS', 'AXIS4': '' } } ] } } ], 'VATLigneTable': [{ 'VATLigne': { 'ITEMVAT': '1', 'THIRDPARTYVAT': '0', 'AMOUNTEXTAXES' : '1000', 'VATAMOUNT' : '200', 'VATONDEBITORCREDIT' : '1' } } ] } }, { 'EntryLigne': { 'ESTABLISHMENT' : '', 'ENTRYDATE' : '20210301', 'JOURNAL' : 'V2', 'CURRENCY' : 'EUR', 'ACCOUNT' : '44571000', 'AMOUNT' : '200', 'FOREIGNCURRENCYTAMOUNT' : '200', 'ACCOUNTINGDOCUMENT' : '5599', 'FLOW' : 'CREDIT', 'DESCRIPTION' : 'facture nebout' } } ] } ] } }" }



Format de la réponse :

Balise

Contenu

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

La response contient notamment le numéro d’ecriture Ecrno au format de réponse de l’appel de l’intégration


Exemple de réponse

{ "error": 0, "result": "{\"label\": \"infinity\",\"codeScript\": \"integration_ecriture\",\"result\":{\"common\":{\"resultcode\": \"0\",\"errormessage\": \"Intégration terminée |Aucune erreur détectée\"},\"response\":\"Ecrno\": \"<ECRNO> 5055<ECRNO> 5056\"}}", "txterr": "", "infos": "" }

 

Ecriture avec auto-liquidation

Avec une écriture avec auto-liquidation, l'écriture doit comporter 2 CTAX dont les montants s’annulent, le champ FlTvaAL (ou VATREVERSECHARGEINDICATOR) indique

  • 1 : pour le CTAX qui est dans le même sens que l'écriture associée

  • 2 : pour le CTAX inverse