---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference
Release :
- xanadu
ft:locale :
- pt-BR
ft:publication_title :
- Referência de API do Xanadu
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# API de conta
# API de conta {#ariaid-title1}
* Versão de lançamento: Xanadu
*
* Atualizado 1 de ago. de 2024
*
*  15 min. de leitura
A API de conta fornece endpoints para recuperar e atualizar Customer Service Management (CSM) registros de conta.
Além disso, você pode gerar novos registros de perfil de mídia social ao criar uma conta.
A API de conta requer o plug-in Atendimento ao cliente (com.sn_customerservice) e é fornecida no namespace `now`.
Os usuários precisam da função csm_ws_integration para acesso total à API.
## Conta - GET /now/account {#ariaid-title2}
Recupera um conjunto especificado de Customer Service Management (CSM) contas.
### Formato da URL
URL com controle de versão: /api/now/{api_version}/account
URL padrão: /api/now/account
### Parâmetros de solicitação compatíveis
{#account-GET__entry__2}{#account-GET__version-RESTAPI}
| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, v1 ou v2. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
[Tabela 1. Parâmetros de caminho]
{#account-GET__entry__6}{#account-GET__sysparm-limit-entry}{#account-GET__sysparm-offset-entry}{#account-GET__sysparm-query-entry}
| Nome | Descrição |
|-|-|
| sysparm_limit | Número máximo de registros a serem retornados. Para solicitações que excedem esse número de registros, use o parâmetro sysparm_offset para paginar a recuperação do registro. Na resposta, o parâmetro booliano hasMore é retornado. Indica se há mais registros a serem retornados que atendam aos critérios de filtro. Tipo de dados: número Padrão: 10 |
| sysparm_offset | Índice de registro inicial para o qual a recuperação de registros será iniciada. Use este valor para paginar a recuperação do registro. Essa 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ê chama este endpoint, sysparm_offset é definido como "0". Para simplesmente percorrer todos os registros disponíveis, use `sysparm_offset=sysparm_offset+sysparm_limit`até chegar ao fim de todos os registros. Não passe um número negativo no parâmetro sysparm_offset. Tipo de dados: número Padrão: 0 |
| sysparm_query | Consulta codificada usada para filtrar o conjunto de resultados. Por exemplo: `sysparm_query=caller_id=javascript:gs.getUserID()^active=true` A consulta codificada oferece suporte à ordem por. Para classificar respostas com base em determinados campos, use as cláusulas ORDERBY e ORDERBYDESC em sysparm_query. Por exemplo, `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` filtra todos os registros ativos e ordena os resultados em ordem crescente por número primeiro e, em seguida, em ordem decrescente por categoria. Se parte da consulta for inválida, por exemplo, especificando um nome de campo inválido, a instância ignorará a parte inválida. Em seguida, ele retorna linhas usando somente a parte válida da consulta. Você pode controlar esse comportamento usando a propriedade glide.invalid_query.returns_no_rows. Defina esta propriedade como verdadeira para não retornar linhas em uma consulta inválida. Nota: A propriedade glide.invalid_query.returns_no_rows controla o comportamento de todas as consultas na instância, como em listas, scripts (GlideRecord.query()) e APIs de serviço web. Tipo de dados: cadeia de caracteres |
[Tabela 2. Parâmetros de consulta]
{#account-GET__entry__14}
| Elemento | Descrição |
|-|-|
| Nenhum(a) | |
[Tabela 3. Parâmetros do corpo da solicitação (XML ou JSON)]
### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#account-GET__entry__18}{#account-GET__accept-RESTAPI}
| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json |
[Tabela 4. Cabeçalhos da solicitação]
{#account-GET__entry__22}
| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) | |
[Tabela 5. Cabeçalhos de resposta]
### Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#account-GET__entry__26}{#account-GET__entry-200-status-code}{#account-GET__entry-500-status-code}
| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 500 | Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro. |
[Tabela 6. Códigos de status]
### Parâmetros do corpo da resposta (JSON ou XML)
{#account-GET__entry__32}{#account-GET__accounttable-account_code-entry}{#account-GET__accounttable-account_parent-entry}{#account-GET__accounttable-account_path-entry}{#account-GET__accounttable-active_escalation-entry}{#account-GET__accounttable-apple_icon-entry}{#account-GET__accounttable-banner_image-entry}{#account-GET__accounttable-banner_image_light-entry}{#account-GET__accounttable-banner_text-entry}{#account-GET__accounttable-city-entry}{#account-GET__accounttable-contact-entry}{#account-GET__accounttable-country-entry}{#account-GET__accounttable-customer-entry}{#account-GET__accounttable-discount-entry}{#account-GET__accounttable-fax_phone-entry}{#account-GET__accounttable-fiscal_year-entry}{#account-GET__accounttable-lat_long_error-entry}{#account-GET__accounttable-latitude-entry}{#account-GET__accounttable-longitude-entry}{#account-GET__accounttable-manufactuer-entry}{#account-GET__accounttable-market_cap-entry}{#account-GET__accounttable-name-entry}{#account-GET__accounttable-notes-entry}{#account-GET__accounttable-num_employees-entry}{#account-GET__accounttable-number-entry}{#account-GET__accounttable-parent-entry}{#account-GET__accounttable-partner-entry}{#account-GET__accounttable-phone-entry}{#account-GET__accounttable-primary-entry}{#account-GET__accounttable-primary_contact-entry}{#account-GET__accounttable-profits-entry}{#account-GET__accounttable-publicly_traded-entry}{#account-GET__accounttable-rank_tier-entry}{#account-GET__accounttable-registration_code-entry}{#account-GET__accounttable-revenue_per_year-entry}{#account-GET__accounttable-state-entry}{#account-GET__accounttable-stock_price-entry}{#account-GET__accounttable-stock_symbol-entry}{#account-GET__accounttable-street-entry}{#account-GET__accounttable-sys_class_name-entry}{#account-GET__accounttable-sys_created_by-entry}{#account-GET__accounttable-sys_created_on-entry}{#account-GET__accounttable-sys_id-entry}{#account-GET__accounttable-sys_mod_count-entry}{#account-GET__accounttable-sys_updated_by-entry}{#account-GET__accounttable-sys_updated_on-entry}{#account-GET__accounttable-theme-entry}{#account-GET__accounttable-vendor-entry}{#account-GET__accounttable-vendor_manager-entry}{#account-GET__accounttable-vendor_type-entry}{#account-GET__accounttable-website-entry}{#account-GET__accounttable-zip-entry}
| Parâmetro | Descrição |
|-|-|
| account_code | Combinação exclusiva de valores que uma aplicação usa para identificar previsões orçamentárias e planos orçamentários. Tipo de dados: cadeia de caracteres Tamanho máximo: 255 |
| account_parent | Sys_id da conta primária desta conta. Localizado na tabela Conta \[customer_account\]. Tipo de dados: cadeia de caracteres |
| account_path | Caminho das contas primárias para as secundárias na hierarquia de contas. Tipo de dados: cadeia de caracteres Tamanho máximo: 255 |
| escalação_ativa | Sys_id da escalação ativa associada à conta. Localizado na tabela Escalação \[sn_customerservice_escalation\]. Tipo de dados: cadeia de caracteres |
| apple_icon | Ícone para marcadores de página inicial do iPhone. Tipo de dados: imagem |
| banner_image | Imagem da faixa que aparece no portal do cliente. Tipo de dados: imagem |
| banner_image_light | Imagem de faixa pequena. Tipo de dados: imagem |
| banner_text | Texto da faixa que aparece no portal do cliente. Tipo de dados: cadeia de caracteres Tamanho máximo: 4.000 |
| cidade | Cidade na qual reside a empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 50 |
| contato | Sys_id de um registro de contato associado a esta conta. Localizado na tabela Usuário \[sys_user\]. Tipo de dados: cadeia de caracteres |
| país | País em que reside a empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 Padrão: EUA |
| cliente | Sinalizador que indica se a conta é uma conta de cliente, em vez de uma conta de parceiro. Valores possíveis: * verdadeiro: conta do cliente * falso: conta do parceiro {#account-GET__ul_mhg_dh3_2hb} Tipo de dados: booliano Padrão: falso |
| desconto | Desconto concedido à conta em compras. Tipo de dados: número Tamanho máximo: 15 |
| fax_telefone | Número de fax primário da empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| fiscal_year | Ano fiscal da empresa associada à conta. Tipo de dados: cadeia de caracteres |
| erro_lat_longo | Diferença na localização real em comparação com as informações de latitude e longitude. Tipo de dados: cadeia de caracteres Tamanho máximo: 1.000 |
| latitude | Latitude da empresa associada a esta conta. Tipo de dados: número (número de ponto flutuante) Tamanho máximo: 40 |
| longitude | Longitude da empresa associada a esta conta. Tipo de dados: número (número de ponto flutuante) Tamanho máximo: 40 |
| manufacturer | Sinalizador que indica se a empresa associada a esta conta produz mercadorias. Valores possíveis: * verdadeiro: bens de fabricação * falso: não produz mercadorias {#account-GET__ul_j4p_t1r_2hb} Tipo de dados: booliano Padrão: falso |
| valor_de_mercado | Valor de mercado das ações negociadas publicamente da empresa associada. Tipo de dados: número (moeda) Tamanho máximo: 20 |
| nome | Nome da empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 80 |
| anotações | Informações adicionais sobre a empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 4.000 |
| num_funcionários | Número de pessoas empregadas pela empresa. Tipo de dados: número (inteiro) Tamanho máximo: 40 |
| número | Número que identifica esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| primário | Sys_id da conta primária desta conta. Localizado na tabela Empresa \[core_company\]. Tipo de dados: cadeia de caracteres |
| parceiro | Sinalizador que indica se a conta é de parceiro ou de cliente. Valores possíveis: * verdadeiro: conta de parceiro * falso: conta do cliente {#account-GET__ul_p1v_ph3_2hb} Tipo de dados: booliano Padrão: falso |
| telefone | Número de telefone primário da empresa. Tipo de dados: cadeia de caracteres |
| primary | Sinalizador que indica se esta é uma conta primária. Valores possíveis: * verdadeiro: conta primária * falso: conta secundária {#account-GET__ul_ax4_sh3_2hb} Tipo de dados: booliano Padrão: falso |
| primário_contato | Sys_id do contato primário da conta. Localizado na tabela Contato \[customer_contact\]. Tipo de dados: cadeia de caracteres |
| lucros | Informações de lucro inseridas para esta conta. Tipo de dados: número (moeda) Tamanho máximo: 40 |
| Public_traded | Sinalizador que indica se a empresa associada a esta conta é negociada publicamente na bolsa de valores. Valores possíveis: * verdadeiro: negociado publicamente * falso: empresa privada {#account-GET__ul_e15_5h3_2hb} Tipo de dados: booliano |
| classificação_nível | Tipo de conta. Valores possíveis: * lista de bloqueios * estratégico * tático * valorizado * outro {#account-GET__ul_cly_c33_2hb} Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| registro_código | Código exclusivo que os clientes usam ao solicitar um login no portal do cliente. Este código fornece um método para validar o cliente na empresa antes de conceder acesso. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| receita_por_ano | Receita produzida pela empresa associada a esta conta. Tipo de dados: número (moeda) Tamanho máximo: 20 |
| estado | Estado em que a empresa reside. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| preço_estoque | Preço da ação da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| símbolo_estoque | Símbolo de ações da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| rua | Endereço da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 255 |
| sys_class_name | Tabela que contém o registro de conta associado. Tipo de dados: cadeia de caracteres |
| sys_created_by | Usuário que criou originalmente a conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| sys_created_on | Data e hora em que a conta foi criada originalmente. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do registro da conta. Tipo de dados: cadeia de caracteres |
| sys_mod_count | Número de vezes que as informações da conta foram atualizadas. Tipo de dados: número (inteiro) |
| sys_updated_by | Usuário que modificou pela última vez as informações da conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| sys_updated_on | Data e hora em que as informações da conta foram atualizadas pela última vez. Tipo de dados: cadeia de caracteres |
| tema | Sys_id do tema do portal do cliente usado por esta conta. Localizado na tabela Tema \[sys_ui_theme\]. Tipo de dados: cadeia de caracteres |
| fornecedor | Sinalizador que indica se a empresa associada a esta conta é um fornecedor. Valores possíveis: * verdadeiro: fornecedor * falso: não é um fornecedor {#account-GET__ul_tqf_333_2hb} Tipo de dados: booliano Padrão: falso |
| vendor_manager | Lista de sys_ids dos gerentes de fornecedor da conta. Localizado na tabela Usuário \[sys_user\]. Tipo de dados: cadeia de caracteres |
| vendor_type | Lista de sys_ids do tipo de fornecedor, como aplicações, hardware, serviços ou software. Localizado na tabela Tipo de fornecedor \[vendor_type\]. Tipo de dados: cadeia de caracteres |
| site | URL do site da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 1.024 |
| zip | CEP da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
[ ]
### Solicitação de cURL
curl "https://instance.servicenow.com/api/now/account?sysparm_limit=2&sysparm_offset=2>;rel="next" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'
{
"result": [
{
"banner_image_light": "",
"country": "USA",
"parent": "",
"notes": "",
"stock_symbol": "",
"discount": "",
"active_escalation": "",
"sys_updated_on": "2019-01-03 19:37:55",
"apple_icon": "",
"number": "ACCT0000003",
"sys_updated_by": "admin",
"fiscal_year": "",
"sys_created_on": "2018-12-23 05:25:17",
"contact": "",
"stock_price": "",
"state": "",
"banner_image": "",
"sys_created_by": "admin",
"longitude": "",
"zip": "BR1 3QR",
"profits": "0",
"phone": "+44 20 8466 9992",
"fax_phone": "",
"name": "Boxeo EMEA",
"banner_text": "",
"account_code": "~~~~3",
"primary": "false",
"city": "Bromley",
"latitude": "",
"sys_class_name": "customer_account",
"manufacturer": "false",
"account_parent": "86837a386f0331003b3c498f5d3ee4ca",
"sys_id": "3eedd08413651200042ab3173244b088",
"market_cap": "0",
"num_employees": "",
"rank_tier": "",
"street": "18 London Rd",
"vendor": "false",
"lat_long_error": "",
"theme": "",
"vendor_type": "",
"website": "",
"revenue_per_year": "0",
"publicly_traded": "false",
"sys_mod_count": "5",
"sys_tags": "",
"partner": "false",
"registration_code": "BOXEO-EMEA",
"vendor_manager": "",
"account_path": "~~~~1/~~~~3",
"primary_contact": "ff66c1254fb81200025ba3618110c76e",
"customer": "true"
},
{
"banner_image_light": "",
"country": "USA",
"parent": "",
"notes": "",
"stock_symbol": "",
"discount": "",
"active_escalation": "",
"sys_updated_on": "2019-01-03 19:38:04",
"apple_icon": "",
"number": "ACCT0000004",
"sys_updated_by": "admin",
"fiscal_year": "",
"sys_created_on": "2018-12-23 05:19:24",
"contact": "",
"stock_price": "",
"state": "",
"banner_image": "",
"sys_created_by": "admin",
"longitude": "",
"zip": "V5L 2G4",
"profits": "0",
"phone": "+1 604-255-9797",
"fax_phone": "",
"name": "Boxeo Canada",
"banner_text": "",
"account_code": "~~~~4",
"primary": "false",
"city": "Vancouver",
"latitude": "",
"sys_class_name": "customer_account",
"manufacturer": "false",
"account_parent": "86837a386f0331003b3c498f5d3ee4ca",
"sys_id": "609cd80413651200042ab3173244b03e",
"market_cap": "0",
"num_employees": "",
"rank_tier": "",
"street": "1362 Venables St,, BC V5L 2G4, Canada",
"vendor": "false",
"lat_long_error": "",
"theme": "",
"vendor_type": "",
"website": "",
"revenue_per_year": "0",
"publicly_traded": "false",
"sys_mod_count": "5",
"sys_tags": "",
"partner": "false",
"registration_code": "BOXEO-CANADA",
"vendor_manager": "",
"account_path": "~~~~1/~~~~4",
"primary_contact": "c07424a54f781200025ba3618110c746",
"customer": "true"
}
]
}
## Conta - GET /now/account/{id} {#ariaid-title3}
Recupera a conta Customer Service Management (CSM) especificada.
### Formato da URL
URL com controle de versão: /api/now/{api_version}/account/{id}
URL padrão: /api/now/account/{id}
### Parâmetros de solicitação compatíveis
{#account-GET-id__entry__2}{#account-GET-id__version-RESTAPI}
| Nome | Descrição |
|-|-|
| api_version | Opcional. Versão do endpoint a ser acessada. Por exemplo, v1 ou v2. Somente especifique este valor para usar uma versão de endpoint diferente da mais recente. Tipo de dados: cadeia de caracteres |
| ID | Sys_id da conta a ser recuperada. Localizado na tabela Cliente \[customer_account\]. Tipo de dados: cadeia de caracteres |
[Tabela 7. Parâmetros de caminho]
{#account-GET-id__entry__8}
| Nome | Descrição |
|-|-|
| Nenhum(a) | |
[Tabela 8. Parâmetros de consulta]
{#account-GET-id__entry__12}
| Nome | Descrição |
|-|-|
| Nenhum(a) | |
[Tabela 9. Parâmetros do corpo da solicitação (XML ou JSON)]
### 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](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#account-GET-id__entry__16}{#account-GET-id__accept-RESTAPI}
| Cabeçalho | Descrição |
|-|-|
| Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/json ou application/xml. Padrão: application/json |
[Tabela 10. Cabeçalhos da solicitação]
{#account-GET-id__entry__20}
| Cabeçalho | Descrição |
|-|-|
| Nenhum(a) | |
[Tabela 11. Cabeçalhos de resposta]
### Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de códigos de status possíveis usados na REST API, consulte [Códigos de resposta HTTP de REST API](https://servicenow-prod.fluidtopics.net/_wb_5~ll90zKaDApNe9ciw "REST (Transferência de Estado Representacional) é uma arquitetura sem estado simples que fornece padrões entre sistemas de computador na Web, facilitando a comunicação entre eles.").
{#account-GET-id__entry__24}{#account-GET-id__entry-200-status-code}
| Código de status | Descrição |
|-|-|
| 200 | Bem-sucedido. A solicitação foi processada com sucesso. |
| 404 | Indica que a solicitação é inválida. Pode ser devido a um dos seguintes motivos: * O caso solicitado não existe. * O usuário não tem acesso ao registro da conta. {#account-GET-id__ul_ubm_1jl_3v} |
[Tabela 12. Códigos de status]
### Parâmetros do corpo da resposta (JSON ou XML)
{#account-GET-id__entry__30}{#account-GET-id__accounttable-account_code-entry}{#account-GET-id__accounttable-account_parent-entry}{#account-GET-id__accounttable-account_path-entry}{#account-GET-id__accounttable-active_escalation-entry}{#account-GET-id__accounttable-apple_icon-entry}{#account-GET-id__accounttable-banner_image-entry}{#account-GET-id__accounttable-banner_image_light-entry}{#account-GET-id__accounttable-banner_text-entry}{#account-GET-id__accounttable-city-entry}{#account-GET-id__accounttable-contact-entry}{#account-GET-id__accounttable-country-entry}{#account-GET-id__accounttable-customer-entry}{#account-GET-id__accounttable-discount-entry}{#account-GET-id__accounttable-fax_phone-entry}{#account-GET-id__accounttable-fiscal_year-entry}{#account-GET-id__accounttable-lat_long_error-entry}{#account-GET-id__accounttable-latitude-entry}{#account-GET-id__accounttable-longitude-entry}{#account-GET-id__accounttable-manufactuer-entry}{#account-GET-id__accounttable-market_cap-entry}{#account-GET-id__accounttable-name-entry}{#account-GET-id__accounttable-notes-entry}{#account-GET-id__accounttable-num_employees-entry}{#account-GET-id__accounttable-number-entry}{#account-GET-id__accounttable-parent-entry}{#account-GET-id__accounttable-partner-entry}{#account-GET-id__accounttable-phone-entry}{#account-GET-id__accounttable-primary-entry}{#account-GET-id__accounttable-primary_contact-entry}{#account-GET-id__accounttable-profits-entry}{#account-GET-id__accounttable-publicly_traded-entry}{#account-GET-id__accounttable-rank_tier-entry}{#account-GET-id__accounttable-registration_code-entry}{#account-GET-id__accounttable-revenue_per_year-entry}{#account-GET-id__accounttable-state-entry}{#account-GET-id__accounttable-stock_price-entry}{#account-GET-id__accounttable-stock_symbol-entry}{#account-GET-id__accounttable-street-entry}{#account-GET-id__accounttable-sys_class_name-entry}{#account-GET-id__accounttable-sys_created_by-entry}{#account-GET-id__accounttable-sys_created_on-entry}{#account-GET-id__accounttable-sys_id-entry}{#account-GET-id__accounttable-sys_mod_count-entry}{#account-GET-id__accounttable-sys_updated_by-entry}{#account-GET-id__accounttable-sys_updated_on-entry}{#account-GET-id__accounttable-theme-entry}{#account-GET-id__accounttable-vendor-entry}{#account-GET-id__accounttable-vendor_manager-entry}{#account-GET-id__accounttable-vendor_type-entry}{#account-GET-id__accounttable-website-entry}{#account-GET-id__accounttable-zip-entry}
| Parâmetro | Descrição |
|-|-|
| account_code | Combinação exclusiva de valores que uma aplicação usa para identificar previsões orçamentárias e planos orçamentários. Tipo de dados: cadeia de caracteres Tamanho máximo: 255 |
| account_parent | Sys_id da conta primária desta conta. Localizado na tabela Conta \[customer_account\]. Tipo de dados: cadeia de caracteres |
| account_path | Caminho das contas primárias para as secundárias na hierarquia de contas. Tipo de dados: cadeia de caracteres Tamanho máximo: 255 |
| escalação_ativa | Sys_id da escalação ativa associada à conta. Localizado na tabela Escalação \[sn_customerservice_escalation\]. Tipo de dados: cadeia de caracteres |
| apple_icon | Ícone para marcadores de página inicial do iPhone. Tipo de dados: imagem |
| banner_image | Imagem da faixa que aparece no portal do cliente. Tipo de dados: imagem |
| banner_image_light | Imagem de faixa pequena. Tipo de dados: imagem |
| banner_text | Texto da faixa que aparece no portal do cliente. Tipo de dados: cadeia de caracteres Tamanho máximo: 4.000 |
| cidade | Cidade na qual reside a empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 50 |
| contato | Sys_id de um registro de contato associado a esta conta. Localizado na tabela Usuário \[sys_user\]. Tipo de dados: cadeia de caracteres |
| país | País em que reside a empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 Padrão: EUA |
| cliente | Sinalizador que indica se a conta é uma conta de cliente, em vez de uma conta de parceiro. Valores possíveis: * verdadeiro: conta do cliente * falso: conta do parceiro {#account-GET-id__ul_mhg_dh3_2hb} Tipo de dados: booliano Padrão: falso |
| desconto | Desconto concedido à conta em compras. Tipo de dados: número Tamanho máximo: 15 |
| fax_telefone | Número de fax primário da empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| fiscal_year | Ano fiscal da empresa associada à conta. Tipo de dados: cadeia de caracteres |
| erro_lat_longo | Diferença na localização real em comparação com as informações de latitude e longitude. Tipo de dados: cadeia de caracteres Tamanho máximo: 1.000 |
| latitude | Latitude da empresa associada a esta conta. Tipo de dados: número (número de ponto flutuante) Tamanho máximo: 40 |
| longitude | Longitude da empresa associada a esta conta. Tipo de dados: número (número de ponto flutuante) Tamanho máximo: 40 |
| manufacturer | Sinalizador que indica se a empresa associada a esta conta produz mercadorias. Valores possíveis: * verdadeiro: bens de fabricação * falso: não produz mercadorias {#account-GET-id__ul_j4p_t1r_2hb} Tipo de dados: booliano Padrão: falso |
| valor_de_mercado | Valor de mercado das ações negociadas publicamente da empresa associada. Tipo de dados: número (moeda) Tamanho máximo: 20 |
| nome | Nome da empresa associada a esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 80 |
| anotações | Informações adicionais sobre a empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 4.000 |
| num_funcionários | Número de pessoas empregadas pela empresa. Tipo de dados: número (inteiro) Tamanho máximo: 40 |
| número | Número que identifica esta conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| primário | Sys_id da conta primária desta conta. Localizado na tabela Empresa \[core_company\]. Tipo de dados: cadeia de caracteres |
| parceiro | Sinalizador que indica se a conta é de parceiro ou de cliente. Valores possíveis: * verdadeiro: conta de parceiro * falso: conta do cliente {#account-GET-id__ul_p1v_ph3_2hb} Tipo de dados: booliano Padrão: falso |
| telefone | Número de telefone primário da empresa. Tipo de dados: cadeia de caracteres |
| primary | Sinalizador que indica se esta é uma conta primária. Valores possíveis: * verdadeiro: conta primária * falso: conta secundária {#account-GET-id__ul_ax4_sh3_2hb} Tipo de dados: booliano Padrão: falso |
| primário_contato | Sys_id do contato primário da conta. Localizado na tabela Contato \[customer_contact\]. Tipo de dados: cadeia de caracteres |
| lucros | Informações de lucro inseridas para esta conta. Tipo de dados: número (moeda) Tamanho máximo: 40 |
| Public_traded | Sinalizador que indica se a empresa associada a esta conta é negociada publicamente na bolsa de valores. Valores possíveis: * verdadeiro: negociado publicamente * falso: empresa privada {#account-GET-id__ul_e15_5h3_2hb} Tipo de dados: booliano |
| classificação_nível | Tipo de conta. Valores possíveis: * lista de bloqueios * estratégico * tático * valorizado * outro {#account-GET-id__ul_cly_c33_2hb} Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| registro_código | Código exclusivo que os clientes usam ao solicitar um login no portal do cliente. Este código fornece um método para validar o cliente na empresa antes de conceder acesso. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| receita_por_ano | Receita produzida pela empresa associada a esta conta. Tipo de dados: número (moeda) Tamanho máximo: 20 |
| estado | Estado em que a empresa reside. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| preço_estoque | Preço da ação da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| símbolo_estoque | Símbolo de ações da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| rua | Endereço da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 255 |
| sys_class_name | Tabela que contém o registro de conta associado. Tipo de dados: cadeia de caracteres |
| sys_created_by | Usuário que criou originalmente a conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| sys_created_on | Data e hora em que a conta foi criada originalmente. Tipo de dados: cadeia de caracteres |
| sys_id | Sys_id do registro da conta. Tipo de dados: cadeia de caracteres |
| sys_mod_count | Número de vezes que as informações da conta foram atualizadas. Tipo de dados: número (inteiro) |
| sys_updated_by | Usuário que modificou pela última vez as informações da conta. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
| sys_updated_on | Data e hora em que as informações da conta foram atualizadas pela última vez. Tipo de dados: cadeia de caracteres |
| tema | Sys_id do tema do portal do cliente usado por esta conta. Localizado na tabela Tema \[sys_ui_theme\]. Tipo de dados: cadeia de caracteres |
| fornecedor | Sinalizador que indica se a empresa associada a esta conta é um fornecedor. Valores possíveis: * verdadeiro: fornecedor * falso: não é um fornecedor {#account-GET-id__ul_tqf_333_2hb} Tipo de dados: booliano Padrão: falso |
| vendor_manager | Lista de sys_ids dos gerentes de fornecedor da conta. Localizado na tabela Usuário \[sys_user\]. Tipo de dados: cadeia de caracteres |
| vendor_type | Lista de sys_ids do tipo de fornecedor, como aplicações, hardware, serviços ou software. Localizado na tabela Tipo de fornecedor \[vendor_type\]. Tipo de dados: cadeia de caracteres |
| site | URL do site da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 1.024 |
| zip | CEP da empresa. Tipo de dados: cadeia de caracteres Tamanho máximo: 40 |
[ ]
### Solicitação de cURL
curl "https://instance.servicenow.com/api/now/account/bf60bef46f0331003b3c498f5d3ee41a" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": {
"banner_image_light": "",
"country": "USA",
"parent": "",
"notes": "",
"stock_symbol": "",
"discount": "",
"active_escalation": "e4fa242887150300fe4433d4c6cb0b5f",
"sys_updated_on": "2020-07-30 21:57:54",
"apple_icon": "",
"number": "ACCT0000009",
"sys_updated_by": "admin",
"fiscal_year": "",
"sys_created_on": "2019-09-16 21:19:27",
"contact": "bea1fef46f0331003b3c498f5d3ee4c5",
"stock_price": "",
"state": "California",
"banner_image": "",
"sys_created_by": "venki",
"longitude": "-122.116445",
"zip": "94022",
"profits": "0",
"phone": "(877) 729-4269",
"fax_phone": "",
"name": "Avid Corporation",
"banner_text": "",
"account_code": "~~~~9",
"primary": "false",
"city": "Los Altos",
"latitude": "37.402666",
"sys_class_name": "customer_account",
"manufacturer": "false",
"account_parent": "",
"sys_id": "bf60bef46f0331003b3c498f5d3ee41a",
"market_cap": "0",
"num_employees": "",
"rank_tier": "",
"street": "4440 El Camino Real",
"vendor": "false",
"lat_long_error": "",
"theme": "",
"vendor_type": "",
"website": "http://www.avidcorp.com",
"revenue_per_year": "0",
"publicly_traded": "false",
"sys_mod_count": "10",
"sys_tags": "",
"partner": "false",
"registration_code": "AVID",
"vendor_manager": "",
"account_path": "~~~~9",
"primary_contact": "bea1fef46f0331003b3c498f5d3ee4c5",
"customer": "true"
}
}