Karpacki Odział Handlowy – opis wymiany - PGNiG

Załącznik nr 2 D do Umowy na: „Wizualizowanie,
drukowanie i kopertowanie dokumentów oraz
przekazywanie korespondencji do operatora
pocztowego”
Karpacki Odział Handlowy – opis wymiany danych z Centrum Korespondencji Masowej
System
bilingowy
Megaz
Format danych
txt – faktury,
xml - wezwania
Biuro/Dział
Ilość JT
Ilość instalacji /
źródło danych
Biuro Handlowe Region
Tarnowski
13
1/2
Biuro Handlowe Region Krakowski
9
1/3
15
3/6
11
1/2
Dział Windykacji
8
4/0
Biuro Obsługi Klientów
Biznesowych
1
8/2
Biuro Handlowe Region
Sandomierski
Biuro Handlowe Region
Rzeszowski
Pliki wymiany danych.
1. Plik zawierający dane do wydruku
a. txt - faktury
b. xml - wezwania do zapłaty
2. Plik zwrotny – zawierający informacje o wydruku i nadaniu dokumentów
a. Brak
Szacowana ilość
użytkowników portalu
2 administratorów + 25
użytkowników
3 administratorów + 3
użytkowników
5 administrator + 14
1 administrator + 3
użytkowników
2 administratorów + 18
użytkowników
15 użytkowników
1
Struktura zbioru wychodzącego z systemu MeGaz - txt
Dane będą przekazywane poprzez zbiory tekstowe o ustalonej strukturze.
Zbiór składa się z linii, w których zapisywane są rekordy.
Rekordy mogą być różnego typu - typy rekordów wymieniono w p. 1.1.
W rekordach występują pola oddzielone od siebie znakiem kreski pionowej „|”.
W polach rekordów mogą wystąpić ciągi znaków, ujęte w znaki „#” (z obu stron). Interpretacja ciągu
zawartego między dwoma znakami „#” jest następująca:
- jeśli ciąg jest liczbą dziesiętną, to należy go traktować jako kod znaku, np.:
#13##10# – dwa znaki, pierwszy o kodzie 13 (nowa linia), drugi – 10 (powrót karetki),
#35#
- znak „#”,
#124#
- znak „|”,
- w każdym innym przypadku ciąg powinien być ignorowany.
Wartości liczbowe przedstawiające ceny, kwoty, ilości, itp. powinny mieć postać zgodną z formatem
określonym dla poszczególnych typów wartości - w konkretnych przypadkach format podany został
w tabelach definiujących typy rekordów. Niezależnie od tego część dziesiętna liczby powinna być
oddzielona od całkowitej znakiem przecinka.
Wszystkie daty zgodne są z formatem "RRRR-MM-DD", czyli 4 cyfry przedstawiające rok, 2 cyfry
przedstawiające miesiąc, 2 cyfry przedstawiające dzień miesiąca, rozdzielone myślnikami.
Plik wynikowy ma nazwę zgodną z następującą maską:
<IdentyfikatorGazowni><Data><NrLosowy>.mas
gdzie:
<IdentyfikatorGazowni> - numeryczny identyfikator Gazowni; przyjmuje następujące wartości dla
poszczególnych gazowni:
Identyfikator
1
2
3
4
5
6
7
8
Gazownia
Tarnów
Kraków
Rzeszów
Lublin
Kielce
Jasło
Jarosław
Sandomierz
<Data> - data w formacie rrmdd, gdzie: rr – dwie najmłodsze cyfry roku (np. dla roku 2009: 09), m –
miesiąc szesnastkowo (np. dla kwietnia: 4, dla października: a), dd – dzień miesiąca
<NrLosowy> - liczba z zakresu 0-999, uzupełniona zerami wiodącymi do długości 3 znaków.
1.1
Typy rekordów
Typ rekordu
Symbol
Uwagi
Inicjujący
I
Początek paczki dokumentów
Nagłówek
F
Rozpoczyna sekwencję wierszy dokumentu typu FB, FBP, NOB
Korekta
C
Rozpoczyna sekwencję wierszy dokumentu korygującego
Do dokumentu
D
Lista dokumentów korygowanych przez dokument korygujący
Lista faktur z blankietu
H
Lista faktur, które zawarte są na blankiecie zbiorczym
Lista prognoz
L
Lista FBP i FBPK rozliczanych przez FB (pozycja „ujęto w
prognozie”)
Sprzedawca
S
Informacje o sprzedawcy
Wystawca
W
Informacje o wystawcy
Nabywca
N
Informacje o nabywcy
Pozycja
P
Pozycja dokumentu (np.: rozliczenie punktu odczytowego, odsetki
do dokumentu)
Protokół rozliczeniowy
PR
Dot. Rozszerzenia dla interfejsu MeGaz-SCADA (opcjonalne dane
nagłówka protokołu)
Pomiar dzienny
Y
Dot. Rozszerzenia dla interfejsu MeGaz-SCADA (opcjonalne dane
pomiarowe dla każdego dnia okresu rozliczeniowego)
Korekta pomiarów
Q
Dot. Rozszerzenia dla interfejsu MeGaz-SCADA (opcjonalne dane
o korektach zużyć i/lub korekcie mocy)
Parametry gazu
G
Dot. Rozszerzenia dla interfejsu MeGaz-SCADA (opcjonalne dane
o zbadanych parametrach i składzie chemicznym gazu)
Było
B
Dot. faktury korygującej
Jest
J
Dot. faktury korygującej
Zmiany
M
Dot. faktury korygującej
Ujęto w prognozie
E
Ujęto w prognozie
Treść
T
Elementy składowe pozycji
Podsumowanie rekordów
Treść
O
Podsumowanie bloku następujących po sobie rekordów typu
Treść
Podsumowanie rekordów
Pozycja
PO
Podsumowanie bloku następujących po sobie rekordów typu
Pozycja
Podsumowanie (Razem)
R
Podsumowanie całej faktury – łącznie z ujętymi prognozami
Podsumowanie korekty
U
Informacja
K
Wrzutka
A
VAT-y
V
Podsumowanie w podziale na stawki VAT
Podpisał
UP
Użytkownik, który podpisał notę odsetkową (NOB).
Koniec faktury
X
Koniec wydruku
Z
1.1.1
Lp
Komentarz
Struktura rekordu „Inicjujący” I
Nazwa pola
Format
Uwagi
0
Typ rekordu
I
1
ID_paczki
Ciąg znaków tworzony zgodnie z algorytmem generowania
nazwy pliku wynikowego (p.2) w formacie:
<IdentyfikatorGazowni><Data><NrLosowy>
2
Nazwa
3
Data wypuszczenia
1.1.2
Lp
Struktura rekordu „Nagłówek” F
Nazwa pola
Format
Uwagi
0
Typ rekordu
F
1
Id faktury
Identyfikator faktury w systemie MeGaz
UWAGA! jest to informacja niedrukowana – nr ten powinien
pojawić się w pliku raportu zwrotnego (p. 3.1.2)
2
Typ dokumentu
np.: FB, FBP, NOB
Na podstawie tego pola określana jest nazwa dokumentu
na wydruku (np. dla FB jest to „Faktura VAT”).
UWAGA! W przypadku gdy pole przyjmuje wartość FB,
a pole Wartość Brutto (3) w strukturze R (p.2.1.21) zawiera
wartość ujemną to zamiast „Faktura VAT” należy
wydrukować nazwę „Faktura korygująca”.
3
Nr faktury
4
Data wystawienia
RRRR-MM-DD
5
Data sprzedaży
RRRR-MM-DD
6
Okres od-do
od [min. początek okresu z pozycji faktury] do [max. koniec
okresu z pozycji faktury]
W przypadku faktur niebilingowych pusty
7
Termin płatności
8
Stan konta przed
rozliczeniem
9
Wystawił
RRRR-MM-DD
np.: Ziutek Kowalski
10 Identyfikator
Ciąg znaków drukowany pod danymi nabywcy
11 Typ wydruku
Jeden z trzech wyrazów: Oryginał, Kopia, Duplikat
12 Data duplikatu
RRRR-MM-DD Tylko, gdy w wierszu „Typ wydruku” jest słowo „Duplikat”
13 Ilość kopii
Ilość kopii drukowanych łącznie z oryginałem [0 – brak
kopii, 1 – jedna kopia itd.]
14 Blankiet
0 – brak blankietu, 1 – blankiet, 2 – blankiet zbiorczy
15 Kod kreskowy
Ciąg znaków; „Blankiet” > 0
16 Nazwa dla banku
Nazwa skrócona wystawcy na blankiecie; „Blankiet” > 0
17 Suma do zapłaty
Suma „do zapłaty” faktur z blankietu zbiorczego;
„Blankiet” = 2
18 Suma do zapłaty
słownie
Kwota z pozycji „Suma do zapłaty” słownie; „Blankiet” = 2
19 Termin płatności
zbiorczy
RRRR-MM-DD Minimalny termin płatności faktur z blankietu zbiorczego;
„Blankiet” = 2
20 Komentarz rozliczenia
Informacje dodatkowe, wypełniane tylko dla faktur FB, dot.
całej faktury, np. informacja o przyszłych prognozach.
21 Algorytm
1 – duży odbiór, 0 – mały odbiór
22 Pokaż saldo
1 – pokaż, 0 – nie pokazuj
23 Typ przesyłki
identyfikator typu przesyłki;
dopuszczalne wartości:
LZ – list zwykły
LP – list polecony
PP – list za potwierdzeniem odbioru
PE – przesyłka elektroniczna (tylko ekofaktura)
1.1.3
Lp
Struktura rekordu „Korekta” C
Nazwa pola
Format
Uwagi
0
Typ rekordu
C
1
Id faktury
Identyfikator faktury w systemie MeGaz
UWAGA! jest to informacja niedrukowana – nr ten powinien
pojawić się w pliku raportu zwrotnego (p. 3.1.2)
2
Typ dokumentu
np.: FBK, FBPK
3
Nr faktury
4
Data wystawienia
RRRR-MM-DD
5
Data sprzedaży
RRRR-MM-DD
6
Okres od-do
od [min. początek okresu z pozycji faktury] do [max. koniec
okresu z pozycji faktury]
W przypadku faktur niebilingowych pusty
7
Termin płatności
8
Wystawił
RRRR-MM-DD
np.: Ziutek Kowalski
9
Tytułem
10 Identyfikator
Ciąg znaków drukowany pod danymi nabywcy
11 Typ wydruku
Jeden z trzech wyrazów: Oryginał, Kopia, Duplikat
12 Data duplikatu
RRRR-MM-DD Tylko, gdy w wierszu „Typ wydruku” jest słowo „Duplikat”
13 Ilość kopii
Ilość kopii drukowanych łącznie z oryginałem [0 – brak
kopii, 1 – jedna kopia itd.]
14 Blankiet
0 – brak blankietu, 1 – blankiet, 2 – blankiet zbiorczy
15 Kod kreskowy
Ciąg znaków; „Blankiet” > 0
16 Nazwa dla banku
Nazwa skrócona wystawcy na blankiecie; „Blankiet” > 0
17 Suma do zapłaty
Suma „do zapłaty” faktur z blankietu zbiorczego;
„Blankiet” = 2
18 Suma do zapłaty
słownie
Kwota z pozycji „Suma do zapłaty” słownie; „Blankiet” = 2
19 Termin płatności
zbiorczy
RRRR-MM-DD Minimalny termin płatności faktur z blankietu zbiorczego;
„Blankiet” = 2
20 Algorytm
1 – duży odbiór, 0 – mały odbiór
21 Typ przesyłki
identyfikator typu przesyłki;
dopuszczalne wartości:
LZ – list zwykły
LP – list polecony
PP – list za potwierdzeniem odbioru
PE – przesyłka elektroniczna (tylko ekofaktura)
1.1.4
Struktura rekordu „Do dokumentu” D
W fakturze korygującej może wystąpić więcej niż 1 rekord „Do dokumentu”.
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
D
1
Nr dokumentu
Nr dokumentu korygowanego
2
Data wystawienia
1.1.5
RRRR-MM-DD Data wystawienia dokumentu korygowanego
Struktura rekordu „Lista faktur z blankietu” H
Na blankiecie zbiorczym występuje więcej niż 1 rekord „Lista faktur z blankietu”.
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
H
1
Nr dokumentu
Nr dokumentu
1.1.6
Struktura rekordu „Lista prognoz” L
Rekord zawiera numer faktury FBP lub FBPK oraz kwoty, które zostały rozliczone bieżącą fakturą, czyli
zmieniającą wartość rozliczenia rzeczywistego. Może wystąpić więcej niż 1 rekord „Lista prognoz”.
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
L
1
Nr dokumentu
Nr FBP lub FBPK
2
Data wystawienia
RRRR-MM-DD Data wystawienia FBP lub FBPK
3
Wartość netto
N,NN
|101,34| zawsze jako tekst, czyli formatowane
4
Wartość VAT
N,NN
|22,26|
5
Wartość brutto
N,NN
|123,60|
1.1.7
Lp
Struktura rekordu „Sprzedawca” S
Nazwa pola
Format
Uwagi
0
Typ rekordu
S
1
Nazwa, 1-sza linia
Nazwa
2
Nazwa, 2-ga linia
3
Nazwa, 3-cia linia
4
Adres
Adres Kod pocztowy + miejscowość, np.: |05-530 Góra
Kalwaria|
5
Adres
Ulica + nr domu + nr lok, np.: |Wyszyńskiego 3 / 49|
6
NIP
np.: 123-098-09-12
7
REGON
1.1.8
Lp
Struktura rekordu „Wystawca” W
Nazwa pola
Format
Uwagi
0
Typ rekordu
W
1
Nazwa, 1-sza linia
Nazwa
2
Nazwa, 2-ga linia
3
Nazwa, 3-ga linia
4
Adres
Adres Kod pocztowy + miejscowość, np.: |05-530 Góra
Kalwaria|
5
Adres
Ulica + nr domu + nr lok, np.: |Wyszyńskiego 3 / 49|
6
Tel
|(0-prefix-22) 523-00-73, 765-09-09|
7
Konto bankowe, 1-sza
linia
|BPH PBK S.A.|
8
Konto bankowe, 2-ga
linia
|O/Kraków|
9
Nr konta, 1-sza linia
|10601060-38569586-|
10 Nr konta, 2-ga linia
1.1.9
Lp
|PLCNK-2700-35|
Struktura rekordu „Nabywca” N
Nazwa pola
0
Typ rekordu
1
ID_odbiorcy
2
Nazwa, 1-sza linia
3
Nazwa, 2-ga linia
4
Nazwa, 3-cia linia
5
Adres
Format
Uwagi
N
Kod pocztowy + miejscowość, np.: |05-530 Góra Kalwaria|
6
Adres
Ulica + nr domu + nr lok, np.: |Wyszyńskiego 3 / 49|
7
NIP
8
REGON
9
Konto bankowe, 1-sza
linia
|BPH PBK S.A.|
10 Konto bankowe, 2-ga
linia
|O/Kraków|
11 Nr konta, 1-sza linia
|10601060-38569586-|
12 Nr konta, 2-ga linia
|PLCNK-2700-35|
13 Adres
korespondencyjny
Kilkuwierszowe pole z adresem korespondencyjnym, jego
zawartość powinna zostać wydrukowana w miejscu
odpowiednim dla „okienka adresowego” koperty
1.1.10
Lp
Struktura rekordu „Pozycja” P
Nazwa pola
Format
Uwagi
0
Typ rekordu
P
1
Nr ewidencyjny
2
Adres zainstalowania
urządzenia, 1-sza linia
Nazwa punktu
3
Adres zainstalowania
urządzenia, 2-ga linia
Kod pocztowy + miejscowość
4
Adres zainstalowania
urządzenia, 3-cia linia
Ulica + nr domu + lok
5
Nr fabryczny urządzenia rozliczającego
Nieobowiązkowe
6
Taryfa
RRRR-MM-DD
7
Data poprzedniego
odczytu
8
Data odczytu
RRRR-MM-DD
9
Wsk. poprzednie
Nieobowiązkowe
10 Wsk. bieżące
Nieobowiązkowe
11 Typ odczytu
12 Zużycie
dla noty odsetkowej jest to tekst: „Odsetki od faktury: ..., z
dnia: ..., na kwotę: ..., termin płatności: ...”
13 Dodatkowe treści
Kwota
N,NN
14
15 Netto
N,NN
16 VAT
N,NN
17 Ciepło spalania
N,NNNN
18 Moc umowna
jest to kwota brutto pozycji faktury; dla noty odsetkowej:
kwota odsetek
numeric (3,4)
Czyli moc zamówiona, np. 150
19 Moc wykonana
informacje dodatkowe, wypełniane tylko dla faktur FB
dużego odbioru, z wyjątkiem rat planowych
20 Dane rozliczenia
21 Komentarz odczytu
22 Rok umowny od
RRRR-MM-DD Nieobowiązkowe, a jeśli wystąpi, to tylko dla dokumentów
typu FB i FBP
23 Rok umowny do
RRRR-MM-DD Obowiązkowe tylko dla dokumentów typu FB i FBP
Numer punktu odczytowego w systemie operatora
Dystrybucji
24 Id punktu OSD
1.1.11
Lp
Struktura rekordu „Protokół rozliczeniowy” PR
Nazwa pola
Format
0
Typ Rekordu
1
Początek okresu
rozliczeniowego
RRRR-MM-DD
2
Koniec okresu
rozliczeniowego
RRRR-MM-DD
3
Rodzina typu
urządzenia
Uwagi
PR
Np. „turbinowy”
4
Typ urządzenia
Np. „G1600”
5
Określenie korektora
Np. "MacMat/2com"
6
Suma zużycia
N,NNNN
Np. 1 767,1234
7
Maksymalna moc
N,NNNN
Np. 107
8
Dzień/godzina mocy
maksymalnej
9
Ilość przekroczonego gazu
10
Czas przekraczania
mocy
11
Łączne zużycie
gazu
12
Moc (po korektach) N,NNNN
Np. 107
13
Suma korekt
Np. 1 019 127
14
Nr bilansowy
1.1.12
Lp
Np. 31/9-10
N,NNNN
Np. 125 698
Np. 123
N,NNNN
N,NNNN
Np. 1 020 894
Tekst 10-cioznakowy, np. 0000001234
Struktura rekordu „Pomiar dzienny” Y
Nazwa pola
Format
Uwagi
0
Typ rekordu
Y
1
Dzień
W formacie DD-MM
2
Licznik
(bez miana)
3
Vn
Jednostka [m3/24h]
4
Vr
Jednostka [m3/24h]
5
Qnmin
Jednostka [m3/h]
6
Qnmax
Jednostka [m3/h]
7
QnmaxCzasPrzekrocz
enia
Jednostka [m3/h]
8
Qrmin
Jednostka [m3/h]
9
Qrmax
Jednostka [m3/h]
10 Tmin
Jednostka [ºC]
11 Tmax
Jednostka [ºC]
12 Pmin
Jednostka [kPa]
13 Pmax
Jednostka [kPa]
1.1.13
Lp
Struktura rekordu „Korekty pomiarów” Q
Nazwa pola
Format
Uwagi
0
Typ rekordu
Q
1
Opis
Tekst przekazany do druku czcionką nieskalowalną (np.
Courier New)
2
Ilość
Ilość do Korekty [m3], np. 1 017 600
3
Typ korekty
Niedrukowalne pole; może przyjąć wartości: Ilosc, Moc
1.1.14
Lp
Struktura rekordu „Parametry gazu” G
Nazwa pola
Format
Uwagi
0
Typ rekordu
G
1
Nr bilansowy
2
Okres
W formacie RRRR-MM
3
Metan
[%]
4
Etan
[%]
5
Propan
[%]
6
N-Butan
[%]
7
I-Butan
[%]
8
N-Pentan
[%]
9
I-Pentan
[%]
10 Suma C6
[%]
11 Dwutlenek węgla
[%]
12 Azot
[%]
13 Tlen
[%]
14 Ciepło spalania
[MJ/m3n]
15 Wartość opałowa
[MJ/m3n]
16 Gęstość względna
[-]
17 Liczba Wobbego
[MJ/m3n]
18 Siarkowodór
[mg/m3n]
19 Siarka org.
[mg/m3n]
20 Siarka całk.
[mg/m3n]
21 Wilgoć
[g/m3n]
22 S. całk.
[mg/m3n]
23 Data protokołu
Format RRRR-MM-DD
1.1.15
Struktura rekordu „Ujęto w prognozie” E
Wiersz zawiera tylko napis „Ujęto w prognozie”.
Lp
0
Nazwa pola
Format
Typ rekordu
1.1.16
Uwagi
E
Struktura rekordu „Było” B
Wiersz zawiera tylko napis „Było”
Lp
0
Nazwa pola
Format
Typ Rekordu
1.1.17
Uwagi
B
Struktura rekordu „Jest” J
Wiersz zawiera tylko napis „Po korekcie”
Lp
0
Nazwa pola
Typ Rekordu
Format
Uwagi
J
1.1.18
Struktura rekordu „Zmiany” M
Wiersz zawiera tylko napis „Korekty”
Lp
0
Nazwa pola
Format
Typ rekordu
1.1.19
Lp
Uwagi
M
Struktura rekordu „Treść” T
Nazwa pola
Format
Uwagi
0
Typ rekordu
T
1
Za co
Dla FB, FBP informacja o składowej danej pozycji;
Dla NOB informacja o fakturze, do której nota została
wystawiona;
np.: ”Abonament”
Ilość
3
Jm
4
Cena netto
N,NNNN
Wartość liczbowa, np.: |0,0543| (zawsze cztery miejsca po
przecinku) lub ciąg |--- (*)| dla treści pozycji JEST i ZMIANY
dokumentów korygujących w przypadku pustej wartości
pola w bazie danych
5
Wartość netto
N,NN
|101,34| zawsze jako tekst, czyli formatowane
6
Wartość VAT
N,NN
|22,26|
7
Wartość brutto
N,NN
|123,60|
8
Stawka VAT
1.1.20
N,NNNN
Wartość liczbowa, np.: |5| lub ciąg |--- (*)| dla treści pozycji
JEST i ZMIANY dokumentów korygujących w przypadku
pustej wartości pola w bazie danych
2
|m-c|
|22%|
Struktura rekordu „Podsumowanie rekordów Treść” O
Rekord ten podsumowuje pozycję faktury, czyli następujące po sobie rekordy Treść. Początek bloku
rekordów branych do podsumowania może określać rekord typu: P, B, J, M.
Lp
0
Nazwa pola
Typ rekordu
Format
Uwagi
O
1
Wartość netto
N,NN
tekst sformatowany, np.: |2 590,79|
2
Wartość VAT
N,NN
tekst sformatowany, np.: |467,19|
3
Wartość brutto
N,NN
tekst sformatowany, np.: |2 123,60|
1.1.21
Struktura rekordu „Podsumowanie rekordów Pozycje” PO
Rekord ten podsumowuje pozycję faktury, czyli następujące po sobie rekordy Pozycji. Rekord PO
występuje jedynie dla faktur rozliczających prognozy. Poprzedza rekord E.
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
1
Wartość netto
N,NN
tekst sformatowany, np.: |2 590,79|
2
Wartość VAT
N,NN
tekst sformatowany, np.: |467,19|
3
Wartość brutto
N,NN
tekst sformatowany, np.: |2 123,60|
1.1.22
PO
Struktura rekordu „Podsumowującego razem” R
Rekord ten podsumowuje Fakturę nie pozycję
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
1
Wartość netto
N,NN
|101,34| zawsze jako tekst, czyli formatowane
2
Wartość VAT
N,NN
|22,26|
3
Wartość brutto
N,NN
|123,60|
4
Nr noty
Nr dokumentu w systemie MeGaz
5
Odsetki
Kwota naliczonych odsetek
6
Do zapłaty
7
Nadpłata/korekta
Wartość uwzględnionej nadpłaty lub korekty
8
Typ obsługi
Jeśli Typ obsługi <> ‘0’ to drukować napis „Płatne przez
bank”
9
Słownie
„Do zapłaty” słownie
10 Brutto słownie
R
N,NN
1.1.23
Lp
Struktura rekordu „Podsumowanie korekty” U
Nazwa pola
Format
Uwagi
0
Typ rekordu
1
Wartość netto
N,NN
|101,34| zawsze jako tekst, czyli formatowane
2
Wartość VAT
N,NN
|22,26|
3
Wartość brutto
N,NN
|123,60|
4
Suma Korekt
N,NN
Suma Korekt = Wartość Brutto – co do wartości
bezwzględnej;
etykieta kwoty:
„Kwota [zz] wartość faktury podlegająca rozliczeniu z
fakturą korygowaną:”
gdzie:
[zz] = „zmniejszająca” jeśli Wartość Brutto < 0
[zz] = „zwiększająca” jeśli Wartość Brutto > 0
5
Suma zmian VAT
N,NN
Suma Zmian VAT = Wartość VAT – co do wartości
bezwzględnej;
etykieta kwoty:
„Podatek VAT [zz] o kwotę:”
gdzie:
[zz] = „zmniejszono” jeśli Wartość VAT < 0
[zz] = „zwiększono” jeśli Wartość VAT > 0
6
Typ obsługi
Jeśli Typ obsługi <> ‘0’ to drukować napis „Płatne przez
bank”
7
Słownie
Suma korekt słownie
1.1.24
U
Struktura rekordu „VAT” V
Rekordy te podsumowują Fakturę nie pozycję
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
V
1
VAT
|22%| lub |ZW|
2
Wartość netto
N,NN
|101,34| zawsze jako tekst, czyli formatowane
3
Wartość VAT
N,NN
|22,26|
4
Wartość brutto
1.1.25
N,NN
|123,60|
Struktura rekordu „Informacyjnego” K
Rekord komentarza
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
K
1
1-sza linia komentarza
|INFORMACJA!!!|
2
2-ga linia komentarza
|Od dnia 2002.02.02 została uruchomiona|
3
3-cia linia komentarza
|kasa przy ul. Racławickiej|
4
4-ta linia komentarza
|Czynna w godzinach 9.00-14.00|
1.1.26
Struktura rekordu „Wrzutka” A
Przy fakturze może być kilka różnych wrzutek. Dla kilku faktur jednego odbiorcy może wystąpić tylko
jedna „wrzutka” danego rodzaju.
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
A
1
Id wrzutki
Identyfikator wrzutki
1.1.27
Struktura rekordu „Podpisał” UP
Dla dokumentów not odsetkowych (NOB) może wystąpić potrzeba przekazania danych użytkownika
podpisującego, w celu zamieszczenia na wydruku obrazu podpisu tego użytkownika. Struktura UP
zawiera dane takiego użytkownika. Struktura pojawia się wyłącznie dla dokumentów typu NOB.
Lp
Nazwa pola
Format
Uwagi
0
Typ rekordu
UP
1
Id
Identyfikator użytkownika, np.: markmi01
2
Nazwa
Imię i nazwisko, np.: Marcin Kmieć
3
Stanowisko
Stanowisko użytkownika, np.: Kierownik Działu Windykacji
1.1.28
Lp
0
Struktura rekordu „Koniec faktury” X
Nazwa pola
Format
Typ rekordu
1.1.29
Lp
Uwagi
X
Struktura rekordu „Zamykającego paczkę” Z
Nazwa pola
Format
Uwagi
0
Typ rekordu
Z
1
Ilość faktur w paczce
|537|
1.2
Kolejność rekordów
[] oznacza wystąpienie opcjonalne.
"Rekord(y)" oznacza możliwość wystąpienia jednego lub więcej rekordów danego typu.
W pliku eksportowym (wysyłanym do centrum drukowania dokumentów) obowiązuje kolejność
rekordów, określona w poniższej sekwencji:
<Rekord typu I>
<Lista dokumentów>
<Rekord typu Z>
<Lista dokumentów> oznacza:
<Sekwencja typu F> lub <Sekwencja typu C>
[<Lista dokumentów>]
<Sekwencja typu F> oznacza:
<Rekord typu F>
<Rekord typu S>
<Rekord typu W>
<Rekord typu N>
<Sekwencja pozycji faktury/noty>
[<Sekwencja ujęto w prognozie>]
<Rekord(y) typu V>
<Rekord typu R>
[<Rekord typu K>]
[<Rekord(y) typu H>]
[<Rekord(y) typu A>]
[<Rekord typu UP>]
<Rekord typu X>
<Sekwencja typu C> oznacza:
<Rekord typu C>
<Rekord(y) typu D>
<Rekord typu S>
<Rekord typu W>
<Rekord typu N>
<Sekwencja pozycji korekty>
[<Sekwencja korekty ujęto w prognozie>]
<Rekord(y) typu V>
<Rekord typu U>
[<Rekord typu K>]
[<Rekord(y) typu H>]
[<Rekord(y) typu A>]
<Rekord typu X>
<Sekwencja pozycji faktury/noty> oznacza:
<Rekord typu P>
[<Rekord typu PR>]
[<Rekord(y) typu Y>]
[<Rekord(y) typu Q>]
[<Rekord(y) typu G>]
<Sekwencja treści>
<Rekord typu O>
[<Sekwencja pozycji faktury/noty>]
<Sekwencja pozycji korekty> oznacza:
<Rekord typu P>
<Rekord typu B>
<Sekwencja treści>
<Rekord typu O>
<Rekord typu J>
<Sekwencja treści>
<Rekord typu O>
<Rekord typu M>
<Sekwencja treści>
<Rekord typu O>
[<Sekwencja pozycji korekty>]
<Sekwencja ujęto w prognozie> oznacza:
<Rekord typu PO>
<Rekord typu E>
<Rekord(y) typu L>
<Sekwencja korekty ujęto w prognozie> oznacza:
<Rekord typu E>
<Rekord typu B>
<Rekord(y) typu L>
<Rekord typu J>
<Rekord typu L>
<Rekord typu M>
<Rekord(y) typu L>
<Sekwencja treści> oznacza:
<Rekord(y) typu T>
2
Struktura zbioru wracającego do systemu MeGaz
Informacja zwrotna o wydruku dokumentów przekazanych plikiem MAS ma strukturę zgodną
z dokumentacją dostarczoną przez dostawcę usługi CKM.
Zgodnie z ustaleniami, dla każdego pliku MAS, przesłanego do CKM, jednokrotnie generowany jest
raport zwrotny. W gestii pracowników Gazowni jest pobranie raportu z udostępnionej przez dostawcę
usługi CKM lokalizacji oraz wprowadzenie danych raportu do systemu MeGaz, za pomocą
funkcjonalności Importu raportów zwrotnych, znajdującej się w Kartotece paczek CKM.
3
Struktura zbioru XML
Dane będą przekazywane poprzez zbiory XML o strukturze zgodnej przedstawionym poniżej opisem
oraz z załączonym do dokumentu schematem dokumentów XML (wz_v05.xsd).
3.1
Nazwa pliku
Plik wynikowy ma nazwę zgodną z następującą maską:
<IdentyfikatorGazowni><Data><NrLosowy>.masx
gdzie:
<IdentyfikatorGazowni> - numeryczny identyfikator Gazowni; przyjmuje następujące wartości dla
poszczególnych gazowni:
Identyfikator
1
2
3
4
5
6
7
8
Gazownia
Tarnów
Kraków
Rzeszów
Lublin
Kielce
Jasło
Jarosław
Sandomierz
<Data> - data w formacie rrmdd, gdzie: rr – dwie najmłodsze cyfry roku (np. dla roku 2009: 09), m –
miesiąc szesnastkowo (np. dla kwietnia: 4, dla października: a), dd – dzień miesiąca
<NrLosowy> - liczba z zakresu 0-999, uzupełniona zerami wiodącymi do długości 3 znaków.
3.2
Formatowanie wartości
Wszelkie restrykcje dotyczące formatowania wartości liczbowych, dat, itp. określono w tabelach
opisujących poszczególne obiekty pliku.
Format dat (RRRR-MM-DD) należy interpretować jako 4 cyfry przedstawiające rok (RRRR), 2 cyfry
przedstawiające miesiąc (MM), 2 cyfry przedstawiające dzień miesiąca (DD).
Format kwot (N.NN) należy interpretować jako liczbę zmiennoprzecinkową z dwoma miejscami po
przecinku.
Format stóp procentowych (N.NN%) należy interpretować jako liczbę zmiennoprzecinkową z dwoma
znakami po przecinku, po której znajduje się znak ‘%’.
3.3
Ograniczenia
Poza wskazanymi w Tabeli 1 wyjątkami każdy element może wystąpić tylko raz w obiekcie nadrzędnym,
w którym się znajduje.
Załącznik nr 2D do Umowy
3.4
Opis elementów pliku XML
Tabela 1 – Struktura pliku wymiany danych.
Obiekt w pliku
XML
Typ
obiektu
CKMPaczkaDokWi
nd
complexT
ype
CKMPaczkaDokWi
nd
DokumentWZ
Typ
skład
nika
węzeł
główn
y
Opis
Ograniczenia
struktura
opisana
poniżej;
może wystąpić
tylko 1 taki
element w pliku
complexT
ype
eleme
nt
dokument
windykacyjn
y;
struktura
opisana
poniżej;
może wystąpić
wiele takich
elementów w
obiekcie
CKMPaczkaDok
Wind
DokumentWZ
IdTeczkaDokument
integer
atrybu
t
identyfikator
w systemie
MeGaz
element
obowiązkowy
TypDokumentu
string
atrybu
t
typ
dokumentu
w systemie
MeGaz
element
obowiązkowy
NumerSprawy
string
DataWystawienia
string
eleme
nt
eleme
nt
numer
dokumentu;
data
wystawienia
;
Kwota
decimal
eleme
nt
należność
główna
KwotaSlownie
string
eleme
nt
WplatyNierozksieg
decimal
eleme
nt
KwotaDoWplaty
decimal
eleme
nt
należność
główna
słownie
kwota
nierozksięgowanych
wpłat
kwota
pozostała
do zapłaty
element
obowiązkowy
element
obowiązkowy;
format: RRRRMM-DD
element
obowiązkowy;
format: N.NN
element
obowiązkowy
Przykład
<DokumentWZ
IDTeczkaDokument="526850"
TypDokumentu="WEZOS">
<!—dane dokumentu-->
</DokumentWZ>
<DokumentWZ
IDTeczkaDokument="526850"
TypDokumentu="WEZOS">
<!—dane dokumentu-->
</DokumentWZ>
<NumerSprawy>120/W/W/0011796/1/09</N
umerSprawy>
<DataWystawienia>2009-0619</DataWystawienia>
<Kwota>713.38</Kwota>
<KwotaSlownie>siedemset trzynaście zł.
trzydzieści osiem gr.</KwotaSlownie>
element
obowiązkowy
<WplatyNierozksieg>22.78</WplatyNierozk
sieg>
element
obowiązkowy;
format: N.NN
<KwotaDoWplaty>713.38</KwotaDoWplaty
>
Załącznik nr 2D do Umowy
Obiekt w pliku
XML
Typ
obiektu
Typ
skład
nika
eleme
nt
KwotaDoWplatyS
string
Odsetki
string
eleme
nt
OdsetkiRok
string
eleme
nt
OpisWindykacji
string
eleme
nt
KasaInfo
string
Konto
string
eleme
nt
eleme
nt
TelefonyWind
string
eleme
nt
Szablon
string
eleme
nt
Opis
Ograniczenia
Przykład
kwota
pozostała
do zapłaty
słownie
dzienna
stopa odsetkowa,
obowiązująca na
dzień wystawienia
odsetek do
dokumentów z WZ;
roczna
stopa odsetkowa,
obowiązująca na
dzień wystawienia
odsetek do
dokumentów z WZ;
opis stanu
windykacji
element
obowiązkowy
<KwotaDoWplatyS>siedemset trzynaście zł.
trzydzieści osiem gr.</KwotaDoWplatyS>
element
opcjonalny;
format: N.NN%
<Odsetki>0.03%</Odsetki>
element
opcjonalny;
format: N.NN%
<OdsetkiRok>10.50%</OdsetkiRok>
element
opcjonalny
informacja o
kasach
konto
odbiorcy na
podstawie
faktury
załączonej
do
wezwania
telefony do
Działu
Windykacji
identyfikator
szablonu
dokumentu
(potrzebne
do
drukowania
wezwań
zgodnie
z różnymi
wzorami)
element
opcjonalny
element
obowiązkowy
<OpisWindykacji>Wezwanie obejmuje
dokumenty z okresu od 1 I 2009 r. do 31 VI
2009 r.</OpisWindykacji>
<KasaInfo>Od 1 I 2010 r. kasy w Oddziale
bedą nieczynne.</KasaInfo>
<Konto>18 1030 1944 7131 0000 0024
0552</Konto>
element
opcjonalny
<TelefonyWind>tel.: +48(78)234567, fax:
+48(78)987653</TelefonyWind>
element
opcjonalny
<Szablon>WEZOS_PRZEDSAD</Szablon>
Załącznik nr 2D do Umowy
Obiekt w pliku
XML
Typ
obiektu
Typ
skład
nika
eleme
nt
TypPrzesylki
string
Odbiorca
complexT
ype
eleme
nt
Uzytkownik
complexT
ype
eleme
nt
Podpisal
complexT
ype
eleme
nt
Sprzedawca
complexT
ype
eleme
nt
Wystawca
complexT
ype
eleme
nt
Opis
identyfikator
typu
przesyłki;
dopuszczal
ne wartości:
LZ – list
zwykły
LP – list
polecony
PP – list za
potwierdzeniem
odbioru
odbiorca
gazu;
struktura
opisana
poniżej;
użytkownik
wystawiający
dokument;
struktura
opisana
poniżej;
użytkownik
podpisujący
dokument;
struktura
opisana
poniżej;
struktura
opisana
poniżej
instytucja
wystawiająca
dokument;
struktura
opisana
poniżej;
Ograniczenia
Przykład
element
obowiązkowy
<TypPrzesylki>LZ</TypPrzesylki>
element
obowiązkowy
<Odbiorca><!—dane odbiorcy-->
</Odbiorca>
element
obowiązkowy
<Uzytkownik><!—dane uzytkownika-->
</Uzytkownik>
element
obowiązkowy
<Podpisal><!—dane podpisujacego-->
</Podpisal>
element
obowiązkowy
<Sprzedawca><!—dane sprzedawcy-></Sprzedawca>
element
obowiązkowy
<Wystawca><!—dane wystawcy-></Wystawca>
Załącznik nr 2D do Umowy
Obiekt w pliku
XML
Zadluzenie
Typ
obiektu
complexT
ype
Typ
skład
nika
eleme
nt
Odbiorca
Numer
string
eleme
nt
Nazwa
string
Imie
string
Nazwisko
string
AdresZamieszkania
complexT
ype
eleme
nt
eleme
nt
eleme
nt
eleme
nt
AdresDoKorespond
encji
complexT
ype
eleme
nt
TelKomorkowy
string
Telefon
string
Fax
string
Email
string
DokumentTozsamo
sci
complexT
ype
eleme
nt
eleme
nt
eleme
nt
eleme
nt
eleme
nt
NIP
string
REGON
string
PESEL
string
eleme
nt
eleme
nt
eleme
nt
Opis
Ograniczenia
Przykład
lista dokumentów
obciążeniowych,
składających się na
zadłużenie
w dokumencie windykacyjnym;
struktura
opisana
poniżej;
element
obowiązkowy
<Zadluzenie><!—dane zadluzenia-></Zadluzenie>
identyfikator
odbiorcy w
systemie
MeGaz
element
obowiązkowy
<Numer>0010796</Numer>
element
obowiązkowy
element
opcjonalny
element
opcjonalny
element
obowiązkowy
<Nazwa>Benek Marzena</Nazwa>
struktura
opisana
poniżej;
struktura
opisana
poniżej;
struktura
opisana
poniżej;
<Imie>Janina</Imie>
<Nazwisko>Kowalska</Nazwisko>
element
obowiązkowy
element
opcjonalny
element
opcjonalny
element
opcjonalny
element
opcjonalny
element
opcjonalny
<TelKomorkowy>607258971</TelKomorko
wy>
<Telefon>0146258971</Telefon>
element
opcjonalny
element
opcjonalny
element
opcjonalny
<NIP>525-000-80-28</NIP>
<Fax>0146258971</Fax>
<Email>[email protected]</Email>
<REGON>012216736</REGON>
<PESEL>969-109-38-38</PESEL>
Załącznik nr 2D do Umowy
Obiekt w pliku
XML
Typ
obiektu
SymbolEKD
string
TypObslugi
string
Typ
skład
nika
eleme
nt
eleme
nt
Opis
kod PKD
lub EKD w
zależności
od tego czy
odbiorca
otrzymał
nowy symbol klasyfikacji (zgodny z
obecnie
obowiązującym rozporządzeniem)
sposób
obsługi płatności odbiorcy w
systemie
MeGaz;
obecnie dopuszczalne
wartości:
STD – standardowo
(kasa lub
bank – wymagane
drukowanie
blankietu
zapłaty)
ROR –
obsługa
przez bank
(bez
blankietu
zapłaty)
PZ –
obsługa poleceniem
zapłaty
przez bank
(bez
blankietu
zapłaty)
Ograniczenia
Przykład
element
opcjonalny
<SymbolEKD>60.20.Z</SymbolEKD>
element
opcjonalny
<TypObslugi>STD</TypObslugi>
Załącznik nr 2D do Umowy
Obiekt w pliku
XML
Typ
obiektu
Uzytkownik
Nazwa
string
Telefon
string
Email
string
Stanowisko
string
Podpisal
Identyfikator
string
Nazwa
string
Stanowisko
string
Sprzedawca
Nazwa
Typ
skład
nika
Opis
Ograniczenia
Przykład
eleme
nt
eleme
nt
eleme
nt
eleme
nt
element
obowiązkowy
element
opcjonalny
element
opcjonalny
element
opcjonalny
<Nazwa>Marcin Kmieć</Nazwa>
eleme
nt
eleme
nt
eleme
nt
element
obowiązkowy
element
obowiązkowy
element
opcjonalny
<Identyfikator>markmi01</Identyfikator>
string
eleme
nt
element
obowiązkowy
<Nazwa>PGNiG SA</Nazwa>
Wystawca
Nazwa
string
string
element
obowiązkowy
element
obowiązkowy
<Nazwa>BOK Tarnów</Nazwa>
NazwaPelna
eleme
nt
eleme
nt
Telefon
string
NIP
string
REGON
string
KodPocztowy
string
Miejscowosc
string
Ulica
string
Bank
string
eleme
nt
eleme
nt
eleme
nt
eleme
nt
eleme
nt
eleme
nt
eleme
nt
element
opcjonalny
element
opcjonalny
element
opcjonalny
element
opcjonalny
element
opcjonalny
element
opcjonalny
element
obowiązkowy
<Telefon>603955288</Telefon>
<Email>[email protected]</Email>
<Stanowisko>kierownik</Stanowisko>
<Nazwa>Marcin Kmieć</Nazwa>
<Stanowisko>kierownik</Stanowisko>
<NazwaPelna>Karpacki Oddział Obrotu
Gazem w Tarnowie Gazownia Tarnowska
Biuro Obsługi Klienta
Tarnów</NazwaPelna>
<Telefon>(14) 6323-868..869, fax 6323815</Telefon>
<NIP>525-000-80-28</NIP>
<REGON>012216736</REGON>
<KodPocztowy>33-100</KodPocztowy>
<Miejscowosc>Tarnów</Miejscowosc>
<Ulica>Wita Stwosza 7</Ulica>
<Bank>Bank Handlowy SA</Bank>
Załącznik nr 2D do Umowy
Obiekt w pliku
XML
Typ
obiektu
Typ
skład
nika
Opis
Ograniczenia
complexT
ype
eleme
nt
struktura
opisana
poniżej;
może wystąpić
wiele (co
najmniej jeden)
takich
elementów w
obiekcie
Zadluzenie
AdresZamieszkani
a
KodPocztowy
string
NazwaPoczty
string
Miejscowosc
string
NazwaUlicy
string
Budynek
string
eleme
nt
eleme
nt
eleme
nt
eleme
nt
eleme
nt
AdresDoKorespon
dencji
KodPocztowy
string
NazwaPoczty
string
Miejscowosc
string
NazwaUlicy
string
Budynek
string
DokumentTozsam
osci
Nazwa
string
Numer
string
Wydajacy
string
Dokument
Lp
integer
Zadluzenie
Dokument
eleme
nt
eleme
nt
eleme
nt
eleme
nt
eleme
nt
numer
budynku i
ew. lokalu
numer
budynku i
ew. lokalu
eleme
nt
eleme
nt
eleme
nt
eleme
nt
nr
porządkowy
element
obowiązkowy
element
obowiązkowy
element
obowiązkowy
element
opcjonalny
element
obowiązkowy
element
obowiązkowy
element
obowiązkowy
element
obowiązkowy
element
opcjonalny
element
obowiązkowy
Przykład
<KodPocztowy>33-170</KodPocztowy>
<NazwaPoczty>Tuchów</NazwaPoczty>
<Miejscowosc>Łękołody</Miejscowosc>
<NazwaUlicy> pl.
Kowalskiego</NazwaUlicy>
<Budynek>46 b</Budynek>
<KodPocztowy>33-170</KodPocztowy>
<NazwaPoczty>Tuchów</NazwaPoczty>
<Miejscowosc>Łękołody</Miejscowosc>
<NazwaUlicy>pl.
Kowalskiego</NazwaUlicy>
<Budynek>46 b</Budynek>
element
opcjonalny
element
opcjonalny
element
opcjonalny
<Nazwa>dowodem osobistym</Nazwa>
element
obowiązkowy
<Lp>1</Lp>
<Numer>DZ2322476</Numer>
<Wydajacy>Wójt Gminy
Pleśna</Wydajacy>
Załącznik nr 2D do Umowy
Obiekt w pliku
XML
Typ
obiektu
Typ
skład
nika
eleme
nt
NrDokumentu
string
DataWystawienia
string
eleme
nt
TerminPlatnosci
string
eleme
nt
Brutto
decimal
eleme
nt
DoZaplaty
decimal
eleme
nt
Odsetki
decimal
eleme
nt
Razem
decimal
eleme
nt
Opis
nr
dokumentu
obciążenio
wego
kwota
odsetek naliczanych w
przypadku
gdy do dokumentu
Wezwania
mają być
wyliczone
odsetki na
datę
terminu
płatności
suma pól
DoZaplaty i
Odsetki
Ograniczenia
Przykład
element
obowiązkowy
<NrDokumentu>170/F/FB/3316/03/09</NrD
okumentu>
element
obowiązkowy;
format: RRRRMM-DD
element
obowiązkowy;
format: RRRRMM-DD
element
obowiązkowy;
format: N.NN
element
obowiązkowy;
format: N.NN
element
opcjonalny;
format: N.NN
<DataWystawienia>2009-0319</DataWystawienia>
element
obowiązkowy;
format: N.NN
<Razem>713.50</Razem>
<TerminPlatnosci>2009-0330</TerminPlatnosci>
<Brutto>713.38</Brutto>
<DoZaplaty>713.38</DoZaplaty>
<Odsetki>0.12</Odsetki>