📄 TXT2INV Plugin - Vodič za programere

1. Ping test

GET /txt2inv/ping

JavaScript fetch:

fetch('/txt2inv/ping')
  .then(response => response.text())
  .then(data => console.log(data));

2. Konverzija INI → JSON

POST /txt2inv/parse
Content-Type: text/plain; charset=UTF-8

INIVERSION=1
ID=25-5555-S1-1
IssueDate=2025-12-15

[Supplier]
Name=Cvjećarna Silvia
CompanyID=81016300664

[Line]
Quantity=2.000
Name=Coca Cola
Price=7.92

JavaScript fetch:

const iniContent = `INIVERSION=1
ID=25-5555-S1-1
IssueDate=2025-12-15

[Supplier]
Name=Cvjećarna Silvia
CompanyID=81016300664

[Line]
Quantity=2.000
Name=Coca Cola
Price=7.92`;

fetch('/txt2inv/parse', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain; charset=UTF-8'
  },
  body: iniContent
})
.then(response => response.json())
.then(json => console.log(JSON.stringify(json, null, 2)));

3. Konverzija INI → UBL XML

JavaScript fetch (osnovno):

fetch('/txt2inv/xml', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain; charset=UTF-8'
  },
  body: iniContent
})
.then(response => response.text())
.then(xml => console.log(xml));

JavaScript fetch sa namespace cleanup:

// Generira XML i uklanja nekorištene namespace deklaracije
fetch('/txt2inv/xml?cleannamespaces=true', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain; charset=UTF-8'
  },
  body: iniContent
})
.then(response => response.text())
.then(xml => console.log('Čisti XML:', xml));

// Sa preserve listom (npr. za potpis kasnije)
fetch('/txt2inv/xml?cleannamespaces=true&preserve=xsi,ds,xades', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain; charset=UTF-8'
  },
  body: iniContent
})
.then(response => response.text())
.then(xml => console.log('XML za potpis:', xml));

4. cURL primjer - Parse

curl -X POST http://localhost:8084/txt2inv/parse \
  -H "Content-Type: text/plain; charset=UTF-8" \
  --data-binary @racun.txt

5. cURL primjer - XML

# Osnovna konverzija
curl -X POST http://localhost:8084/txt2inv/xml \
  -H "Content-Type: text/plain; charset=UTF-8" \
  --data-binary @racun.txt \
  -o invoice.xml

# Sa namespace cleanup
curl -X POST "http://localhost:8084/txt2inv/xml?cleannamespaces=true" \
  -H "Content-Type: text/plain; charset=UTF-8" \
  --data-binary @racun.txt \
  -o invoice-clean.xml

# Sa preserve listom za potpis
curl -X POST "http://localhost:8084/txt2inv/xml?cleannamespaces=true&preserve=xsi,ds" \
  -H "Content-Type: text/plain; charset=UTF-8" \
  --data-binary @racun.txt \
  -o invoice-for-signing.xml

6. Provjera minimalnih polja

fetch('/txt2inv/checkMinimal', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain; charset=UTF-8'
  },
  body: iniContent
})
.then(response => response.json())
.then(json => {
  console.log('Valid:', json.valid);
  console.log('Missing:', json.missing);
});

7. Reversna konverzija XML → INI

// Učitaj XML sadržaj
const xmlContent = `<?xml version="1.0" encoding="UTF-8"?>
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2"
         xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2"
         xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2">
  <cbc:ID>25-5555-S1-1</cbc:ID>
  <cbc:IssueDate>2025-12-15</cbc:IssueDate>
  ...
</Invoice>`;

fetch('/txt2inv/xml2ini', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/xml; charset=UTF-8'
  },
  body: xmlContent
})
.then(response => response.text())
.then(iniContent => {
  console.log('Konvertirani INI format:');
  console.log(iniContent);
});

cURL primjer - XML → INI:

curl -X POST http://localhost:8449/txt2inv/xml2ini \
  -H "Content-Type: application/xml; charset=UTF-8" \
  --data-binary @invoice.xml \
  -o racun.txt

1. Konverzija INI → JSON (POST file)

http:NOENCODEPOST
/txt2inv/parse
file=racun.txt 
text/html

2. Konverzija INI → UBL XML (POST file)

# Osnovna konverzija
http:NOENCODEPOST
/txt2inv/xml
file=racun.txt 
text/html

# Sa namespace cleanup
http:NOENCODEPOST
/txt2inv/xml?cleannamespaces=true
file=racun.txt 
text/html

# Sa preserve listom (za potpis)
http:NOENCODEPOST
/txt2inv/xml?cleannamespaces=true&preserve=xsi,ds,xades
file=racun.txt 
text/html

3. Provjera ispravnosti INI datoteke

http:NOENCODEPOST
/txt2inv/validate
file=racun.txt 
text/html

4. Provjera minimalnih polja (POST file)

http:NOENCODEPOST
/txt2inv/checkMinimal
file=racun.txt 
text/html

5. Slanje ini fajla direktno provajderu

http:NOENCODEPOST
/txt2inv/sendTo/doku
file=racun.txt 
text/html

6. Pregled računa u HTML formatu (POST file)

http:NOENCODEPOST
/txt2inv/preview
file=racun.txt
text/html

7. Generiranje PDF računa (POST file)

http:NOENCODEPOST
/txt2inv/getinvoicepdf
file=racun.txt
text/html

8. Generiranje INI datoteke od Invoice XMLa (POST file)

http:NOENCODEPOST
/txt2inv/xml2ini
file=Invoice.xml
text/html

9. Generiranje jednostavne TXT datoteke parsiranjem Invoice XMLa po dubini (POST file)

http:NOENCODEPOST
/txt2inv/xmltoflat
file=Invoice.xml
text/html