GSA Per Diem (Editor Independente)
As taxas por diem são as taxas de reembolso permitidas para estadias em hotéis e refeições para viajantes federais. As taxas são definidas para cada um dos anos fiscais do governo federal (de 1º de outubro a 30 de setembro) A GSA é responsável por definir as taxas nos Estados Unidos continentais. Muitas empresas e outras organizações também adotam essas taxas. Essa API fornece acesso às informações de taxa atuais.
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: - China Cloud operado pela 21Vianet |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Richard Wilson |
| URL | https://www.richardawilson.com/ |
| richard.a.wilson@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Richard Wilson |
| Site | https://open.gsa.gov/api/perdiem/ |
| Política de privacidade | https://www.gsa.gov/technology/government-it-initiatives/digital-strategy/terms-of-service-for-developer-resources |
| Categorias | Comércio; Financiar |
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 |
|---|---|---|---|
| Chave de API GSA | secureString | A chave de API GSA que pode ser obtida de https://open.gsa.gov/api/perdiem | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Mapeamento de CEP para Destination-IDs e locais de estado |
Fornece um mapeamento de CEP para seus Destination-IDs e locais de estado correspondentes para um determinado ano fiscal. |
| Obter taxas por diem para todos os condados e cidades, por estado e ano |
Fornece taxas por diem para todos os condados e cidades dentro de um estado especificado para um determinado ano fiscal. Isso é útil para os usuários que exigem uma visão abrangente das taxas em todo um estado. |
| Obter taxas por diem por CEP e ano |
Busca taxas por diem com base no CEP e no ano fiscal. Esse ponto de extremidade é particularmente útil para usuários que desejam encontrar rapidamente taxas em uma área geográfica específica identificada pelo CEP. |
| Obter taxas por diem por cidade, estado e ano |
Recupera as taxas por diem para uma cidade, estado e ano fiscal especificados. Esse ponto de extremidade é ideal para usuários que precisam de informações detalhadas por taxa de diem para combinações específicas de cidade e estado. |
| Taxas de hospedagem para os EUA continentais por ano |
Oferece informações detalhadas sobre a taxa de hospedagem para vários locais nos Estados Unidos Continentais para o ano fiscal especificado. |
Mapeamento de CEP para Destination-IDs e locais de estado
Fornece um mapeamento de CEP para seus Destination-IDs e locais de estado correspondentes para um determinado ano fiscal.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ano
|
year | True | string |
Insira o ano fiscal pelo qual filtrar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Zip
|
Zip | string |
O CEP associado à ID e ao estado de destino. |
|
ID de destino
|
DID | string |
A ID de destino correspondente ao CEP. |
|
Estado
|
ST | string |
A abreviação de estado associada ao CEP. |
Obter taxas por diem para todos os condados e cidades, por estado e ano
Fornece taxas por diem para todos os condados e cidades dentro de um estado especificado para um determinado ano fiscal. Isso é útil para os usuários que exigem uma visão abrangente das taxas em todo um estado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Abreviação de Estado
|
state | True | string |
Insira a abreviação de duas letras do estado. |
|
Ano
|
year | True | string |
Insira o ano fiscal pelo qual filtrar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Solicitação
|
request | string |
Identifica a solicitação feita à API. |
|
Errors
|
errors | string |
Contém todos os erros encontrados durante a solicitação. |
|
Taxas
|
rates | array of object |
Uma matriz de informações de taxa por diem para todos os condados e cidades dentro do estado e do ano especificados. |
|
Informações do Oconus
|
rates.oconusInfo | string |
Fornece informações específicas para locais fora dos Estados Unidos continentais. |
|
Rate
|
rates.rate | array of object |
Contém informações detalhadas de taxa para cada mês. |
|
Mês
|
rates.rate.months.month | array of object |
Lista meses individuais com detalhes de taxa correspondentes. |
|
Value
|
rates.rate.months.month.value | integer |
O valor numérico que representa o mês. |
|
Número
|
rates.rate.months.month.number | integer |
A ordem numérica do mês no ano. |
|
Curto
|
rates.rate.months.month.short | string |
Representação de formulário curto do nome do mês. |
|
Long
|
rates.rate.months.month.long | string |
Nome completo do mês. |
|
Refeições
|
rates.rate.meals | integer |
A taxa de refeição por diem. |
|
Zip
|
rates.rate.zip | string |
O CEP do local. |
|
Município
|
rates.rate.county | string |
O nome do condado do local. |
|
City
|
rates.rate.city | string |
O nome da cidade do local. |
|
Taxa Padrão
|
rates.rate.standardRate | string |
A taxa de hospedagem padrão para o local. |
|
Estado
|
rates.state | string |
O nome do estado correspondente às taxas. |
|
Ano
|
rates.year | integer |
O ano fiscal para o qual as taxas são aplicáveis. |
|
É Oconus
|
rates.isOconus | string |
Indica se o local está fora dos Estados Unidos Continentais. |
|
Versão
|
version | string |
Indica a versão da API para os dados retornados. |
Obter taxas por diem por CEP e ano
Busca taxas por diem com base no CEP e no ano fiscal. Esse ponto de extremidade é particularmente útil para usuários que desejam encontrar rapidamente taxas em uma área geográfica específica identificada pelo CEP.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Zip
|
zip | True | integer |
Insira o CEP pelo qual filtrar. |
|
Ano
|
year | True | string |
Insira o ano fiscal pelo qual filtrar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Solicitação
|
request | string |
Identifica a solicitação feita à API. |
|
Errors
|
errors | string |
Contém todos os erros encontrados durante a solicitação. |
|
Taxas
|
rates | array of object |
Uma matriz de informações de taxa por diem com base no CEP especificado e no ano fiscal. |
|
Informações do Oconus
|
rates.oconusInfo | string |
Fornece informações específicas para locais fora dos Estados Unidos continentais. |
|
Rate
|
rates.rate | array of object |
Contém informações detalhadas de taxa para cada mês. |
|
Mês
|
rates.rate.months.month | array of object |
Lista meses individuais com detalhes de taxa correspondentes. |
|
Value
|
rates.rate.months.month.value | integer |
O valor numérico que representa o mês. |
|
Número
|
rates.rate.months.month.number | integer |
A ordem numérica do mês no ano. |
|
Curto
|
rates.rate.months.month.short | string |
Representação de formulário curto do nome do mês. |
|
Long
|
rates.rate.months.month.long | string |
Nome completo do mês. |
|
Refeições
|
rates.rate.meals | integer |
A taxa de refeição por diem. |
|
Zip
|
rates.rate.zip | string |
O CEP do local. |
|
Município
|
rates.rate.county | string |
O nome do condado do local. |
|
City
|
rates.rate.city | string |
O nome da cidade do local. |
|
Taxa Padrão
|
rates.rate.standardRate | string |
A taxa de hospedagem padrão para o local. |
|
Estado
|
rates.state | string |
O nome do estado correspondente às taxas. |
|
Ano
|
rates.year | integer |
O ano fiscal para o qual as taxas são aplicáveis. |
|
É Oconus
|
rates.isOconus | string |
Indica se o local está fora dos Estados Unidos Continentais. |
|
Versão
|
version | string |
Indica a versão da API para os dados retornados. |
Obter taxas por diem por cidade, estado e ano
Recupera as taxas por diem para uma cidade, estado e ano fiscal especificados. Esse ponto de extremidade é ideal para usuários que precisam de informações detalhadas por taxa de diem para combinações específicas de cidade e estado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
City
|
city | True | string |
Insira a cidade pela qual filtrar. |
|
Abreviação de Estado
|
state | True | string |
Insira a abreviação de duas letras do estado. |
|
Ano
|
year | True | string |
Insira o ano fiscal pelo qual filtrar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Solicitação
|
request | string |
Identifica a solicitação feita à API. |
|
Errors
|
errors | string |
Contém todos os erros encontrados durante a solicitação. |
|
Taxas
|
rates | array of object |
Uma matriz de informações de taxa por diem para o local e o ano especificados. |
|
Informações do Oconus
|
rates.oconusInfo | string |
Fornece informações específicas para locais fora dos Estados Unidos continentais. |
|
Rate
|
rates.rate | array of object |
Contém informações detalhadas de taxa para cada mês. |
|
Mês
|
rates.rate.months.month | array of object |
Lista meses individuais com detalhes de taxa correspondentes. |
|
Value
|
rates.rate.months.month.value | integer |
O valor numérico que representa o mês. |
|
Número
|
rates.rate.months.month.number | integer |
A ordem numérica do mês no ano. |
|
Curto
|
rates.rate.months.month.short | string |
Representação de formulário curto do nome do mês. |
|
Long
|
rates.rate.months.month.long | string |
Nome completo do mês. |
|
Refeições
|
rates.rate.meals | integer |
A taxa de refeição por diem. |
|
Zip
|
rates.rate.zip | string |
O CEP do local. |
|
Município
|
rates.rate.county | string |
O nome do condado do local. |
|
City
|
rates.rate.city | string |
O nome da cidade do local. |
|
Taxa Padrão
|
rates.rate.standardRate | string |
A taxa de hospedagem padrão para o local. |
|
Estado
|
rates.state | string |
O nome do estado correspondente às taxas. |
|
Ano
|
rates.year | integer |
O ano fiscal para o qual as taxas são aplicáveis. |
|
É Oconus
|
rates.isOconus | string |
Indica se o local está fora dos Estados Unidos Continentais. |
|
Versão
|
version | string |
Indica a versão da API para os dados retornados. |
Taxas de hospedagem para os EUA continentais por ano
Oferece informações detalhadas sobre a taxa de hospedagem para vários locais nos Estados Unidos Continentais para o ano fiscal especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Ano
|
year | True | string |
Insira o ano fiscal pelo qual filtrar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
Janeiro
|
Jan | string |
Taxas de hospedagem para janeiro. |
|
Fevereiro
|
Feb | string |
Taxas de hospedagem para fevereiro. |
|
Março
|
Mar | string |
Taxas de hospedagem para março. |
|
Abril
|
Apr | string |
Taxas de hospedagem para abril. |
|
Maio
|
May | string |
Taxas de hospedagem para maio. |
|
Junho
|
Jun | string |
Taxas de hospedagem para junho. |
|
Julho
|
Jul | string |
Taxas de hospedagem para julho. |
|
Agosto
|
Aug | string |
Taxas de hospedagem para agosto. |
|
Setembro
|
Sep | string |
Taxas de hospedagem para setembro. |
|
Outubro
|
Oct | string |
Taxas de hospedagem para outubro. |
|
Novembro
|
Nov | string |
Taxas de hospedagem para novembro. |
|
Dezembro
|
Dec | string |
Taxas de hospedagem para dezembro. |
|
Refeições
|
Meals | string |
Taxas de refeição por diem para o ano inteiro. |
|
City
|
City | string |
A cidade para a qual as taxas são aplicáveis. |
|
Estado
|
State | string |
O estado correspondente às taxas de hospedagem. |
|
Município
|
County | string |
O condado correspondente às taxas de hospedagem. |
|
ID de destino
|
DID | string |
A ID de destino do local. |