--- 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 - POST /sn_spend_intg/spenint/price # API de gasto - POST /sn_spend_intg/spenint/price {#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 todos os preços dos registros de produto do fornecedor. Quando o preço está disponível para registros de produto do fornecedor, a API usa o SKU do produto para encontrar um produto de fornecedor existente. Se existir um produto do fornecedor correspondente, o preço do contrato correspondente será 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 o preço não existe. ## Tabelas de status {#spendint-POST-price__section_hrm_qts_knb} Para saber o status da solicitação de importação de preç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 importação de preço falhou. Para obter uma resposta de importação de preço, consulte a tabela Erro de preço com o seguinte parâmetro: `_query_outbound_error.supplier_id_id_outbound_error.state: 20` Você pode encontrar os detalhes sobre o ID do cliente, ID do fornecedor, tipo de erro, ID do conjunto de importação exclusivo e CAN de estado na tabela Status de saída, que é a tabela de erros primária. ## Formato de URL {#spendint-POST-price__section_dtb_zd2_dmb} /api/sn_sn_spend_intg/spenint/price ## Parâmetros de solicitação compatíveis {#spendint-POST-price__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 1. Parâmetros de caminho] {#spendint-POST-price__table_bdb_dck_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-price__ul_hdr_tkg_ymb} Padrão: Assíncrono | [Tabela 2. Parâmetros de consulta] {#spendint-POST-price__table_bdb_dck_ymb} {#spendint-POST-price__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 produtos a serem criados ou atualizados. Cada transação tem um limite de 1000 produtos. Tipo de dados: Matriz "products": [ { "contract_agreement": {Array}, "sku": "String" } ] | | products.contract_agreement | Detalhes do contrato de um produto. Tipo de dados: Objeto "contract_agreement": { "contract_end_date": "String", "contract_number": "String", "contract_start_date": "String", "negotiated_currency ": "String", "negotiated_price": "String" } | | contract_agreement.contract_date.contract_end_date | Data em que o termo do contrato termina. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 FORMATO: AAAA-MM-DD | | contract_agreement.contract_number | Necessário. Número do contrato ativo associado ao produto. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 | | contract_agreement.contract_date.contract_start_date | Data em que o termo do contrato começa. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 FORMATO: AAAA-MM-DD | | contract_agreement.negociated_currency | Necessário. Moeda do preço negociado. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | products.contract_agreement.negociated_price | Necessário. Preço unitário de um produto conforme negociado por meio de um contrato com o fornecedor ou revendedor. 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 | | supplier_id | Necessário. 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 | Identificador que 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-price__entry__36}{#spendint-POST-price__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-price__entry__40} | 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-price__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-price__table_lml_1qg_ymb} ## Parâmetros do corpo da resposta (json) {#spendint-POST-price__section_iy2_1hk_ymb} Esses parâmetros do corpo de resposta são recebidos quando consultados no modo síncrono.{#spendint-POST-price__table_jy2_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-price__table_jy2_1hk_ymb} ## Solicitação de curl curl "https://instance.service-now.com/api/sn_spend_intg/spendint/price" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root": [{ "customer_id": "ACME CORP", "catalog_id": "AB-1234323", "supplier_id": "SUP-123456", "third_party_import_id": "DEL789876", "products": [ { "sku": "5578874", "contract_agreement": { "contract_number": "34567892", "contract_start_date": "YYYY-MM-DD", "contract_end_date": "YYYY-MM-DD", "negotiated_price": "456", "negotiated_currency ": "USD" } } ] } ]} Respostas possíveis: // Success response: { "result": { "response": "success" } } // Error response: { "result": { "response": [ { "customer_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "DEL789876", "status_code": "failure", "error_response_body": [ { "sku": "5578874", "error_message": "The product for which you are trying to update pricing does not exist\nField Value empty/Formatting issue Negotiated currency\nField Value empty/Formatting issue Contract start date\nField Value empty/Formatting issue Contract end date\n" } ] } ] } }