--- sourceDocument: Yokohama Finanças e cadeia de suprimentos sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/source-to-pay-operations Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Finanças e cadeia de suprimentos ft:clusterId : - stpop bundleId : - stpop workflow : - Creator --- # API de gasto - PUBLICAR /sn_sn_spend_intg/spenint/availability # API de gasto - PUBLICAR /sn_sn_spend_intg/spenint/availability {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura 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 do 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 {#spendint-POST-availability__section_hrm_qts_knb} Para saber o status da solicitação de disponibilidade de atualização, faça uma chamada REST no ServiceNowbanco de dados usando o. Tabela REST API. A resposta da API lista os registros em que a solicitação de disponibilidade de atualização falhou. Para atualizar resposta de disponibilidade, consulte a tabela Erro de disponibilidade com o seguinte parâmetro: `_query_outbound_error.supplier_id_id_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 {#spendint-POST-availability__section_alq_xd2_dmb} /api/sn_sn_spend_intg/spenint/availability ## Parâmetros de solicitação compatíveis {#spendint-POST-availability__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 1. Parâmetros de caminho] {#spendint-POST-availability__table_rdf_2ck_ymb__entry__2} | Nome | Descrição | |-|-| | modo | Suporte para modos assíncrono e síncrono para integração de terceiros. Tipo de dados: Cadeia de caracteres Valores válidos: * Assíncrono: Modo assíncrono. * Sincronização: Modo síncrono. {#spendint-POST-availability__ul_hdr_tkg_ymb} Padrão: Assíncrono | [Tabela 2. Parâmetros de consulta] {#spendint-POST-availability__table_rdf_2ck_ymb} {#spendint-POST-availability__entry__10} | Nome | Descrição | |-|-| | catalog_id | Necessá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 | Necessá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.products.sku | Necessá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 | | unidade.de produtos | Necessá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 | [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. {#spendint-POST-availability__entry__28}{#spendint-POST-availability__accept-RESTAPI} | Cabeçalho | Descrição | |-|-| | Aceitar | Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json | [Tabela 4. Cabeçalhos da solicitação] Nota: Somente o. application/jsonO formato de dados é compatível com a Estrutura de integração de compras. {#spendint-POST-availability__entry__32} | 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. {#spendint-POST-availability__table_lml_1qg_ymb__entry__2} | Código de status | Descrição | |-|-| | êxito | Bem-sucedido. A solicitação foi processada com sucesso. | | falha | Sem sucesso. A solicitação foi processada com erros. | [Tabela 6. Códigos de status] {#spendint-POST-availability__table_lml_1qg_ymb} ## Parâmetros do corpo da resposta (json) {#spendint-POST-availability__section_usm_1hk_ymb} Esses parâmetros do corpo de resposta são recebidos quando consultados no modo síncrono.{#spendint-POST-availability__table_vsm_1hk_ymb__entry__2} | Nome | Descrição | |-|-| | error_response_body | Descrição dos erros, listados por sku e a 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 | [ ] {#spendint-POST-availability__table_vsm_1hk_ymb} ## 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" } ] } ]} Respostas possíveis: // 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" } ] } ] } }