--- 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/invoice # API de gasto - PUBLICAR /sn_sn_spend_intg/spenint/invoice {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura Aceita faturas de provedores terceirizados. Se a ordem de compra e as linhas da ordem de compra estiverem no status Envio pendente e as linhas da ordem de vendas e da ordem de vendas não estiverem preenchidas, a remessa e a publicação da fatura do revendedor terceirizado não serão permitidas. Isso só é permitido quando o status da ordem de compra e das linhas da ordem de compra são Solicitadas. Além disso, não há restrições sequenciais na expedição e na publicação da fatura. Depois que uma fatura é enviada, a fatura e as linhas da fatura são mapeadas para uma ordem de compra. Em um mapeamento bem-sucedido, o estado da fatura é definido da seguinte forma: * Aguardando entrega: Quando não há recibos, o pedido é parcialmente entregue ou a fatura requer aprovação. * Fatura confirmada: Quando a ordem de compra é entregue e o valor faturado corresponde ao valor total da ordem de compra. * Requer revisão: Quando a ordem de compra é entregue e o valor faturado não corresponde ao valor total da ordem de compra. {#spendint-POST-invoice__ul_mqv_3c2_dmb} Quando uma fatura válida é lançada para um item de linha, a mesma fatura não pode ser atualizada. Se a fatura fornecida não tiver um número de ordem de compra, a fatura será rejeitada e você verá uma mensagem de erro informando que uma ou mais faturas fornecidas não têm um número de ordem de compra. Se a fatura fornecida tiver um número de ordem de compra, mas não corresponder à ordem de compra ou não existir nenhuma ordem de compra, você verá uma mensagem de erro. A mensagem informa que uma ou mais faturas não têm uma ordem de compra correspondente que corresponda ao número da ordem de compra da fatura. Além disso, se o valor faturado enviado do revendedor terceirizado não corresponder ao valor faturado, a fatura será rejeitada. ## Tabelas de status {#spendint-POST-invoice__section_hrm_qts_knb} Para saber o status da solicitação de fatura, faça uma chamada REST no ServiceNowbanco de dados usando o. Tabela REST API. A resposta da API lista os registros em que a criação da fatura falhou. Para resposta da fatura, consulte a tabela Erro da fatura 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-invoice__section_lxx_b22_dmb} /api/sn_sn_spend_intg/spenint/invoice ## Parâmetros de solicitação compatíveis {#spendint-POST-invoice__entry__2} | Nome | Descrição | |-|-| | Nenhum(a) | | [Tabela 1. Parâmetros de caminho] {#spendint-POST-invoice__table_jhz_gck_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-invoice__ul_hdr_tkg_ymb} Padrão: Assíncrono | [Tabela 2. Parâmetros de consulta] {#spendint-POST-invoice__table_jhz_gck_ymb} {#spendint-POST-invoice__entry__10} | Nome | Descrição | |-|-| | moeda | Necessário. Moeda para subtotal, imposto e envio. O subtotal, o imposto e o envio devem estar na mesma moeda. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | customer_id | Identificador do cliente. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 | | descontos | Descontos aplicados à fatura. Este é um campo editável. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 | | invoice_date | Necessário. Data em que o cliente foi faturado. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 FORMATO: AAAA-MM-DD | | invoice_lines | Lista de objetos que definem as linhas que estão sendo faturadas para compras neste pedido. Tipo de dados: Matriz "invoice_lines": [ { "invoiced_line_amount": "String", "invoiced_quantity": "String", "line_number": "String", "supplier_invoice_line_number": "String", "sales_order_line_number": "String" } ] | | invoice_lines.invoiced_line_amount | Necessário. Custo total, excluindo impostos e envio, que um cliente está sendo faturado para uma determinada linha de ordem de compra. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | invoice_lines.invoiced_quantity | Necessário. Quantidade de bens ou serviços pelos quais um cliente está sendo faturado. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | invoice_lines.line_number | Necessário. Número da linha da ordem de compra que é gerado pelo cliente para uma compra específica. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | invoice_lines.sales_order_line_number | Necessário. Número da linha do pedido de vendas gerado pelo fornecedor. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | invoice_lines.supplier_invoice_line_number | Necessário. Número de identificação gerado por um fornecedor para esta linha de fatura. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 | | other_charges | Outras cobranças adicionais associadas à fatura. Este é um campo editável. 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 | | remit_to_address | Necessário. Local para o qual um pagamento é feito. Tipo de dados: Cadeia de caracteres Comprimento máximo: 1000 | | sales_order_number | Necessário. Número ou valor gerado pelo fornecedor para este pedido. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | remessa | Necessário. Custo total de envio para toda a compra. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | subtotal | Necessário. Valor total do dinheiro a ser pago ao fornecedor, excluindo impostos e taxas de envio. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | 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 | | supplier_invoice_number | Necessário. Número de identificação gerado por um fornecedor para esta fatura. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 | | supplier_tax_id | Identificador de imposto associado ao revendedor terceirizado. Este é um campo editável. Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 | | imposto | Necessário. Valor total de impostos faturados pela compra. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | | tax_rate | Percentual da alíquota de imposto aplicada ao pedido. Este é um campo editável. 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 | | total_amount_faturado | Necessário. Valor total do dinheiro a ser pago ao fornecedor, incluindo impostos e taxas de envio. Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 | [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-invoice__entry__58}{#spendint-POST-invoice__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-invoice__entry__62} | 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-invoice__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-invoice__table_lml_1qg_ymb} ## Parâmetros do corpo da resposta (json) {#spendint-POST-invoice__section_ih4_bhk_ymb} Esses parâmetros do corpo de resposta são recebidos quando consultados no modo síncrono.{#spendint-POST-invoice__table_jh4_bhk_ymb__entry__2} | Nome | Descrição | |-|-| | error_response_body | Descrição dos erros, listados pelo número da linha da ordem de vendas, número da ordem de vendas, número da fatura do fornecedor, número da linha da fatura do fornecedor 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-invoice__table_jh4_bhk_ymb} ## Solicitação de curl curl "https://instance.service-now.com/api/sn_spend_intg/spendint/invoice" \ --request POST \ --header "Accept:application/json" \ --user 'username':'password' {"root":[{ "customer_id": "Customer - A", "supplier_id": "SUP-123456", "third_party_import_id": "undefined", "supplier_invoice_number": "QAAP89873220071", "supplier_tax_id": "TIN000000", "order_number": "POL7987633", "sales_order_number": "SO0000000081", "invoice_date": "YYYY-MM-DD", "subtotal": "6000", "tax_rate": "10%", "tax": "600", "shipping": "120", "other_charges": "100", "discounts": "200", "total_amount_invoiced": "6620", "remit_to_address": "1640 Camino Del Rio North #202, San Diego,CA", "currency": "USD", "invoice_lines": [ { "supplier_invoice_line_number": "QA789A867877ABN32251", "line_number": "POL587667", "sales_order_line_number": "SOL00000081", "invoiced_quantity": "45", "invoiced_line_amount": "4000" }, { "line_number": "POL587668", "supplier_invoice_line_number": "78987323", "sales_order_line_number": "SOL98769", "invoiced_quantity": "12", "invoiced_line_amount": "2000" } ] } ]} Respostas possíveis: // Success response: { "result": { "response": "success" } } // Error response: { "result": { "response": [ { "customer_id": "Customer - A", "supplier_id": "SUP-123456", "third_party_import_id": "undefined", "status_code": "failure", "error_response_body": [ { "sales_order_line_number": "SOL00000081", "sales_order_number": "SO0000000081", "supplier_invoice_number": "QAAP89873220071", "supplier_invoice_line_number": "QA789A867877ABN32251", "error_message": "The invoice do not have a corresponding purchase order which matches the purchase order number of the invoice provided\n" } ] } ] } }