Biuletyn techniczny. Moduł: Wymiana dokumentów za pomocą systemu ECOD. Wersja 10.5

Transkrypt

1 Biuletyn techniczny Moduł: Wymiana dokumentów za pomocą systemu ECOD Wersja 10.5

2 Copyright 2011 COMARCH Wszelkie prawa zastrzeżone Nieautoryzowane rozpowszechnianie całości lub fragmentu niniejszej publikacji w jakiejkolwiek postaci jest zabronione. Wykonywanie kopii metodą kserograficzną, fotograficzną, a także kopiowanie na nośniku filmowym, magnetycznym lub innym, powoduje naruszenie praw autorskich niniejszej publikacji. Wersja Moduł: ECOD

3 Lista zmian wprowadzonych w biuletynie Data wprowadzenia zmian Rozdział, w którym dokonano zmian Biuletyn uaktualniono do wersji 9.0 CDN XL. Biuletyn uaktualniono do wersji 10.5 CDN XL. Opis zmian Uaktualniono wszystkie rozdziały w związku z rozwojem systemu. Uaktualniono wszystkie rozdziały w związku z rozwojem systemu. Wersja Moduł: ECOD

4 Spis treści 1. Informacje wstępne Wymiana dokumentów za pomocą systemu ECOD Eksport dokumentów dokonywany dla sieci elektrotechnicznych Ustalanie formatu dla dokonywanego eksportu Obsługa opłaty produktowej podczas eksportu faktury sprzedaży Jednostka miary w systemie Comarch CDN XL, a jej odpowiednik w systemie ECOD Wymiana dokumentów typu faktura za pomocą systemu ECOD Eksport faktury sprzedaży FS do systemu ECOD Najczęstsze problemy występujące przy eksporcie FS do systemu ECOD Import faktury FZ z systemu ECOD Najczęstsze problemy występujące podczas importu faktury zakupu z ECOD Wymiana katalogu produktów za pomocą systemu ECOD Eksport katalogu produktów OS do systemu ECOD Najczęstsze problemy występujące podczas eksportu katalogu produktów do systemu ECOD Import katalogu produktów OZ z systemu ECOD Najczęstsze problemy występujące podczas importu katalogu produktów OZ z ECOD Wymiana zamówień za pomocą systemu ECOD Eksport zamówienia zakupu ZZ do systemu ECOD Najczęstsze problemy występujące podczas eksportu ZZ do systemu ECOD Import zamówienia ZS z systemu ECOD Najczęstsze problemy występujące podczas importu zamówienia sprzedaży z systemu ECOD 68 7 Obsługa Awiza wysyłki w programie Comarch CDN XL Eksport dokumentu WZ generowanie Awiza wysyłki Import Awiza wysyłki generowanie dokumentu PZ Obsługa Potwierdzenia dostawy w programie Comarch CDN XL Eksport dokumentu PZ generowanie Potwierdzenia dostawy Import Potwierdzenia dostawy Informacje dodatkowe Kod wg Kupującego automatycznie kopiowany na nagłówek dokumentu Jak przesłać duplikat faktury do ECOD? Wersja Moduł: ECOD

5 9.3 Czy można zmodyfikować format numeracji dokumentów wg którego tworzony jest wpis w komunikatach w linii <InvoiceNumber>? Jak przesłać informację o numerze dokumentu zwrotu dla FSK I (S)FSK? W jakiej kolejności identyfikowany jest towar podczas importu komunikatu do systemu Comarch CDN XL? Jakie licencje wymagane są do wymiany danych? W jaki sposób mogę wymieniać dokumenty, jakie są modele wymiany? Czy mogę zmienić format dla NIPu? Wersja Moduł: ECOD

6 1. Informacje wstępne W celu przygotowania baz do wymiany dokumentów przez ECOD, należy: ustawić numery GLN na kontrahentach oraz na ich adresach wysyłkowych. ustalić numer GLN na pieczątce firmy oraz pamiętać o dodaniu pieczątki w strukturze firmy. ustalić kody EAN na towarach Przykład: DOSTAWCA na pieczątce firmy ma numer GLN , ODBIORCA GLN DOSTAWCA widnieje w bazie ODBIROCY jako kontrahent z numerem GLN oraz GLN adresu wysyłkowego (zależny od adresu docelowego, może być zgodny z adresem kontrahenta lub nie). ODBIORCA widnieje na bazie DOSTAWCY jako kontrahent z numerem GLN oraz GLN adresu wysyłkowego. Na obu bazach widnieją towary o tych samych numerach EAN. wskazać folder do którego będą przekazywane odpowiednie pliki xml: Parametry komputera/wymiana danych (w zależności od sposobu wymiany dokumentów (rozdział 9.7 W jaki sposób mogę wymieniać dokumenty, jakie są modele wymiany?)) Rysunek 1 Parametry komputera wybór sposobu tworzenia się struktury folderów. Z listy rozwijalnej można wybrać sposób generowania folderów podrzędnych, mogą one powstawać w zależności od wskazanych opcji. Wersja Moduł: ECOD

7 Rysunek 2 Parametry komputera wskazanie folderu plików wyeksportowanych Zaznaczając parametr Przenoś wczytane do podkatalogu system utworzy dodatkowy folder w którym będzie przechowywał pliki xml, które zostały już wczytane do systemu poprzez ECOD. 2. Wymiana dokumentów za pomocą systemu ECOD Funkcjonalność programu Comarch CDN XL pozwala na wymianę pomiędzy dostawcą i odbiorcą takich dokumentów jak katalog produktów, zamówienia, awiza wysyłki, potwierdzenia dostawy, faktury czy fakturykorekty. Do obsługi katalogu produktów służy komunikat: ProductCatalogue, zamówień, komunikat: Order, awiza wysyłki, komunikat: DespatchAdvice, potwierdzenia dostawy, komunikat: ReceivingAdvice natomiast faktury, komunikat: Invoice. Pełna obsługa wyżej wymienionych komunikatów z punktu widzenia dostawcy wraz z towarzyszącymi mu dokumentami generowanymi w systemie Comarch CDN XL wygląda następująco: Wersja Moduł: ECOD

8 Dokument źródłowy/wynikowy Komunikat OS Cennik ZS Zamówienie WZ DOSTAWCA Awizo wysyłki ODBIORCA Spinacz (S)FS lub raport o rozbieżnościach Potwierdzenie dostawy (S)FS Faktura Dostawca przesyła do klienta katalog produktów W wyniku importu zamówienia złożonego przez klienta w systemie generowane jest zamówienie sprzedaży Po odpowiednim przygotowaniu zamówionego towaru do wysyłki z zamówienia generowany jest dokument WZ, który następnie eksportowany jest do klienta jako Awizo wysyłki Dla danego dokumentu WZ dokonywany jest import Potwierdzenia Dostawy od klienta. Na tej podstawie dokonywane jest sprawdzenie zgodności kodów i ilości towarów: na dokumencie WZ oraz na Potwierdzeniu Dostawy. W przypadku zgodności ww dokumentów, w systemie generowany jest spinacz do dokumentu WZ ((S)FS do bufora), w przypadku wystąpienia jakiejkolwiek niezgodności spinacz nie jest tworzony, a operator otrzymuje stosowną informację o występujących rozbieżnościach. Wystawiony w wyniku ww operacji spinacz (S)FS eksportowany jest do klienta w formie pliku INVOICE Pełna obsługa wyżej wymienionych komunikatów z punktu widzenia odbiorcy wraz z towarzyszącymi mu dokumentami generowanymi w systemie Comarch CDN XL wygląda następująco: DOSTAWCA Komunikat ODBIORCA Dokument źródłowy/wynikowy Wersja Moduł: ECOD

9 Cennik OZ Zamówienie ZZ Awizo wysyłki PZ do bufora Potwierdzenie dostawy PZ zatwierdzone ilościowo Faktura Spinacz (S)FZ lub raport o rozbieżnościach W wyniku importu katalogu produktów przez klienta w systemie generowana jest oferta zakupu Na podstawie wygenerowanego w systemie zamówienia zakupu dokonywany jest eksport i złożenie zamówienia u dostawcy Jeżeli towar został przez dostawce wysłany odbiorca otrzymuje i importuje Awizo Wysyłki, w wyniku czego w systemie generowany jest dokument PZ do bufora Po sprawdzeniu zgodności kodów i ilości towaru i ewentualnej dokonanej zmianie na ww dokumencie PZ, po jego ilościowym zatwierdzeniu dokument ten eksportowany jest jako Potwierdzenie Dostawy Dla ww. dokumentu PZ dokonywany jest import przesłanej przez dostawcę faktury, na podstawie wczytywanego pliku dokonywane jest sprawdzenie zgodności: kodów i ilości towarów oraz ceny zakupu. W przypadku, gdy wartość dostawy na dokumencie PZ nie jest ustalona, następuje zmiana ceny zakupu towarów. Jeżeli w wyniku tych operacji dokumenty: PZ i importowana faktura są zgodne, wówczas do dokumentu PZ tworzony jest spinacz do bufora, w przeciwnym wypadku operator otrzymuje informacje o zaistniałych rozbieżnościach. UWAGA: W związku z tym, iż niektóre sieci przesyłają w plikach komunikacyjnych ECOD, EAN 14 znakowy, od wersji 9.0 systemu Comarch CDN XL będzie eksportowany kod EAN obcięty do 14 znaków, bez względu na to czy występuje na jednostce pomocniczej, na karcie towaru, czy też w polu Kod u kontrahenta. Obsługa linii <BuyerItemCode> i <SupplierItemCode> pozostała bez zmian. Dotyczy eksportu dokumentów: OS, ZZ, WZ, PZ, FS, (S)FS, FSK, (S)FSK. UWAGA: W związku z tym, iż niektóre sieci przesyłają w plikach komunikacyjnych ECOD, EAN 14 znakowy, od wersji 9.0 systemu Comarch CDN XL podczas importu komunikatów system Comarch CDN XL będzie interpretować całą zawartość przesyłaną w linii <EAN> i identyfikować towary po tej całej wartości. Wersja Moduł: ECOD

10 Dotyczy importu komunikatów: OZ, ZS, PZ, potwierdzenie dostawy, FZ, FZK. 3. Eksport dokumentów dokonywany dla sieci elektrotechnicznych 3.1 Ustalanie formatu dla dokonywanego eksportu System Comarch CDN XL umożliwia wymianę komunikatów ProductCatalogue, Order oraz Invoice w formacie przewidzianym dla branży elektrotechnicznej. Operator może więc zdecydować w jakim formacie ma zostać dokonany eksport dokumentu do systemu ECOD. Różnicowanie to zostało oparte na atrybucie wg następującej zasady. Jeżeli na eksportowanym dokumencie OS/ZZ/FS zdefiniowano atrybut o nazwie FormatEcod i określono dla niego wartość Elektro, wówczas wynikiem eksportu takiego dokumentu będzie generowanie pliku xml wg struktury przewidzianej dla sieci elektrotechnicznej, w przeciwnym wypadku wygenerowany plik będzie miał dotychczasową strukturę, właściwą dla sieci handlowych. 3.2 Obsługa opłaty produktowej podczas eksportu faktury sprzedaży Jeżeli dla pozycji eksportowanego dokumentu FS zostanie dodany atrybut o nazwie FeeValue bądź o nazwie KGO i podana zostanie wartość liczbowa tego atrybutu, wówczas wartość ta zostanie potraktowana jako cena jednostkowa opłaty produktowej związanej z daną pozycją, a co za tym idzie linia <FeeValue> dla danej linii komunikatu Invoice zostanie wypełniona wartością tego atrybutu. W celu poprawnej obsługi wyżej wymienionej linii oraz innych linii pliku związanych z opłatą produktową jeden z wyżej wymienionych atrybutów należy dodać do każdego towaru faktury sprzedaży, dla którego opłata ta ma zostać obsłużona, a wartość atrybutu powinna zostać określona na poziomie jednostkowej ceny netto opłaty, wyrażonej z dokładnością do dwóch miejsc po przecinku, bez względu na ilość towaru na tej pozycji FS UWAGA: W przypadku gdy oba atrybuty, atrybut o nazwie FeeValue i atrybut o nazwie KGO, zostały dodane na pozycję dokumentu faktury sprzedaży, linia <FeeValue> zostanie wypełniona wartością atrybutu FeeValue. Jeżeli w komunikacie Invoice przesyłana jest wartość dla linii <FeeValue> i jeżeli w systemie zdefiniowano klasę atrybutu o nazwie FeeValue lub klasę atrybutu o nazwie KGO i przypisano ją do elementu faktury zakupu, to do pozycji dokumentu faktury zakupu zostanie dodany atrybut i wypełniony wartością przesyłaną w linii. UWAGA: W przypadku gdy oba atrybuty, atrybut o nazwie FeeValue i atrybut o nazwie KGO, zostały przypięte do obiektu element faktury zakupu, wówczas przy imporcie dokumentu faktury zakupu, na pozycję dokumentu zostanie dodana pierwsza odszukana klasa atrybutu. 3.3 Jednostka miary w systemie Comarch CDN XL, a jej odpowiednik w systemie ECOD Załączona tabela przedstawia odpowiednik jednostki miary w systemie ECOD dla jednostek miary stosowanych w systemie Comarch CDN XL. Wersja Moduł: ECOD

11 Tabela 1 Jednostka miary w systemie Comarch CDN XL, a jej odpowiednik w systemie ECOD. Jednostka miary w słowniku jednostek CDN XL Wysyłany w pliku kod/wartość pola <UnitOfMeasure> Pliki dla sieci handlowych: Makro, Real,... Pliki dla branży elektro technicznej (bez rozróżnienia na małe/duże litery) PCE, szt, szt. PCE WZ, PZ, ZZ, FS, FSK, OS ZZ, FS, FSK, OS KGM, kg KGM WZ, PZ, ZZ, FS, FSK, OS ZZ, FS, FSK, OS MTR, metr, m MTR WZ, PZ, ZZ, FS, FSK, OS ZZ, FS, FSK, OS MTK, m2, metr kwadratowy MTK WZ, PZ, ZZ, FS, FSK, OS LTR, litr LTR WZ, PZ, ZZ, FS, FSK, OS ZZ, FS, FSK, OS PR, para PR WZ, PZ, ZZ, FS, FSK, OS ZZ, FS, FSK, OS TNE, tona, tona metryczna TNE WZ, PZ, ZZ, FS, FSK, OS ZZ, FS, FSK, OS KMT, kilometr KMT FS, FSK, OS ZZ, FS, FSK, OS PA PA FS, FSK, OS ZZ, FS, FSK, OS SET, kpl, komplet SET FS, FSK, OS ZZ, FS, FSK, OS CT, karton CT FS, FSK, OS PK, paczka PK FS, FSK, OS UWAGA: W przypadku gdy symbol jednostki jest inny nyż wyżej wymieniony lub z innych powodów nie udaje się go zinterpretować, w pliku przesyłany jest symbol PCE. Wersja Moduł: ECOD

12 4 Wymiana dokumentów typu faktura za pomocą systemu ECOD 4.1 Eksport faktury sprzedaży FS do systemu ECOD Tabela 2 przedstawia strukturę komunikatu typu Invoice oraz zasady ustalania i przesyłania do pliku xml informacji zawartych w eksportowanej fakturze sprzedaży (FS). Te sekcje, które nie są przez program obsługiwane są w tabeli pozostawione jako puste. Linie występujące wyłącznie w formacie właściwym dla sieci Elektro prezentowane są w kolorze zielonym, linie występujące wyłącznie w formacie Makro w kolorze niebieskim, linie wspólne w kolorze czarnym. Wersja Moduł: ECOD

13 Tabela 2 Eksport FS do systemu ECOD. Nazwa pola wraz z przykładem jego wypełnienia Opis Źródło informacji (interfejs) <Document-Invoice> <Invoice-Header> <Invoice-Number>FSK42/09/SER</Invoice-Number> Numer faktury Symbol i pełny numer dokumentu FS/FSK, zgodnie z przyjętym w systemie schematem numeracji <InvoiceDate> </InvoiceDate> Data faktury Data wystawienia FS. <SalesDate> </SalesDate> Data sprzedaży Data sprzedaży FS/(S)FS. W przypadku FSK/(S)FSK także będzie to data sprzedaży FS/(S)FS. <InvoiceDuplicateDate></InvoiceDuplicateDate> Data duplikatu Linia występuje wyłącznie w przypadku eksportu duplikatu faktury. Jeżeli do FS dodano atrybut o tej nazwie i typie data i wypełniono go wartością (datą), wówczas w linii tej przesyłana jest wartość tego atrybutu, w przeciwnym wypadku przesyłana jest data dokonywania eksportu <InvoiceCurrency>PLN</InvoiceCurrency> Waluta Waluta systemowa. <InvoicePaymentDueDate> </InvoicePaymentDueDate> Data płatności Data płatności z pola Płatność/Do

14 <InvoicePaymentTerms>7</InvoicePaymentTerms> Termin płatności w dniach Ilość dni liczona jako różnica pomiędzy datą sprzedaży i datą płatności <InvoicePaymentType>42</InvoicePaymentType> Forma płatności Forma płatności dokumentu FS. Wg zasady: gotówka-10, przelew-42, czek-20, kompensata- 97, w przypadku gdy formy nie uda się ustalić przesyłana jest 42-przelew <DocumentFunctionCode>C</DocumentFunctionCode> Typ dokumentu (kopia, oryginał, ) Wartość atrybutu DocumentFunctionCode zdefiniowanego na zakładce Atrybuty dokumentu FS/FSK. Jeżeli atrybut nie został zdefiniowany, wówczas podczas eksportu dokumentu FS wysyłany jest symbol O oryginał, a w przypadku eksportu dokumentu FSK symbol C korekta <CorrectionReason>zwrot uszkodzonego towaru</correctionreason> Powód korekty Linia pojawia się wyłącznie podczas eksportu FSK/(S)FSK, wówczas, gdy powód korekty jest taki sam dla wszystkich korygowanych pozycji. Szczegóły opisane w sekcji Line-Item <Remarks>Uwagi</Remarks> Opis/Uwagi Linia zostanie wypełniona wartością wprowadzoną w polu Opis nagłówka eksportowanego dokumentu FS/(S)FS/FSK/(S)FSK <Order> Sekcja ta pojawi się wówczas, gdy wszystkie linie towarowe wskazują na to samo zamówienie <BuyerOrderNumber>15/2009</BuyerOrderNumber> Numer zamówienia Wartość atrybutu BuyerOrderNumer, zdefiniowanego na zakładce Atrybuty dokumentu Biuletyn techniczny 14

15 FS/FSK. <BuyerOrderDate> </BuyerOrderDate> Data zamówienia Wartość atrybutu BuyerOrderDate, zdefiniowanego na zakładce Atrybuty dokumentu FS/FSK. </Order> <Reference> W przypadku braku atrybutu linia jest uzupełniana datą wystawienia FSK/(S)FSK. <InvoiceReferenceNumber>FS15/09</InvoiceReferenceNumber> Nr faktury korygowanej <InvoiceReferenceDate> </InvoiceReferenceDate> Data faktury korygowanej Wypełnianie jak dla sekcjiline-reference Wypełnianie jak dla sekcjiline-reference </Reference> <Delivery> <DeliveryLocationNumber> </DeliveryLocationNumber> <DeliveryDate> </DeliveryDate> <DespatchNumber>WZ12</DespatchNumber> Wypełniane jak dla sekcji Line-Delivery Wypełniane jak dla sekcji Line-Delivery Wypełniane jak dla sekcji Line-Delivery <Name>ABS</Name> <StreetAndNumber>Handlowa 3</StreetAndNumber> Nazwa kupującego Ulica i numer Biuletyn techniczny 15

16 <CityName>Kraków</CityName> <PostalCode>33-156</PostalCode> <Country>PL</Country> Miasto Kod pocztowy Kraj </Delivery> </Invoice-Header> <Invoice-Parties> <Buyer> <ILN> </ILN> GLN kupującego Numer GLN wprowadzony na formatce adresu, który jest adresem kontrahenta głównego na dokumencie FS <TaxID> </TaxID> NIP kupującego NIP zdefiniowany na formatce adresu, który jest adresem kontrahenta głównego <AccountNumber></AccountNumber> Konto bankowe <Name>ABS</Name> Nazwa kupującego Akronim zdefiniowany na formatce adresu, który jest adresem kontrahenta głównego FS <StreetAndNumber>Handlowa 3</StreetAndNumber> Ulica i numer Dane zdefiniowane na formatce adresu, który jest adresem kontrahenta głównego dokumentu <CityName>Kraków</CityName> Miasto FS <PostalCode>33-156</PostalCode> Kod pocztowy Biuletyn techniczny 16

17 <Country>PL</Country> Kraj </Buyer> <Invoicee> <ILN> </ILN> GLN odbiorcy GLN odbiorcy faktury <TaxID> </TaxID> NIP odbiorcy NIP odbiorcy faktury <AccountNumber></AccountNumber> Konto bankowe Konto bankowe odbiorcy faktury <Name>ABS</Name> Nazwa Nazwa odbiorcy faktury <StreetAndNumber>Handlowa 3</StreetAndNumber> Ulica i numer Dane zdefiniowane na formatce adresu, który jest adresem kontrahenta docelowego <CityName>Kraków</CityName> Miasto dokumentu FS <PostalCode>33-156</PostalCode> <Country>PL</Country> Kod pocztowy Kraj </Invoicee> <Seller> <ILN> </ILN> GLN sprzedającego Numer GLN zdefiniowany na pieczątce firmy przypisanej do centrum będącego właścicielem dokumentu FS <TaxID> </TaxID> NIP sprzedawcy NIP zdefiniowany na wyżej wymienionej pieczątce firmy Biuletyn techniczny 17

18 <AccountNumber></AccountNumber> <CodeByBuyer> </CodeByBuyer> <Name>CDK</Name> Konto bankowe Kod wg kupującego Nazwa sprzedawcy <StreetAndNumber>Mała 14</StreetAndNumber> Ulica i numer Dane z pieczątki firmy przypisanej do centrum będącego właścicielem dokumentu FS <CityName>Kraków</CityName> Miasto <PostalCode>33-185</PostalCode> <Country>PL</Country> Kod pocztowy Kraj <UtilizationRegisterNumber> </UtilizationRegisterNumber> Wartość atrybutu o nazwie UtilizationRegisterNumber zdefiniowanego na zakładce Atrybuty dokumentu FS. <CourtAndCapitalInformation>KRS , Kapitał zakładowy PLN, Kapitał wpłacony: PLN</CourtAndCapitalInformation> </Seller> <Payee> Informacja o sądzie rejestrowym, nr rejestru, wysokości kapitału Dane z sekcji Organ rejestrowy pieczątki odszukanej j.w. (zakładka Deklaracje) <ILN> </ILN> GLN odbiorcy płatności <TaxID> </TaxID> NIP odbiorcy płatności Zgodny z Seller/ILN Zgodny z Seller/TaxID Biuletyn techniczny 18

19 <AccountNumber> </AccountNumber> Konto bankowe odbiorcy płatności <Name>ABS</Name> Nazwa odbiorcy płatności Numer rachunku bankowego z zakładki Nagłówek dokumentu FS Dane zgodne z danymi dla sekcji Seller <StreetAndNumber>Handlowa 3</StreetAndNumber> <CityName>Kraków</CityName> <PostalCode>33-156</PostalCode> <Country>PL</Country> Ulica i numer Miasto Kod pocztowy Kraj </Payee> <SellerHeadquarters> <ILN> </ILN> Dane dotyczące siedziby firmy <Name>CDK</Name> Dane z pieczątki centrum głównego firmy, niezależnie od tego, które centrum jest właścicielem eksportowanego dokumentu <StreetAndNumber> Mała 14</StreetAndNumber> <CityName>Kraków</CityName> <PostalCode>33-185</PostalCode> <Country>PL</Country> </SellerHeadquarters> Biuletyn techniczny 19

20 </Invoice-Parties> <Invoice-Lines> <Line> <Line-Item> <LineNumber>1</LineNumber> Numer pozycji w fakturze Kolejny numer pozycji wczytywanej z FS do pliku <EAN> </EAN> EAN towaru <BuyerItemCode></BuyerItemCode> Kod produktu wg nabywcy <SupplierItemCode></SupplierItemCode> Kod produktu wg sprzedawcy <ItemDescription>buty</ItemDescription> Nazwa produktu Nazwa towaru podana na pozycji dokumentu. Jeżeli na karcie towarowej dodano atrybut: ItemDescription to w linii <ItemDescription> pojawi się wprowadzona nazwa. <ItemType>CU</ItemType> Typ towaru (jednostka handlowa lub opakowanie zwrotne) <InvoiceQuantity>7</InvoiceQuantity> Zafakturowana ilość Biuletyn techniczny 20

21 <UnitOfMeasure>PCE</UnitOfMeasure> Jednostka miary <InvoiceUnitPacksize>1.000</InvoiceUnitPacksize> <PackItemUnitOfMeasure>PCE</PackItemUnitOfMeasure> Liczba sztuk detalicznych w jednostce zbiorczej Jednostka miary sztuki detalicznej w jednostce zbiorczej <InvoiceUnitNetPrice>120.00</InvoiceUnitNetPrice> Cena netto <TaxRate>22.00</TaxRate> Stawka VAT To pole nie jest eksportowane jeżeli stawka jest równa 0% (zwolniony). <TaxCategoryCode>S</TaxCategoryCode> Kod stawki Kod stawki: "E" (exempt) - zwolniony "S" (standard) - inna, wyrażona liczba <TaxReference> <ReferenceType>SWW</ReferenceType> <ReferenceNumber>23-569</ReferenceNumber> Typ referencji Kod SWW/PKWiU </TaxReference> <TaxAmount>184.80</TaxAmount> Wartość VAT pozycji <NetAmount>840.00</NetAmount> Wartość netto pozycji Biuletyn techniczny 21

22 <PreviousInvoiceQuantity>10.000</PreviousInvoiceQuantity> <PreviousInvoiceUnitNetPrice>12.00</PreviousInvoiceUnitNetPrice> Ilość przed korektą Cena przed korektą <PreviousTaxRate>22.00</PreviousTaxRate> Stawka podatku przed korektą <PreviousTaxCategoryCode>S</PreviousTaxCategoryCode> Kategoria podatku przed korektą <PreviousTaxAmount>264.00</PreviousTaxAmount> <PreviousNetAmount> </PreviousNetAmount> <CorrectionInvoiceQuantity>-3.000</CorrectionInvoiceQuantity> <CorrectionInvoiceUnitNetPrice>0.00</CorrectionInvoiceUnitNetPrice> <CorrectionTaxAmount>-79.20</CorrectionTaxAmount> Wartość VAT przed korektą Wartość netto przed korektą Korekta ilości Korekta ceny Korekta podatku <CorrectionNetAmount> </CorrectionNetAmount> Korekta wartości netto <CorrectionReason>zwrot uszkodzonego towaru</correctionreason> Powód korekty <ProductFeeDetails> <UnitNetPriceWithoutFee>23.00</UnitNetPriceWithoutFee> Cena netto bez kosztów gospodarowania Cena wyliczona jak dla linii InvoiceUnitNetPrice, pomniejszona o FeeValue Biuletyn techniczny 22

23 odpadami <NetAmountWithautFee>46.00</NetAmountWithautFee> Wartość bez ww kosztów <FeeValue>0.45</FeeValue> Jednostkowy koszt gospodarowania odpadami UnitNetPriceWithoutFee x InvoiceQuantity Wartość atrybutu a nazwie FeeValue zdefiniowanego dla pozycji, lub cena 2-go elementu zestawu, o którym mowa w pkt <FeeNetAmount>0.06</FeeNetAmount> Wartość ww kosztu FeeValue x InvoiceQuantity </ProductFeeDetails> <Line-Item> <Line-Order> <BuyerOrderNumber>ZZ15/09/SER2</BuyerOrderNumber> Numer zamówienia Linia nie wypełniana dla FSK/(S)FSK w przypadku istnienia atrybutu BuyerOrderNumber. <BuyerOrderDate> </BuyerOrderDate> Data zamówienia Linia nie wypełniana dla FSK/(S)FSK w przypadku istnienia atrybutu BuyerOrderDate. <OrderLineNumber>1</OrderLineNumber> </Line-Order> <Line-Reference> <InvoiceReferenceNumber>FS15</InvoiceReferenceNumber> Numer faktury korygowanej Biuletyn techniczny 23

24 <InvoiceReferenceDate> </InvoiceReferenceDate> Data faktury korygowanej </Line-Reference> <Line-Delivery> <DeliveryLocationNumber> </DeliveryLocationNumber> GLN lokalizacji dostawy <PartyName>ABS</PartyName> <Name>ABS</Name> <StreetAndNumber>Handlowa 3</StreetAndNumber> <CityName>Kraków</CityName> <PostalCode>33-156</PostalCode> <Country>PL</Country> <DeliveryDate> </DeliveryDate> <DespatchNumber>WZ12</DespatchNumber> Data dostawy Numer dostawy <DespatchAdviceNumber></DespatchAdviceNumber> Numer awiza wysyłki </Line-Delivery> </Line> Biuletyn techniczny 24

25 </Invoice-Lines> <Invoice-Summary> <TotalLines>1</TotalLines> <TotalNetAmount>840.00</TotalNetAmount> Suma netto <TotalTaxableBasis>840.00</TotalTaxableBasis> Suma podlegająca opodatkowaniu <TotalTaxAmount>184.00</TotalTaxAmount> <TotalGrossAmount> </TotalGrossAmount> <GrossAmountInWords>minus czterysta trzydzieści dziewięć PLN</GrossAmountInWords> Suma VAT Suma brutto Suma brutto słownie <Tax-Summary> <Tax-Summary-Line> <TaxRate>22.00</TaxRate> Stawka VAT To pole nie jest eksportowane jeżeli stawka jest równa 0% (zwolniony). <TaxCategoryCode>S</TaxCategoryCode> Kod stawki Kod stawki: "E" (exempt) - zwolniony "S" (standard) - inna, wyrażona liczba <TaxAmount>184.80</TaxAmount> Suma VAT dla danej stawki Biuletyn techniczny 25

26 <TaxableBasis>840.00</TaxableBasis> Suma podlegająca opodatkowaniu <TaxableAmount>840.00</TaxableAmount> <GrossAmount> </GrossAmount> Suma VAT Suma brutto </Tax-Summary-Line> </Tax-Summary> <ProductFee-Summary> <TotalNetAmountWithoutFee>46.00</TotalNetAmountWithoutFee> <TotalFeeNetAmount>0.90</TotalFeeNetAmount> </ProductFee-Summary> </Invoice-Summary> </Document-Invoice> 4.2 Najczęstsze problemy występujące przy eksporcie FS do systemu ECOD Aby eksport dokumentu FS do ECOD przebiegł prawidłowo, system musi mieć dostęp do tych informacji, które są informacjami obowiązkowymi dla komunikatu Invoice. Tabela 3 przedstawia najczęstsze problemy, z jakimi operator może się spotkać podczas wykonywania operacji Eksport do ECOD i ich przyczyny: Biuletyn techniczny 26

27 Tabela 3 Przyczyny błędów eksportu FS do systemu ECOD. Treść informacji w logu Przyczyna Remedium Nie określono GLN kontrahenta Dla adresu, który jest adresem kontrahenta głównego FS nie zdefiniowano numeru GLN Odnaleźć adres wskazany na FS jako adres kontrahenta głównego i wpisać na formatce adresu numer GLN Nie określono GLN kontrahenta Nie określono GLN firmy na pieczątce Nie określono numeru NIP firmy Dla adresu, który jest adresem kontrahenta docelowego na FS nie zdefiniowano numeru GLN Do centrum będącego właścicielem dokumentu FS nie przypisano pieczątki, lub na przypisanej pieczątce nie zdefiniowano numeru GLN Do centrum będącego właścicielem dokumentu FS nie przypisano pieczątki, lub na przypisanej pieczątce nie zdefiniowano numeru NIP Odnaleźć adres wskazany na FS jako adres kontrahenta docelowego i wpisać na formatce adresu numer GLN Przypisać do centrum pieczątkę, lub jeżeli jest ona już przypisana wpisać na niej numer GLN Przypisać do centrum pieczątkę, lub jeżeli jest ona już przypisana wpisać na niej numer NIP Nie określono numeru rachunku na rejestrze dokumentu Na zakładce Nagłówek dokumentu FS nie wybrano rejestru bankowego Wybrać rejestr bankowy na dokumencie FS Nie określono numeru EAN na karcie towaru: T1 (format Makro) Dla towaru T1 będącym elementem dokumentu FS nie zdefiniowano numeru EAN (błąd wystąpi jeżeli dla towaru nie zdefiniowano żadnego z poniższych numerów: brak numeru na formatce jednostki pomocniczej towaru użytej na dokumencie FS, brak numeru EAN na zakładce Ogólne karty towaru T1, brak kodu u kontrahenta dla Odbiorcy zgodnego z kontrahentem głównym FS Jeżeli użyto jednostki pomocniczej towaru i wysłana ma być ilość w tej jednostce, należy określić EAN na formatce tej jednostki pomocniczej towaru. Jeżeli wysłana ma być ilość w jednostce głównej należy zdefiniować EAN na zakładce Ogólne karty towaru T1, lub wpisać EAN w polu u kontrahenta na formatce Odbiorca towaru, definiowanej na zakładce Kontrahenci karty towaru T1 dla kontrahenta głównego FS 4.3 Import faktury FZ z systemu ECOD W wyniku dokonywanej operacji Import FZ z ECOD w systemie zostaje wygenerowany dokument FZ (tabela 4). Podstawowe dane na tym dokumencie ustalane są na podstawie przekazanych w pliku Invoice informacji. Sposób interpretacji tych danych przedstawia. Puste sekcje w tabeli oznaczają, że informacje, których dotyczą nie są przez system interpretowane. Biuletyn techniczny 27

28 Sekcje: Order, Reference, Delivery, Line-Order, Line-Reference, Line-Delivery, Invoice-Summary nie są interpretowane, stąd zostały w tabeli pominięte. Tabela 4 Import FZ z systemu ECOD. Nazwa pola wraz z przykładem jego wypełnienia Opis Źródło informacji (interfejs) <Document-Invoice> <Invoice-Header> <Invoice-Number>FS48/09/SER</Invoice-Number> Numer faktury Numer faktury przepisywany jest do pola Faktura na zakładce Nagłówek dokumentu FZ <InvoiceDate> </InvoiceDate> Data faktury Na tej podstawie ustalana jest data wystawienia dokumentu FZ <InvoiceDuplicateDate> </InvoiceDuplicateDate> Data duplikatu Jeżeli dla obiektu FZ zdefiniowano klasę atrybutu o nazwie InvoiceDuplicateDate, wówczas na generowanym w wyniku importu dokumencie FZ ta klasa zostanie automatycznie dodana i wypełniona wartością atrybutu zgodną z przesyłaną w pliku <InvoiceCurrency>PLN</InvoiceCurrency> Waluta Waluta FZ, widoczna na zakładce Nagłówek dokumentu FZ. Jeżeli waluta jest inna niż PLN, wówczas na dokumencie zaznaczony zostaje parametr import i ustalony kurs bieżący o rodzaju zdefiniowanym w definicji dokumentu FZ centrum, które wykonuje operację importu <InvoicePaymentDueDate> </InvoicePaymentDueDate> Data płatności Na tej podstawie ustalany jest termin płatności (data) na dokumencie FZ oraz na jego płatnościach Biuletyn techniczny 28

29 <InvoicePaymentTerms>30</InvoicePaymentTerms> Termin płatności w dniach Termin w dniach jest wyliczany samodzielnie, jako różnica pomiędzy datą płatności (InvoicePaymentDueDate) a odpowiednio: datą wpływu, wystawienia lub zakupu w zależności od dokonanego wyboru w definicji dokumentu FZ ( Płatność od daty zakładka Parametry) <InvoicePaymentType>42</InvoicePaymentType> Forma płatności Na tej podstawie ustalana jest forma płatności na FZ, wg zasady: 10-gotówka, 42-przelew, 20-czek, 97-kompensata, jeżeli w systemie nie zdefiniowano takiej formy, lub linia ta nie jest przesyłana, wówczas na FZ ustalana jest forma domyślna <DocumentFunctionCode>O</DocumentFunctionCode> Typ dokumentu (kopia, oryginał, ) <CorrectionReason>zwrot uszkodzonego towaru</correctionreason> Powód korekty <Remarks>Uwagi</Remarks> Opis/Uwagi Jeżeli linia jest wypełniona wówczas jej wartość zostanie zapisana w polu Opis dokumentu FZ/(S)FZ. </Invoice-Header> <Invoice-Parties> <Buyer> <ILN> </ILN> <TaxID> </TaxID> GLN kupującego NIP kupującego Biuletyn techniczny 29

30 <AccountNumber></AccountNumber> Konto bankowe kupującego <Name>ABS</Name> <StreetAndNumber>Handlowa 3</StreetAndNumber> <CityName>Kraków</CityName> <PostalCode>33-156</PostalCode> <Country>PL</Country> Nazwa kupującego Ulica i numer Miasto Kod pocztowy Kraj </Buyer> <Invoicee> <ILN> </ILN> <TaxID> </TaxID> <AccountNumber></AccountNumber> <Name>ABS</Name> <StreetAndNumber>Handlowa 3</StreetAndNumber> <CityName>Kraków</CityName> <PostalCode>33-156</PostalCode> <Country>PLN</Country> GLN odbiorcy NIP odbiorcy Konto bankowe Nazwa Ulica i numer Miasto Kod pocztowy Kraj Biuletyn techniczny 30

31 </Invoicee> <Seller> <ILN> </ILN> GLN sprzedającego Na tej podstawie ustalany jest kontrahent główny na dokumencie FZ w sposób następujący: Najpierw poszukiwany jest kontrahent z numerem GLN zdefiniowanym na zakładce Ogólne karty kontrahenta zgodnym z przesyłanym GLN, jeżeli zostanie on odnaleziony, wówczas zostanie on ustalony jako kontrahent główny z jego adresem aktualnym. Jeżeli ww. kontrahent nie zostanie odnaleziony, wówczas poszukiwany jest adres z numerem GLN zgodnym z przesyłanym nr GLN. Tak odnaleziony adres staje się adresem kontrahenta głównego na dokumencie FZ, a kontrahentem głównym kontrahent z tego adresu. Kontrahent docelowy jest zgodny z kontrahentem głównym, a adres zgodny z adresem aktualnym kontrahenta <TaxID> </TaxID> NIP sprzedawcy <AccountNumber></AccountNumber> Konto bankowe sprzedawcy <CodeByBuyer> </CodeByBuyer> Kod wg kupującego (kod pod jakim sprzedawca figuruje Jeżeli dla obiektu FZ zdefiniowano klasę atrybutu o nazwie CodeByBuyer i jeżeli w pliku jest ten numer przesyłany, wówczas na generowanym w wyniku importu dokumencie FZ ta klasa zostanie Biuletyn techniczny 31

32 u odbiorcy) automatycznie dodana i wypełniona wartością atrybutu zgodną z przesyłaną w pliku zawartością sekcji <CodeByBuyer> <Name>CDK</Name> <StreetAndNumber>Mała 14</StreetAndNumber> <CityName>Kraków</CityName> <PostalCode>33-185</PostalCode> <Country>PL</Country> Nazwa sprzedawcy Ulica i numer Miasto Kod pocztowy Kraj <UtilizationRegisterNumber> </UtilizationRegisterNumber> Jeżeli dla obiektu FZ zdefiniowano klasę atrybutu o nazwie UtilizationRegisterNumber, wówczas na generowanym w wyniku importu dokumencie FZ ta klasa zostanie automatycznie dodana i wypełniona wartością zgodną z przesyłaną w pliku zawartością tej linii </Seller> <Payee> <ILN> </ILN> GLN odbiorcy płatności Na tej podstawie ustalony zostaje płatnik na dokumencie FZ (interpretowany jako odbiorca płatności) <TaxID> </TaxID> NIP odbiorcy płatności Biuletyn techniczny 32

33 <AccountNumber></AccountNumber> Konto bankowe odbiorcy płatności <Name>ABS</Name> Nazwa odbiorcy płatności <StreetAndNumber>Handlowa 3</StreetAndNumber> <CityName>Kraków</CityName> <PostalCode>33-156</PostalCode> <Country>PL</Country> Ulica i numer Miasto Kod pocztowy Kraj </Payee> </Invoice-Parties> <Invoice-Lines> <Line> <Line-Item> <LineNumber>1</LineNumber> Numer pozycji w fakturze <EAN> </EAN> EAN towaru Na tej podstawie identyfikowany jest towar, którego faktura dotyczy wg kolejności: najpierw sprawdzane są jednostki pomocnicze towaru, jeżeli zostanie odnaleziona jednostka pomocnicza z numerem EAN zgodnym z przesłanym, wówczas na elemencie FZ Biuletyn techniczny 33

34 <BuyerItemCode></BuyerItemCode> <SupplierItemCode></SupplierItemCode> Kod produktu wg nabywcy Kod produktu wg sprzedawcy ustalany jest dany towar w tej jednostce. Jeżeli jednostka taka nie zostanie odnaleziona, wówczas poszukiwany jest towar, dla którego na zakładce Ogólne zdefiniowano EAN zgodny z przesyłanym i towar spełniający ww. warunek zostaje ustalony na elemencie FZ. Jeżeli taki towar nie zostanie odnaleziony, wówczas poszukiwany jest towar, dla którego na zakładce Kontrahenci kod u kontrahenta zgodny z przesyłanym EAN-em. W przypadku tak odnalezionego towaru, jeżeli dla kontrahenta tego towaru zdefiniowano jednostkę pomocniczą, wówczas towar taki dodawany jest na FZ z tą jednostką jako pomocnicza Jeżeli EAN nie jest przesyłany, wówczas ustalony zostanie towar z kodem (Twr_Kod) zgodnym z wartością przesyłaną w tej linii Jeżeli ani EAN ani BuyerItemCode nie jest przesyłany, wówczas ustalany jest towar, dla którego na formatce dostawcy zdefiniowano: kod u kontrahenta zgodny z wartością przesyłaną w tej linii. <ItemDescription>buty</ItemDescription> Nazwa produktu Nazwa towaru podana na pozycji dokumentu. Jeżeli na karcie towarowej dodano atrybut: ItemDescription to w linii <ItemDescription> pojawi się wprowadzona nazwa. <ItemType>CU</ItemType> Typ towaru Biuletyn techniczny 34

35 <InvoiceQuantity>2</InvoiceQuantity> Zafakturowana ilość Jeżeli towar zostanie zidentyfikowany na podstawie EAN-u jednostki pomocniczej, czyli na podstawie EAN-u zdefiniowanego na formatce jednostki pomocniczej, lub na podstawie kod u kontrahenta, dla którego zdefiniowano jednostkę pomocniczą, wówczas przesłana ilość traktowana jest jako ilość w jednostce pomocniczej, a ilość w jednostce głównej wyliczana jest na podstawie przelicznika do jednostki pomocniczej. W pozostałych wypadkach przesyłana ilość traktowana jest jako ilość w jednostce podstawowej i taka jest ustalana na elemencie FZ. W takim wypadku jednostka pomocnicza pojawi się na elemencie FZ tylko wówczas, jeżeli jest ona domyślna dla zakupu, a jej ilość zostanie wyliczona na podstawie ilości w jednostce głównej i przelicznika. <UnitOfMeasure>PCE</UnitOfMeasure> Jednostka miary <InvoiceUnitPacksize>1.000</InvoiceUnitPacksize> <PackItemUnitOfMeasure>PCE</PackItemUnitOfMeasure> Liczba sztuk detalicznych w jednostce zbiorczej Jednostka miary sztuki detalicznej w jednostce zbiorczej <InvoiceUnitNetPrice>23.45</InvoiceUnitNetPrice> Cena netto Jeżeli towar znaleziony zostanie wg jednostki pomocniczej (patrz wyżej), wówczas przesyłana cena jest traktowana jako cena dla tej jednostki pomocniczej, a cena dla jednostki głównej wyliczana wtórnie. W pozostałych wypadkach przesyłana cena jest Biuletyn techniczny 35

36 interpretowana jako cena jednostkowa dla jednostki głównej. W każdym przypadku, jeżeli waluta faktury jest inna niż PLN, wówczas przesyłana cena jest przeliczana na PLN po kursie bieżącym <TaxRate>7.00</TaxRate> Stawka VAT Na tej podstawie ustalana jest stawka VAT pozycji dokumentu FZ <TaxCategoryCode>S</TaxCategoryCode> Kod stawki Istotna dla TaxRate=0, wówczas przesyłany kod jest interpretowany następująco: "Z" - na elemencie ustalona zostanie ta stawka 0%, dla której w systemie zdefiniowano status "nie podlega"; "E" - na elemencie ustalona zostanie ta stawka 0%, dla której w systemie zdefiniowano status "zwolniony" <TaxReference> <ReferenceType>SWW</ReferenceType> Typ referencji (SWW/PKWiU) <ReferenceNumber>23-569</ReferenceNumber> Kod SWW/PKWiU </TaxReference> <TaxAmount>3.28</TaxAmount> Wartość VAT pozycji <NetAmount>46.90</NetAmount> Wartość netto pozycji <PreviousInvoiceQuantity>1.000</PreviousInvoiceQuantity> Ilość przed korektą Biuletyn techniczny 36

37 <PreviousInvoiceUnitNetPrice>12.00</PreviousInvoiceUnitNetPrice> Cena przed korektą <PreviousTaxRate>22.00</PreviousTaxRate> Stawka podatku przed korektą <PreviousTaxCategoryCode>S</PreviousTaxCategoryCode> Kategoria podatku przed korektą <PreviousTaxAmount>5.16</PreviousTaxAmount> Wartość VAT przed korektą <PreviousNetAmount>23.45</PreviousNetAmount> Wartość netto przed korektą <CorrectionInvoiceQuantity>-1.000</CorrectionInvoiceQuantity> <CorrectionInvoiceUnitNetPrice>0.00</CorrectionInvoiceUnitNetPrice> <CorrectionTaxAmount>-5.16</CorrectionTaxAmount> Korekta ilości Korekta ceny Korekta podatku <CorrectionNetAmount>-23.45</CorrectionNetAmount> Korekta wartości netto <ProductFeeDetails> <UnitNetPriceWithoutFee>46.00</UnitNetPriceWithoutFee> Cena netto bez kosztów gospodarowania odpadami <NetAmountWithautFee>46.00</NetAmountWithautFee> Wartość bez ww. kosztów Biuletyn techniczny 37

38 <FeeValue>0.45</FeeValue> <FeeNetAmount>0.06</FeeNetAmount> </ProductFeeDetails> <Line-Item> Jednostkowy koszt gospodarowania odpadami Wartość ww. kosztu Jeżeli do pozycji FZ przypisano klasę atrybutu o nazwie FeeValue, wówczas na utworzonym w wyniku importu elemencie dokumentu FZ atrybut ten zostanie automatycznie dodany i wypełniony wartością przesyłaną w tej linii Pełna nazwa pliku Invoice zapisywana jest w polu URL zakładka Nagłówek generowanego dokumentu FZ </Document-Invoice> Biuletyn techniczny 38

39 4.4 Najczęstsze problemy występujące podczas importu faktury zakupu z ECOD Aby operacja importu pliku Invoice przebiegła prawidłowo, system muszą odnaleźć i odpowiednio zinterpretować przesyłane w pliku informacje. Tabela 5 przedstawia najczęstsze problemy, z jakimi operator może się spotkać podczas wykonywania operacji Import FZ z ECOD i ich przyczyny. Tabela 5 Przyczyny błędów importu FZ z systemu ECOD. Treść informacji w logu Przyczyna Remedium Nie znaleziono waluty W programie XL nie zdefiniowano waluty o symbolu zgodnym z przesyłaną waluta faktury Sprawdzić w sekcji <Invoice-Currency> importowanego pliku symbol waluty, zdefiniować taką walutę w systemie Nie udało się odnaleźć kontrahenta o numerze GLN: W systemie nie ma kontrahenta, dla którego istniałby (na jego karcie lub formatce adresu) numer GLN zgodny z przesyłanym w pliku Wprowadzić numer GLN na zakładce Ogólne karty kontrahenta-sprzedawcy, a jeżeli adres kontrahenta ma być inny niż jego adres aktualny, wówczas wprowadzić numer GLN na jednym z jego adresów Nie udało się odnaleźć towaru o numerze EAN W systemie nie istnieje towar z numerem EAN zgodnym z przesyłanym w pliku (błąd wystąpi jeżeli nie zostanie odnaleziony EAN w żadnej ze wskazanych pozycji: brak jednostki pomocniczej z numerem EAN zgodnym z przesyłanym, brak karty towaru, na której na zakładce Ogólne zdefiniowano EAN zgodny z przesyłanym, brak towaru, dla którego zdefiniowano kod u kontrahenta zgodny z przesyłanym Na towarze, którego dotyczy importowana faktura należy zdefiniować numer EAN zgodny z przesyłanym Nie znaleziono w konfiguracji wybranej stawki podatkowej 7% S W programie nie zdefiniowano stawki podatkowej 7% Dodać brakująca stawkę podatku do konfiguracji systemu Biuletyn techniczny 39

40 5 Wymiana katalogu produktów za pomocą systemu ECOD 5.1 Eksport katalogu produktów OS do systemu ECOD Podstawą generowania pliku xml dla komunikatu Product Catalogue wysyłanego do odbiorcy jest zarejestrowana w systemie oferta na sprzedaż. Tabela 6 przedstawia strukturę komunikatu typu Product Catalogue oraz zasady ustalania i przesyłania do pliku xml informacji zawartych w eksportowanej ofercie sprzedaży. Sekcje, które nie są przez program obsługiwane, pozostawione są w tabeli jako puste. Linie występujące wyłącznie w formacie właściwym dla sieci Elektro prezentowane są w kolorze zielonym, linie występujące wyłącznie w formacie Makro w kolorze niebieskim, linie wspólne w kolorze czarnym. Tabela 6 Eksport OS do ECOD. Nazwa pola wraz z przykładem jego wypełnienia Opis Źródło informacji (interfejs) <Document-ProductCatalogue> <ProductCatalogue-Header> <ProductCatalogueNumber>4</ProductCatalogueNumber> <ProductCatalogueDate> </ProductCatalogueDate> <PeriodEndDate> </PeriodEndDate> <DocumentFunctionCode>N</DocumentFunctionCode> </ProductCatalogue-Header> Numer katalogu produktów Data katalogu produktów Data obowiązywania Data obowiązywania Do (brak wpisu oznacza bezterminowe obowiązywanie) Typ dokumentu: N nie przyrostowy Biuletyn techniczny 40

41 <ProductCatalogue-Parties> <Buyer> <ILN> </ILN> <OrderContact></OrderContact> </Buyer> <Seller> <ILN> </ILN> <OrderContact></OrderContact> </Seller> </ProductCatalogue-Parties> <ProductCatalogue-Lines> <Line> <Line-Item> <LineNumber>1</LineNumber> GLN kupującego Osoba kontaktowa GLN sprzedawcy Osoba kontaktowa Numer linii Osoba kontaktowa dotycząca zamówień Osoba kontaktowa dotycząca zamówień Biuletyn techniczny 41

42 <LineType>3</LineType> TYLKO MAKRO <EAN> </EAN> <BuyerItemCode> </BuyerItemCode> TYLKO MAKRO <SupplierItemCode>T1</SupplierItemCode> <PreviousEAN></PreviousEAN> <PreviousBuyerItemCode></PreviousBuyerItemCode> TYLKO MAKRO <PreviousSupplierItemCode></PreviousSupplierItemCode> <ItemDescription>buty</ItemDescription> <ItemType>CU</ItemType> Typ linii EAN produktu Kod produktu kupującego Kod produktu sprzedawcy EAN produktu poprzednika Kod produktu kupującego poprzednika Kod produktu sprzedawcy poprzednika Nazwa produktu Identyfikator opakowania Typ linii: 1-dodana; 2-usunięta; 3-zmieniona; 4- bez zmian Linia wypełniana na podstawie atrybutu PreviousEAN umieszczonego na elemencie oferty sprzedaży Nazwa towaru podana na pozycji dokumentu. Jeżeli na karcie towarowej dodano atrybut: ItemDescription to w linii <ItemDescription> pojawi się wprowadzona nazwa. "CU" jednostka handlowa Biuletyn techniczny 42

43 zwrotnego. "RC" opakowanie zwrotne <UnitOfMeasure>PCE</UnitOfMeasure> Jednostka miary "PCE" sztuka "KGM" kilogram "MTR" - metr "KMT" kilometr "PA" - opakowanie "SET" - komplet "PR" - para "TNE" tona metryczna "LTR" - litr <UnitNetPrice>81.97</UnitNetPrice> TYLKO MAKRO <TaxRate>22.00</TaxRate> <TaxCategoryCode>S</TaxCategoryCode> <TaxReference> Cena jednostkowa netto Stawka VAT Kod stawki To pole nie jest eksportowane jeżeli stawka jest równa 0% (zwolniony). Kod stawki: "E" (exempt) - zwolniony "S" (standard) - inna, wyrażona liczba <ReferenceType>PKWIU</ReferenceType> Kod referencji typu <ReferenceNumber></ReferenceNumber> Kod PKWIU Biuletyn techniczny 43

44 </TaxReference> <PackDetails> <UnitPackSize>1.000</UnitPackSize> TYLKO MAKRO Ilość w opakowaniu zbiorczym w jednostce miary </PackDetails> </Line-Item> </Line> </ProductCatalogue-Lines> <ProductCatalogue-Summary> <TotalLines>1</TotalLines> Ilość linii </ProductCatalogue-Summary> </Document-ProductCatalogue> 5.2 Najczęstsze problemy występujące podczas eksportu katalogu produktów do systemu ECOD Aby eksport katalogu produktu do ECOD przebiegł prawidłowo, system musi mieć dostęp do tych informacji, które są informacjami obowiązkowymi dla komunikatu Product Catalog. Tabela 7 przedstawia najczęstsze problemy, z jakimi operator może się spotkać podczas wykonywania operacji Eksport do ECOD i ich przyczyny. Biuletyn techniczny 44

45 Tabela 7 Przyczyny błędów eksportu ZZ do systemu ECOD. Treść informacji w logu Przyczyna Remedium Nie określono numeru GLN firmy na pieczątce Do centrum będącego właścicielem dokumentu ZZ nie przypisano pieczątki, lub na przypisanej pieczątce nie zdefiniowano numeru GLN Przypisać do centrum pieczątkę, lub jeżeli jest ona już przypisana wpisać na niej numer GLN Nie określono numeru GLN kontrahenta Dla adresu, który jest adresem kontrahenta głównego ZZ nie zdefiniowano numeru GLN Odnaleźć adres wskazany na ZZ jako adres kontrahenta głównego i wpisać na formatce adresu numer GLN Nie określono numeru GLN miejsca dostawy Do centrum będącego właścicielem ZZ nie została przypisana pieczątka, lub też nie zdefiniowano żadnego z poniższych numerów GLN: numeru GLN na formatce adresu wysyłkowego kontrahenta wewnętrznego przypisanego do pieczątki firmy, numeru GLN na pieczątce firmy Przypisać pieczątkę do centrum-właściciela ZZ i wpisać na niej numer GLN. Jeżeli miejsce dostawy ma być inne, niż adres z pieczątki, przypisać do pieczątki kontrahenta wewnętrznego, zdefiniować dla niego adres wysyłkowy zgodny z miejscem dostawy i wprowadzić na nim numer GLN Nie określono numeru GLN punktu wysyłki Dla adresu, który jest adresem kontrahenta docelowego ZZ nie zdefiniowano numeru GLN Sprawdzić, który adres został wybrany jako adres kontrahenta docelowego ZZ, zdefiniować na formatce tego adresu numer GLN Nie określono numeru EAN na karcie towaru: T1 (format Makro) Dla towaru T1 będącym elementem dokumentu ZZ nie zdefiniowano numeru EAN (błąd wystąpi jeżeli dla towaru nie zdefiniowano żadnego z poniższych numerów: brak numeru na formatce jednostki pomocniczej towaru użytej na dokumencie ZZ, brak numeru EAN na zakładce Ogólne karty towaru T1, brak kodu u kontrahenta dla Odbiorcy Jeżeli użyto jednostki pomocniczej towaru i wysłana ma być ilość w tej jednostce, należy określić EAN na formatce tej jednostki pomocniczej towaru. Jeżeli wysłana ma być ilość w jednostce głównej należy zdefiniować EAN na zakładce Ogólne karty towaru T1, lub wpisać EAN w polu u kontrahenta na formatce Odbiorca towaru, definiowanej na zakładce Biuletyn techniczny 45

46 zgodnego z kontrahentem głównym ZZ Kontrahenci karty towaru T1 dla kontrahenta głównego ZZ 5.3 Import katalogu produktów OZ z systemu ECOD W wyniku dokonywanej z poziomu listy zamówień sprzedaży operacji: Import z ECOD w systemie zostaje wygenerowany dokument ZS. Podstawowe dane na tym dokumencie ustalane są na podstawie przekazanych w pliku Order informacji. Sposób interpretacji tych danych przedstawia Tabela 8. Puste sekcje w tabeli oznaczają, że informacje, których dotyczą nie są przez system interpretowane. Tabela 8 Import katalogu produktów z systemu ECOD. Nazwa pola wraz z przykładem jego wypełnienia Opis Źródło informacji (interfejs) <Document-ProductCatalogue> <ProductCatalogue-Header> <ProductCatalogueNumber>4</ProductCatalogueNumber> <PeriodEndDate> </PeriodEndDate> <DocumentFunctionCode>N</DocumentFunctionCode> </ProductCatalogue-Header> <ProductCatalogue-Parties> Numer katalogu produktów Data obowiązywania Data obowiązywania Do (brak wpisu oznacza bezterminowe obowiązywanie) Typ dokumentu: P przyrostowy N nie przyrostowy Biuletyn techniczny 46

47 <Seller> <ILN> </ILN> GLN sprzedawcy </Seller> </ProductCatalogue-Parties> <ProductCatalogue-Lines> <Line> <Line-Item> <LineNumber>1</LineNumber> <LineType>3</LineType> TYLKO MAKRO <EAN> </EAN> <BuyerItemCode> </BuyerItemCode> TYLKO MAKRO <SupplierItemCode>T1</SupplierItemCode> <PreviousEAN></PreviousEAN> Numer linii Typ linii EAN produktu Kod produktu kupującego Kod produktu sprzedawcy EAN produktu poprzednika Typ linii: 1-dodana; 2-usunięta; 3-zmieniona; 4- bez zmian Linia wypełniana na podstawie atrybutu PreviousEAN umieszczonego Biuletyn techniczny 47

48 <PreviousBuyerItemCode></PreviousBuyerItemCode> TYLKO MAKRO <PreviousSupplierItemCode></PreviousSupplierItemCode> <UnitNetPrice>81.97</UnitNetPrice> TYLKO MAKRO Kod produktu kupującego poprzednika Kod produktu sprzedawcy poprzednika Cena jednostkowa netto <PackDetails> <UnitPackSize>1.000</UnitPackSize> TYLKO MAKRO Ilość w opakowaniu zbiorczym w jednostce miary </PackDetails> </Line-Item> </Line> </ProductCatalogue-Lines> <ProductCatalogue-Summary> <TotalLines>1</TotalLines> Ilość linii </ProductCatalogue-Summary> </Document-ProductCatalogue> Biuletyn techniczny 48

49 5.4 Najczęstsze problemy występujące podczas importu katalogu produktów OZ z ECOD Aby operacja importu pliku ProductCatalog przebiegła prawidłowo, system musi odnaleźć i odpowiednio zinterpretować przesyłane w pliku informacje. Tabela 9 przedstawia najczęstsze problemy, z jakimi operator może się spotkać podczas wykonywania operacji Import OZ z ECOD i ich przyczyny. Tabela 9 Przyczyny błędów importu FZ z systemu ECOD. Treść informacji w logu Przyczyna Remedium Nie znaleziono waluty W programie XL nie zdefiniowano waluty o symbolu zgodnym z przesyłaną waluta faktury Sprawdzić w sekcji <Invoice-Currency> importowanego pliku symbol waluty, zdefiniować taką walutę w systemie Nie udało się odnaleźć kontrahenta o numerze GLN: W systemie nie ma kontrahenta, dla którego istniałby (na jego karcie lub formatce adresu) numer GLN zgodny z przesyłanym w pliku Wprowadzić numer GLN na zakładce Ogólne karty kontrahenta-sprzedawcy, a jeżeli adres kontrahenta ma być inny niż jego adres aktualny, wówczas wprowadzić numer GLN na jednym z jego adresów Nie udało się odnaleźć towaru o numerze EAN W systemie nie istnieje towar z numerem EAN zgodnym z przesyłanym w pliku (błąd wystąpi jeżeli nie zostanie odnaleziony EAN w żadnej ze wskazanych pozycji: brak jednostki pomocniczej z numerem EAN zgodnym z przesyłanym, brak karty towaru, na której na zakładce Ogólne zdefiniowano EAN zgodny z przesyłanym, brak towaru, dla którego zdefiniowano kod u kontrahenta zgodny z przesyłanym Na towarze, którego dotyczy importowana faktura należy zdefiniować numer EAN zgodny z przesyłanym Nie znaleziono w konfiguracji wybranej stawki podatkowej 7% S W programie nie zdefiniowano stawki podatkowej 7% Dodać brakująca stawkę podatku do konfiguracji systemu Biuletyn techniczny 49