V primeru, da želite podatke izvoziti za dostavno službo, ki v OM še ni podprta, lahko s pomočjo konfiguratorja izdelate .cvs ali .xls datoteko. Ko boste v OM izbrali gumb "Izvoz", se bo preko oznake dostavne službe izbrala izvozni format (CSV, Excel), ki ga boste zgradili.

1. Koraki za nastavitev - kreiranje povezave

Dodatne nastavitve / Dostavne službe - izberite "Prilagojeni izvoz"

Izpolnite podatke Vrsta dostave, ime datoteke ob izvozu ter ostale morebitne potrebne podatke

Vrsta dostave = izberete Vrsto dostave, ki ste jo pred tem vnesli v Nastavitve/Šifranti (izbrani šifrant - vrsta dostave).

Format = izberete obliko zapisa željenega izvoza

Vnos shranite.

Za nov zapis kliknete in izbirete med ponujenimi:

Naziv = ime stolpca

tip podatkov = vrednost, ki jo želite da bi se iz naročila zapisala v ta stolpec.

To ponavljate, tollikokrat kot je

Vsebino shranite.

3. Izvoz podatkov

V Order Managementu izberete vnešeno dostavno službo in s klikom na gumb "izvoz" se bo kreirala datoteka, ki ste jo pripravili v prejšnjih korakih.

Podrobnejši opis nastavitev izvoza

Konfiguracija nastavitve je sestavljena iz naslednjih delov :

extraFields - splošne nastavitve poročila
columns - določitev stolpcev

Primer 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}
  ]
}

Vsak stolpec je svoj zapis in ima naslednja obvezna polja :

title - naziv, ki mora nujno biti za vsak stolpec različen
type - tip podatkov, ki določa kateri podatki se bodo izpisali.

Vsak stolpec lahko vsebuje (niso obvezna) tudi naslednja polja :

excelWidth - širina stolpca v Excel tabeli (če je izvoz v Excel). Drugače je prevzeta vrednost 100.
stringMaxNOfCharacters - omejitev vrednosti na število znakov.
replaceCharacter in replaceCharacterSeparator zamenjava vrednosti glede na vnešeno definicijo (glej spodaj Primer 2 za primer uporabe)
leftPadCharacter in leftPadSize - v kolikor vrednost ne presega dolžine LeftPadSize, se predtem dodajo znaki LeftPadCharacter (glej spodaj Primer 2 za primer uporabe)

Opomba: v koliko so podani parametri leftPad, replaceCharacter in stringMaxNOfCharacters, se le ti vedno izvedeno v naslednjem vrstnem redu :

replaceCharacter
leftPad
stringMaxNOfCharacters

Podprti so naslednji tipi stolpcev :

Tip	Pomen	Opomba
fix_value	Fiksna vrednost	Zahtevan dodatni stolpec 'fixValue' s fiksno vrednostjo.
fix_value_if_cod	Fiksna vrednost, če ima naročilo odkupnino	Zahtevana dodatna stolpca 'fixValue' in 'fixValueNoValue' s fiksno vrednostjo.
empty_value	Prazna vrednost
full_name	Polno ime prejemnika
firstname	Ime prejemnika	V OM je zapisano samo polno ime prejemnika. "Ime" je potem prva beseda, ločena s presledkom.
secondname	Priimek prejemnika	V OM je zapisano samo polno ime prejemnika. "Priimek" je potem niz za prvo besedo, ločena s presledkom.
street	Ulica in hišna številka prejemnika
street_name	Ulica
street_number	Hišta številka	Hišna številka je tako prvi niz, ločen s presledkom, ki vsebuje številko
post_number	Poštna številka prejemnika
place	Kraj prejemnika
province	Provinca prejemnika
phone_number	Telefonska številka prejemnika
email	E-mail prejemnika
order_date	Datum naročila	Zahtevan dodatni stolpce orderDateFormat z ustrezno vrednostjo za formatiranje (npr. "dd/MM/yyyy")
export_date	Datum izvoza podatkov	Zahtevan dodatni stolpce orderDateFormat z ustrezno vrednostjo za formatiranje (npr. "dd/MM/yyyy")
customer_order	Naročilo kupca
customer_order_normalize1	Naročilo kupca v normalizirani obliki	Odstranijo se vejice in presledki. Primer "100 200,300400" -> "100200,300400"
notes	Dodatni opis naročila
cod	Vrednost morebitne odkupnine	Preko parametra "codZeroValue" se nastavi vrednost, ki se uporabi če ni odkupnine (prevzeto prazna vrednost). Parameter "codDecimalSeparator" je namenjen določitvi znaka razmejitve med celim in decimalnim delom številka (prevzeto ",").
order_sum	Vrednost celotnega naročila
weight_g	Skupna teža naročila v gramih
weight_kg	Skupna teža v naročila v kg (na 3 decimalke)
productDecription	Seznam artiklov na naročilu	seznam količina - šifra artikla. Ločeno s vejico. Ne vsebuje storitev. (npr. 1 - SKU1, 2 - SKU2)
product_sku	Šifra artikla	Na voljo samo, če je vključena možnost separate_by_material_product
product_quantity	Količina artikla	Na voljo samo, če je vključena možnost separate_by_material_product
country_en	Država
country_en_2char	Država 2 znaka
country_en_3char	Država 3 znaki
product_desc2	Opis artikla
product_desc3	Opisi artiklov ločeni z vejico	V primeru, da je izbrana možnost 'Loči izpis po artiklih' se v vsaki vrstici izpiše
product_height	Višina produkta	V mm
product_width	Širina produkta	V mm
product_length	Globina produkta	V mm
street_romania_bl	Ulica Romunija - oznaka BL
street_romania_sc	Ulica Romunija - oznaka SC
street_romania_et	Ulica Romunija - oznaka ET
street_romania_ap	Ulica Romunija - oznaka AP
count_code	Št. naročila
product_printout_amount_x_code	Artikli izpis (količina x sku)
product_printout_amount_x_description	Artikli izpis (količina x opis)	Format izpisa izberete pod 'Dodatne nastavitve > OrderManagement > Izberi format opomb na nalepkah'
product_printout	Artikli izpis	V primeru, da izbere to možnost, se vam prikaže dodatno polje 'Format izpisa'.
customer_order_and_initials	Naročilo kupca & inicialke	Naročilo kupca in prvi dve črki imena
tracking_code	Tracking koda naročila
product_customs_tariff	Carinska tarifa artikla
product_country_of_origin	Država porekla artikla
price_with_tax_by_piece	Cena z davkom artikla / kos
invoice_count_code	Številka računa

Možne so naslednje splošne nastavitve stolpcev :

Tip	Pomen	Privzeta vrednost	Opomba
filename	Ime izhodne datoteke	not_define
csv_encoding	Kodna tabela za kodiranje posebnih znakov jezika posamezne države za CSV izvoz	UTF8	Primer vrednosti : Cp1250 Cp1252
csv_separator	Ločnik med vrednostmi stolpcev za CSV izvoz	vejica
separate_by_material_product	Vsako naročilo se razbije na kombinacijo naročilo - N vrstic materialnih artiklov	false
merge_with_data_export	Združi več izvozov v eno ZIP datoteko.	prazno
tracking_url	URL za sledenje naročila	prazno	Vrednost bo prisotna samo v primeru, da ima prodajno naročilo generirano tracking kodo in sicer : tracking_url + tracking_code
delivery_service_phone_number	Tel. št. dostavne službe	prazno

Primeri

Primer 1 : bolj obsežna 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 }
  ]
}

Primer 2 : uporaba LeftPad in ReplaceCharacter

Opombe :

leftPadSize = 5 in leftPadCharacter = '0' pomeni, da v koliko je niz krajši od 5 znakov, bo predtem dobil znake 0. Npr. "30" -> "00030"
replaceCharacterSeparator = "#;". Prvi znak (#) označuje delimeter znak med iskalnim nizom in nizem za zamenjavo. Drugi znak (;) označuje delimter znak med posameznimi definicijami. Pravilo ",# ;!#_;.#" tako lahko razbijemo na 3 ločena pravila (na podlagi znaka (;) :
- ",# " - vejico spremeni v presledek,
- "!#_" - klicaj spremeni v podvezaj
- ".#" - piko spremeni v prazen 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"
  }
  ]
}

Podpora

Prilagojeni izvozi za dostavne službe ( xls, csv) Natisni

1. Koraki za nastavitev - kreiranje povezave

3. Izvoz podatkov

Podrobnejši opis nastavitev izvoza

Primeri

Primer 1 : bolj obsežna konfiguracija

Primer 2 : uporaba LeftPad in ReplaceCharacter

Prilagojeni izvozi za dostavne službe ( xls, csv) Natisni

1. Koraki za nastavitev - kreiranje povezave

3. Izvoz podatkov

Podrobnejši opis nastavitev izvoza

Primeri

Primer 1 : bolj obsežna konfiguracija

Primer 2 : uporaba LeftPad in ReplaceCharacter

Related Articles