Dias úteis (Editor Independente) (versão prévia)
Serviço de dias úteis. Abrange mais de 45 países e 230 calendários regionais. Ele também abrange os principais calendários de bolsas de valores. A qualidade dos dados é a prioridade máxima. A API oferece informações atualizadas seguindo comunicados do governo sobre mudanças de feriados públicos.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Tomasz Poszytek |
| URL | https://aka.ms/poszytek |
| tomasz@poszytek.eu |
| Metadados do conector | |
|---|---|
| Publicador | Tomasz Poszytek |
| Site | https://api.workingdays.org/ |
| Política de privacidade | https://api.workingdays.org/1.2/privacy_policy.php |
| Categorias | Financiar; Comércio |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Forneça sua chave de API. | secureString | Forneça sua chave de API. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Adicionar dias de fim de semana |
Adicione dias de fim de semana a uma determinada data. |
| Adicionar dias úteis |
Adicione (ou remova) qualquer número de dias úteis a uma data. |
| Adicionar feriados |
Adicione dias em que feriados públicos estão ocorrendo a uma determinada data. |
| Adicionar horas de trabalho |
Adicione uma quantidade de tempo de trabalho a uma determinada data/hora de início. |
| Analyze |
Analisar um período (fornecer um start_date e um end_date em um determinado calendário, a API responde com a análise de período). |
| Cota de verificação |
Verifique a cota de dias restantes a serem usados no mês atual e disponível para o próximo mês. |
| Listar dias não úteis |
Liste os dias não úteis (dias de fim de semana, feriados públicos e datas personalizadas) entre duas datas. |
| Localizando um endereço postal |
Às vezes, pode ser necessário identificar qual configuração de calendário é relevante para o endereço postal de um determinado cliente. Esse serviço retorna a configuração country_code > apropriada para um determinado endereço postal. |
| Obter informações do dia |
Obtenha informações detalhadas sobre um dia específico. |
Adicionar dias de fim de semana
Adicione dias de fim de semana a uma determinada data.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código do país
|
country_code | True | string |
O código do país ISO (2 letras). |
|
Data de início
|
start_date | True | string |
A data de início (YYYY-MM-DD) |
|
Incremento
|
increment | True | string |
O número de dias de fim de semana que você deseja adicionar à data de início (inteiro positivo ou negativo, mas não zero). |
|
Incluir início
|
include_start | True | boolean |
A contagem deve incluir o start_date? O valor padrão é verdadeiro. |
|
Configuração
|
configuration | string |
O nome da configuração de predefinição regional. Consulte a documentação para obter mais informações. |
|
|
Fim de semana
|
weekend | string |
Sua estrutura de fim de semana. Domingo-segunda-segunda-terça-quarta-quarta-quinta-sexta-feira-sábado. Se o fim de semana para você for domingo e segunda-feira, você poderá enviar: 1100000 Se o fim de semana for sábado à tarde e domingo: 1000003 |
|
|
Horários da semana
|
week_times | string |
Sua estrutura de agendamento de trabalho da semana. Esse parâmetro é útil ao calcular horas de trabalho durante um período. Quando usado, esse parâmetro substitui o parâmetro week_hours. |
|
|
Iniciar modelo
|
start_template | string |
A data de início de um modelo de semana alternada (YYYY-MM-DD) Se você definir um agendamento de modelo de semana alternado, precisará informar qual domingo o modelo está sendo iniciado. |
|
|
Usar configuração personalizada
|
use_custom_configuration | boolean |
Leve em conta sua própria configuração pessoal. |
|
|
ID do perfil
|
profile_id | string |
Se você criou vários perfis em sua configuração personalizada, a ID do perfil a ser usado. 6 caracteres. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data de término |
|
Todo o total
|
result.days.total | string |
Total de dias dentro do período |
|
Todas as segundas-feiras
|
result.days.mondays | string |
Segundas-feiras dentro do período |
|
Todas as terças-feiras
|
result.days.tuesdays | string |
Terças-feiras dentro do período |
|
Todas as quartas-feiras
|
result.days.wednesdays | string |
Quartas-feiras dentro do período |
|
Todas as quintas-feiras
|
result.days.thursdays | string |
Quintas-feiras dentro do período |
|
Todas as sextas-feiras
|
result.days.fridays | string |
Sextas-feiras dentro do período |
|
Todos os sábados
|
result.days.saturdays | string |
Sábados dentro do período |
|
Todos os domingos
|
result.days.sundays | string |
Domingos dentro do período |
|
Todas as horas
|
result.days.hours | string |
Horas dentro do período |
|
Todo o total de trabalho
|
result.working_days.total | string |
Total de dias úteis dentro do período |
|
Todas as segundas-feiras de trabalho
|
result.working_days.mondays | string |
Trabalhar segundas-feiras dentro do período |
|
Todas as terças-feiras de trabalho
|
result.working_days.tuesdays | string |
Terças-feiras de trabalho dentro do período |
|
Todas as quartas-feiras de trabalho
|
result.working_days.wednesdays | string |
Quartas-feiras de trabalho dentro do período |
|
Todas as quintas-feiras em funcionamento
|
result.working_days.thursdays | string |
Quintas-feiras de trabalho dentro do período |
|
Todas as sextas-feiras de trabalho
|
result.working_days.fridays | string |
Sextas-feiras de trabalho dentro do período |
|
Todos os sábados de trabalho
|
result.working_days.saturdays | string |
Trabalhar aos sábados dentro do período |
|
Todos os domingos de trabalho
|
result.working_days.sundays | string |
Trabalhar aos domingos dentro do período |
|
Todas as horas de trabalho
|
result.working_days.work_hours | string |
Horas de trabalho dentro do período |
|
Todos os salários
|
result.working_days.wages | string |
Salários dentro do período |
|
Total de dias de fim de semana
|
result.weekend_days.total | string |
Total de dias de fim de semana dentro do período |
|
Todos os dias de fim de semana às segundas-feiras
|
result.weekend_days.mondays | string |
Dias de fim de semana que ocorrem às segundas-feiras dentro do período |
|
Todos os dias de fim de semana às terças-feiras
|
result.weekend_days.tuesdays | string |
Dias de fim de semana que ocorrem às terças-feiras dentro do período |
|
Todos os dias de fim de semana às quartas-feiras
|
result.weekend_days.wednesdays | string |
Dias de fim de semana que ocorrem às quartas-feiras dentro do período |
|
Todos os dias de fim de semana às quintas-feiras
|
result.weekend_days.thursdays | string |
Dias de fim de semana que ocorrem às quintas-feiras dentro do período |
|
Todos os dias de fim de semana às sextas-feiras
|
result.weekend_days.fridays | string |
Dias de fim de semana que ocorrem às sextas-feiras dentro do período |
|
Todos os dias de fim de semana aos sábados
|
result.weekend_days.saturdays | string |
Dias de fim de semana que ocorrem aos sábados dentro do período |
|
Todos os dias de fim de semana aos domingos
|
result.weekend_days.sundays | string |
Dias de fim de semana que ocorrem aos domingos dentro do período |
|
Feriados
|
result.public_holidays | object |
Lista de feriados |
Adicionar dias úteis
Adicione (ou remova) qualquer número de dias úteis a uma data.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código do país
|
country_code | True | string |
O código do país ISO (2 letras). |
|
Data de início
|
start_date | True | string |
A data de início (YYYY-MM-DD) |
|
Incremento
|
increment | True | string |
O número de dias úteis que você deseja adicionar à data de início (inteiro positivo ou negativo, mas não zero). |
|
Incluir início
|
include_start | True | boolean |
A contagem deve incluir o start_date? O valor padrão é verdadeiro. |
|
Configuração
|
configuration | string |
O nome da configuração de predefinição regional. Consulte a documentação para obter mais informações. |
|
|
Fim de semana
|
weekend | string |
Sua estrutura de fim de semana. Domingo-segunda-segunda-terça-quarta-quarta-quinta-sexta-feira-sábado. Se o fim de semana para você for domingo e segunda-feira, você poderá enviar: 1100000 Se o fim de semana for sábado à tarde e domingo: 1000003 |
|
|
Horários da semana
|
week_times | string |
Sua estrutura de agendamento de trabalho da semana. Esse parâmetro é útil ao calcular horas de trabalho durante um período. Quando usado, esse parâmetro substitui o parâmetro week_hours. |
|
|
Iniciar modelo
|
start_template | string |
A data de início de um modelo de semana alternada (YYYY-MM-DD) Se você definir um agendamento de modelo de semana alternado, precisará informar qual domingo o modelo está sendo iniciado. |
|
|
Usar configuração personalizada
|
use_custom_configuration | boolean |
Leve em conta sua própria configuração pessoal. |
|
|
ID do perfil
|
profile_id | string |
Se você criou vários perfis em sua configuração personalizada, a ID do perfil a ser usado. 6 caracteres. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data de término |
|
Todo o total
|
result.days.total | string |
Total de dias dentro do período |
|
Todas as segundas-feiras
|
result.days.mondays | string |
Segundas-feiras dentro do período |
|
Todas as terças-feiras
|
result.days.tuesdays | string |
Terças-feiras dentro do período |
|
Todas as quartas-feiras
|
result.days.wednesdays | string |
Quartas-feiras dentro do período |
|
Todas as quintas-feiras
|
result.days.thursdays | string |
Quintas-feiras dentro do período |
|
Todas as sextas-feiras
|
result.days.fridays | string |
Sextas-feiras dentro do período |
|
Todos os sábados
|
result.days.saturdays | string |
Sábados dentro do período |
|
Todos os domingos
|
result.days.sundays | string |
Domingos dentro do período |
|
Todas as horas
|
result.days.hours | string |
Horas dentro do período |
|
Todo o total de trabalho
|
result.working_days.total | string |
Total de dias úteis dentro do período |
|
Todas as segundas-feiras de trabalho
|
result.working_days.mondays | string |
Trabalhar segundas-feiras dentro do período |
|
Todas as terças-feiras de trabalho
|
result.working_days.tuesdays | string |
Terças-feiras de trabalho dentro do período |
|
Todas as quartas-feiras de trabalho
|
result.working_days.wednesdays | string |
Quartas-feiras de trabalho dentro do período |
|
Todas as quintas-feiras em funcionamento
|
result.working_days.thursdays | string |
Quintas-feiras de trabalho dentro do período |
|
Todas as sextas-feiras de trabalho
|
result.working_days.fridays | string |
Sextas-feiras de trabalho dentro do período |
|
Todos os sábados de trabalho
|
result.working_days.saturdays | string |
Trabalhar aos sábados dentro do período |
|
Todos os domingos de trabalho
|
result.working_days.sundays | string |
Trabalhar aos domingos dentro do período |
|
Todas as horas de trabalho
|
result.working_days.work_hours | string |
Horas de trabalho dentro do período |
|
Todos os salários
|
result.working_days.wages | string |
Salários dentro do período |
|
Total de dias de fim de semana
|
result.weekend_days.total | string |
Total de dias de fim de semana dentro do período |
|
Todos os dias de fim de semana às segundas-feiras
|
result.weekend_days.mondays | string |
Dias de fim de semana que ocorrem às segundas-feiras dentro do período |
|
Todos os dias de fim de semana às terças-feiras
|
result.weekend_days.tuesdays | string |
Dias de fim de semana que ocorrem às terças-feiras dentro do período |
|
Todos os dias de fim de semana às quartas-feiras
|
result.weekend_days.wednesdays | string |
Dias de fim de semana que ocorrem às quartas-feiras dentro do período |
|
Todos os dias de fim de semana às quintas-feiras
|
result.weekend_days.thursdays | string |
Dias de fim de semana que ocorrem às quintas-feiras dentro do período |
|
Todos os dias de fim de semana às sextas-feiras
|
result.weekend_days.fridays | string |
Dias de fim de semana que ocorrem às sextas-feiras dentro do período |
|
Todos os dias de fim de semana aos sábados
|
result.weekend_days.saturdays | string |
Dias de fim de semana que ocorrem aos sábados dentro do período |
|
Todos os dias de fim de semana aos domingos
|
result.weekend_days.sundays | string |
Dias de fim de semana que ocorrem aos domingos dentro do período |
|
Feriados
|
result.public_holidays | object |
Lista de feriados |
Adicionar feriados
Adicione dias em que feriados públicos estão ocorrendo a uma determinada data.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código do país
|
country_code | True | string |
O código do país ISO (2 letras). |
|
Data de início
|
start_date | True | string |
A data de início (YYYY-MM-DD) |
|
Incremento
|
increment | True | string |
O número de dias sendo feriados que você deseja adicionar à data de início (inteiro positivo ou negativo, mas não zero). |
|
Incluir início
|
include_start | True | boolean |
A contagem deve incluir o start_date? O valor padrão é verdadeiro. |
|
Configuração
|
configuration | string |
O nome da configuração de predefinição regional. Consulte a documentação para obter mais informações. |
|
|
Fim de semana
|
weekend | string |
Sua estrutura de fim de semana. Domingo-segunda-segunda-terça-quarta-quarta-quinta-sexta-feira-sábado. Se o fim de semana para você for domingo e segunda-feira, você poderá enviar: 1100000 Se o fim de semana for sábado à tarde e domingo: 1000003 |
|
|
Horários da semana
|
week_times | string |
Sua estrutura de agendamento de trabalho da semana. Esse parâmetro é útil ao calcular horas de trabalho durante um período. Quando usado, esse parâmetro substitui o parâmetro week_hours. |
|
|
Iniciar modelo
|
start_template | string |
A data de início de um modelo de semana alternada (YYYY-MM-DD) Se você definir um agendamento de modelo de semana alternado, precisará informar qual domingo o modelo está sendo iniciado. |
|
|
Usar configuração personalizada
|
use_custom_configuration | boolean |
Leve em conta sua própria configuração pessoal. |
|
|
ID do perfil
|
profile_id | string |
Se você criou vários perfis em sua configuração personalizada, a ID do perfil a ser usado. 6 caracteres. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data de término |
|
Todo o total
|
result.days.total | string |
Total de dias dentro do período |
|
Todas as segundas-feiras
|
result.days.mondays | string |
Segundas-feiras dentro do período |
|
Todas as terças-feiras
|
result.days.tuesdays | string |
Terças-feiras dentro do período |
|
Todas as quartas-feiras
|
result.days.wednesdays | string |
Quartas-feiras dentro do período |
|
Todas as quintas-feiras
|
result.days.thursdays | string |
Quintas-feiras dentro do período |
|
Todas as sextas-feiras
|
result.days.fridays | string |
Sextas-feiras dentro do período |
|
Todos os sábados
|
result.days.saturdays | string |
Sábados dentro do período |
|
Todos os domingos
|
result.days.sundays | string |
Domingos dentro do período |
|
Todas as horas
|
result.days.hours | string |
Horas dentro do período |
|
Todo o total de trabalho
|
result.working_days.total | string |
Total de dias úteis dentro do período |
|
Todas as segundas-feiras de trabalho
|
result.working_days.mondays | string |
Trabalhar segundas-feiras dentro do período |
|
Todas as terças-feiras de trabalho
|
result.working_days.tuesdays | string |
Terças-feiras de trabalho dentro do período |
|
Todas as quartas-feiras de trabalho
|
result.working_days.wednesdays | string |
Quartas-feiras de trabalho dentro do período |
|
Todas as quintas-feiras em funcionamento
|
result.working_days.thursdays | string |
Quintas-feiras de trabalho dentro do período |
|
Todas as sextas-feiras de trabalho
|
result.working_days.fridays | string |
Sextas-feiras de trabalho dentro do período |
|
Todos os sábados de trabalho
|
result.working_days.saturdays | string |
Trabalhar aos sábados dentro do período |
|
Todos os domingos de trabalho
|
result.working_days.sundays | string |
Trabalhar aos domingos dentro do período |
|
Todas as horas de trabalho
|
result.working_days.work_hours | string |
Horas de trabalho dentro do período |
|
Todos os salários
|
result.working_days.wages | string |
Salários dentro do período |
|
Total de dias de fim de semana
|
result.weekend_days.total | string |
Total de dias de fim de semana dentro do período |
|
Todos os dias de fim de semana às segundas-feiras
|
result.weekend_days.mondays | string |
Dias de fim de semana que ocorrem às segundas-feiras dentro do período |
|
Todos os dias de fim de semana às terças-feiras
|
result.weekend_days.tuesdays | string |
Dias de fim de semana que ocorrem às terças-feiras dentro do período |
|
Todos os dias de fim de semana às quartas-feiras
|
result.weekend_days.wednesdays | string |
Dias de fim de semana que ocorrem às quartas-feiras dentro do período |
|
Todos os dias de fim de semana às quintas-feiras
|
result.weekend_days.thursdays | string |
Dias de fim de semana que ocorrem às quintas-feiras dentro do período |
|
Todos os dias de fim de semana às sextas-feiras
|
result.weekend_days.fridays | string |
Dias de fim de semana que ocorrem às sextas-feiras dentro do período |
|
Todos os dias de fim de semana aos sábados
|
result.weekend_days.saturdays | string |
Dias de fim de semana que ocorrem aos sábados dentro do período |
|
Todos os dias de fim de semana aos domingos
|
result.weekend_days.sundays | string |
Dias de fim de semana que ocorrem aos domingos dentro do período |
|
Feriados
|
result.public_holidays | object |
Lista de feriados |
Adicionar horas de trabalho
Adicione uma quantidade de tempo de trabalho a uma determinada data/hora de início.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código do país
|
country_code | True | string |
O código do país ISO (2 letras). |
|
Data de início
|
start_date | True | string |
A data de início (YYYY-MM-DD) |
|
Hora de início
|
start_time | True | string |
A hora de início (HH:MM) |
|
Tempo de incremento
|
increment_time | True | string |
A quantidade de tempo de trabalho a ser adicionado (ou removido) à data de início. Formato: H:i |
|
Configuração
|
configuration | string |
O nome da configuração de predefinição regional. Consulte a documentação para obter mais informações. |
|
|
Fim de semana
|
weekend | string |
Sua estrutura de fim de semana. Domingo-segunda-segunda-terça-quarta-quarta-quinta-sexta-feira-sábado. Se o fim de semana para você for domingo e segunda-feira, você poderá enviar: 1100000 Se o fim de semana for sábado à tarde e domingo: 1000003 |
|
|
Horários da semana
|
week_times | string |
Sua estrutura de agendamento de trabalho da semana. Esse parâmetro é útil ao calcular horas de trabalho durante um período. Quando usado, esse parâmetro substitui o parâmetro week_hours. |
|
|
Iniciar modelo
|
start_template | string |
A data de início de um modelo de semana alternada (YYYY-MM-DD) Se você definir um agendamento de modelo de semana alternado, precisará informar qual domingo o modelo está sendo iniciado. |
|
|
Usar configuração personalizada
|
use_custom_configuration | boolean |
Leve em conta sua própria configuração pessoal. |
|
|
ID do perfil
|
profile_id | string |
Se você criou vários perfis em sua configuração personalizada, a ID do perfil a ser usado. 6 caracteres. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Data de término
|
result.end_date | string |
Data de término calculada. |
|
Hora de término
|
result.end_time | string |
Hora de término calculada. |
Analyze
Analisar um período (fornecer um start_date e um end_date em um determinado calendário, a API responde com a análise de período).
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código do país
|
country_code | True | string |
O código do país ISO (2 letras). |
|
Data de início
|
start_date | True | string |
A data de início (YYYY-MM-DD) |
|
Data de término
|
end_date | True | string |
A data de término (YYYY-MM-DD) |
|
Hora de início
|
start_time | string |
A hora de início (HH:MM) |
|
|
Hora de término
|
end_time | string |
A hora de término (HH:MM) |
|
|
Configuração
|
configuration | string |
O nome da configuração de predefinição regional. Consulte a documentação para obter mais informações. |
|
|
Fim de semana
|
weekend | string |
Sua estrutura de fim de semana. Domingo-segunda-segunda-terça-quarta-quarta-quinta-sexta-feira-sábado. Se o fim de semana para você for domingo e segunda-feira, você poderá enviar: 1100000 Se o fim de semana for sábado à tarde e domingo: 1000003 |
|
|
Horários da semana
|
week_times | string |
Sua estrutura de agendamento de trabalho da semana. Esse parâmetro é útil ao calcular horas de trabalho durante um período. Quando usado, esse parâmetro substitui o parâmetro week_hours. |
|
|
Iniciar modelo
|
start_template | string |
A data de início de um modelo de semana alternada (YYYY-MM-DD) Se você definir um agendamento de modelo de semana alternado, precisará informar qual domingo o modelo está sendo iniciado. |
|
|
Usar configuração personalizada
|
use_custom_configuration | boolean |
Leve em conta sua própria configuração pessoal. |
|
|
ID do perfil
|
profile_id | string |
Se você criou vários perfis em sua configuração personalizada, a ID do perfil a ser usado. 6 caracteres. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
end_date
|
result.end_date | string |
Data de término |
|
Todo o total
|
result.days.total | string |
Total de dias dentro do período |
|
Todas as segundas-feiras
|
result.days.mondays | string |
Segundas-feiras dentro do período |
|
Todas as terças-feiras
|
result.days.tuesdays | string |
Terças-feiras dentro do período |
|
Todas as quartas-feiras
|
result.days.wednesdays | string |
Quartas-feiras dentro do período |
|
Todas as quintas-feiras
|
result.days.thursdays | string |
Quintas-feiras dentro do período |
|
Todas as sextas-feiras
|
result.days.fridays | string |
Sextas-feiras dentro do período |
|
Todos os sábados
|
result.days.saturdays | string |
Sábados dentro do período |
|
Todos os domingos
|
result.days.sundays | string |
Domingos dentro do período |
|
Todas as horas
|
result.days.hours | string |
Horas dentro do período |
|
Todo o total de trabalho
|
result.working_days.total | string |
Total de dias úteis dentro do período |
|
Todas as segundas-feiras de trabalho
|
result.working_days.mondays | string |
Trabalhar segundas-feiras dentro do período |
|
Todas as terças-feiras de trabalho
|
result.working_days.tuesdays | string |
Terças-feiras de trabalho dentro do período |
|
Todas as quartas-feiras de trabalho
|
result.working_days.wednesdays | string |
Quartas-feiras de trabalho dentro do período |
|
Todas as quintas-feiras em funcionamento
|
result.working_days.thursdays | string |
Quintas-feiras de trabalho dentro do período |
|
Todas as sextas-feiras de trabalho
|
result.working_days.fridays | string |
Sextas-feiras de trabalho dentro do período |
|
Todos os sábados de trabalho
|
result.working_days.saturdays | string |
Trabalhar aos sábados dentro do período |
|
Todos os domingos de trabalho
|
result.working_days.sundays | string |
Trabalhar aos domingos dentro do período |
|
Todas as horas de trabalho
|
result.working_days.work_hours | string |
Horas de trabalho dentro do período |
|
Todos os salários
|
result.working_days.wages | string |
Salários dentro do período |
|
Total de dias de fim de semana
|
result.weekend_days.total | string |
Total de dias de fim de semana dentro do período |
|
Todos os dias de fim de semana às segundas-feiras
|
result.weekend_days.mondays | string |
Dias de fim de semana que ocorrem às segundas-feiras dentro do período |
|
Todos os dias de fim de semana às terças-feiras
|
result.weekend_days.tuesdays | string |
Dias de fim de semana que ocorrem às terças-feiras dentro do período |
|
Todos os dias de fim de semana às quartas-feiras
|
result.weekend_days.wednesdays | string |
Dias de fim de semana que ocorrem às quartas-feiras dentro do período |
|
Todos os dias de fim de semana às quintas-feiras
|
result.weekend_days.thursdays | string |
Dias de fim de semana que ocorrem às quintas-feiras dentro do período |
|
Todos os dias de fim de semana às sextas-feiras
|
result.weekend_days.fridays | string |
Dias de fim de semana que ocorrem às sextas-feiras dentro do período |
|
Todos os dias de fim de semana aos sábados
|
result.weekend_days.saturdays | string |
Dias de fim de semana que ocorrem aos sábados dentro do período |
|
Todos os dias de fim de semana aos domingos
|
result.weekend_days.sundays | string |
Dias de fim de semana que ocorrem aos domingos dentro do período |
|
Feriados
|
result.public_holidays | object |
Lista de feriados |
Cota de verificação
Verifique a cota de dias restantes a serem usados no mês atual e disponível para o próximo mês.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Estado
|
result.state | string |
O estado do seu plano (1:active, 2:cancelled, -1:error). |
|
Atual
|
result.current | string |
Cota atual (dias a serem analisados neste mês). |
|
Next
|
result.next | string |
Cota disponível para o próximo mês. |
Listar dias não úteis
Liste os dias não úteis (dias de fim de semana, feriados públicos e datas personalizadas) entre duas datas.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código do país
|
country_code | True | string |
O código do país ISO (2 letras). |
|
Data de início
|
start_date | True | string |
A data de início (YYYY-MM-DD) |
|
Data de término
|
end_date | True | string |
A data de término (YYYY-MM-DD) |
|
Configuração
|
configuration | string |
O nome da configuração de predefinição regional. Consulte a documentação para obter mais informações. |
|
|
Fim de semana
|
weekend | string |
Sua estrutura de fim de semana. Domingo-segunda-segunda-terça-quarta-quarta-quinta-sexta-feira-sábado. Se o fim de semana para você for domingo e segunda-feira, você poderá enviar: 1100000 Se o fim de semana for sábado à tarde e domingo: 1000003 |
|
|
Usar configuração personalizada
|
use_custom_configuration | boolean |
Leve em conta sua própria configuração pessoal. |
|
|
ID do perfil
|
profile_id | string |
Se você criou vários perfis em sua configuração personalizada, a ID do perfil a ser usado. 6 caracteres. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dias não úteis
|
result.non_working_days | object |
Lista de dias não úteis. |
Localizando um endereço postal
Às vezes, pode ser necessário identificar qual configuração de calendário é relevante para o endereço postal de um determinado cliente. Esse serviço retorna a configuração country_code > apropriada para um determinado endereço postal.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Endereço
|
address | True | string |
O endereço postal. É uma cadeia de caracteres sem restrição. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Situação
|
result.status | string |
Status do endereço |
|
Código do país
|
result.country_code | string |
Código do país ISO. |
|
Configuração
|
result.configuration | string |
Endereçar informações adicionais. |
|
Endereço formatado
|
result.formatted_address | string |
Endereço formatado retornado. |
Obter informações do dia
Obtenha informações detalhadas sobre um dia específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Código do país
|
country_code | True | string |
O código do país ISO (2 letras). |
|
Date
|
date | True | string |
A data a ser analisada (YYYY-MM-DD) |
|
Configuração
|
configuration | string |
O nome da configuração de predefinição regional. Consulte a documentação para obter mais informações. |
|
|
Fim de semana
|
weekend | string |
Sua estrutura de fim de semana. Domingo-segunda-segunda-terça-quarta-quarta-quinta-sexta-feira-sábado. Se o fim de semana para você for domingo e segunda-feira, você poderá enviar: 1100000 Se o fim de semana for sábado à tarde e domingo: 1000003 |
|
|
Usar configuração personalizada
|
use_custom_configuration | boolean |
Leve em conta sua própria configuração pessoal. |
|
|
ID do perfil
|
profile_id | string |
Se você criou vários perfis em sua configuração personalizada, a ID do perfil a ser usado. 6 caracteres. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Dia útil
|
result.working_day | string |
Este é um dia útil (0 significa não). |
|
Horas de trabalho
|
result.work_hours | string |
Número de horas de trabalho naquele dia. |
|
Salário
|
result.wages | string |
Salário |
|
Início da manhã
|
result.morning_start | string |
Hora em que a manhã começa |
|
Fim da manhã
|
result.morning_end | string |
Hora em que a manhã termina |
|
Início da tarde
|
result.afternoon_start | string |
Hora em que a tarde começa |
|
Fim da tarde
|
result.afternoon_end | string |
Hora em que a tarde termina |
|
Feriado
|
result.public_holiday | string |
Este é um feriado (0 significa não). |
|
Descrição do feriado
|
result.public_holiday_description | string |
Descrição deste feriado |
|
Dia do fim de semana
|
result.weekend_day | string |
É um dia de fim de semana (0 significa não). |
|
Data personalizada
|
result.custom_date | string |
Essa é uma data personalizada (0 significa não). |
|
Descrição da data personalizada
|
result.custom_date_description | string |
Descrição dessa data personalizada. |
|
Cor da data personalizada
|
result.custom_date_color | string |
Cor definida para esta data personalizada. |