Instale a API do item-base

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

    • . Item-base de instalação A API fornece endpoints para acessar e gerenciar registros de itens-base de instalação em um ServiceNow instância.

    Um item-base de instalação representa uma instância de um produto que foi configurada para um cliente. Os itens-base de instalação permitem rastrear todas as compras feitas por um cliente.

    Você também pode executar operações CRUD na lista relacionada Partes relacionadas da base de instalação usando esta API. Além disso, você pode ler registros em outras listas relacionadas de itens-base de instalação, como casos, contratos, direitos, planos de manutenção, produtos vendidos e ordens de serviço.

    Para acessar esta API, você deve ter a função sn_install_base.ib_api_write ou sn_install_base.ib_api_read, dependendo do tipo de ação CRUD que você está tentando executar.

    Para acessar os vários endpoints nesta API, os seguintes plug-ins devem ser instalados:
    • Gestão da base de instalação do Atendimento ao cliente (com.snc.install_base)
    • Gestão de trabalhos planejados (sn_fsm_planned_wm) se você quiser recuperar os dados do plano de manutenção e da ordem de serviço.

    Esta API é executada no sn_install_base namespace.

    Nota:
    Esta API retorna somente campos não vazios nas respostas do endpoint. Nenhum dos campos no nível do sistema (aqueles precedidos com "sys_") são retornados, exceto o campo sys_id.

    Para obter informações adicionais sobre itens-base de instalação, consulte Create an Install base item.

    Item-base de instalação - EXCLUA /sn_install_base/integrations/installbaseitems/

    Desassocia um registro de partes relacionadas especificado de um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base//integrations/installbaseitems/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/

    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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    related_party_sys_id Sys_id do registro da parte relacionada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Parte relacionada da base de instalação [sn_install_base_related_party]
    Tabela 2. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)
    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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    resultado Descrição dos resultados do endpoint.

    Tipo de dados: Objeto
    result.status Status da solicitação de endpoint.

    Valores possíveis:

    • ÊXITO
    • FALHA

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/f77c7542b7343300ece839a6ee11a991/relatedparties/2a42dfae872521100b6afc86dabb356b" \
--request DELETE \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitens

    Retorna todos os itens-base de instalação. Você pode passar parâmetros na chamada para filtrar os resultados de retorno.

    Formato de URL

    URL com controle de versão: /api/sn_install_base//integrations/installbaseitens

    URL padrão: /api/sn_install_base/integrations/installbaseitens

    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
    pares de nome-valor do campo Pares de valor de campo a serem usados para filtrar os registros do item-base de instalação. Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, para retornar somente registros em que o campo de estado está definido como "in_use" e o campo de status está definido como "substituição", passe o seguinte: "in_use&status""substituição" .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos

    Tabela: Item-base de instalação [sn_istall_base_item]
    related_party Sys_id de um registro de parte relacionada.

    Filtra os registros do item-base de instalação com base na parte relacionada especificada. Uma parte relacionada pode ser vinculada a um item-base de instalação ou a um produto vendido.

    Valores válidos:
    • Sys_id da conta: Localizado na tabela Conta [customer_account].
    • Sys_id do consumidor: Localizado na tabela Consumidor [csm_consumer].
    • Sys_id do contato: Localizado na tabela Contato [customer-contact].
    • Organização de serviço sys_id: Localizado na tabela Organização de serviço [sn_customer_service_organization].
    • Sys_id do usuário: Localizado na tabela Usuário [sys-user].

    Tipo de dados: Cadeia de caracteres

    Tabela: Parte relacionada da base de instalação [sn_install_base_related_party]
    responsabilidade Sys_id do registro de responsabilidade associado. Este registro define o nível de acesso para as informações da base de instalação.

    Este parâmetro só será válido se related_partyo campo também é especificado. Se especificado, ele retornará somente os itens-base de instalação que correspondem a ambos related_partye. responsibilityparâmetros.

    Para obter informações adicionais, confira Configure related parties for Items Received.

    Tipo de dados: Cadeia de caracteres
    sys_class_name Se os registros desejados estiverem em uma tabela que estende a tabela Itens-base de instalação [sn_install_base_item], o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 9. Solicitar parâmetros do corpo (XML ou JSON)
    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 10. 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 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    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 (JSON ou XML)

    Os resultados de retorno a seguir descrevem somente os valores de retorno dos registros retornados da tabela Itens-base de instalação [sn_install_base_items].

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    itens Lista de itens-base de instalação que corresponderam aos resultados de filtro especificados.

    Tipo de dados: Matriz de objetos

    "items":[
  {
    "account": {Object},
    "active": "String",
    "asset": {Object},
    "configuration_item": {Object},
    "consumer": {Object},
    "consumer_profile": {Object},
    "contact": {Object},
    "health_status": {Object},
    "health_status_last_updated": "String",
    "household": {Object},
    "install_date": {Object},
    "location": {Object},
    "name": "String",
    "number": "String",
    "parent": {Object},
    "product": {Object},
    "service_context": {Object},
    "service_organization" {Object},
    "sys_class_name": "String",
    "sys_id": "String",
    "sys_mod_count": "String",
    "state": {Object},
    "status": {Object},
    "uninstall_date": "String"
  }
]
    itens.conta Detalhes sobre a conta do cliente associada ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "account": {
  "display_value": "String",
  "sys_id": "String"
}
    itens.account.display_value Nome de texto da conta do cliente associada ao registro do item-base de instalação. Use este valor para exibir o nome da conta do cliente na IU.

    Tipo de dados: Cadeia de caracteres
    account.sys_id Sys_id do registro da conta do cliente associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.ativos Sinalizador que indica se o item-base de instalação está ativo.
    Valores possíveis:
    • Verdadeiro: O item-base de instalação está ativo.
    • Falso: O item-base de instalação está inativo.

    Tipo de dados: Cadeia de caracteres booliana
    item.ativo Detalhes sobre o ativo associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "asset": {
  "display_value": "String",
  "sys_id": "String"
}
    items.asset.display_value Nome do texto do ativo associado ao registro do item-base de instalação. Use este valor para exibir o nome do ativo na IU.

    Tipo de dados: Cadeia de caracteres
    items.asset.sys_id Sys_id do registro de ativo associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.configuration_item Detalhes sobre o item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "configuration_item": {
  "display_value": "String",
  "sys_id": "String"
}
    items.configuration_item.display_value Nome do texto do item de configuração associado ao registro do item-base de instalação. Use este valor para exibir o nome do item de configuração na IU.

    Tipo de dados: Cadeia de caracteres
    items.configuration_item.sys_id Sys_id do registro do item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.consumidor Detalhes sobre o consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    items.consumer.display_value Nome de texto do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    items.consumer.sys_id Sys_id do registro do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.consumer_profile Detalhes sobre o perfil do consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo de perfil do consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer_profile": {
  "display_value": "String",
  "sys_id": "String"
}
    items.consumer_profile.display_value Nome de texto do perfil do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do perfil do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    items.consumer_profile.sys_id Sys_id do registro de perfil do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.contato Detalhes sobre o contato da conta responsável pelo registro do item-base de instalação.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    items.contact.display_value Nome de texto do contato da conta associado ao registro do item-base de instalação. Use este valor para exibir o nome do contato da conta na IU.

    Tipo de dados: Cadeia de caracteres
    items.contact.sys_id Sys_id do registro de contato da conta associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.health_status Detalhes sobre o status de integridade atual do item-base de instalação. Retornado somente se o plug-in Proactive Customer Service Operations (com.snc.proactive_cs_itom) estiver instalado.

    Tipo de dados: Objeto

    "health_status": {
  "display_value": "String",
  "value": "String"
}
    items.health_status.display_value Cadeia de caracteres de texto do status de integridade atual do item-base de instalação. Use este valor para exibir o status de integridade na IU.

    Tipo de dados: Cadeia de caracteres
    items.health_status.value Valor interno do status de integridade do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    health_status_last_updated Data e hora em que o status de integridade foi atualizado pela última vez para o item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.residência Detalhes sobre a residência associada ao registro do item-base de instalação. Retornado somente se o plug-in Residência do Atendimento ao cliente (com.snc.household) estiver instalado.

    Tipo de dados: Objeto

    "household": {
  "display_value": "String",
  "sys_id": "String"
}
    items.household.display_value Nome do texto da residência associada ao registro do item-base de instalação. Use este valor para exibir o nome da residência na IU.

    Tipo de dados: Cadeia de caracteres
    items.household.sys_id Sys_id da residência associada ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.install_date Detalhes sobre a data em que o item-base de instalação se tornou ativo.

    Tipo de dados: Objeto

    "install_date": {
  "display_value": "String",
  "value": "String"
}
    items.install_date.display_value Data de instalação de texto. Use este valor para exibir a data de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    items.install_date.value Valor interno da data de instalação.

    Tipo de dados: Cadeia de caracteres
    items.location Detalhes sobre o local do item-base de instalação.

    Tipo de dados: Objeto

    "location": {
  "display_value": "String",
  "sys_id": "String"
}
    items.location.display_value Nome do texto do local do item-base de instalação. Use este valor para exibir o nome do local na IU.

    Tipo de dados: Cadeia de caracteres
    items.location.sys_id Sys_id do registro de local associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.name Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.número ID exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.primário Detalhes sobre o registro primário do registro do item-base de instalação.

    Tipo de dados: Objeto

    "parent": {
  "display_value": "String",
  "sys_id": "String"
}
    items.parent.display_value Nome do texto do registro primário associado ao registro do item-base de instalação. Use este valor para exibir o nome primário na IU.

    Tipo de dados: Cadeia de caracteres
    items.parent.sys_id Sys_id do registro primário associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.product Detalhes sobre o modelo de produto associado ao registro do item-base de instalação. Use essas informações para identificar os serviços associados a qualquer modelo de produto.

    Tipo de dados: Objeto

    "product": {
  "display_value": "String",
  "sys_id": "String"
}
    items.product.display_value Nome do texto do modelo de produto associado ao registro do item-base de instalação. Use este valor para exibir o nome do produto na IU.

    Tipo de dados: Cadeia de caracteres
    items.product.sys_id Sys_id do registro do modelo de produto associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.service_context Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    items.service_context.display_value Nome do texto do contexto de serviço associado ao registro do item-base de instalação. Use este valor para exibir o nome do contexto de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    items.service_context.sys_id Sys_id do registro de contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.service_organization Detalhes sobre a organização de serviço associada ao registro do item-base de instalação. Retornado somente se o plug-in Organização de serviço (com.snc.service_organization) estiver instalado.

    Tipo de dados: Objeto

    "service_organization": {
  "display_value": "String",
  "sys_id": "String"
}
    items.service_organization.display_value Nome do texto da organização de serviço associada ao registro do item-base de instalação. Use este valor para exibir o nome da organização de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    items.service_organization.sys_id Sys_id do registro da organização de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.sys_class_name Tabela que contém o registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    sys_id Sys_id do registro do item-base de instalação. Localizado na tabela especificada em sys_class_nameparâmetro.

    Tipo de dados: Cadeia de caracteres
    itens.sys_mod_count Número de vezes que o registro do item-base de instalação associado foi modificado.

    Tipo de dados: Cadeia de caracteres
    itens.state Detalhes sobre o estado atual do item-base de instalação.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    items.state.display_value Cadeia de caracteres de texto do estado atual do item-base de instalação. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    items.state.value Valor interno do estado do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.status Detalhes sobre o status do item-base de instalação.

    Tipo de dados: Objeto

    "status": {
  "display_value": "String",
  "value": "String"
}
    items.status.display_value Cadeia de caracteres de texto do status do item-base de instalação. Use este valor para exibir o status na IU.

    Tipo de dados: Cadeia de caracteres
    itens.status.valor Valor interno do status do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    uninstall_date Detalhes sobre a data em que o item-base de instalação ficou inativo.

    Tipo de dados: Objeto

    "uninstall_date": {
  "display_value": "String",
  "value": "String"
}
    uninstall_date.display_value Data de desinstalação de texto. Use este valor para exibir a data de desinstalação na IU.

    Tipo de dados: Cadeia de caracteres
    uninstall_date.value Valor interno da data de desinstalação.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_depth Número de níveis de profundidade em que o item-base de instalação secundário retornado está na hierarquia.

    Tipo de dados: Inteiro
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra uma chamada simples que retorna apenas um único registro começando no deslocamento 5.

    curl "https://instance.servicenow.com/api/sn_install_base/v1/integrations/installbaseitems?sysparm_limit=1&sysparm_offset=5" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": "5",
    "sysparm_limit": 1,
    "has_more": true,
    "items": [
      {
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM001100",
        "sys_id": "181df7ff530a1110539dddeeff7b12f4",
        "state": {
          "value": "in_use",
          "display_value": "In Use"
        },
        "sys_mod_count": "2",
        "active": "true",
        "configuration_item": {
          "sys_id": "62446ae8535e5510539dddeeff7b12db",
          "display_value": "boxeoproderp"
        },
        "name": "boxeoproderp",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Solicitação de curl

    O exemplo de código a seguir mostra como pesquisar os campos state"em_uso" e. status"Substituição" na tabela Item-base de instalação.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems?state=in_use&status=replacement" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": "0",
    "sysparm_limit": "10",
    "has_more": false,
    "items": [
      {
        "parent": {
          "sys_id": "ffd023f453de9910539dddeeff7b1264",
          "display_value": "Point of Sale System"
        },
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM001140",
        "sys_id": "a1a123745312d910539dddeeff7b127b",
        "state": {
          "value": "in_use",
          "display_value": "In Use"
        },
        "install_date": {
          "value": "2018-12-14 07:00:00",
          "display_value": "2018-12-13 23:00:00"
        },
        "product": {
          "sys_id": "2dd1e7b753421110539dddeeff7b12d1",
          "display_value": "Stand"
        },
        "active": "true",
        "name": "Stand",
        "service_organization": {
          "sys_id": "42b51f5ab3401010700b4d43c6a8dc5a",
          "display_value": "LA City Center - West"
        },
        "status": {
          "value": "replacement",
          "display_value": "Replacement"
        }
      },
      {
        "parent": {
          "sys_id": "ffd023f453de9910539dddeeff7b1264",
          "display_value": "Point of Sale System"
        },
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM001139",
        "sys_id": "d0916bb05312d910539dddeeff7b1232",
        "state": {
          "value": "in_use",
          "display_value": "In Use"
        },
        "install_date": {
          "value": "2018-12-14 07:00:00",
          "display_value": "2018-12-13 23:00:00"
        },
        "product": {
          "sys_id": "dfc127b753421110539dddeeff7b12ac",
          "display_value": "Register"
        },
        "active": "true",
        "name": "Register",
        "service_organization": {
          "sys_id": "42b51f5ab3401010700b4d43c6a8dc5a",
          "display_value": "LA City Center - West"
        },
        "status": {
          "value": "replacement",
          "display_value": "Replacement"
        }
      },
      {
        "parent": {
          "sys_id": "ffd023f453de9910539dddeeff7b1264",
          "display_value": "Point of Sale System"
        },
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM001141",
        "sys_id": "ffb123745312d910539dddeeff7b12cb",
        "state": {
          "value": "in_use",
          "display_value": "In Use"
        },
        "install_date": {
          "value": "2018-12-14 07:00:00",
          "display_value": "2018-12-13 23:00:00"
        },
        "product": {
          "sys_id": "59e1e7b753421110539dddeeff7b12cc",
          "display_value": "Terminal"
        },
        "active": "true",
        "name": "Terminal",
        "service_organization": {
          "sys_id": "42b51f5ab3401010700b4d43c6a8dc5a",
          "display_value": "LA City Center - West"
        },
        "status": {
          "value": "replacement",
          "display_value": "Replacement"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Solicitação de curl

    O exemplo de código a seguir mostra como filtrar os resultados de retorno usando related_partye. responsibilityparâmetros de consulta.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems?related_party=dc0185d94f341200025ba3618110c77c&responsibility=c009bbedb3730010700b4d43c6a8dce" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": "0",
    "sysparm_limit": "10",
    "has_more": false,
    "items": [
      {
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM0001004",
        "sys_id": "3ea014a778de1110f877d304c76fdd0d",
        "state": {
          "value": "in_use",
          "display_value": "In Use"
        },
        "consumer": {
          "sys_id": "feb5139ab3401010700b4d43c6a8dc43",
          "display_value": "Kenny Smith"
        },
        "product": {
          "sys_id": "63c8bc9778921110f877d304c76fdd34",
          "display_value": "X4 Sport Utility 4D"
        },
        "active": "true",
        "name": "X4 Sport Utility 4D",
        "status": {
          "value": "original",
          "display_value": "Original"
        }
      },
      {
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM001003",
        "sys_id": "6e94e3c853500010df5dddeeff7b1234",
        "contact": {
          "sys_id": "4d147a386f0331003b3c498f5d3ee437",
          "display_value": "Julie Lewis"
        },
        "active": "true",
        "configuration_item": {
          "sys_id": "a96a570453500010df5dddeeff7b1206",
          "display_value": "boxeosandbox"
        },
        "name": "Boxeo - Sandbox",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      },
      {
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM0001010",
        "sys_id": "83332fde87e5a1105d0055373cbb3567",
        "contact": {
          "sys_id": "ddce70866f9331003b3c498f5d3ee417",
          "display_value": "George Warren"
        },
        "state": {
          "value": "in_use",
          "display_value": "In Use"
        },
        "install_date": {
          "value": "2023-02-26 18:59:52",
          "display_value": "2023-02-26 10:59:52"
        },
        "health_status": {
          "value": "not_available",
          "display_value": "Not Available"
        },
        "product": {
          "sys_id": "a9a2d0c3c6112276010db16c5ddd3461",
          "display_value": "Lenovo ThinkStation S20"
        },
        "active": "true",
        "configuration_item": {
          "sys_id": "affd3c8437201000deeabfc8bcbe5dc3",
          "display_value": "*BETH-IBM"
        },
        "name": "IB B2B",
        "location": {
          "sys_id": "25ab9c4d0a0a0bb300f7dabdc0ca7c1c",
          "display_value": "100 South Charles Street, Baltimore,MD"
        },
        "asset": {
          "sys_id": "bfc1fa8837f3100044e0bfc8bcbe5ddf",
          "display_value": "P1000228 - Lenovo ThinkStation S20"
        },
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        },
        "status": {
          "value": "original",
          "display_value": "Original"
        }
      },
      {
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM0001011",
        "sys_id": "9d766f168729a1105d0055373cbb3597",
        "health_status": {
          "value": "not_available",
          "display_value": "Not Available"
        },
        "product": {
          "sys_id": "8583ce8237732000158bbfc8bcbe5dd9",
          "display_value": "Fujitsu 1TB Hybrid Solid State Drive"
        },
        "active": "true",
        "name": "IBA",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      },
      {
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM0001013",
        "sys_id": "bd955a2687ada1100b6afc86dabb35fb",
        "health_status": {
          "value": "not_available",
          "display_value": "Not Available"
        },
        "consumer": {
          "sys_id": "59e788fbdb1b1200b6075200cf9619d2",
          "display_value": "Gilly Parker"
        },
        "product": {
          "sys_id": "1a13974053500010df5dddeeff7b122c",
          "display_value": "12000XHD Digital Press"
        },
        "active": "true",
        "name": "IBConsumer"
      },
      {
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM0000901",
        "sys_id": "f77c7542b7343300ece839a6ee11a991",
        "product": {
          "sys_id": "8583ce8237732000158bbfc8bcbe5dd9",
          "display_value": "Fujitsu 1TB Hybrid Solid State Drive"
        },
        "active": "true",
        "name": "KX Series - KX5001",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitem/

    Retorna um registro de item-base de instalação especificado e sua hierarquia secundária.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitem/

    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 13. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 14. Parâmetros de consulta
    Nome Descrição
    sys_class_name Se o registro pretendido estiver em uma tabela que estende a tabela Itens-base de instalação [sn_install_base_item], o nome da tabela estendida a ser consultada. Esta tabela deve estender a tabela sn_install_base_item.

    Tipo de dados: Cadeia de caracteres
    sysparm_depth Profundidade máxima da hierarquia do item-base de instalação secundário a ser retornada.

    Tipo de dados: Inteiro

    Padrão: 7

    Máximo: 10
    sysparm_limit Número máximo de registros a serem retornados em cada hierarquia secundária.

    Tipo de dados: Inteiro

    Padrão: 10

    Máximo: 100
    Tabela 15. Solicitar parâmetros do corpo (XML ou JSON)
    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 16. 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 17. 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 18. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    childinstallbase Lista de registros de item-base de instalação secundário associados ao item-base de instalação especificado.

    Tipo de dados: Objeto

    "childinstallbase": {
  "items": [Array],
  "sysparm_depth": Integer
}
    childinstallbase.items Itens-base de instalação secundários associados ao item-base de instalação especificado.

    Os valores nesta matriz são definidos em items[]matriz mais abaixo nesta seção.
    childinstallbase.sysparm_depth Nível secundário do item-base de instalação.

    Tipo de dados: Inteiro
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_children Sinalizador que indica se o registro do item-base de instalação solicitado tem registros de item-base de instalação secundário.
    • Verdadeiro: Tem registros de item-base de instalação secundários.
    • Falso: Não tem registros de item-base de instalação secundária.

    Tipo de dados: Booliano
    item Item-base de instalação que correspondeu aos resultados de filtro especificados.

    Tipo de dados: Objeto

    "item": {
  "account": {Object},
  "active": "String",
  "asset": {Object},
  "configuration_item": {Object},
  "consumer": {Object},
  "consumer_profile": {Object},
  "contact": {Object},
  "health_status": "Object",
  "health_status_last_updated": "String",
  "household": {Object},
  "install_date": {Object},
  "location": {Object},
  "name": "String",
  "number": "String",
  "parent": {Object},
  "product": {Object},
  "service_context": {Object},
  "service_organization" {Object},
  "sys_class_name": "String",
  "sys_id": "String",
  "state": {Object},
  "status": {Object},
  "uninstall_date": "String"
}
    item.conta Detalhes sobre a conta do cliente associada ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "account": {
  "display_value": "String",
  "sys_id": "String"
}
    item.account.display_value Nome de texto da conta do cliente associada ao registro do item-base de instalação. Use este valor para exibir o nome da conta do cliente na IU.

    Tipo de dados: Cadeia de caracteres
    item.account.sys_id Sys_id do registro da conta do cliente associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.ativo Sinalizador que indica se o item-base de instalação está ativo.
    Valores possíveis:
    • Verdadeiro: O item-base de instalação está ativo.
    • Falso: O item-base de instalação está inativo.

    Tipo de dados: Cadeia de caracteres booliana
    item.ativo Detalhes sobre o ativo associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "asset": {
  "display_value": "String",
  "sys_id": "String"
}
    item.asset.display_value Nome do texto do ativo associado ao registro do item-base de instalação. Use este valor para exibir o nome do ativo na IU.

    Tipo de dados: Cadeia de caracteres
    item.asset.sys_id Sys_id do registro de ativo associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.configuration_item Detalhes sobre o item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "configuration_item": {
  "display_value": "String",
  "sys_id": "String"
}
    item.configuration_item.display_value Nome do texto do item de configuração associado ao registro do item-base de instalação. Use este valor para exibir o nome do item de configuração na IU.

    Tipo de dados: Cadeia de caracteres
    item.configuration_item.sys_id Sys_id do registro do item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.consumidor Detalhes sobre o consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    item.consumer.display_value Nome de texto do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    item.consumer.sys_id Sys_id do registro do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.consumer_profile Detalhes sobre o perfil do consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo de perfil do consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer_profile": {
  "display_value": "String",
  "sys_id": "String"
}
    item.consumer_profile.display_value Nome de texto do perfil do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do perfil do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    item.consumer_profile.sys_id Sys_id do registro de perfil do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.contato Detalhes sobre o contato da conta responsável pelo registro do item-base de instalação.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    item.contact.display_value Nome de texto do contato da conta associado ao registro do item-base de instalação. Use este valor para exibir o nome do contato da conta na IU.

    Tipo de dados: Cadeia de caracteres
    item.contact.sys_id Sys_id do registro de contato da conta associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.health_status Detalhes sobre o status de integridade atual do item-base de instalação. Retornado somente se o plug-in Proactive Customer Service Operations (com.snc.proactive_cs_itom) estiver instalado.

    Tipo de dados: Objeto

    "health_status": {
  "display_value": "String",
  "value": "String"
}
    item.health_status.display_value Cadeia de caracteres de texto do status de integridade atual do item-base de instalação. Use este valor para exibir o status de integridade na IU.

    Tipo de dados: Cadeia de caracteres
    item.health_status.value Valor interno do status de integridade do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.health_status_last_updated Data e hora em que o status de integridade foi atualizado pela última vez para o item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.residência Detalhes sobre a residência associada ao registro do item-base de instalação. Retornado somente se o plug-in Residência do Atendimento ao cliente (com.snc.household) estiver instalado.

    Tipo de dados: Objeto

    "household": {
  "display_value": "String",
  "sys_id": "String"
}
    item.household.display_value Nome do texto da residência associada ao registro do item-base de instalação. Use este valor para exibir o nome da residência na IU.

    Tipo de dados: Cadeia de caracteres
    item.household.sys_id Sys_id da residência associada ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.install_date Detalhes sobre a data em que o item-base de instalação se tornou ativo.

    Tipo de dados: Objeto

    "install_date": {
  "display_value": "String",
  "value": "String"
}
    item.install_date.display_value Data de instalação de texto. Use este valor para exibir a data de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    item.install_date.value Valor interno da data de instalação.

    Tipo de dados: Cadeia de caracteres
    item.location Detalhes sobre o local do item-base de instalação.

    Tipo de dados: Objeto

    "location": {
  "display_value": "String",
  "sys_id": "String"
}
    item.location.display_value Nome do texto do local do item-base de instalação. Use este valor para exibir o nome do local na IU.

    Tipo de dados: Cadeia de caracteres
    item.location.sys_id Sys_id do registro de local associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item_name Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.número ID exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.primário Detalhes sobre o registro primário do registro do item-base de instalação.

    Tipo de dados: Objeto

    "parent": {
  "display_value": "String",
  "sys_id": "String"
}
    item.parent.display_value Nome do texto do registro primário associado ao registro do item-base de instalação. Use este valor para exibir o nome primário na IU.

    Tipo de dados: Cadeia de caracteres
    item.parent.sys_id Sys_id do registro primário associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.product Detalhes sobre o modelo de produto associado ao registro do item-base de instalação. Use essas informações para identificar os serviços associados a qualquer modelo de produto.

    Tipo de dados: Objeto

    "product": {
  "display_value": "String",
  "sys_id": "String"
}
    item.product.display_value Nome do texto do modelo de produto associado ao registro do item-base de instalação. Use este valor para exibir o nome do produto na IU.

    Tipo de dados: Cadeia de caracteres
    item.product.sys_id Sys_id do registro do modelo de produto associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.service_context Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_context.display_value Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_context.sys_id Sys_id do registro de contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.service_organization Detalhes sobre a organização de serviço associada ao registro do item-base de instalação. Retornado somente se o plug-in Organização de serviço (com.snc.service_organization) estiver instalado.

    Tipo de dados: Objeto

    "service_organization": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_organization.display_value Nome do texto da organização de serviço associada ao registro do item-base de instalação. Use este valor para exibir o nome da organização de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    item.service_organization.sys_id Sys_id do registro da organização de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.sys_class_name Tabela que contém o registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.sys_id Sys_id do registro do item-base de instalação. Localizado na tabela especificada em sys_class_nameparâmetro.

    Tipo de dados: Cadeia de caracteres
    item.sys_mod_count Número de vezes que o registro do item-base de instalação associado foi modificado.

    Tipo de dados: Cadeia de caracteres
    item.state Detalhes sobre o estado atual do item-base de instalação.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    item.state.display_value Cadeia de caracteres de texto do estado atual do item-base de instalação. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    item.state.value Valor interno do estado do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.status Detalhes sobre o status do item-base de instalação.

    Tipo de dados: Objeto

    "status": {
  "display_value": "String",
  "value": "String"
}
    item.status.display_value Cadeia de caracteres de texto do status do item-base de instalação. Use este valor para exibir o status na IU.

    Tipo de dados: Cadeia de caracteres
    item.status.valor Valor interno do status do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.uninstall_date Detalhes sobre a data em que o item-base de instalação ficou inativo.

    Tipo de dados: Objeto

    "uninstall_date": {
  "display_value": "String",
  "value": "String"
}
    item.uninstall_date.display_value Data de desinstalação de texto. Use este valor para exibir a data de desinstalação na IU.

    Tipo de dados: Cadeia de caracteres
    item.uninstall_date.value Valor interno da data de desinstalação.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint. O item-base de instalação associado não tem secundários.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitem/f77c7542b7343300ece839a6ee11a991" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "status": "SUCCESS",
    "item": {
      "sys_class_name": "sn_install_base_item",
      "number": "IBITM0000901",
      "sys_id": "f77c7542b7343300ece839a6ee11a991",
      "product": {
        "sys_id": "8583ce8237732000158bbfc8bcbe5dd9",
        "display_value": "Fujitsu 1TB Hybrid Solid State Drive"
      },
      "active": "true",
      "name": "KX Series - KX5001",
      "account": {
        "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
        "display_value": "Boxeo"
      }
    },
    "hasChildren": "false"
  }
}

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint especificando uma profundidade máxima de quatro níveis secundários.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/e0a80e4b87b521100b6afc86dabb3565?depth=4" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "status": "SUCCESS",
    "item": {
      "sys_class_name": "sn_install_base_item",
      "number": "IBITM0001073",
      "sys_id": "e0a80e4b87b521100b6afc86dabb3565",
      "health_status": {
        "value": "not_available",
        "display_value": "Not Available"
      },
      "active": "true",
      "name": "parent",
      "account": {
        "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
        "display_value": "Boxeo"
      }
    },
    "hasChildren": "true",
    "childinstallbase": {
      "sysparm_depth": 2,
      "items": [
        {
          "parent": {
            "sys_id": "e0a80e4b87b521100b6afc86dabb3565",
            "display_value": "parent"
          },
          "sys_class_name": "sn_install_base_item",
          "number": "IBITM0001074",
          "sys_id": "6db80e4b87b521100b6afc86dabb356b",
          "state": {
            "value": "in_use",
            "display_value": "In Use"
          },
          "health_status": {
            "value": "not_available",
            "display_value": "Not Available"
          },
          "active": "true",
          "name": "child1",
          "account": {
            "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
            "display_value": "Boxeo"
          },
          "hasChildren": "true",
          "items": {
            "sysparm_depth": 3,
            "items": [
              {
                "parent": {
                  "sys_id": "6db80e4b87b521100b6afc86dabb356b",
                  "display_value": "child1"
                },
                "sys_class_name": "sn_install_base_item",
                "number": "IBITM0001075",
                "sys_id": "36ecce4b87b521100b6afc86dabb3503",
                "health_status": {
                  "value": "not_available",
                  "display_value": "Not Available"
                },
                "active": "true",
                "name": "childL2",
                "account": {
                  "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
                  "display_value": "Boxeo"
                },
                "hasChildren": "false"
              }
            ]
          }
        }
      ]
    }
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/id/cases

    Retorna os casos associados a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitens/id/cases

    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 19. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 20. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de campo-valor a serem usados para filtrar os registros de caso. Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, para retornar somente registros em que o campo Aprovação está definido como "Rejeitado" e o campo de categoria está definido como "2", passe o seguinte: "aprovação: rejeitada e categoria: 2 .

    Tipo de dados: Cadeia de caracteres

    Tabela: Caso [sn_customerservice_case]

    Padrão: Todos os campos
    sys_class_name Se estiver usando uma tabela de caso estendida (não sn_customerservice_case), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_customerservice_case
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 21. Solicitar parâmetros do corpo (XML ou JSON)
    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 22. 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 23. 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 24. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Elemento Descrição
    casos Lista de casos associados ao registro do item-base de instalação especificado.

    Tipo de dados: Matriz de objetos

    "cases": [
  {
    "account": "String",
    "active": Boolean,
    "active_account_escalation": "String",
    "active_escalation": "String",
    "activity_due": "String",
    "additional_assignee_list": "String",
    "approval": "String",
    "approval_history": "String",
    "approval_set": "String",
    "asset": "String",
    "assigned_on": "String",
    "assigned_to": "String",
    "assignment_group": "String",
    "auto_close": Boolean,
    "business_duration": "String",
    "business_impact": "String",
    "business_service": "String",
    "calendar_duration": "String",
    "case": "String",
    "case_report": "String",
    "category": Number,
    "cause": "String",
    "caused_by": "String",
    "change": "String",
    "child_case_creation_progress": Boolean,
    "closed_at": "String",
    "closed_by": "String",
    "close_notes: "String",
    "cmdb_ci": "String",
    "comments": "String",
    "comments_and_work_notes": "String",
    "company": "String",
    "consumer": "String",
    "contact": "String",
    "contact_local_time: "String",
    "contact_time_zone": "String",
    "contact_type": "String",
    "contract": "String",
    "contributor_groups": "String",
    "contributor_users": "String",
    "correlation_display": "String",
    "correlation_id": "String",
    "delivery_plan": "String",
    "delivery_task": "String",
    "description": "string",
    "due_date": "String",
    "entitlement": "String",
    "escalation": Number,
    "expected_start": "String",
    "first_response_time": "String",
    "follow_the_sun": Boolean,
    "follow_up": "String",
    "group_list": [Array],
    "impact": Number,
    "internal_user": "String",
    "initiated_as_request": Boolean,
    "knowledge": Boolean,
    "location": "String",
    "made_sla": Boolean,
    "major_case_state": "String",
    "needs_attention": Boolean,
    "notes_to_comments": Boolean,
    "notify": Number,
    "number": "String",
    "opened_at": "String",
    "opened_by": "String",
    "order": Number,
    "parent": "String",
    "partner": "String",
    "partner_contact": "String",
    "priority": Number,
    "proactive": Boolean,
    "probable_cause": "String",
    "problem": "String",
    "product": "String",
    "reassignment_count": Number,
    "recipient_list": "String",
    "rejection_goto": "String",
    "resolution_code": "String",
    "resolved_at": "String",
    "resolved_by": "String",
    "route_reason": "String",
    "service_offering": "String",
    "short_description": "String",
    "skills": "String",
    "sla_due": "String",
    "sn_app_cs_social_social_profile": "String",
    "sold_product": "String",
    "stage": "String",
    "state": Number,
    "subcategory": Number,
    "support_manager" "String",
    "sync_driver": Boolean,
    "sys_class_name": "String",
    "sys_domain": "String",
    "sys_domain_path": "String",
    "sys_id": "String",
    "task_effective_number": "String",
    "time_worked": "String",
    "universal_request": "String",
    "upon_approval": "String",
    "upon_reject": "String",
    "urgency": Number,
    "user_input": "String",
    "variables":  "String",
    "watch_list": [Array],
    "wf_activity": "String",
    "work_end": "String",
    "work_notes": "String",
    "work_notes_list": [Array],
    "work_start": "String"
    cases.conta
    Sys_id do registro da conta associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Conta [customer_account]
    casos.ativos Sinalizador que indica se o caso está aberto e ativo.

    Valores possíveis:

    • Verdadeiro: O caso está ativo
    • Falso: O caso está encerrado

    Tipo de dados: Booliano

    Padrão: verdadeiro
    cases.active_account_escalation Sys_id do registro de escalação de conta ativo associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Escalação [sn_customerservice_escalation]
    cases.active_escalation Sys_id do registro de escalação ativo associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Escalação [sn_customerservice_escalation]
    acses.activity_due Data para a qual o caso associado deve ser concluído.

    Tipo de dados: Cadeia de caracteres
    additional_assignee_list Lista de sys_ids das pessoas adicionais (que não sejam o designado primário) que foram atribuídas à conta.

    Tipo de dados: Matriz

    Máximo: 4 000

    Tabela: Usuário [sys_user]
    cases.approval Cadeia de caracteres que descreve o tipo de aprovação necessária.

    Valores possíveis:

    • aprovado
    • Cancelados(as)
    • duplicado
    • not_required
    • não solicitado
    • rejeitado
    • solicitado

    Tipo de dados: Cadeia de caracteres

    Máximo de caracteres: 40

    Padrão: Não solicitado
    cases.approval_history Lista de todas as aprovações associadas ao caso.

    Tipo de dados: Cadeia de caracteres

    Máximo de caracteres: 4 000
    approval_set Data e hora em que a ação associada foi aprovada.

    Tipo de dados: Cadeia de caracteres
    cases.asset Sys_id do registro de ativo associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Ativo [alm_asset]
    assigned_on Data e hora em que o caso foi atribuído à pessoa identificada no assigned_toparâmetro.

    Tipo de dados: Cadeia de caracteres (data)

    Comprimento máximo: 40
    assigned_to
    Sys_id da pessoa atribuída ao caso.

    Tabela: Usuário [sys_user]

    Tipo de dados: Cadeia de caracteres
    cases.assignment_group Sys_id do grupo de agentes de atendimento ao cliente atribuído ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Grupo [sys_user_group]
    cases.auto_close Sinalizador que indica se o caso foi encerrado automaticamente.

    Valores possíveis:

    • Verdadeiro: O caso foi encerrado automaticamente
    • Falso: O caso não foi encerrado automaticamente

    Tipo de dados: Booliano

    Padrão: falso
    cases.business_duration Duração em horas de trabalho do calendário, dias úteis e semanas de trabalho que levou para concluir o caso.

    Tipo de dados: Cadeia de caracteres
    cases.business_impact Impacto do problema no cliente associado.

    Tipo de dados: Cadeia de caracteres

    Máximo de caracteres: 4 000
    cases.business_service Sys_id do registro de serviço associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Serviço [cmdb_ci_service]
    cases.calendar_duration Duração em horas, dias e semanas do calendário que levou para concluir o caso.

    Tipo de dados: Cadeia de caracteres (duração)

    Comprimento máximo: 40
    cases.case Descrição resumida do caso e número do caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 300
    cases.case_report Sys_id do relatório de caso associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Relatório de caso [sn_customerservice_case_report]
    cases.category Categoria do caso.

    Valores possíveis:

    • 0: Pergunta
    • 1: Problema
    • 2: Recurso

    Tipo de dados: Número (inteiro)

    Padrão: 1
    cases.cause Detalhes sobre a causa do problema.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    cases.caused_by Sys_id da solicitação de mudança que causou a criação do caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: solicitação de mudança [change_request]
    cases.change Sys_id da solicitação de mudança que causou a criação do caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: solicitação de mudança [change_request]
    cases.child_case_creation_progress Sinalizador que indica se o caso é um caso secundário que foi criado a partir de um caso principal.

    Valores possíveis:

    • Verdadeiro: Caso secundário criado a partir de um caso principal
    • Falso: Não é um caso secundário

    Tipo de dados: Booliano
    casos.encerrado_em Data e hora em que o caso foi encerrado.

    Tipo de dados: Cadeia de caracteres
    cases.closed_by Sys_id do usuário que fechou o caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    cases.close_notes Anotações feitas quando o caso foi encerrado.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    cmdb_ci Sys_id do item de configuração associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item de configuração [cmdb_ci]
    cases.comments Comentários adicionais sobre o caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    cases.comments_and_work_notes Comentários e anotações de trabalho inseridos para o caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    cases.company Sys_id da empresa associada ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Empresa [core_company]
    casos.consumidor Somente casos entre empresas e consumidores. Sys_id da pessoa a ser contatada em relação a este caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Consumidor [csm_consumer]
    casos.contato Somente casos baseados entre empresas. Sys_id da pessoa a ser contatada em relação a este caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    contact_local_time Horário local do contato.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 70
    cases.contact_time_zone Fuso horário do contato associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    cases.contact_type Método no qual o caso foi relatado inicialmente.
    Valores possíveis:
    • bate-papo
    • e-mail
    • telefone
    • social
    • web

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    casos.contrato Sys_id do contrato associado ao caso. Este contrato contém informações sobre o tipo de suporte fornecido à empresa associada ao caso. Um contrato pode incluir uma empresa e um contato e os ativos específicos cobertos. Um contrato também pode incluir vários direitos de serviço e ANSs.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contrato [ast_contract]
    cases.contributor_groups Lista de sys_ids dos grupos de usuários que contribuíram para o caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Grupo [sys_user_group]
    cases.contributor_users Lista de sys_ids dos usuários que contribuíram para o caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    cases.correlation_display Exibição de correlação.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 100
    cases.correlation_id Identificador de correlação.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 100
    cases.delivery_plan Sys_id do plano de execução primário para este caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Plano de execução [sc_cat_item_delivery_plan]
    cases.delivery_task Sys_id da tarefa do plano de execução.

    Tipo de dados: Cadeia de caracteres

    Tabela: Tarefa do plano de execução [sc_cat_item_delivery_task]
    cases.description Descrição detalhada do problema associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    due_date.due_date Data em que o caso deve ser encerrado.

    Tipo de dados: Cadeia de caracteres
    cases.direito Sys_id do registro de direito associado ao caso. Os direitos definem o tipo de suporte que um cliente recebe, bem como os canais de comunicação compatíveis. Um direito pode ser associado a um produto, um ativo, uma conta ou um contrato.

    Tipo de dados: Cadeia de caracteres

    Tabela: Direito [service_entitlement]
    cases.escalation Nível de escalação atual.

    Valores possíveis:

    • 0: Normal
    • 1: Moderado
    • 2: Alto
    • 3: Atrasado

    Tipo de dados: Número (inteiro)

    Padrão: 0
    expected_start Data e hora em que o trabalho está programado para começar no caso.

    Tipo de dados: Cadeia de caracteres
    first_response_time Data e hora em que a primeira ação foi realizada no caso.

    Tipo de dados: Cadeia de caracteres
    casos.follow_the_sun Sinalizador que indica se o caso deve ser entregue para acompanhamento global.

    Se um cliente inserir comentários adicionais em um caso de Prioridade 1 - Crítica ou Prioridade 2 - Alta, ou se o caso for escalado, o sinalizador será definido automaticamente como verdadeiro.

    Valores possíveis:

    • Verdadeiro: O caso deve ser entregue para acompanhamento global
    • Falso: O caso não deve ser entregue para acompanhamento global

    Tipo de dados: Booliano

    Padrão: falso
    follow_up Data e hora da próxima ação de acompanhamento.

    Tipo de dados: Cadeia de caracteres
    cases.group_list Lista de sys_ids dos registros do grupo associados ao caso.

    Tipo de dados: Matriz

    Tabela: Grupo [sys_user_group]
    cases.impacto Impacto no cliente.

    Valores possíveis:

    • 1: Alto
    • 2: Médio
    • 3: Baixo

    Tipo de dados: Número (inteiro)

    Padrão: 3
    cases.internal_user Sys_id do usuário interno para este caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    cases.initiated_as_request Sinalizador que indica se esta consulta foi iniciada como uma solicitação pelo cliente.

    Valores possíveis:

    • Verdadeiro: Consulta iniciada pelo cliente.
    • Falso: A consulta não foi iniciada pelo cliente.

    Tipo de dados: Booliano

    Padrão: falso
    casos.conhecimento Sinalizador que indica se há um artigo da base de conhecimento disponível para o problema especificado.

    Valores possíveis:

    • Verdadeiro: o artigo da base de conhecimento está disponível para este problema
    • Falso: o artigo da base de conhecimento não está disponível para este problema

    Tipo de dados: Booliano

    Padrão: falso
    cases.location Sys_id do registro que descreve o local da empresa.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local [cmn_location]
    made_ans Sinalizador que indica se o caso foi resolvido em alinhamento com o acordo de nível de serviço associado.

    Valores possíveis:

    • Verdadeiro: O caso foi resolvido em alinhamento com o ANS
    • Falso: O caso não foi resolvido de acordo com o ANS

    Tipo de dados: Booliano

    Padrão: verdadeiro
    casos.major_case_state Estado atual do caso principal.

    Valores possíveis:

    • Estado inicial quando um gerente cria um caso principal ou quando um gerente promove um caso candidato.
    • Cancelado: O caso foi cancelado.
    • Proposto: Estado inicial quando um agente ou gerente cria ou propõe um caso candidato.
    • Rejeitado: O gerente rejeitou o caso candidato.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    needs_attention Sinalizador que indica se o caso precisa de atenção.

    Valores possíveis:

    • Verdadeiro: O caso precisa de atenção adicional
    • Falso: O caso não precisa de atenção adicional

    Tipo de dados: Booliano

    Padrão: falso
    cases.notes_to_comments Sinalizador que indica se as anotações de resolução devem ser adicionadas aos comentários.

    Valores possíveis:

    • Verdadeiro: Anotações de resoluções, quando adicionadas, também são adicionadas aos comentários
    • Falso: As anotações de resolução nos comentários não são necessárias

    Tipo de dados: Booliano
    cases.notify Método a ser usado para notificar contato/consumidor.

    Valores possíveis:

    • 1: Não notificar
    • 2: Enviar e-mail
    • 3: Telefone

    Tipo de dados: Número (inteiro)

    Padrão: 1
    cases.number Número do caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    opened_at Data e hora em que o caso foi aberto.

    Tipo de dados: Cadeia de caracteres
    opened_by Sys_id da pessoa que abriu o caso inicialmente.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    cases.ordem Ordem do caso.

    Tipo de dados: Número (inteiro)
    cases.primário Sys_id do caso primário ao qual este caso (secundário) está associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Tarefa [task]
    cases.parceiro Sys_id do parceiro associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Conta [customer_account]
    cases.partner_contact Sys_id do contato do parceiro associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    casos.prioridade Prioridade do caso.
    Valores possíveis:
    • 1: Crítico
    • 2: Alto
    • 3: Moderado
    • 4: Baixo

    Tipo de dados: Número (inteiro)

    Padrão: 4
    cases.proactive Sinalizador que indica se a consulta está sendo monitorada proativamente.

    Valores possíveis:

    • Verdadeiro: Sendo monitorado proativamente.
    • Falso: Não sendo monitorado.

    Tipo de dados: Booliano

    Padrão:falso
    cases.probable_cause Possível causa do problema associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    cases.problem Sys_id do problema que o cliente está encontrando.

    Tipo de dados: Cadeia de caracteres

    Tabela: problema [problema]
    cases.product Sys_id do modelo de produto do ativo associado ao caso. Um modelo é uma versão ou configuração específica de um ativo (por exemplo, Apple Mac Book Pro).

    Tipo de dados: Cadeia de caracteres

    Tabela: Modelo de produto [cmdb_model]
    reassignment_count Número de vezes que o caso foi reatribuído a uma pessoa responsável por avançar o caso.

    Tipo de dados: Número (inteiro)

    Padrão: 0
    cases.recipient_list Sys_id do registro que contém a lista de destinatários para comunicações sobre este caso.

    Tipo de dados: Cadeia de caracteres

    Lista de destinatários [sn_publications_destinatários_list]
    rejection_goto Sys_id da tarefa a ser executada se o caso for rejeitado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Tarefa [task]
    cases.resolution_code Estado de resolução do caso, como "Resolvido - Corrigido pelo suporte/orientação fornecido".

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    resolved_at Data e hora em que o caso foi resolvido.

    Tipo de dados: Cadeia de caracteres
    resolved_by Sys_id da pessoa que resolveu o caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    cases.route_reason Motivo pelo qual o caso foi roteado para um designado diferente.

    Tipo de dados: Número (inteiro)

    Comprimento máximo: 40
    cases.service_offering Sys_id da oferta de serviço associada à consulta de pagamento. As ofertas de serviço definem exclusivamente o nível de serviço em termos de disponibilidade, escopo, preço e opções de pacote.

    Tipo de dados: Cadeia de caracteres

    Tabela: Oferta de serviço [service_offering]
    short_description Descrição concisa do caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 160
    cases.habilidades Lista de identificadores exclusivos (sys_id) das habilidades necessárias para concluir o caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Habilidade [cmn_skill]
    casos.sla_due Data/hora em que o caso deve ser encerrado com base no acordo de nível de serviço associado.

    Tipo de dados: Cadeia de caracteres
    cases.sn_app_cs_social_social_profile Sys_id do perfil de mídia social associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Perfil social [sn_app_cs_social_social_profile]
    cases.sold_product Sys_id do produto associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Produto vendido [sn_install_base_sold_product]
    cases.stage Fase da consulta, como Encerrado concluído, Encerrado rejeitado, Verificação de documento, Autorização e assim por diante.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    cases.state Estado atual do caso.

    Valores possíveis:

    • 1: Novo
    • 3: Encerrado
    • 6: Resolvido
    • 10: Aberto
    • 18: Aguardando informações

    Tipo de dados: Número (inteiro)

    Padrão: 1
    subcategoria.casos Subcategoria do caso.

    Valores possíveis:

    0: Pergunta

    Tipo de dados: Número (inteiro)

    Padrão: 0
    cases.support_manager Sys_id do gerente de CSM atribuído ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    casos.sync_driver Sinalizador que indica se há sincronização de driver.

    Valores possíveis:

    • Verdadeiro: O driver está sincronizado
    • Falso: O driver não está sincronizado

    Tipo de dados: Booliano
    cases.sys_class_name Tabela que contém o registro do caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 80
    cases.sys_domain Domínio associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 32

    Padrão: Global
    cases.sys_domain_path Caminho do domínio.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 255

    Padrão: /
    cases.sys_id Identificador exclusivo do caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 32
    task_effective_number Número de identificação.

    Se a tarefa tiver uma Solicitação universal associada a ela, será o número UR. Caso contrário, será o número da tarefa atual.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    casos.tempo_trabalhado Quantidade total de tempo trabalhado no caso.

    Tipo de dados: Cadeia de caracteres
    universal_request Sys_id de uma tarefa universal da qual esta consulta faz parte.

    Tipo de dados: Cadeia de caracteres

    Tabela: Tarefa [task]
    cases.upon_approval Ação a ser realizada se o caso for aprovado.

    Valores possíveis:

    • do_nothing
    • prosseguir

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40

    Padrão: Prosseguir
    cases.upon_reject Ação a ser realizada se o caso for rejeitado.

    Valores possíveis:

    • cancelar
    • goto

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40

    Padrão: Cancelar
    urgência Urgência do caso.

    Valores possíveis:

    • 1: Alto
    • 2: Médio
    • 3: Baixo

    Tipo de dados: Número (inteiro)

    Padrão: 3
    cases.user_input Entrada adicional do usuário.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    cases.variáveis Pares nome-valor de variáveis associadas ao caso.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 40
    casos.watch_list Lista de sys_ids dos usuários que recebem notificações sobre este caso quando comentários adicionais são adicionados ou se o estado de um caso é alterado para Resolvido ou Encerrado.

    Tipo de dados: Matriz

    Tabela: Usuário [sys_user]
    wf_activity Sys_id do registro de atividade de fluxo de trabalho associado ao caso.

    Tipo de dados: Cadeia de caracteres

    Tabela: Atividade de fluxo de trabalho [wf_activity]
    cases.work_end Data e hora em que o trabalho terminou no caso.

    Tipo de dados: Cadeia de caracteres
    casos.work_notes Informações sobre como resolver o caso ou as etapas executadas para resolvê-lo.

    Tipo de dados: Cadeia de caracteres

    Comprimento máximo: 4 000
    work_notes_list Lista de sys_ids dos usuários internos que recebem notificações sobre este caso quando anotações de trabalho são adicionadas.

    Tipo de dados: Matriz

    Tabela: Usuário [sys_user]
    casos.work_start Data e hora em que o trabalho começou no caso.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit
    Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Na resposta, o parâmetro booliano hasMoreretornado. Indica se há mais registros a serem retornados que atendem aos critérios de filtro.

    Tipo de dados: Número

    Padrão: 10
    sysparm_offset
    Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/1474a3c853500010df5dddeeff7b12ec/cases" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 10,
    "has_more": false,
    "cases": [
      {
        "upon_reject": {
          "value": "cancel",
          "display_value": "Cancel all future Tasks"
        },
        "number": "CS0001034",
        "initiated_as_request": "0",
        "state": "1",
        "case": "Performance is impacted with latest update​CS0001034",
        "knowledge": "0",
        "impact": "3",
        "contract": {
          "sys_id": "495e16b96f0731003b3c498f5d3ee4af",
          "display_value": "CNTR0000603"
        },
        "active": "1",
        "auto_created_case": "0",
        "priority": "4",
        "sys_domain_path": "/",
        "child_case_creation_progress": "0",
        "sync_driver": "0",
        "needs_attention": "0",
        "short_description": "Performance is impacted with latest update",
        "notify": "1",
        "sys_class_name": "sn_customerservice_case",
        "reassignment_count": "0",
        "notes_to_comments": "0",
        "hierarchical_variables": "variable_pool",
        "escalation": "0",
        "upon_approval": {
          "value": "proceed",
          "display_value": "Proceed to Next Task"
        },
        "made_sla": "1",
        "task_effective_number": "CS0001034",
        "opened_by": {
          "sys_id": "ddce70866f9331003b3c498f5d3ee417",
          "display_value": "George Warren"
        },
        "contact": {
          "sys_id": "ddce70866f9331003b3c498f5d3ee417",
          "display_value": "George Warren"
        },
        "follow_the_sun": "0",
        "entitlement": {
          "sys_id": "1eb7893a6f1b31003b3c498f5d3ee4dd",
          "display_value": "24x7 Customer Support"
        },
        "opened_at": {
          "value": "2023-03-20 14:53:51",
          "display_value": "2023-03-20 07:53:51"
        },
        "case_report": {
          "sys_id": "85e8604c87f521100b6afc86dabb35b9",
          "display_value": "CSR0010014"
        },
        "subcategory": "0",
        "install_base": {
          "sys_id": "1474a3c853500010df5dddeeff7b12ec",
          "display_value": "Boxeo - Development"
        },
        "proactive": "0",
        "auto_close": "0",
        "sys_id": "92c8684087b521105d0055373cbb357e",
        "contact_type": {
          "value": "web",
          "display_value": "Web"
        },
        "urgency": "3",
        "approval": {
          "value": "not requested",
          "display_value": "Not Yet Requested"
        },
        "category": "1",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      },
      {
        "upon_reject": {
          "value": "cancel",
          "display_value": "Cancel all future Tasks"
        },
        "number": "CS0001008",
        "initiated_as_request": "0",
        "state": "1",
        "case": "Test Alert​CS0001008",
        "knowledge": "0",
        "impact": "3",
        "active": "1",
        "auto_created_case": "0",
        "priority": "1",
        "sys_domain_path": "/",
        "child_case_creation_progress": "0",
        "sync_driver": "0",
        "needs_attention": "1",
        "short_description": "Test Alert",
        "notify": "1",
        "sys_class_name": "sn_customerservice_case",
        "reassignment_count": "0",
        "notes_to_comments": "0",
        "hierarchical_variables": "variable_pool",
        "escalation": "0",
        "upon_approval": {
          "value": "proceed",
          "display_value": "Proceed to Next Task"
        },
        "made_sla": "1",
        "task_effective_number": "CS0001008",
        "opened_by": {
          "sys_id": "08c83021acbe7300964fca436af2bb97",
          "display_value": "noc_operator "
        },
        "follow_the_sun": "0",
        "opened_at": {
          "value": "2023-03-15 08:02:58",
          "display_value": "2023-03-15 01:02:58"
        },
        "case_report": {
          "sys_id": "a4fa9d9a872d61105d0055373cbb356e",
          "display_value": "CSR0010005"
        },
        "subcategory": "0",
        "proactive": "1",
        "auto_close": "0",
        "sys_id": "60ea199a872d61105d0055373cbb35c9",
        "contact_type": {
          "value": "proactive",
          "display_value": "Alert"
        },
        "alert": {
          "sys_id": "506a559a872d61105d0055373cbb3581",
          "display_value": "Alert0010008"
        },
        "urgency": "3",
        "action_status": "4",
        "approval": {
          "value": "not requested",
          "display_value": "Not Yet Requested"
        },
        "category": "1"
      },
      {
        "upon_reject": {
          "value": "cancel",
          "display_value": "Cancel all future Tasks"
        },
        "number": "CS0001033",
        "initiated_as_request": "0",
        "state": "1",
        "case": "System is down​CS0001033",
        "knowledge": "0",
        "impact": "3",
        "contract": {
          "sys_id": "495e16b96f0731003b3c498f5d3ee4af",
          "display_value": "CNTR0000603"
        },
        "active": "1",
        "auto_created_case": "0",
        "priority": "4",
        "sys_domain_path": "/",
        "child_case_creation_progress": "0",
        "sync_driver": "0",
        "needs_attention": "0",
        "short_description": "System is down",
        "notify": "1",
        "sys_class_name": "sn_customerservice_case",
        "reassignment_count": "0",
        "notes_to_comments": "0",
        "hierarchical_variables": "variable_pool",
        "escalation": "0",
        "upon_approval": {
          "value": "proceed",
          "display_value": "Proceed to Next Task"
        },
        "made_sla": "1",
        "task_effective_number": "CS0001033",
        "opened_by": {
          "sys_id": "ddce70866f9331003b3c498f5d3ee417",
          "display_value": "George Warren"
        },
        "contact": {
          "sys_id": "ddce70866f9331003b3c498f5d3ee417",
          "display_value": "George Warren"
        },
        "follow_the_sun": "0",
        "entitlement": {
          "sys_id": "1eb7893a6f1b31003b3c498f5d3ee4dd",
          "display_value": "24x7 Customer Support"
        },
        "opened_at": {
          "value": "2023-03-20 14:52:48",
          "display_value": "2023-03-20 07:52:48"
        },
        "case_report": {
          "sys_id": "64b86c0c87f521100b6afc86dabb35fc",
          "display_value": "CSR0010013"
        },
        "subcategory": "0",
        "install_base": {
          "sys_id": "1474a3c853500010df5dddeeff7b12ec",
          "display_value": "Boxeo - Development"
        },
        "proactive": "0",
        "auto_close": "0",
        "sys_id": "7c98a04087b521105d0055373cbb352e",
        "contact_type": {
          "value": "web",
          "display_value": "Web"
        },
        "urgency": "3",
        "approval": {
          "value": "not requested",
          "display_value": "Not Yet Requested"
        },
        "category": "1",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      },
      {
        "upon_reject": {
          "value": "cancel",
          "display_value": "Cancel all future Tasks"
        },
        "number": "CS0001048",
        "initiated_as_request": "0",
        "state": "1",
        "case": "AIB with Single account​CS0001048",
        "knowledge": "0",
        "impact": "3",
        "active": "1",
        "auto_created_case": "0",
        "priority": "4",
        "sys_domain_path": "/",
        "child_case_creation_progress": "0",
        "sync_driver": "0",
        "needs_attention": "1",
        "short_description": "AIB with Single account",
        "notify": "1",
        "sys_class_name": "sn_customerservice_case",
        "reassignment_count": "0",
        "notes_to_comments": "0",
        "hierarchical_variables": "variable_pool",
        "escalation": "0",
        "upon_approval": {
          "value": "proceed",
          "display_value": "Proceed to Next Task"
        },
        "made_sla": "1",
        "task_effective_number": "CS0001048",
        "opened_by": {
          "sys_id": "08c83021acbe7300964fca436af2bb97",
          "display_value": "noc_operator "
        },
        "contact": {
          "sys_id": "4d147a386f0331003b3c498f5d3ee437",
          "display_value": "Julie Lewis"
        },
        "follow_the_sun": "0",
        "opened_at": {
          "value": "2023-03-24 03:28:58",
          "display_value": "2023-03-23 20:28:58"
        },
        "case_report": {
          "sys_id": "4082be81877161100b6afc86dabb35fe",
          "display_value": "CSR0010023"
        },
        "subcategory": "0",
        "proactive": "1",
        "auto_close": "0",
        "sys_id": "6a723e81877161100b6afc86dabb35cf",
        "contact_type": {
          "value": "proactive",
          "display_value": "Alert"
        },
        "alert": {
          "sys_id": "6b227681877161100b6afc86dabb35d5",
          "display_value": "Alert0010094"
        },
        "urgency": "3",
        "action_status": "4",
        "approval": {
          "value": "not requested",
          "display_value": "Not Yet Requested"
        },
        "category": "1",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/id/childinstallbaseitems

    Retorna os itens-base de instalação secundários associados a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/id/childinstallbaseitems

    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 25. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 26. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de valor de campo a serem usados para filtrar os registros do item-base de instalação secundário.Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, para retornar somente registros em que o campo de estado está definido como "in_use" e o campo de status está definido como "substituição", passe o seguinte: "in_use&status""substituição" .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos

    Tabela: Item-base de instalação [sn_install_base_item]
    sys_class_name Se estiver usando uma tabela de itens-base de instalação estendida (não sn_install_base_item), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_item
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 27. Solicitar parâmetros do corpo (XML ou JSON)
    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 28. 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 29. 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 30. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    itens Lista de itens-base de instalação que corresponderam aos resultados de filtro especificados.

    Tipo de dados: Matriz de objetos

    "items":[
  {
    "account": {Object},
    "active": "String",
    "asset": {Object},
    "configuration_item": {Object},
    "consumer": {Object},
    "consumer_profile": {Object},
    "contact": {Object},
    "health_status": {Object},
    "health_status_last_updated": "String",
    "household": {Object},
    "install_date": {Object},
    "location": {Object},
    "name": "String",
    "number": "String",
    "parent": {Object},
    "product": {Object},
    "service_context": {Object},
    "service_organization" {Object},
    "sys_class_name": "String",
    "sys_id": "String",
    "sys_mod_count": "String",
    "state": {Object},
    "status": {Object},
    "uninstall_date": "String"
  }
]
    itens.conta Detalhes sobre a conta do cliente associada ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "account": {
  "display_value": "String",
  "sys_id": "String"
}
    itens.account.display_value Nome de texto da conta do cliente associada ao registro do item-base de instalação. Use este valor para exibir o nome da conta do cliente na IU.

    Tipo de dados: Cadeia de caracteres
    account.sys_id Sys_id do registro da conta do cliente associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.ativos Sinalizador que indica se o item-base de instalação está ativo.
    Valores possíveis:
    • Verdadeiro: O item-base de instalação está ativo.
    • Falso: O item-base de instalação está inativo.

    Tipo de dados: Cadeia de caracteres booliana
    item.ativo Detalhes sobre o ativo associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "asset": {
  "display_value": "String",
  "sys_id": "String"
}
    items.asset.display_value Nome do texto do ativo associado ao registro do item-base de instalação. Use este valor para exibir o nome do ativo na IU.

    Tipo de dados: Cadeia de caracteres
    items.asset.sys_id Sys_id do registro de ativo associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.configuration_item Detalhes sobre o item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "configuration_item": {
  "display_value": "String",
  "sys_id": "String"
}
    items.configuration_item.display_value Nome do texto do item de configuração associado ao registro do item-base de instalação. Use este valor para exibir o nome do item de configuração na IU.

    Tipo de dados: Cadeia de caracteres
    items.configuration_item.sys_id Sys_id do registro do item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.consumidor Detalhes sobre o consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    items.consumer.display_value Nome de texto do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    items.consumer.sys_id Sys_id do registro do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.consumer_profile Detalhes sobre o perfil do consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo de perfil do consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer_profile": {
  "display_value": "String",
  "sys_id": "String"
}
    items.consumer_profile.display_value Nome de texto do perfil do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do perfil do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    items.consumer_profile.sys_id Sys_id do registro de perfil do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.contato Detalhes sobre o contato da conta responsável pelo registro do item-base de instalação.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    items.contact.display_value Nome de texto do contato da conta associado ao registro do item-base de instalação. Use este valor para exibir o nome do contato da conta na IU.

    Tipo de dados: Cadeia de caracteres
    items.contact.sys_id Sys_id do registro de contato da conta associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.health_status Detalhes sobre o status de integridade atual do item-base de instalação. Retornado somente se o plug-in Proactive Customer Service Operations (com.snc.proactive_cs_itom) estiver instalado.

    Tipo de dados: Objeto

    "health_status": {
  "display_value": "String",
  "value": "String"
}
    items.health_status.display_value Cadeia de caracteres de texto do status de integridade atual do item-base de instalação. Use este valor para exibir o status de integridade na IU.

    Tipo de dados: Cadeia de caracteres
    items.health_status.value Valor interno do status de integridade do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    health_status_last_updated Data e hora em que o status de integridade foi atualizado pela última vez para o item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.residência Detalhes sobre a residência associada ao registro do item-base de instalação. Retornado somente se o plug-in Residência do Atendimento ao cliente (com.snc.household) estiver instalado.

    Tipo de dados: Objeto

    "household": {
  "display_value": "String",
  "sys_id": "String"
}
    items.household.display_value Nome do texto da residência associada ao registro do item-base de instalação. Use este valor para exibir o nome da residência na IU.

    Tipo de dados: Cadeia de caracteres
    items.household.sys_id Sys_id da residência associada ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.install_date Detalhes sobre a data em que o item-base de instalação se tornou ativo.

    Tipo de dados: Objeto

    "install_date": {
  "display_value": "String",
  "value": "String"
}
    items.install_date.display_value Data de instalação de texto. Use este valor para exibir a data de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    items.install_date.value Valor interno da data de instalação.

    Tipo de dados: Cadeia de caracteres
    items.location Detalhes sobre o local do item-base de instalação.

    Tipo de dados: Objeto

    "location": {
  "display_value": "String",
  "sys_id": "String"
}
    items.location.display_value Nome do texto do local do item-base de instalação. Use este valor para exibir o nome do local na IU.

    Tipo de dados: Cadeia de caracteres
    items.location.sys_id Sys_id do registro de local associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.name Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.número ID exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.primário Detalhes sobre o registro primário do registro do item-base de instalação.

    Tipo de dados: Objeto

    "parent": {
  "display_value": "String",
  "sys_id": "String"
}
    items.parent.display_value Nome do texto do registro primário associado ao registro do item-base de instalação. Use este valor para exibir o nome primário na IU.

    Tipo de dados: Cadeia de caracteres
    items.parent.sys_id Sys_id do registro primário associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.product Detalhes sobre o modelo de produto associado ao registro do item-base de instalação. Use essas informações para identificar os serviços associados a qualquer modelo de produto.

    Tipo de dados: Objeto

    "product": {
  "display_value": "String",
  "sys_id": "String"
}
    items.product.display_value Nome do texto do modelo de produto associado ao registro do item-base de instalação. Use este valor para exibir o nome do produto na IU.

    Tipo de dados: Cadeia de caracteres
    items.product.sys_id Sys_id do registro do modelo de produto associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.service_context Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    items.service_context.display_value Nome do texto do contexto de serviço associado ao registro do item-base de instalação. Use este valor para exibir o nome do contexto de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    items.service_context.sys_id Sys_id do registro de contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    items.service_organization Detalhes sobre a organização de serviço associada ao registro do item-base de instalação. Retornado somente se o plug-in Organização de serviço (com.snc.service_organization) estiver instalado.

    Tipo de dados: Objeto

    "service_organization": {
  "display_value": "String",
  "sys_id": "String"
}
    items.service_organization.display_value Nome do texto da organização de serviço associada ao registro do item-base de instalação. Use este valor para exibir o nome da organização de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    items.service_organization.sys_id Sys_id do registro da organização de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.sys_class_name Tabela que contém o registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    sys_id Sys_id do registro do item-base de instalação. Localizado na tabela especificada em sys_class_nameparâmetro.

    Tipo de dados: Cadeia de caracteres
    itens.sys_mod_count Número de vezes que o registro do item-base de instalação associado foi modificado.

    Tipo de dados: Cadeia de caracteres
    itens.state Detalhes sobre o estado atual do item-base de instalação.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    items.state.display_value Cadeia de caracteres de texto do estado atual do item-base de instalação. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    items.state.value Valor interno do estado do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    itens.status Detalhes sobre o status do item-base de instalação.

    Tipo de dados: Objeto

    "status": {
  "display_value": "String",
  "value": "String"
}
    items.status.display_value Cadeia de caracteres de texto do status do item-base de instalação. Use este valor para exibir o status na IU.

    Tipo de dados: Cadeia de caracteres
    itens.status.valor Valor interno do status do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    uninstall_date Detalhes sobre a data em que o item-base de instalação ficou inativo.

    Tipo de dados: Objeto

    "uninstall_date": {
  "display_value": "String",
  "value": "String"
}
    uninstall_date.display_value Data de desinstalação de texto. Use este valor para exibir a data de desinstalação na IU.

    Tipo de dados: Cadeia de caracteres
    uninstall_date.value Valor interno da data de desinstalação.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_depth Número de níveis de profundidade em que o item-base de instalação secundário retornado está na hierarquia.

    Tipo de dados: Inteiro
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/767f34d378d21110f877d304c76fdd2a/childinstallbaseitems?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 1,
    "has_more": true,
    "items": [
      {
        "parent": {
          "sys_id": "767f34d378d21110f877d304c76fdd2a",
          "display_value": "X5 Sport Utility 4D"
        },
        "sys_class_name": "sn_install_base_item",
        "number": "IBITM0001005",
        "sys_id": "0704dfcc39265110f87734024cfbc222",
        "state": {
          "value": "in_use",
          "display_value": "In Use"
        },
        "consumer": {
          "sys_id": "bab5139ab3401010700b4d43c6a8dc41",
          "display_value": "Charles Barkley"
        },
        "product": {
          "sys_id": "56c84f0439265110f87734024cfbc233",
          "display_value": "Electric Power-Assist Speed-Sensing Steering"
        },
        "active": "true",
        "name": "Electric Power-Assist Speed-Sensing Steering",
        "status": {
          "value": "original",
          "display_value": "Original"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/id/contracts

    Retorna os contratos associados a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/id/contracts

    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 31. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 32. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de campo-valor a serem usados para filtrar os registros do contrato. Por padrão, faz referência aos campos na tabela Contrato [ast_contract]. Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, para retornar somente registros em que o campo Renovável está definido como "verdadeiro", passe o seguinte: &renovável: verdadeiro .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos
    sys_class_name Se estiver usando uma tabela de contratos estendidos (não ast_contract), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: ast_contract
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 33. Solicitar parâmetros do corpo (XML ou JSON)
    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 34. 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 35. 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 36. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    contratos Lista de contratos associados ao registro do item-base de instalação especificado.

    Tipo de dados: Matriz de objeto

    "contracts": [
  {
    "active": "String", 
    "approver": {Object},
    "commitment": "String",
    "consumer": {Object},
    "cost_adjustment": "String",
    "cost_adjustment_percentage": "String",
    "cost_per_unit": "String",
    "contract_composite": "String",
    "ends": "String",
    "expiration": {Object},
    "lifetime_cost": "String",
    "monthly_cost": "String",
    "number": "String",
    "payment_amount": "String",
    "payment_schedule": {Object},
    "ratecard": "String",
    "renewable": "String",
    "sales_tax": "String",
    "short_description": "String",
    "starts": "String",
    "state": {Object},
    "sub_total_cost": "String",
    "sys_class_name": "String",
    "sys_domain_path": "String",
    "sys_id": "String",
    "tax_cost": "String",
    "tax_exempt": "String",
    "tax_rate": "String",
    "total_cost": "String",
    "vendor_contract": "String",
    "yearly_cost": "String"
  }
]
    contratos.ativos Sinalizador que indica se o contrato está ativo.
    Valores possíveis:
    • Verdadeiro: O contrato está ativo.
    • Falso: O contrato está inativo.

    Tipo de dados: Cadeia de caracteres booliana
    aprovador.contratos Detalhes sobre a pessoa autorizada a aprovar o contrato.

    Tipo de dados: Objeto

    "approver": {
  "display_value": "String",
  "sys_id": "String"
}
    contracts.approver.display_value Nome do texto do aprovador associado ao registro de contratos. Use este valor para exibir o nome do aprovador na IU.

    Tipo de dados: Cadeia de caracteres
    contracts.approvador.sys_id Sys_id do registro do aprovador associado ao registro de contratos.

    Tipo de dados: Cadeia de caracteres
    contratos.consumidor Detalhes sobre o consumidor associado ao registro de contratos.
    Nota:
    O campo consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    contracts.consumer.display_value Nome do texto do consumidor associado ao registro de contratos. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    contracts.consumer.sys_id Sys_id do registro do consumidor associado ao registro de contratos.

    Tipo de dados: Cadeia de caracteres
    contracts.cost_adjustment Tipo de ajuste de custo aplicado ao contrato.

    Valores possíveis:

    • Fixo
    • Manual
    • CPI (índice de preços ao consumidor)

    Tipo de dados: Cadeia de caracteres
    contracts.cost_adjustment_percentage Aumento ou diminuição da porcentagem do preço do contrato. Para indicar uma redução no preço, insira uma porcentagem negativa. Um Ajuste de custo ou Porcentagem de ajuste de custo pode ser especificado, mas não ambos.

    Tipo de dados: Cadeia de caracteres
    contracts.cost_per_unit Custo por unidade do provedor do produto.

    Tipo de dados: Cadeia de caracteres
    contratos.termina Data em que o contrato termina.

    Tipo de dados: Cadeia de caracteres
    contratos.vencimento Detalhes sobre o status de expiração do contrato associado.

    Tipo de dados: Objeto

    "expiration": {
  "display_value": "String",
  "sys_id": "String"
}
    contracts.expiration.display_value Status de expiração do contrato associado. Use este valor para exibir o status de expiração na IU.

    Tipo de dados: Cadeia de caracteres
    contracts.expiration.sys_id Sys_id do registro de expiração associado ao registro de contratos.

    Tipo de dados: Cadeia de caracteres
    contracts.lifetime_cost Custo vitalício do contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.monthly_cost Custo mensal do contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.number Número do contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.payment_amount Valor em dinheiro que foi pago diretamente à parte receptora deste contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.payment_schedule Detalhes sobre a programação de pagamento associada ao contrato.

    Tipo de dados: Objeto

    "payment_schedule": {
  "display_value": "String",
  "sys_id": "String"
}
    contracts.payment_schedule.display_value Programação de pagamento para o contrato associado. Use este valor para exibir a programação de pagamento na IU.

    Tipo de dados: Cadeia de caracteres
    contracts.payment_schedule.value Valor interno da programação de pagamento deste contrato, como diário, semanal ou mensal.

    Tipo de dados: Cadeia de caracteres
    contracts.cartão de taxa Sinalizador que indica se há uma tabela de valores associada a este contrato.
    Valores possíveis:
    • Verdadeiro: Tabela de valores.
    • Falso: Sem tabela de valores.

    Tipo de dados: Cadeia de caracteres booliana

    Tabela: Taxa de atendimento [fm_contract_rate_card]
    contratos.renováveis Sinalizador que indica se o contrato é renovável.
    Valores possíveis:
    • Verdadeiro: O contrato é renovável.
    • Falso: O contrato não é renovável.

    Tipo de dados: Cadeia de caracteres booliana
    contracts.sales_tax Sinalizador que indica se o imposto sobre vendas é cobrado por itens referenciados por este contrato.
    Valores possíveis:
    • Verdadeiro: O imposto sobre vendas é cobrado.
    • Falso: Nenhum imposto sobre vendas é cobrado.

    Tipo de dados: Cadeia de caracteres booliana
    contratos.short_description Breve descrição do contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.inícios Data em que o contrato começa.

    Tipo de dados: Cadeia de caracteres
    contracts.state Detalhes sobre o estado atual do contrato.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    contracts.state.display_value Cadeia de caracteres de texto do estado atual do contrato. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    contracts.state.value Valor interno ou o estado do contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.sub_total_cost Subtotal do custo do contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.sys_class_name Tabela que contém o registro do contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.sys_domain_path Caminho para o domínio no qual este contrato está disponível.

    Tipo de dados: Cadeia de caracteres

    Domínio global
    contracts.sys_id Sys_id do registro de contrato associado.

    Tipo de dados: Cadeia de caracteres
    contracts.tax_cost Imposto total sobre o contrato.

    Este campo ficará visível somente se o campo Impostos aplicáveis estiver selecionado como Vendas .

    Tipo de dados: Cadeia de caracteres
    contracts.tax_isaint Sinalizador que indica se os itens associados a este contrato estão isentos de imposto.
    Valores possíveis:
    • Verdadeiro: Os itens estão isentos de impostos.
    • Falso: Os itens não estão isentos de impostos.

    Tipo de dados: Cadeia de caracteres booliana
    contracts.tax_rate Taxa de imposto cobrada por itens tributáveis associados ao contrato.

    Tipo de dados: Cadeia de caracteres
    contracts.total_cost Custo final do contrato após a aplicação de ajustes Se um contrato tiver uma ou mais tabelas de preços, este campo mostrará o valor combinado de todas as tabelas de preços.

    Tipo de dados: Cadeia de caracteres
    contracts.vendor_contract Número do contrato do fornecedor.

    Tipo de dados: Cadeia de caracteres
    contracts.yearly_cost Custo por ano do contrato.

    Tipo de dados: Cadeia de caracteres
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/167e96f053961910539dddeeff7b1298/contracts" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 10,
    "has_more": false,
    "contracts": [
      {
        "cost_adjustment_percentage": "0",
        "total_cost": "0",
        "cost_adjustment": "0",
        "tax_rate": "7.75",
        "number": "CNTR0000701",
        "tax_cost": "0",
        "sub_total_cost": "0",
        "state": {
          "value": "expired",
          "display_value": "Expired"
        },
        "starts": "2016-07-01",
        "contract_composite": "CoolMate KL300 1 year Limited Warranty\n\t\t​CNTR0000701",
        "tax_exempt": "false",
        "yearly_cost": "0",
        "active": "true",
        "payment_amount": "0",
        "commitment": "0",
        "sys_domain_path": "/",
        "payment_schedule": {
          "value": "Monthly",
          "display_value": "Monthly"
        },
        "renewable": "true",
        "expiration": {
          "sys_id": "c752e78ec3103000c111113e5bba8f3a",
          "display_value": "Expired"
        },
        "short_description": "CoolMate KL300 1 year Limited Warranty\n\t\t",
        "ratecard": "false",
        "sys_class_name": "ast_contract",
        "sys_id": "3f9db778c3302200e7c7d44d81d3ae0a",
        "ends": "2017-06-30",
        "consumer": {
          "sys_id": "59e788fbdb1b1200b6075200cf9619d2",
          "display_value": "Gilly Parker"
        },
        "approver": {
          "sys_id": "f2c0b27247702000cdd1706eecde27c8",
          "display_value": "Software Manager"
        },
        "monthly_cost": "0",
        "vendor_contract": "CNTR0000701",
        "lifetime_cost": "0",
        "sales_tax": "true",
        "cost_per_unit": "0"
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/id/entitlements

    Retorna os direitos associados a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/

    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 37. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 38. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de valor de campo a serem usados para filtrar os registros de direitos. Por padrão, faz referência aos campos na tabela Direito [service_entitlement]. Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, para retornar somente registros que estão ativos, passe o seguinte: verdadeiro .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos
    sys_class_name Se estiver usando uma tabela de direitos estendidos (não service_entitlement), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: Service_entitlement
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 39. Solicitar parâmetros do corpo (XML ou JSON)
    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 40. 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 41. 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 42. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    direitos Lista de direitos associados ao registro do item-base de instalação especificado.

    Tipo de dados: Objeto

    "entitlements": {
  "account": {Object},
  "active": "String",
  "business_hour": {Object},
  "contract": {Object},
  "end_date": "String",
  "entitlement_name": "String",
  "install_base_item": {Object},
  "per_unit": "String",
  "start_date": "String",
  "sys_id": "String",
  "total_units": "String",
  "remaining_units": "String",
  "unit": {Object}
  }
    conta.direitos Detalhes sobre a conta associada ao registro de direitos.

    Tipo de dados: Objeto

    "account": {
  "display_value": "String",
  "sys_id": "String"
}
    entitlements.account.display_value Nome do texto da conta associada ao registro de direitos. Use este valor para exibir o nome da conta na IU.

    Tipo de dados: Cadeia de caracteres
    entitlements.account.sys_id Sys_id do registro de conta associado ao registro de direitos.

    Tipo de dados: Cadeia de caracteres
    direitos.ativo Sinalizador que indica se o direito está ativo.
    Valores possíveis:
    • 0: O direito não está ativo.
    • 1: O direito está ativo.

    Tipo de dados: Cadeia de caracteres

    Padrão: 1
    entitlements.business_hour Detalhes sobre o horário comercial do registro de direitos.

    Tipo de dados: Objeto

    "business_hour": {
  "display_value": "String",
  "sys_id": "String"
}
    entitlements.business_hour.display_value Nome do texto do registro de horário comercial associado ao registro de direitos. Use este valor para exibir o horário comercial na IU.

    Tipo de dados: Cadeia de caracteres
    entitlements.business_hour.sys_id Sys_id do registro de horário comercial associado ao registro de direitos.

    Tipo de dados: Cadeia de caracteres
    direitos.contrato Detalhes sobre o contrato associado ao registro de direito.

    Tipo de dados: Objeto

    "contract": {
  "display_value": "String",
  "sys_id": "String"
}
    entitlements.contract.display_value Nome do texto do contrato associado ao registro de direito. Use este valor para exibir o nome do contrato na IU.

    Tipo de dados: Cadeia de caracteres
    entitlements.contract.sys_id Sys_id do registro do contrato associado ao registro de direito.

    Tipo de dados: Cadeia de caracteres
    end_date Data de término do direito.

    Tipo de dados: Cadeia de caracteres
    entitlement.entitlement_name Nome do direito.

    Tipo de dados: Cadeia de caracteres
    entitlements.install_base_item Detalhes sobre o item-base de instalação associado ao registro de direitos.

    Tipo de dados: Objeto

    "install_base_item": {
  "display_value": "String",
  "sys_id": "String"
}
    entitlements.install_base_item.display_value Nome de texto do item-base de instalação associado ao registro de direitos. Use este valor para exibir o nome do item-base de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    entitlements.install_base_item.sys_id Sys_id do registro do item-base de instalação associado ao registro de direitos.

    Tipo de dados: Cadeia de caracteres
    entitlements.per_unit Número de produtos em uma unidade. Por exemplo, se o unit. caso este valor seria 12 se houver 12 itens por caso.

    Tipo de dados: Cadeia de caracteres
    start_date Data de início do direito.

    Tipo de dados: Cadeia de caracteres
    entitlements.sys_id Sys_id do registro de direitos associado.

    Tipo de dados: Cadeia de caracteres
    total_units.total Número de unidades que estavam originalmente disponíveis.

    Tipo de dados: Cadeia de caracteres
    remaining_units Número de unidades restantes.

    Tipo de dados: Cadeia de caracteres
    entitlements.unit Detalhes sobre a unidade do item associado ao registro de direitos.

    Tipo de dados: Objeto

    "unit": {
  "display_value": "String",
  "value": "String"
}
    entitlements.unit.display_value Nome do texto da unidade do item associado ao registro de direitos. Use este valor para exibir o nome da unidade na IU.

    Tipo de dados: Cadeia de caracteres
    entitlements.unit.value Nome interno da unidade do item associado ao registro de direitos.

    Tipo de dados: Cadeia de caracteres
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/42746a3b876121100b6afc86dabb3597/entitlements" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 10,
    "has_more": false,
    "entitlements": [
      {
        "end_date": "2023-04-28",
        "remaining_units": "4978",
        "business_hour": {
          "sys_id": "08fcd0830a0a0b2600079f56b1adb9ae",
          "display_value": "8-5 weekdays"
        },
        "entitlement_name": "Entitlement",
        "sys_id": "7206095d87f121105d0055373cbb3504",
        "total_units": "5000",
        "start_date": "2023-03-27",
        "contract": {
          "sys_id": "495e16b96f0731003b3c498f5d3ee4af",
          "display_value": "CNTR0000603"
        },
        "active": "1",
        "install_base_item": {
          "sys_id": "42746a3b876121100b6afc86dabb3597",
          "display_value": "KX Series - KX5000"
        },
        "unit": {
          "value": "cases",
          "display_value": "Cases"
        },
        "per_unit": "0",
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/id/maintenanceplans

    Retorna os planos de manutenção associados a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base//integrations/installbaseitems/id/maintenanceplans

    URL padrão: /api/sn_install_base/integrations/installbaseitems/id/maintenanceplans

    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 43. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 44. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de campo-valor a serem usados para filtrar os registros do plano de manutenção. Por padrão, faz referência aos campos na tabela Plano de manutenção [sm_maint_plan]. Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, para retornar somente registros que estão ativos, passe o seguinte: verdadeiro .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos
    sys_class_name Se estiver usando uma tabela de planos de manutenção estendida (não planos de manutenção), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: Planos de manutenção
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 45. Solicitar parâmetros do corpo (XML ou JSON)
    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 46. 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 47. 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 48. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    planos de manutenção Lista dos planos de manutenção associados ao registro do item-base de instalação especificado.

    Tipo de dados: Matriz de objeto

    "maintenanceplans": [
  {
    "active": "String",
    "apply_to_new": "String",
    "allow_future_wo": "String",
    "maintenance_override_policy": {Object},
    "model": "String",
    "name": "String",
    "number": "String",
    "propagation_flag": "String",
    "sys_class_name": "String",
    "sys_id": "String",
    "table": "String",
    "type": {Object}
  }
]
    planos de manutenção. ​​ativo Sinalizador que indica se o plano de manutenção está ativo.
    Valores possíveis:
    • Verdadeiro: O plano de manutenção está ativo.
    • Falso: O plano de manutenção está inativo.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​apply_to_new Sinalizador que indica se os cronogramas definidos para este plano de manutenção são aplicados a todos os registros que foram adicionados à tabela especificada desde a última vez em que o plano foi executado e que atendem às condições inseridas na Condição de filtro.
    Valores possíveis:
    • Verdadeiro: Aplicado a todos os novos registros.
    • Falso: Não aplicado a todos os novos registros.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​allow_future_wo Sinalizador que indica se as ordens de serviço podem ser associadas ao plano de manutenção.
    Valores possíveis:
    • Verdadeiro: Novas ordens de serviço podem ser associadas.
    • Falso: Nenhuma nova ordem de serviço pode ser associada.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​maintenance_override_policy Detalhes sobre a política de substituição de manutenção para o plano de manutenção.

    Tipo de dados: Objeto

    "maintenance_override_policy": {
  "display_value": "String",
  "value": "String"
}
    planos de manutenção. ​​maintenance_override_policy. ​​display_value Cadeia de caracteres de texto que descreve a política de substituição. Use este valor para exibir a política de substituição na IU.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​maintenance_override_policy. ​​valor Valor interno da política de substituição.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​modelo Sys_id do registro do modelo associado ao plano de manutenção.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​número Número do plano de manutenção.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​propagation_flag Sinalizador que indica se o plano de manutenção pode ser propagado.
    Valores possíveis:
    • Verdadeiro: O plano de manutenção pode ser propagado.
    • Falso: O plano de manutenção não pode ser propagado.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​sys_class_name Tabela que contém o registro do plano de manutenção.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​sys_id Sys_id do plano de manutenção associado.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​tabela Tabela que contém o registro de tempo de base de instalação associado.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​tipo Detalhes sobre o tipo de plano de manutenção.

    Tipo de dados: Objeto

    "type": {
  "display_value": "String",
  "value": "String"
}
    planos de manutenção. ​​tipo. ​​display_value Cadeia de caracteres de texto que descreve o tipo de plano de manutenção. Use este valor para exibir o tipo na IU.

    Tipo de dados: Cadeia de caracteres
    planos de manutenção. ​​tipo. ​​valor Valor interno do tipo de plano de manutenção.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/167e96f053961910539dddeeff7b1298/maintenanceplans" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 1,
    "has_more": true,
    "maintenanceplans": [
      {
        "propagation_flag": "false",
        "active": "true",
        "type": {
          "value": "install_base",
          "display_value": "Install base"
        },
        "maintenance_override_policy": {
          "value": "do_nothing",
          "display_value": "Leave alone"
        },
        "sys_class_name": "wm_planned_work_plan",
        "allow_future_wo": "true",
        "sys_id": "0b809d70877561105d0055373cbb357f",
        "number": "WP0001026",
        "name": "Plan 10",
        "model": "8583ce8237732000158bbfc8bcbe5dd9",
        "apply_to_new": "true",
        "table": "sn_install_base_item"
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/

    Retorna as partes relacionadas associadas a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/

    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 49. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 50. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de valor de campo a serem usados para filtrar os registros de partes relacionadas. Por padrão, faz referência aos campos na tabela Partes relacionadas [sn_install_base_related_party]. Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, se você quiser filtrar uma conta específica e uma parte responsável, passe os sys_ids dos dois registros: 86837a386f0331003b3c498f5d3ee4ca&responsabilidade: c009bbedb3730010700b4d43c6a8dcef .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos
    sys_class_name Se estiver usando uma tabela de partes relacionadas estendida (não sn_install_base_related_party), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_related_party
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 51. Solicitar parâmetros do corpo (XML ou JSON)
    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 52. 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 53. 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 54. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    partes relacionadas Lista de partes relacionadas associadas ao registro do item-base de instalação especificado.

    Tipo de dados: Matriz de objetos

    "relatedparties": [
  {
    "account": {Object},
    "consumer": {Object},
    "contact": {Object},
    "install_base_item": {Object},
    "responsibility": {Object},
    "service_organization": {Object},
    "sys_class_name": "String",
    "sys_id": "String",
    "type": {Object},
    "user": {Object}
  }
]
    relatedparties.conta Detalhes sobre a conta associada ao registro de partes relacionadas.

    Tipo de dados: Objeto

    account": {
  "display_value": "String",
  "sys_id": "String"
}
    relatedpartes.account.display_value Nome do texto da conta associada ao registro de partes relacionadas. Use este valor para exibir o nome da conta na IU.

    Tipo de dados: Cadeia de caracteres
    relatedpartes.account.sys_id Sys_id do registro de conta associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    relacionadospartes.consumidor Detalhes sobre o consumidor associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    relacionadospartes.consumer.display_value Nome do texto do consumidor associado ao registro de partes relacionadas. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    relatedparties.consumer.sys_id Sys_id do registro do consumidor associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    relacionadospartes.contato Detalhes sobre o contato da conta responsável pelo registro de partes relacionadas.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    relacionadospartes.contact.display_value Nome de texto do contato associado ao registro de partes relacionadas. Use este valor para exibir o nome do contato na IU.

    Tipo de dados: Cadeia de caracteres
    relacionadospartes.contact.sys_id Sys_id do registro de contato associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    relatedparties.install_base_item Detalhes sobre o item-base de instalação associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "install_base_item": {
  "display_value": "String",
  "sys_id": "String"
}
    relatedparties.install_base_item.display_value Nome de texto do item-base de instalação associado ao registro de partes relacionadas. Use este valor para exibir o nome do item-base de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    relatedparties.install_base_item.sys_id Sys_id do registro do item-base de instalação associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    relacionadospartes.responsabilidade Detalhes sobre o nível de acesso para as informações da base de instalação.

    Tipo de dados: Objeto

    "responsibility": {
  "display_value": "String",
  "sys_id": "String"
}
    relatedparties.responsibility.display_value Valor de exibição de texto para o nível de acesso das informações da base de instalação.

    Tipo de dados: Cadeia de caracteres
    relatedparties.responsibility.sys_id Sys_id do registro de responsabilidade associado. Este registro define o nível de acesso para as informações da base de instalação.

    Este parâmetro só será válido se related_partyo campo também é especificado. Se especificado, ele retornará somente os itens-base de instalação que correspondem a ambos related_partye. responsibilityparâmetros.

    Para obter informações adicionais, consulte Configure related parties for Items Received

    Tipo de dados: Cadeia de caracteres

    Definição de responsabilidade [sn_customerservice_responsibility_def]
    relatedparties.service_organization Detalhes sobre a organização de serviço associada ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "service_organization": {
  "display_value": "String",
  "sys_id": "String"
}
    relatedparties.service_organization.display_value Nome do texto da organização de serviço associada ao registro de partes relacionadas. Use este valor para exibir o nome da organização de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    relatedparties.service_organization.sys_id Sys_id do registro da organização de serviço associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Organização de serviço [sn_customer_service_organization]
    relatedpartes.sys_class_name Tabela que contém o registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_related_party
    relatedparties.sys_id Sys_id do registro de partes relacionadas associadas.

    Tipo de dados: Cadeia de caracteres
    relacionadospartes.type Detalhes sobre o tipo de contato associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "type": {
  "display_value": "String",
  "sys_id": "String"
}
    relacionadospartes.type.display_value Nome do texto do tipo de contato associado ao registro de partes relacionadas. Use este valor para exibir o tipo de contato na IU. Para obter informações adicionais, confira Create related party configurations.
    Tipos possíveis:
    • Conta autorizada
    • Consumidor autorizado
    • Contato autorizado
    • Colaborador autorizado
    • Membro autorizado
    • Organização de serviço autorizada
    • Conta listada
    • Consumidor listado
    • Contato listado
    • Colaborador listado
    • Membro listado
    • Organização de serviço listada

    Tipo de dados: Cadeia de caracteres
    relatedparties.type.sys_id Sys_id do tipo de registro associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    relatedparties.user Detalhes sobre o usuário associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "user": {
  "display_value": "String",
  "sys_id": "String"
}
    relatedparties.user.display_value Nome do texto do usuário associado ao registro de partes relacionadas. Use este valor para exibir o nome de usuário na IU.

    Tipo de dados: Cadeia de caracteres
    relatedparties.user.sys_id
    Sys_id do registro do usuário associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/42746a3b876121100b6afc86dabb3597/relatedparties" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 10,
    "has_more": false,
    "relatedparties": [
      {
        "type": {
          "sys_id": "68ec8b2965e99110f87764df53db779f",
          "display_value": "Authorized Contact"
        },
        "install_base_item": {
          "sys_id": "42746a3b876121100b6afc86dabb3597",
          "display_value": "KX Series - KX5000"
        },
        "sys_class_name": "sn_install_base_related_party",
        "sys_id": "8547774087f561100b6afc86dabb351a",
        "responsibility": {
          "sys_id": "c009bbedb3730010700b4d43c6a8dcef",
          "display_value": "Authorized Representative"
        },
        "contact": {
          "sys_id": "dc0185d94f341200025ba3618110c77c",
          "display_value": "Cindy Contact"
        },
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/id/soldproducts

    Retorna os registros de Produtos vendidos associados a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/

    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 55. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 56. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de valor de campo a serem usados para filtrar os registros de partes relacionadas. Por padrão, faz referência aos campos na tabela Produtos vendidos [sn_install_base_sold_product]. Se você especificar uma tabela diferente em sys_class_nameespecifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, se você quiser filtrar os produtos vendidos para uma conta específica, passe algo semelhante ao seguinte, em que o valor passado é o sys_id da conta: 86837a386f0331003b3c498f5d3ee4ca .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos
    sys_class_name Se estiver usando uma tabela Produtos vendidos estendida (não sn_install_base_sold_product), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_sold_product
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.

    Este limite é aplicado antes da avaliação da ACL. Se nenhum registro for retornado, incluindo os registros aos quais você tem acesso, reorganize a ordem do registro para que os registros que você tenha acesso sejam retornados primeiro.

    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 20

    Máximo: 100
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 57. Solicitar parâmetros do corpo (XML ou JSON)
    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 58. 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 59. 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 60. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    soldprodutos Lista de produtos vendidos associados ao registro do item-base de instalação especificado.

    Tipo de dados: Matriz de objetos

    "soldproducts":[
  {
    "account": {Object},
    "contact": {Object},
    "name": "String",
    "number": "String",
    "product": {Object},
    "sys_class_name": "String",
    "sys_id": "String",
    "state": {Object}
  }
]
    soldproducts.account Detalhes sobre a conta associada ao registro do produto.

    Tipo de dados: Objeto

    account": {
  "display_value": "String",
  "sys_id": "String"
}
    soldproducts.account.display_value Nome do texto da conta associada ao registro do produto. Use este valor para exibir o nome da conta na IU.

    Tipo de dados: Cadeia de caracteres
    soldproducts.account.sys_id Sys_id do registro da conta associado ao registro do produto.

    Tipo de dados: Cadeia de caracteres
    soldproducts.contact Detalhes sobre o contato da conta responsável pelo produto.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    soldproducts.contact.display_value Nome do texto do contato associado ao produto. Use este valor para exibir o nome do contato na IU.

    Tipo de dados: Cadeia de caracteres
    soldproducts.contact.sys_id Sys_id do registro de contato associado ao registro do produto.

    Tipo de dados: Cadeia de caracteres
    soldproducts.name Nome do produto.

    Tipo de dados: Cadeia de caracteres
    soldproducts.number Número do produto.

    Tipo de dados: Cadeia de caracteres
    soldproducts.sys_class_name Tabela que contém o registro do produto.

    Tipo de dados: Cadeia de caracteres
    soldproducts.sys_id Sys_id do produto associado.

    Tipo de dados: Cadeia de caracteres
    soldproducts.state Detalhes sobre o estado atual do produto.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    soldproducts.state.display_value Cadeia de caracteres de texto do estado atual do produto. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    soldproducts.state.value Valor interno do estado do produto.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/f77c7542b7343300ece839a6ee11a991/soldproducts?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 1,
    "has_more": true,
    "soldproducts": [
      {
        "product": {
          "sys_id": "a9a2d0c3c6112276010db16c5ddd3461",
          "display_value": "Lenovo ThinkStation S20"
        },
        "sys_class_name": "sn_install_base_sold_product",
        "number": "SLPRD0001008",
        "sys_id": "17a3a7128729a1105d0055373cbb35fb",
        "contact": {
          "sys_id": "ddce70866f9331003b3c498f5d3ee417",
          "display_value": "George Warren"
        },
        "name": "SP B2B",
        "state": {
          "value": "active",
          "display_value": "Active"
        },
        "account": {
          "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
          "display_value": "Boxeo"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - OBTENHA /sn_install_base/integrations/installbaseitems/id/workorders

    Retorna as ordens de serviço associadas a um registro de item-base de instalação especificado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/id/workorders

    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 61. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 62. Parâmetros de consulta
    Nome Descrição
    pares de nome-valor do campo Pares de valor de campo a serem usados para filtrar os registros de partes relacionadas. Por padrão, faz referência aos campos na tabela Produtos vendidos [sn_install_base_sold_product]. Se você especificar uma tabela diferente em sys_class_name, em seguida, especifique os campos nessa tabela.

    Você pode passar um ou mais pares de valor de campo para filtrar os resultados de retorno.

    Por exemplo, se você quiser filtrar os produtos vendidos para uma conta específica, passe algo semelhante ao seguinte, em que o valor passado é o sys_id da conta: 86837a386f0331003b3c498f5d3ee4ca .

    Tipo de dados: Cadeia de caracteres

    Padrão: Todos os campos
    sys_class_name Se estiver usando uma tabela Produtos vendidos estendida (não sn_install_base_sold_product), o nome da tabela estendida a ser consultada.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_sold_product
    sysparm_limit Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use sysparm_offsetparâmetro para paginar a recuperação de registro.
    Nota:
    Incomum grande sysparm_limitos valores podem afetar o desempenho do sistema.

    Tipo de dados: Número

    Padrão: 10
    sysparm_offset Índice de registro inicial para o qual começar a recuperar registros. Use este valor para paginar a recuperação de registro. Esta funcionalidade permite a recuperação de todos os registros, independentemente do número de registros, em pequenos blocos gerenciáveis.

    Por exemplo, na primeira vez que você chamar este endpoint, sysparm_offsetdefinido como "0". Para simplesmente percorrer todos os registros disponíveis, use se você não tiver certeza de que você está usando o sysparm_offset até chegar ao final de todos os registros.

    Não passe um número negativo em sysparm_offsetparâmetro.

    Tipo de dados: Número

    Padrão: 0
    Tabela 63. Solicitar parâmetros do corpo (XML ou JSON)
    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 64. 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 65. 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 66. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    has_more Sinalizador que indica se há mais registros na tabela para retornar.
    Valores possíveis:
    • Verdadeiro: Mais registros a serem retornados.
    • Falso: Não há mais registros a serem retornados.

    Tipo de dados: Cadeia de caracteres booliana
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço Lista de ordens de serviço associadas ao registro do item-base de instalação especificado.

    Tipo de dados: Matriz de objetos

    "workorders":[
  {
    "active": "String",
    "approval": {Object},
    "billable": "String",
    "escalation": "String",
    "has_appointment": "String",
    "hierarchical_variables": "String",
    "impact": "String",
    "install_base_item": {Object},
    "is_catalog": "String",
    "knowledge": "String",
    "location": {Object},
    "made_sla": "String",
    "needs_attention": "String",
    "number": "String",
    "opened_at": {Object},
    "opened_by": {Object},
    "opened_for": {Object},
    "priority": "String",
    "reassignment_count": "String",
    "reschedule_maintenance_if_canceled": "String",
    "short_description": "String",
    "sla_suspended": "String",
    "state": "String",
    "sys_class_name": "String",
    "sys_domain_path": "String"
    "sys_id": "String",
    "task_created": "String",
    "task_effective_number": "String",
    "template_workflow_invoked": "String",
    "upon_approval": {Object},
    "upon_reject": {Object},
    "urgency": "String"
  }
]
    ordens de serviço.ativo Sinalizador que indica se a ordem de serviço está ativa.
    Valores possíveis:
    • Verdadeiro: A ordem de serviço está ativa.
    • Falso: A ordem de serviço está inativa.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço.aprovação Detalhes sobre o processo de aprovação atual da ordem de serviço.

    Tipo de dados: Objeto

    "approval": {
  "display_value": "String",
  "value": "String"
}
    ordens de serviço. ​approval.display_value Cadeia de caracteres de texto do estado atual do processo de aprovação. Use este valor para exibir o estado de aprovação na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​approval.value Valor interno do estado do processo de aprovação.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​faturável Sinalizador que indica se a ordem de serviço é faturável.
    Valores possíveis:
    • Verdadeiro: A ordem de serviço é faturável.
    • Falso: A ordem de serviço não é faturável

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço. ​escalação Nível de escalação da ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​has_appointment Sinalizador que indica se a ordem de serviço tem um compromisso programado.
    Valores possíveis:
    • Verdadeiro: A ordem de serviço tem um compromisso.
    • Falso: A ordem de serviço não tem um compromisso.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço. ​install_base_item Detalhes sobre o item-base de instalação associado ao registro de ordem de serviço.

    Tipo de dados: Objeto

    "install_base_item": {
  "display_value": "String",
  "sys_id": "String"
}
    ordens de serviço. ​install_base_item. ​display_value Nome de texto do item-base de instalação associado ao registro da ordem de serviço. Use este valor para exibir o nome do item-base de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​install_base_item.sys_id Sys_id do registro do item-base de instalação associado ao registro de ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​is_catalog Sinalizador que indica se faz parte de um catálogo.
    Valores possíveis:
    • Verdadeiro: A ordem de serviço faz parte de um catálogo.
    • Falso: A ordem de serviço não faz parte de um catálogo.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço.conhecimento Sinalizador que indica se há um artigo da base de conhecimento disponível para o problema de ordem de serviço especificado.

    Valores possíveis:

    • Verdadeiro: o artigo da base de conhecimento está disponível para este problema.
    • Falso: o artigo da base de conhecimento não está disponível para este problema.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço.local Detalhes sobre o local do item que precisa ser trabalhado.

    Tipo de dados: Objeto

    "location": {
  "display_value": "String",
  "sys_id": "String"
}
    ordens de serviço. ​local. ​display_value Nome do texto do local do item a ser trabalhado. Use este valor para exibir o local na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​local. ​sys_id Sys_id do registro de local associado ao registro de ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​made_sla Sinalizador que indica se o trabalho associado à ordem de serviço atendeu ao Acordo de nível de serviço (ANS) associado.
    Valores possíveis:
    • Verdadeiro: ANS foi atendido.
    • ANS não foi atendido.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço. ​needs_attention Sinalizador que indica se esta ordem de serviço precisa de atenção.
    Valores possíveis:
    • Verdadeiro: A ordem de serviço precisa de atenção.
    • Falso: A ordem de serviço não precisa de atenção.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço. ​número Número exclusivo usado para identificar a ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​opened_at Detalhes sobre quando a ordem de serviço foi aberta.

    Tipo de dados: Objeto

    "opened_at": {
  "display_value": "String",
  "value": "String"
}
    ordens de serviço. ​opened_at. ​display_value Data e hora em que a ordem de serviço foi aberta. Use este valor para exibir o valor na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​opened_at. ​valor Data e hora em que a ordem de serviço foi aberta.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​opened_by Detalhes sobre a pessoa que abriu a ordem de serviço.

    Tipo de dados: Objeto

    "opened_by": {
  "display_value": "String",
  "sys_id": "String"
}
    ordens de serviço. ​opened_by. ​display_value Nome do texto da pessoa que abriu a ordem de serviço. Use este valor para exibir este nome na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​opened_by. ​sys_id Sys_id do registro do usuário da pessoa que abriu a ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço.opened_for Detalhes sobre a pessoa para a qual a ordem de serviço foi aberta se for diferente de opened_bypessoa.

    Tipo de dados: Objeto

    "opened_for": {
  "display_value": "String",
  "sys_id": "String"
}
    ordens de serviço. ​opened_for. ​display_value Nome do texto da pessoa para a qual a ordem de serviço foi aberta. Use este valor para exibir este nome na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​opened_for. ​sys_id Sys_id do registro do usuário da pessoa para a qual a ordem de serviço foi aberta.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço.prioridade Prioridade da ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​reassignment_count Número de vezes que a ordem de serviço foi reatribuída a uma pessoa responsável por avançar a ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​reprogramar_maintenance_if_cancelled Sinalizador que indica se o trabalho deve ser reprogramado se a ordem de serviço associada for cancelada.
    Valores possíveis:
    • Reprograme o trabalho.
    • Falso: Verifique antes de reprogramar o trabalho.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço. ​short_description Breve texto que descreve o trabalho associado à ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​ans_suspenso Sinalizador que indica se o ANS associado à ordem de serviço foi suspenso.
    Valores válidos:
    • Verdadeiro: O ANS foi suspenso.
    • ANS não foi suspenso.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço.estado Estado atual da ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​sys_class_name Tabela que contém o registro da ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​sys_domain_path Caminho do domínio.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço.sys_id Sys_id do registro de ordem de serviço associado.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​task_created Sinalizador que indica se uma tarefa foi criada para esta ordem de serviço.
    Valores possíveis:
    • Verdadeiro: A tarefa foi criada para esta ordem de serviço.
    • Falso: A tarefa não foi criada para esta ordem de serviço.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço. ​task_effective_number Número exclusivo usado para identificar a ordem de serviço.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​template_workflow_invoked Sinalizador que indica se o fluxo de trabalho associado foi invocado para esta ordem de serviço.
    Valores possíveis:
    • Verdadeiro: O fluxo de trabalho foi invocado.
    • Falso: O fluxo de trabalho não foi invocado.

    Tipo de dados: Cadeia de caracteres booliana
    ordens de serviço. ​approval Detalhes sobre a próxima ação a ser tomada se a ordem de serviço for aprovada.

    Tipo de dados: Objeto

    "upon_approval": {
  "display_value": "String",
  "value": "String"
}
    ordens de serviço. ​approval. ​display_value Cadeia de caracteres de texto da ação a ser realizada se a ordem de serviço for aprovada. Use este valor para exibir essas informações na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​approval. ​valor Ação a ser realizada se a ordem de serviço for aprovada.

    Valores possíveis:

    • do_nothing
    • prosseguir

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​upon_reject Detalhes sobre a próxima ação a ser executada se a ordem de serviço for rejeitada.

    Tipo de dados: Objeto

    "upon_reject": {
  "display_value": "String",
  "value": "String"
}
    ordens de serviço. ​upon_reject. ​display_value Cadeia de caracteres de texto da ação a ser realizada se a ordem de serviço for rejeitada. Use este valor para exibir essas informações na IU.

    Tipo de dados: Cadeia de caracteres
    ordens de serviço. ​upon_reject. ​valor Ação a ser realizada se a ordem de serviço for rejeitada.

    Valores possíveis:

    • cancelar
    • goto

    Tipo de dados: Cadeia de caracteres
    ordens de serviço.urgência Urgência da ordem de serviço.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/f77c7542b7343300ece839a6ee11a991/workorders?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "sysparm_offset": 0,
    "sysparm_limit": 10,
    "has_more": false,
    "workorders": [
      {
        "upon_reject": {
          "value": "cancel",
          "display_value": "Cancel all future Tasks"
        },
        "number": "WO0010372",
        "state": "1",
        "template_workflow_invoked": "false",
        "knowledge": "false",
        "impact": "3",
        "active": "true",
        "priority": "4",
        "sys_domain_path": "/",
        "sla_suspended": "false",
        "needs_attention": "false",
        "short_description": "Test WO1",
        "sys_class_name": "wm_order",
        "reschedule_maintenance_if_canceled": "true",
        "reassignment_count": "0",
        "hierarchical_variables": "variable_pool",
        "opened_for": {
          "sys_id": "85453c616fc331003b3c498f5d3ee4fa",
          "display_value": "Jodi Seals"
        },
        "install_base_item": {
          "sys_id": "42746a3b876121100b6afc86dabb3597",
          "display_value": "KX Series - KX5000"
        },
        "has_appointment": "false",
        "escalation": "0",
        "upon_approval": {
          "value": "proceed",
          "display_value": "Proceed to Next Task"
        },
        "spam": "false",
        "made_sla": "true",
        "is_catalog": "false",
        "task_effective_number": "WO0010372",
        "opened_by": {
          "sys_id": "85453c616fc331003b3c498f5d3ee4fa",
          "display_value": "Jodi Seals"
        },
        "opened_at": {
          "value": "2023-03-20 13:33:22",
          "display_value": "2023-03-20 06:33:22"
        },
        "task_created": "false",
        "sys_id": "19761cc087b521100b6afc86dabb352f",
        "urgency": "3",
        "approval": {
          "value": "not requested",
          "display_value": "Not Yet Requested"
        },
        "billable": "false",
        "location": {
          "sys_id": "1cd145bc23070110766713d1d7bf654f",
          "display_value": "2866 Stevens Creek Blvd,Santa Clara,CA"
        }
      }
    ],
    "status": "SUCCESS"
  }
}

    Item-base de instalação - PATCH /sn_install_base/integrations/installbaseitems/

    Atualiza um registro de item-base de instalação especificado com valores de campo especificados.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitens/

    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 67. 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 68. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 69. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    conta Necessário ao criar um item-base de instalação para uma conta.

    Sys_id da conta a ser associada ao item-base de instalação.

    Nota:
    Se você passar accountparâmetro, você também não pode passar consumerparâmetro.

    Tipo de dados: Cadeia de caracteres

    Tabela: Conta [customer_account]
    ativo Sinalizador que indica se o item-base de instalação está ativo.
    Valores válidos:
    • Verdadeiro, "verdadeiro" ou "0": O item está ativo.
    • Falso, "falso" ou "1": O item não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    ativo Sys_id do ativo associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Ativo [alm_asset]
    child_install_base_items Lista de itens-base de instalação secundários associados a este item-base de instalação.
    Nota:
    Os seguintes campos de item-base de instalação secundária não podem ser diferentes de seu primário:
    • conta
    • cliente
    • contato
    • organização de serviço

    Tipo de dados: Matriz de objetos

    "child_install_base_items": [
  {
    "name": "String",
    "product": "String"
  }
]
    child_install_base_items.name Nome do item-base de instalação secundário.

    Tipo de dados: Cadeia de caracteres
    child_install_base_items.product Sys_id do registro do item base secundário associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    configuration_item Sys_id do item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item de configuração [cmdb_ci]
    cliente Necessário ao criar um item-base de instalação para um consumidor.
    Sys_id do consumidor associado ao registro do item-base de instalação.
    Nota:
    Se você passar consumerparâmetro, você também não pode passar accountparâmetro. Você só poderá associar um consumidor a um item-base de instalação se o plug-in B2B2C estiver instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Tabela: Consumidor [csm_consumer]
    consumer_profile Sys_id do perfil do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Perfil do consumidor [sn_csm_consumer_profile]
    contato
    Sys_id do registro de contato da conta que é o principal responsável pelo item-base de instalação.
    Nota:
    Os contatos só podem ser especificados para itens-base de instalação da conta.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    residência Sys_id da residência associada ao registro do item-base de instalação.
    Nota:
    Este campo só é válido quando o plug-in Residência do Atendimento ao cliente (com.snc.household) está instalado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Residência [csm_household]
    install_date Data em que o item-base de instalação se torna ativo.

    Tipo de dados: Cadeia de caracteres

    Formato: aaaa-MM-dd HH:mm:ss
    local Sys_id do local do produto associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local [cmn_location]
    nome Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    número Identificador exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Padrão: Gerado automaticamente pelo endpoint.
    primário Sys_id do registro primário deste registro de item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    product_model Sys_id do modelo de produto associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Modelo de produto [cmdb_model]
    quantidade Número de itens instalados.

    Tipo de dados: Inteiro
    service_context Sys_id do serviço associado ao IC subjacente para calcular a gravidade do impacto da Gestão de eventos. Para obter mais informações, consulte Service health status for install base.
    Nota:
    Este campo só será válido se o plug-in Proactive Customer Service Operations com Gestão de eventos estiver instalado.

    Tipo de dados: Cadeia de caracteres
    service_organization Necessário ao criar um item-base de instalação para uma organização de serviço.

    Sys_id do registro da organização de serviço envolvido na prestação de serviço ao cliente.

    Nota:
    Se você passar este parâmetro, não deverá passar também os parâmetros de conta, contato ou consumidor. . service_organizationO parâmetro só está disponível quando o plug-in Organização de serviço (com.snc.service_organization) está instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Organização de serviço [sn_customer_service_organization]
    estado Estado atual do item-base de instalação.
    Valores válidos:
    • em_uso
    • inativo

    Tipo de dados: Cadeia de caracteres
    status Status do produto.
    Valores válidos:
    • original
    • substituição

    Tipo de dados: Cadeia de caracteres
    sys_class_name Nome da tabela-base de instalação estendida na qual atualizar o registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    uninstall_date Data em que a base de instalação se torna inativa.

    Tipo de dados: Cadeia de caracteres

    Formato: aaaa-MM-dd HH:mm:ss

    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 70. 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 71. 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 72. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    item Detalhes sobre o item-base de instalação que foi atualizado.

    Tipo de dados: Objeto

    "item": {
  "account": {Object},
  "active": Boolean,
  "name": "String",
  "number": "String",
  "state": {Object},
  "sys_class_name": {Object},
  "sys_id": "String"
}
    item.conta Detalhes sobre a conta do cliente associada ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "account": {
  "display_value": "String",
  "sys_id": "String"
}
    item.account.display_value Nome de texto da conta do cliente associada ao registro do item-base de instalação. Use este valor para exibir o nome da conta do cliente na IU.

    Tipo de dados: Cadeia de caracteres
    item.account.sys_id Sys_id do registro da conta do cliente associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.ativo Sinalizador que indica se o item-base de instalação está ativo.
    Valores possíveis:
    • Verdadeiro: O item-base de instalação está ativo.
    • Falso: O item-base de instalação está inativo.

    Tipo de dados: Cadeia de caracteres booliana
    item_name Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.número ID exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.state Detalhes sobre o estado atual do item-base de instalação.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    item.state.display_value Cadeia de caracteres de texto do estado atual do item-base de instalação. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    item.state.value Valor interno do estado do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.sys_class_name Detalhes sobre a tabela que contém o item-base de instalação.

    Tipo de dados: Objeto

    "sys_class_name": {
  "display_value": "String",
  "value": "String"
}
    item.sys_class_name.display_value Cadeia de caracteres de texto do nome da tabela que contém o item-base de instalação. Use este valor para exibir o nome da tabela na IU.

    Tipo de dados: Cadeia de caracteres
    item.sys_class_name.value Valor interno da tabela que contém o item-base de instalação

    Tipo de dados: Cadeia de caracteres
    item.sys_id Sys_id do registro do item-base de instalação. Localizado na tabela especificada em sys_class_nameparâmetro.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como atualizar o nome e os campos ativos no registro do item-base de instalação.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/f77c7542b7343300ece839a6ee11a991" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"name\": \"KX Series - KX5001\",
  \"active\":true
}" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "status": "SUCCESS",
    "item": {
      "sys_class_name": {
        "value": "sn_install_base_item",
        "display_value": "Install Base Item"
      },
      "number": "IBITM0001001",
      "sys_id": "bc610d38cb76211050501ebfe8076d8b",
      "state": {
        "value": "inactive",
        "display_value": "Inactive"
      },
      "active": "false",
      "name": "NewTestIB",
      "account": {
        "sys_id": "8637a386f0331003b3c498f5d3ee4ca",
        "display_value": "Boxeo"
      }
    }
  }
}
      
}

    Item-base de instalação - PATCH /sn_install_base/integrations/installbaseitems/

    Atualiza o registro de parte relacionada especificado, associado a um item-base de instalação especificado, com os valores no corpo da solicitação.

    Se você precisar modificar o tipo de parte relacionada associada a um Item-base de instalação, remova os campos específicos do tipo do tipo de parte relacionada atual e substitua-os pelos campos específicos do tipo do novo tipo de parte relacionada. Por exemplo, para mudar de um tipo de conta autorizada para consumidor autorizado, passe o seguinte:

    • type "Consumidor autorizado"
    • account ""
    • consumer "sys_id of consumer record>"
    • responsibility "sys_id de responsabilidade do consumidor>"

    Formato de URL

    URL com controle de versão: /api/sn_install_base//integrations/installbaseitems/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/

    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 73. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    related_party_sys_id Sys_id do registro da parte relacionada.

    Tipo de dados: Cadeia de caracteres

    Tabela: Parte relacionada da base de instalação [sn_install_base_related_party]
    Tabela 74. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 75. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    conta Necessário se typeo parâmetro é um dos seguintes:
    • Conta autorizada
    • Contato autorizado
    • Conta listada
    • Contato listado

    Sys_id da conta a ser associada ao item-base de instalação.

    Nota:
    Se você passar accountparâmetro, você também não pode passar consumerparâmetro.

    Tipo de dados: Cadeia de caracteres

    Tabela: Conta [customer_account]
    cliente Necessário se typeo parâmetro é Consumidor autorizado ou Consumidor listado .
    Sys_id do consumidor associado ao registro do item-base de instalação.
    Nota:
    Se você passar consumerparâmetro, você também não pode passar accountparâmetro. Você só poderá associar um consumidor a um item-base de instalação se o plug-in B2B2C estiver instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Tabela: Consumidor [csm_consumer]
    contato Sys_id do registro de contato associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    responsabilidade Sys_id do registro de responsabilidade associado. Este registro define o nível de acesso para as informações da base de instalação.

    Este parâmetro só será válido se related_partyo campo também é especificado. Se especificado, ele retornará somente os itens-base de instalação que correspondem a ambos related_partye. responsibilityparâmetros.

    Para obter informações adicionais, consulte Configure related parties for Items Received

    Tipo de dados: Cadeia de caracteres

    Definição de responsabilidade [sn_customerservice_responsibility_def]
    service_organization Necessário se typeo parâmetro é um dos seguintes:
    • Membro autorizado
    • Organização de serviço autorizada
    • Membro listado
    • Organização de serviço listada

    Sys_id do registro da organização de serviço envolvido na prestação de serviço ao cliente.

    Nota:
    Se você passar este parâmetro, não deverá passar também os parâmetros de conta, contato ou consumidor. . service_organizationO parâmetro só está disponível quando o plug-in Organização de serviço (com.snc.service_organization) está instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Organização de serviço [sn_customer_service_organization]
    sys_class_name Tabela que contém o registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_related_party
    tipo Obrigatório. Sys_id do tipo de parte relacionada a ser criada.
    Tipos possíveis:
    • Conta autorizada
    • Consumidor autorizado
    • Contato autorizado
    • Colaborador autorizado
    • Membro autorizado
    • Organização de serviço autorizada
    • Conta listada
    • Consumidor listado
    • Contato listado
    • Colaborador listado
    • Membro listado
    • Organização de serviço listada

    Tipo de dados: Cadeia de caracteres

    Configuração de parte relacionada [sn_customerservice_related_party_configuration]
    usuário Necessário se typeo parâmetro é um dos seguintes tipos de parte relacionada:
    • Colaborador autorizado
    • Membro autorizado
    • Colaborador listado
    • Membro listado
    Sys_id do registro do usuário associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]

    Para Membro autorizado e. Membro listado este usuário deve estar associado ao especificado service_organizationregistro.

    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 76. 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 77. 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 78. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    item Detalhes sobre o registro de partes relacionadas.

    Tipo de dados: Matriz

    "item": {
  "account": {Object},
  "consumer": {Object},
  "contact": {Object},
  "install_base_item": {Object},
  "responsibility": {Object},
  "service_organization": {Object},
  "sys_class_name": "String",
  "sys_id": "String",
  "type": {Object},
  "user": {Object}
}
    item.conta Detalhes sobre a conta associada ao registro de partes relacionadas.

    Tipo de dados: Objeto

    account": {
  "display_value": "String",
  "sys_id": "String"
}
    item.account.display_value Nome do texto da conta associada ao registro de partes relacionadas. Use este valor para exibir o nome da conta na IU.

    Tipo de dados: Cadeia de caracteres
    item.account.sys_id Sys_id do registro de conta associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    item.consumidor Detalhes sobre o consumidor associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    item.consumer.display_value Nome do texto do consumidor associado ao registro de partes relacionadas. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    item.consumer.sys_id Sys_id do registro do consumidor associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    item.contato Detalhes sobre o contato da conta responsável pelo registro de partes relacionadas.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    item.contact.display_value Nome de texto do contato associado ao registro de partes relacionadas. Use este valor para exibir o nome do contato na IU.

    Tipo de dados: Cadeia de caracteres
    item.contact.sys_id Sys_id do registro de contato associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    item.install_base_item Detalhes sobre o item-base de instalação associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "install_base_item": {
  "display_value": "String",
  "sys_id": "String"
}
    item.install_base_item.display_value Nome de texto do item-base de instalação associado ao registro de partes relacionadas. Use este valor para exibir o nome do item-base de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    item.install_base_item.sys_id Sys_id do registro do item-base de instalação associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    item.responsabilidade Detalhes sobre o nível de acesso para as informações da base de instalação.

    Tipo de dados: Objeto

    "responsibility": {
  "display_value": "String",
  "sys_id": "String"
}
    item.responsibility.display_value Valor de exibição de texto para o nível de acesso das informações da base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.responsibility.sys_id Sys_id do registro de responsabilidade associado. Este registro define o nível de acesso para as informações da base de instalação.

    Este parâmetro só será válido se related_partyo campo também é especificado. Se especificado, ele retornará somente os itens-base de instalação que correspondem a ambos related_partye. responsibilityparâmetros.

    Para obter informações adicionais, consulte Configure related parties for Items Received

    Tipo de dados: Cadeia de caracteres

    Definição de responsabilidade [sn_customerservice_responsibility_def]
    item.sys_class_name Tabela que contém o registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_related_party
    item.sys_id Sys_id do registro de partes relacionadas associadas.

    Tipo de dados: Cadeia de caracteres
    item.type Detalhes sobre o tipo de contato associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "type": {
  "display_value": "String",
  "sys_id": "String"
}
    item.type.display_value Nome do texto do tipo de contato associado ao registro de partes relacionadas. Use este valor para exibir o tipo de contato na IU. Para obter informações adicionais, confira Create related party configurations.
    Tipos possíveis:
    • Conta autorizada
    • Consumidor autorizado
    • Contato autorizado
    • Colaborador autorizado
    • Membro autorizado
    • Organização de serviço autorizada
    • Conta listada
    • Consumidor listado
    • Contato listado
    • Colaborador listado
    • Membro listado
    • Organização de serviço listada

    Tipo de dados: Cadeia de caracteres
    item.type.sys_id Sys_id do tipo de registro associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    item.user Detalhes sobre o usuário associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "user": {
  "display_value": "String",
  "sys_id": "String"
}
    item.user.display_value Nome do texto do usuário associado ao registro de partes relacionadas. Use este valor para exibir o nome de usuário na IU.

    Tipo de dados: Cadeia de caracteres
    item.user.sys_id
    Sys_id do registro do usuário associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint para atualizar o registro de contato associado à parte relacionada.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/relatedparties/f77c7542b7343300ece839a6ee11a991" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"contact\": \"dc0185d94f341200025ba3618110c77c\"
}" \
--user 'username':'password'

    Resultados de retorno:

    {
"result":
  {
    "type": {
      "display_value":"Authorized Contact",
      "sys_id":"68ec8b2965e99110f87764df53db779f"
    },
    "install_base_item": {
      "display_value":"KX Series - KX5000",
      "sys_id":"f77c7542b7343300ece839a6ee11a991"
    },
    "sys_class_name":"sn_install_base_related_party",
    "sys_id":"4659539814ac6910f877ae314c1fb43a",
    "responsibility": {
      "display_value":"Authorized Representative",
      "sys_id":"c009bbedb3730010700b4d43c6a8dcef"
    },
    "contact": {
      "display_value":"Cindy Contact",
      "sys_id":"dc0185d94f341200025ba3618110c77c"
    },
    "account": {
      "display_value":"Boxeo",
      "value":"86837a386f0331003b3c498f5d3ee4ca"
    },
    "status":"SUCCESS",
  }
}

    Item-base de instalação - PATCH /sn_install_base/integrations/installbaseitems/id/uninstall

    Desinstala o item-base de instalação especificado.

    Uma desinstalação consiste em definir o. activecampo para falso e definindo o. unistall_datecampo para uma data especificada. Vazio se um valor de data não for fornecido.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitens/id/uninstall

    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 79. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 80. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 81. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    uninstall_date Data em que desinstalar o item-base de instalação especificado. Se não for especificado, ele será desinstalado imediatamente.

    Tipo de dados: Cadeia de caracteres

    Formato: aaaa-MM-dd hh:mm:ss

    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 82. 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 83. 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 84. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    item Descrição do item desinstalado.

    Tipo de dados: Objeto

    "item": {
  "account": {Object},
  "active": "String",
  "asset": {Object},
  "configuration_item": {Object},
  "consumer": {Object},
  "consumer_profile": {Object},
  "contact": {Object},
  "health_status": {Object},
  "health_status_last_updated": "String",
  "household": {Object},
  "install_date": {Object},
  "location": {Object},
  "name": "String",
  "number": "String",
  "parent": {Object},
  "product": {Object},
  "service_context": {Object},
  "service_organization" {Object},
  "sys_class_name": "String",
  "sys_id": "String",
  "state": {Object},
  "status": {Object},
  "uninstall_date": "String"
}
    item.conta Detalhes sobre a conta do cliente associada ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "account": {
  "display_value": "String",
  "sys_id": "String"
}
    item.account.display_value Nome de texto da conta do cliente associada ao registro do item-base de instalação. Use este valor para exibir o nome da conta do cliente na IU.

    Tipo de dados: Cadeia de caracteres
    item.account.sys_id Sys_id do registro da conta do cliente associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.ativo Sinalizador que indica se o item-base de instalação está ativo.
    Valores possíveis:
    • Verdadeiro: O item-base de instalação está ativo.
    • Falso: O item-base de instalação está inativo.

    Tipo de dados: Cadeia de caracteres booliana
    item.ativo Detalhes sobre o ativo associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "asset": {
  "display_value": "String",
  "sys_id": "String"
}
    item.asset.display_value Nome do texto do ativo associado ao registro do item-base de instalação. Use este valor para exibir o nome do ativo na IU.

    Tipo de dados: Cadeia de caracteres
    item.asset.sys_id Sys_id do registro de ativo associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.child_install_base_items Lista de itens-base de instalação secundários associados a este item-base de instalação.
    Nota:
    Os seguintes campos de item-base de instalação secundária não podem ser diferentes de seu primário:
    • conta
    • cliente
    • contato
    • organização de serviço

    Tipo de dados: Matriz de objetos

    "child_install_base_items": [
  {
    "name": "String",
    "product": "String"
  }
]
    item.child_install_base_items.name Nome do item-base de instalação secundário.

    Tipo de dados: Cadeia de caracteres
    item.child_install_base_items.product Sys_id do registro do item base secundário associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    item.configuration_item Detalhes sobre o item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "configuration_item": {
  "display_value": "String",
  "sys_id": "String"
}
    item.configuration_display_value Nome do texto do item de configuração associado ao registro do item-base de instalação. Use este valor para exibir o nome do item de configuração na IU.

    Tipo de dados: Cadeia de caracteres
    item.configuration_sys_id Sys_id do registro do item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.consumidor Detalhes sobre o consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    item.consumer.display_value Nome de texto do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    item.consumer.sys_id Sys_id do registro do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.consumer_profile Detalhes sobre o perfil do consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo de perfil do consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer_profile": {
  "display_value": "String",
  "sys_id": "String"
}
    item.consumer_profile.display_value Nome de texto do perfil do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do perfil do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    item.consumer_profile.sys_id Sys_id do registro de perfil do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.contato Detalhes sobre o contato da conta responsável pelo registro do item-base de instalação.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    item.contact.display_value Nome de texto do contato da conta associado ao registro do item-base de instalação. Use este valor para exibir o nome do contato da conta na IU.

    Tipo de dados: Cadeia de caracteres
    item.contact.sys_id Sys_id do registro de contato da conta associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.health_status Detalhes sobre o status de integridade atual do item-base de instalação. Retornado somente se o plug-in Proactive Customer Service Operations (com.snc.proactive_cs_itom) estiver instalado.

    Tipo de dados: Objeto

    "health_status": {
  "display_value": "String",
  "value": "String"
}
    item.health_status.display_value Cadeia de caracteres de texto do status de integridade atual do item-base de instalação. Use este valor para exibir o status de integridade na IU.

    Tipo de dados: Cadeia de caracteres
    item.health_status.value Valor interno do status de integridade do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.health_status_last_updated Data e hora em que o status de integridade foi atualizado pela última vez para o item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.residência Detalhes sobre a residência associada ao registro do item-base de instalação. Retornado somente se o plug-in Residência do Atendimento ao cliente (com.snc.household) estiver instalado.

    Tipo de dados: Objeto

    "household": {
  "display_value": "String",
  "sys_id": "String"
}
    item.household.display_value Nome do texto da residência associada ao registro do item-base de instalação. Use este valor para exibir o nome da residência na IU.

    Tipo de dados: Cadeia de caracteres
    item.household.sys_id Sys_id da residência associada ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.install_date Detalhes sobre a data em que o item-base de instalação se tornou ativo.

    Tipo de dados: Objeto

    "install_date": {
  "display_value": "String",
  "value": "String"
}
    item.install_date.display_value Data de instalação de texto. Use este valor para exibir a data de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    item.install_date.value Valor interno da data de instalação.

    Tipo de dados: Cadeia de caracteres
    item.location Detalhes sobre o local do item-base de instalação.

    Tipo de dados: Objeto

    "location": {
  "display_value": "String",
  "sys_id": "String"
}
    item.location.display_value Nome do texto do local do item-base de instalação. Use este valor para exibir o nome do local na IU.

    Tipo de dados: Cadeia de caracteres
    item.location.sys_id Sys_id do registro de local associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item_name Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.número ID exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.primário Detalhes sobre o registro primário do registro do item-base de instalação.

    Tipo de dados: Objeto

    "parent": {
  "display_value": "String",
  "sys_id": "String"
}
    item.parent.display_value Nome do texto do registro primário associado ao registro do item-base de instalação. Use este valor para exibir o nome primário na IU.

    Tipo de dados: Cadeia de caracteres
    item.parent.sys_id Sys_id do registro primário associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.product Detalhes sobre o modelo de produto associado ao registro do item-base de instalação. Use essas informações para identificar os serviços associados a qualquer modelo de produto.

    Tipo de dados: Objeto

    "product": {
  "display_value": "String",
  "sys_id": "String"
}
    item.product.display_value Nome do texto do modelo de produto associado ao registro do item-base de instalação. Use este valor para exibir o nome do produto na IU.

    Tipo de dados: Cadeia de caracteres
    item.product.sys_id Sys_id do registro do modelo de produto associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.quantidade Número de itens instalados.

    Tipo de dados: Inteiro
    item.service_context Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_context.display_value Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_context.sys_id Sys_id do registro de contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.service_organization Detalhes sobre a organização de serviço associada ao registro do item-base de instalação. Retornado somente se o plug-in Organização de serviço (com.snc.service_organization) estiver instalado.

    Tipo de dados: Objeto

    "service_organization": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_organization.display_value Nome do texto da organização de serviço associada ao registro do item-base de instalação. Use este valor para exibir o nome da organização de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    item.service_organization.sys_id Sys_id do registro da organização de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.sys_class_name Tabela que contém o registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.sys_id Sys_id do registro do item-base de instalação. Localizado na tabela especificada em sys_class_nameparâmetro.

    Tipo de dados: Cadeia de caracteres
    item.state Detalhes sobre o estado atual do item-base de instalação.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    item.state.display_value Cadeia de caracteres de texto do estado atual do item-base de instalação. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    item.state.value Valor interno do estado do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.status Detalhes sobre o status do item-base de instalação.

    Tipo de dados: Objeto

    "status": {
  "display_value": "String",
  "value": "String"
}
    item.status.display_value Cadeia de caracteres de texto do status do item-base de instalação. Use este valor para exibir o status na IU.

    Tipo de dados: Cadeia de caracteres
    item.status.valor Valor interno do status do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.uninstall_date Detalhes sobre a data em que o item-base de instalação ficou inativo.

    Tipo de dados: Objeto

    "uninstall_date": {
  "display_value": "String",
  "value": "String"
}
    item.uninstall_date.display_value Data de desinstalação de texto. Use este valor para exibir a data de desinstalação na IU.

    Tipo de dados: Cadeia de caracteres
    item.uninstall_date.value Valor interno da data de desinstalação.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems/42746a3b876121100b6afc86dabb3597/uninstall" \
--request PATCH \
--header "Accept:application/json" \
--user 'username':'password'

    Resultados de retorno:

    {
  "result": {
    "status": "SUCCESS",
    "item": {
      "sys_class_name": {
        "value": "sn_install_base_item",
        "display_value": "Install Base Item"
      },
      "number": "IBITM0000901",
      "sys_id": "f77c7542b7343300ece839a6ee11a991",
      "contact": {
        "sys_id": "4d147a386f0331003b3c498f5d3ee437",
        "display_value": "Julie Lewis"
      },
      "state": {
        "value": "inactive",
        "display_value": "Inactive"
      },
      "active": "false",
      "configuration_item": {
        "sys_id": "e5a28e07c30202001efd5cb981d3aedb",
        "display_value": "KX Series - KX5000"
      },
      "name": "KX Series - KX5000",
      "account": {
        "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
        "display_value": "Boxeo"
      }
    }
  }
}

    Item-base de instalação - POST /sn_install_base/integrations/installbaseitens

    Cria um ou mais registros de item-base de instalação na tabela Item-base de instalação padrão ou em sua tabela estendida, se especificada, e preenche-os com os valores de campo especificados.

    Ao criar um único registro de item-base de instalação, você passa um objeto no corpo da solicitação que contém todos os campos a serem incluídos no corpo da solicitação. Ao criar vários registros de item-base de instalação em uma única chamada, você passa uma matriz de objetos no corpo da solicitação que contém todos os registros a serem criados. O endpoint processa e relata cada um dos objetos de criação de registro individualmente. Se um ou mais registros não forem criados, isso não afetará a criação de outro registro.

    Formato de URL

    URL com controle de versão: /api/sn_install_base//integrations/installbaseitens

    URL padrão: /api/sn_install_base/integrations/installbaseitens

    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 85. 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 86. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 87. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    conta Necessário ao criar um item-base de instalação para uma conta.

    Sys_id da conta a ser associada ao item-base de instalação.

    Nota:
    Se você passar accountparâmetro, você também não pode passar consumerparâmetro.

    Tipo de dados: Cadeia de caracteres

    Tabela: Conta [customer_account]
    ativo Sinalizador que indica se o item-base de instalação está ativo.
    Valores válidos:
    • Verdadeiro, "verdadeiro" ou "0": O item está ativo.
    • Falso, "falso" ou "1": O item não está ativo.

    Tipo de dados: Booliano

    Padrão: verdadeiro
    ativo Sys_id do ativo associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Ativo [alm_asset]
    child_install_base_items Lista de itens-base de instalação secundários associados a este item-base de instalação.
    Nota:
    Os seguintes campos de item-base de instalação secundária não podem ser diferentes de seu primário:
    • conta
    • cliente
    • contato
    • organização de serviço

    Tipo de dados: Matriz de objetos

    "child_install_base_items": [
  {
    "name": "String",
    "product": "String"
  }
]
    child_install_base_items.name Nome do item-base de instalação secundário.

    Tipo de dados: Cadeia de caracteres
    child_install_base_items.product Sys_id do registro do item base secundário associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    configuration_item Sys_id do item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item de configuração [cmdb_ci]
    cliente Necessário ao criar um item-base de instalação para um consumidor.
    Sys_id do consumidor associado ao registro do item-base de instalação.
    Nota:
    Se você passar consumerparâmetro, você também não pode passar accountparâmetro. Você só poderá associar um consumidor a um item-base de instalação se o plug-in B2B2C estiver instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Tabela: Consumidor [csm_consumer]
    consumer_profile Sys_id do perfil do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Perfil do consumidor [sn_csm_consumer_profile]
    contato
    Sys_id do registro de contato da conta que é o principal responsável pelo item-base de instalação.
    Nota:
    Os contatos só podem ser especificados para itens-base de instalação da conta.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    residência Sys_id da residência associada ao registro do item-base de instalação.
    Nota:
    Este campo só é válido quando o plug-in Residência do Atendimento ao cliente (com.snc.household) está instalado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Residência [csm_household]
    install_date Data em que o item-base de instalação se torna ativo.

    Tipo de dados: Cadeia de caracteres

    Formato: aaaa-MM-dd HH:mm:ss
    local Sys_id do local do produto associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Local [cmn_location]
    nome Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    número Identificador exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Padrão: Gerado automaticamente pelo endpoint.
    primário Sys_id do registro primário deste registro de item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    product_model Sys_id do modelo de produto associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Modelo de produto [cmdb_model]
    quantidade Número de itens instalados.

    Tipo de dados: Inteiro
    service_context Sys_id do serviço associado ao IC subjacente para calcular a gravidade do impacto da Gestão de eventos. Para obter mais informações, consulte Service health status for install base.
    Nota:
    Este campo só será válido se o plug-in Proactive Customer Service Operations com Gestão de eventos estiver instalado.

    Tipo de dados: Cadeia de caracteres
    service_organization Necessário ao criar um item-base de instalação para uma organização de serviço.

    Sys_id do registro da organização de serviço envolvido na prestação de serviço ao cliente.

    Nota:
    Se você passar este parâmetro, não deverá passar também os parâmetros de conta, contato ou consumidor. . service_organizationO parâmetro só está disponível quando o plug-in Organização de serviço (com.snc.service_organization) está instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Organização de serviço [sn_customer_service_organization]
    estado Estado atual do item-base de instalação.
    Valores válidos:
    • em_uso
    • inativo

    Tipo de dados: Cadeia de caracteres
    status Status do produto.
    Valores válidos:
    • original
    • substituição

    Tipo de dados: Cadeia de caracteres
    sys_class_name Nome da tabela-base de instalação estendida na qual o registro do item-base de instalação será criado.

    Tipo de dados: Cadeia de caracteres

    Padrão: Tabela Item-base de instalação [sn_install_base_item]
    uninstall_date Data em que a base de instalação se torna inativa.

    Tipo de dados: Cadeia de caracteres

    Formato: aaaa-MM-dd HH:mm:ss

    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 88. 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 89. 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 90. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    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 (JSON ou XML)

    Nome Descrição
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    item Item-base de instalação que correspondeu aos resultados de filtro especificados. Somente campos não vazios são retornados.

    Tipo de dados: Matriz de objetos

    "item": {
  "account": {Object},
  "active": "String",
  "asset": {Object},
  "child_install_base_items": {Object},
  "condition": "String",
  "configuration_item": {Object},
  "consumer": {Object},
  "consumer_profile": {Object},
  "contact": {Object},
  "health_status": {Object},
  "health_status_last_updated": "String",
  "household": {Object},
  "install_date": {Object},
  "location": {Object},
  "name": "String",
  "number": "String",
  "parent": {Object},
  "product": {Object},
  "quantity": Integer,
  "service_context": {Object},
  "service_organization" {Object},
  "sys_id": "String",
  "state": {Object},
  "status": {Object},
  "uninstall_date": "String"
}
    item.conta Detalhes sobre a conta do cliente associada ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "account": {
  "display_value": "String",
  "sys_id": "String"
}
    item.account.display_value Nome de texto da conta do cliente associada ao registro do item-base de instalação. Use este valor para exibir o nome da conta do cliente na IU.

    Tipo de dados: Cadeia de caracteres
    item.account.sys_id Sys_id do registro da conta do cliente associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.ativo Sinalizador que indica se o item-base de instalação está ativo.
    Valores possíveis:
    • Verdadeiro: O item-base de instalação está ativo.
    • Falso: O item-base de instalação está inativo.

    Tipo de dados: Cadeia de caracteres booliana
    item.ativo Detalhes sobre o ativo associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "asset": {
  "display_value": "String",
  "sys_id": "String"
}
    item.asset.display_value Nome do texto do ativo associado ao registro do item-base de instalação. Use este valor para exibir o nome do ativo na IU.

    Tipo de dados: Cadeia de caracteres
    item.asset.sys_id Sys_id do registro de ativo associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.child_install_base_items Lista de itens-base de instalação secundários associados a este item-base de instalação.
    Nota:
    Os seguintes campos de item-base de instalação secundária não podem ser diferentes de seu primário:
    • conta
    • cliente
    • contato
    • organização de serviço

    Tipo de dados: Matriz de objetos

    "child_install_base_items": [
  {
    "name": "String",
    "product": "String"
  }
]
    item.child_install_base_items.name Nome do item-base de instalação secundário.

    Tipo de dados: Cadeia de caracteres
    item.child_install_base_items.product Sys_id do registro do item base secundário associado.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    item.configuration_item Detalhes sobre o item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "configuration_item": {
  "display_value": "String",
  "sys_id": "String"
}
    item.configuration_item.display_value Nome do texto do item de configuração associado ao registro do item-base de instalação. Use este valor para exibir o nome do item de configuração na IU.

    Tipo de dados: Cadeia de caracteres
    item.configuration_item.sys_id Sys_id do registro do item de configuração associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.consumidor Detalhes sobre o consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    item.consumer.display_value Nome de texto do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    item.consumer.sys_id Sys_id do registro do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.consumer_profile Detalhes sobre o perfil do consumidor associado ao registro do item-base de instalação.
    Nota:
    O campo de perfil do consumidor só estará disponível se o plug-in B2B2C estiver instalado.

    Tipo de dados: Objeto

    "consumer_profile": {
  "display_value": "String",
  "sys_id": "String"
}
    item.consumer_profile.display_value Nome de texto do perfil do consumidor associado ao registro do item-base de instalação. Use este valor para exibir o nome do perfil do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    item.consumer_profile.sys_id Sys_id do registro de perfil do consumidor associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.contato Detalhes sobre o contato da conta responsável pelo registro do item-base de instalação.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    item.contact.display_value Nome de texto do contato da conta associado ao registro do item-base de instalação. Use este valor para exibir o nome do contato da conta na IU.

    Tipo de dados: Cadeia de caracteres
    item.contact.sys_id Sys_id do registro de contato da conta associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.health_status Detalhes sobre o status de integridade atual do item-base de instalação. Retornado somente se o plug-in Proactive Customer Service Operations (com.snc.proactive_cs_itom) estiver instalado.

    Tipo de dados: Objeto

    "health_status": {
  "display_value": "String",
  "value": "String"
}
    item.health_status.display_value Cadeia de caracteres de texto do status de integridade atual do item-base de instalação. Use este valor para exibir o status de integridade na IU.

    Tipo de dados: Cadeia de caracteres
    item.health_status.value Valor interno do status de integridade do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.health_status_last_updated Data e hora em que o status de integridade foi atualizado pela última vez para o item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.residência Detalhes sobre a residência associada ao registro do item-base de instalação. Retornado somente se o plug-in Residência do Atendimento ao cliente (com.snc.household) estiver instalado.

    Tipo de dados: Objeto

    "household": {
  "display_value": "String",
  "sys_id": "String"
}
    item.household.display_value Nome do texto da residência associada ao registro do item-base de instalação. Use este valor para exibir o nome da residência na IU.

    Tipo de dados: Cadeia de caracteres
    item.household.sys_id Sys_id da residência associada ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.install_date Detalhes sobre a data em que o item-base de instalação se tornou ativo.

    Tipo de dados: Objeto

    "install_date": {
  "display_value": "String",
  "value": "String"
}
    item.install_date.display_value Data de instalação de texto. Use este valor para exibir a data de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    item.install_date.value Valor interno da data de instalação.

    Tipo de dados: Cadeia de caracteres
    item.location Detalhes sobre o local do item-base de instalação.

    Tipo de dados: Objeto

    "location": {
  "display_value": "String",
  "sys_id": "String"
}
    item.location.display_value Nome do texto do local do item-base de instalação. Use este valor para exibir o nome do local na IU.

    Tipo de dados: Cadeia de caracteres
    item.location.sys_id Sys_id do registro de local associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item_name Nome do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.número ID exclusivo do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.primário Detalhes sobre o registro primário do registro do item-base de instalação.

    Tipo de dados: Objeto

    "parent": {
  "display_value": "String",
  "sys_id": "String"
}
    item.parent.display_value Nome do texto do registro primário associado ao registro do item-base de instalação. Use este valor para exibir o nome primário na IU.

    Tipo de dados: Cadeia de caracteres
    item.parent.sys_id Sys_id do registro primário associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.product Detalhes sobre o modelo de produto associado ao registro do item-base de instalação. Use essas informações para identificar os serviços associados a qualquer modelo de produto.

    Tipo de dados: Objeto

    "product": {
  "display_value": "String",
  "sys_id": "String"
}
    item.product.display_value Nome do texto do modelo de produto associado ao registro do item-base de instalação. Use este valor para exibir o nome do produto na IU.

    Tipo de dados: Cadeia de caracteres
    item.product.sys_id Sys_id do registro do modelo de produto associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.quantidade Número de itens instalados.

    Tipo de dados: Inteiro
    item.service_context Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_context.display_value Detalhes sobre o contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Objeto

    "service_context": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_context.sys_id Sys_id do registro de contexto de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.service_organization Detalhes sobre a organização de serviço associada ao registro do item-base de instalação. Retornado somente se o plug-in Organização de serviço (com.snc.service_organization) estiver instalado.

    Tipo de dados: Objeto

    "service_organization": {
  "display_value": "String",
  "sys_id": "String"
}
    item.service_organization.display_value Nome do texto da organização de serviço associada ao registro do item-base de instalação. Use este valor para exibir o nome da organização de serviço na IU.

    Tipo de dados: Cadeia de caracteres
    item.service_organization.sys_id Sys_id do registro da organização de serviço associado ao registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.sys_class_name Tabela que contém o registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.sys_id Sys_id do registro do item-base de instalação. Localizado na tabela especificada em sys_class_nameparâmetro.

    Tipo de dados: Cadeia de caracteres
    item.state Detalhes sobre o estado atual do item-base de instalação.

    Tipo de dados: Objeto

    "state": {
  "display_value": "String",
  "value": "String"
}
    item.state.display_value Cadeia de caracteres de texto do estado atual do item-base de instalação. Use este valor para exibir o estado na IU.

    Tipo de dados: Cadeia de caracteres
    item.state.value Valor interno do estado do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.status Detalhes sobre o status do item-base de instalação.

    Tipo de dados: Objeto

    "status": {
  "display_value": "String",
  "value": "String"
}
    item.status.display_value Cadeia de caracteres de texto do status do item-base de instalação. Use este valor para exibir o status na IU.

    Tipo de dados: Cadeia de caracteres
    item.status.valor Valor interno do status do item-base de instalação.

    Tipo de dados: Cadeia de caracteres
    item.uninstall_date Detalhes sobre a data em que o item-base de instalação ficou inativo.

    Tipo de dados: Objeto

    "uninstall_date": {
  "display_value": "String",
  "value": "String"
}
    item.uninstall_date.display_value Data de desinstalação de texto. Use este valor para exibir a data de desinstalação na IU.

    Tipo de dados: Cadeia de caracteres
    item.uninstall_date.value Valor interno da data de desinstalação.

    Tipo de dados: Cadeia de caracteres
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres

    Solicitação de curl

    O exemplo de código a seguir mostra como criar um único registro de Item-base de instalação.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"name\":\"Base Monitor\",
  \"quantity\": 4,
  \"account\":\"86837a386f0331003b3c498f5d3ee4ca\",
  \"contact\": \"dc0185d94f341200025ba3618110c77c\",
  \"configuration_item\":\"0c43baaac61122750182c132ee74bcf0\",
  \"state\":\"in_use\"
}" \
--user 'username':'password'

    Resultados de retorno: Somente campos não vazios são retornados.

    {
  "result": {
    "status": "SUCCESS",
    "item": {
      "sys_class_name": "sn_install_base_item",
      "number": "IBITM0001003",
      "sys_id": "27cb093114c66910f877324710112fd6",
      "contact": {
        "sys_id": "dc0185d94f341200025ba3618110c77c",
        "display_value": "Cindy Contact"
      },
      "state": {
        "value": "in_use",
        "display_value": "In Use"
      },
      "quantity": "4",
      "active": "true",
      "configuration_item": {
        "sys_id": "0c43baaac61122750182c132ee74bcf0",
        "display_value": "3D Pinball"
      },
      "name": "Base Monitor",
      "account": {
        "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
        "display_value": "Boxeo"
      }
    }
  }
}

    Solicitação de curl

    O exemplo de código a seguir mostra como criar vários registros de Item-base de instalação.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/installbaseitems" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "[
  {
    \"name\":\"AST4 Laptop\",
    \"consumer\":\"b119803fdb1b1200b6075200cf961917\",
    \"status\":\"replacement\",
    \"install_date\":\"2023-05-18 12:00:00\",
    \"uninstall_date\":\"2023-09-28 12:00:00\"
  },
{
    \"name\":\"Base Monitor\",
    \"quantity\": 4,
    \"account\":\"86837a386f0331003b3c498f5d3ee4ca\",
    \"contact\": \"dc0185d94f341200025ba3618110c77c\",
    \"configuration_item\":\"0c43baaac61122750182c132ee74bcf0\",
    \"state\":\"in_use\"
  }
]" \
--user 'username':'password'

    Resultados de retorno: Somente campos não vazios são retornados.

    {
  "result": {
    "status": "SUCCESS",
    "items": [
      {
        "status": "SUCCESS",
        "item": {
          "sys_class_name": "sn_install_base_item",
          "number": "IBITM0001018",
          "sys_id": "16fe91b1140a6910f877324710112f40",
          "uninstall_date": {
            "value": "2023-09-28 12:00:00",
            "display_value": "2023-09-28 05:00:00"
          },
          "install_date": {
            "value": "2023-05-18 12:00:00",
            "display_value": "2023-05-18 05:00:00"
          },
          "consumer": {
            "sys_id": "b119803fdb1b1200b6075200cf961917",
            "display_value": "Silvester Erik"
          },
          "active": "true",
          "name": "AST4 Laptop",
          "status": {
            "value": "replacement",
            "display_value": "Replacement"
          }
        }
      },
      {
        "status": "SUCCESS",
        "item": {
          "sys_class_name": "sn_install_base_item",
          "number": "IBITM0001019",
          "sys_id": "5efe91b1140a6910f877324710112f40",
          "contact": {
            "sys_id": "dc0185d94f341200025ba3618110c77c",
            "display_value": "Cindy Contact"
          },
          "state": {
            "value": "in_use",
            "display_value": "In Use"
          },
          "quantity": "4",
          "active": "true",
          "configuration_item": {
            "sys_id": "0c43baaac61122750182c132ee74bcf0",
            "display_value": "3D Pinball"
          },
          "name": "Base Monitor",
          "account": {
            "sys_id": "86837a386f0331003b3c498f5d3ee4ca",
            "display_value": "Boxeo"
          }
        }
      }
    ]
  }
}

    Item-base de instalação - POST /sn_install_base/integrations/installbaseitems/

    Cria um registro de parte relacionada e o associa a um registro de item-base de instalação especificado. Os valores especificados nos parâmetros de solicitação são armazenados no registro da parte relacionada recém-criado.

    Formato de URL

    URL com controle de versão: /api/sn_install_base/

    URL padrão: /api/sn_install_base/integrations/installbaseitems/

    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 91. 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
    id Sys_id do registro do item-base de instalação.

    Tipo de dados: Cadeia de caracteres

    Tabela: Item-base de instalação [sn_install_base_item]
    Tabela 92. Parâmetros de consulta
    Nome Descrição
    Nenhum(a)
    Tabela 93. Solicitar parâmetros do corpo (XML ou JSON)
    Nome Descrição
    conta Necessário se typeo parâmetro é um dos seguintes:
    • Conta autorizada
    • Contato autorizado
    • Conta listada
    • Contato listado

    Sys_id da conta a ser associada ao item-base de instalação.

    Nota:
    Se você passar accountparâmetro, você também não pode passar consumerparâmetro.

    Tipo de dados: Cadeia de caracteres

    Tabela: Conta [customer_account]
    cliente Necessário se typeo parâmetro é Consumidor autorizado ou Consumidor listado .
    Sys_id do consumidor associado ao registro do item-base de instalação.
    Nota:
    Se você passar consumerparâmetro, você também não pode passar accountparâmetro. Você só poderá associar um consumidor a um item-base de instalação se o plug-in B2B2C estiver instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Tabela: Consumidor [csm_consumer]
    contato Sys_id do registro de contato associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    install_base_item Sys_id do registro do item-base de instalação associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    responsabilidade Sys_id do registro de responsabilidade associado. Este registro define o nível de acesso para as informações da base de instalação.

    Este parâmetro só será válido se related_partyo campo também é especificado. Se especificado, ele retornará somente os itens-base de instalação que correspondem a ambos related_partye. responsibilityparâmetros.

    Para obter informações adicionais, consulte Configure related parties for Items Received

    Tipo de dados: Cadeia de caracteres

    Definição de responsabilidade [sn_customerservice_responsibility_def]
    service_organization Necessário se typeo parâmetro é um dos seguintes:
    • Membro autorizado
    • Organização de serviço autorizada
    • Membro listado
    • Organização de serviço listada

    Sys_id do registro da organização de serviço envolvido na prestação de serviço ao cliente.

    Nota:
    Se você passar este parâmetro, não deverá passar também os parâmetros de conta, contato ou consumidor. . service_organizationO parâmetro só está disponível quando o plug-in Organização de serviço (com.snc.service_organization) está instalado em sua instância.

    Tipo de dados: Cadeia de caracteres

    Organização de serviço [sn_customer_service_organization]
    sys_class_name Tabela que contém o registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_related_party
    tipo Obrigatório. Sys_id do tipo de parte relacionada a ser criada.
    Tipos possíveis:
    • Conta autorizada
    • Consumidor autorizado
    • Contato autorizado
    • Colaborador autorizado
    • Membro autorizado
    • Organização de serviço autorizada
    • Conta listada
    • Consumidor listado
    • Contato listado
    • Colaborador listado
    • Membro listado
    • Organização de serviço listada

    Tipo de dados: Cadeia de caracteres

    Configuração de parte relacionada [sn_customerservice_related_party_configuration]
    usuário Necessário se typeo parâmetro é um dos seguintes tipos de parte relacionada:
    • Colaborador autorizado
    • Membro autorizado
    • Colaborador listado
    • Membro listado

    Para Membro autorizado e. Membro listado este usuário deve estar associado ao especificado service_organizationregistro.

    Sys_id do registro do usuário associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]

    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 94. 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
    Tipo de conteúdo Formato de dados do corpo da solicitação. Tipos compatíveis: application/jsonou application/xml.

    Padrão: application/json
    Tabela 95. 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 96. 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.
    403 Proibido. O usuário não tem direitos de acesso ao registro especificado.
    404 Não encontrado. O item solicitado não foi encontrado.
    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 (JSON ou XML)

    Nome Descrição
    conta Detalhes sobre a conta associada ao registro de partes relacionadas.

    Tipo de dados: Objeto

    account": {
  "display_value": "String",
  "sys_id": "String"
}
    account.display_value Nome do texto da conta associada ao registro de partes relacionadas. Use este valor para exibir o nome da conta na IU.

    Tipo de dados: Cadeia de caracteres
    account.sys_id Sys_id do registro de conta associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    cliente Detalhes sobre o consumidor associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "consumer": {
  "display_value": "String",
  "sys_id": "String"
}
    consumer.display_value Nome do texto do consumidor associado ao registro de partes relacionadas. Use este valor para exibir o nome do consumidor na IU.

    Tipo de dados: Cadeia de caracteres
    consumer.sys_id Sys_id do registro do consumidor associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    contato Detalhes sobre o contato da conta responsável pelo registro de partes relacionadas.

    Tipo de dados: Objeto

    "contact": {
  "display_value": "String",
  "sys_id": "String"
}
    contact.display_value Nome de texto do contato associado ao registro de partes relacionadas. Use este valor para exibir o nome do contato na IU.

    Tipo de dados: Cadeia de caracteres
    contact.sys_id Sys_id do registro de contato associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Contato [customer_contact]
    erro Detalhes sobre o erro que ocorreu ao tentar processar a solicitação.

    Tipo de dados: Objeto

    "error": {
  "detail": "String",
  "message": "String"
}
    error.detail Detalhes adicionais sobre o erro associado.

    Tipo de dados: Cadeia de caracteres
    mensagem.erro Mensagem de erro que descreve o problema que ocorreu ao tentar executar a solicitação.

    Tipo de dados: Cadeia de caracteres
    install_base_item Detalhes sobre o item-base de instalação associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "install_base_item": {
  "display_value": "String",
  "sys_id": "String"
}
    install_base_item.display_value Nome de texto do item-base de instalação associado ao registro de partes relacionadas. Use este valor para exibir o nome do item-base de instalação na IU.

    Tipo de dados: Cadeia de caracteres
    install_base_item.sys_id Sys_id do registro do item-base de instalação associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    responsabilidade Detalhes sobre o nível de acesso para as informações da base de instalação.

    Tipo de dados: Objeto

    "responsibility": {
  "display_value": "String",
  "sys_id": "String"
}
    display_value.display_value Valor de exibição de texto para o nível de acesso das informações da base de instalação.

    Tipo de dados: Cadeia de caracteres
    sys_id.sys_id Sys_id do registro de responsabilidade associado. Este registro define o nível de acesso para as informações da base de instalação.

    Este parâmetro só será válido se related_partyo campo também é especificado. Se especificado, ele retornará somente os itens-base de instalação que correspondem a ambos related_partye. responsibilityparâmetros.

    Para obter informações adicionais, consulte Configure related parties for Items Received

    Tipo de dados: Cadeia de caracteres

    Definição de responsabilidade [sn_customerservice_responsibility_def]
    status Status da chamada de endpoint.

    Tipo de dados: Cadeia de caracteres
    sys_class_name Tabela que contém o registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Padrão: sn_install_base_related_party
    sys_id Sys_id do registro de partes relacionadas associadas.

    Tipo de dados: Cadeia de caracteres
    sysparm_limit Número de registros retornados. Se este valor não for especificado na solicitação original, ele usará o valor padrão.

    Tipo de dados: Número
    sysparm_offset Deslocamento (ponto de partida) na tabela associada da qual os registros foram avaliados e recuperados.

    Tipo de dados: Cadeia de caracteres
    tipo Detalhes sobre o tipo de contato associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "type": {
  "display_value": "String",
  "sys_id": "String"
}
    type.display_value Nome do texto do tipo de contato associado ao registro de partes relacionadas. Use este valor para exibir o tipo de contato na IU. Para obter informações adicionais, confira Create related party configurations.
    Tipos possíveis:
    • Conta autorizada
    • Consumidor autorizado
    • Contato autorizado
    • Colaborador autorizado
    • Membro autorizado
    • Organização de serviço autorizada
    • Conta listada
    • Consumidor listado
    • Contato listado
    • Colaborador listado
    • Membro listado
    • Organização de serviço listada

    Tipo de dados: Cadeia de caracteres
    type.sys_id Sys_id do tipo de registro associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres
    usuário Detalhes sobre o usuário associado ao registro de partes relacionadas.

    Tipo de dados: Objeto

    "user": {
  "display_value": "String",
  "sys_id": "String"
}
    user.display_value Nome do texto do usuário associado ao registro de partes relacionadas. Use este valor para exibir o nome de usuário na IU.

    Tipo de dados: Cadeia de caracteres
    user.sys_id
    Sys_id do registro do usuário associado ao registro de partes relacionadas.

    Tipo de dados: Cadeia de caracteres

    Tabela: Usuário [sys_user]

    Solicitação de curl

    O exemplo de código a seguir mostra como chamar este endpoint para criar um registro relacionado à conta autorizada e associá-lo a um item-base de instalação.

    curl "https://instance.servicenow.com/api/sn_install_base/integrations/relatedparties/f77c7542b7343300ece839a6ee11a991" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  "contact":"0a232a0013691200042ab3173244b075",
  "type":"68ec8b2965e99110f87764df53db779f",
  "account":"86837a386f0331003b3c498f5d3ee4ca",
  "install_base_item":"f77c7542b7343300ece839a6ee11a991",
  "responsibility":"c009bbedb3730010700b4d43c6a8dcef",
  "sys_class_name":"sn_install_base_related_party"
}" \
--user 'username':'password'

    Resultados de retorno:

    {
"result":
  {
    "type": {
      "display_value":"Authorized Contact",
      "sys_id":"68ec8b2965e99110f87764df53db779f"
    },
    "install_base_item": {
      "display_value":"KX Series - KX5000",
      "sys_id":"f77c7542b7343300ece839a6ee11a991"
    },
    "sys_class_name":"sn_install_base_related_party",
    "sys_id":"4659539814ac6910f877ae314c1fb43a",
    "responsibility": {
      "display_value":"Authorized Representative",
      "sys_id":"c009bbedb3730010700b4d43c6a8dcef"
    },
    "contact": {
      "display_value":"Cindy Contact",
      "sys_id":"dc0185d94f341200025ba3618110c77c"
    },
    "account": {
      "display_value":"Boxeo",
      "value":"86837a386f0331003b3c498f5d3ee4ca"
    },
    "status":"SUCCESS",
  }
}