API de serviço extra do WSD

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 12 min. de leitura

    • . Prestação de serviços no local de trabalho(WSD) Serviço extra A API fornece endpoints para recuperar serviços extras, como layouts de local e serviços padrão de um local de trabalho.

    Para acessar esta API, o solicitante deve ter a função sn_wsd_core.workplace_user.

    Esta API é executada no sn_wsd_rsv namespace. Para acessar esta API, o plug-in Gestão de reservas do local de trabalho (sn_wsd_rsv) deve ser ativado.

    Para obter informações adicionais sobre Gestão de reservas do local de trabalho, consulte Gestão de reservas do local de trabalho .

    Solicitação de serviço extra do WSD - PATCH /api/sn_wsd_rsv/wsd_extra_service_request/reservation/

    Retorna as solicitações de serviço extras associadas a uma única reserva.

    Nota:
    Este endpoint não funciona para reservas de grupo ou várias.

    Formato de URL

    URL com controle de versão: /api/sn_wsd_rsv//wsd_extra_service_request/reservation/

    URL padrão: /api/sn_wsd_rsv/wsd_extra_service_request/reservation/

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 1. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    sys_id Sys_id do registro de reserva para o qual retornar os detalhes extras da solicitação de serviço.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 3. Parâmetros do corpo da solicitação
    Nome Descrição
    Nenhum(a)

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 4. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 5. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 6. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. A reserva sys_id está ausente, é inválida ou não existe.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta

    Nome Descrição
    resultado Detalhes sobre a solicitação de serviço extra especificada.

    Tipo de dados: Objeto

    "result": {
  "reservableId": "String",
  "reservationId": "String",
  "serviceCategories": {Object},
  "serviceTimes": {Object}
}
    Result.reservableId
    Sys_id do local do local do local de trabalho em que a reserva foi criada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    Result.reservationId Sys_id da reserva para a qual retornar os detalhes extras da solicitação de serviço.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation].
    result.serviceCategories Detalhes sobre a categoria de serviço dos serviços extras associados.

    Tipo de dados: Objeto

    "serviceCategories": {
  "String": {
    "categoryFriendlyName": "String",
    "categoryCurrencyCode": "String",
    "comment": "String",
    "flexibleServices": [Array],
    "serviceTimes": {Object}
  }
}
    result.serviceCategories.categoryFriendly​Nome Nome amigável da categoria do serviço do local de trabalho ou serviço extra, como Organização de espaço.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.​CategoryCurrencyCode Código da moeda usado para calcular o custo do item de serviço do local de trabalho ou do serviço extra.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.comment
    Comentários sobre a categoria de serviço.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices Detalhes sobre cada um dos itens de serviço do local de trabalho ou serviço extra solicitado para a reserva.

    Tipo de dados: Matriz de objetos

    "flexibleServices": [
  {
    "capacity": Number,
    "capacityEnabled": Boolean,
    "category": "String",
    "categoryComment": "String",
    "categoryFriendlyName": "String",
    "comment": "String",
    "currencyCode": "String",
    "deliveryTime": "String",
    "flexibleServiceId": "String",
    "flexibleServiceName": "String",
    "maxCapacity": Number,
    "quantity": Number,
    "quantityEnabled": Boolean,
    "requestId": "String",
    "serviceItemImage": "String",
    "servicePrice": Number,
    "serviceTimes": {Object},
    "state": {Object},
    "subCategory": {Object},
    "totalPrice": Number,
  }
]
    result.serviceCategories.flexibleServices.​Capacidade Capacidade solicitada ao solicitar o item de serviço do local de trabalho.

    Tipo de dados: Número
    result.serviceCategories.flexibleServices.​CapacidadeHabilitado Sinalizador que indica se o usuário que está criando a reserva pode especificar a capacidade do local de trabalho.
    Valores possíveis:
    • Verdadeiro: O usuário pode especificar a capacidade.
    • Falso: O usuário não pode especificar a capacidade.

    Tipo de dados: Booliano
    result.serviceCategories.flexibleServices.​Categoria Sys_id da categoria do serviço do local de trabalho ou serviço extra associado à reserva.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​CategoryComentário Comentários adicionais sobre a categoria.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​CategoryFriendlyName Nome amigável da categoria do serviço do local de trabalho ou serviço extra, como Organização de espaço.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​Comentário
    Comentários adicionais sobre o item de serviço do local de trabalho ou serviço extra.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​CurrencyCode Código da moeda usado para calcular o custo do item de serviço do local de trabalho associado ou serviço extra.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​Tempo de entrega
    Tempo de entrega do item de serviço do local de trabalho ou serviço extra.

    Tipo de dados: Cadeia de caracteres

    Formato: UTC - aaaa-mm-ddThh:mm:ssZ, como 2021-02-05T18:00:00Z
    result.serviceCategories.flexibleServices.​FlexibleServiceId
    Sys_id do serviço extra ou item de serviço do local de trabalho.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item de serviço do local de trabalho [sn_wsd_case_workplace_service_item]
    result.serviceCategories.flexibleServices.​FlexibleServiceName Nome do serviço extra associado ou item de serviço do local de trabalho.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​MaxCapacity Capacidade máxima do local de trabalho que pode ser solicitada.

    Tipo de dados: Número
    result.serviceCategories.flexibleServices.​Quantidade
    Número de itens de serviço extras solicitados.

    Tipo de dados: Número
    result.serviceCategories.flexibleServices.​QuantityEnabled Sinalizador que indica se o usuário que está criando a reserva pode especificar a quantidade de itens de serviço.
    Valores possíveis:
    • Verdadeiro: O usuário pode especificar a quantidade.
    • Falso: O usuário não pode especificar a quantidade.

    Tipo de dados: Booliano
    ​RequestId result.serviceCategories.flexibleServices Sys_id do serviço extra ou item de serviço do local de trabalho.

    Tipo de dados: Cadeia de caracteres

    Solicitação de serviço [sn_wsd_case_service_item_request]
    result.serviceCategories.flexibleServices.​ServiceItemImage Nome do arquivo da imagem em miniatura do item de serviço do local de trabalho.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​ServicePrice Custo do item de serviço do local de trabalho ou serviço extra.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​ServiceTimes Detalhes sobre o tempo necessário para preparar e limpar o item de serviço do local de trabalho.

    Tipo de dados: Objeto

    "serviceTimes": {
  "endCleanup": "String",
  "endPreparation": "String",
  "startCleanup": "String",
  "startPreparation": "String"
}
    result.serviceCategories.flexibleServices.​ServiceTimes.endCleanup Data e hora em que a limpeza do item de serviço do local de trabalho terminará

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​ServiceTimes.endPreparation Data e hora em que a preparação do item de serviço do local de trabalho terminará

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​ServiceTimes.startCleanup Data e hora em que a limpeza do item de serviço do local de trabalho começará.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​ServiceTimes.startPreparation Data e hora em que a preparação do item de serviço do local de trabalho começará.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.state Detalhes sobre o estado atual do item de serviço do local de trabalho associado.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.serviceCategories.flexibleServices.state.​Display_value Valor de exibição do estado do item de serviço do local de trabalho, como Aberto.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.state.​Valor Valor interno do estado do item de serviço do local de trabalho, como Aberto.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​Subcategoria Detalhes sobre a subcategoria do item de serviço do local de trabalho associado.

    Tipo de dados: Objeto

    "subCategory": {
  "display_value": "String",
  "value": "String"
}
    result.serviceCategories.flexibleServices.​Subcategoria.display_value Valor de exibição da subcategoria do item de serviço do local de trabalho ou serviço extra, como layout da cadeira, bebidas ou suporte DE TI.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​Subcategoria.valor Valor interno da subcategoria do item de serviço do local de trabalho ou serviço extra, como chair_layout, drinks ou IT_support.

    Tipo de dados: Cadeia de caracteres
    result.serviceCategories.flexibleServices.​Total_price Custo total do item de serviço do local de trabalho ou serviço extra para a reserva.

    Tipo de dados: Número
    result.serviceTimes Detalhes sobre o tempo necessário para preparar e limpar o item de serviço do local de trabalho.

    Tipo de dados: Objeto

    "serviceTimes": {
  "endCleanup": "String",
  "endPreparation": "String",
  "startCleanup": "String",
  "startPreparation": "String"
}
    result.serviceTimes.endCleanup Data e hora em que a limpeza do item de serviço do local de trabalho terminará

    Tipo de dados: Cadeia de caracteres
    result.serviceTimes.endPreparation Data e hora em que a preparação do item de serviço do local de trabalho terminará

    Tipo de dados: Cadeia de caracteres
    result.serviceTimes.startCleanup Data e hora em que a limpeza do item de serviço do local de trabalho começará.

    Tipo de dados: Cadeia de caracteres
    result.serviceTimes.startPreparation Data e hora em que a preparação do item de serviço do local de trabalho começará.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    Este exemplo de código mostra como solicitar os detalhes dos serviços extras ou itens de serviço do local de trabalho para uma reserva.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/wsd_extra_service_request/reservation/383e36c1536f01103cf7ddeeff7b1245" \
--request GET \
--header "Accept:application/json" \
--user "username": "password"

    Resultados de retorno:

    {
  "result": {
    "reservationId": "383e36c1536f01103cf7ddeeff7b1245",
    "serviceTimes": {
      "startPreparation": "2022-05-17T11:45:00ZZ",
      "endPreparation": "2022-05-17T12:00:00ZZ",
      "startCleanup": "2022-05-17T13:00:00ZZ",
      "endCleanup": "2022-05-17T13:15:00ZZ"
    },
    "reservableId": "02000d4edb7650106c731dcd13961914",
    "serviceCategories": {
      "50723fbf07100110c9b36b6e0ad300b4": {
        "serviceTimes": {
          "startPreparation": "2022-05-17T11:45:00Z",
          "endPreparation": "2022-05-17T12:00:00Z",
          "startCleanup": "2022-05-17T13:00:00Z",
          "endCleanup": "2022-05-17T13:15:00Z"
        },
        "flexibleServices": [
          {
            "requestId": "743eb605536f01103cf7ddeeff7b126b",
            "category": "50723fbf07100110c9b36b6e0ad300b4",
            "categoryComment": "test2",
            "subCategory": {
              "value": "chair_layout",
              "display_value": "Chair layout"
            },
            "categoryFriendlyName": "Space arrangement",
            "servicePrice": 0,
            "serviceItemImage": "4c6a0d7107600110c9b36b6e0ad300fc.iix",
            "currencyCode": "GBP",
            "totalPrice": 0,
            "flexibleServiceId": "21e2c08407600110c9b36b6e0ad3007c",
            "flexibleServiceName": "Theater Style",
            "deliveryTime": "2022-05-17 12:00:00",
            "comment": "test1",
            "quantity": 1,
            "capacity": 1,
            "quantityEnabled": false,
            "capacityEnabled": true,
            "maxCapacity": null,
            "state": {
              "value": "2",
              "display_value": "Work in Progress"
            },
            "serviceTimes": {
              "startPreparation": "2022-05-17T11:45:00Z",
              "endPreparation": "2022-05-17T12:00:00Z",
              "startCleanup": "2022-05-17T13:00:00Z",
              "endCleanup": "2022-05-17T13:15:00Z"
            }
          }
        ],
        "comment": "test2",
        "categoryFriendlyName": "Space arrangement",
        "categoryCurrencyCode": "GBP"
      }
    }
  }
}

    Solicitação de serviço extra do WSD - PATCH /api/sn_wsd_rsv/wsd_extra_service_request/submit

    Adiciona uma nova solicitação de serviço ou atualiza uma solicitação de serviço extra existente a uma única reserva especificada.

    Nota:
    Este endpoint não funciona para reservas de grupo ou várias.

    Formato de URL

    URL com controle de versão: /api/sn_wsd_rsv//wsd_extra_service_request/submit

    URL padrão: /api/sn_wsd_rsv/wsv/wsd_extra_service_request/submit

    Nota:
    As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

    Parâmetros de solicitação compatíveis

    Tabela 7. Parâmetros de caminho
    Nome Descrição
    api_version Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente.

    Tipo de dados: Cadeia de caracteres
    Tabela 8. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 9. Parâmetros do corpo da solicitação
    Nome Descrição
    ReservationDateTimeChanged Sinalizador que indica se a data e a hora da reserva foram alteradas.
    Valores válidos:
    • Verdadeiro: A data e a hora da reserva foram alteradas.
    • Falso: A data e a hora da reserva não foram alteradas.

    Tipo de dados: Booliano

    Padrão: falso
    ReservableId Obrigatório.
    Sys_id do local do local do local de trabalho em que a reserva foi criada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    ReservationId Obrigatório. Sys_id da reserva para a qual adicionar as solicitações de serviço extras.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]
    ServiceCategories Obrigatório. Lista de itens de serviço do local de trabalho ou serviços extras a serem adicionados à reserva.

    Tipo de dados: Matriz de objetos

    "serviceCategories": [
  {
    "category": "String",
    "comment": "String",
    "flexibleServices": [Array]
  }
]
    serviceCategories.category Obrigatório. Sys_id ou nome do serviço do local de trabalho a ser adicionado à reserva.

    Tipo de dados: Cadeia de caracteres

    Tabela: Serviço do local de trabalho [sn_wsd_case_workplace_service]
    serviceCategories.comment Obrigatório.
    Comentários sobre a categoria de serviço.

    Tipo de dados: Cadeia de caracteres
    ServiceCategories.flexibleServices Obrigatório. Detalhes sobre cada um dos itens de serviço do local de trabalho ou serviço extra a ser adicionado ou cancelado da reserva.

    Tipo de dados: Matriz de objetos

    "flexibleServices": [
  {
    "cancelFlag": Boolean,
    "comment": "String",
    "deliveryTime": "String",
    "extraServiceRequestId": "String",
    "flexibleServiceId": "String",
    "quantity": Number
  }
]
    serviceCategories.flexibleServices.cancelFlag Sinalizador que indica se a solicitação de serviço extra especificada deve ser cancelada.
    Valores possíveis:
    • Verdadeiro: Exclua a solicitação de serviço extra associada.
    • Falso: Nenhuma operação.

    Tipo de dados: Booliano

    Padrão: falso
    serviceCategories.flexibleServices.comment Obrigatório.
    Comentários adicionais sobre o item de serviço do local de trabalho ou serviço extra.

    Tipo de dados: Cadeia de caracteres
    ServiceCategories.flexibleServices.​DeliveryTime Obrigatório.
    Tempo de entrega do item de serviço do local de trabalho ou serviço extra.

    Tipo de dados: Cadeia de caracteres

    Formato: UTC - aaaa-mm-ddThh:mm:ssZ, como 2021-02-05T18:00:00Z
    ServiceCategories.flexibleServices.​ExtraServiceRequestId Sys_id da solicitação de serviço extra existente. Forneça este parâmetro para atualizar uma solicitação de serviço extra existente.

    Tipo de dados: Cadeia de caracteres

    Solicitação de itens de serviço [sn_wsd_case_service_item_request]
    ServiceCategories.flexibleServices.​FlexibleServiceId Obrigatório. Sys_id do serviço extra ou item de serviço do local de trabalho.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item de serviço do local de trabalho [sn_wsd_case_workplace_service_item]
    ServiceCategories.flexibleServices.​Quantidade Obrigatório.
    Número de itens de serviço extras solicitados.

    Tipo de dados: Número

    Cabeçalhos

    Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

    Tabela 10. Cabeçalhos da solicitação
    Cabeçalho Descrição
    Aceitar Formato de dados do corpo da solicitação. Tipos compatíveis: application/json, application/xmlou, text/xml.

    Padrão: application/json
    Tipo de conteúdo Formato de dados do corpo da solicitação. Oferece suporte somente a application/json.
    Tabela 11. Cabeçalhos de resposta
    Cabeçalho Descrição
    Nenhum(a)

    Códigos de status

    Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

    Tabela 12. Códigos de status
    Código do status Descrição
    200 Bem-sucedido. A solicitação foi processada com sucesso.
    400 Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
    401 Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
    500 Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

    Parâmetros do corpo da resposta

    Nome Descrição
    resultado Retornar resultados da solicitação.

    Tipo de dados: Objeto

    "result": {
  "extraServiceRequests": [Array],
  "reservableId": "String",
  "reservationId": "String",
  "success": Boolean
}
    Result.extraServiceRequests Detalhes sobre a solicitação de serviço extra adicionada ou cancelada.

    Tipo de dados: Matriz de objeto

    "extraServiceRequests": [
  {
    "flexibleServiceId": "String",
    "requestId": "String"
    }
]
    Result.extraServiceRequests.flexibleServiceId Sys_id da solicitação de item de serviço extra que foi adicionada à reserva.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item de serviço do local de trabalho [sn_wsd_case_workplace_service_item]
    Result.extraServiceRequests.requestId Sys_id do item de serviço extra que foi adicionado à solicitação.

    Tipo de dados: Cadeia de caracteres

    Solicitação de itens de serviço [sn_wsd_case_service_item_request]
    Result.reservableId
    Sys_id do local do local do local de trabalho em que a reserva foi criada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local do local de trabalho [sn_wsd_core_workplace_location]
    Result.reservationId Sys_id da reserva para a qual a solicitação de serviço extra foi adicionada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Reserva do local de trabalho [sn_wsd_rsv_reservation]
    resultado.sucesso Sinalizador que indica se a solicitação de serviço extra foi adicionada com sucesso à reserva.
    Valores possíveis:
    • Verdadeiro: Adicionado com sucesso.
    • Falso: Falha na operação.

    Tipo de dados: Booliano

    Solicitação de curl

    O exemplo de código a seguir mostra como adicionar uma solicitação de item de serviço extra a uma reserva.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/wsd_extra_service_request/submit" \
--request POST \
--header "Accept:application/json" \
--header "Concept-Type:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "reservationId": "2dc2efdf531701103cf7ddeeff7b1227",
    "reservableId": "02000d4edb7650106c731dcd13961914",
    "extraServiceRequests": [
      {
        "requestId": "bea46dbc53e701103cf7ddeeff7b1236",
        "flexibleServiceId": "e2ecf7b307500110c9b36b6e0ad30033"
      }
],
    "success": true
  }
}