U slučaju da želite izvoziti podatke za dostavnu službu koja u OM još nije podržana, možete uz pomoć konfiguratora izraditi .cvs ili .xls datoteku. Kada budete odabrali gumb ''Izvoz'' u OM , preko oznake dostavne službe odabrat će se izvozni format (CSV, Excel) koji ćete konstruirati.
1. Koraci za podešavanje - kreiranje veze
Dodatne postavke / Dostavne službe - odaberite "Prilagođeni izvoz"
Ispunite sljedeće podatke - Vrsta dostave, ime datoteke pri izvozu i ostale moguće potrebne podatke
Vrsta dostave = odaberite Vrstu dostave, koju ste pre toga unijeli u Postavke/Registri (odabrani registar - vrsta dostave)
Format = odaberite oblik zapisa željenog izvoza
Spremite unos.
Kliknite na ''Nov zapis'' i odaberite među ponuđenim:
Naziv = ime stupca
tip podataka = vrijednost za koju želite da bude zapisana iz narudžbe u taj stupac
To ponavljajte, onoliko puta koliko je
Sadržaj spremite
3. Izvoz podataka
U Order Managementu odaberite unesenu dostavnu službu i klikom na gumb "izvoz" kreirat će se datoteka, koju ste pripremili u prethodnim koracima.
Detaljniji opis postavki izvoza
Konfiguracija postavki je sastavljena iz sljedećih delova :
- extraFields - opće postavke izvješća
- columns - određivanje stupaca
Primjer konfiguracije :
{ "type": "MK_EXPORT", "delivery_type_id": 1600372916, "country_id": 1, "default_additional_service_id_list": [], "exportFormat": "XLSX", "additional_delivery_services": [], "extraFields" : { "filename" : "Correos_Spain_", "csv_encoding" : "Cp1250", "csv_separator" : ";" }, "columns": [ , { "title": "OrderNumber", "type": "customer_order", "excelWidth": 200 } , { "title": "Name", "type": "full_name", "excelWidth": 200 } , { "title": "Fix1", "type": "fix_value", "fixValue" : "ES", "excelWidth": 100} , { "title": "Empty1", "type": "empty_value", "excelWidth": 100} ]}JavaScript
Svaki stupac je svoj zapis i ima sljedeća obavezna polja:
- title - naziv, koji mora obavezno biti različit za svaki stupac
- type - tip podataka, koji određuje koji podaci će se ispisati.
Svaki stupac može sadržati i sljedeća polja (nisu obavezna):
- excelWidth - širina stupca u Excel tabeli (ako je izvoz u Excelu). Inače je podrazumijevana vrijednost 100.
- stringMaxNOfCharacters - ograničenje vrijednosti na broj znakova.
- replaceCharacter in replaceCharacterSeparator zamjena vrijednosti prema unesenoj definiciji (pogledajte primjer 2 ispod kao primjer upotrebe)
- leftPadCharacter in leftPadSize - ukoliko vrijednost ne premašuje dužinu LeftPadSize, prije toga se dodaju znaci LeftPadCharacter (pogledajte ispod Primjer 2 kao primjer upotrebe)
Napomena: ukoliko su dati parametri leftPad, replaceCharacter i stringMaxNOfCharacters, isti su uvijek izvedeni sljedećim redoslijedom:
- replaceCharacter
- leftPad
- stringMaxNOfCharacters
Podržani su sljedeći tipovi stupaca:
| Tip | Značenje | Napomena |
| fix_value | Fiksna vrijednost | Zahtjevan dodatni stupac 'fixValue' s fiksnom vrijednošću. |
| fix_value_if_cod | Fiksna vrijednost, ako narudžba ima otkupninu | Zahtjevani dodatni stupci 'fixValue' i 'fixValueNoValue' s fiksnom vrijednošću. |
| empty_value | Prazna vrijednost | |
| full_name | Puno ime primatelja | |
| firstname | Ime primatelja | U OM je zapisano samo puno ime primatelja. Potom je "Ime" prva riječ, odvojena razmakom. |
| secondname | Prezime primatelja | U OM je zapisano samo puno ime primatelja. Potom je "Prezime" niz za prvu riječ, odvojenu razmakom. |
| street | Ulica i kućni broj primatelja | |
| street_name | Ulica | |
| street_number | Kućni broj | Kućni broj je prvi niz, odvojen razmakom, koji sadrži broj |
| post_number | Poštanski broj primatelja | |
| place | Kraj primatelja | |
| province | Pokrajina primatelja | |
| phone_number | Telefonski broj primatelja | |
| E-mail primatelja | ||
| order_date | Datum narudžbe | Zahtjevan dodatni stupac orderDateFormat s odgovarajućom vrijednošću za formatiranje (npr. "dd/MM/yyyy") |
| export_date | Datum izvoza podataka | Zahtjevan dodatni stupac orderDateFormat s odgovarajućom vrijednošću za formatiranje (npr. "dd/MM/yyyy") |
| customer_order | Narudžba kupca | |
| customer_order_normalize1 | Narudžba kupca u normaliziranom obliku | Uklanjaju se zarezi i razmaci. Primjer "100 200,300400" -> "100200,300400" |
| notes | Dodatni opis narudžbe | |
| cod | Vrijednost moguće otkupnine | Preko parametra "codZeroValue" podesi se vrijednost, koja se koristi u slučaju da nema otkupnine (preuzeta prazna vrijednost). Parametar "codDecimalSeparator" je namijenjen određivanju znaka razgraničenja između cijelog i decimalnog djela broja (prevzeto ","). |
| order_sum | Vrijednost cijelokupne narudžbe | |
| weight_g | Ukupna težina narudžbe u gramima | |
| weight_kg | Ukupna težina narudžbe u kg (na 3 decimale) | |
| productDecription | Popis proizvoda u narudžbi | popis količina - šifra proizvoda. Odvojeno zarezom. Ne sadrži uslugu. (npr. 1 - SKU1, 2 - SKU2) |
| product_sku | Šifra proizvoda | Dostupna samo, ako je uključena opcija separate_by_material_product |
| product_quantity | Količina proizvoda | Dostupna samo, ako je uključena opcija separate_by_material_product |
| country_en | Država | |
| country_en_2char | Država 2 znaka | |
| country_en_3char | Država 3 znaka | |
| product_desc2 | Opis proizvoda | |
| product_desc3 | Opisi proizvoda odvojeni zarezom | U slučaju, da je odabrana opcija 'Rajščlani ispis po proizvodima' u svakom redku se ispiše |
| product_height | Visina proizvoda | U mm |
| product_width | Širina proizvoda | U mm |
| product_length | Dubina proizvoda | U mm |
| street_romania_bl | Ulica Rumunjska - oznaka BL | |
| street_romania_sc | Ulica Rumunjska - oznaka SC | |
| street_romania_et | Ulica Rumunjska - oznaka ET | |
| street_romania_ap | Ulica Rumunjska - oznaka AP | |
| count_code | Br. narudžbe | |
| product_printout_amount_x_code | Ispis proizvoda (količina x sku) | |
| product_printout_amount_x_description | Ispis proizvoda (količina x opis) | Format ispisa odaberite pod 'Dodatne postavke > OrderManagement > Odaberi format napomena na naljepnicama' |
| product_printout | Ispis proizvoda | U slučaju da odaberete tu opciju, prikazat će Vam se dodatno polje 'Format ispisa'. |
| customer_order_and_initials | Narudžba kupca & inicijali | Narudžba kupca i prva dva slova imena |
| tracking_code | Broj za praćenje narudžbe | |
| product_customs_tariff | Carinska tarifa proizvoda | |
| product_country_of_origin | Država podrijetla proizvoda | |
| price_with_tax_by_piece | Cijena s PDV-om proizvoda / komad | |
| invoice_count_code | Broj računa |
Moguće su sljedeće opće postavke stupaca :
| Tip | Značenje | Podrazumijevana vrijednost | Napomena |
| filename | Ime izlazne datoteke | not_define | |
| csv_encoding | Kodna tabela za kodiranje posebnih jezičkih znakova pojedinačne države za CSV izvoz | UTF8 | Primjer vrijednosti : Cp1250 Cp1252 |
| csv_separator | Odvajač između vrijednosti stupaca za CSV izvoz | zarez | |
| separate_by_material_product | Svaka narudžba se raščlanjuje na kombiniranu narudžbu - N redaka materijalnih proizvoda | false | |
| merge_with_data_export | Združi više izvoza u jednu ZIP datoteku. | prazno | |
| tracking_url | URL za praćenje narudžbe | prazno | Vrijednost će biti prisutna samo u slučaju da prodajna narudžba ima generiran broj za praćenje i to: tracking_url + tracking_code |
| delivery_service_phone_number | Br. tel. dostavne službe | prazno |
Primjeri
Primjer 1 : Opsežnija konfiguracija
{ "type": "MK_EXPORT", "delivery_type_id": 1600372916, "country_id": 1, "default_additional_service_id_list": [], "exportFormat": "XLSX", "additional_delivery_services": [], "extraFields" : { "filename" : "Correos_Spain_", "csv_encoding" : "Cp1250", "csv_separator" : ";" }, "columns": [ { "title": "OrderData", "type": "order_date", "orderDateFormat" : "dd/MM/yyyy", "excelWidth": 200 } , { "title": "OrderNumber", "type": "customer_order", "excelWidth": 200 } , { "title": "Name", "type": "full_name", "excelWidth": 200 } , { "title": "Street", "type": "street", "excelWidth": 200 } , { "title": "Province", "type": "province", "excelWidth": 200 } , { "title": "Post number", "type": "post_number", "excelWidth": 200 } , { "title": "Fix1", "type": "fix_value", "fixValue" : "ES", "excelWidth": 100} , { "title": "Empty1", "type": "empty_value", "excelWidth": 100} , { "title": "Phone", "type": "phone_number_normalize1", "excelWidth": 100} , { "title": "Fix2", "type": "fix_value", "fixValue" : "33", "excelWidth": 100} , { "title": "Empty2", "type": "empty_value", "excelWidth": 100} , { "title": "OrderNumber2", "type": "customer_order_normalize1", "excelWidth": 200, "stringMaxNOfCharacters" : 12} , { "title": "Fix3", "type": "fix_value", "fixValue" : "FALSE", "excelWidth": 100 } , { "title": "Empty3", "type": "empty_value", "excelWidth": 100 } , { "title": "Empty4", "type": "empty_value", "excelWidth": 100 } , { "title": "Notes", "type": "notes", "excelWidth": 200 } , { "title": "Fix4", "type": "fix_value", "fixValue" : "V", "excelWidth": 100 } , { "title": "Fix5", "type": "fix_value", "fixValue" : "1", "excelWidth": 100 } , { "title": "Fix6", "type": "fix_value", "fixValue" : "1", "excelWidth": 100 } , { "title": "Empty5", "type": "empty_value", "excelWidth": 100 } , { "title": "Empty6", "type": "empty_value", "excelWidth": 100 } , { "title": "Empty7", "type": "empty_value", "excelWidth": 100 } , { "title": "Fix7", "type": "fix_value", "fixValue" : "Expedidor", "excelWidth": 100 } , { "title": "COD", "type": "cod", "codZeroValue" : "", "codDecimalSeparator" : ",", "excelWidth": 100 } ]}JavaScript
Primjer 2 : Upotreba LeftPad in ReplaceCharacter
Napomena :
- leftPadSize = 5 in leftPadCharacter = '0' znači, da ukoliko je niz kraći od 5 znakova, prethodno će dobiti znak 0 Npr. "30" -> "00030"
- replaceCharacterSeparator = "#;". Prvi znak (#) označava delimiter znak između niza za pretraživanje i niza za zamjenu. Drugi znak (;) označava delimiter znak između pojedinačnih definicija. Na taj način pravilo ",# ;!#_;.#" možemo razdvojiti na 3 različita pravila (na temelju znaka (;) :
- ",# " - zarez promijeni u razmak,
- "!#_" - uskličnik promijeni u donju crticu
- ".#" - točku promijeni u prazan niz
{ "type" : "MK_EXPORT", "country_id" : 1, "default_additional_service_id_list" : [ ], "extraFields" : { "csv_encoding" : "Cp1252", "csv_separator" : ";", "filename" : "Gologistic_" }, "exportFormat" : "XLSX", "columns" : [ { "title" : "PostalCode", "type" : "post_number", "excelWidth" : 200, "leftPadSize" : 5, "replaceCharacter" : ",# ;!#_;.#", "replaceCharacterSeparator" : "#;", "leftPadCharacter" : "0" } ]}