API Spendint - POST /sn_spend_intg/spenint/availability

Atualiza a disponibilidade dos registros de produto do fornecedor.

Quando os registros de produto do fornecedor estão disponíveis, a API usa o SKU do produto para encontrar um produto de fornecedor existente. Se existir um produto de fornecedor correspondente, o correspondente available_units o campo foi atualizado. Se nenhum produto de fornecedor correspondente for encontrado, uma mensagem de erro será gerada informando que o produto para o qual você está tentando atualizar a disponibilidade não existe.

Tabelas de status

Para saber o status da solicitação de disponibilidade de atualização, faça uma chamada REST no ServiceNow banco de dados usando Tabela REST API. A resposta da API lista os registros em que a solicitação de disponibilidade de atualização falhou. Para atualizar a resposta de disponibilidade, consulte a tabela Erro de disponibilidade com o seguinte parâmetro:

se <supplier_id> você estiver usando o comando "outbound_error.supplier_id" "outbound_error.state", "outbound_error.state" é "20"

Os detalhes sobre o ID do cliente, ID do fornecedor, tipo de erro, ID do conjunto de importação exclusivo e estado podem ser encontrados na tabela Status de saída, que é a tabela de erros primária.

Formato de URL

/api/sn_sp_intg/spenint/availability

Parâmetros de solicitação compatíveis

Tabela 1. Parâmetros de caminho

Nome	Descrição
Nenhum(a)

Tabela 2. Parâmetros de consulta

Nome	Descrição
modo	Suporte a modos assíncronos e síncronos para integração de terceiros. Tipo de dados: Cadeia de caracteres Valores válidos: Async: Modo assíncrono. Sincronização: Modo síncrono. Padrão: Assíncrono

Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)

Nome	Descrição
catalog_id	Obrigatório. Identificador do conteúdo do catálogo que pode ser comprado por um cliente. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
customer_id	Obrigatório. Identificador do cliente. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
produtos	Lista de objetos que definem os produtos a serem atualizados. Cada transação tem um limite de 1000 produtos. Tipo de dados: Matriz "products": [ { "available_units": "String", "sku": "String", "unit": "String" } ]
available_units	Necessário para produtos mantidos em estoque. Número de unidades disponíveis para este produto. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40
sku	Obrigatório. Número gerado por um fornecedor que identifica exclusivamente um produto vendido por esse fornecedor. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
products.unit	Obrigatório. Unidade ou taxa na qual o produto é vendido pelo fornecedor. Por exemplo, peças, horas e assim por diante. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
supplier_id	Identificador do revendedor ou fornecedor com o qual o cliente pode fazer pedidos. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100
third_party_import_id	Permite que um terceiro passe um valor de cadeia de caracteres para identificar exclusivamente um conjunto de dados importados. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100

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.

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

Nota:

. application/jsonO formato de dados é compatível com a Estrutura de integração de compras.

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.

Tabela 6. Códigos de status

Código do status	Descrição
êxito	Bem-sucedido. A solicitação foi processada com sucesso.
falha	Malsucedido. A solicitação foi processada com erros.

Parâmetros do corpo da resposta (JSON)

Esses parâmetros do corpo de resposta são recebidos quando consultados no modo síncrono.

Nome	Descrição
error_response_body	Descrição dos erros, listados por sku e pela mensagem de erro. Tipo de dados: Matriz
error_response_body.error_message	Mensagem de erro detalhada. Tipo de dados: Cadeia de caracteres
status_code	Status da resposta, como "Sucesso" ou "Falha". Tipo de dados: Cadeia de caracteres

Solicitação de curl

curl "https://instance.servicenow.com/api/sn_spend_intg/spendint/availability" \
--request POST \
--header "Accept:application/json" \
--user 'username':'password'
{"root": [{
  "customer_id": "AB-1234323",
  "catalog_id": "ACME CORP",
  "supplier_id": "SUP-123456",
  "third_party_import_id": "DEL6789876",
  "products": [
    {
      "sku": "5578874",
      "unit": "Each",
      "available_units": "20"
    }
  ]
}
]}

Possíveis respostas:

// Success response:
{
    "result": {
        "response": "success"
    }
}

Error response: 
{
    "result": {
        "response": [
            {
                "customer_id": "AB-1234323",
                "supplier_id": "SUP-123456",
                "third_party_import_id": "DEL6789876",
                "status_code": "failure",
                "error_response_body": [
                    {
                        "sku": "5578874",
                        "error_message": "The product for which you are trying to update availability does not exist\nField Value empty/Formatting issue Unit\n"
                    }
                ]
            }
        ]
    }
}