Skip to content

platformaERP - reprezentacja dokumentu XML

Reprezentacja dokumentu XML dla interfejsów zewnętrznych. Używana w interfejsie finansowo-księgowym (np. Rewizor).

Możliwe tryby

Wartość Opis Główna tabela
invoice Faktura sprzedaży document.invoice
invoicepurchase Faktura zakupu document.invoice
document Dokument magazynowy document.document

Struktura zwracanego XML

XML
<data>
  <document>...</document>   <!-- nagłówek dokumentu -->
  <lines>
    <line>...</line>         <!-- pozycje -->
  </lines>
  <signatures>               <!-- akceptacje elektroniczne tylko invoicepurchase -->
    <line>...</line>
  </signatures>
  <relations>                <!-- powiazane dokumenty magazynowe i inne -->
    <line>...</line>
  </relations>
</data>

Tryb invoicepurchase — Faktura zakupu

SQL
dbo.fn_decodeXML('92e26d5c-e9ac-47fd-bab7-2cee3d247d20', 'invoicepurchase')

<document> — Nagłówek faktury zakupu

Pole Typ Opis
invoiceID uniqueidentifier ID faktury
invoiceFullNR varchar Numer własny (wewnętrzny)
invoiceFullNR2 varchar Numer obcy (dostawcy)
referenceNumber varchar Numer referencyjny (np. KSeF)
warehouseCode varchar Kod magazynu
invoiceIssueDate date Data wystawienia
paymentDate date Termin płatności
saleDate date Data sprzedaży
currency varchar Waluta (domyślnie PLN)
currencyExchangeRate varchar Kurs waluty (NULL jeśli brak)
currencyexchangetablenumber varchar Nr tabeli kursów NBP (NULL jeśli brak)
netValue decimal Wartość netto w walucie dokumentu
grossValue decimal Wartość brutto w walucie dokumentu
vatValue decimal Kwota VAT w walucie dokumentu
sysNetValue decimal Wartość netto w walucie systemowej (PLN)
sysGrossValue decimal Wartość brutto w walucie systemowej
sysVatValue decimal Kwota VAT w walucie systemowej
addDate datetime Data dodania rekordu
addUsername varchar Login użytkownika dodającego
firmName varchar Nazwa wystawcy
firmAccount varchar Konto bankowe wystawcy
firmNR varchar Numer kartoteki wystawcy
firmCountrycode varchar Kod kraju wystawcy (domyślnie PL)
firmTaxCode varchar NIP wystawcy
invoiceCategory varchar Typ dokumentu (np. ZM)
baseDocumentType varchar Bazowy typ wg document.documentType (np. PurInv)
isForeignDocument bit Czy dokument zagraniczny
isAdvanceInvoice bit Czy faktura zaliczkowa
documentCategory varchar Kategoria (commercial / commercC dla korekty)
accountingRegister varchar Rejestr księgowy
accountingTYPE varchar Typ księgowy

<lines> — Pozycje faktury zakupu

Pole Typ Opis
invoiceOrdinalNumber int Numer porządkowy pozycji
itemPrice decimal Cena jednostkowa w walucie dokumentu
sysItemPrice decimal Cena jednostkowa w walucie systemowej
itemQuantity decimal Ilość
netValue decimal Wartość netto pozycji
sysNetValue decimal Wartość netto pozycji w PLN
itemSerialNumber varchar Numer seryjny
isCorrectiveLine bit Czy pozycja korygująca
itemCode varchar Kod towaru (wms.item.itemCode)
itemUnit varchar Jednostka miary (ze słownika common.dictionary)
itemNameCommercial varchar Nazwa handlowa (z linii lub z kartoteki towaru)
itemGroupName varchar Nazwa grupy asortymentowej
itemGroupAccount varchar Konto księgowe grupy
itemGroupPrefix varchar Prefiks grupy (dictionaryurl)
gtu varchar Kod GTU
pkwiu varchar Kod PKWiU
cn varchar Kod CN
orderFullNR varchar Numer powiązanego zamówienia

<signatures> — Podpisy / akceptacje elektronicze

Pole Typ Opis
signature_email varchar Email osoby podpisującej
signature_sign_date datetime Data i godzina podpisu
signature_status int Status: 0=Oczekuje, 10=Odrzucony, 30=Podpis-Inny, 40=Podpisany
signature_status_text varchar Opis statusu (generowany przez CASE)
signature_level varchar Poziom akceptacji (np. 80 dyrektor, 90 zarzad)
signature_comment varchar Komentarz do podpisu

<relations> — Powiązania z dokumentami magazynowymi

Pole Typ Opis
documentFullNR varchar Numer dokumentu z numerem porządkowym (np. SPZ/394/1/2026)
documentOrdinalNumber int Numer porządkowy dokumentu
documentDate date Data dokumentu magazynowego
itemCode varchar Kod towaru
itemName varchar Nazwa towaru (skrócona lub pełna)
itemQuantity decimal Ilość (uwzględnia znaki korekt sign)
itemValue decimal Wartość pozycji

Przykładowy wynik — invoicepurchase

XML
<data>
  <document>
    <invoiceID>92E26D5C-E9AC-47FD-BAB7-2CEE3D247D20</invoiceID>
    <invoiceFullNR>SZM158/05/2026</invoiceFullNR>
    <invoiceFullNR2>5494/STR/05/2026</invoiceFullNR2>
    <referenceNumber>XXXXXXXXXX-20260522-XXXXXXXXXX-CC</referenceNumber>
    <warehouseCode>1</warehouseCode>
    <invoiceIssueDate>2026-05-22</invoiceIssueDate>
    <paymentDate>2026-06-21</paymentDate>
    <saleDate>2026-05-20</saleDate>
    <currency>PLN</currency>
    <currencyExchangeRate>NULL</currencyExchangeRate>
    <currencyexchangetablenumber>NULL</currencyexchangetablenumber>
    <netValue>1621.00</netValue>
    <grossValue>1993.83</grossValue>
    <vatValue>372.83</vatValue>
    <sysNetValue>1621.00</sysNetValue>
    <sysGrossValue>1993.83</sysGrossValue>
    <sysVatValue>372.83</sysVatValue>
    <addDate>2010-05-22T09:16:14.633</addDate>
    <addUsername>a.kowalska</addUsername>
    <firmID>127D7568-85CE-4778-8E13-78211D84E108</firmID>
    <firmName>XXXXXXXXXXXXXXXX</firmName>
    <firmAccount>NULL</firmAccount>
    <firmNR>2039</firmNR>
    <firmCountrycode>PL</firmCountrycode>
    <firmTaxCode>XXXXXXXXXXXXXXXX</firmTaxCode>
    <invoiceCategory>ZM</invoiceCategory>
    <baseDocumentType>PurInv</baseDocumentType>
    <isForeignDocument>0</isForeignDocument>
    <isAdvanceInvoice>0</isAdvanceInvoice>
    <documentCategory>commercial</documentCategory>
    <accountingRegister>NULL</accountingRegister>
    <accountingTYPE>NULL</accountingTYPE>
  </document>
  <lines>
    <line>
      <invoiceOrdinalNumber>1</invoiceOrdinalNumber>
      <itemPrice>0.70</itemPrice>
      <sysItemPrice>0.70</sysItemPrice>
      <itemQuantity>10.0000</itemQuantity>
      <netValue>7.00</netValue>
      <sysNetValue>7.00</sysNetValue>
      <isCorrectiveLine>0</isCorrectiveLine>
      <itemCode>S01MA00005093</itemCode>
      <itemUnit>szt</itemUnit>
      <itemNameCommercial>USZCZ. DN 15/4 NBR</itemNameCommercial>
      <itemGroupName>MECHANICZNE</itemGroupName>
      <itemGroupAccount>NULL</itemGroupAccount>
      <itemGroupPrefix>MA</itemGroupPrefix>
      <gtu>NULL</gtu>
      <pkwiu>NULL</pkwiu>
      <cn>NULL</cn>
      <orderFullNR>SZZ130/202605</orderFullNR>
    </line>
    <line>
      <invoiceOrdinalNumber>2</invoiceOrdinalNumber>
      <itemPrice>29.00</itemPrice>
      <sysItemPrice>29.00</sysItemPrice>
      <itemQuantity>20.0000</itemQuantity>
      <netValue>580.00</netValue>
      <sysNetValue>580.00</sysNetValue>
      <isCorrectiveLine>0</isCorrectiveLine>
      <itemCode>S01MA00005701</itemCode>
      <itemUnit>szt</itemUnit>
      <itemNameCommercial>ZAWÓR KULOWY 3/4" mat 316 K.O /z blokada pokretla/</itemNameCommercial>
      <itemGroupName>MECHANICZNE</itemGroupName>
      <itemGroupAccount>NULL</itemGroupAccount>
      <itemGroupPrefix>MA</itemGroupPrefix>
      <gtu>NULL</gtu>
      <pkwiu>NULL</pkwiu>
      <cn>NULL</cn>
      <orderFullNR>SZZ130/202605</orderFullNR>
    </line>
    <line>
      <invoiceOrdinalNumber>3</invoiceOrdinalNumber>
      <itemPrice>65.00</itemPrice>
      <sysItemPrice>65.00</sysItemPrice>
      <itemQuantity>10.0000</itemQuantity>
      <netValue>650.00</netValue>
      <sysNetValue>650.00</sysNetValue>
      <isCorrectiveLine>0</isCorrectiveLine>
      <itemCode>S01MA00005696</itemCode>
      <itemUnit>szt</itemUnit>
      <itemNameCommercial>ZAWÓR KULOWY 1.1/2" mat 316 K.O. /z blokada pokretla/</itemNameCommercial>
      <itemGroupName>MECHANICZNE</itemGroupName>
      <itemGroupAccount>NULL</itemGroupAccount>
      <itemGroupPrefix>MA</itemGroupPrefix>
      <gtu>NULL</gtu>
      <pkwiu>NULL</pkwiu>
      <cn>NULL</cn>
      <orderFullNR>SZZ130/202605</orderFullNR>
    </line>
    <line>
      <invoiceOrdinalNumber>4</invoiceOrdinalNumber>
      <itemPrice>52.00</itemPrice>
      <sysItemPrice>52.00</sysItemPrice>
      <itemQuantity>2.0000</itemQuantity>
      <netValue>104.00</netValue>
      <sysNetValue>104.00</sysNetValue>
      <isCorrectiveLine>0</isCorrectiveLine>
      <itemCode>S01MA00017888</itemCode>
      <itemUnit>szt</itemUnit>
      <itemNameCommercial>FILTR SIATKOWY SKOSNY DN 25 1" K.O. DO GAZU</itemNameCommercial>
      <itemGroupName>MECHANICZNE</itemGroupName>
      <itemGroupAccount>NULL</itemGroupAccount>
      <itemGroupPrefix>MA</itemGroupPrefix>
      <gtu>NULL</gtu>
      <pkwiu>NULL</pkwiu>
      <cn>NULL</cn>
      <orderFullNR>SZZ130/202605</orderFullNR>
    </line>
    <line>
      <invoiceOrdinalNumber>5</invoiceOrdinalNumber>
      <itemPrice>70.00</itemPrice>
      <sysItemPrice>70.00</sysItemPrice>
      <itemQuantity>4.0000</itemQuantity>
      <netValue>280.00</netValue>
      <sysNetValue>280.00</sysNetValue>
      <isCorrectiveLine>0</isCorrectiveLine>
      <itemCode>S01MA00021522</itemCode>
      <itemUnit>szt</itemUnit>
      <itemNameCommercial>ZAWÓR GRZYBKOWY SKOSNY 1 " GW/GW 316</itemNameCommercial>
      <itemGroupName>MECHANICZNE</itemGroupName>
      <itemGroupAccount>NULL</itemGroupAccount>
      <itemGroupPrefix>MA</itemGroupPrefix>
      <gtu>NULL</gtu>
      <pkwiu>NULL</pkwiu>
      <cn>NULL</cn>
      <orderFullNR>SZZ130/202605</orderFullNR>
    </line>
  </lines>
  <signatures>
    <line>
      <signature_email>p.nowak</signature_email>
      <signature_sign_date>2026-05-26T09:40:00</signature_sign_date>
      <signature_status>40</signature_status>
      <signature_level>80 dyrektor</signature_level>
      <signature_comment />
      <signature_status_text>Podpisany</signature_status_text>
    </line>
    <line>
      <signature_email>j.kowalski</signature_email>
      <signature_sign_date>2026-05-29T09:40:00</signature_sign_date>
      <signature_status>40</signature_status>
      <signature_level>90 zarzad</signature_level>
      <signature_comment />
      <signature_status_text>Podpisany</signature_status_text>
    </line>
  </signatures>
  <relations>
    <line>
      <documentFullNR>SPZ/394/1/2026</documentFullNR>
      <documentOrdinalNumber>1</documentOrdinalNumber>
      <documentDate>2026-05-22</documentDate>
      <itemCode>S01MA00005093</itemCode>
      <itemName>USZCZ. DN 15/4 NBR</itemName>
      <itemQuantity>10.000</itemQuantity>
      <itemValue>7.00</itemValue>
    </line>
    <line>
      <documentFullNR>SPZ/394/1/2026</documentFullNR>
      <documentOrdinalNumber>2</documentOrdinalNumber>
      <documentDate>2026-05-22</documentDate>
      <itemCode>S01MA00005701</itemCode>
      <itemName>ZAWÓR KULOWY 3/4" K.O</itemName>
      <itemQuantity>20.000</itemQuantity>
      <itemValue>580.00</itemValue>
    </line>
    <line>
      <documentFullNR>SPZ/394/1/2026</documentFullNR>
      <documentOrdinalNumber>3</documentOrdinalNumber>
      <documentDate>2026-05-22</documentDate>
      <itemCode>S01MA00005696</itemCode>
      <itemName>ZAWÓR KULOWY 1.1/2" K.O.</itemName>
      <itemQuantity>10.000</itemQuantity>
      <itemValue>650.00</itemValue>
    </line>
    <line>
      <documentFullNR>SPZ/394/1/2026</documentFullNR>
      <documentOrdinalNumber>4</documentOrdinalNumber>
      <documentDate>2026-05-22</documentDate>
      <itemCode>S01MA00017888</itemCode>
      <itemName>FILTR SIATKOWY SKOŚNY DN 25 1" K.O. DO GAZU</itemName>
      <itemQuantity>2.000</itemQuantity>
      <itemValue>104.00</itemValue>
    </line>
    <line>
      <documentFullNR>SPZ/394/1/2026</documentFullNR>
      <documentOrdinalNumber>5</documentOrdinalNumber>
      <documentDate>2026-05-22</documentDate>
      <itemCode>S01MA00021522</itemCode>
      <itemName>ZAWÓR GRZYBKOWY SKOŚNY 1 " GW/GW 316</itemName>
      <itemQuantity>4.000</itemQuantity>
      <itemValue>280.00</itemValue>
    </line>
  </relations>
</data>