{"id":30357,"date":"2025-05-14T14:14:41","date_gmt":"2025-05-14T12:14:41","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/?post_type=ht_kb&p=30357"},"modified":"2025-05-14T14:17:24","modified_gmt":"2025-05-14T12:17:24","slug":"import-umow-premiowych-sprzedazy","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/import-umow-premiowych-sprzedazy\/","title":{"rendered":"Import um\u00f3w premiowych sprzeda\u017cy"},"content":{"rendered":"\n

W artykule opisano instrukcje zwi\u0105zane z aplikacj\u0105 Import danych<\/em> w kontek\u015bcie um\u00f3w premiowych sprzeda\u017cy. Instrukcje zawieraj\u0105 og\u00f3lne kroki, a tak\u017ce informacje o mo\u017cliwych warunkach wst\u0119pnych i skutkach.<\/p>\n\n\n\n

Opis aplikacji Import danych<\/em>, zawieraj\u0105cy mi\u0119dzy innymi opisy p\u00f3l i przycisk\u00f3w, znajduje si\u0119 w dokumentacji Import danych<\/em>.<\/p>\n\n\n\n

Definicje poj\u0119\u0107<\/h3>\n\n\n\n

Rodzaje premii<\/strong>
Premia lojalno\u015bciowa, kt\u00f3ra zazwyczaj jest przyznawana klientowi po fakcie, w formie dokumentu kredytowego. Mo\u017ce by\u0107 przyznana jako podzi\u0119kowanie za d\u0142ugoletni\u0105 wsp\u00f3\u0142prac\u0119 (rodzaj premii: kwota sta\u0142a) lub za osi\u0105gni\u0119cie okre\u015blonej warto\u015bci sprzeda\u017cy (rodzaj premii: premia obrotowa, premia za wzrost).<\/p>\n\n\n\n

Premia obrotowa<\/strong>
Premia jest wyp\u0142acana po osi\u0105gni\u0119ciu okre\u015blonych, uzgodnionych poziom\u00f3w obrot\u00f3w. Poziomy obrot\u00f3w, od kt\u00f3rych przyznawana jest premia, mog\u0105 by\u0107 definiowane stopniowo. Premia obrotowa zale\u017cy od osi\u0105gni\u0119tych poziom\u00f3w premii. Po osi\u0105gni\u0119ciu okre\u015blonego poziomu, wyp\u0142acana jest procentowa premia od obrotu.<\/p>\n\n\n\n

Premia za wzrost<\/strong>
Premia jest wyp\u0142acana po osi\u0105gni\u0119ciu okre\u015blonych, uzgodnionych poziom\u00f3w obrot\u00f3w. Poziomy obrot\u00f3w, od kt\u00f3rych przyznawana jest premia, mog\u0105 by\u0107 definiowane stopniowo. Premia za wzrost zale\u017cy od procentowego przekroczenia osi\u0105gni\u0119tego obrotu. Wysoko\u015b\u0107 premii zale\u017cy od osi\u0105gni\u0119tego obrotu i uzgodnionych procent\u00f3w.<\/p>\n\n\n\n

Poziomy premiowe<\/strong>
Poziomy premiowe s\u0142u\u017c\u0105 do ustalania okre\u015blonych, wcze\u015bniej uzgodnionych cel\u00f3w sprzeda\u017cowych w zdefiniowanym okresie czasu. Po przekroczeniu poziom\u00f3w premiowych wyp\u0142acana jest procentowa premia od osi\u0105gni\u0119tego obrotu.<\/p>\n\n\n\n

Informacje og\u00f3lne<\/h3>\n\n\n\n

Poni\u017cej znajduj\u0105 si\u0119 og\u00f3lne informacje dotycz\u0105ce um\u00f3w premiowych sprzeda\u017cy oraz struktury importowanych obiekt\u00f3w danych.<\/p>\n\n\n\n

Umowy premiowe sprzeda\u017cy mog\u0105 sk\u0142ada\u0107 si\u0119 z nast\u0119puj\u0105cych element\u00f3w:<\/p>\n\n\n\n

    \n
  • Dane podstawowe<\/li>\n\n\n\n
  • Poziomy premiowe<\/li>\n\n\n\n
  • W\u0142\u0105czenia i wy\u0142\u0105czenia klasyfikacji premii artyku\u0142u<\/li>\n\n\n\n
  • Organizacje sprzeda\u017cy podlegaj\u0105ce rozliczeniom premii<\/li>\n<\/ul>\n\n\n\n

    Trzy ostatnie komponenty s\u0105 cz\u0119\u015bci\u0105 umowy premiowej sprzeda\u017cy i nie mog\u0105 by\u0107 importowane oddzielnie, lecz jedynie w ramach przypisania do jednoznacznie zidentyfikowanej umowy premiowej sprzeda\u017cy.<\/p>\n\n\n\n

    Import p\u0142atno\u015bci premiowych oraz tekst\u00f3w nie jest obs\u0142ugiwany.<\/p>\n\n\n\n

    Instrukcje<\/h3>\n\n\n\n

    Poni\u017cej opisano procedury dotycz\u0105ce importu um\u00f3w premiowych sprzeda\u017cy:<\/p>\n\n\n\n

      \n
    • Import danych<\/li>\n\n\n\n
    • Wymagane atrybuty dla importu<\/li>\n\n\n\n
    • Import nowej umowy premiowej sprzeda\u017cy<\/li>\n\n\n\n
    • Import poziom\u00f3w premiowych do istniej\u0105cej umowy premiowej sprzeda\u017cy<\/li>\n<\/ul>\n\n\n\n

      Import danych<\/h3>\n\n\n\n

      Aby zaimportowa\u0107 umowy premiowe sprzeda\u017cy, nale\u017cy:<\/p>\n\n\n\n

        \n
      1. Otworzy\u0107 aplikacj\u0119 Import danych<\/em>.<\/li>\n\n\n\n
      2. Wy\u015bwietli\u0107 filtr dla obiektu biznesowego com.cisag.app.sales.obj.BonusAgreement<\/em>.
        \u2192Wy\u015bwietlony zostanie filtr dla importu danych.<\/li>\n\n\n\n
      3. Wybrane atrybuty filtra s\u0105 ju\u017c zaznaczone. W razie potrzeby mo\u017cna dostosowa\u0107 atrybuty.<\/li>\n\n\n\n
      4. Nacisn\u0105\u0107 przycisk [Import danych<\/strong>] na standardowym pasku przycisk\u00f3w.
        \u2192Otworzy si\u0119 okno dialogowe Import danych<\/em>.<\/li>\n\n\n\n
      5. W oknie dialogowym mo\u017cna skonfigurowa\u0107 ustawienia dla pliku importu. Szczeg\u00f3\u0142owy opis p\u00f3l znajduje si\u0119 w dokumentacji Import danych<\/em> w odpowiednim rozdziale.<\/li>\n\n\n\n
      6. Nacisn\u0105\u0107 przycisk [W tle<\/strong>], aby rozpocz\u0105\u0107 import.<\/li>\n<\/ol>\n\n\n\n

        Wymagane atrybuty dla importu<\/h4>\n\n\n\n

        Nale\u017cy poda\u0107 co najmniej nast\u0119puj\u0105ce atrybuty dla ka\u017cdego obiektu biznesowego:<\/p>\n\n\n\n

          \n
        • Atrybuty identyfikacyjne (Business Key)<\/li>\n\n\n\n
        • Pola obowi\u0105zkowe<\/li>\n<\/ul>\n\n\n\n

          Bez atrybut\u00f3w identyfikacyjnych obiekt biznesowy nie mo\u017ce zosta\u0107 przypisany. Je\u015bli brakuje pola obowi\u0105zkowego, proces importu zostanie przerwany i uruchomiona zostanie procedura uzupe\u0142niania brakuj\u0105cych danych.<\/p>\n\n\n\n

          Pola obowi\u0105zkowe i atrybuty identyfikacyjne dla poszczeg\u00f3lnych obiekt\u00f3w biznesowych s\u0105 zestawione w rozdziale Przegl\u0105d: Atrybuty identyfikacyjne i obowi\u0105zkow<\/em>e.<\/p>\n\n\n\n

          Dodatkowo istniej\u0105 powi\u0105zania z innymi obiektami biznesowymi, kt\u00f3re nie nale\u017c\u0105 bezpo\u015brednio do obiektu biznesowego Umowa premiowa sprzeda\u017cy<\/em> (powi\u0105zania poprzez klucz obcy, oznaczone kursyw\u0105 w filtrze). Aby te powi\u0105zania mog\u0142y zosta\u0107 rozwi\u0105zane, nale\u017cy zaznaczy\u0107 atrybuty identyfikacyjne tych obiekt\u00f3w biznesowych w filtrze.<\/p>\n\n\n\n

          Import nowej umowy premiowej sprzeda\u017cy<\/h3>\n\n\n\n

          W pliku importu musz\u0105 zosta\u0107 podane wszystkie atrybuty identyfikacyjne i obowi\u0105zkowe danych podstawowych. W formacie CSV pozosta\u0142e dane mog\u0105 by\u0107 importowane tylko w kilku plikach, poniewa\u017c nale\u017cy uwzgl\u0119dni\u0107 kilka relacji 1:n (poziomy premiowe, organizacje sprzeda\u017cy do uwzgl\u0119dnienia).<\/p>\n\n\n\n

          Aby dowiedzie\u0107 si\u0119, jak powi\u0105za\u0107 oddzielne pliki importu, nale\u017cy zapozna\u0107 si\u0119 z dokumentacj\u0105 aplikacji Import danych<\/em>.<\/p>\n\n\n\n

          Przyk\u0142ad importu nowych um\u00f3w premiowych sprzeda\u017cy za pomoc\u0105 kilku plik\u00f3w importu:<\/h4>\n\n\n\n

          Dane podstawowe:<\/p>\n\n\n\n

          number<\/th>BonusAgreementType.code<\/th>description<\/th>Currency<\/th>ResponsiblePartner<\/th><\/tr><\/thead>
          100<\/td>UMS<\/td>Premia od sprzeda\u017cy<\/td>EUR<\/td>MUELLER<\/td><\/tr>
          200<\/td>STG<\/td>Premia wzrostowa<\/td>EUR<\/td>MUELLER<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          Poziomy premiowe:<\/p>\n\n\n\n

          number<\/th>BonusAgreementType.code<\/th>BonusAgreementDetails.level<\/th>BonusAgreementDetails.bonusPercent<\/th><\/tr><\/thead>
          100<\/td>UMS<\/td>1<\/td>0,25<\/td><\/tr>
          100<\/td>UMS<\/td>2<\/td>0,75<\/td><\/tr>
          100<\/td>UMS<\/td>3<\/td>1,25<\/td><\/tr>
          200<\/td>STG<\/td>1<\/td>0,5<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          [Indicator]Atrybuty zwi\u0105zane z kluczami obcymi musz\u0105 by\u0107 ju\u017c obecne w systemie przed importem. Je\u015bli w pliku importu zostan\u0105 podane inne atrybuty ni\u017c atrybuty identyfikacyjne, zostan\u0105 one zignorowane.<\/p>\n\n\n\n

          Je\u015bli klucz g\u0142\u00f3wny obiektu biznesowego sk\u0142ada si\u0119 ca\u0142kowicie lub cz\u0119\u015bciowo z kluczy obcych, obiekt biznesowy, do kt\u00f3rego odnosi si\u0119 ten klucz obcy, musi zosta\u0107 okre\u015blony poprzez swoje atrybuty identyfikacyjne.[\/indicator]<\/p>\n\n\n\n

          Przyk\u0142ad<\/div>
          Atrybut paymentCurrency<\/em> w umowie premiowej sprzeda\u017cy odnosi si\u0119 do waluty, w kt\u00f3rej naliczane s\u0105 kwoty premiowe. Ta waluta jest okre\u015blana za pomoc\u0105 identyfikatora (String), kt\u00f3ry jest przypisany poprzez klucz obcy Currency<\/em>.<\/div><\/section>\n\n\n\n

          Import poziom\u00f3w premiowych do istniej\u0105cej umowy premiowej sprzeda\u017cy<\/h4>\n\n\n\n

          [Indicator]Aby skorzysta\u0107 z tej instrukcji importu poziom\u00f3w premiowych do istniej\u0105cej umowy premiowej sprzeda\u017cy, dane podstawowe musz\u0105 zosta\u0107 wcze\u015bniej poprawnie zaimportowane.<\/p>\n\n\n\n

          W pliku importu nale\u017cy poda\u0107 jedynie atrybuty identyfikacyjne (number, BonusAgreementType.code<\/em>) danych podstawowych. Je\u015bli zostan\u0105 podane inne atrybuty danych podstawowych, istniej\u0105ce dane zostan\u0105 nadpisane.<\/p>\n\n\n\n

          [Indicator]Je\u015bli poziom premiowy, kt\u00f3ry ma zosta\u0107 zaimportowany, ju\u017c istnieje (zgodnie z kombinacj\u0105 atrybut\u00f3w number<\/em>, BonusAgreementType, BonusAgreementDetails.level<\/em>), dane zostan\u0105 nadpisane.[\/indicator]<\/p>\n\n\n\n

          Uwaga<\/div>
          Ta metoda importu powinna by\u0107 stosowana wy\u0142\u0105cznie do aktualizacji istniej\u0105cej umowy premiowej sprzeda\u017cy. Oddzielny import um\u00f3w premiowych i poziom\u00f3w premiowych mo\u017ce prowadzi\u0107 do obni\u017cenia wydajno\u015bci systemu.<\/div><\/section>\n\n\n\n

          Przyk\u0142ad pliku importu dla aktualizacji poziom\u00f3w premiowych:<\/p>\n\n\n\n

          number<\/th>BonusAgreementType.code<\/th>BonusAgreementDetails.level<\/th>BonusAgreementDetails.bonusPercent<\/th><\/tr><\/thead>
          100<\/td>UMS<\/td>1<\/td>0,25<\/td><\/tr>
          100<\/td>UMS<\/td>2<\/td>0,75<\/td><\/tr>
          100<\/td>UMS<\/td>3<\/td>1,25<\/td><\/tr>
          200<\/td>STG<\/td>1<\/td>0,5<\/td><\/tr>
          200<\/td>STG<\/td>2<\/td>1<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          Organizacje sprzeda\u017cy do uwzgl\u0119dnienia:<\/p>\n\n\n\n

          number<\/th>BonusAgreementType.code<\/th>BonusAgreementOrganizationAssignments.InvoicingPartyPartner<\/th><\/tr><\/thead>
          100<\/td>UMS<\/td>IT01<\/td><\/tr>
          200<\/td>STG<\/td>SA01<\/td><\/tr>
          200<\/td>STG<\/td>SA02<\/td><\/tr>
          200<\/td>STG<\/td>SA03<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          Przegl\u0105d: Atrybuty identyfikacyjne i obowi\u0105zkowe<\/h3>\n\n\n\n

          W tym rozdziale zebrano atrybuty identyfikacyjne i obowi\u0105zkowe dla importu um\u00f3w premiowych sprzeda\u017cy.<\/p>\n\n\n\n

          Podczas importu w formacie CSV dla wszystkich atrybut\u00f3w kwotowych (ForeignAmount) nale\u017cy poda\u0107 co najmniej atrybut amount<\/em>. W razie potrzeby mo\u017cna u\u017cy\u0107 cyfry 0<\/em>.<\/p>\n\n\n\n

          Dane podstawowe<\/h4>\n\n\n\n
          Atrybut<\/th>Opis<\/th>Relacja klucza obcego<\/th><\/tr><\/thead>
          number (K)<\/td>Identyfikacja<\/td>–<\/td><\/tr>
          type (K)<\/td>Rodzaj<\/td>BonusAgreementType<\/td><\/tr>
          description<\/td>Opis<\/td>–<\/td><\/tr>
          responsible<\/td>Odpowiedzialny pracownik<\/td>ResponsiblePartner<\/td><\/tr>
          customer<\/td>Klient, alternatywnie do klasyfikacji klienta<\/td>CustomerPartner<\/td><\/tr>
          customerType<\/td>Zastosowanie partnera<\/td>–<\/td><\/tr>
          customerClassification<\/td>Klasyfikacja premiowa klienta, alternatywnie do klienta<\/td>CustomerBonusClassification<\/td><\/tr>
          currency<\/td>Waluta<\/td>Currency<\/td><\/tr>
          payee<\/td>Partner rozliczeniowy<\/td>PayeePartner<\/td><\/tr>
          maintainingOrganization<\/td>Organizacja sprzeda\u017cy<\/td>MaintainingOrganization<\/td><\/tr>
          agreementBeginn<\/td>Okres rozliczeniowy (od)<\/td>–<\/td><\/tr>
          agreementEnd<\/td>Okres rozliczeniowy (do)<\/td>–<\/td><\/tr>
          paymentDueDate<\/td>Termin p\u0142atno\u015bci<\/td>–<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          Poziomy premiowe<\/h4>\n\n\n\n\n\n

          <\/h4>\n\n\n\n
          Atrybut<\/th>Opis<\/th>Relacja klucza obcego<\/th><\/tr><\/thead>
          BonusAgreementDetails.level (K)<\/td>Poziom<\/td>–<\/td><\/tr>
          BonusAgreementDetails.salesTarget<\/td>Obr\u00f3t<\/td>–<\/td><\/tr>
          BonusAgreementDetails.salesIncreasePercent<\/td>Wzrost<\/td>–<\/td><\/tr>
          BonusAgreementDetails.bonusPercent<\/td>Procent premii<\/td>–<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          W\u0142\u0105czenia i wy\u0142\u0105czenia klasyfikacji premiowej artyku\u0142\u00f3w<\/h4>\n\n\n\n
          Atrybut<\/th>Opis<\/th>Relacja klucza obcego<\/th><\/tr><\/thead>
          BonusAgreementExclusions.itemHierarchy (K)<\/td>W\u0142\u0105czona lub wy\u0142\u0105czona klasyfikacja premiowa artyku\u0142\u00f3w<\/td>ItemBonusHierarchy<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          Uwzgl\u0119dniane organizacje sprzeda\u017cy<\/h4>\n\n\n\n
          Atrybut<\/th>Opis<\/th>Relacja klucza obcego<\/th><\/tr><\/thead>
          BonusAgreementOrganizationAssignments.invoicingParty (K)<\/td>Uwzgl\u0119dniana organizacja sprzeda\u017cy<\/td><\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"author":18,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-30357","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-premia-sprzedazy"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/30357","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/comments?post=30357"}],"version-history":[{"count":6,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/30357\/revisions"}],"predecessor-version":[{"id":30430,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/30357\/revisions\/30430"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/media?parent=30357"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}