{"id":8899,"date":"2024-07-24T15:51:25","date_gmt":"2024-07-24T13:51:25","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&p=8899"},"modified":"2024-07-30T15:12:00","modified_gmt":"2024-07-30T13:12:00","slug":"import-kontraktow-konsumenckich","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/import-kontraktow-konsumenckich\/","title":{"rendered":"Import kontrakt\u00f3w sprzeda\u017cy"},"content":{"rendered":"

Niniejsza dokumentacja opisuje instrukcj\u0119 korzystania z aplikacji Import danych<\/em> w odniesieniu do kontakt\u00f3w sprzeda\u017cy. Instrukcje te zawieraj\u0105 og\u00f3lne kroki instrukcji i specjalne funkcje, kt\u00f3re nale\u017cy wzi\u0105\u0107 pod uwag\u0119. Zostaniesz r\u00f3wnie\u017c poinformowany o mo\u017cliwych warunkach wst\u0119pnych i skutkach.<\/p>\n

Opis aplikacji Import danych<\/em> kt\u00f3ry zawiera r\u00f3wnie\u017c opisy p\u00f3l i przycisk\u00f3w, mo\u017cna znale\u017a\u0107 w dokumentacji Import danych<\/em>.<\/p>\n

Informacje og\u00f3lne<\/strong><\/p>\n

Import kontrakt\u00f3w sprzeda\u017cy jest zasadniczo oparty na bie\u017c\u0105cym modelu danych, kt\u00f3ry jest przechowywany w bazie danych repozytorium. W przypadku eksportu danych dost\u0119pnych jest wi\u0119cej atrybut\u00f3w ni\u017c w przypadku importu danych. Dlatego sensowne jest zdefiniowanie oddzielnych filtr\u00f3w dla eksportu i importu.<\/p>\n

Relacje 1:1 s\u0105 zazwyczaj oparte na technicznym atrybucie GUID w modelu danych. W zale\u017cno\u015bci od przypadku u\u017cycia, do importu mo\u017cna u\u017cy\u0107 technicznego atrybutu GUID lub klucza funkcjonalnego z obiektu docelowego (zwykle kodu lub numeru). W przypadku niekt\u00f3rych obiekt\u00f3w biznesowych wymagana jest organizacja do konwersji klucza funkcjonalnego na klucz techniczny. Odpowiednia organizacja nie jest zwykle bezpo\u015brednio w \u017ar\u00f3dle importu, ale jest okre\u015blana za po\u015brednictwem kontekstu dokumentu. Wi\u0119cej informacji na ten temat mo\u017cna znale\u017a\u0107 w rozdziale Przegl\u0105d: Atrybuty<\/em><\/a>.<\/p>\n

Obiekty biznesowe kodu skr\u00f3tu s\u0105 przywo\u0142ywane zar\u00f3wno w podstawie, jak i w pozycji kontraktu sprzeda\u017cy. S\u0105 to technicznie powi\u0105zane grupy atrybut\u00f3w, kt\u00f3re s\u0105 zawsze takie same dla wielu dokument\u00f3w i kt\u00f3rych ponowne u\u017cycie pozwala zaoszcz\u0119dzi\u0107 miejsce w bazie danych i pami\u0119ci g\u0142\u00f3wnej. Korzystaj\u0105c ze specjalnej konwersji, obiekty biznesowe z kodem skr\u00f3tu s\u0105 wy\u015bwietlane jako cz\u0119\u015bci do eksportu lub importu.<\/p>\n

Niekt\u00f3re dane kontraktu sprzeda\u017cy, takie jak warto\u015bci waluty lokalnej, status i wewn\u0119trzne atrybuty pomocnicze nie mog\u0105 by\u0107 importowane.<\/p>\n

Je\u015bli nie ma pewno\u015bci, kt\u00f3ry format jest odpowiedni dla pliku importu, nale\u017cy wykona\u0107 nast\u0119puj\u0105ce czynno\u015bci: Wprowadzi\u0107 przyk\u0142adowy dokument za po\u015brednictwem aplikacji Kontrakty sprzeda\u017cy<\/em> i wyeksportowa\u0107 go przy u\u017cyciu filtra dla importu w \u017c\u0105danym formacie z \u017c\u0105danymi atrybutami. Wynikowy plik przyk\u0142adowy mo\u017ce zosta\u0107 u\u017cyty jako szablon dla generowanych plik\u00f3w importu.<\/p>\n

Podczas importowania obowi\u0105zuj\u0105 te same zasady, co podczas edycji za po\u015brednictwem aplikacji. Na przyk\u0142ad artyku\u0142 w zapisanym elemencie nie mo\u017ce by\u0107 p\u00f3\u017aniej zmieniany. Warto\u015bci atrybut\u00f3w s\u0105 ignorowane, je\u015bli nie mo\u017cna ich przyj\u0105\u0107 w bie\u017c\u0105cym kontek\u015bcie. Ta sama logika jest stosowana przy okre\u015blaniu warto\u015bci domy\u015blnej, wi\u0119c import i aplikacja zachowuj\u0105 si\u0119 identycznie. To samo dotyczy kontroli.<\/p>\n

Instrukcja: Import kontrakt\u00f3w sprzeda\u017cy<\/strong><\/p>\n

    \n
  1. Nale\u017cy otworzy\u0107 aplikacj\u0119 Import danych<\/em>.<\/li>\n
  2. Wy\u015bwietli\u0107 filtr dla obiektu biznesowego: com.cisag.app.sales.obj.SalesContract<\/em><\/li>\n<\/ol>\n

    \u2192Zostanie otwarty filtr do importu kontraktu sprzeda\u017cy.<\/p>\n

      \n
    1. W razie potrzeby mo\u017cna powieli\u0107 lub utworzy\u0107 nowy filtr dla tego obiektu biznesowego.<\/li>\n
    2. W razie potrzeby mo\u017cna zmieni\u0107 ju\u017c wybrane atrybuty filtra.<\/li>\n
    3. Nacisn\u0105\u0107 przycisk [Import danych<\/strong>] na standardowym pasku przycisk\u00f3w.<\/li>\n<\/ol>\n

      \u2192Otworzy si\u0119 okno dialogowe Import danych<\/em>.<\/p>\n

        \n
      1. W oknie dialogowym Import danych<\/em> mo\u017cna wprowadzi\u0107 ustawienia dla importowanego pliku. Opis p\u00f3l mo\u017cna znale\u017a\u0107 w dokumentacji Import danych<\/em>.<\/li>\n
      2. Nacisn\u0105\u0107 przycisk [W tle<\/strong>].<\/li>\n<\/ol>\n

        \u2192Import zostanie wykonany.<\/p>\n

        Tworzenie nowych kontrakt\u00f3w sprzeda\u017cy<\/strong><\/p>\n

        Minimalne wymagane atrybuty dla obiektu podstawowego:<\/p>\n\n\n\n\n\n\n
        Opis atrybutu<\/strong><\/td>\nAtrybut<\/strong><\/td>\n<\/tr>\n
        Organizacja sprzeda\u017cy(w systemach jednostanowiskowych z wy\u0142\u0105czonymi uprawnieniami merytorycznymi jest to automatycznie klient)<\/td>\ninvoicingPartyData.Partner<\/em><\/td>\n<\/tr>\n
        Rodzaj kontraktu sprzeda\u017cy<\/td>\ntype<\/em><\/td>\n<\/tr>\n
        Partner kontraktu<\/td>\ncustomerData.CustomerPartner<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

        Opcjonalnie mo\u017cna r\u00f3wnie\u017c przenie\u015b\u0107 numer za pomoc\u0105 importu. W takim przypadku numer okre\u015blony za pomoc\u0105 schematu numeracji zgodnie z rodzajem jest ignorowany. Ponadto nale\u017cy zastosowa\u0107 odpowiednie konwencje, aby upewni\u0107 si\u0119, \u017ce numer przypisany za pomoc\u0105 importu nie pasuje do numeru, kt\u00f3ry zosta\u0142 ju\u017c przypisany lub ma zosta\u0107 przypisany automatycznie w przysz\u0142o\u015bci.<\/p>\n

        W razie potrzeby mo\u017cna r\u00f3wnie\u017c okre\u015bli\u0107 list\u0119 dozwolonych organizacji w kluczu OrganizationAssignments<\/em>:<\/p>\n

        Organizacja wywo\u0142uj\u0105ce kontrakt sprzeda\u017cy: OrganisationalUnit<\/em><\/p>\n

        Wskaz\u00f3wka<\/div>
        Organizacja sprzeda\u017cy jest proponowana podczas tworzenia kontraktu.<\/div><\/section>\n

        W razie potrzeby w kluczach OrdererAssignments, DeliveryCustomerAssignments <\/em>i InvoiceCustomerAssignments<\/em> mo\u017cna r\u00f3wnie\u017c okre\u015bli\u0107 list\u0119 klient\u00f3w dozwolonych dla danego partnera:<\/p>\n

        Klient kontraktu sprzeda\u017cy: Partner<\/em><\/p>\n

        Wskaz\u00f3wka<\/div>
        Podczas tworzenia partner kontraktu jest proponowany jako zamawiaj\u0105cy. W zale\u017cno\u015bci od ustawie\u0144 w rodzaju, preferowany odbiorca dostawy lub preferowany odbiorca faktury mo\u017ce zosta\u0107 zaproponowany w odpowiedniej tabeli.<\/div><\/section>\n

        Minimalne wymagane atrybuty na obiekt pozycji:<\/p>\n\n\n\n\n\n\n\n\n\n\n
        Opis atrybutu<\/strong><\/td>\nAtrybut<\/strong><\/td>\n<\/tr>\n
        Artyku\u0142<\/td>\nItem<\/em><\/td>\n<\/tr>\n
        Wymagane dla tych typ\u00f3w kontrakt\u00f3w sprzeda\u017cy:<\/p>\n
          \n
        • Sta\u0142a ilo\u015b\u0107<\/em><\/li>\n
        • Ilo\u015b\u0107\/termin<\/em><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
        Ca\u0142kowita ilo\u015b\u0107<\/td>\ntotalQuantity<\/em><\/td>\n<\/tr>\n
        Wymagane dla tych typ\u00f3w kontrakt\u00f3w sprzeda\u017cy:<\/p>\n
          \n
        • Sta\u0142a warto\u015b\u0107<\/em><\/li>\n
        • Warto\u015b\u0107\/termin<\/em><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
        Warto\u015b\u0107 ca\u0142kowita<\/td>\nvalues.grossValue.amount<\/em><\/td>\n<\/tr>\n
        Wymagane dla tych typ\u00f3w kontrakt\u00f3w sprzeda\u017cy:<\/p>\n
          \n
        • Sta\u0142y termin<\/em><\/li>\n
        • Ilo\u015b\u0107\/termin<\/em><\/li>\n
        • Warto\u015b\u0107\/termin<\/em><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
        Wa\u017cne do<\/td>\n\u00a0expiryDate<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

        Opcjonalnie mo\u017cna r\u00f3wnie\u017c wprowadzi\u0107 numer (number<\/em>) dla nowej pozycji.<\/p>\n

        Odpowiedni minimalny XML dla kontrakt\u00f3w typu Ilo\u015b\u0107\/termin<\/em>\u00a0z atrybutami funkcjonalnymi i dwoma pozycjami ma na przyk\u0142ad nast\u0119puj\u0105c\u0105 zawarto\u015b\u0107:<\/p>\n

        <?xml version=\"1.0\" encoding=\"UTF-8\"?>.<\/code><\/p>\n

        <semiramis xmlns=\"com.cisag.app.sales.obj.SalesContract\" xsi:schemaLocation=\"com.cisag.app.sales.obj.SalesContract SalesContract.xsd\" created=\"2005-12-28T07:36:29.729Z\" locale=\"en-US-XMLSchemaCompliant\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"><\/code><\/p>\n

        <SalesContract xmlns=\"com.cisag.app.sales.obj.SalesContract\"><\/code><\/p>\n

        <invoicingPartyData><\/code><\/p>\n

        <partner>00000<\/partner><\/code><\/p>\n

        <\/invoicingPartyData><\/code><\/p>\n

        <Type>100<\/Type><\/code><\/p>\n

        <customerData><\/code><\/p>\n

        <CustomerPartner>10020<\/CustomerPartner><\/code><\/p>\n

        <\/customerData><\/code><\/p>\n

        <Details><\/code><\/p>\n

        <Item>4711<\/Item><\/code><\/p>\n

        <totalQuantity><\/code><\/p>\n

        <amount>10<\/amount><\/code><\/p>\n

        <Uom>St.<\/Uom><\/code><\/p>\n

        <\/totalQuantity><\/code><\/p>\n

        <expiryDate>2006-12-30T23:00:01.000Z<\/expiryDate><\/code><\/p>\n

        <\/Details><\/code><\/p>\n

        <Details><\/code><\/p>\n

        <Item>4712<\/Item><\/code><\/p>\n

        <totalQuantity><\/code><\/p>\n

        <amount>20<\/amount><\/code><\/p>\n

        <Uom>St.<\/Uom><\/code><\/p>\n

        <\/totalQuantity><\/code><\/p>\n

        <expiryDate>2006-12-30T23:00:01.000Z<\/expiryDate><\/code><\/p>\n

        <\/Details><\/code><\/p>\n

        <\/SalesContract><\/code><\/p>\n

        <\/semiramis><\/code><\/p>\n

        Analogiczny przyk\u0142ad dla kontrakt\u00f3w typu Warto\u015b\u0107\/termin<\/em>, kt\u00f3ry zawiera r\u00f3wnie\u017c ceny i szczeg\u00f3\u0142y dotycz\u0105ce niedostarczenia i przekroczenia dostawy, ma nast\u0119puj\u0105c\u0105 tre\u015b\u0107:<\/p>\n

        <?xml version=\"1.0\" encoding=\"UTF-8\"?><\/code><\/p>\n

        <semiramis xmlns=\"com.cisag.app.sales.obj.SalesContract\" xsi:schemaLocation=\"com.cisag.app.sales.obj.SalesContract SalesContract.xsd\" created=\"2005-12-28T07:36:29.729Z\" locale=\"en-US-XMLSchemaCompliant\" xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"><\/code><\/p>\n

        <SalesContract xmlns=\"com.cisag.app.sales.obj.SalesContract\"><\/code><\/p>\n

        <invoicingPartyData><\/code><\/p>\n

        <partner>00000<\/partner><\/code><\/p>\n

        <\/invoicingPartyData><\/code><\/p>\n

        <Type>200<\/Type><\/code><\/p>\n

        <customerData><\/code><\/p>\n

        <CustomerPartner>10020<\/CustomerPartner><\/code><\/p>\n

        <\/customerData><\/code><\/p>\n

        <Details><\/code><\/p>\n

        <Item>4711<\/Item><\/code><\/p>\n

        <values><\/code><\/p>\n

        <grossValue><\/code><\/p>\n

        <amount>10000.000000<\/amount><\/code><\/p>\n

        <Currency>EUR<\/Currency><\/code><\/p>\n

        <grossValue><\/code><\/p>\n

        <\/values><\/code><\/p>\n

        <grossPrice><\/code><\/p>\n

        <amount>10.000000<\/amount><\/code><\/p>\n

        <Currency>EUR<\/Currency><\/code><\/p>\n

        <\/grossPrice><\/code><\/p>\n

        <expiryDate>2006-12-30T23:00:01.000Z<\/expiryDate><\/code><\/p>\n

        <underDeliveryLimit>1.0000<\/underDeliveryLimit><\/code><\/p>\n

        <overDeliveryLimit>2.0000<\/overDeliveryLimit><\/code><\/p>\n

        <\/Details><\/code><\/p>\n

        <Szczeg\u00f3\u0142y><\/code><\/p>\n

        <Item>4712<\/Item><\/code><\/p>\n

        <values><\/code><\/p>\n

        <grossValue><\/code><\/p>\n

        <amount>20000.000000<\/amount><\/code><\/p>\n

        <Currency>EUR<\/Currency><\/code><\/p>\n

        <grossValue><\/code><\/p>\n

        <\/values><\/code><\/p>\n

        <grossPrice><\/code><\/p>\n

        <amount>20.000000<\/amount><\/code><\/p>\n

        <Currency>EUR<\/Currency><\/code><\/p>\n

        <\/grossPrice><\/code><\/p>\n

        <expiryDate>2006-12-30T23:00:01.000Z<\/expiryDate><\/code><\/p>\n

        <underDeliveryLimit>3.0000<\/underDeliveryLimit><\/code><\/p>\n

        <overDeliveryLimit>4.0000<\/overDeliveryLimit><\/code><\/p>\n

        <\/Details><\/code><\/p>\n

        <\/SalesContract><\/code><\/p>\n

        <\/semiramis><\/code><\/p>\n

        W przypadku typ\u00f3w Sta\u0142a ilo\u015b\u0107<\/em> i Sta\u0142a warto\u015b\u0107<\/em> warto\u015b\u0107 expiryDate<\/em> jest ignorowana.<\/p>\n

        Pozosta\u0142e wymagane atrybuty s\u0105 dodawane w tych przyk\u0142adach przy u\u017cyciu warto\u015bci domy\u015blnych zgodnie z danymi podstawowymi.<\/p>\n

        Mo\u017cna r\u00f3wnie\u017c zaimportowa\u0107 dodatkowe warto\u015bci i u\u017cy\u0107 atrybut\u00f3w technicznych zamiast atrybut\u00f3w funkcjonalnych. List\u0119 atrybut\u00f3w mo\u017cna znale\u017a\u0107 w rozdziale Przegl\u0105d: Atrybuty<\/em><\/a>.<\/p>\n

        Funkcje specjalne podczas edycji kontraktu<\/strong><\/p>\n

        Podczas edycji istniej\u0105cego kontraktu nale\u017cy zwr\u00f3ci\u0107 uwag\u0119 na nast\u0119puj\u0105ce kwestie: Podczas importowania kontrakt\u00f3w sprzeda\u017cy w systemach wielostanowiskowych i systemach jednostanowiskowych z aktywowanymi uprawnieniami do tre\u015bci wymagana jest organizacja sprzeda\u017cy. Podczas edycji istniej\u0105cego kontraktu organizacja sprzeda\u017cy jest zawsze pobierana z dokumentu przechowywanego w bazie danych. Ka\u017cda inna organizacja sprzeda\u017cy w \u017ar\u00f3dle importu jest w tym przypadku ignorowana.<\/p>\n

        Aby znale\u017a\u0107 kontrakt sprzeda\u017cy przechowywany w bazie danych, wymagana jest jego identyfikacja techniczna (SalesContract:guid<\/em>) lub identyfikacja funkcjonalna (Type<\/em> [lub type<\/em>] i number<\/em>).<\/p>\n

        W przypadku organizacji wywo\u0142uj\u0105cych i klient\u00f3w wywo\u0142uj\u0105cych mo\u017cna u\u017cy\u0107 wszystkich opcji importu – w szczeg\u00f3lno\u015bci usuwania. R\u00f3wnie\u017c w tym przypadku do znalezienia zapisanego partnera wymagana jest tylko identyfikacja techniczna (identyfikacja partnera).<\/p>\n

        W przypadku pozycji mo\u017cna u\u017cy\u0107 wszystkich opcji importu, w szczeg\u00f3lno\u015bci usuwania. R\u00f3wnie\u017c w tym przypadku do znalezienia zapisanej pozycji wymagana jest identyfikacja techniczna (Sales\u00acContractDetail:guid<\/em>) lub identyfikacja funkcjonalna (number<\/em>).<\/p>\n

        Zmiany za pomoc\u0105 importu s\u0105 mo\u017cliwe tylko wtedy, gdy \u017cadna kontrola tego nie uniemo\u017cliwia.<\/p>\n

        Automatyczne zwolnienie po imporcie<\/strong><\/p>\n

        Je\u015bli import zosta\u0142 przeprowadzony pomy\u015blnie, edytowany kontrakt sprzeda\u017cy mo\u017ce zosta\u0107 zwolniony automatycznie po zaimportowaniu. Opcja ta jest szczeg\u00f3lnie przydatna w po\u0142\u0105czeniu ze statusem otwarcia W trakcie realizacji<\/em> . Zapobiega to wykorzystaniu w kolejnych dokumentach kontraktu sprzeda\u017cy, kt\u00f3ra nie zosta\u0142a jeszcze w pe\u0142ni zaimportowana. Podczas wydania kontrakt sprzeda\u017cy ma status Nieprawid\u0142owy<\/em>, wi\u0119c nie mo\u017cna go u\u017cy\u0107 r\u00f3wnie\u017c w tym kroku.<\/p>\n

        Aby uzyska\u0107 t\u0119 funkcjonalno\u015b\u0107, nale\u017cy ustawi\u0107 wirtualny atrybut bazowy autoRelease<\/em> na warto\u015b\u0107 true<\/em> dla odpowiedniej instancji.<\/p>\n

        Je\u015bli ta w\u0142a\u015bciwo\u015b\u0107 jest aktywna i nie ma innych b\u0142\u0119d\u00f3w, w dzienniku komunikat\u00f3w wy\u015bwietlany jest dodatkowy komunikat informacyjny informuj\u0105cy, \u017ce kontrakt sprzeda\u017cy zosta\u0142 automatycznie zwolniony. Je\u015bli nie by\u0142o to mo\u017cliwe, wy\u015bwietlane jest ostrze\u017cenie.<\/p>\n

        Wskaz\u00f3wki dotycz\u0105ce transferu starszych danych<\/strong><\/p>\n

        Je\u015bli import ma zosta\u0107 u\u017cyty do przeniesienia starszych danych, pomocne s\u0105 poni\u017csze wskaz\u00f3wki:<\/p>\n

        Nale\u017cy upewni\u0107 si\u0119, \u017ce wszystkie dane podstawowe zosta\u0142y poprawnie przeniesione. Pozwoli to unikn\u0105\u0107 niepotrzebnego przetwarzania b\u0142\u0119d\u00f3w dla um\u00f3w.<\/p>\n

        Przegl\u0105d: Atrybuty<\/em><\/strong><\/p>\n

        Atrybuty poszczeg\u00f3lnych obiekt\u00f3w biznesowych, kt\u00f3re s\u0105 dost\u0119pne do importu, s\u0105 wymienione poni\u017cej. Odpowiednia nazwa relacji jest r\u00f3wnie\u017c uwzgl\u0119dniona dla atrybut\u00f3w klucza obcego. Atrybuty mog\u0105 podlega\u0107 zmianom i mo\u017cna je rozszerzy\u0107 poprzez konfiguracj\u0119.<\/p>\n

        W przypadku niekt\u00f3rych obiekt\u00f3w biznesowych wymagana jest organizacja do konwersji kluczy funkcjonalnych na klucze techniczne. Na listach atrybut\u00f3w jest to oznaczone nast\u0119puj\u0105cymi uwagami w kolumnie Atrybut<\/em>.<\/p>\n