{"id":13323,"date":"2024-05-06T09:59:38","date_gmt":"2024-05-06T07:59:38","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/?post_type=ht_kb&p=13323"},"modified":"2024-05-06T10:11:05","modified_gmt":"2024-05-06T08:11:05","slug":"import-dokumentow-szybkiej-rejestracji-sprzedazy","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/import-dokumentow-szybkiej-rejestracji-sprzedazy\/","title":{"rendered":"Import dokument\u00f3w szybkiej rejestracji sprzeda\u017cy"},"content":{"rendered":"

Niniejszy dokument opisuje korzystanie z aplikacji Import danych<\/em> w kontek\u015bcie danych dotycz\u0105cych dokument\u00f3w szybkiej rejestracji sprzeda\u017cy.<\/p>\n

Dokument opisuje warunki wst\u0119pne, instrukcje importu, zawiera informacje o tym, na co nale\u017cy zwr\u00f3ci\u0107 uwag\u0119 oraz informuje o mo\u017cliwych efektach importu.<\/p>\n

Informacje og\u00f3lne<\/h3>\n

Import dokumentu szybkiej rejestracji sprzeda\u017cy zasadniczo opiera si\u0119 na aktualnym modelu danych, kt\u00f3ry jest przechowywany w bazie danych repozytorium.<\/span><\/span> W przypadku eksportu danych dost\u0119pnych jest wi\u0119cej atrybut\u00f3w, ni\u017c w przypadku importu danych.<\/span><\/span> Dlatego sensowne jest ustawienie oddzielnych filtr\u00f3w dla eksportu i importu. <\/span><\/span>Relacje 1:1 s\u0105 zwykle oparte na technicznym atrybucie GUID w modelu danych.<\/span><\/span> W zale\u017cno\u015bci od aplikacji podczas importu mo\u017cna u\u017cy\u0107 technicznego atrybutu GUID lub klucza technicznego z obiektu docelowego (zwykle kod lub numer).<\/span><\/span> W przypadku niekt\u00f3rych obiekt\u00f3w biznesowych organizacja jest odpowiedzialna za konwersj\u0119 kluczy biznesowych na klucze techniczne <\/span><\/span>(organizacja) konieczna.<\/span><\/span> Odpowiednia organizacja zwykle nie znajduje si\u0119 bezpo\u015brednio w \u017ar\u00f3dle importu, ale jest okre\u015blana poprzez kontekst dokumentu.<\/span><\/span> Wi\u0119cej informacji mo\u017cna znale\u017a\u0107 w rozdziale Przegl\u0105d atrybut\u00f3w<\/em>.<\/a><\/span><\/span> Obiekty biznesowe z kodem skr\u00f3tu s\u0105 przywo\u0142ywane na podstawie dokumentu szybkiej rejestracji sprzeda\u017cy.<\/span><\/span> S\u0105 to technicznie powi\u0105zane grupy atrybut\u00f3w, kt\u00f3re s\u0105 zawsze takie same dla wielu dokument\u00f3w i dzi\u0119ki temu pozwalaj\u0105 zaoszcz\u0119dzi\u0107 miejsce w bazie danych i pami\u0119ci g\u0142\u00f3wnej poprzez ich ponowne wykorzystanie.<\/span><\/span> Dzi\u0119ki specjalnej konwersji obiekty biznesowe z kodem skr\u00f3tu s\u0105 wy\u015bwietlane jak cz\u0119\u015bci do eksportu lub importu. Niekt\u00f3re dane z dokument\u00f3w szybkiej rejestracji sprzeda\u017cy, takie jak pola stanu <\/span><\/span>i wewn\u0119trzne atrybuty pomocnicze nie mog\u0105 by\u0107 importowane. <\/span><\/span>Je\u015bli nie ma pewno\u015bci, jaki format pliku importu jest odpowiedni, nale\u017cy post\u0105pi\u0107 w nast\u0119puj\u0105cy spos\u00f3b: <\/span><\/span><\/p>\n

Wprowadzi\u0107 przyk\u0142adowy dokument za pomoc\u0105 aplikacji Dokumenty szybkiej rejestracji sprzeda\u017cy<\/em><\/a><\/span><\/span> i wyeksportowa\u0107 go za pomoc\u0105 filtra importu w \u017c\u0105danym formacie i z \u017c\u0105danymi atrybutami. Wyj\u015bciowy<\/span><\/span>\u00a0plik przyk\u0142adowy mo\u017ce zosta\u0107 u\u017cyty jako szablon dla tworzonych plik\u00f3w importowych.<\/span><\/span> Przy imporcie obowi\u0105zuj\u0105 te same zasady, co przy edycji za po\u015brednictwem aplikacji.<\/span><\/span> Na przyk\u0142ad: artyku\u0142 nie mo\u017ce znajdowa\u0107 si\u0119 w zapisanej pozycji<\/span><\/span>.<\/span><\/span> Warto\u015bci atrybut\u00f3w s\u0105 ignorowane, je\u015bli nie mo\u017cna ich przyj\u0105\u0107 w bie\u017c\u0105cym kontek\u015bcie.<\/span><\/span> T\u0119 sam\u0105 logik\u0119 stosuje si\u0119 r\u00f3wnie\u017c przy ustalaniu sugerowanej warto\u015bci, dzi\u0119ki czemu import i aplikacja zachowuj\u0105 si\u0119 identycznie.<\/span><\/span><\/p>\n

Wskaz\u00f3wka<\/div>
<\/span><\/span>Istniej\u0105ce dokumenty szybkiej rejestracji sprzeda\u017cy mo\u017cna rozbudowa\u0107 poprzez import dodatkowych danych.<\/span><\/span> Je\u015bli to mo\u017cliwe, istniej\u0105ce dane zostan\u0105 zast\u0105pione danymi importowymi.<\/div><\/section><\/span><\/span><\/p>\n

Instrukcja importu dokument\u00f3w szybkiej rejestracji sprzeda\u017cy<\/h3>\n

Aby zaimportowa\u0107 dokumenty szybkiej rejestracji sprzeda\u017cy, nale\u017cy:<\/span><\/span><\/p>\n

1. Otworzy\u0107 aplikacj\u0119 Importuj dane<\/em>. <\/span><\/span><\/p>\n

2. Wy\u015bwietli\u0107 filtr lub filtr dla tego obiektu biznesowego: <\/span><\/span>com.cisag.app.sales.obj.SalesRapidDocument<\/em> <\/span><\/span><\/p>\n

\u2192 Otworzy si\u0119 filtr umo\u017cliwiaj\u0105cy import dokument\u00f3w szybkiej rejestracji sprzeda\u017cy. <\/span><\/span><\/p>\n

\u00a0Je\u015bli to konieczne, nale\u017cy zduplikowa\u0107 filtr. <\/span><\/span>W razie potrzeby mo\u017cna zmieni\u0107 wybrane ju\u017c atrybuty filtra. <\/span><\/span><\/p>\n

3. Na standardowym pasku przycisk\u00f3w nale\u017cy wybra\u0107 przycisk [Importuj dane<\/strong>]. <\/span><\/span><\/p>\n

\u2192 Otworzy si\u0119 okno dialogowe Import danych<\/em>. <\/span><\/span><\/p>\n

4. W oknie dialogowym Import danych<\/em> mo\u017cna dokona\u0107 ustawie\u0144 pliku importu.<\/span><\/span> Opis p\u00f3l znajduje si\u0119 w artykule Import danych<\/em>. <\/span><\/span><\/p>\n

5. Po dokonaniu niezb\u0119dnych zmian nale\u017cy wybra\u0107 przycisk [W tle<\/strong>].<\/span><\/span>\u00a0<\/span><\/span><\/p>\n

\u2192 Import zostanie wykonany.<\/span><\/span><\/p>\n

<\/a>Przegl\u0105d atrybut\u00f3w<\/h3>\n

Poni\u017cej wymieniono atrybuty poszczeg\u00f3lnych obiekt\u00f3w biznesowych, kt\u00f3re mo\u017cna zaimportowa\u0107.<\/span><\/span> W przypadku atrybut\u00f3w klucza obcego uwzgl\u0119dniana jest r\u00f3wnie\u017c odpowiednia nazwa relacji.<\/span><\/span> Pola identyfikacyjne i obowi\u0105zkowe mog\u0105 ulec zmianie i mo\u017cna je rozszerzy\u0107 poprzez konfiguracj\u0119.<\/span><\/span> Atrybuty identyfikacyjne (atrybuty kluczowe) s\u0105 oznaczone liter\u0105 (K).<\/span><\/span><\/p>\n

Dane podstawowe<\/h4>\n

Dokumenty szybkiej rejestracji sprzeda\u017cy (SalesRapidDocument)<\/h5>\n

Identyfikacja dokumentu szybkiej rejestracji sprzeda\u017cy sk\u0142ada si\u0119 z rodzaju dokumentu szybkiej rejestracji sprzeda\u017cy oraz numeru utworzonego za pomoc\u0105 schematu numeracji przypisanego do danego rodzaju dokumentu.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Atrybut<\/strong><\/td>\nRelacja<\/strong><\/td>\nWyja\u015bnienie<\/strong><\/td>\n<\/tr>\n
afterTransfer<\/td>\n<\/td>\nPo przej\u0119ciu<\/td>\n<\/tr>\n
autoConfirmWarnings<\/td>\n<\/td>\nAutomatyczne zatwierdzanie ostrze\u017ce\u0144<\/td>\n<\/tr>\n
customerData<\/td>\n<\/td>\nInformacje w rozdziale Dane klienta<\/em><\/a> (customerData, deliveryCustomerData, invoiceCustomerData)<\/td>\n<\/tr>\n
customerOrderData.purchaseOrder<\/td>\n<\/td>\nNumer dokumentu zewn\u0119trznego<\/td>\n<\/tr>\n
customerOrderData.date.value<\/td>\n<\/td>\nData dokumentu zewn\u0119trznego<\/td>\n<\/tr>\n
CustomerProposal.Type.code<\/td>\n<\/td>\nRodzaj oferty sprzeda\u017cy<\/p>\n

Wskaz\u00f3wka<\/div>
Je\u015bli importowane s\u0105 dokumenty szybkiej rejestracji sprzeda\u017cy z dokumentem docelowym o typie Oferta sprzeda\u017cy<\/em>, nale\u017cy uwzgl\u0119dni\u0107 tak\u017ce rodzaj oferty, kt\u00f3ry b\u0119dzie u\u017cyty w tym atrybucie.<\/div><\/section><\/td>\n<\/tr>\n
date<\/td>\n<\/td>\nData wpisu<\/td>\n<\/tr>\n
deliveryCustomerData<\/td>\n<\/td>\nInformacje w rozdziale Dane klienta<\/em><\/a> (customerData, deliveryCustomerData, invoiceCustomerData)<\/td>\n<\/tr>\n
deliveryData<\/td>\n<\/td>\nInformacje w rozdziale Dane dostawy<\/em><\/a> (deliveryData)<\/td>\n<\/tr>\n
discountOriginType<\/td>\n<\/td>\nPochodzenie rabatu<\/p>\n

Wskaz\u00f3wka<\/div>
Dane dotycz\u0105ce cen mo\u017cna importowa\u0107 tylko dla dokument\u00f3w, dla kt\u00f3rych aktywny jest parametr Zastosuj cen<\/em>y, zale\u017cny od rodzaju dokumentu.<\/p>\n
\n
\n
\n
W przypadku istniej\u0105cych dokument\u00f3w szybkiej rejestracji sprzeda\u017cy z pozycjami dokument\u00f3w, ten atrybut mo\u017cna zmieni\u0107 poprzez import tylko wtedy, gdy ceny zostan\u0105 ustalone z op\u00f3\u017anieniem w zale\u017cno\u015bci od rodzaju dokumentu.<\/div><\/section><\/span><\/span><\/span><\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/td>\n<\/tr>\n
discounts[0..3]<\/p>\n
    \n
  • discounts.discountType<\/li>\n
  • value<\/li>\n
  • code<\/li>\n<\/ul>\n<\/td>\n
DiscountType<\/td>\nRabaty od 1 do 4<\/p>\n
    \n
  • Rodzaj sk\u0142adnika ceny<\/li>\n
  • Ilo\u015b\u0107, cena, procent<\/li>\n
  • Sztuka<\/li>\n<\/ul>\n

    Wskaz\u00f3wka<\/div>
    Dane dotycz\u0105ce cen mo\u017cna importowa\u0107 tylko dla dokument\u00f3w, dla kt\u00f3rych aktywny jest parametr Zastosuj cen<\/em>y, zale\u017cny od rodzaju dokumentu. Aby zaimportowa\u0107 informacje o rabatach nale\u017cy ustawi\u0107 pochodzenie rabatu na warto\u015b\u0107 R\u0119cznie.<\/em><\/p>\n

    W przypadku istniej\u0105cych dokument\u00f3w szybkiej rejestracji sprzeda\u017cy z pozycjami dokument\u00f3w, atrybut ten mo\u017cna zmieni\u0107 poprzez import tylko wtedy, gdy ceny zostan\u0105 ustalone z op\u00f3\u017anieniem w zale\u017cno\u015bci od rodzaju dokumentu.<\/div><\/section><\/td>\n<\/tr>\n

guid (K)<\/td>\n<\/td>\nIdentyfikator techniczny umo\u017cliwiaj\u0105cy zmian\u0119 lub usuni\u0119cie danych, kt\u00f3re zosta\u0142y ju\u017c zapisane, je\u015bli s\u0105 znane.<\/td>\n<\/tr>\n
invoiceCustomerData<\/td>\n<\/td>\nInformacje w rozdziale Dane klienta<\/em><\/a> (customerData, deliveryCustomerData, invoiceCustomerData)<\/td>\n<\/tr>\n
invoicingData<\/td>\n<\/td>\nInformacje w rozdziale Dane faktury<\/em><\/a> (invoicingData)<\/td>\n<\/tr>\n
invoicingPartyData<\/td>\n<\/td>\nInformacje w rozdziale Dane organizacji sprzeda\u017cy<\/em><\/a> (invoicingPartyData)<\/td>\n<\/tr>\n
number (K)<\/td>\n<\/td>\nNumer (identyfikator techniczny).<\/p>\n

Obowi\u0105zkowe, je\u017celi przy wprowadzaniu zmian\/usuwaniu danych nie podano identyfikatora Guid.<\/p>\n

Opcjonalne dla nowych obiekt\u00f3w – w innym razie zostanie ustalony automatycznie.<\/td>\n<\/tr>\n

payee<\/td>\nPayeePartner<\/td>\nP\u0142atnik<\/p>\n

Wskaz\u00f3wka<\/div>
Mo\u017cna wykorzysta\u0107 w przypadku istnienia dokument\u00f3w szybkiej rejestracji sprzeda\u017cy. Atrybut mo\u017cna zmieni\u0107 poprzez import, gdy nie istniej\u0105 \u017cadne pozycje dokumentu.<\/div><\/section><\/td>\n<\/tr>\n
priceDate<\/td>\n<\/td>\nData kalkulacji<\/p>\n

Wskaz\u00f3wka<\/div>
Dane dotycz\u0105ce cen mo\u017cna importowa\u0107 tylko dla dokument\u00f3w, dla kt\u00f3rych aktywny jest parametr Zastosuj cen<\/em>y, zale\u017cny od rodzaju dokumentu.<\/p>\n

W przypadku istniej\u0105cych dokument\u00f3w szybkiej rejestracji sprzeda\u017cy z pozycjami dokument\u00f3w, atrybut ten mo\u017cna zmieni\u0107 poprzez import tylko wtedy, gdy ceny zostan\u0105 ustalone z op\u00f3\u017anieniem w zale\u017cno\u015bci od rodzaju dokumentu.<\/div><\/section><\/td>\n<\/tr>\n

priceListing<\/td>\n<\/td>\nLista cennik\u00f3w<\/p>\n

Wskaz\u00f3wka<\/div>
Dane dotycz\u0105ce cen mo\u017cna importowa\u0107 tylko dla dokument\u00f3w, dla kt\u00f3rych aktywny jest parametr Zastosuj cen<\/em>y, zale\u017cny od rodzaju dokumentu.<\/p>\n

W przypadku istniej\u0105cych dokument\u00f3w szybkiej rejestracji sprzeda\u017cy ten atrybut mo\u017cna zmieni\u0107 poprzez import wy\u0142\u0105cznie, je\u015bli dokument nie ma powi\u0105zanych pozycji.<\/div><\/section><\/td>\n<\/tr>\n

priceValidityDate<\/td>\n<\/td>\nData ustalenia ceny<\/p>\n

Wskaz\u00f3wka<\/div>
Dane dotycz\u0105ce cen mo\u017cna importowa\u0107 tylko dla dokument\u00f3w, dla kt\u00f3rych aktywny jest parametr Zastosuj cen<\/em>y, zale\u017cny od rodzaju dokumentu.<\/p>\n

W przypadku istniej\u0105cych dokument\u00f3w szybkiej rejestracji sprzeda\u017cy z pozycjami dokumentu, ten atrybut mo\u017cna zmieni\u0107 poprzez import tylko wtedy, gdy ceny zostan\u0105 ustalone z op\u00f3\u017anieniem w zale\u017cno\u015bci od rodzaju dokumentu.<\/div><\/section><\/td>\n<\/tr>\n

pricingPartnerRelation<\/td>\n<\/td>\nU\u017cycie partnera<\/p>\n

Wskaz\u00f3wka<\/div>
Dane dotycz\u0105ce cen mo\u017cna importowa\u0107 tylko dla dokument\u00f3w, dla kt\u00f3rych aktywny jest parametr Zastosuj cen<\/em>y, zale\u017cny od rodzaju dokumentu.<\/p>\n

W przypadku istniej\u0105cych dokument\u00f3w szybkiej rejestracji sprzeda\u017cy z pozycjami dokumentu, ten atrybut mo\u017cna zmieni\u0107 poprzez import tylko wtedy, gdy ceny zostan\u0105 ustalone z op\u00f3\u017anieniem w zale\u017cno\u015bci od rodzaju dokumentu.<\/div><\/section><\/td>\n<\/tr>\n

requestDate.value<\/td>\n<\/td>\nPreferowana data<\/td>\n<\/tr>\n
RequestForProposal.Type.code<\/td>\n<\/td>\nRodzaj zapytania ofertowego sprzeda\u017cy<\/p>\n

Wskaz\u00f3wka<\/div>
Je\u015bli importowane s\u0105 dokumenty szybkiej rejestracji sprzeda\u017cy z dokumentem docelowym o typie Zapytanie ofertowe sprzeda\u017cy<\/em>, nale\u017cy uwzgl\u0119dni\u0107 tak\u017ce rodzaj zapytania ofertowego, kt\u00f3ry b\u0119dzie u\u017cyty w tym atrybucie.<\/div><\/section><\/td>\n<\/tr>\n
responsible<\/td>\nResponsiblePartner<\/td>\nOdpowiedzialny pracownik<\/td>\n<\/tr>\n
SalesOrder.Type.code<\/td>\n<\/td>\nRodzaj zam\u00f3wienia sprzeda\u017cy<\/p>\n

Wskaz\u00f3wka<\/div>
Je\u015bli importowane s\u0105 dokumenty szybkiej rejestracji sprzeda\u017cy z dokumentem docelowym o typie Zam\u00f3wienie sprzeda\u017cy<\/em>, nale\u017cy uwzgl\u0119dni\u0107 tak\u017ce rodzaj zam\u00f3wienia, kt\u00f3ry b\u0119dzie u\u017cyty w tym atrybucie.<\/div><\/section><\/td>\n<\/tr>\n
salesRepresentatives[0:2]<\/td>\nSalesRepresentatives<\/td>\nDo trzech przedstawicieli<\/td>\n<\/tr>\n
shippingDate<\/td>\n<\/td>\nData wysy\u0142ki<\/td>\n<\/tr>\n
storageArea.warehouse<\/td>\n<\/td>\nMagazyn<\/p>\n
Wskaz\u00f3wka<\/div>
Magazyny mo\u017cna importowa\u0107 tylko w przypadku dokument\u00f3w, dla kt\u00f3rych aktywny jest parametr Wykorzystanie magazynu\u00a0<\/em>w zale\u017cno\u015bci od rodzaju dokumentu.[\/inidicator]<\/td>\n<\/tr>\n
targetOrderType<\/td>\n<\/td>\nDocelowy rodzaj dokumentu<\/td>\n<\/tr>\n
<\/td>\nTextAssignments<\/td>\nZa\u0142\u0105czniki\/Teksty<\/p>\n

Informacja w rozdziale Teksty<\/em> <\/a>(TextAssignments)<\/td>\n<\/tr>\n

type (K)<\/td>\n<\/td>\nTyp (identyfikator techniczny)<\/p>\n

Obowi\u0105zkowe, je\u017celi przy wprowadzaniu zmian\/usuwaniu nie podano identyfikatora Guid.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/a>Dane klienta (customerData, deliveryCustomerData, invoiceCustomerData)<\/h5>\n

Dane klient\u00f3w w trzech rolach s\u0105 przechowywane w bazie danych jako obiekt biznesowy HashCode i \u200b\u200bprezentowane jako obiekt do eksportu\/importu. To samo dotyczy danych adresowych. <\/span><\/span>Analogicznie do nazw atrybut\u00f3w technicznych, nadano nast\u0119puj\u0105ce nazwy jednostek:<\/span><\/span><\/p>\n