AP Invoice API
Permite que sistemas externos, como os usados por fornecedores, enviem faturas com segurança diretamente para um sistema de contas a pagar de maneira estruturada e automatizada.
Esta API requer Processamento de faturas para contas a pagar aplicação de armazenamento (com.sn_ap_apm), que é fornecida em sn_spend_intg namespace. Para obter informações, consulte Accounts Payable Invoice Processing.
- Defina um campo personalizado para faturas, linhas de fatura e linhas de imposto de fatura.
- Mapeie o campo personalizado entre as tabelas de origem e de destino.
- Mapeie o campo personalizado para uma entrada de carga em um formato específico, como JSON, cXML ou XML.
- Definir credenciais para autenticação ao usar cXML como carga útil.
- Anexos da fatura
- Os endpoints XML e JSON são compatíveis com anexos nos níveis de fatura, linha de fatura e caso de fatura. O endpoint cXML não oferece suporte a anexos.
Fatura do AP - PUBLICAR sn_sn_spend_intg/ap_invoice/cxml
Processa uma fatura automatizada no formato XML de comércio (cXML).
Use a tabela Mapeamentos de campo de integração de fatura [sn_spend_intg_invoice_intg_field_mapping] para determinar como os campos são mapeados para marcadores cXML.
Para recursos cXML adicionais, consulte Guia de referência do cXML em https://xml.cxml.org .
As credenciais para esta API estão incluídas na carga. Você pode configurar credenciais na tabela Credencial do sistema de origem [sn_spend_intg_source_system_credential]. Para obter instruções, consulte Definir credenciais para autenticação na carga do cXML.
Formato de URL
URL com controle de versão: /api/sn_sp_intg/v1/ap_invoice/cxml
URL padrão: /api/sn_sp_intg/ap_invoice/cxml
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
| Caminho | Descrição |
|---|---|
| /CXML/Header/From /Credential | Identificador do revendedor ou fornecedor com o qual o cliente pode fazer pedidos. Campo de destino: u_supplier Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/request/InvoiceDetalRequest /InvoiceDetalRequestHeader[ em invoiceDate] | Data em que o cliente foi faturado. Campo de destino: u_invoice_date Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] FORMATO: AAAA-MM-DD |
| /CXML/request/InvoiceDetalRequest /InvoiceDetalRequestHeader[ em invoiceID] | Número da fatura gerado a partir de uma aplicação de terceiros. Campo de destino: u_external_invoice_number Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/request/InvoiceDetalRequest /InvoiceDetalRequestHeader | Sistema de origem externa em que a fatura é recebida. Por exemplo, fornecedor. Campo de destino: u_inbound_source Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalRequest /InvoiceDetalRequestHeader/InvoicePartner /Contact | A cidade para a qual a fatura será enviada. Campo de destino: u_bill_to_city Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalRequest /InvoiceDetalRequestHeader/InvoicePartner /Contact | O país para o qual a fatura é enviada no formato ISO 3166. Por exemplo, EUA . Campo de destino: u_bill_to_country Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalRequest /InvoiceDetalRequestHeader/InvoicePartner /Contact | O estado ou província para o qual a fatura é enviada. Campo de destino: u_bill_to_state_or_province Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalRequest /InvoiceDetalRequestHeader/InvoicePartner /Contact | O endereço para o qual a fatura é enviada. Campo de destino: u_bill_to_street Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalRequest /InvoiceDetalRequestHeader/InvoicePartner /Contact | O CEP ou código postal para o qual a fatura é enviada. Campo de destino: u_bill_to_zip_or_postal_code |
| Contato/PostalAddress /Street | O endereço para o qual o pagamento é feito. Campo de destino: u_remit_address |
| Contato/PostalAddress/Cidade | A cidade para a qual o pagamento será feito. Campo de destino: u_remit_to_city |
| Contato/PostalAddress/State | O estado ou província para o qual o pagamento é feito. Campo de destino: u_remit_to_state_or_province |
| PostalAddress /PostalCode | O CEP ou código postal para o qual o pagamento é feito. Campo de destino: u_remit_to_zip_or_postal_code |
| Contato/PostalAddress/País | O país para o qual o pagamento é feito no formato ISO 3166. Por exemplo, EUA . Campo de destino: u_remit_to_country |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalRequestHeader /InvoiceDetalShipping/Contact | Rua da qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_street Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalRequestHeader /InvoiceDetalShipping/Contact | Cidade da qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_city Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalRequestHeader /InvoiceDetalShipping/Contact | Estado do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_state_or_province Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalRequestHeader /InvoiceDetalShipping/Contact | CEP do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_zip_or_postal_code Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalRequestHeader /InvoiceDetalShipping/Contact | País do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_country Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalRequestHeader /InvoicePartner/Contact | Nome da entidade jurídica do fornecedor. Localizado na tabela Entidade jurídica [sn_fin_legal_entity]. Campo de destino: u_legal_entity Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| Contato/Nome | Nome do contato para o qual os itens na ordem de compra devem ser enviados. Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| Enviar/PostalAddress/Rua | Rua para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_street Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| Contato/PostalAddress/Cidade | Cidade para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_city Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| Contato/PostalAddress/State | Estado ou província para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_state_or_province |
| Contato/PostalAddress/PostalCode | CEP para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_zip_or_postal_code Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| Contato/PostalAddress/País | País para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_country Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest /InvoiceDetalRequestHeader/PaymentTerm | O tempo acordado e as condições sob as quais um pagamento a um fornecedor é feito. Por exemplo, Líquido 30 . Campo de destino: u_payment_terms Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/request/InvoiceDetalhRequest/InvoiceDetalhorder /InvoiceDetalItem[ em description]/ | Descrição da linha da fatura. Campo de destino: u_line_description |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceDetalItem[ em quantidade]/ | Quantidade de bens ou serviços pelos quais um cliente está sendo faturado. Campo de destino: u_line_quantity |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceDetalItem/Distribution/AccountingSegment[1]/Nome | Número da conta do centro de custos para o qual a fatura é gerada. Listado na tabela Centro de custos [cmn_cost_center]. Campo de destino: u_cost_center |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceDetalItem/Distribution/AccountingSegment[2]/Nome | Número da conta do razão geral (GL) usado para gerar a fatura. Campo de destino: u_gl_account Consulte também: |
| /CXML/Request/InvoiceDetalhRequest/InvoiceDetalOrder /InvoiceDetalItem/SubtotalAmount/Money | Valor total a ser pago ao fornecedor, excluindo impostos e despesas de envio. Campo de destino: u_subtotal Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalhRequest/InvoiceDetalhaOrder /InvoiceDetalItem/NetAmount/Money | Custo total, excluindo impostos e envio, que um cliente está sendo faturado para uma determinada linha de ordem de compra. Campo de destino: u_line_amount_faturado Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceDetalOrderInfo/OrderReference | Número da ordem de compra fornecido pelo cliente para esta ordem. Listado na tabela Ordem de compra [sn_shop_purchase_order]. Campo de destino: u_purchase_order Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceDetalItem/UnitPrice/UnitOfMeasure | Unidade de medida (UOM) base usada para contar o item na fatura. Campo de destino: u_uom Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceItem/UnitPrice/Money | Preço unitário do item de linha na fatura. Campo de destino: u_line_unit_price Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceItem/UnitPrice/Money | Moeda do item de linha. Por exemplo, USD . Campo de destino: u_currency Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceDetalItem /InvoiceDetalItemReference | ID da linha da ordem de compra do fornecedor referenciado. Listado na tabela Linha de ordem de compra [sn_shop_purchase_order_line]. Campo de destino: u_purchase_order_line Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| CXML/Solicitação/InvoiceDetalheRequest/InvoiceDetalhaOrder /InvoiceItem/InvoiceDetalhaReferência /ItemID/SupplierPartID | Número de peça gerado por um fornecedor para esta linha de fatura. Campo de destino: u_supplier_part_number Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| CXML/Request/InvoiceDetalRequest/InvoiceDetalOrder /InvoiceDetalItem/InvoiceDetalhItemReferência/Descrição | Descrição da linha da ordem de compra da fatura. Campo de destino: u_po_line_description Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| CXML/Solicitação/InvoiceDetalheRequest/InvoiceDetalOrder /InvoiceDetalItem/Imposto/Dinheiro | Valor total de impostos faturados pela compra. Campo de destino: u_tax_amount Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| CXML/Solicitação/InvoiceDetalheRequest/InvoiceDetalOrder /InvoiceDetalItem/Imposto/Descrição | Código de imposto exclusivo gerado a partir da origem do ERP. Campo de destino: u_tax_code Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /CXML/request/InvoiceDetalRequest/ InvoiceDetalhSummary /SubtotalAmount/money | Valor total a ser pago ao fornecedor, excluindo impostos e despesas de envio. Campo de destino: u_subtotal Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/request/InvoiceDetalRequest/InvoiceDetalhSummary /Tax/Money | Valor total de impostos faturados pela compra. Campo de destino: u_tax_amount Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] |
| /CXML/Request/InvoiceDetalheRequest/InvoiceDetalhSummary /Tax/TaxDetaiList | Tipo de imposto aplicável na fatura. Listado na tabela Tipo de imposto [sn_fin_tax_type]. Campo de destino: u_tax_type Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] |
| /CXML/Request/InvoiceDetalheRequest/InvoiceDetalhSummary /Tax/TaxDetait[ em percentageRate] | A alíquota de imposto cobrada pelo fornecedor. Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] Campo de destino: u_supplier_tax_rate Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] |
| /CXML/request/InvoiceDetalhRequest/InvoiceDetalhSummary /SpecialHandlingAmount/money | Outras cobranças adicionais associadas à fatura. Este é um campo editável. Campo de destino: u_other_charges Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/request/InvoiceDetalhrequest/InvoiceDetalhSummary /ShippingAmount/money | Custo total de envio para toda a compra. Campo de destino: u_shipping_amount Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/request/InvoiceDetalRequest/InvoiceDetalhSummary /GrossAmount/money | Obrigatório. Moeda para subtotal, imposto e envio. O subtotal, o imposto e o envio devem estar na mesma moeda. Campo de destino: u_currency Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/request/InvoiceDetalhrequest/InvoiceDetalhSummary /InvoiceDetalhdiscount/money | Descontos aplicados à fatura. Campo de destino: u_discounts Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /CXML/Request/InvoiceDetalhRequest/InvoiceDetalhSummary /NetAmount/Money | Valor total a ser pago ao fornecedor, incluindo impostos e despesas de envio. Campo de destino: u_amount_faturado Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
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. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/xml. |
| Source-System | Especifica o sistema de origem do qual a solicitação vem. Os sistemas disponíveis são listados na tabela Credenciais dos sistemas de origem [sn_spend_intg_source_system_credential]. Esta configuração ajuda a determinar se a solicitação fornecida segue a estrutura na tabela Mapeamento de campo de integração de fatura [sn_sp_intg_invoice_intg_field_mapping]. Esta configuração também é usada para buscar credenciais da tabela Credenciais do sistema de origem [sn_sp_intg_source_system_credential]. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 202 | Solicitação aceita. A solicitação foi bem-sucedida e o processamento da fatura está em andamento. |
| 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. |
| 429 | Excesso de solicitações. A taxa de solicitação excedeu o máximo de 10 solicitações por hora. |
Parâmetros do corpo da resposta
| Nome | Descrição |
|---|---|
| batch_id | Identificador exclusivo da solicitação em lote. Este ID pode ser usado para rastrear o status da solicitação. Este registro é armazenado na tabela Log de integração de fatura [sn_spend_intg_invoice_integration_log]. Tipo de dados: Cadeia de caracteres |
| erro | Contém mensagem de erro e detalhes quando a solicitação falha.Tipo de dados: Objeto |
| error.detail | Detalhes adicionais sobre o erro de solicitação. Possíveis resultados:
Tipo de dados: Cadeia de caracteres |
| mensagem.erro | Mensagem de erro que contém o motivo da falha na solicitação Possíveis erros:
Tipo de dados: Cadeia de caracteres |
| mensagem | Mensagem de sucesso, por exemplo, Sua solicitação foi recebida com sucesso e está sendo processada . Você pode exibir o status da solicitação na tabela Log de integração de fatura [sn_sp_intg_invoice_integration_log]. Tipo de dados: Cadeia de caracteres |
| status | Indica o resultado da solicitação. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
Solicitação de curl
O exemplo a seguir mostra como processar uma fatura fornecida como uma solicitação no formato cXML.
curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/cxml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '{
"content": "------=_Part_1367_1859161670.1709186492411\r\nContent-Type: text/xml; charset=UTF-8\r\n
Content-ID: 1709186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com\r\n<?xml version=\"1.0\"
encoding=\"UTF-8\"?>\r\n<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/fgKrCERVqQU35PNzBuw39pz?domain=xml.cxml.org\">
\r\n<cXML timestamp=\"2024-02-28T22:01:32-08:00\" payloadID=\"1709186492411-3401013259654180284@10.209.37.74\">
\r\n <Response>\r\n <Status code=\"200\" text=\"OK\" />\r\n <DataResponse>\r\n <Attachment>
\r\n <URL>186492411.10815535@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.110</URL>\r\n </Attachment>
\r\n <Attachment>\r\n <URL>1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108</URL>
\r\n </Attachment>\r\n </DataResponse>\r\n </Response>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411
\r\nContent-Type: text/xml; charset=UTF-8\r\nContent-ID: 1709186492403.306612238@produs-c4-an-s2-z3-1.us2.gcpint.ariba.com.108
\r\n<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n
<!DOCTYPE cXML SYSTEM \"https://protect-us.mimecast.com/s/7QpfCG6VRKf15gQPwFpUTKe?domain=xml.cxml.org\">\r\n
<cXML payloadID=\"1705930173863-1790846563502652473@10.209.37.98\" timestamp=\"2024-01-22T05:29:33-08:00\" version=\"1.2.060\">\r\n
<Header>\r\n <From>\r\n <Credential domain=\"NetworkID\">\r\n <Identity>AN01532216648-T</Identity>\r\n
</Credential>\r\n <Credential domain=\"VendorID\">\r\n <Identity>3245545</Identity>\r\n
</Credential>\r\n <Credential domain=\"PrivateID\">\r\n <Identity>0000099123</Identity>\r\n
</Credential>\r\n </From>\r\n <To>\r\n <Credential domain=\"NetworkID\">\r\n
<Identity>AN01404744424-T</Identity>\r\n </Credential>\r\n <Credential domain=\"SystemID\">\r\n
<Identity>ERP1</Identity>\r\n </Credential>\r\n <Credential domain=\"EndPointID\">\r\n
<Identity>CIG</Identity>\r\n </Credential>\r\n </To>\r\n <Sender>\r\n
<Credential domain=\"NetworkID\">\r\n <Identity>AN01000000001</Identity>\r\n
<SharedSecret>Ariba@123</SharedSecret>\r\n </Credential>\r\n <UserAgent>Supplier</UserAgent>\r\n
</Sender>\r\n </Header>\r\n <Request deploymentMode=\"test\">\r\n <InvoiceDetailRequest>\r\n
<InvoiceDetailRequestHeader invoiceDate=\"2024-01-22\" invoiceID=\"\" invoiceOrigin=\"supplier\" operation=\"new\ purpose=\"PO Invoice\">\r\n
<InvoiceDetailHeaderIndicator></InvoiceDetailHeaderIndicator>\r\n
<InvoiceDetailLineIndicator></InvoiceDetailLineIndicator>\r\n <InvoicePartner>\r\n
<Contact addressID=\"Test123\" role=\"remitTo\">\r\n
<Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
<PostalAddress>\r\n <Street>Xyz street</Street>\r\n <City>USA</City>\r\n
<State isoStateCode=\"US-NY\">NY</State>\r\n <PostalCode>10001</PostalCode>\r\n
<Country isoCountryCode=\"US\">United States</Country>\r\n </PostalAddress>\r\n
</Contact>\r\n </InvoicePartner>\r\n <InvoicePartner>\r\n
<Contact addressID=\"9009\" role=\"billTo\">\r\n <Name xml:lang=\"EN\">Bristlecone Inc</Name>\r\n
<PostalAddress>\r\n <Street>10 Boulvard-10</Street>\r\n
<City>San Jose</City>\r\n <State>CA</State>\r\n
<PostalCode>94077</PostalCode>\r\n <Country isoCountryCode=\"US\"></Country>\r\n
</PostalAddress>\r\n <Phone>\r\n <TelephoneNumber>\r\n
<CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n <Number>7687687799</Number>\r\n
</TelephoneNumber>\r\n </Phone>\r\n <Fax>\r\n
<TelephoneNumber>\r\n <CountryCode isoCountryCode=\"US\">1</CountryCode>\r\n
<Number>768-FAX-NUMBER</Number>\r\n </TelephoneNumber>\r\n </Fax>\r\n
</Contact>\r\n </InvoicePartner>\r\n <InvoicePartner>\r\n <Contact role=\"from\">\r\n
<Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n <PostalAddress>\r\n
<Street>123 , street no 5</Street>\r\n <City>Dallas</City>\r\n
<State isoStateCode=\"US-AL\">AL</State>\r\n <PostalCode>36615</PostalCode>\r\n
<Country isoCountryCode=\"US\">United States</Country>\r\n </PostalAddress>\r\n
</Contact>\r\n </InvoicePartner>\r\n <InvoiceDetailShipping>\r\n
<Contact role=\"shipFrom\">\r\n <Name xml:lang=\"en-US\">Oil and Natural Gas Corporation Limited</Name>\r\n
<PostalAddress>\r\n <Street>Deendayal Urja Bhawan</Street>\r\n
<City>New Delhi</City>\r\n <State isoStateCode=\"IN-MH\">Maharashtra</State>\r\n
<PostalCode>110070</PostalCode>\r\n <Country isoCountryCode=\"IN\">India</Country>\r\n
</PostalAddress>\r\n </Contact>\r\n <Contact addressID=\"9999\" role=\"shipTo\">\r\n
<Name xml:lang=\"EN\">Buyer Plant Bristlecone</Name>\r\n <PostalAddress name=\"default\">\r\n
<Street>18 Hanoi Road</Street>\r\n <City>San Jose</City>\r\n
<State>CA</State>\r\n <PostalCode>77077</PostalCode>\r\n
<Country isoCountryCode=\"US\"></Country>\r\n </PostalAddress>\r\n
<Email name=\"default\" preferredLang=\"en\">test@test.com</Email>\r\n </Contact>\r\n
</InvoiceDetailShipping>\r\n </InvoiceDetailRequestHeader>\r\n <InvoiceDetailOrder>\r\n
<InvoiceDetailOrderInfo>\r\n <OrderReference orderID=\"\">\r\n
<DocumentReference payloadID=\"0AAF8EA1FA5F1EDE9FDC97460BCB03E1\"></DocumentReference>\r\n
</OrderReference>\r\n </InvoiceDetailOrderInfo>\r\n
<InvoiceDetailItem invoiceLineNumber=\"2\" quantity=\"25\" description=\"Indian Oil\">\r\n
<UnitOfMeasure>EA</UnitOfMeasure>\r\n <UnitPrice>\r\n <Money currency=\"USD\">50</Money>\r\n
</UnitPrice>\r\n <SubtotalAmount>\r\n <Money currency=\"USD\">1250.00</Money>\r\n
</SubtotalAmount>\r\n </InvoiceDetailItem>\r\n </InvoiceDetailOrder>\r\n </InvoiceDetailRequest>\r\n
</Request>\r\n</cXML>\r\n------=_Part_1367_1859161670.1709186492411--"
}'
O resultado a seguir mostra que a solicitação foi bem-sucedida e que os dados da fatura estão sendo processados. Você pode exibir o status da solicitação na tabela Log de integração de fatura [sn_sp_intg_invoice_integration_log]. Use o ID do lote listado na coluna ID do lote para encontrar a fatura.
{
"batchId": "APIINV1729711710733280",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}
Fatura do AP - PUBLICAR sn_sn_spend_intg/ap_invoice/json
Processa uma fatura automatizada no formato JSON.
Função necessária: sn_spend_intg.procurement_integrator
Use a tabela Mapeamentos de campo de integração de fatura [sn_spend_intg_invoice_intg_field_mapping] para determinar como os campos são mapeados para as propriedades JSON.
Formato de URL
URL com controle de versão: /api/sn_sp_intg/v1/ap_invoice/json
URL padrão: /api/sn_sp_intg/ap_invoice/json
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
| Nome | Descrição |
|---|---|
| faturas | Lista que contém cada fatura a ser processada. Tipo de dados: Objeto de objetos de fatura aninhados. |
| invoices.amount_faturado | Valor total a ser pago ao fornecedor, incluindo impostos e despesas de envio. Campo de destino: u_amount_faturado Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| bill_to_city | A cidade para a qual a fatura será enviada. Campo de destino: u_bill_to_city Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| bill_to_country | O país para o qual a fatura é enviada no formato ISO 3166. Por exemplo, EUA . Campo de destino: u_bill_to_country Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| bill_to_state_or_province | O estado ou província para o qual a fatura é enviada. Campo de destino: u_bill_to_state_or_province Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| bill_to_street | O endereço para o qual a fatura é enviada. Campo de destino: u_bill_to_street Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| bill_to_zip_or_postal_code | O CEP ou código postal para o qual a fatura é enviada. Campo de destino: u_bill_to_zip_or_postal_code |
| invoices.business_owner | Nome do responsável pela aplicação do lado comercial. Campo de destino: u_business_owner Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoic e] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| faturas.currency | Obrigatório. Moeda para subtotal, imposto e envio. O subtotal, o imposto e o envio devem estar na mesma moeda. Campo de destino: u_currency Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| descontos.faturas | Descontos aplicados à fatura. Campo de destino: u_discounts Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| erp_number | Número exclusivo gerado no sistema ERP (Enterprise Resource Planning) para a ordem de compra. Para obter informações, consulte Purchase order integration. Campo de destino: u_erp_number Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| faturas. external_invoice_number | Obrigatório. Número da fatura gerado a partir de uma aplicação de terceiros. Campo de destino: u_external_invoice_number Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| faturas. invoice_copy_attachment | Lista de anexos definidos no nível da fatura. Consulte Accounts Payable Invoice Processing. Uma vez criado, o sistema gerará o registro da fatura junto com o caso de fatura associado e as linhas de fatura. Os anexos serão vinculados aos respectivos registros de acordo. Tipo de dados: Matriz de objetos |
| invoices.invoice_copy_attachment. conteúdo | Conteúdo do arquivo codificado em base64 do anexo. Tipo de dados: Cadeia de caracteres |
| invoices.invoice_copy_attachment. codificação | Este valor é sempre base64 . Tipo de dados: Cadeia de caracteres |
| invoices.invoice_copy_attachment. mime_code | Este valor é sempre base64 . Tipo de dados: Cadeia de caracteres |
| invoices.invoice_copy_attachment. nome | Nome do arquivo do anexo. Nota: Não use o prefixo reservado "sd_" para um nome de arquivo de anexo. Tipo de dados: Cadeia de caracteres |
| invoices.invoice_date | Obrigatório. Data em que o cliente foi faturado. Campo de destino: u_invoice_date Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 FORMATO: AAAA-MM-DD |
| invoices.invoice_line_count | Número de linhas na fatura. Campo de destino: u_invoice_line_count Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines | Lista de objetos que definem as linhas que estão sendo faturadas para compras neste pedido. As linhas de fatura são preparadas na tabela de entrada de importação de linha de fatura [sn_spend_intg_imp_invoice_line]. Tipo de dados: Matriz de objetos |
| invoices.invoice_lines. anexos | Lista de anexos definidos no nível da linha da fatura. Consulte Create New Invoice Line form. Uma vez criado, o sistema gerará o registro da fatura junto com o caso de fatura associado e as linhas de fatura. Os anexos serão vinculados aos respectivos registros de acordo. Tipo de dados: Matriz de objetos |
| invoices.invoice_lines. anexos.conteúdo | Conteúdo do arquivo codificado em base64 do anexo. Tipo de dados: Cadeia de caracteres |
| invoices.invoice_lines. attachments.encoding | Este valor é sempre base64 . Tipo de dados: Cadeia de caracteres |
| invoices.invoice_lines. attachments.mime_code | Este valor é sempre base64 . Tipo de dados: Cadeia de caracteres |
| invoices.invoice_lines. attachments.name | Nome do arquivo do anexo. Nota: Não use o prefixo reservado "sd_" para um nome de arquivo de anexo. Tipo de dados: Cadeia de caracteres |
| invoices.invoice_lines. cost_center | Número da conta do centro de custos para o qual a fatura é gerada. Listado na tabela Centro de custos [cmn_cost_center]. Campo de destino: u_cost_center Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. moeda | Moeda do item de linha. Por exemplo, USD . Campo de destino: u_currency Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. external_invoice_number | Obrigatório. Número da fatura gerado a partir de uma aplicação de terceiros. Campo de destino: u_external_invoice_number Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. gl_account | Número da conta do razão geral (GL) usado para gerar a fatura. Campo de destino: u_gl_account Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 Consulte também: |
| invoices.invoice_lines. line_amount_faturado | Obrigatório. Custo total, excluindo impostos e envio, que um cliente está sendo faturado para uma determinada linha de ordem de compra. Campo de destino: u_line_amount_faturado Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. line_description | Obrigatório. Descrição da linha da fatura. Campo de destino: u_line_description Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. line_quantity | Obrigatório. Quantidade de bens ou serviços pelos quais um cliente está sendo faturado. Campo de destino: u_line_quantity Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. line_unit_price | Preço unitário do item de linha na fatura. Campo de destino: u_line_unit_price Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. po_line_description | Descrição da linha da ordem de compra da fatura. Campo de destino: u_po_line_description Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. purchase_order_line | Obrigatório. ID da linha da ordem de compra do fornecedor referenciado. Listado na tabela Linha de ordem de compra [sn_shop_purchase_order_line]. Campo de destino: u_purchase_order_line Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. ship_to_city | Cidade para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_city Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. ship_to_country | País para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_country Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. ship_to_state_or_province | Estado ou província para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_state_or_province Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. ship_to_street | Rua para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_street Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. ship_to_zip_or_postal_code | CEP para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_zip_or_postal_code Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. subtotal | Obrigatório. Valor total a ser pago ao fornecedor, excluindo impostos e despesas de envio. Campo de destino: u_subtotal Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. supplier_part_number | Obrigatório. Número de peça gerado por um fornecedor para esta linha de fatura. Campo de destino: u_supplier_part_number Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| tax_code invoices.invoice_lines | Código de imposto exclusivo gerado a partir da origem do ERP. Campo de destino: u_tax_code Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. tax_details | Lista de linhas de imposto para compras associadas à linha de fatura. Tipo de dados: Matriz de objetos |
| invoices.invoice_lines. tax_details.tax_amount | Obrigatório. Valor total de impostos faturados pela compra. Campo de destino: u_tax_amount Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.invoice_lines. tax_details.tax_rate | A alíquota de imposto cobrada pelo fornecedor. Campo de destino: u_supplier_tax_rate Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines. tax_details.tax_type | Tipo de imposto aplicável na fatura. Listado na tabela Tipo de imposto [sn_fin_tax_type]. Campo de destino: u_tax_type Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_lines.uom | Unidade de medida (UOM) base usada para contar o item na fatura. Campo de destino: u_uom Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.invoice_type | Tipo de fatura para processamento. Campo de destino: u_invoice_type Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.legal_entity | Nome da entidade jurídica do fornecedor. Localizado na tabela Entidade jurídica [sn_fin_legal_entity]. Campo de destino: u_legal_entity Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.original_invoice | Número da fatura exclusivo criado pelo fornecedor. Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Campo de destino: u_original_invoice Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| other_chargs | Outras cobranças adicionais associadas à fatura. Este é um campo editável. Campo de destino: u_other_charges Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.payment_terms | O tempo acordado e as condições sob as quais um pagamento a um fornecedor é feito. Por exemplo, Líquido 30 . Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| purchase_order | Obrigatório. Número da ordem de compra fornecido pelo cliente para esta ordem. Listado na tabela Ordem de compra [sn_shop_purchase_order]. Campo de destino: u_purchase_order Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| invoices.remit_address | Obrigatório. O endereço para o qual o pagamento é feito. Campo de destino: u_remit_address Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.remit_to_city | Obrigatório. A cidade para a qual o pagamento será feito. Campo de destino: u_remit_to_city Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.remit_to_country | Obrigatório. O país para o qual o pagamento é feito no formato ISO 3166. Por exemplo, EUA . Campo de destino: u_remit_to_country Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| faturas. remit_to_state_or_province | Obrigatório. O estado ou província para o qual o pagamento é feito. Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| faturas. remit_to_zip_or_postal_code | Obrigatório. O CEP ou código postal para o qual o pagamento é feito. Campo de destino: u_remit_to_state_or_province Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.ship_from_city | Cidade da qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_city Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.ship_from_country | País do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_country Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| faturas. ship_from_state_or_province | Estado do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_state_or_province Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.ship_from_street | Rua da qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_street Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| faturas. ship_from_zip_or_postal_code | CEP do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_zip_or_postal_code Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.ship_to_city | Cidade para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_city Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.ship_to_country | País para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_country Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| faturas. send_to_state_or_province | Estado para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_state_or_province Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.ship_to_street | Rua para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_street Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| faturas. enviar_para_zip_or_postal_code | CEP para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_zip_or_postal_code Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.shipping_amount | Obrigatório. Custo total de envio para toda a compra. Campo de destino: u_shipping_amount Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| subtotal | Obrigatório. Valor total a ser pago ao fornecedor, excluindo impostos e despesas de envio. Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 40 |
| fornecedor.faturas | Obrigatório. Identificador do revendedor ou fornecedor com o qual o cliente pode fazer pedidos. Campo de destino: u_supplier Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| faturas. supplier_invoice_number | Obrigatório. Número de identificação gerado por um fornecedor para esta fatura. Campo de destino: u_supplier_invoice_number Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] 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. Campo de destino: u_supplier_tax_id Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Tipo de dados: Cadeia de caracteres Comprimento máximo: 100 |
| invoices.target_erp | Registro ERP no qual a fatura é publicada. Localizado na tabela Origem do ERP [sn_fin_erp_source]. Consulte ERP source. Tipo de dados: Cadeia de caracteres |
| faturas. supporting_attachings | Lista de anexos definidos no nível de caso de processamento de fatura para casos atribuídos a Especialistas em contas a pagar. Consulte Invoice processing case form. Uma vez criado, o sistema gerará o registro da fatura junto com o caso de fatura associado e as linhas de fatura. Os anexos serão vinculados aos respectivos registros de acordo. Tipo de dados: Matriz de objetos |
| faturas. supporting_attachments.content | Conteúdo do arquivo codificado em base64 do anexo. Tipo de dados: Cadeia de caracteres |
| faturas. supporting_attachments.encoding | Este valor é sempre base64 . Tipo de dados: Cadeia de caracteres |
| faturas. supporting_attachments.mime_code | Este valor é sempre base64 . Tipo de dados: Cadeia de caracteres |
| faturas. supporting_attachments.name | Nome do arquivo do anexo. Nota: Não use o prefixo reservado "sd_" para um nome de arquivo de anexo. Tipo de dados: Cadeia de caracteres |
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. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/json. |
| Source-System | Especifica o sistema de origem do qual a solicitação vem. Esta configuração ajuda a determinar se a solicitação fornecida segue a estrutura na tabela Mapeamento de campo de integração de fatura [sn_sp_intg_invoice_intg_field_mapping]. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 202 | Solicitação aceita. A solicitação foi bem-sucedida e o processamento da fatura está em andamento. |
| 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. |
| 429 | Excesso de solicitações. A taxa de solicitação excedeu o máximo de 10 solicitações por hora. |
Parâmetros do corpo da resposta
| Nome | Descrição |
|---|---|
| batch_id | Identificador exclusivo da solicitação em lote. Este ID pode ser usado para rastrear o status da solicitação. Este registro é armazenado na tabela Log de integração de fatura [sn_spend_intg_invoice_integration_log]. Tipo de dados: Cadeia de caracteres |
| erro | Contém mensagem de erro e detalhes quando a solicitação falha.Tipo de dados: Objeto |
| error.detail | Detalhes adicionais sobre o erro de solicitação. Possíveis resultados:
Tipo de dados: Cadeia de caracteres |
| mensagem.erro | Mensagem de erro que contém o motivo da falha na solicitação Possíveis erros:
Tipo de dados: Cadeia de caracteres |
| mensagem | Mensagem de sucesso, por exemplo, Sua solicitação foi recebida com sucesso e está sendo processada . Você pode exibir o status da solicitação na tabela Log de integração de fatura [sn_sp_intg_invoice_integration_log]. Tipo de dados: Cadeia de caracteres |
| status | Indica o resultado da solicitação. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
Solicitação de curl
O exemplo a seguir mostra como processar uma fatura fornecida como uma solicitação no formato JSON. A codificação base64 varia em tamanho e pode ser muito grande. O valor do conteúdo foi truncado para economizar espaço. As informações refletem a estrutura de carga adequada.
curl "https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/json" \
--request \
POST \
--header \
"Source-System: Coupa" \
--header \
"Content-Type: application/json" \
--user 'username' \
:'password' \
--data \
'{
"invoices": [
{
"invoice_type": "",
"supplier_invoice_number": "2InvoiceAttach_A1",
"external_invoice_number": "EXT-INV-erp-po-1_Attach1",
"supplier": "",
"business_owner": "lara.croft@example.com",
"purchase_order": "",
"date_format": "DD MMMM, YYYY",
"invoice_date": "2nd June, 2021",
"payment_terms": "Net 30",
"legal_entity": "AUS",
"subtotal": "(100.00)",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "00.00",
"amount_invoiced": "200.00",
"currency": "USD",
"invoice_line_count": "10",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "123456789",
"invoice_copy_attachment": [
{
"file_name": "InvoiceTestInv_Json_A1.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmV/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceTestINVIMG_Json_A1.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1B/Base64EncodingIntentionallyTruncated"
}
],
"tax_details": [
{
"tax_type": "CGST",
"tax_amount": "10",
"tax_rate": ""
},
{
"tax_type": "Withholding tax",
"tax_amount": "",
"tax_rate": "25"
},
{
"tax_type": "Sales tax",
"tax_amount": "12",
"tax_rate": "12"
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-erp-po-1",
"line_description": "2INV_Line_Attach_A1",
"po_line_description": "",
"purchase_order_line": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "118.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "100001",
"tax_code": "A1 - Sales tax, reduced rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"attachments": [
{
"file_name": "InvoiceTestLine.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQc/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceTest1Line.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0MgUHJvZmW2GWCy8SpAszALlJ/Mv6HK54/f/3/XFv4ysU57JMAAAAASUVORK5CYII="
}
]
},
{
"external_invoice_number": "EXT-INV-erp-po-3",
"line_description": "Testing",
"po_line_description": "",
"purchase_order_line": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "118.00",
"currency": "USD",
"cost_center": "ACN00005",
"gl_account": "100002",
"tax_code": "A1 - Sales tax, reduced rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours"
}
]
},
{
"invoice_type": "",
"supplier_invoice_number": "10MultiInvoiceAttach_A2",
"external_invoice_number": "EXT-INV-noerp-PO_Attach_A2",
"purchase_order": "0004531004",
"supplier": "880733",
"date_format": "DD-MM-YYYY",
"invoice_date": "02-05-2021",
"payment_terms": "NET 30",
"legal_entity": "XYZ Ltd.",
"subtotal": "100",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "10.00",
"amount_invoiced": "140.00",
"currency": "USD",
"invoice_line_count": "1",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "12340009",
"supporting_attachments": [
{
"file_name": "10InvcCaseTstInv_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24gOTY3MTUxMzkw/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstPNGInv_Json_A2.png",
"mime_code": "image/png",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0MgUHJvZmlsZQAASImVVwdY/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstInv2_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24gOTY3MTQzNjgzKQovQXV0aG9yIChQYWdlcm8gQUIpCi9Td/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstXMLINV_Json_A2.xml",
"mime_code": "text/xml",
"encoding": "base64",
"content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9I/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTtExcelINV_Json_A2.xlsx",
"mime_code": "application/vnd.ms-excel",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAAAAAAAAAA/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstCSVINV_Json_A2.csv",
"mime_code": "text/csv",
"encoding": "base64",
"content": "Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic3VwcGxpZXIiLCJzdGF0ZSIsInR5cGUiLCJkd/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstJsonINV_Json_A2.json",
"mime_code": "application/json",
"encoding": "base64",
"content": "eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lbnQiOiJmYWxzZSIsInRheF9hbW91buYm91bmRfc291cmNlIjoiIn1dfQ==/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTstdocINV_Json_A2.docx",
"mime_code": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAAAAAAA/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceCasePPT_Json_A2.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiB="
},
{
"file_name": "10InvoiceCaseRichText_Json_A2.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRleHRzY2FsaW5nMFxjb2NvYXBsYXRmb3JtM/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvcCaseTst_INVJPG_Json_A2.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINCgoNEhQQEBIQEB/Base64EncodingIntentionallyTruncated"
}
],
"invoice_copy_attachment": [
{
"file_name": "10InvoiceTestInv_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24g/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestInv_Json_A2.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0MgUHJvZmls/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvceTstInv2_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50YXRpb24g=/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestXMLINV_Json_A2.xml",
"mime_code": "text/xml",
"encoding": "base64",
"content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vI/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestExcelINV_Json_A2.xlsx",
"mime_code": "application/vnd.ms-excel",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAACAAAAAAAAAAAAAA=/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestCSVINV_Json_A2.csv",
"mime_code": "text/csv",
"encoding": "base64",
"content": "Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic3VwcGxpZXIiLCJzd/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestJsonINV_Json_A2.json",
"mime_code": "application/json",
"encoding": "base64",
"content": "eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lbnQiOiJmYWxzZSI/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestdocINV_Json_A2.docx",
"mime_code": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnht/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoicePPT_Json_A2.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtb/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceRichText_Json_A2.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRleHRz/Base64EncodingIntentionallyTruncated"
}
],
"tax_details": [
{
"tax_type": "Value added tax",
"tax_amount": "21",
"tax_rate": ""
},
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "22"
},
{
"tax_type": "Withholding tax",
"tax_amount": "23",
"tax_rate": ""
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-noerp-PO_Attach_A2",
"purchase_order_line": "00045310041",
"po_line_description": "Yeti microphone - black",
"line_description": "10MultiInvoiceLineAttach_A2",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00-",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "141150",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"attachments": [
{
"file_name": "10InvoiceTest_INVLine_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTest_INVLine_Json_A2.jpg",
"mime_code": "image/jpeg",
"encoding": "base64",
"content": "iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ0Mg/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvceTst2_INVLine_Json_A2.pdf",
"mime_code": "application/pdf",
"encoding": "base64",
"content": "JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZW50Y/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestXML_INVLine_Json_A2.xml",
"mime_code": "text/xml",
"encoding": "base64",
"content": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxv/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestExcel_INVLine_Json_A2.xlsx",
"mime_code": "application/vnd.ms-excel",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZX/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10InvoiceTestdoc_INVLine_Json_A2.docx",
"mime_code": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZX/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10_InvoiceLinePPT_Json_A2.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZX/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "10_InvoiceLineRichText_Json_A2.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYX/Base64EncodingIntentionallyTruncated"
}
],
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "3.4"
},
{
"tax_type": "GST",
"tax_amount": "3.9",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "2",
"tax_rate": "4"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO",
"purchase_order_line": "00045310041",
"po_line_description": "Yeti microphone - black",
"line_description": "Testing ERP POL",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00-",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "141150",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "3.4"
},
{
"tax_type": "GST",
"tax_amount": "3.9",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "2",
"tax_rate": "4"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO_Attach3",
"purchase_order_line": "00045310042",
"po_line_description": "Pv-3310 photo tripod w/3-way pan",
"line_description": "Date Formate Test",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00002",
"gl_account": "100005",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "3.2"
},
{
"tax_type": "Withholding tax",
"tax_amount": "",
"tax_rate": "4"
},
{
"tax_type": "VAT",
"tax_amount": "",
"tax_rate": "3"
}
],
"attachments": [
{
"file_name": "InvoiceLinePPT.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXN/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceLineRichText.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYX/Base64EncodingIntentionallyTruncated"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO-01",
"purchase_order_line": "00045310042",
"po_line_description": "Yeti microphone - black",
"line_description": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00005",
"gl_account": "141101",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "SGST",
"tax_amount": "",
"tax_rate": "3.1"
},
{
"tax_type": "GST",
"tax_amount": "3.8",
"tax_rate": ""
},
{
"tax_type": "CGST",
"tax_amount": "",
"tax_rate": "1.2"
}
]
}
]
},
{
"invoice_type": "",
"supplier_invoice_number": "LineLevelTax_Attach3",
"external_invoice_number": "EXT-INV-noerp-PO-line_attach3",
"purchase_order": "",
"supplier": "880733",
"date_format": "mm-dd-yyyy",
"invoice_date": "09-05-2021",
"payment_terms": "NET 30",
"legal_entity": "1100.",
"subtotal": "100",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "10.00-",
"amount_invoiced": "140.00",
"currency": "USD",
"invoice_line_count": "1",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "12340009",
"invoice_copy_attachment": [
{
"file_name": "InvoicePPT.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXNdLnh/Base64EncodingIntentionallyTruncated"
},
{
"file_name": "InvoiceRichText.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRleH/Base64EncodingIntentionallyTruncated"
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-noerp-PO-3",
"purchase_order_line": "00045310041",
"po_line_description": "Yeti microphone - black",
"line_description": "Testing ERP POL",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00005",
"gl_account": "120040",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "6"
},
{
"tax_type": "GST",
"tax_amount": "7",
"tax_rate": ""
},
{
"tax_type": "Sales tax",
"tax_amount": "8",
"tax_rate": "8"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO-3",
"purchase_order_line": "00045310042",
"po_line_description": "Pv-3310 photo tripod w/3-way pan",
"line_description": "Date Formate Test",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "200.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00001",
"gl_account": "141250",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "CGST",
"tax_amount": "",
"tax_rate": "4.1"
},
{
"tax_type": "SGST",
"tax_amount": "4.4",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "",
"tax_rate": "4.3"
}
]
},
{
"external_invoice_number": "EXT-INV-noerp-PO-3",
"purchase_order_line": "00045310042",
"po_line_description": "Yeti microphone - black",
"line_description": "",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "97.00",
"currency": "USD",
"cost_center": "ACN00007",
"gl_account": "141300",
"tax_code": "A0 - Sales tax, standard rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"uom": "Hours",
"tax_details": [
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "2.4"
},
{
"tax_type": "Withholding tax",
"tax_amount": "5.5",
"tax_rate": ""
},
{
"tax_type": "VAT",
"tax_amount": "2.6",
"tax_rate": ""
}
]
}
]
},
{
"invoice_type": "credit_memo",
"supplier_invoice_number": "EXT-INV-erp-po_AttachLine",
"external_invoice_number": "EXT-INV-erp-po_AttachLine",
"original_invoice": "INV0001013",
"supplier": "",
"business_owner": "lara.croft@example.com",
"purchase_order": "0004889699",
"invoice_date": "09/13/2024",
"payment_terms": "Net 30",
"legal_entity": "AUS",
"subtotal": "150.00",
"shipping_amount": "30.00",
"other_charges": "20.00",
"discounts": "00.00",
"amount_invoiced": "200.00",
"currency": "USD",
"invoice_line_count": "10",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"ship_from_city": "Los Angeles",
"ship_from_country": "USA",
"ship_from_state_or_province": "CA",
"ship_from_street": "456 Oak Ave",
"ship_from_zip_or_postal_code": "90001",
"remit_address": "789 Elm St, Suite 200",
"remit_to_city": "Chicago",
"remit_to_country": "USA",
"remit_to_state_or_province": "IL",
"remit_to_zip_or_postal_code": "60601",
"supplier_tax_id": "123456789",
"tax_details": [
{
"tax_type": "CGST",
"tax_amount": "15",
"tax_rate": ""
},
{
"tax_type": "Sales tax",
"tax_amount": "",
"tax_rate": "10"
},
{
"tax_type": "SGST",
"tax_amount": "10",
"tax_rate": ""
}
],
"invoice_lines": [
{
"external_invoice_number": "EXT-INV-erp-po_AttachLine",
"line_description": "POL ERP number Attachment on line only",
"po_line_description": "",
"purchase_order_line": "00048896991",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "118.00",
"currency": "USD",
"cost_center": "ACN00004",
"gl_account": "436000",
"tax_code": "A1 - Sales tax, reduced rate",
"ship_to_city": "New York",
"ship_to_country": "USA",
"ship_to_state_or_province": "NY",
"ship_to_street": "123 Main St",
"ship_to_zip_or_postal_code": "10001",
"supplier_part_number": "SPN-001",
"attachments": [
{
"file_name": "InvoiceLinePPT.pptx",
"mime_code": "application/vnd.ms-powerpoint",
"encoding": "base64",
"content": "UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZXN/Base64EncodingIntentionallyTruncated""
},
{
"file_name": "InvoiceLineRichText.rtf",
"mime_code": "application/rtf",
"encoding": "base64",
"content": "e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2NvYXRl/Base64EncodingIntentionallyTruncated"
],
"uom": "Hours"
}
]
}
],
"target_erp": ""
}'
O resultado a seguir mostra que a solicitação foi bem-sucedida e que os dados da fatura estão sendo processados. Você pode exibir o status da solicitação na tabela Log de integração de fatura [sn_sp_intg_invoice_integration_log]. Use o ID do lote listado na coluna ID do lote para encontrar a fatura.
{
"batchId": "APIINV1729711710733280",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}
Fatura do AP - PUBLICAR sn_sn_spend_intg/ap_invoice/xml
Processa uma fatura automatizada no formato XML.
Use a tabela Mapeamentos de campo de integração de fatura [sn_spend_intg_invoice_intg_field_mapping] para determinar como os campos são mapeados para marcadores XML.
Formato de URL
URL com controle de versão: /api/sn_sp_intg/v1/ap_invoice/xml
URL padrão: /api/sn_sp_intg/ap_invoice/xml
Parâmetros de solicitação compatíveis
| Nome | Descrição |
|---|---|
| api_version | Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres |
| Nome | Descrição |
|---|---|
| Nenhum(a) |
| Caminho | Descrição |
|---|---|
| /Invoice/AmontFaturado | Valor total a ser pago ao fornecedor, incluindo impostos e despesas de envio. Campo de destino: u_amount_faturado Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| Fatura/billToCity | A cidade para a qual a fatura será enviada. Campo de destino: u_bill_to_city Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/BiltoCountry | O país para o qual a fatura é enviada no formato ISO 3166. Por exemplo, EUA . Campo de destino: u_bill_to_country Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/BilToStateOrProvince | O estado ou província para o qual a fatura é enviada. Campo de destino: u_bill_to_state_or_province Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/billToStreet | O endereço para o qual a fatura é enviada. Campo de destino: u_bill_to_street Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/billToZipOrPostalCode | O CEP ou código postal para o qual a fatura é enviada. Campo de destino: u_bill_to_zip_or_postal_code |
| /Fatura/Moeda | Obrigatório. Moeda para subtotal, imposto e envio. O subtotal, o imposto e o envio devem estar na mesma moeda. Campo de destino: u_currency Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/DateFormat | Define o formato de data da fatura do padrão AAAA-MM-DD para outro formato de data compatível. O valor de data é definido em InvoiceDateelemento. Formatos de data compatíveis:
Nota: A entrada no formato MMM representa um mês em suas três primeiras letras, por exemplo, agosto A entrada no formato MMMM representa o nome completo do mês, por exemplo, agosto. Campo de destino: u_date_format Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Formato padrão: AAAA-MM-DD |
| /Fatura/Descontos | Descontos aplicados à fatura. Campo de destino: u_discounts Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/ExternalInvoiceNumber | Número da fatura gerado a partir de uma aplicação de terceiros. Campo de destino: u_external_invoice_number Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| Invoice/FatuceDate | Data em que o cliente foi faturado.Use DateFormatelemento para adicionar a data em um formato não padrão compatível. Campo de destino: u_invoice_date Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] Formato padrão: AAAA-MM-DD |
| /Invoice/LegalEntity | Nome da entidade jurídica do fornecedor. Localizado na tabela Entidade jurídica [sn_fin_legal_entity]. Campo de destino: u_legal_entity Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/OtherCharges | Outras cobranças adicionais associadas à fatura. Este é um campo editável. Campo de destino: u_other_charges Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/PaymentTerms | O tempo acordado e as condições sob as quais um pagamento a um fornecedor é feito. Por exemplo, Líquido 30 . Campo de destino: u_payment_terms Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/RemitAddress | O endereço para o qual o pagamento é feito. Campo de destino: u_remit_address |
| RemitTo City | A cidade para a qual o pagamento será feito. Campo de destino: u_remit_to_city |
| /Invoice/RemitToCountry | O país para o qual o pagamento é feito no formato ISO 3166. Por exemplo, EUA . Campo de destino: u_remit_to_country |
| /Invoice/RemitToStateOrProvince | O estado ou província para o qual o pagamento é feito. Campo de destino: u_remit_to_state_or_province |
| /Invoice/RemitToZipOrPostalCode | O CEP ou código postal para o qual o pagamento é feito. Campo de destino: u_remit_to_zip_or_postal_code |
| /Invoice/ShipFromCity | Cidade da qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_city Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/ShipFromCountry | País do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_country Tabela relacionada: Linha de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/ShipFromStateOrProvince | Estado do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_state_or_province Tabela relacionada: Linha de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/ShipFromStreet | Rua da qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_street Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/ShipFromZipOrPostalCode | CEP do qual os itens na ordem de compra são enviados. Campo de destino: u_ship_from_zip_or_postal_code Tabela relacionada: Linha de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/ShippingAmount | Custo total de envio para toda a compra. Campo de destino: u_shipping_amount Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Fatura/subtotal | Valor total a ser pago ao fornecedor, excluindo impostos e despesas de envio. Campo de destino: u_subtotal Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Fatura/fornecedor | Identificador do revendedor ou fornecedor com o qual o cliente pode fazer pedidos. Campo de destino: u_supplier Tabela relacionada: Importação de fatura [sn_spend_intg_imp_invoice] |
| /Invoice/SupportingAttachments | Lista de anexos definidos no nível de caso de processamento de fatura para casos atribuídos a Especialistas em contas a pagar. Consulte Invoice processing case form. Uma vez criado, o sistema gerará o registro da fatura junto com o caso de fatura associado e as linhas de fatura. Os anexos serão vinculados aos respectivos registros de acordo. |
| /Invoice/SupportingAttachments/Attachment/ | Contém os detalhes de um único anexo. |
| /Invoice/SupportingAttachments/Attachment/Content | Conteúdo do arquivo codificado em base64 do anexo. |
| /Invoice/SupportingAttachments/Attachment/Encoding | Este valor é sempre base64 . |
| /Invoice/SupportingAttachments/Attachment/Filename | Nome do arquivo do anexo. Nota: Não use o prefixo reservado "sd_" para um nome de arquivo de anexo. |
| /Invoice/SupportingAttachments/Attachment/MimeCode | Este valor é sempre base64 . |
| Invoice/InvoiceCopy Attachment/ | Lista de anexos definidos no nível da fatura. Consulte Accounts Payable Invoice Processing. Uma vez criado, o sistema gerará o registro da fatura junto com o caso de fatura associado e as linhas de fatura. Os anexos serão vinculados aos respectivos registros de acordo. |
| Invoice/InvoiceCopy Attachment/Attachment/ | Contém os detalhes de um único anexo. |
| Invoice/InvoiceCopy Attachment/Attachment/Content | Conteúdo do arquivo codificado em base64 do anexo. |
| Invoice/InvoiceCopy Attachment/Attachment/Encoding | Este valor é sempre base64 . |
| Invoice/InvoiceCopyAttachment/Attachment/Filename | Nome do arquivo do anexo. Nota: Não use o prefixo reservado "sd_" para um nome de arquivo de anexo. |
| Invoice/InvoiceCopy Attachment/Attachment/MimeCode | Este valor é sempre base64 . |
| Invoice/FatuceLines/ | Lista de elementos de linha de fatura que definem as linhas que estão sendo faturadas para compras neste pedido. |
| Linha de fatura/ | Definição da linha da fatura. As linhas de fatura são preparadas na tabela de entrada de importação de linha de fatura [sn_spend_intg_imp_invoice_line]. |
| InvoiceLine/Attachment/ | Contém os detalhes de um único anexo. |
| InvoiceLine/Attachment/Content | Conteúdo do arquivo codificado em base64 do anexo. |
| InvoiceLine/Attachment/Encoding | Este valor é sempre base64 . |
| InvoiceLine/Attachment/Filename | Nome do arquivo do anexo. Nota: Não use o prefixo reservado "sd_" para um nome de arquivo de anexo. |
| InvoiceLine/Attachment/MimeCode | Este valor é sempre base64 . |
| /InvoiceLine/Centro de custos | Número da conta do centro de custos para o qual a fatura é gerada. Listado na tabela Centro de custos [cmn_cost_center]. Campo de destino: u_cost_center |
| Linha de fatura/Moeda | Moeda do item de linha. Por exemplo, USD . Campo de destino: u_currency Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| InvoiceLine/GLAccount | Número da conta do razão geral (GL) usado para gerar a fatura. Campo de destino: u_gl_account Consulte também: |
| InvoiceLine/LineAmountFatured | Custo total, excluindo impostos e envio, que um cliente está sendo faturado para uma determinada linha de ordem de compra. Campo de destino: u_line_amount_faturado Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| InvoiceLine/LineDescription | Descrição da linha da fatura. Campo de destino: u_line_description |
| InvoiceLine/LineQuantity | Quantidade de bens ou serviços pelos quais um cliente está sendo faturado. Campo de destino: u_line_quantity |
| InvoiceLine/LineUnitPrice | Preço unitário do item de linha na fatura. Campo de destino: u_line_unit_price Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/POLineDescription | Descrição da linha da ordem de compra da fatura. Campo de destino: u_po_line_description Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/PurchaseOrderLine | Número da ordem de compra fornecido pelo cliente para esta ordem. Listado na tabela Ordem de compra [sn_shop_purchase_order]. Campo de destino: u_purchase_order Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| InvoiceLine/ShipToCity | Cidade para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_city Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| InvoiceLine/ShipToCountry | País para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_country Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| InvoiceLine/ShipToStateOrProvince | Estado ou província para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_state_or_province |
| InvoiceLine/ShipToStreet | Rua para a qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_street Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToZipOrPostalCode | CEP para o qual os itens na ordem de compra são enviados. Campo de destino: u_ship_to_zip_or_postal_code Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| Linha de faturamento/Subtotal | Valor total a ser pago ao fornecedor, excluindo impostos e despesas de envio. Campo de destino: u_subtotal Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/SupplierPartNumber | Número de peça gerado por um fornecedor para esta linha de fatura. Campo de destino: u_supplier_part_number Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/taxcode | Código de imposto exclusivo gerado a partir da origem do ERP. Campo de destino: u_tax_code Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| Linha de fatura/UOM | Unidade de medida (UOM) base usada para contar o item na fatura. Campo de destino: u_uom Tabela relacionada: Importação de linha de fatura [sn_spend_intg_imp_invoice_line] |
| /TaxDetait/TaxType | Tipo de imposto aplicável na fatura. Listado na tabela Tipo de imposto [sn_fin_tax_type]. Campo de destino: u_tax_type Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] |
| /TaxDetait/Taxrate | A alíquota de imposto cobrada pelo fornecedor. Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] Campo de destino: u_supplier_tax_rate Tabela relacionada: Importação da linha de imposto da fatura [sn_spend_intg_imp_invoice_tax_line] |
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. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .
| Cabeçalho | Descrição |
|---|---|
| Tipo de conteúdo | Formato de dados do corpo da solicitação. Oferece suporte somente a application/xml. |
| Source-System | Especifica o sistema de origem do qual a solicitação vem. Os sistemas disponíveis são listados na tabela Credenciais dos sistemas de origem [sn_spend_intg_source_system_credential]. Esta configuração ajuda a determinar se a solicitação fornecida segue a estrutura na tabela Mapeamento de campo de integração de fatura [sn_sp_intg_invoice_intg_field_mapping]. Esta configuração também é usada para buscar credenciais da tabela Credenciais do sistema de origem [sn_sp_intg_source_system_credential]. |
| Cabeçalho | Descrição |
|---|---|
| Nenhum(a) |
Códigos de status
Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .
| Código do status | Descrição |
|---|---|
| 202 | Solicitação aceita. A solicitação foi bem-sucedida e o processamento da fatura está em andamento. |
| 400 | Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada. |
| 429 | Excesso de solicitações. A taxa de solicitação excedeu o máximo de 10 solicitações por hora. |
Parâmetros do corpo da resposta
| Nome | Descrição |
|---|---|
| batch_id | Identificador exclusivo da solicitação em lote. Este ID pode ser usado para rastrear o status da solicitação. Este registro é armazenado na tabela Log de integração de fatura [sn_spend_intg_invoice_integration_log]. Tipo de dados: Cadeia de caracteres |
| erro | Contém mensagem de erro e detalhes quando a solicitação falha.Tipo de dados: Objeto |
| error.detail | Detalhes adicionais sobre o erro de solicitação. Possíveis resultados:
Tipo de dados: Cadeia de caracteres |
| mensagem.erro | Mensagem de erro que contém o motivo da falha na solicitação Possíveis erros:
Tipo de dados: Cadeia de caracteres |
| mensagem | Mensagem de sucesso, por exemplo, Sua solicitação foi recebida com sucesso e está sendo processada . Você pode exibir o status da solicitação na tabela Log de integração de fatura [sn_sp_intg_invoice_integration_log]. Tipo de dados: Cadeia de caracteres |
| status | Indica o resultado da solicitação. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
Solicitação de curl
O exemplo a seguir mostra como processar uma fatura fornecida como uma solicitação no formato XML. A codificação base64 varia em tamanho e pode ser muito grande. O valor do conteúdo foi truncado para economizar espaço. As informações refletem a estrutura de carga adequada.
curl -X POST https://instance.servicenow.com/api/sn_spend_intg/v1/ap_invoice/xml \
-H "Source-System: Ariba" \
-H "Content-Type: application/json" \
-d '<Invoices>
<Invoice>
<InvoiceType>po_invoice</InvoiceType>
<SupplierInvoiceNumber>S-AttachmentInvoice-A1-SupportDoc1</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#00A1</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder>###0004889698</PurchaseOrder>
<BusinessOwner>paula.smith@example.com</BusinessOwner>
<DateFormat>DD-MMM-YY</DateFormat>
<InvoiceDate>16-DEC-24</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100.00</Subtotal>
<ShippingAmount>20.00</ShippingAmount>
<OtherCharges>20</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>150.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<TaxDetails>
<TaxDetail>
<TaxType>Sales tax</TaxType>
<TaxAmount>10</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>CGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>11</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate>12</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>13</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
<SupportingAttachments>
<Attachment>
<FileName>InvoiceCaseSupportingDoc.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>InvoiceImageA1.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</SupportingAttachments>
<InvoiceCopyAttachment>
<Attachment>
<FileName>InvoiceA1.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>InvoiceImageA1.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</InvoiceCopyAttachment>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#00A1</ExternalInvoiceNumber>
<LineDescription>Invoice_Line_Attach_A1</LineDescription>
<PurchaseOrderLine>POL11232</PurchaseOrderLine>
<POLineDescription>NowX Charger</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00001</CostCenter>
<GLAccount>100005</GLAccount>
<TaxCode>A1 - Sales tax, reduced rate</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<Attachments>
<Attachment>
<FileName>InvoiceLineA1.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMT/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</Attachments>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#00A</ExternalInvoiceNumber>
<LineDescription>InvoiceLine_PDF_Attach_A1</LineDescription>
<PurchaseOrderLine>00048896981</PurchaseOrderLine>
<POLineDescription></POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>120050</GLAccount>
<TaxCode>A1 - Sales tax, reduced rate</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<Attachments>
<Attachment>
<FileName>Invoice_line_A1.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBER/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>InvoiceImageA1.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</Attachments>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType>non_po_invoice</InvoiceType>
<SupplierInvoiceNumber>10MultiAttach_Inv_invline_A2-MultiSupp</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#00A2</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<BusinessOwner>paula.smith@example.com</BusinessOwner>
<DateFormat>DD-MMM-YYYY</DateFormat>
<InvoiceDate>10-Nov-2024</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>1100</LegalEntity>
<Subtotal>120.00</Subtotal>
<ShippingAmount>10.00</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>150.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<TaxDetails>
<TaxDetail>
<TaxType>Value added tax</TaxType>
<TaxAmount>8</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>7</TaxRate>
</TaxDetail>
</TaxDetails>
<SupportingAttachments>
<Attachment>
<FileName>10InvoiceCaseTestInv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCasePNGInv_Xml_A2.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvceCaseTst2Inv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseTestXMLINV_Xml_A2.xml</FileName>
<MimeCode>text/xml</MimeCode>
<Encoding>base64</Encoding>
<Content>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kY/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseTestExcelINV_Xml_A2.xlsx</FileName>
<MimeCode>application/vnd.ms-excel</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseTestdocINV_Xml_A2.docx</FileName>
<MimeCode>application/vnd.openxmlformats-officedocument.wordprocessingml.document</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCasePPT_Xml_A2.pptx</FileName>
<MimeCode>application/vnd.ms-powerpoint</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseRichText_Xml_A2.rtf</FileName>
<MimeCode>application/rtf</MimeCode>
<Encoding>base64</Encoding>
<Content>e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2Nv/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceCaseImageJpeg_XML_A2.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</SupportingAttachments>
<InvoiceCopyAttachment>
<Attachment>
<FileName>10InvoiceTestInv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoicePNGInv_Xml_A2.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMTmlDQ1BJQ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvceTst2Inv_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBERiBQcmVzZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestXMLINV_Xml_A2.xml</FileName>
<MimeCode>text/xml</MimeCode>
<Encoding>base64</Encoding>
<Content>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kY/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestExcelINV_Xml_A2.xlsx</FileName>
<MimeCode>application/vnd.ms-excel</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestCSVINV_Xml_A2.csv</FileName>
<MimeCode>text/csv</MimeCode>
<Encoding>base64</Encoding>
<Content>Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic3VwcGxp/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestJsonINV_Xml_A2.json</FileName>
<MimeCode>application/json</MimeCode>
<Encoding>base64</Encoding>
<Content>eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lbnQiOiJmY/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestdocINV_Xml_A2.docx</FileName>
<MimeCode>application/vnd.openxmlformats-officedocument.wordprocessingml.document</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoicePPT_Xml_A2.pptx</FileName>
<MimeCode>application/vnd.ms-powerpoint</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlbnRfVHlwZ/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceRichText_Xml_A2.rtf</FileName>
<MimeCode>application/rtf</MimeCode>
<Encoding>base64</Encoding>
<Content>e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyClxjb2Nv/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceImageJpeg_XML_A2.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPCggKDxINC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</InvoiceCopyAttachment>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#00A2</ExternalInvoiceNumber>
<LineDescription>Apple_MultiAttach_A2</LineDescription>
<PurchaseOrderLine>48896981</PurchaseOrderLine>
<POLineDescription>Keyboards</POLineDescription>
<LineQuantity>12</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>(200.00)</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141100</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>2</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>3</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount>5</TaxAmount>
<TaxRate>4</TaxRate>
</TaxDetail>
</TaxDetails>
<Attachments>
<Attachment>
<FileName>10InvoiceTestInvLine_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBER/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvcPNGInvLine_Xml_A2.png</FileName>
<MimeCode>image/png</MimeCode>
<Encoding>base64</Encoding>
<Content>iVBORw0KGgoAAAANSUhEUgAAA0YAAALUCAYAAAAv/SLkAAAMT/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvTst2InvLine_Xml_A2.pdf</FileName>
<MimeCode>application/pdf</MimeCode>
<Encoding>base64</Encoding>
<Content>JVBERi0xLjQKJaqrrK0KMSAwIG9iago8PAovVGl0bGUgKFBER/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestXMLINVLine_Xml_A2.xml</FileName>
<MimeCode>text/xml</MimeCode>
<Encoding>base64</Encoding>
<Content>PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIH/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestExcelINVLine_Xml_A2.xlsx</FileName>
<MimeCode>application/vnd.ms-excel</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQCpD2g4fwEAAAIFAAATAAgCW0NvbnRlbn/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestCSVINVLine_Xml_A2.csv</FileName>
<MimeCode>text/csv</MimeCode>
<Encoding>base64</Encoding>
<Content>Im51bWJlciIsInN1cHBsaWVyX2ludm9pY2VfbnVtYmVyIiwic/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestJsonINVLine_Xml_A2.json</FileName>
<MimeCode>application/json</MimeCode>
<Encoding>base64</Encoding>
<Content>eyJyZWNvcmRzIjpbeyJyZXF1aXJlc19hY2tub3dsZWRnZW1lb/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceTestdocINVLine_Xml_A2.docx</FileName>
<MimeCode>application/vnd.openxmlformats-officedocument.wordprocessingml.document</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQDnIQddcAEAANcFAAATAAgCW0NvbnRlb/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceLinePPT_Xml_A2.pptx</FileName>
<MimeCode>application/vnd.ms-powerpoint</MimeCode>
<Encoding>base64</Encoding>
<Content>UEsDBBQABgAIAAAAIQAPBpW0tQEAAHgMAAATAAgCW0NvbnRlb/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvoiceLineRichText_Xml_A2.rtf</FileName>
<MimeCode>application/rtf</MimeCode>
<Encoding>base64</Encoding>
<Content>e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcY29jb2FydGYyODIyC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
<Attachment>
<FileName>10InvcImageJPG_InvcLine_Xml_A2.jpg</FileName>
<MimeCode>image/jpeg</MimeCode>
<Encoding>base64</Encoding>
<Content>/9j/4AAQSkZJRgABAQEA8ADwAAD/2wCEAAoHBwcIBwoICAoPC/Base64EncodingIntentionallyTruncated=</Content>
</Attachment>
</Attachments>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-#002</ExternalInvoiceNumber>
<LineDescription>Negative Tax</LineDescription>
<PurchaseOrderLine>48896981</PurchaseOrderLine>
<POLineDescription>Keyboards</POLineDescription>
<LineQuantity>12</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00001</CostCenter>
<GLAccount>100001</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>Value added tax</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>6</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>16</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType></InvoiceType>
<SupplierInvoiceNumber>Both taxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#008</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<OriginalInvoice></OriginalInvoice>
<PurchaseOrder>###0004889698</PurchaseOrder>
<BusinessOwner>paula.smith@example.com</BusinessOwner>
<DateFormat>DD MMMM, YY</DateFormat>
<InvoiceDate>5 June, 24</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>1100</LegalEntity>
<Subtotal>100.00</Subtotal>
<ShippingAmount>10.00</ShippingAmount>
<OtherCharges>10-</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>130.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>21</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>IGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>23</TaxRate>
</TaxDetail>
</TaxDetails>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine>#ABC00048896981</PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>-200.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>100001</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType>credit_memo</InvoiceType>
<SupplierInvoiceNumber>no taxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#009</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<OriginalInvoice>Both taxes</OriginalInvoice>
<PurchaseOrder></PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<DateFormat></DateFormat>
<InvoiceDate>2024-06-03</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100.00</Subtotal>
<ShippingAmount>10.00</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>130.00</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine>#ABC00048896981</PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00-</LineUnitPrice>
<Subtotal>100.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141200</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine>#ABC00048896981</PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>10.00</LineUnitPrice>
<Subtotal>100.00</Subtotal>
<LineAmountInvoiced>100</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00001</CostCenter>
<GLAccount>100002</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType></InvoiceType>
<SupplierInvoiceNumber>LineLevelTaxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#0010</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder></PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<DateFormat>MMM DD, YYYY</DateFormat>
<InvoiceDate>Aug 3, 2024</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100</Subtotal>
<ShippingAmount>10</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>10</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121$%ad</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine></PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>20</LineUnitPrice>
<Subtotal>-200¥</Subtotal>
<LineAmountInvoiced>200$</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141300</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001ACD@</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>CGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>15</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>13</TaxAmount>
<TaxRate>13</TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType></InvoiceType>
<SupplierInvoiceNumber>LineLevelTaxes</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-#0010</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder></PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<DateFormat>MMMM DD, YYYY</DateFormat>
<InvoiceDate>september 1st, 2024</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<LegalEntity>US</LegalEntity>
<Subtotal>100</Subtotal>
<ShippingAmount>10</ShippingAmount>
<OtherCharges>10</OtherCharges>
<Discounts>10</Discounts>
<AmountInvoiced>10</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>1</InvoiceLineCount>
<ShipToCity>Los Angeles</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>CA</ShipToStateOrProvince>
<ShipToStreet>456 Oak Ave</ShipToStreet>
<ShipToZipOrPostalCode>90001</ShipToZipOrPostalCode>
<ShipFromCity>Addison</ShipFromCity>
<ShipFromCountry>USA</ShipFromCountry>
<ShipFromStateOrProvince>TX</ShipFromStateOrProvince>
<ShipFromStreet>15725 Dallas P</ShipFromStreet>
<ShipFromZipOrPostalCode>55555</ShipFromZipOrPostalCode>
<RemitAddress>47 W 11th St</RemitAddress>
<RemitToCity>New York</RemitToCity>
<RemitToCountry>USA</RemitToCountry>
<RemitToStateOrProvince>NY</RemitToStateOrProvince>
<RemitToZipOrPostalCode>99999</RemitToZipOrPostalCode>
<BillToStreet>4810 Eastgate Mall</BillToStreet>
<BillToCity>San Diego</BillToCity>
<BillToCountry>USA</BillToCountry>
<BillToStateOrProvince>CA</BillToStateOrProvince>
<BillToZipOrPostalCode>92121$%ad</BillToZipOrPostalCode>
<SupplierTaxID>7894328742</SupplierTaxID>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-008</ExternalInvoiceNumber>
<LineDescription>Apple macbook 15 Pro</LineDescription>
<PurchaseOrderLine></PurchaseOrderLine>
<POLineDescription>NowX Laptop</POLineDescription>
<LineQuantity>10</LineQuantity>
<LineUnitPrice>20</LineUnitPrice>
<Subtotal>-200¥</Subtotal>
<LineAmountInvoiced>200$</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter>ACN00005</CostCenter>
<GLAccount>141300</GLAccount>
<TaxCode>A0 Sales Tax</TaxCode>
<ShipToCity>New York</ShipToCity>
<ShipToCountry>USA</ShipToCountry>
<ShipToStateOrProvince>New York</ShipToStateOrProvince>
<ShipToStreet>PA112</ShipToStreet>
<ShipToZipOrPostalCode>1001ACD@</ShipToZipOrPostalCode>
<SupplierPartNumber>SPN1211</SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>12</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>CGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>15</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>Withholding tax</TaxType>
<TaxAmount>13</TaxAmount>
<TaxRate>13</TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<TargetERP>ERP1</TargetERP>
</Invoices>'
O resultado a seguir mostra que a solicitação foi bem-sucedida e que os dados da fatura estão sendo processados. Você pode exibir o status da solicitação na tabela Log de integração de fatura [sn_sp_intg_invoice_integration_log]. Use o ID do lote listado na coluna ID do lote para encontrar a fatura.
{
"batchId": "APIINV1736249646168148",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}