Differences

This shows you the differences between two versions of the page.

--- kb:kb:dodatni_moduli:modul_20_main [2025/04/04 11:05] – [JSON "procedures"] milano
+++ kb:kb:dodatni_moduli:modul_20_main [2025/07/25 11:38] (current) – [JSON "procedure"] milano
@@ Line 3: / Line 3: @@
 Modul proširuje Balans procedurama za izradu velikog broja računa (billing) prema pravilima registrovanim u ugovorima.
+===== Markeri =====
+Sledeći markeri (//markup text//) biće dinamički zamenjeni odgovarajućim vrednostima iz okruženja:
+^ Marker ^ Značenje ^ Napomena ^
+|''<nowiki>{{</nowiki>cassa_amount<nowiki>}}</nowiki>''|Ukupan iznos uslovnog rabata.|Iznos uslovnog rabata koji se može ostvariti izražen u valuti računa <code>blnsDDIzlaz.TotCassa</code>.|
+|''<nowiki>{{</nowiki>cassa_duedate<nowiki>}}</nowiki>''|Datum do kada treba izvršiti uplatu.|Datum je zadat u //short date// formatu.|
+|''<nowiki>{{</nowiki>cassa_percent<nowiki>}}</nowiki>''|Ukupno umanjenje izraženo kroz procenat od početne vredosti.| |
+|''<nowiki>{{</nowiki>cassa_reducedtotal<nowiki>}}</nowiki>''|Vrednost računa umanjena za vrednost uslovnog rabata.| Formula je <code>Format(blnsDDIzlaz.Total - blnsDDIzlaz.TotCassa, gcRNDSTD)</code>.|
+|''<nowiki>{{</nowiki>cassa_valuta<nowiki>}}</nowiki>''|Oznaka valute u kojoj su izraženi iznosi kase.| |
+|''<nowiki>{{</nowiki>transmonth_srb<nowiki>}}</nowiki>''|Naziv meseca datuma prometa na srpskom.|Postojanje ovog markera automatski prikazuje izbornik datuma prometa na formi za odabir ugovora.|
+|''<nowiki>{{</nowiki>transyear_num<nowiki>}}</nowiki>''|Godina (u vidu broja) datuma prometa.|Postojanje ovog markera automatski prikazuje izbornik datuma prometa na formi za odabir ugovora.|
 ===== Parametri =====
 Parametri modula zadaju se JSON objektom u polju **Parametri** definicije modula (''fn_dodatnimoduli'').
@@ Line 9: / Line 21: @@
 <code>
 {
-   {"procedures":[{}]} -- matrica billing procedura sa različitim postavkama obračuna (minimalno jedan član).
+   {"procedures":[{JSON "procedure"}]} -- matrica billing procedura sa različitim postavkama obračuna (minimalno jedan član).
 }
 </code>
-==== JSON "procedures" ====
+==== JSON "procedure" ====
 <code>
 [
    {
-       "procedure_id":<procedure code>        -- Numerička oznaka procedure iz enumeratora BE_BillingProcedures, služi za rutiranje procedure kroz Billing sistem.
+       "procedure_id":<procedure code>        -- Numerička oznaka procedure - jedinstvena unutar matrice definisanih procedura.
        "procedure_name":"<naziv procedure>"   -- Naziv procedure od značaja za korisnika. Ovo će biti prikazano u izborniku.
+       "procedure_type":<be_billingprocedure> -- Identifikator način obračuna iz enumeratora ''BE_BillingProcedures'', služi za rutiranje procedure kroz Billing sistem.
        "document_header":{}                   -- JSON objekat sa definicijom zaglavlja računa-obračuna.
        "line_item":{}                         -- JSON objekat sa definicijom linije računa.
+                                                 Ukoliko ne postoji ili je prazno linije će se povući prema definiciji u ugovoru. Pri tom važe zamene ''{{}}'' tagova u skladu sa definicijom.
        "payment_terms":{}                     -- JSON objekat sa parametrima sa uslovima plaćanja.
+       "invoicing_rules":{}                   -- JSON objekat sa posebnim pravilima pri izradi računa na bazi ugovora.
    }
 ]
@@ Line 37: / Line 52: @@
 {
     "issuing_date": "+-wd0"               -- Pomeraj u radnim danima datuma izdavanja računa.
-                                                       Može početi sa "+" ili "-" što znači da se dani dodaju ili oduzimaju.
+                                                       Mora početi sa "+" ili "-" što znači da se dani dodaju ili oduzimaju.
                                                        Sledi uvek dvokarakterska oznaka:
@@ Line 45: / Line 60: @@
                                                                                                             Ako jeste uzeće se dan koji joj prethodi, tj. subota.
                                                        "ad" bilo koji dan; Npr. "+ad2" znači: "Dva dana od sada, pa makar to bila i nedelja."
-                                                       "tx" poslednji dan poreskog perioda; Npr. "-tx1" znači "Poslednji dan prethodnog poreskog perioda".
+                                                       "ld" Poslednji dan meseca; Npr. "-ld1" znači "poslednji dan prethodnog meseca", dok "+ld0" znači "poslednji dan tekućeg meseca".
                                                        Nakon toga sledi broj dana/mesci/perioda na šta se već oznaka odnosila.
@@ Line 62: / Line 77: @@
     "id":<elid elementa>             -- Balans ''elementi.elid'' id artikla koji služi za iskazivanje obračuna.
     "stock_id":<sklid skladišta>     -- Balans ''skladista.sklid" Id skladišta sa kog će se stavka fakturisati.
-    "custom_text":"<Markup tekst>"   -- Markup tekst sa aktivnim elementima koji će biti zamenjeni odgovarajućim vrednostima pri izradi linije.
+    "custom_text":"<Markup text>"    -- Markup tekst sa aktivnim elementima koji će biti zamenjeni odgovarajućim vrednostima pri izradi linije.
-                                         {{transmonth_srb}} Naziv meseca datuma prometa na srpskom.
-                                         {{transyear_num}} Godina (u vidu broja) datuma prometa.
 }
 </code>
@@ Line 72: / Line 85: @@
 {
     "cassa":[{}]         -- Matrica definicija kasa skonta koje mogu da se dobiju ukoliko se ispune uslovi.
+}
+</code>
+=== JSON "invoicing_rules" ===
+<code>
+{
+    "qtt_mode":""        -- Oznaka koja govori kako se procesira podatak o količinama prilikom fakturisanja. Moguće vrednosti su:
+                                 "force_one"  - količina u fakturi je uvek jedan. U ovom slučaju cena će biti jednaka vrednosti ugovora ili vrednosti reda ukoliko se preuzima svaka stavka za sebe.
+                                 "contracted" - količina u fakturi biće preuzeta iz ugovora. Za cenu se uzima jedinična cena iz ugovora.
 }
 </code>
@@ Line 78: / Line 100: @@
 <code>
 {
-    "id":<id kasa skonta>               -- Id kasa-skonta koji će biti ubačen u račun (referenca na ''defCustData.CusID'')
+    "id":<id kasa skonta>,              -- Id kasa-skonta koji će biti ubačen u račun (referenca na ''defCustData.CusID'')
-    "due_term":["fixed_day"]            -- Način obračuna datuma važenja kase:
+    "due_term":["fixed_day"],           -- Način obračuna datuma važenja kase:
                                                     --   "fixed_day" znači da je zadat dan u mesecu zaključno sa kojim trba izvršiti zadati procenat da bi se kasa ostvarila.
-    "due_day":<dan u mesecu>            -- Dan u mesecu zaključno sa kojim treba izvršiti plaćanje.
+    "due_day":<dan u mesecu>,           -- Dan u mesecu zaključno sa kojim treba izvršiti plaćanje.
-    "due_perc":<procenat>               -- Procenat plaćanja koji treba da se izvrši za uzimanje kase.
+    "due_perc":<procenat>,              -- Procenat plaćanja koji treba da se izvrši za uzimanje kase.
+    "invoice_comment":"<napomena>"      -- Dodatak na prateći tekst računa u kom se ova kasa iskoristi. Napomena se provlači kroz marker-parser.
 }
 </code>