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):

  1. excelWidth - širina stupca u Excel tabeli (ako je izvoz u Excelu). Inače je podrazumijevana vrijednost 100.
  2. stringMaxNOfCharacters - ograničenje vrijednosti na broj znakova.
  3. replaceCharacter in replaceCharacterSeparator zamjena vrijednosti prema unesenoj definiciji (pogledajte primjer 2 ispod kao primjer upotrebe)
  4. 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:

  1. replaceCharacter
  2. leftPad
  3. stringMaxNOfCharacters


Podržani su sljedeći tipovi stupaca:

TipZnačenje
Napomena
fix_valueFiksna vrijednostZahtjevan dodatni stupac 'fixValue' s fiksnom vrijednošću. 
fix_value_if_codFiksna vrijednost, ako narudžba ima otkupninuZahtjevani dodatni stupci 'fixValue' i 'fixValueNoValue' s fiksnom vrijednošću.
empty_valuePrazna vrijednost
full_namePuno ime primatelja
firstnameIme primateljaU OM je zapisano samo puno ime primatelja. Potom je "Ime" prva riječ, odvojena razmakom.
secondnamePrezime primateljaU OM je zapisano samo puno ime primatelja. Potom je "Prezime" niz za prvu riječ, odvojenu razmakom.
streetUlica i kućni broj primatelja
street_nameUlica
street_numberKućni broj
Kućni broj je prvi niz, odvojen razmakom, koji sadrži broj
post_numberPoštanski broj primatelja 
placeKraj primatelja
provincePokrajina primatelja
phone_numberTelefonski broj primatelja 
emailE-mail primatelja
order_dateDatum narudžbeZahtjevan dodatni stupac orderDateFormat s odgovarajućom vrijednošću za formatiranje (npr. "dd/MM/yyyy")
export_dateDatum izvoza podatakaZahtjevan dodatni stupac orderDateFormat s odgovarajućom vrijednošću za formatiranje (npr. "dd/MM/yyyy")
customer_orderNarudžba kupca
customer_order_normalize1Narudžba kupca u normaliziranom oblikuUklanjaju se zarezi i razmaci. Primjer "100 200,300400" -> "100200,300400"
notesDodatni opis narudžbe
codVrijednost moguće otkupninePreko 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_sumVrijednost cijelokupne narudžbe
weight_gUkupna težina narudžbe u gramima
weight_kgUkupna težina narudžbe u kg (na 3 decimale) 
productDecriptionPopis proizvoda u narudžbipopis količina - šifra proizvoda. Odvojeno zarezom. Ne sadrži uslugu. (npr. 1 - SKU1, 2 - SKU2)
product_skuŠifra proizvodaDostupna samo, ako je uključena opcija separate_by_material_product
product_quantityKoličina proizvodaDostupna samo, ako je uključena opcija separate_by_material_product
country_enDržava
country_en_2char
Država 2 znaka

country_en_3char
Država 3 znaka

product_desc2Opis proizvoda
product_desc3
Opisi proizvoda odvojeni zarezomU slučaju, da je odabrana opcija 'Rajščlani ispis po proizvodima' u svakom redku se ispiše
product_heightVisina proizvodaU mm
product_widthŠirina proizvodaU mm
product_lengthDubina proizvodaU mm
street_romania_blUlica Rumunjska - oznaka BL
street_romania_scUlica Rumunjska - oznaka SC
street_romania_etUlica Rumunjska  - oznaka ET
street_romania_apUlica 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 :


TipZnačenje
Podrazumijevana vrijednostNapomena
filenameIme izlazne datotekenot_define
csv_encodingKodna tabela za kodiranje posebnih jezičkih znakova pojedinačne države za CSV izvoz
UTF8
Primjer vrijednosti :
Cp1250
Cp1252
csv_separatorOdvajač između vrijednosti stupaca za CSV izvozzarez
separate_by_material_productSvaka narudžba se raščlanjuje na kombiniranu narudžbu - N redaka materijalnih proizvodafalse
merge_with_data_exportZdruž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"  }  ]}