Metody HTTP do obs\u0142ugi zam\u00f3wie\u0144 pozwalaj\u0105 platformom e-commerce synchronizowa\u0107 dane o zam\u00f3wieniach z ECDP. Dzi\u0119ki temu historia zakup\u00f3w klient\u00f3w jest zawsze aktualna, co wspiera analityk\u0119, segmentacj\u0119, analiz\u0119 RFM i spersonalizowane scenariusze marketingowe.<\/p>\n\n\n\n
Metoda POST \/orders tworzy nowe zam\u00f3wienia lub aktualizuje istniej\u0105ce dane. Obs\u0142uguje trzy tryby operacji: Add (tworzenie nowego), AddOrReplace (tworzenie nowego lub aktualizacja istniej\u0105cego) oraz Replace (aktualizacja istniej\u0105cego).<\/p>\n\n\n\n
POST orders<\/p>\n\n\n\n
Host:<\/strong> https:\/\/api.ecdp.app<\/p>\n\n\n\n Wymagany jest co najmniej jeden identyfikator klienta zgodny z konfiguracj\u0105 w Ustawienia<\/strong> > Klienci<\/strong> > Klienci<\/strong>.<\/p>\n\n\n\n Dodanie nowego zam\u00f3wienia<\/strong><\/p>\n\n\n\nParametry zapytania<\/h3>\n\n\n\n
Parametr<\/strong><\/td> Lokalizacja<\/strong><\/td> Typ<\/strong><\/td> Wymagany<\/strong><\/td> Opis<\/strong><\/td> Dozwolone warto\u015bci \/ Uwagi<\/strong><\/td><\/tr><\/thead> x-api-key<\/td> header<\/td> string<\/td> tak<\/td> klucz uwierzytelniaj\u0105cy API.<\/td> Pobierz w Ustawienia > API.<\/td><\/tr> Content-Type<\/td> header<\/td> string<\/td> tak<\/td> typ zawarto\u015bci \u017c\u0105dania.<\/td> application\/json.<\/td><\/tr> mode<\/td> body<\/td> string<\/td> tak<\/td> tryb operacji.<\/td> Add, AddOrReplace, Replace.<\/td><\/tr> id<\/td> body<\/td> string<\/td> tak<\/td> unikalny identyfikator zam\u00f3wienia.<\/td> Maks. 128 znak\u00f3w.<\/td><\/tr> date<\/td> body<\/td> string ($date-time)<\/td> tak<\/td> data i czas z\u0142o\u017cenia zam\u00f3wienia.<\/td> Format: YYYY-MM-DDTHH:mm:ss.sssZ.<\/td><\/tr> timeZone<\/td> body<\/td> string<\/td> nie<\/td> strefa czasowa dla daty zam\u00f3wienia.<\/td> Zobacz Obs\u0142ugiwane strefy czasowe<\/strong>. Domy\u015blnie: strefa czasowa jednostki biznesowej.<\/td><\/tr> websiteId<\/td> body<\/td> integer($int32)<\/td> nie<\/td> identyfikator strony internetowej, na kt\u00f3rej z\u0142o\u017cono zam\u00f3wienie.<\/td> Warto\u015b\u0107 ca\u0142kowita.<\/td><\/tr> status<\/td> body<\/td> string<\/td> nie<\/td> status zam\u00f3wienia.<\/td> placed, paid, completed, canceled.<\/td><\/tr> currency<\/td> body<\/td> string<\/td> nie<\/td> kod waluty zam\u00f3wienia.<\/td> Dok\u0142adnie 3 znaki (ISO 4217).<\/td><\/tr> totalValue<\/td> body<\/td> number($double)<\/td> nie<\/td> ca\u0142kowita warto\u015b\u0107 zam\u00f3wienia.<\/td> Min. 0.<\/td><\/tr> returnsValue<\/td> body<\/td> number($double)<\/td> nie<\/td> warto\u015b\u0107 zwr\u00f3conych produkt\u00f3w.<\/td> Min. 0.<\/td><\/tr> customer<\/td> body<\/td> object<\/td> tak<\/td> dane identyfikacyjne klienta.<\/td> Zobacz Order customer data<\/strong><\/td><\/tr> products<\/td> body<\/td> array<\/td> tak<\/td> zam\u00f3wione produkty.<\/td> Zobacz Order product data<\/strong><\/td><\/tr> orderAttributes<\/td> body<\/td> array<\/td> nie<\/td> niestandardowe atrybuty zam\u00f3wienia.<\/td> Zobacz Order attribute value<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Order customer data<\/h4>\n\n\n\n
Parametr<\/strong><\/td> Lokalizacja<\/strong><\/td> Typ<\/strong><\/td> Wymagany<\/strong><\/td> Opis<\/strong><\/td> Uwagi<\/strong><\/td><\/tr><\/thead> email<\/td> body<\/td> string<\/td> warunkowo<\/td> adres e-mail klienta.<\/td> Wymagany, je\u015bli e-mail jest domy\u015blnym trybem dopasowania. Maks. 320 znak\u00f3w.<\/td><\/tr> phone<\/td> body<\/td> string<\/td> warunkowo<\/td> numer telefonu klienta.<\/td> Wymagany, je\u015bli telefon jest domy\u015blnym trybem dopasowania. Maks. 20 znak\u00f3w.<\/td><\/tr> crmId<\/td> body<\/td> string<\/td> warunkowo<\/td> identyfikator CRM klienta.<\/td> Wymagany, je\u015bli CRM ID jest domy\u015blnym trybem dopasowania. Maks. 128 znak\u00f3w.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Order product data<\/h4>\n\n\n\n
Parametr<\/strong><\/td> Lokalizacja<\/strong><\/td> Typ<\/strong><\/td> Wymagany<\/strong><\/td> Opis<\/strong><\/td> Uwagi<\/strong><\/td><\/tr><\/thead> id<\/td> body<\/td> string<\/td> tak<\/td> identyfikator produktu.<\/td> Min. 1, maks. 128 znak\u00f3w.<\/td><\/tr> name<\/td> body<\/td> string<\/td> tak<\/td> nazwa produktu.<\/td> Min. 0, maks. 2048 znak\u00f3w.<\/td><\/tr> price<\/td> body<\/td> numer($double)<\/td> tak<\/td> cena jednostkowa.<\/td> Min. 0.<\/td><\/tr> quantity<\/td> body<\/td> integer($int32)<\/td> tak<\/td> zam\u00f3wiona ilo\u015b\u0107.<\/td> Min. 1, maks. 2147483647.<\/td><\/tr> returned<\/td> body<\/td> integer($int32)<\/td> nie<\/td> zwr\u00f3cona ilo\u015b\u0107.<\/td> Min. 0, maks. 2147483647.<\/td><\/tr> url<\/td> body<\/td> string<\/td> nie<\/td> URL strony produktu.<\/td> Maks. 2048 znak\u00f3w.<\/td><\/tr> imageUrl<\/td> body<\/td> string<\/td> nie<\/td> URL zdj\u0119cia produktu.<\/td> Maks. 2048 znak\u00f3w.<\/td><\/tr> category<\/td> body<\/td> string<\/td> nie<\/td> kategoria produktu.<\/td> Maks. 2048 znak\u00f3w.<\/td><\/tr> productAttributes<\/td> body<\/td> array<\/td> nie<\/td> niestandardowe cechy produktu.<\/td> Zobacz Product custom attribute values<\/strong><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Product custom attribute values<\/h4>\n\n\n\n
Parametr<\/strong><\/td> Lokalizacja<\/strong><\/td> Typ<\/strong><\/td> Wymagany<\/strong><\/td> Opis<\/strong><\/td> Uwagi<\/strong><\/td><\/tr><\/thead> name<\/td> body<\/td> string<\/td> tak<\/td> nazwa cechy produktu.<\/td> Maks. 256 znak\u00f3w.<\/td><\/tr> value<\/td> body<\/td> string<\/td> nie<\/td> warto\u015b\u0107 tej cechy.<\/td> \u2013<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Order attribute value#<\/a><\/h4>\n\n\n\n
Parametr<\/strong><\/td> Lokalizacja<\/strong><\/td> Typ<\/strong><\/td> Wymagany<\/strong><\/td> Opis<\/strong><\/td> Uwagi<\/strong><\/td><\/tr><\/thead> name<\/td> body<\/td> string<\/td> tak<\/td> nazwa cechy zam\u00f3wienia.<\/td> Maks. 256 znak\u00f3w.<\/td><\/tr> value<\/td> body<\/td> string<\/td> nie<\/td> warto\u015b\u0107 tej cechy.<\/td> \u2013<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Przyk\u0142adowe zapytania#<\/a><\/h3>\n\n\n\n