Obecný popis
Exportní výstup Cesťáků-zpráv ve formátu XLSX (Microsoft Excel) je určen pro datový přenos Cesťáků (volitelně včetně přiložených účtenek) z Fidoo ven a pro následné zpracování a další použití mimo Fidoo. Univerzální formát XLSX dovoluje jak pohodlnou uživatelskou práci, tak automatizované/robotické zpracování vyexportovaných dat.
Obsahově je tento export navržen tak, aby poskytoval maximální možnou šířku informací o Cesťácích Fidoo.
Typické využití tohoto exportního formátu je pro přehledy, reporty, analýzy, investigace, ale i pro import dat do dalších podnikových systémů.
Principy a pravidla používání exportu
- Export průběžně doplňujeme o nové údaje tak, jak postupně zpracováváme nové klientské požadavky.
- Pokud do exportu doplňujeme nové údaje, snažíme se jednotlivá data obsahově shlukovat k sobě. Tím dochází ke změně pořadí sloupců. Je potřeba s tím počítat, že doplňování dalších údajů a změny v pořadí sloupců budou v budoucnu neustále nastávat.
- Názvy sloupců v exportu v budoucnu měnit nebudeme.
- Pokud používáte XLSX export pro automatizované zpracování, nastavujte své skripty a roboty na názvy sloupců, nikoliv na jejich pořadí.
- Doporučujeme pro automatizované zpracování exportních výstupů z Fidoo pokud možno nepoužívat tento XLSX formát, ale namísto toho zvolit jiný, vhodnější a stabilnější formát/způsob určený primárně pro automatizované zpracování. Např. formát XML nebo Fidoo Public API (viz Generický formát XML a Public API).
Struktura a popis dat
Název v Exportu | Název interní / XML | Popis pole | Vzor dat |
---|---|---|---|
travel_report_id | reportId | Identifikátor cesťáku | TR-455 |
report_name | reportName | Název cesťáku | Cesta do Mordoru |
user_firstname | user/[@firstName] | Jméno cestovatele | Sam |
user_lastname | user/[@lastName] | Příjemní cestovatele | Křepelka |
journey_type | journeyType | Typ cesťáku | foreign |
report_state | reportState | Status cesťáku | approve |
journey_start_date | journeyStartDate | Datum začátku cesty | 11.03.2021 8:00:00 |
journey_end_date | journeyEndDate | Datum konce cesty | 21.03.2021 21:31:41 |
journey_start_point | journeyStartPoint | Místo začátku cesty | Praha, Česko |
journey_end_point | journeyEndPoint | Místo konce cesty | Katovice, Polsko |
meal_allowance_czk | allowance/[@mealAllowanceCzk] | Stravování (orientační výpočet) | 880 |
pocket_money_czk | allowance/[@pocketMoneyCzk] | Kapesné (orientační výpočet) | 440 |
car_allowance_czk | allowance/[@carAllowanceCzk] | Náhrada za soukromé vozidlo (orientační výpočet) | 0 |
fuel_allowance_czk | allowance/[@fuelAllowanceCzk] | Náhrada za palivo (orientační výpočet) | 0 |
allowance_total_czk | allowance/[@allowanceTotalCzk] | Celkové náhrady (orientační výpočet) | 1320 |
cost_centers | costCenters/costCenter | Označení cost centra, na které je cesťák přiřazen | AAA |
projects | projects/project | Označení projektu, na které je cesťák přiřazen | BBB |
journey_note | journeyNote | Poznámka | text poznámky |
days_count | daysCount | Počet dní | 2 |
report_created | reportCreated | Datum vytvoření cesťáku | 10.03.2021 11:10:00 |
report_author | reportAuthor | Autor cesťáku | Sam Křepelka |
report_approved | reportApproved | Schvalovatel cesťáku | Karel Schvalovatel |
report_accountant_approved | reportAccountantApproved | Účetní | Jana Vypočítavá |
request_id | request/requestId | Identifikátor žádosti | TQ-555 |
request_state | request/requestState | Status žádosti | approve |
export_from_date | export/[@fromdate] | Výpis cesťáků od data | 10.03.2021 0:00:01 |
export_to_date | export/[@todate] | Výpis cesťáků do data | 22.03.2021 23:59:59 |
export_created | export/[@created] | Datum exportu souboru | 12.03.2021 13:51:51 |
deposit_requested | depositRequested | Požadovaná záloha | 123 |
deposit_currency | depositCurrency | Měna zálohy | CZK |
deposit_type | depositType | Typ zálohy | card |
employee_number | user/[@employeeNumber] | Zaměstnanecké číslo (pokud je vyplněno) | 123666 |
approval_date | approval/date | Datum posledního schválení | 10.03.2021 13:25:50 |
approval_first_name | approval/firstName | Jméno posledního schvalovatele | Karel |
approval_last_name | approval/lastName | Příjmení posledního schvalovatele | Schvalovatel |
approval_employee_number | approval/employeeNumber | Zaměstnanecké číslo posledního schvalovatele | 123666 |
trip_id | id | Identifikátor cesty | 043be458-7ce1-457e-85fc-95399b201a04 |
---|---|---|---|
report_id | reportId | Identifikátor cesťáku | TR-415 |
journey_type | journeyType | Typ cesťáku | DOMESTIC |
journey_start_date | startDate | Datum začátku jedn. cesty | 11.03.2021 8:00:00 |
journey_end_date | endDate | Datum konce jedn. cesty | 17.03.2021 17:10:00 |
journey_start_point | startPoint | Místo začátku jedn. cesty | Praha, Česko |
journey_end_point | endPoint | Místo konce jedn. cesty | Ostrava, Česko |
meal_allowance_czk | mealAllowanceCzk | Stravování | 400 |
pocket_money_czk | pocketMoneyCzk | Kapesné | 100 |
car_allowance_czk | carAllowanceCzk | Náhrada za soukromé vozidlo | 0 |
fuel_allowance_czk | fuelAllowanceCzk | Náhrada za palivo | 0 |
allowance_total_czk | allowanceTotalCzk | Celkové náhrady | 500 |