క్రొయేషియా యొక్క 2026 ఇ-ఇన్వాయిస్ నిబంధన PHP డెవలపర్‌లను వాలిడేషన్‌ను మళ్ళీ రూపొందించేలా చేస్తోంది – పన్ను అధికారి సంస్థ యొక్క Schematron ఫైల్ XSLT 2.0 పై ఆధారపడి ఉంది, కానీ ప్రధాన PHP XSLT ఇంజిన్ XSLT 1.0 ని మాత్రమే సపోర్ట్ చేస్తుంది. దీని ఫలితం: చాలా అకౌంటింగ్ యాప్‌లు వర్క్‌అరౌండ్ లేకుండా 62 తప్పనిసరి బిజినెస్-రూల్ తనిఖీలను నిర్వహించలేవు, మరియు తిరస్కరించబడిన ఇన్‌వాయిస్ B2B నగదు ప్రవాహాన్ని నిలిపివేయవచ్చు.

ఈ సాంకేతిక అడ్డంకి ఎందుకు ముఖ్యమైనది

1 జనవరి 2026 నుండి క్రొయేషియాలోని ప్రతి B2B లావాదేవీ 62 నిర్దిష్ట వాలిడేషన్ నియమాలకు అనుగుణంగా ఒక e-Račun రూపంలో మారాలి. పన్ను పరిపాలన (Tax Administration) ఆ నియమాలను Schematron ఫైల్‌గా ప్రచురిస్తుంది – ఇది ప్రాథమికంగా ఉల్లంఘనలను గుర్తించే ఒక XSLT 2.0 స్టైల్‌షీట్. ప్రముఖ xsltproc మరియు చాలా Composer ప్యాకేజీలకు శక్తినిచ్చే PHP యొక్క అంతర్గత libxslt లైబ్రరీ, XSLT 1.0 ని మాత్రమే అమలు చేస్తుంది. XSLT 2.0 సపోర్ట్ లేకపోతే Schematronను వర్తింపజేయలేము, అంటే PHP ఆధారిత ఇన్‌వాయిసింగ్ సిస్టమ్ పన్ను పోర్టల్ తిరస్కరించే ఇన్‌వాయిస్‌లను రూపొందిస్తుంది లేదా మరొక భాష లేదా సర్వీస్‌ను సంప్రదించాల్సి ఉంటుంది.

డెవలపర్లు అనుసరించగల మూడు మార్గాలు

ఎంపిక ఇందులో ఏముంటుంది ఆచరణాత్మక లోపాలు
SaxonC PECL extension Saxon-C ప్రాసెసర్‌ను నేటివ్ PHP ఎక్స్‌టెన్షన్‌గా ఇన్‌స్టాల్ చేసి, నేరుగా Schematronను పిలవవచ్చు. ఈ ఎక్స్‌టెన్షన్ సాధారణ Composer వర్క్‌ఫ్లోలో భాగం కాదు; వివిధ సర్వర్‌లలో నేటివ్ బైనరీలను నిర్మించడం మరియు మోహరించడం (deploy) సంక్లిష్టతను పెంచుతుంది.
External validation service మీ తరపున Schematronను నడిపించే వెబ్-సర్వీస్‌కు XMLను పంపడం. ప్రతి ఇన్‌వాయిస్ ఇప్పుడు నెట్‌వర్క్ లాటెన్సీ మరియు సర్వీస్ లభ్యతపై ఆధారపడి ఉంటుంది; తాత్కాలిక అంతరాయం ఇన్‌వాయిసింగ్‌ను పూర్తిగా నిలిపివేయవచ్చు.
Re-implement the rules in PHP 62 Schematron అస్సెర్షన్లను నేటివ్ PHP కోడ్‌లోకి అనువదించడం. దీనికి ముందుగా కృషి అవసరం, కానీ ఒకసారి కోడ్ చేసిన తర్వాత వాలిడేటర్ లోకల్‌గా నడుస్తుంది, ఏ PHP స్టాక్‌తోనైనా సులభంగా కలిసిపోతుంది మరియు బాహ్య ఆధారితాలను (external dependencies) తొలగిస్తుంది.

సాధారణ అమలులను తప్పుదారి పట్టించే దాగి ఉన్న లాజిక్

Schematron యొక్క సాధారణ అనువాదం కూడా సూక్ష్మమైన అర్థాలను (semantics) విస్మరించవచ్చు. ఉదాహరణకు నియమం HR-BR-4: "చెల్లించాల్సిన మొత్తం సున్నా కంటే ఎక్కువగా ఉంటే గడువు తేదీ (due date) తప్పనిసరిగా ఉండాలి." క్రెడిట్ నోట్ల కోసం ఇన్‌వాయిస్ మొత్తాన్ని –1 తో గుణించే వేరియబుల్‌ను Schematron నిర్వచిస్తుంది. ముడి XMLలో క్రెడిట్ నోట్ పాజిటివ్ మొత్తాన్ని చూపుతుంది, కానీ వేరియబుల్ దానిని నెగటివ్‌గా మారుస్తుంది, కాబట్టి "సున్నా కంటే ఎక్కువ" అనే నిబంధన తప్పు అవుతుంది. వాలిడేటర్ కేవలం అస్సెర్షన్ టెక్స్ట్‌ను మాత్రమే చదివితే, అది ప్రతి క్రెడిట్ నోట్‌ను తిరస్కరిస్తుంది.

పాఠం స్పష్టంగా ఉంది: తగిన PHP కండిషన్‌ను కోడ్ చేయడానికి ముందు Schematronలోని వేరియబుల్ నిర్వచనాలను చదవండి. అంకగణితం లేదా స్ట్రింగ్ మానిప్యులేషన్ $ వేరియబుల్ వెనుక దాగి ఉన్న ఇతర నియమాలలో కూడా ఇదే విధానం కనిపిస్తుంది.

సాధారణ తిరస్కరణ కారణాలు

నియమాలను సరిగ్గా కోడ్ చేసినప్పటికీ, పన్ను వ్యవస్థ ప్రాణాంతక లోపాలుగా పరిగణించే ఇన్‌వాయిస్ ఎలిమెంట్లను డెవలపర్లు తరచుగా విస్మరిస్తారు:

  • Missing operator details – ప్రతి ఇన్‌వాయిస్‌లో ఆపరేటర్ యొక్క పూర్తి పేరు మరియు OIB (క్రొయేషియన్ వ్యక్తిగత గుర్తింపు సంఖ్య) ఉండాలి. ఏదైనా ఫీల్డ్ ఖాళీగా ఉంటే వెంటనే తిరస్కరించబడుతుంది.
  • Empty XML tags – <cbc:Note></cbc:Note> వంటి ట్యాగ్‌లు వాలిడేటర్‌ను క్రాష్ చేస్తాయి. ఖాళీ ఎలిమెంట్లను తొలగించడం లేదా వాటిని ప్లేస్‌హోల్డర్ స్ట్రింగ్‌తో నింపడం ద్వారా ఈ సమస్యను పరిష్కరించవచ్చు.
  • Incorrect KPD codes – Klasifikacija proizvoda i usluga (KPD) కోడ్ కనీసం ఆరు అంకెలు ఉండాలి. తక్కువ అంకెలు ఉన్న కోడ్‌లను తప్పుగా గుర్తించబడతాయి.
  • Invalid dates – ఇతర అంశాలు సరిగ్గా ఉన్నప్పటికీ, 1 జనవరి 2026 కంటే ముందు తేదీ ఉన్న ఏ ఇన్‌వాయిస్ అయినా తప్పనిసరి-తేదీ నియమాన్ని విఫలం చేస్తుంది.

టెస్టింగ్ లోపాలు

పన్ను పరిపాలన డెవలపర్‌ల కోసం నమూనా e-Račun ఫైల్‌లను ప్రచురిస్తుంది. ఆ ఉదాహరణలలో ఇంకా 2025 తేదీలు మరియు 2026 నియమాలకు సరిపోని OIBలు ఉన్నాయి. వాటిని మాత్రమే ప్రామాణికంగా వాడటం వల్ల తప్పుడు భరోసా లభిస్తుంది. అధికారిక నమూనాలను కేవలం పార్సర్ శానిటీ చెక్ (parser sanity check) కోసం మాత్రమే ఉపయోగించండి, ఆపై మీ అప్లికేషన్ ద్వారా రూపొందించబడిన వాస్తవిక డేటాతో మీ స్వంత నియమ అమలు సూట్‌ను (rule-enforcement suite) రన్ చేయండి.

ఇప్పటికే అందుబాటులో ఉన్న PHP-ఓన్లీ పరిష్కారం

ఒక డెవలపర్ రీ-ఇంప్లిమెంటేషన్ మార్గాన్ని పూర్తి చేసి, 62 వాలిడేషన్ నియమాలన్నింటినీ Laravel ప్రాజెక్ట్‌ల కోసం Composer-installable లైబ్రరీగా ప్యాకేజ్ చేశారు. ఈ లైబ్రరీ Schematron దాచి ఉంచే అంకగణితం, వేరియబుల్ స్కోపింగ్ మరియు ఎడ్జ్-కేస్ తనిఖీలను నిర్వహిస్తుంది, దీనివల్ల ఇన్‌వాయిస్‌లను పూర్తిగా PHP రన్‌టైమ్‌లోనే వాలిడేట్ చేయవచ్చు. XSLT 2.0 మరియు బాహ్య కాల్స్‌ను తొలగించడం ద్వారా, ఈ ప్యాకేజీ నిబంధనల అమలుకు ఒక నిర్ధారితమైన (deterministic), తక్కువ-లాటెన్సీ మార్గాన్ని అందిస్తుంది.

సోర్స్ కోడ్ మరియు వినియోగ గైడ్ రచయిత యొక్క పబ్లిక్ రిపోజిటరీలో అందుబాటులో ఉన్నాయి (అసలు పోస్ట్‌లో లింక్ అందించబడింది).

తదుపరి గమనించవలసినవి

  • కమ్యూనిటీ ఆధారిత PHP వాలిడేటర్లు – మరింత మంది డెవలపర్లు రీ-ఇంప్లిమెంటేషన్ విధానాన్ని అవలంబిస్తున్న కొద్దీ, యూనిట్-టెస్ట్ ఫిక్చర్‌లు, ఇతర ఫ్రేమ్‌వర్క్‌ల మద్దతు లేదా పనితీరు మెరుగుదలలను జోడించే ఫోర్క్‌లు మరియు ఎక్స్‌టెన్షన్‌లను ఆశించవచ్చు.

ముగింపు

క్రొయేషియా యొక్క 2026 ఇ-ఇన్వాయిస్ నిబంధన, ఆధునిక XSLT 2.0 Schematron మరియు ఈ భాష యొక్క పాత XSLT 1.0 ఇంజిన్ మధ్య ఉన్న అసమతుల్యతను PHP డెవలపర్లు ఎదుర్కోవాల్సి వచ్చేలా చేస్తుంది. 62 బిజినెస్ రూల్స్‌ను నేటివ్ PHPలోకి అనువదించడం, దాగి ఉన్న వేరియబుల్ లాజిక్‌ను గమనించడం మరియు సాధారణ XML లోపాలను నివారించడం ద్వారా ఇన్‌వాయిసింగ్‌ను ఇన్‌-హౌస్‌లోనే ఉంచుకోవచ్చు, నెట్‌వర్క్ సంబంధిత వైఫల్యాలను తప్పించుకోవచ్చు మరియు గడువు ముగిసే సమయానికి అకౌంటింగ్ సాఫ్ట్‌వేర్‌ను సులభమైన, నిబంధనలకు అనుగుణమైన రోల్‌అవుట్‌కు సిద్ధం చేయవచ్చు.