1. Opis ogólny
2. Zamówienia sprzedaży EDI
2.1 Pobieranie zam sprzedaży EDI [ORDER]
2.2 Potwierdzenie zam sprzedaży EDI [ORDRSP]
2.3 Uwagi i zastrzeżenia
3. Zapisywanie faktur sprzedaży EDI [INVOICE]
3.1 Format
3.2 Dane dla faktur sprzedaży EDI
3.3 Zestawienie kontrolne EDI
3.4 Parametry dokumentów EDI
3.5 Zapisywanie faktur sprzedaży w pliku EDI
3.6 Data zapisania komunikatu EDI
3.7 Numery LOT/SER
4. Zapisywanie DESADV Awizo dostawy
Opis ogólny
Uwagi i zastrzeżenia
5. Przykłady komunikatów
6. Tematy powiązane
1. Opis ogólny
Faktura KSeF XML w 'świecie' EDI
Firmy, które wymieniały dane transakcyjne przy pomocy komunikatów EDI
teraz muszą włączyć się do wymiany faktur KSeF - wystawiać faktury sprzedaży
i pobierać faktury zakupu.
Patrz szczegóły:
KSeF. EDI INVOICE a Faktury XMLKSeF. Faktury a komunikaty EDI
Opisy zawarte w tym artykule prosimy odczytywać uwzględniając wymagania KSeF.
***********************************************************************************************************
EDI Electronic Data Interchange, to jest przesyłanie standardowych
komunikatów elektronicznych, które są odpowiednikami dokumentów handlowych
i administracyjnych, np. faktur sprzedaży, zamówień zakupu.
W programie Trawers można pobierać (Import) i wysyłać (Export)
następujące komunikaty dotyczące sprzedaży:
Import
-------------------------
Zamówienia sprzedaży - komunikat ORDER XML 1.2(CP)
-------------------------
Eksport
-------------------------
Faktury sprzedaży - komunikat INVOICE XML7.69
Faktury sprzedaży Korekty - komunikat CORRECTING INOVICE XML7.69
Faktury sprzedaży - komunikat INVOICE XML7.69(V)
Faktury sprzedaży Korekty - komunikat CORRECTING INOVICE XML7.69(V)
Faktury sprzedaży - komunikat INVOICE XML7.69(U)
Faktury sprzedaży Korekty - komunikat CORRECTING INOVICE XML7.69(U)
Wysyłka [SD] (beta) - komunikat DESADV XML2.9
Potwierdzenie zamówienia - komunikat ORDRSP XML1.5
-------------------------
2. Zamówienia sprzedaży EDI
2.1 Pobieranie zam sprzedaży EDI [ORDER]
Zamówienia sprzedaży można pobierać w formacie EDI XML w dwóch funkcjach:
* NA > Zamówienia > Pobieranie EDI [NA_DEDI1]
* Funkcja SOA > Polecenie wstawienia zamówienia sprzedaży EDI
SOA Funkcje OutBound i InBound
NA > Zamówienia > Pobieranie EDI [NA_DEDI1]
Operator wskazuje (wybiera) plik .xml
o--- Plik w /trawers/tr5x/trtres/trinout -----------o
| |
| Plik: 00142105.xml |
| |
o---------------------------------------------------o
Po wybraniu pliku 00142105.xml, program pokazuje jego zawartość.
o--- Zamówienie EDI ------------------------------------o
| <soapenv:Header/> |
| <soapenv:Body> |
| <Document-Order> |
| <Order-Header> |
| <OrderNumber>Numer obcy EDI</OrderNumber> |
| <VendorOrderNumber>!</VendorOrderNumber> |
| <OrderDate>20xx-09-28</OrderDate> |
| <OrderTime>!</OrderTime> |
| <CollectionDate>!</CollectionDate> |
| <CollectionTime>!</CollectionTime> |
| <PromotionReference>!</PromotionReference> |
| ....... |
o-------------------------------------------------------o
| F3-wczytaj plik, F5-zapisz, F8-wykonaj, F9-usuń |
o---------------------------- ----o----- ---------------o
|
v
F8-wykonaj, przekształca odczytane zamówienie sprzedaży
w formacie EDI do formatu Trawersa i zapisuje
w zbiorze zamówień sprzedaży
Funkcja SOA > Polecenie wstawienia zamówienia sprzedaży EDI
Funkcja SOA [Document-Order] dopisuje zamówienie sprzedaży [ZL] zgodne z ECOD XML.
Przykład pliku xml z zamówieniem EDI [ORDER] jest w danych przygotowanych do ćwiczeń
pobierania komunikatów EDI. Korzystając z danych przykładowych można poznąć
strukturę pliku EDI (XML), zawartość informacyyjną i sposoby wczytywania.
Patrz szczegóły:
SOA Przykłady i ćwiczeniaSOA Funkcje OutBound i InBound
2.2 Potwierdzenie zam sprzedaży EDI [ORDRSP]
EDI: Wysłanie komunikatu EDI ORDRSP <Document-OrderResponse>
Sprzedający (en: Seller) wysyła do kupującego (En: Buyer) komunikat,
który jest odpowiedzią na otrzymane zamówienie.
1. NA > Zamówienia > Potwierdzenie zam EDI [ORDRSP] [NA_DZM80]
2. NA > Zamówienia > E-mail Dołączenie: [ORDRSP] [NA_DZM70]
3. NA > Zamówienia > Potwierdzanie [P] > F2-cd > Wysłanie EDI [ORDRSP] e-mailem
IdProces: [NA_DSP10]
NOTE: e-mail nie jest rekomendowany do wysyłania komunikatów EDI
Zamówienie musi mieć status: [P] Potwierdzone [ACKDATA]
Tylko zamówienia [P] pojawiają się na liście wyboru.
Patrz też:
Cykl przetwarzania zam sprzedaży
2.3 Uwagi i zastrzeżenia
* Ilości w JmS
Program wczytujący zakłada, że ilości asortymentu w zamówieniu EDI
podane są w JmS, tj. w jednostce miary sprzedaży (rozchodu).
Np. Dokument EDI zamawia 10 PCE. Z tabeli Jm wynika, że zamawia 10 szt
----------------------------------------
Symbol Nazwa JmEDI
---- ------------------ ---
szp Szpula
szt Sztuka PCE PCE --> szt
tszt Tysiąc sztuk o
---------------------------------------- |
|
Indeks 2296 U 50 ST3S ceownik |
Jm-zapasów (magazynowa) ....... kg |
-przych t = 1,000.00000000 kg |
-rozch szt = 0.50000000 kg <-------------------o
Zamawiający otrzyma 10 szt
tj. 5 kg ceownika
Program sprawdza, czy JmS (-rozch) w KIM tu: szt wskazuje na PCE
zapisane w dokumencie EDI
JmEDI pobiera sie z tabeli: Jednostki miary EDI [MG_TJE10]
* Id asortymentu
Identyfikator asortymentu (EAN) w zamówieniu EDI powinien wskazywać
na indeks (KIM) lub BarKod (KIM)
Gdy program wczytujący nie odszuka asortymentu wg indeksu lub Barkodu,
to szuka asortymentu w kartotece KID. Patrz opis kartoteki KID.
Kartoteka kodów KID
NOTE: Przeliczniki Jm podane w karcie KID nie są brane pod uwagę
podczas przetwarzania zamówienia EDI
* Id na fakturze
Identyfikator asortymentu podany na zamówieniu EDI (InBound) będzie także
identyfikatorem asortymentu na fakturze sprzedaży (OutBound) utworzonej
wg tego zamówienia sprzedaży
Np. zamawiający 11111 (Piłka) otrzyma na fakturze 11111 (Piłka)
mimo, że w kartotece KIM jest 55555 (Piłka)
Patrz w opisie KID jak zapewnić taką zgodność
* Numerowanie pobieranych dokumentów
Pobierane dokumenty otrzymują numery wg definicji w: Tabela serii dokumentów.
Numerowanie dokumentów
3. Zapisywanie faktur sprzedaży EDI [INVOICE]
3.1 Format
INVOICE XML 7.69 : Komunikat standardowy. Specyfikacja formatu ma nazwę
[v]ECOD XML: INVOICE 7.69
[v] CORRECTING INVOICE 7.69
Opublikowana jest w:
https://www.comarchedi.pl/specyfikacje-plikow/
INVOICE XML 7.69(V): Komunikat rozszerzony o dane zawierające kwotę VAT w PLN
Do każdej faktury (w walucie i w PLN) dopisywane są
kwoty PTU (VAT) w PLN
Taki zapis jest wymagany, gdy faktura jest wystawiona
w walucie a adresat ma siedzibę w Polsce
Komunikat rozszerzony stosuje platforma wymiany faktur
EDI e-invoicing: www.ob10.com
INVOICE XML 7.69(U): Komunikat uproszczony. Bez informacji o obcym numerze zamówienia.
Pomija sekcje: <Order> oraz <Line-Order>
z polami <BuyerOrderNumber> oraz <BuyerOrderDate>.
Tzn. nie sprawdza i nie przekazuje informacji o obcym nr zamówienia.
Stosowany w firmach używających program Trawers do bezpośredniego
przekazywania faktur sprzedaży i wczytywania ich jako faktury zakupu.
3.2 Dane dla faktur sprzedaży EDI
Faktura EDI tworzona jest na podstawie pozycji faktury sprzedaży
lub faktury korygującej oraz danych znajdujących sie w innych,
powiązanych zbiorach w programie Trawers
Poprawność wypełnienia danych w zbiorach programu Trawers można
sprawdzić w funkcji: NA > Zestawienie kontrolne EDI [NA_ZED20]
Trzeba wybrać jedną z wystawionych faktur. Na bazie tej faktury program sprawdzi,
czy w zbiorach danych są wszystkie konieczne dane.
Aby utworzyć fakturę EDI muszą być spełnione warunki:
* Zamówienie [ZL] i Faktura sprzedaży [FA]
Faktura sprzedaży musi być powiązana z zamówieniem sprzedaży.
Z zamówienia sprzedaży do faktury EDI pobierany jest numer i data
zamówienia podane przez kupującego <BuyerOrderNumber> i <BuyerOrderDate>
Podane na ekranie zamówienia:
Numer obcy zamówienia ............
Data zamówienia rrrr.mm.dd
* Numer obcy zamówienia
Z ekranu Dane wysyłki pobierane/doświetlane są dane dotyczące nr obcego zamówienia:
Pole Podpowiadana wartość
------------------------ -------------------------------
Numer obcy zamówienia nr obcy zamówienia
Data zamówienia data obcego zamówienia
- dla formatu [1] i [2]
- gdy faktura do jednego zamówienia
- odczytywane z zamówienia, którego dotyczy faktura
- informacja będzie w nagłówku EDI w sekcji <Order>
- pola wypełnia się ręcznie
- pola muszą być wypełnione
Pole Podpowiadana wartość
------------------------ -------------------------------
Numer obcy zamówienia <wiele zamówień>
Data zamówienia <wiele zamówień>
- dla formatu [1] i [2]
- gdy faktura do wielu zamówień
- odczytywane z zamówień, których dotyczy faktura
- informacja będzie w pozycjach EDI w sekcji <Line-Order>
- pola wypełniane są automatycznie
- pola dla wszystkich pozycji muszą być wypełnione
Pole Podpowiadana wartość
------------------------ -------------------------------
Numer obcy zamówienia <NIE UJMOWAĆ>
Data zamówienia <NIE UJMOWAĆ>
- dla formatu [3]
- informacja o numerach obcych nie jest przekazywana
- sekcje <Order> i <Line-Order> nie są ujmowane
* Rachunek bankowy
Numer rachunku bankowego, na który będzie płacił odbiorca (podawany
na fakturze) musi być wypełniony w tabeli firm i tabeli oddziałów
Numer rachunku należy podać w formacie NRB, tzn.
Nr banku 8 znaków
Cyfra kontrolna 2 znaki
Nr rachunku 16 znaków
Rachunki bankowe (konta)
* Zamówienie [ZA] i Faktura korygująca [FK]
Faktura korygująca też musi być powiązana z zamówieniem sprzedaży.
Do faktury EDI pobierany jest numer i data zamówienia kupującego, tj.
<BuyerOrderNumber> i <BuyerOrderDate> z zamówienia sprzedaży powiązanego
z fakturą pierwotną (korygowaną)
* EAN i PKWiU
W karcie KIM należy wypełnić pola: Barkod (EAN) i kod PKWiU/SWW
PKWiU można pobrać z tabeli w systemie MG. Tabela PKWiU [MG_TTP10].
* J miar wg EDI
W tabeli jednostek miar należy podać jednostki wg norm EDI:
(pełna lista wymieniona jest w opisie formatu (specyfikacji)),
---------------------------------
Trawers EDI Nazwa
--- --- --------
szt PCE sztuka
kg KGM kilogram
l LTR litr
m2 MT2 metr kwadratowy
---------------------------------
* Gdy spółka
Gdy firma, wystawca faktury EDI jest spółką prawa handlowego,
to w karcie firmy (w tabeli firm) należy podać:
* adres siedziby firmy (spółki)
* opis zawierający numer KRS, nazwę sądu rejestrowego oraz kapitał
* Dane wysyłki
Z ekranu pobierane są dane nt. wysyłki (dostawy):
--------------------------------------------------------------------
Pole Podpowiadana wartość
------------------------ -------------------------------
ILN lokalizacji (sklepu) ILN adresu: Wysłać do
Numer dostawy nasz numer zamówienia sprzedaży
Data dostawy puste
Numer awiza dostawy puste
Numer obcy zamówienia wg formatu
Data zamówienia wg formatu
--------------------------------------------------------------------
NOTE: U jednego z użytkowników programu Trawers (nr licencji: 010017)
w polu: Numer dostawy i Data dostawy podaje się:
Numer i data dokumentu rozchodu ([RO]
DeliveryPoint
DeliveryPoint, to miejsce (adres wysyłki) zamówionego /sprzedanego towaru.
Ustalane wg ILN/GLN adresu wysyłki w karcie adresu odbiorcy.
np. <ILN>0000000000001</ILN> <--- ILN w karcie adresu odbiorcy - wskazuje
adres wysyłki zamówienia (Shipto)
* Jednostki zbiorcze
Niektórzy odbiorcy faktur EDI wymagają wykazania jednostek zbiorczych
Na fakturze EDI są to następujace pola:
---------------------------------------------------------------------
<InvoiceQuantity> = ilość w jednostkach sprzedaży
To jest ilość jednostek zbiorczych
Pobierana z pozycji faktury z pola: Ilość
<UnitOfMeasure> = jednostka miary sprzedaży
Pobierana z pozycji faktury z pola: pole JMS
<InvoiceUnitPacksize> = liczba sztuk detal. w jedn. zbiorczej
Pobierana z pozycji faktury z pola: WSSPRZ
<PackItemUnitOfMeasure> = jedn. miary sztuki detal. w jedn. zbiorczej
Pobierana z pozycji faktury z pola: JM
---------------------------------------------------------------------
Przykład dla Trawers:
Sprzedajemy 10 sztuk indeksu ZGRZEWKA_WODY, który oznacza
zgrzewkę zawierającą 6 butelek wody
W karcie KIM tego indeksu podano, że jednostka sprzedaży:
zgrz = 6.000 btlk, tzn.
JMS = WSSPRZ JM
Dla jednostek miary przypisano jednostki EDI:
zgrz -> PCE
btlk -> PCE
W fakturze EDI pola zostaną wpełnione następująco:
------------------------------
<InvoiceQuantity> 10.000
<UnitOfMeasure> PCE
<InvoiceUnitPacksize> 6.000
<PackItemUnitOfMeasure> PCE
------------------------------
3.3 Zestawienie kontrolne EDI
Program tworzy raport wskazujący, których informacji brakuje w bazach danych,
aby utworzyć faktury w formacie EDI. NA > Zestawienie kontrolne EDI [NA_ZED20].
W raporcie podane są oznaczenia wg terminologii EDI, np. <ILN> <DeliveryPoint>.
EDI Stosowane oznaczenia
3.4 Parametry dokumentów EDI
a) Karta odbiorcy > Zakładka: Profil EDI, wskazuje się format dokumentu EDI
oraz metodę pobierania danych dla dokumentu EDI:
Nr i data dostawy na dok FA [1][2][3][4][5]
b) Uprawnienia i parametry operatora: podaje się wartości domyślne, które
są pobierane do dokumentów, np. symbole dekretacji, nr magazynu itd.
Patrz: Domyślne (podpowiadane) obiekty, oznaczone: [+]
Uprawnienia operatorów
3.5 Zapisywanie faktur sprzedaży w pliku EDI
Faktury sprzedaży i korygujące zgromadzone w zbiorze dokumentów okresowych
zapisuje się w pliku EDI w funkcji:
NA > Sprzedaż > Zapisywanie faktur EDI [NA_ZED10].
Faktury pojedyńczo
a) Faktury zapisuje się pojedyńczo, faktura za fakturą
-- Zapisywanie faktur sprzedaży w formacie EDI ----
Odbiorca: 000321 ALFA Sp.z o.o.
Format: 1 ECOD XML INVOICE wersja 7.69
Okres obliczeniowy: 2020/09
Faktura [FA] [FK]: F00023/09/20
Do pliku: \trinout\000321_fa0023_09_20.xml
----------o------------
--------------------------------- | ---------------
|
v
Nazwa pliku EDI zawiera w sobie:
Symbol odbiorcy: 000321
Numer faktury: fa0023
Okres obliczeniowy: 09_20
Nazwa pliku: 000321_fa0023_09_20.xml pozwala powiązać
dokument EDI z dokumentem w bazie danych Trawers ERP
(dane łączące to: symbol odbiorcy, nr faktury i okres obliczeniowy)
Faktury seryjnie
b) Faktury można zapisywać seryjnie. Funkcja w menu NA [NA_ZED11]
Przy zapisie seryjnym program nie zatrzymuje się aby pobrać dodatkowe
dane z ekranu (jak w zapisie pojedyńczym, faktura za fakturą)
lecz wypełnia automatycznie dane zgodnie z parametrami podanymi
w zakładkach kart odbiorców: > Dane podstawowe > Profil EDI odbiorcy.
Nr i data dostawy na dok FA (opcje)
[1] Numer zamówienia, data pusta
[2] Numer i data dokumentu rozchodu [RO]
[3] Numer i data faktury sprzedaży
[4] Numer i data dok [SD] Wysyłka
[5] Numer awiza z dok [SD] Wysyłka
Np. można podać:
[3] Numer i data faktury
Program zapisuje plik EDI z nazwą pozwalającą na identyfikację pliku:
komunikat (INVOICE), data i godzina, kontrahent, nr faktury.
np. EDI_INVOICE_20220401144952454/000001_fa0001_03_22.xml
3.6 Data zapisania komunikatu EDI
Na ekranie: Dokument Znaczące daty program pokazuje datę zapisania
i symbol operatora, który zapisał plik EDI.
Utworzono EDI: [AA] 20xx.06.24 dok [INVOICE]
-- -----o----
^ ^
| |
EDISYMOP EDISENT
(operator) (data zapisu)
3.7 Numery LOT/SER
W fakturach sprzedaży w systemie NA mogą być wypełnione 2 pola: LOT lub SER.
W fakturach EDI: INVOICE jest jedno pole: <SerialNumber>
Procedura w programie Trawers
* Zapisywanie faktury EDI [NA_ZED10]
<SerialNumber> program zapisuje SER lub LOT, zależnie od wskaźnika w KIM
* SOA Pobieranie (InBound) Faktura sprzedaży EDI [SalesInvoiceGetById]
SOA Pobieranie (InBound) Faktura korekty EDI [SalesCorrectiveInvoiceGetById]
<SerialNumber> program zapisuje SER lub LOT, zależnie od wskaźnika w KIM
4. Zapisywanie DESADV Awizo dostawy
Awizo dostawy [DESADV] w formacie EDI XML program tworzy na podstawie
dokumentu [SD] Wysyłka w funkcji:
* NA > Zamówienia > Wysyłka > EDI Awizo dostawy [DESADV] [NA_DLL85]
Awizo dostawy [DESADV], to zawiadomienie o wysyłce towarów przez dostawcę.
Także: ASN Advanced Shipping Notice (EDI 856)
Zadanie: Upewnienie odbiorcy przez dostawcę, że awizowana wysyłka zawiera taki
asortyment jaki jest na zamówieniu. Standardowy format EDI zapewnia, że dokumenty
można przetwarzać automatycznie. Ew. różnice można natychmiast sygnalizować.
Dodatkowa korzyść dla odbiorcy, to możliwość automatycznego przekształcenia
komunikatu DESADV na dokument dostawy (przychodu) w systemie ERP.
W programie Trawers:
W systemie NA Sprzedaż generuje się komunikat DESADV Awizo dostawy
na podstawie dokumentu [SD] Wysyłka asortymentu
W systemie ZO Zakupy tworzy się dokument [DA] Dostawa w ZO
na podstawie komunikatu DESADV Awizo dostawy
Patrz szczegóły:
EDI DESADV Awizo dostawy (NA) (ZO)