[[insoft:ac:doc:webservice:dap]]
Piste: • dap
Vous êtes ici: accueil » insoft » ac » doc » webservice » dap

Table des matières


Comment ça marche? Trucs & astuces
Produit Accountix
Projet Webservice
Mot clé ACX WS
Statut :V:

Rédacteur(s)

— Yassine 11/09/2015 15:54

Description

Contrairement à l'application accountix 'standard', l'application accountix 'Web' ne générera pas de sous-écran (subscreen). Toutes les lignes seront sur un seul écran, les lignes d'écritures générées automatiquement suite à une différence de règlement devront être dépendantes les unes des autres. Il ne devra donc pas être possible de supprimer individuellement une ligne qui serait dépendante d'autres lignes. ce traitement est réalisé ligne par ligne et non pas en fin de transaction globale (sous entendu , pas d'automatisme, c'est l'utilisateur qui décide).

Différence de règlement

  • Lors de la saisie des DAP (OD/FI) il faut pouvoir gérer les “différences de règlements”. Les différents cas qui seront traités sont:
    • Acompte.
    • Différence de règlement.
    • Escompte

Différence de change

Il s'agit d'un comportement, lorsque l'on veut apurer un document émis dans un devise “X” sur un financier géré en devise Y.

Par l'exemple, une facture en USD payée sur un compte en EUR. L'utilisateur connait le montant payé en USD, le système propose par défaut la contre valeur EUR selon les parités du jour. Mais, l'utilisateur doit pouvoir entrer la contre valeur EUR présente sur l'extrait financier, donc, respectivement imposé par la banque.

Mélange des traitements

L'utilisateur veut constater de l'escompte et de la différence de règlement, ou un acompte.

Exemple : facture de 1000 EUR; on paie 800 EUR en prenant 2 % d'escompte. Soit 784 €;sur ces 784 EUR, je décide de n'en considérer que 780, les 4 € restants passe en différence de règlement.

A ces différences de règlement, on peut combiner le principe de la différence de change. Le cas de figure classique c'est une différence de change en devise de mouvement (financier) qui va déclencher une différence de règlement sur la devise de ligne (facture).

Le mélange des traitements est une problématique à intégrer par le programme de saisie, qui se résout par des appels aux méthodes simples décrites ci-dessus. Cette partie ne fait pas l'objet d'un chiffrage particulier.

Traitement du code TVA

Si l'utilisateur introduit un code de TVA, l'appel va permettre d'extraire la TVA et préparer l'imputation sur les comptes de TVA.

Remarque

Néanmoins, il est possible de paramétrer le système afin d'avoir un calcul automatique à l'enregistrement de la transaction globale (Donc, pas d'appel de ligne).

Explication 'Différence de Règlement' par l'exemple

Acompte

Un Client paye un montant de 600 € sur une facture de 800 €. On justifie cette différence comme étant un Acompte.

Résultat

Dans ce cas rien de particulier, la facture est apurée partiellement dans la comptabilité. Aucun appel Webservice nécessaire :!:

Différence de Règlement

Exemple

Un Client paye un montant de 800 € sur une facture de 804 €. On justifie cette différence comme étant une différence de règlement. Le comptable fait un geste commercial et décide que la facture est payée entièrement.

Appel

Appel Webservice
  • URL : http://masterdev/accountix/dap/lines?
  • Méthode : POST
  • Variables attendues :
    • OPETYP = 2 (différence_de_règlement)
    • DOC = valeur
    • DEVISE = valeur
    • OBJET = valeur
    • JNL (Journal FI ou OD) = valeur
    • DATE = valeur
    • DBMNT (Débit en devise de ligne) = valeur
    • CRMNT (Crédit en devise de ligne) = valeur
    • DBREC (Débit en devise du financier) = valeur
    • CRREC (Crédit en devise du financier) = valeur
Résultat

Variable = format tableau 

[
    {
        "Trt": "1",
        "Account": "3#24##VEN#128#1",
        "Debit": "0.00",
        "Credit": "800.00",
        "RecDebit": "0.00",
        "RecCredit": "800.00",
        "LineDevise": "EUR",
        "LineDebit": "0.00",
        "LineCredit": "800.00",
        "Object": "TEST",
        "Tva": ""
    },
    {
        "Trt": "1",
        "Account": "3#24##VEN#128#1",
        "Debit": "0.00",
        "Credit": "4.00",
        "RecDebit": "0.00",
        "RecCredit": "4.00",
        "LineDevise": "EUR",
        "LineDebit": "0.00",
        "LineCredit": "4.00",
        "Object": "TEST Diff. rgt",
        "Tva": ""
    },
    {
        "Trt": "2",
        "Account": "6650000",
        "Debit": "4.00",
        "Credit": "0.00",
        "RecDebit": "4.00",
        "RecCredit": "0.00",
        "LineDevise": "EUR",
        "LineDebit": "4.00",
        "LineCredit": "0.00",
        "Object": "TEST",
        "Tva": ""
    }
]

Le tableau de retour contient toujours la ligne maîtresse (valeur d'appel) en ligne 1, dont les valeurs ont été éventuellement adaptées. Ce qui signifie que le programme appelant DOIT rafraîchir sa ligne courante.

Dans ce cas, la facture est apurée complètement dans la comptabilité. La différence de règlement est imputée sur un compte de charge 'Différence de Règlement'.

Escompte

Exemple

  • Un Client paye un montant de 776 € sur une facture de 800 €. Il justifie cette différence par une prise d'escompte de 3%.

Appel

Appel Webservice
  • URL : http://masterdev/accountix/dap/lines?
  • Méthode : POST
  • Variables attendues :
    • OPETYP = 3 (Escompte)
    • DOC = valeur
    • DEVISE = valeur
    • OBJET = valeur
    • JNL (Journal FI ou OD) = valeur
    • DATE = valeur
    • DBMNT (Débit en devise de ligne) = valeur
    • CRMNT (Crédit en devise de ligne) = valeur
    • DBREC (Débit en devise du financier) = valeur
    • CRREC (Crédit en devise du financier) = valeur
Résultat

Variable = format tableau 

[
   {
        "Trt": "1",
        "Account": "3#24##VEN#128#1",
        "Debit": "0.00",
        "Credit": "776.00",
        "RecDebit": "0.00",
        "RecCredit": "776.00",
        "LineDevise": "EUR",
        "LineDebit": "0.00",
        "LineCredit": "776.00",
        "Object": "TEST",
        "Tva": ""
    },
    {
        "Trt": "1",
        "Account": "3#24##VEN#128#1",
        "Debit": "0.00",
        "Credit": "24.00",
        "RecDebit": "0.00",
        "RecCredit": "24.00",
        "LineDevise": "EUR",
        "LineDebit": "0.00",
        "LineCredit": "24.00",
        "Object": "TEST Escompte",
        "Tva": ""
    },
    {
        "Trt": "2",
        "Account": "6631000",
        "Debit": "20.51",
        "Credit": "",
        "RecDebit": "20.51",
        "RecCredit": "0.00",
        "LineDevise": "EUR",
        "LineDebit": "20.51",
        "LineCredit": "0.00",
        "Object": "TEST",
        "Tva": "V17"
    },
    {
        "Trt": "2",
        "Account": "4457000",
        "Debit": "3.49",
        "Credit": "",
        "RecDebit": "3.49",
        "RecCredit": "0.00",
        "LineDevise": "EUR",
        "LineDebit": "3.49",
        "LineCredit": "0.00",
        "Object": "TEST",
        "Tva": ""
    }
]

Dans ce cas, la facture est apurée complètement dans la comptabilité. Le montant de l'escompte est imputée en partie sur un compte de charge 'Escompte client' et sur un compte de TVA.

Explication 'Différence de Change' par l'exemple

Une facture de 800$ est émise à un client le 01.06.15 (taux 1.154400 - 693 €) Le Client paye sa facture le 10.06.15 → 688 € (taux 1.162790). Cette différence est justifiée par la différence de change.

Facture

Paiement

Appel

  • URL : http://masterdev/accountix/dap/lines?
  • Méthode : POST
  • Variables attendues :
    • OPETYP = 9 (Différence de change)
    • DOC = valeur
    • DEVISE = valeur
    • OBJET = valeur
    • JNL (Journal FI ou OD) = valeur
    • DATE = valeur
    • DBMNT (Débit en devise de ligne) = valeur
    • CRMNT (Crédit en devise de ligne) = valeur
    • DBREC (Débit en devise du financier) = valeur forcée
    • CRREC (Crédit en devise du financier) = valeur forcée
Résultat

Variable = format tableau 

[
    {
        "Trt": "1",
        "Account": "3#24##VEN#128#1",
        "Debit": "0.00",
        "Credit": "688.00",
        "RecDebit": "0.00",
        "RecCredit": "688.00",
        "LineDevise": "USD",
        "LineDebit": "0.00",
        "LineCredit": "800.00",
        "Object": "TEST",
        "Tva": ""
    },
    {
        "Trt": "1",
        "Account": "3#24##VEN#128#1",
        "Debit": "32.00",
        "Credit": "0.00",
        "RecDebit": "32.00",
        "RecCredit": "0.00",
        "LineDevise": "USD",
        "LineDebit": "0.00",
        "LineCredit": "0.00",
        "Object": "TEST",
        "Tva": ""
    },
    {
        "Trt": "2",
        "Account": "7662000",
        "Debit": "0.00",
        "Credit": "32.00",
        "RecDebit": "0.00",
        "RecCredit": "32.00",
        "LineDevise": "USD",
        "LineDebit": "0.00",
        "LineCredit": "0.00",
        "Object": "TEST",
        "Tva": ""
    }
 ]

Le tableau de retour contient toujours la ligne maîtresse (valeur d'appel) en ligne 1, dont les valeurs ont été éventuellement adaptées. Ce qui signifie que le programme appelant DOIT rafraîchir sa ligne courante.

Dans ce cas, la facture est apurée complètement dans la comptabilité. La différence est imputée sur un compte de charge (ou de produit) de différence de change.

Mélange des traitements

Le Client veut payer 800€ d'acompte sur une facture de 1000€, il prend 2% d'escompte (16€) et arrondi le montant à 780€ (4€ de différence de règlement)

Résultat

Dans ce cas, la facture est apurée partiellement dans la comptabilité. Le montant de l'escompte est imputée en partie sur un compte de charge 'Escompte client' et sur un compte de TVA. La différence de règlement est imputée sur un compte de charge 'Différence de règlement' Il reste un solde de 200€ sur cette facture.

Traitement du code TVA

Appel

Appel Webservice
  • URL : http://masterdev/accountix/dap/lines?
  • Méthode : POST
  • Variables attendues :
    • OPETYP = vide
    • TVAID = valeur
    • DOC = valeur
    • DEVISE = valeur
    • OBJET = valeur
    • JNL (Journal FI ou OD) = valeur
    • DATE = valeur
    • DBMNT (Débit en devise de ligne) = valeur
    • CRMNT (Crédit en devise de ligne) = valeur
    • DBREC (Débit en devise du financier) = valeur
    • CRREC (Crédit en devise du financier) = valeur
Résultat

Variable = format tableau 

[
    {
        "Trt": "1",
        "Account": "6000000",
        "Debit": "0.00",
        "Credit": "1068.38",
        "RecDebit": "0.00",
        "RecCredit": "1068.38",
        "LineDevise": "EUR",
        "LineDebit": "0.00",
        "LineCredit": "1068.38",
        "Object": "TEST",
        "Tva": "V17"
    },
    {
        "Trt": "2",
        "Account": "4457000",
        "Debit": "",
        "Credit": "181.62",
        "RecDebit": "0.00",
        "RecCredit": "181.62",
        "LineDevise": "EUR",
        "LineDebit": "0.00",
        "LineCredit": "181.62",
        "Object": "TEST",
        "Tva": ""
    }
]

Le tableau de retour contient toujours la ligne maîtresse (valeur d'appel) en ligne 1, dont les valeurs ont été éventuellement adaptées. Ce qui signifie que le programme appelant DOIT rafraîchir sa ligne courante.

insoft/ac/doc/webservice/dap.txt · Dernière modification: 15/09/2015 07:37 par Yassine
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki