--- 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 spendint - POST /sn_spend_intg/spendint/orderack # API de spendint - POST /sn_spend_intg/spendint/orderack {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura Atualiza as informações do pedido para quando um usuário compra um produto de um catálogo de terceiros. Quando o usuário faz o check-out, uma linha de compra é criada para que as aprovações ou outras tarefas da compra possam ser concluídas. Quando uma ordem de compra é gerada no ServiceNowbanco de dados, o pedido é enviado para as seguintes tabelas: * Pedido de saída: Contém o cabeçalho do pedido. * Linha do pedido de saída: Contém as linhas do pedido. {#spendint-POST-orderack__ul_cvl_3cs_knb} Os fornecedores precisam consultar essas tabelas e buscar os pedidos pendentes em relação a elas. Os fornecedores devem criar um app com escopo para Workflow Studioações para integração com ServiceNowbanco de dados. Consulte as tabelas com os seguintes parâmetros: * `_order.status: 20 para o cabeçalho` * `_query.purchase_order.supplier_id: 20 para cabeçalho` {#spendint-POST-orderack__ul_owg_sfs_knb} Quando uma linha de compra é convertida em uma linha de ordem de compra, os seguintes processos são executados: 1. A ordem de compra e a linha da ordem de compra são enviadas para o Planejamento de recursos empresariais (ERP), se aplicável. 2. A ordem de compra e a linha da ordem de compra são transferidas por meio da integração para o terceiro com o ID do cliente, ID do fornecedor, número da ordem de compra, data do pedido, valor da ordem de compra, moeda do valor da ordem de compra e linhas da ordem de compra. 3. A ordem de compra e a linha da ordem de compra permanecem no estado Envio pendente até que as mensagens de confirmação sejam recebidas pela integração do catálogo de terceiros e pelo ERP. Após o recebimento da confirmação, o estado é atualizado para Solicitado. Se não houver integração de ERP envolvida, uma mensagem de confirmação será necessária somente da integração de terceiros. {#spendint-POST-orderack__ol_bzv_51p_znb} ## Tabelas de status {#spendint-POST-orderack__section_hrm_qts_knb} Para saber o status da solicitação de confirmação de pedido, 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 confirmação do pedido falhou. Para obter uma resposta de confirmação de pedido, consulte a tabela Erro de confirmação de pedido 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-orderack__section_vkd_122_dmb} /api/sn_sp_intg/spenint/orderack ## Parâmetros de solicitação compatíveis {#spendint-POST-orderack__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 1. Parâmetros de caminho] {#spendint-POST-orderack__table_sd3_lck_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-orderack__ul_td3_lck_ymb} Padrão: Assíncrono | [Tabela 2. Parâmetros de consulta] {#spendint-POST-orderack__table_sd3_lck_ymb} {#spendint-POST-orderack__entry__10} | Nome | Descrição | |-|-| | customer_id | Necessário. Identificador do cliente. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 | | order_number | Necessário. Número da ordem de compra fornecido pelo cliente para este pedido. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | sales_order_lines | Lista de objetos que definem as linhas do pedido de vendas com atualizações exclusivas para as compras neste pedido. Tipo de dados: Matriz "sales_order_lines":[ { "estimated_arrival_date": "String", "line_number": "String", "sales_order_line_number": "String" } ] | | sales_order_lines.estimated_arrival_date | Data de chegada estimada do pedido. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 FORMATO: AAAA-MM-DD | | sales_order_lines.line_number | Necessário. Número da linha da ordem de compra que foi gerado pelo cliente para uma compra específica. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | sales_order_lines.sales_order_line_number | Número da linha do pedido de vendas gerado pelo fornecedor. Este número é necessário somente para revisões desta compra. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | sales_order_number | Número ou valor gerado pelo fornecedor para este pedido. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | status_code | Necessário. Status do pedido enviado que confirma se o pedido foi feito com sucesso. Tipo de dados: Cadeia de caracteres Valores válidos: * Pedido feito com sucesso. * Rejeitado: Pedido não feito. {#spendint-POST-orderack__ul_hdr_tkg_ymb} | | status_message | Mensagem anexada a um código de status. Por exemplo, a mensagem pode ser que o pedido foi feito com sucesso e está em pedido pendente. Tipo de dados: Cadeia de caracteres Comprimento máximo: 1000 | | 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-orderack__entry__34}{#spendint-POST-orderack__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-orderack__entry__38} | 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-orderack__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-orderack__table_lml_1qg_ymb} ## Parâmetros do corpo da resposta (json) {#spendint-POST-orderack__section_cq5_1hk_ymb} Esses parâmetros do corpo de resposta são recebidos quando consultados no modo síncrono.{#spendint-POST-orderack__table_dq5_1hk_ymb__entry__2} | Nome | Descrição | |-|-| | error_response_body | Descrição dos erros, listados pelo número do pedido de vendas, número da linha do pedido de vendas e 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-orderack__table_dq5_1hk_ymb} ## Solicitação de curl curl "https://instance.service-now.com/api/sn_spend_intg/spendint/orderack" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root":[{ "customer_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "undefined", "order_number": "PO08903323", "sales_order_number": "SO03323212", "status_code": "CONFIRMED", "status_message": "BACKORDERED", "sales_order_lines":[ { "line_number": "POL6789876", "sales_order_line_number": "SOL5678909", "estimated_arrival_date": "YYYY-MM-DD" } ] } ]} Respostas possíveis: // Success response: { "result": { "response": "success" } } // Error response: { "result": { "response": [ { "customer_id": "ACME CORP", "supplier_id": "SUP-123456", "third_party_import_id": "undefined", "status_code": "failure", "error_response_body": [ { "sales_order_number": "SO03323212", "sales_order_line_number": "SOL5678909", "error_message": "Field Value empty/Formatting issue Purchase order number\nField Value empty/Formatting issue Purchase order line number\n" } ] } ] } }