Dni robocze (niezależny wydawca) (wersja zapoznawcza)
Usługa dni roboczych. Obejmuje ponad 45 krajów i 230 kalendarzy regionalnych. Obejmuje również główne kalendarze giełdowe. Jakość danych jest priorytetem. Interfejs API oferuje aktualne informacje, postępując zgodnie z ogłoszeniami rządowymi dotyczącymi zmian w świętach publicznych.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Tomasz Poszytek |
| adres URL | https://aka.ms/poszytek |
| tomasz@poszytek.eu |
| Metadane łącznika | |
|---|---|
| Publisher | Tomasz Poszytek |
| Witryna internetowa | https://api.workingdays.org/ |
| Zasady ochrony prywatności | https://api.workingdays.org/1.2/privacy_policy.php |
| Kategorie | Finanse; Handel |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Podaj klucz interfejsu API. | securestring | Podaj klucz interfejsu API. | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Analiza |
Analizowanie okresu (podaj start_date i end_date w danym kalendarzu, interfejs API odpowiada na analizę okresu). |
| Dodawanie dni roboczych |
Dodaj (lub usuń) dowolną liczbę dni roboczych do daty. |
| Dodawanie dni weekendowych |
Dodaj dni weekendowe do danej daty. |
| Dodawanie dni wolnych od pracy |
Dodaj dni, w których mają miejsce dni wolne od pracy z daną datą. |
| Dodawanie godzin pracy |
Dodaj ilość czasu pracy do danej daty/godziny rozpoczęcia. |
| Lokalizowanie adresu pocztowego |
Czasami może być konieczne określenie, która konfiguracja kalendarza jest odpowiednia dla danego adresu pocztowego klienta. Ta usługa zwraca odpowiednie country_code i konfigurację dla danego adresu pocztowego. |
| Sprawdzanie limitu przydziału |
Sprawdź limit przydziału pozostałych dni do użycia w ciągu bieżącego miesiąca i dostępny dla następnego miesiąca. |
| Uzyskiwanie informacji o dniu |
Uzyskaj szczegółowe informacje o określonym dniu. |
| Wyświetlanie listy dni roboczych |
Wyświetl listę dni wolnych od pracy (dni weekendowe, dni wolne od pracy i daty niestandardowe) między 2 datami. |
Analiza
Analizowanie okresu (podaj start_date i end_date w danym kalendarzu, interfejs API odpowiada na analizę okresu).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod kraju
|
country_code | True | string |
Kod kraju ISO (2 litery). |
|
Data rozpoczęcia
|
start_date | True | string |
Data rozpoczęcia (RRRR-MM-DD) |
|
Data zakończenia
|
end_date | True | string |
Data zakończenia (RRRR-MM-DD) |
|
Godzina rozpoczęcia
|
start_time | string |
Godzina rozpoczęcia (HH:MM) |
|
|
Godzina zakończenia
|
end_time | string |
Godzina zakończenia (HH:MM) |
|
|
Konfiguracja
|
configuration | string |
Nazwa konfiguracji ustawień wstępnych regionalnych. Aby uzyskać więcej informacji, zobacz dokumentację. |
|
|
Weekend
|
weekend | string |
Struktura weekendu. Niedziela-poniedziałek-wtorek-środa-czwartek-piątek-sobota. Jeśli weekend dla Ciebie to niedziela i poniedziałek, możesz wysłać: 1100000 Jeśli weekend jest w sobotę po południu i niedzielę: 1000003 |
|
|
Godziny tygodnia
|
week_times | string |
Struktura harmonogramu roboczego tygodnia. Ten parametr jest przydatny podczas przetwarzania godzin pracy w danym okresie. W przypadku użycia ten parametr jest zastępowany przez parametr week_hours. |
|
|
Uruchamianie szablonu
|
start_template | string |
Data rozpoczęcia szablonu naprzemiennego tygodnia (RRRR-MM-DD) Jeśli zdefiniujesz harmonogram szablonu naprzemiennego tygodnia, musisz określić niedzielę rozpoczęcia szablonu. |
|
|
Korzystanie z konfiguracji niestandardowej
|
use_custom_configuration | boolean |
Weź pod uwagę własną konfigurację osobistą. |
|
|
Identyfikator profilu
|
profile_id | string |
Jeśli utworzono kilka profilów w ramach konfiguracji niestandardowej, identyfikator profilu do użycia. 6 znaków. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data zakończenia |
|
Wszystkie sumy
|
result.days.total | string |
Łączna liczba dni w okresie |
|
Wszystkie poniedziałki
|
result.days.mondays | string |
Poniedziałki w okresie |
|
Wszystkie wtorki
|
result.days.tuesdays | string |
Wtorki w okresie |
|
Wszystkie środy
|
result.days.wednesdays | string |
Środy w okresie |
|
Wszystkie czwartki
|
result.days.thursdays | string |
Czwartki w okresie |
|
Wszystkie piątki
|
result.days.fridays | string |
Piątki w okresie |
|
Wszystkie soboty
|
result.days.saturdays | string |
Soboty w okresie |
|
Wszystkie niedziele
|
result.days.sundays | string |
Niedziele w okresie |
|
Wszystkie godziny
|
result.days.hours | string |
Godziny w okresie |
|
Cała suma robocza
|
result.working_days.total | string |
Łączna liczba dni roboczych w okresie |
|
Wszystkie poniedziałki robocze
|
result.working_days.mondays | string |
Poniedziałki robocze w okresie |
|
Wszystkie wtorki robocze
|
result.working_days.tuesdays | string |
Wtorki robocze w okresie |
|
Wszystkie środy robocze
|
result.working_days.wednesdays | string |
Środy robocze w okresie |
|
Wszystkie czwartki robocze
|
result.working_days.thursdays | string |
Czwartki robocze w danym okresie |
|
Wszystkie piątki robocze
|
result.working_days.fridays | string |
Piątki robocze w danym okresie |
|
Wszystkie soboty robocze
|
result.working_days.saturdays | string |
Soboty robocze w okresie |
|
Wszystkie niedziele robocze
|
result.working_days.sundays | string |
Niedziele robocze w danym okresie |
|
Wszystkie godziny pracy
|
result.working_days.work_hours | string |
Godziny pracy w danym okresie |
|
Wszystkie płace
|
result.working_days.wages | string |
Płace w okresie |
|
Łączna liczba dni weekendowych
|
result.weekend_days.total | string |
Łączna liczba dni weekendowych w okresie |
|
Wszystkie dni weekendowe w poniedziałki
|
result.weekend_days.mondays | string |
Dni weekendowe odbywają się w poniedziałki w okresie |
|
Wszystkie dni weekendowe we wtorki
|
result.weekend_days.tuesdays | string |
Dni weekendowe odbywają się we wtorki w okresie |
|
Wszystkie dni weekendowe w środy
|
result.weekend_days.wednesdays | string |
Dni weekendowe odbywają się w środy w okresie |
|
Wszystkie dni weekendowe w czwartki
|
result.weekend_days.thursdays | string |
Dni weekendowe odbywają się w czwartek w okresie |
|
Wszystkie dni weekendowe w piątki
|
result.weekend_days.fridays | string |
Dni weekendowe odbywają się w piątki w okresie |
|
Wszystkie dni weekendowe w soboty
|
result.weekend_days.saturdays | string |
Dni weekendowe odbywają się w soboty w okresie |
|
Wszystkie dni weekendowe w niedziele
|
result.weekend_days.sundays | string |
Dni weekendowe odbywają się w niedziele w okresie |
|
Święta
|
result.public_holidays | object |
Lista świąt publicznych |
Dodawanie dni roboczych
Dodaj (lub usuń) dowolną liczbę dni roboczych do daty.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod kraju
|
country_code | True | string |
Kod kraju ISO (2 litery). |
|
Data rozpoczęcia
|
start_date | True | string |
Data rozpoczęcia (RRRR-MM-DD) |
|
Wzrost
|
increment | True | string |
Liczba dni roboczych, które chcesz dodać do daty rozpoczęcia (dodatnia lub ujemna liczba całkowita, ale nie zero). |
|
Uwzględnij początek
|
include_start | True | boolean |
Czy liczba powinna zawierać start_date? Domyślna wartość to "true". |
|
Konfiguracja
|
configuration | string |
Nazwa konfiguracji ustawień wstępnych regionalnych. Aby uzyskać więcej informacji, zobacz dokumentację. |
|
|
Weekend
|
weekend | string |
Struktura weekendu. Niedziela-poniedziałek-wtorek-środa-czwartek-piątek-sobota. Jeśli weekend dla Ciebie to niedziela i poniedziałek, możesz wysłać: 1100000 Jeśli weekend jest w sobotę po południu i niedzielę: 1000003 |
|
|
Godziny tygodnia
|
week_times | string |
Struktura harmonogramu roboczego tygodnia. Ten parametr jest przydatny podczas przetwarzania godzin pracy w danym okresie. W przypadku użycia ten parametr jest zastępowany przez parametr week_hours. |
|
|
Uruchamianie szablonu
|
start_template | string |
Data rozpoczęcia szablonu naprzemiennego tygodnia (RRRR-MM-DD) Jeśli zdefiniujesz harmonogram szablonu naprzemiennego tygodnia, musisz określić niedzielę rozpoczęcia szablonu. |
|
|
Korzystanie z konfiguracji niestandardowej
|
use_custom_configuration | boolean |
Weź pod uwagę własną konfigurację osobistą. |
|
|
Identyfikator profilu
|
profile_id | string |
Jeśli utworzono kilka profilów w ramach konfiguracji niestandardowej, identyfikator profilu do użycia. 6 znaków. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data zakończenia |
|
Wszystkie sumy
|
result.days.total | string |
Łączna liczba dni w okresie |
|
Wszystkie poniedziałki
|
result.days.mondays | string |
Poniedziałki w okresie |
|
Wszystkie wtorki
|
result.days.tuesdays | string |
Wtorki w okresie |
|
Wszystkie środy
|
result.days.wednesdays | string |
Środy w okresie |
|
Wszystkie czwartki
|
result.days.thursdays | string |
Czwartki w okresie |
|
Wszystkie piątki
|
result.days.fridays | string |
Piątki w okresie |
|
Wszystkie soboty
|
result.days.saturdays | string |
Soboty w okresie |
|
Wszystkie niedziele
|
result.days.sundays | string |
Niedziele w okresie |
|
Wszystkie godziny
|
result.days.hours | string |
Godziny w okresie |
|
Cała suma robocza
|
result.working_days.total | string |
Łączna liczba dni roboczych w okresie |
|
Wszystkie poniedziałki robocze
|
result.working_days.mondays | string |
Poniedziałki robocze w okresie |
|
Wszystkie wtorki robocze
|
result.working_days.tuesdays | string |
Wtorki robocze w okresie |
|
Wszystkie środy robocze
|
result.working_days.wednesdays | string |
Środy robocze w okresie |
|
Wszystkie czwartki robocze
|
result.working_days.thursdays | string |
Czwartki robocze w danym okresie |
|
Wszystkie piątki robocze
|
result.working_days.fridays | string |
Piątki robocze w danym okresie |
|
Wszystkie soboty robocze
|
result.working_days.saturdays | string |
Soboty robocze w okresie |
|
Wszystkie niedziele robocze
|
result.working_days.sundays | string |
Niedziele robocze w danym okresie |
|
Wszystkie godziny pracy
|
result.working_days.work_hours | string |
Godziny pracy w danym okresie |
|
Wszystkie płace
|
result.working_days.wages | string |
Płace w okresie |
|
Łączna liczba dni weekendowych
|
result.weekend_days.total | string |
Łączna liczba dni weekendowych w okresie |
|
Wszystkie dni weekendowe w poniedziałki
|
result.weekend_days.mondays | string |
Dni weekendowe odbywają się w poniedziałki w okresie |
|
Wszystkie dni weekendowe we wtorki
|
result.weekend_days.tuesdays | string |
Dni weekendowe odbywają się we wtorki w okresie |
|
Wszystkie dni weekendowe w środy
|
result.weekend_days.wednesdays | string |
Dni weekendowe odbywają się w środy w okresie |
|
Wszystkie dni weekendowe w czwartki
|
result.weekend_days.thursdays | string |
Dni weekendowe odbywają się w czwartek w okresie |
|
Wszystkie dni weekendowe w piątki
|
result.weekend_days.fridays | string |
Dni weekendowe odbywają się w piątki w okresie |
|
Wszystkie dni weekendowe w soboty
|
result.weekend_days.saturdays | string |
Dni weekendowe odbywają się w soboty w okresie |
|
Wszystkie dni weekendowe w niedziele
|
result.weekend_days.sundays | string |
Dni weekendowe odbywają się w niedziele w okresie |
|
Święta
|
result.public_holidays | object |
Lista świąt publicznych |
Dodawanie dni weekendowych
Dodaj dni weekendowe do danej daty.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod kraju
|
country_code | True | string |
Kod kraju ISO (2 litery). |
|
Data rozpoczęcia
|
start_date | True | string |
Data rozpoczęcia (RRRR-MM-DD) |
|
Wzrost
|
increment | True | string |
Liczba dni weekendowych, które chcesz dodać do daty rozpoczęcia (dodatnia lub ujemna liczba całkowita, ale nie zero). |
|
Uwzględnij początek
|
include_start | True | boolean |
Czy liczba powinna zawierać start_date? Domyślna wartość to "true". |
|
Konfiguracja
|
configuration | string |
Nazwa konfiguracji ustawień wstępnych regionalnych. Aby uzyskać więcej informacji, zobacz dokumentację. |
|
|
Weekend
|
weekend | string |
Struktura weekendu. Niedziela-poniedziałek-wtorek-środa-czwartek-piątek-sobota. Jeśli weekend dla Ciebie to niedziela i poniedziałek, możesz wysłać: 1100000 Jeśli weekend jest w sobotę po południu i niedzielę: 1000003 |
|
|
Godziny tygodnia
|
week_times | string |
Struktura harmonogramu roboczego tygodnia. Ten parametr jest przydatny podczas przetwarzania godzin pracy w danym okresie. W przypadku użycia ten parametr jest zastępowany przez parametr week_hours. |
|
|
Uruchamianie szablonu
|
start_template | string |
Data rozpoczęcia szablonu naprzemiennego tygodnia (RRRR-MM-DD) Jeśli zdefiniujesz harmonogram szablonu naprzemiennego tygodnia, musisz określić niedzielę rozpoczęcia szablonu. |
|
|
Korzystanie z konfiguracji niestandardowej
|
use_custom_configuration | boolean |
Weź pod uwagę własną konfigurację osobistą. |
|
|
Identyfikator profilu
|
profile_id | string |
Jeśli utworzono kilka profilów w ramach konfiguracji niestandardowej, identyfikator profilu do użycia. 6 znaków. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data zakończenia |
|
Wszystkie sumy
|
result.days.total | string |
Łączna liczba dni w okresie |
|
Wszystkie poniedziałki
|
result.days.mondays | string |
Poniedziałki w okresie |
|
Wszystkie wtorki
|
result.days.tuesdays | string |
Wtorki w okresie |
|
Wszystkie środy
|
result.days.wednesdays | string |
Środy w okresie |
|
Wszystkie czwartki
|
result.days.thursdays | string |
Czwartki w okresie |
|
Wszystkie piątki
|
result.days.fridays | string |
Piątki w okresie |
|
Wszystkie soboty
|
result.days.saturdays | string |
Soboty w okresie |
|
Wszystkie niedziele
|
result.days.sundays | string |
Niedziele w okresie |
|
Wszystkie godziny
|
result.days.hours | string |
Godziny w okresie |
|
Cała suma robocza
|
result.working_days.total | string |
Łączna liczba dni roboczych w okresie |
|
Wszystkie poniedziałki robocze
|
result.working_days.mondays | string |
Poniedziałki robocze w okresie |
|
Wszystkie wtorki robocze
|
result.working_days.tuesdays | string |
Wtorki robocze w okresie |
|
Wszystkie środy robocze
|
result.working_days.wednesdays | string |
Środy robocze w okresie |
|
Wszystkie czwartki robocze
|
result.working_days.thursdays | string |
Czwartki robocze w danym okresie |
|
Wszystkie piątki robocze
|
result.working_days.fridays | string |
Piątki robocze w danym okresie |
|
Wszystkie soboty robocze
|
result.working_days.saturdays | string |
Soboty robocze w okresie |
|
Wszystkie niedziele robocze
|
result.working_days.sundays | string |
Niedziele robocze w danym okresie |
|
Wszystkie godziny pracy
|
result.working_days.work_hours | string |
Godziny pracy w danym okresie |
|
Wszystkie płace
|
result.working_days.wages | string |
Płace w okresie |
|
Łączna liczba dni weekendowych
|
result.weekend_days.total | string |
Łączna liczba dni weekendowych w okresie |
|
Wszystkie dni weekendowe w poniedziałki
|
result.weekend_days.mondays | string |
Dni weekendowe odbywają się w poniedziałki w okresie |
|
Wszystkie dni weekendowe we wtorki
|
result.weekend_days.tuesdays | string |
Dni weekendowe odbywają się we wtorki w okresie |
|
Wszystkie dni weekendowe w środy
|
result.weekend_days.wednesdays | string |
Dni weekendowe odbywają się w środy w okresie |
|
Wszystkie dni weekendowe w czwartki
|
result.weekend_days.thursdays | string |
Dni weekendowe odbywają się w czwartek w okresie |
|
Wszystkie dni weekendowe w piątki
|
result.weekend_days.fridays | string |
Dni weekendowe odbywają się w piątki w okresie |
|
Wszystkie dni weekendowe w soboty
|
result.weekend_days.saturdays | string |
Dni weekendowe odbywają się w soboty w okresie |
|
Wszystkie dni weekendowe w niedziele
|
result.weekend_days.sundays | string |
Dni weekendowe odbywają się w niedziele w okresie |
|
Święta
|
result.public_holidays | object |
Lista świąt publicznych |
Dodawanie dni wolnych od pracy
Dodaj dni, w których mają miejsce dni wolne od pracy z daną datą.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod kraju
|
country_code | True | string |
Kod kraju ISO (2 litery). |
|
Data rozpoczęcia
|
start_date | True | string |
Data rozpoczęcia (RRRR-MM-DD) |
|
Wzrost
|
increment | True | string |
Liczba dni dni wolnych od pracy, które chcesz dodać do daty rozpoczęcia (dodatnia lub ujemna liczba całkowita, ale nie zero). |
|
Uwzględnij początek
|
include_start | True | boolean |
Czy liczba powinna zawierać start_date? Domyślna wartość to "true". |
|
Konfiguracja
|
configuration | string |
Nazwa konfiguracji ustawień wstępnych regionalnych. Aby uzyskać więcej informacji, zobacz dokumentację. |
|
|
Weekend
|
weekend | string |
Struktura weekendu. Niedziela-poniedziałek-wtorek-środa-czwartek-piątek-sobota. Jeśli weekend dla Ciebie to niedziela i poniedziałek, możesz wysłać: 1100000 Jeśli weekend jest w sobotę po południu i niedzielę: 1000003 |
|
|
Godziny tygodnia
|
week_times | string |
Struktura harmonogramu roboczego tygodnia. Ten parametr jest przydatny podczas przetwarzania godzin pracy w danym okresie. W przypadku użycia ten parametr jest zastępowany przez parametr week_hours. |
|
|
Uruchamianie szablonu
|
start_template | string |
Data rozpoczęcia szablonu naprzemiennego tygodnia (RRRR-MM-DD) Jeśli zdefiniujesz harmonogram szablonu naprzemiennego tygodnia, musisz określić niedzielę rozpoczęcia szablonu. |
|
|
Korzystanie z konfiguracji niestandardowej
|
use_custom_configuration | boolean |
Weź pod uwagę własną konfigurację osobistą. |
|
|
Identyfikator profilu
|
profile_id | string |
Jeśli utworzono kilka profilów w ramach konfiguracji niestandardowej, identyfikator profilu do użycia. 6 znaków. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data zakończenia |
|
Wszystkie sumy
|
result.days.total | string |
Łączna liczba dni w okresie |
|
Wszystkie poniedziałki
|
result.days.mondays | string |
Poniedziałki w okresie |
|
Wszystkie wtorki
|
result.days.tuesdays | string |
Wtorki w okresie |
|
Wszystkie środy
|
result.days.wednesdays | string |
Środy w okresie |
|
Wszystkie czwartki
|
result.days.thursdays | string |
Czwartki w okresie |
|
Wszystkie piątki
|
result.days.fridays | string |
Piątki w okresie |
|
Wszystkie soboty
|
result.days.saturdays | string |
Soboty w okresie |
|
Wszystkie niedziele
|
result.days.sundays | string |
Niedziele w okresie |
|
Wszystkie godziny
|
result.days.hours | string |
Godziny w okresie |
|
Cała suma robocza
|
result.working_days.total | string |
Łączna liczba dni roboczych w okresie |
|
Wszystkie poniedziałki robocze
|
result.working_days.mondays | string |
Poniedziałki robocze w okresie |
|
Wszystkie wtorki robocze
|
result.working_days.tuesdays | string |
Wtorki robocze w okresie |
|
Wszystkie środy robocze
|
result.working_days.wednesdays | string |
Środy robocze w okresie |
|
Wszystkie czwartki robocze
|
result.working_days.thursdays | string |
Czwartki robocze w danym okresie |
|
Wszystkie piątki robocze
|
result.working_days.fridays | string |
Piątki robocze w danym okresie |
|
Wszystkie soboty robocze
|
result.working_days.saturdays | string |
Soboty robocze w okresie |
|
Wszystkie niedziele robocze
|
result.working_days.sundays | string |
Niedziele robocze w danym okresie |
|
Wszystkie godziny pracy
|
result.working_days.work_hours | string |
Godziny pracy w danym okresie |
|
Wszystkie płace
|
result.working_days.wages | string |
Płace w okresie |
|
Łączna liczba dni weekendowych
|
result.weekend_days.total | string |
Łączna liczba dni weekendowych w okresie |
|
Wszystkie dni weekendowe w poniedziałki
|
result.weekend_days.mondays | string |
Dni weekendowe odbywają się w poniedziałki w okresie |
|
Wszystkie dni weekendowe we wtorki
|
result.weekend_days.tuesdays | string |
Dni weekendowe odbywają się we wtorki w okresie |
|
Wszystkie dni weekendowe w środy
|
result.weekend_days.wednesdays | string |
Dni weekendowe odbywają się w środy w okresie |
|
Wszystkie dni weekendowe w czwartki
|
result.weekend_days.thursdays | string |
Dni weekendowe odbywają się w czwartek w okresie |
|
Wszystkie dni weekendowe w piątki
|
result.weekend_days.fridays | string |
Dni weekendowe odbywają się w piątki w okresie |
|
Wszystkie dni weekendowe w soboty
|
result.weekend_days.saturdays | string |
Dni weekendowe odbywają się w soboty w okresie |
|
Wszystkie dni weekendowe w niedziele
|
result.weekend_days.sundays | string |
Dni weekendowe odbywają się w niedziele w okresie |
|
Święta
|
result.public_holidays | object |
Lista świąt publicznych |
Dodawanie godzin pracy
Dodaj ilość czasu pracy do danej daty/godziny rozpoczęcia.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod kraju
|
country_code | True | string |
Kod kraju ISO (2 litery). |
|
Data rozpoczęcia
|
start_date | True | string |
Data rozpoczęcia (RRRR-MM-DD) |
|
Godzina rozpoczęcia
|
start_time | True | string |
Godzina rozpoczęcia (HH:MM) |
|
Czas przyrostu
|
increment_time | True | string |
Czas pracy, który ma zostać dodany (lub usunięty) do daty rozpoczęcia. Format: H:i |
|
Konfiguracja
|
configuration | string |
Nazwa konfiguracji ustawień wstępnych regionalnych. Aby uzyskać więcej informacji, zobacz dokumentację. |
|
|
Weekend
|
weekend | string |
Struktura weekendu. Niedziela-poniedziałek-wtorek-środa-czwartek-piątek-sobota. Jeśli weekend dla Ciebie to niedziela i poniedziałek, możesz wysłać: 1100000 Jeśli weekend jest w sobotę po południu i niedzielę: 1000003 |
|
|
Godziny tygodnia
|
week_times | string |
Struktura harmonogramu roboczego tygodnia. Ten parametr jest przydatny podczas przetwarzania godzin pracy w danym okresie. W przypadku użycia ten parametr jest zastępowany przez parametr week_hours. |
|
|
Uruchamianie szablonu
|
start_template | string |
Data rozpoczęcia szablonu naprzemiennego tygodnia (RRRR-MM-DD) Jeśli zdefiniujesz harmonogram szablonu naprzemiennego tygodnia, musisz określić niedzielę rozpoczęcia szablonu. |
|
|
Korzystanie z konfiguracji niestandardowej
|
use_custom_configuration | boolean |
Weź pod uwagę własną konfigurację osobistą. |
|
|
Identyfikator profilu
|
profile_id | string |
Jeśli utworzono kilka profilów w ramach konfiguracji niestandardowej, identyfikator profilu do użycia. 6 znaków. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Data zakończenia
|
result.end_date | string |
Obliczana data zakończenia. |
|
Godzina zakończenia
|
result.end_time | string |
Obliczany czas zakończenia. |
Lokalizowanie adresu pocztowego
Czasami może być konieczne określenie, która konfiguracja kalendarza jest odpowiednia dla danego adresu pocztowego klienta. Ta usługa zwraca odpowiednie country_code i konfigurację dla danego adresu pocztowego.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Address
|
address | True | string |
Adres pocztowy. Jest to ciąg bez ograniczeń. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
result.status | string |
Stan adresu |
|
Kod kraju
|
result.country_code | string |
Kod kraju ISO. |
|
Konfiguracja
|
result.configuration | string |
Rozwiąż dodatkowe informacje. |
|
Sformatowany adres
|
result.formatted_address | string |
Zwrócony sformatowany adres. |
Sprawdzanie limitu przydziału
Sprawdź limit przydziału pozostałych dni do użycia w ciągu bieżącego miesiąca i dostępny dla następnego miesiąca.
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
State
|
result.state | string |
Stan planu (1:active, 2:cancelled, -1:error). |
|
Aktualny
|
result.current | string |
Bieżący limit przydziału (dni do przeanalizowania w tym miesiącu). |
|
Next
|
result.next | string |
Limit przydziału dostępny w przyszłym miesiącu. |
Uzyskiwanie informacji o dniu
Uzyskaj szczegółowe informacje o określonym dniu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod kraju
|
country_code | True | string |
Kod kraju ISO (2 litery). |
|
Date
|
date | True | string |
Data analizy (RRRR-MM-DD) |
|
Konfiguracja
|
configuration | string |
Nazwa konfiguracji ustawień wstępnych regionalnych. Aby uzyskać więcej informacji, zobacz dokumentację. |
|
|
Weekend
|
weekend | string |
Struktura weekendu. Niedziela-poniedziałek-wtorek-środa-czwartek-piątek-sobota. Jeśli weekend dla Ciebie to niedziela i poniedziałek, możesz wysłać: 1100000 Jeśli weekend jest w sobotę po południu i niedzielę: 1000003 |
|
|
Korzystanie z konfiguracji niestandardowej
|
use_custom_configuration | boolean |
Weź pod uwagę własną konfigurację osobistą. |
|
|
Identyfikator profilu
|
profile_id | string |
Jeśli utworzono kilka profilów w ramach konfiguracji niestandardowej, identyfikator profilu do użycia. 6 znaków. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Dzień roboczy
|
result.working_day | string |
Czy to dzień roboczy (0 oznacza nie). |
|
Godziny pracy
|
result.work_hours | string |
Liczba godzin pracy tego dnia. |
|
Płaca
|
result.wages | string |
Płaca |
|
Początek rano
|
result.morning_start | string |
Godzina rozpoczęcia porannych |
|
Koniec poranny
|
result.morning_end | string |
Godzina zakończenia poranka |
|
Początek po południu
|
result.afternoon_start | string |
Godzina rozpoczęcia popołudnia |
|
Koniec popołudnia
|
result.afternoon_end | string |
Godzina zakończenia popołudnia |
|
Święto
|
result.public_holiday | string |
Czy to święto publiczne (0 oznacza nie). |
|
Opis święta publicznego
|
result.public_holiday_description | string |
Opis tego święta publicznego |
|
Dzień weekendowy
|
result.weekend_day | string |
Czy jest to dzień weekendowy (0 oznacza nie). |
|
Data niestandardowa
|
result.custom_date | string |
Czy jest to data niestandardowa (0 oznacza nie). |
|
Niestandardowy opis daty
|
result.custom_date_description | string |
Opis tej daty niestandardowej. |
|
Niestandardowy kolor daty
|
result.custom_date_color | string |
Kolor zdefiniowany dla tej daty niestandardowej. |
Wyświetlanie listy dni roboczych
Wyświetl listę dni wolnych od pracy (dni weekendowe, dni wolne od pracy i daty niestandardowe) między 2 datami.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Kod kraju
|
country_code | True | string |
Kod kraju ISO (2 litery). |
|
Data rozpoczęcia
|
start_date | True | string |
Data rozpoczęcia (RRRR-MM-DD) |
|
Data zakończenia
|
end_date | True | string |
Data zakończenia (RRRR-MM-DD) |
|
Konfiguracja
|
configuration | string |
Nazwa konfiguracji ustawień wstępnych regionalnych. Aby uzyskać więcej informacji, zobacz dokumentację. |
|
|
Weekend
|
weekend | string |
Struktura weekendu. Niedziela-poniedziałek-wtorek-środa-czwartek-piątek-sobota. Jeśli weekend dla Ciebie to niedziela i poniedziałek, możesz wysłać: 1100000 Jeśli weekend jest w sobotę po południu i niedzielę: 1000003 |
|
|
Korzystanie z konfiguracji niestandardowej
|
use_custom_configuration | boolean |
Weź pod uwagę własną konfigurację osobistą. |
|
|
Identyfikator profilu
|
profile_id | string |
Jeśli utworzono kilka profilów w ramach konfiguracji niestandardowej, identyfikator profilu do użycia. 6 znaków. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Dni bez pracy
|
result.non_working_days | object |
Lista dni roboczych. |