API de facture AP
Permet aux systèmes externes, tels que ceux utilisés par les fournisseurs, de soumettre en toute sécurité des factures directement dans un système de comptes fournisseurs de manière structurée et automatisée.
Cette API nécessite l’application Traitement des factures des comptes fournisseurs (com.sn_ap_apm) store, qui est fournie dans l’espace de noms sn_spend_intg . (pour en savoir plus, consultez Accounts Payable Invoice Processing) ;
- Définissez un champ personnalisé pour les factures, les lignes de facture et les lignes de taxe de facture.
- Mappez le champ personnalisé entre les tables source et cible.
- Mappez le champ personnalisé à une entrée de charge utile dans un format spécifique, tel que JSON, cXML ou XML.
- Définition des informations d’identification pour l’authentification lors de l’utilisation de cXML comme charge utile.
Facture AP – POST sn_spend_intg/ap_invoice/cxml
Traite une facture automatisée au format XML commercial (cXML).
Utilisez la table Mappages de champs d’intégration de facture [sn_spend_intg_invoice_intg_field_mapping] pour déterminer comment les champs sont mappés aux balises cXML.
Pour plus de ressources cXML, reportez-vous au Guide de référence cXML au https://xml.cxml.org.
Les informations d’identification de cette API sont incluses dans la charge utile. Vous pouvez configurer les informations d’identification dans la table Informations d’identification du système source [sn_spend_intg_source_system_credential]. Pour obtenir des instructions, consultez Définition des informations d’identification pour l’authentification dans la charge utile cXML.
Format d'URL
URL versionnée : /api/sn_spend_intg/v1/ap_invoice/cxml
URL par défaut : /api/sn_spend_intg/ap_invoice/cxml
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| Nom | Description |
|---|---|
| Néant |
| Chemin d'accès | Description |
|---|---|
| /cXML/en-tête/à partir de /credential[@domain='VendorID']/identity | Identificateur du revendeur ou du fournisseur auprès duquel le client peut passer des commandes. Champ cible : u_supplier Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceDate] | Date à laquelle le client a été facturé. Champ cible : u_invoice_date Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Format : AAAA-MM-JJ |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceID] | Numéro de facture généré à partir d’une application tierce. Champ cible : u_external_invoice_number Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader[@invoiceOrigin] | Système source externe à partir duquel la facture est reçue. Par exemple, fournisseur. Champ cible : u_inbound_source Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/City | Ville à laquelle la facture est envoyée. Champ cible : u_bill_to_city Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/Country | Pays auquel la facture est envoyée au format ISO 3166. Par exemple, États-Unis.Champ cible : u_bill_to_country Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/State | État ou province à laquelle la facture est envoyée. Champ cible : u_bill_to_state_or_province Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/Street | Adresse postale à laquelle la facture est envoyée. Champ cible : u_bill_to_street Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/InvoicePartner /Contact[@role='billTo']/PostalAddress/PostalCode | Le code postal auquel la facture est envoyée. Champ cible : u_bill_to_zip_or_postal_code |
| Contact[@role="remitTo"]/PostalAddress /Street | Rue à laquelle le paiement est effectué. Champ cible : u_remit_address |
| Contact[@role="remitTo"]/PostalAddress /Ville | Ville à laquelle le paiement est effectué Champ cible : u_remit_to_city |
| Contact[@role="remitTo"]/PostalAddress /State | État ou province auquel le paiement est effectué Champ cible : u_remit_to_state_or_province |
| Contact[@role="remitTo"]/PostalAddress /PostalCode | Le code postal auquel le paiement est effectué. Champ cible : u_remit_to_zip_or_postal_code |
| Contact[@role="remitTo"]/PostalAddress /Pays | Pays auquel le paiement est effectué au format ISO 3166. Par exemple, États-Unis.Champ cible : u_remit_to_country |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /Street | Rue à partir de laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_from_street Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /City | Ville à partir de laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_from_city Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /State | État à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_state_or_province Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /PostalCode | Code postal à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_zip_or_postal_code Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoiceDetailShipping/Contact[@role="shipFrom"]/PostalAddress /Country | Pays à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_country Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailRequestHeader /InvoicePartner/Contact[@role="billTo"] [@addressID] | Nom de l’entité juridique du fournisseur. Situé dans la table Entité juridique [sn_fin_legal_entity]. Champ cible : u_legal_entity Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| Contact[@role="shipTo"]/Nom | Nom du contact vers lequel les articles du bon de commande doivent être expédiés. Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| Contact[@role="shipTo"]/PostalAddress /Street | Rue vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_street Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| Contact[@role="shipTo"]/PostalAddress /Ville | Ville vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_city Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| Contact[@role="shipTo"]/PostalAddress /State | État ou province vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_state_or_province |
| Contact[@role="shipTo"]/PostalAddress /PostalCode | Code postal vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_zip_or_postal_code Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| Contact[@role="shipTo"]/PostalAddress /Country | Pays vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_country Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest /InvoiceDetailRequestHeader/PaymentTerm | Délai et conditions convenus pour le paiement d’un fournisseur Par exemple, Net 30.Champ cible : u_payment_terms Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem[@description]/ | Description de la ligne de facture. Champ cible : u_line_description |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem[@quantity]/ | Quantité de biens ou de services pour lesquels un client est facturé. Champ cible : u_line_quantity |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Distribution/Accounting /AccountingSegment[1]/Name | Numéro de compte du centre de coûts pour lequel la facture est générée. Répertorié dans la table Centre de coûts [cmn_cost_center]. Champ cible : u_cost_center |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Distribution/Accounting /AccountingSegment[2]/Name | Numéro de compte de la comptabilité générale (GL) utilisé pour générer la facture. Champ cible : u_gl_account Voir aussi : |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/SubtotalAmount/Money | Montant total à payer au fournisseur, hors taxes et frais d’expédition. Champ cible : u_subtotal Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/NetAmount/Money | Coût total, hors taxes et coûts d'expédition, facturé à un client pour une ligne de bon de commande donnée. Champ cible : u_line_amount_invoiced Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailOrderInfo/OrderReference | Numéro de bon de commande fourni par le client pour cette commande. Répertorié dans la table Bon de commande [sn_shop_purchase_order]. Champ cible : u_purchase_order Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/UnitPrice/UnitOfMeasure | Unité de mesure de base (UdM) utilisée pour compter l’élément dans la facture Champ cible : u_uom Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/UnitPrice/Money | Prix unitaire de l'élément de la ligne dans la facture Champ cible : u_line_unit_price Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/UnitPrice/Money[@currency] | Devise de l’élément de ligne. Par exemple, USD.Champ cible : u_currency Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem /InvoiceDetailItemReference[@lineNumber] | ID de ligne de bon de commande pour le fournisseur référencé. Répertorié dans la table Ligne de bon de commande [sn_shop_purchase_order_line]. Champ cible : u_purchase_order_line Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/InvoiceDetailItemReference /ItemID/SupplierPartID | Numéro de pièce généré par un fournisseur pour cette ligne de facture. Champ cible : u_supplier_part_number Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/InvoiceDetailItemReference /Description | Description de la ligne de bon de commande de la facture. Champ cible : u_po_line_description Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Tax/Money | Montant total des taxes facturées pour l'achat. Champ cible : u_tax_amount Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| cXML/Request/InvoiceDetailRequest/InvoiceDetailOrder /InvoiceDetailItem/Tax/Description | Code fiscal unique généré à partir de la source ERP. Champ cible : u_tax_code Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /cXML/Request/InvoiceDetailRequest/ InvoiceDetailSummary /SubtotalAmount/Money | Montant total à payer au fournisseur, hors taxes et frais d’expédition. Champ cible : u_subtotal Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /Tax/Money | Montant total des taxes facturées pour l'achat. Champ cible : u_tax_amount Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /Tax/TaxDetail[@category] | Type de taxe applicable sur la facture. Répertorié dans la table Type de taxe [sn_fin_tax_type]. Champ cible : u_tax_type Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /Tax/TaxDetail[@percentageRate] | Taux fiscal facturé par le fournisseur Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] Champ cible : u_supplier_tax_rate Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /SpecialHandlingAmount/Money | Autres frais supplémentaires associés à la facture. Ce champ est modifiable. Champ cible : u_other_charges Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /ShippingAmount/Money | Coût total d'expédition pour l'ensemble de l'achat. Champ cible : u_shipping_amount Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /GrossAmount/Money | Obligatoire. Devise du sous-total, des taxes et des coûts d'expédition. Le sous-total, les taxes et les coûts d'expédition doivent être exprimés dans la même devise. Champ cible : u_currency Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /InvoiceDetailDiscount/Money | Remises appliquées à la facture. Champ cible : u_discounts Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /cXML/Request/InvoiceDetailRequest/InvoiceDetailSummary /NetAmount/Money | Montant total à payer au fournisseur, y compris les taxes et les frais d’expédition. Champ cible : u_amount_invoiced Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
En-têtes
Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Type de contenu | Format de données du corps de la demande. Prend uniquement en charge application/xml. |
| Système source | Spécifie le système source d’où provient la demande. Les systèmes disponibles sont répertoriés dans la table Informations d’identification du système source [sn_spend_intg_source_system_credential]. Ce paramètre permet de déterminer si la demande fournie suit la structure de la table Mappage de champ d’intégration de facture [sn_spend_intg_invoice_intg_field_mapping]. Ce paramètre est également utilisé pour extraire les informations d’identification de la table Informations d’identification du système source [sn_spend_intg_source_system_credential]. |
| En-tête | Description |
|---|---|
| Aucun |
Codes d'état
Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 202 | Demande acceptée. La demande a abouti et le traitement des factures est en cours. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
| 429 | Trop de demandes. Le taux de demandes a dépassé le maximum de 10 demandes par heure. |
Paramètres du corps de réponse
| Nom | Description |
|---|---|
| batch_id | Identificateur unique de la demande par lots. Cet ID peut être utilisé pour suivre l’état de la demande. Cet enregistrement est stocké dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Type de données : chaîne |
| erreur | Contient un message d’erreur et des détails lorsque la demande échoue.Type de données : objet |
| erreur.détail | Détails supplémentaires sur l’erreur de demande. Résultats possibles :
Type de données : chaîne |
| message.erreur | Message d’erreur indiquant le motif de l’échec de la demande Erreurs possibles :
Type de données : chaîne |
| message | Message de réussite, par exemple, Votre demande a été reçue avec succès et est en cours de traitement. Vous pouvez consulter l’état de la demande dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Type de données : chaîne |
| statut | Indique le résultat de la demande. Valeurs possibles :
Type de données : chaîne |
Demande cURL
L’exemple suivant montre comment traiter une facture fournie en tant que requête au format 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--"
}'
Le résultat suivant montre que la demande a abouti et que les données de la facture sont en cours de traitement. Vous pouvez consulter l’état de la demande dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Utilisez l’ID de lot répertorié dans la colonne ID de lot pour trouver la facture.
{
"batchId": "APIINV1729711710733280",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}Facture AP – PUBLIER sn_spend_intg/ap_invoice/JSON
Traite une facture automatisée au format JSON.
Rôle requis : sn_spend_intg.procurement_integrator
Utilisez la table Mappages de champs d’intégration de facture [sn_spend_intg_invoice_intg_field_mapping] pour déterminer comment les champs sont mappés aux propriétés JSON.
Format d'URL
URL versionnée : /api/sn_spend_intg/v1/ap_invoice/json
URL par défaut : /api/sn_spend_intg/ap_invoice/json
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| Nom | Description |
|---|---|
| Néant |
| Nom | Description |
|---|---|
| factures | Liste contenant chaque facture à traiter. Type de données : objet des objets de facture imbriqués. |
| invoices.amount_invoiced | Montant total à payer au fournisseur, y compris les taxes et les frais d’expédition. Champ cible : u_amount_invoiced Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| bill_to_city | Ville à laquelle la facture est envoyée. Champ cible : u_bill_to_city Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| bill_to_country | Pays auquel la facture est envoyée au format ISO 3166. Par exemple, États-Unis.Champ cible : u_bill_to_country Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| bill_to_state_or_province | État ou province à laquelle la facture est envoyée. Champ cible : u_bill_to_state_or_province Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| bill_to_street | Adresse postale à laquelle la facture est envoyée. Champ cible : u_bill_to_street Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| bill_to_zip_or_postal_code | Le code postal auquel la facture est envoyée. Champ cible : u_bill_to_zip_or_postal_code |
| invoices.business_owner | Nom du propriétaire qui possède l’application du côté de l’entreprise. Champ cible : u_business_owner Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| factures.devise | Obligatoire. Devise du sous-total, des taxes et des coûts d'expédition. Le sous-total, les taxes et les coûts d'expédition doivent être exprimés dans la même devise. Champ cible : u_currency Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| factures.remises | Remises appliquées à la facture. Champ cible : u_discounts Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.erp_number | Numéro unique généré dans le système ERP (progiciel de gestion intégré) pour le bon de commande. (pour en savoir plus, consultez Purchase order integration) ; Champ cible : u_erp_number Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| Factures. external_invoice_number | Requis. Numéro de facture généré à partir d’une application tierce. Champ cible : u_external_invoice_number Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_date | Requis. Date à laquelle le client a été facturé. Champ cible : u_invoice_date Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 Format : AAAA-MM-JJ |
| invoices.invoice_line_count | Nombre de lignes dans la facture Champ cible : u_invoice_line_count Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines | Liste d'objets qui définissent les lignes facturées pour les achats dans cette commande. Les lignes de facture sont regroupées dans la table Importation de ligne de facture entrante [sn_spend_intg_imp_invoice_line]. Type de données : tableau |
| invoices.invoice_lines. cost_center | Numéro de compte du centre de coûts pour lequel la facture est générée. Répertorié dans la table Centre de coûts [cmn_cost_center]. Champ cible : u_cost_center Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. monnaie | Devise de l’élément de ligne. Par exemple, USD.Champ cible : u_currency Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. external_invoice_number | Requis. Numéro de facture généré à partir d’une application tierce. Champ cible : u_external_invoice_number Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. gl_account | Numéro de compte de la comptabilité générale (GL) utilisé pour générer la facture. Champ cible : u_gl_account Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 Voir aussi : |
| invoices.invoice_lines. line_amount_invoiced | Requis. Coût total, hors taxes et coûts d'expédition, facturé à un client pour une ligne de bon de commande donnée. Champ cible : u_line_amount_invoiced Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. line_description | Requis. Description de la ligne de facture. Champ cible : u_line_description Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. line_quantity | Requis. Quantité de biens ou de services pour lesquels un client est facturé. Champ cible : u_line_quantity Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. line_unit_price | Prix unitaire de l'élément de la ligne dans la facture Champ cible : u_line_unit_price Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. po_line_description | Description de la ligne de bon de commande de la facture. Champ cible : u_po_line_description Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. purchase_order_line | Requis. ID de ligne de bon de commande pour le fournisseur référencé. Répertorié dans la table Ligne de bon de commande [sn_shop_purchase_order_line]. Champ cible : u_purchase_order_line Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. ship_to_city | Ville vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_city Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. ship_to_country | Pays vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_country Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. ship_to_state_or_province | État ou province vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_state_or_province Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. ship_to_street | Rue vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_street Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. ship_to_zip_or_postal_code | Code postal vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_zip_or_postal_code Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. sous-total | Requis. Montant total à payer au fournisseur, hors taxes et frais d’expédition. Champ cible : u_subtotal Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. supplier_part_number | Requis. Numéro de pièce généré par un fournisseur pour cette ligne de facture. Champ cible : u_supplier_part_number Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. tax_code | Code fiscal unique généré à partir de la source ERP. Champ cible : u_tax_code Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. tax_details | Liste des lignes de taxe pour les achats associés à la ligne de facture. Type de données : tableau d’objets |
| invoices.invoice_lines. tax_details.montant_fiscal | Requis. Montant total des taxes facturées pour l'achat. Champ cible : u_tax_amount Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] Type de données : chaîne Longueur maximale : 40 |
| invoices.invoice_lines. tax_details.tax_rate | Taux fiscal facturé par le fournisseur Champ cible : u_supplier_tax_rate Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines. tax_details.type_taxe | Type de taxe applicable sur la facture. Répertorié dans la table Type de taxe [sn_fin_tax_type]. Champ cible : u_tax_type Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_lines.uom | Unité de mesure de base (UdM) utilisée pour compter l’élément dans la facture Champ cible : u_uom Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.invoice_type | Type de facture pour le traitement. Champ cible : u_invoice_type Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.legal_entity | Nom de l’entité juridique du fournisseur. Situé dans la table Entité juridique [sn_fin_legal_entity]. Champ cible : u_legal_entity Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.original_invoice | Numéro de facture unique créé par le fournisseur. Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Champ cible : u_original_invoice Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.other_charges | Autres frais supplémentaires associés à la facture. Ce champ est modifiable. Champ cible : u_other_charges Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.payment_terms | Délai et conditions convenus pour le paiement d’un fournisseur Par exemple, Net 30.Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.purchase_order | Requis. Numéro de bon de commande fourni par le client pour cette commande. Répertorié dans la table Bon de commande [sn_shop_purchase_order]. Champ cible : u_purchase_order Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| invoices.remit_address | Requis. Rue à laquelle le paiement est effectué. Champ cible : u_remit_address Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.remit_to_city | Requis. Ville à laquelle le paiement est effectué Champ cible : u_remit_to_city Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.remit_to_country | Requis. Pays auquel le paiement est effectué au format ISO 3166. Par exemple, États-Unis.Champ cible : u_remit_to_country Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| Factures. remit_to_state_or_province | Requis. État ou province auquel le paiement est effectué Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| Factures. remit_to_zip_or_postal_code | Requis. Le code postal auquel le paiement est effectué. Champ cible : u_remit_to_state_or_province Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.ship_from_city | Ville à partir de laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_from_city Type de données : chaîne Longueur maximale : 100 |
| invoices.ship_from_country | Pays à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_country Type de données : chaîne Longueur maximale : 100 |
| Factures. ship_from_state_or_province | État à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_state_or_province Type de données : chaîne Longueur maximale : 100 |
| invoices.ship_from_street | Rue à partir de laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_from_street Type de données : chaîne Longueur maximale : 100 |
| Factures. ship_from_zip_or_postal_code | Code postal à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_zip_or_postal_code Type de données : chaîne Longueur maximale : 100 |
| invoices.ship_to_city | Ville vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_city Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.ship_to_country | Pays vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_country Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| Factures. ship_to_state_or_province | État vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_state_or_province Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.ship_to_street | Rue vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_street Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| Factures. ship_to_zip_or_postal_code | Code postal vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_zip_or_postal_code Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.shipping_amount | Requis. Coût total d'expédition pour l'ensemble de l'achat. Champ cible : u_shipping_amount Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| factures.sous-total | Requis. Montant total à payer au fournisseur, hors taxes et frais d’expédition. Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 40 |
| Factures.Fournisseur | Requis. Identificateur du revendeur ou du fournisseur auprès duquel le client peut passer des commandes. Champ cible : u_supplier Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| Factures. supplier_invoice_number | Requis. Numéro d'identification généré par un fournisseur pour cette facture. Champ cible : u_supplier_invoice_number Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.supplier_tax_id | Identificateur fiscal associé au revendeur tiers. Ce champ est modifiable. Champ cible : u_supplier_tax_id Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Type de données : chaîne Longueur maximale : 100 |
| invoices.target_erp | Enregistrement ERP dans lequel la facture est publiée. Situé dans la table Source ERP [sn_fin_erp_source]. Consultez ERP source. Type de données : chaîne |
En-têtes
Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Type de contenu | Format de données du corps de la demande. Prend uniquement en charge application/json. |
| Système source | Spécifie le système source d’où provient la demande. Ce paramètre permet de déterminer si la demande fournie suit la structure de la table Mappage de champ d’intégration de facture [sn_spend_intg_invoice_intg_field_mapping]. |
| En-tête | Description |
|---|---|
| Aucun |
Codes d'état
Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 202 | Demande acceptée. La demande a abouti et le traitement des factures est en cours. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
| 429 | Trop de demandes. Le taux de demandes a dépassé le maximum de 10 demandes par heure. |
Paramètres du corps de réponse
| Nom | Description |
|---|---|
| batch_id | Identificateur unique de la demande par lots. Cet ID peut être utilisé pour suivre l’état de la demande. Cet enregistrement est stocké dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Type de données : chaîne |
| erreur | Contient un message d’erreur et des détails lorsque la demande échoue.Type de données : objet |
| erreur.détail | Détails supplémentaires sur l’erreur de demande. Résultats possibles :
Type de données : chaîne |
| message.erreur | Message d’erreur indiquant le motif de l’échec de la demande Erreurs possibles :
Type de données : chaîne |
| message | Message de réussite, par exemple, Votre demande a été reçue avec succès et est en cours de traitement. Vous pouvez consulter l’état de la demande dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Type de données : chaîne |
| statut | Indique le résultat de la demande. Valeurs possibles :
Type de données : chaîne |
Demande cURL
L’exemple suivant montre comment traiter une facture fournie en tant que demande au format JSON.
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": "non_po_invoice",
"supplier_invoice_number": "SPOTLIGHT98",
"external_invoice_number": "SPOTLIGHT98",
"erp_number": "RTest12345",
"purchase_order": "R0030R16537",
"business_owner": "paula.smith@example.com",
"supplier": "3245545",
"original_invoice": "SIN188191",
"invoice_date": "2023-08-15",
"payment_terms": "Net 30",
"legal_entity": "1000",
"subtotal": "100.00",
"shipping_amount": "50.00",
"other_charges": "20.00",
"discounts": "100.00",
"amount_invoiced": "150.00",
"currency": "USD",
"invoice_line_count": "2",
"ship_to_city": "",
"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",
"bill_to_city": "San Diego",
"bill_to_country": "USA",
"bill_to_state_or_province": "CA",
"bill_to_street": "4810 Eastgate Mall",
"bill_to_zip_or_postal_code": "92121",
"supplier_tax_id": "123456789",
"tax_details": [
{
"tax_type": "Central Goods and Services Tax",
"tax_amount": "25",
"tax_rate": ""
},
{
"tax_type": "Sales tax",
"tax_amount": "10",
"tax_rate": "10"
},
{
"tax_type": "IGST",
"tax_amount": "",
"tax_rate": "15"
},
{
"tax_type": "State Goods and Service Tax",
"tax_amount": "20",
"tax_rate": "10"
}
],
"invoice_lines": [
{
"external_invoice_number": "SPOTLIGHT98",
"line_description": "Laptop",
"line_quantity": "5",
"line_unit_price": "20.00",
"subtotal": "100.00",
"line_amount_invoiced": "100.00",
"purchase_order_line": "232432",
"po_line_description": "Mac laptop",
"currency": "USD",
"cost_center": "41605600",
"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": "Central Goods and Services Tax",
"tax_amount": "25",
"tax_rate": ""
},
{
"tax_type": "Sales tax",
"tax_amount": "",
"tax_rate": "10"
}
]
},
{
"external_invoice_number": "SPOTLIGHT98",
"line_description": "Charger",
"line_quantity": "5",
"line_unit_price": "40.00",
"subtotal": "200.00",
"line_amount_invoiced": "200.00",
"purchase_order_line": "232432",
"po_line_description": "Mac laptop",
"currency": "USD",
"cost_center": "41605600",
"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": "Central Goods and Services Tax",
"tax_amount": "25",
"tax_rate": ""
},
{
"tax_type": "Sales tax",
"tax_amount": "",
"tax_rate": "10"
}
]
}
]
}
],
"target_erp": ""
}'Le résultat suivant montre que la demande a abouti et que les données de la facture sont en cours de traitement. Vous pouvez consulter l’état de la demande dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Utilisez l’ID de lot répertorié dans la colonne ID de lot pour trouver la facture.
{
"batchId": "APIINV1729711710733280",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}Facture AP – PUBLIER sn_spend_intg/ap_invoice/xml
Traite une facture automatisée au format XML.
Utilisez la table Mappages de champs d’intégration de facture [sn_spend_intg_invoice_intg_field_mapping] pour déterminer comment les champs sont mappés aux balises XML.
Format d'URL
Version de l’URL : /api/sn_spend_intg/v1/ap_invoice/xml
URL par défaut : /api/sn_spend_intg/ap_invoice/xml
Paramètres de demande pris en charge
| Nom | Description |
|---|---|
| api_version | Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne |
| Nom | Description |
|---|---|
| Néant |
| Chemin d'accès | Description |
|---|---|
| /facture/montantfacturé | Montant total à payer au fournisseur, y compris les taxes et les frais d’expédition. Champ cible : u_amount_invoiced Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| Facture/BillToCity | Ville à laquelle la facture est envoyée. Champ cible : u_bill_to_city Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /facture/BillToCountry | Pays auquel la facture est envoyée au format ISO 3166. Par exemple, États-Unis.Champ cible : u_bill_to_country Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /facture/BillToStateOrProvince | État ou province à laquelle la facture est envoyée. Champ cible : u_bill_to_state_or_province Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Facture/BillToStreet | Adresse postale à laquelle la facture est envoyée. Champ cible : u_bill_to_street Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Facture/BillToZipOrPostalCode | Le code postal auquel la facture est envoyée. Champ cible : u_bill_to_zip_or_postal_code |
| /Facture/Devise | Obligatoire. Devise du sous-total, des taxes et des coûts d'expédition. Le sous-total, les taxes et les coûts d'expédition doivent être exprimés dans la même devise. Champ cible : u_currency Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Facture/Format de date | Définit le format de date de facture du format de date par défaut AAAA-MM-JJ sur un autre format de date pris en charge. La valeur de date est définie dans l’élément InvoiceDate . Formats de date pris en charge :
Remarque : L’entrée du format MMM représente un mois dans ses trois premières lettres, par exemple, Aug. L’entrée de format MMMM représente le nom complet du mois, par exemple, août. Champ cible : u_date_format Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Format par défaut : AAAA-MM-JJ |
| /Facture/Remises | Remises appliquées à la facture. Champ cible : u_discounts Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Invoice/ExternalInvoiceNumber | Numéro de facture généré à partir d’une application tierce. Champ cible : u_external_invoice_number Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Facture/InvoiceDate | Date à laquelle le client a été facturé. Utilisez l’élément DateFormat pour ajouter la date dans un format pris en charge autre que celui par défaut. Champ cible : u_invoice_date Table connexe : Importation de facture [sn_spend_intg_imp_invoice] Format par défaut : AAAA-MM-JJ |
| /Facture/EntitéJuridique | Nom de l’entité juridique du fournisseur. Situé dans la table Entité juridique [sn_fin_legal_entity]. Champ cible : u_legal_entity Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /facture/autres frais | Autres frais supplémentaires associés à la facture. Ce champ est modifiable. Champ cible : u_other_charges Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Facture/Modalités de paiement | Délai et conditions convenus pour le paiement d’un fournisseur Par exemple, Net 30.Champ cible : u_payment_terms Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Adresse/Facture/Remise | Rue à laquelle le paiement est effectué. Champ cible : u_remit_address |
| Facture/RemitToCity | Ville à laquelle le paiement est effectué Champ cible : u_remit_to_city |
| /Facture/RemitToCountry | Pays auquel le paiement est effectué au format ISO 3166. Par exemple, États-Unis.Champ cible : u_remit_to_country |
| /Facture/RemitToStateOrProvince | État ou province auquel le paiement est effectué Champ cible : u_remit_to_state_or_province |
| /Facture/RemitToZipOrPostalCode | Le code postal auquel le paiement est effectué. Champ cible : u_remit_to_zip_or_postal_code |
| /Facture/ShipFromCity | Ville à partir de laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_from_city Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /facture/ShipFromCountry | Pays à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_country Table connexe : Ligne de facture [sn_spend_intg_imp_invoice] |
| /facture/ShipFromStateOrProvince | État à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_state_or_province Table connexe : Ligne de facture [sn_spend_intg_imp_invoice] |
| /Facture/ShipFromStreet | Rue à partir de laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_from_street Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Facture/ExpédierDeZipOuCodePostalCode | Code postal à partir duquel les articles du bon de commande sont expédiés. Champ cible : u_ship_from_zip_or_postal_code Table connexe : Ligne de facture [sn_spend_intg_imp_invoice] |
| /Facture/MontantExpédition | Coût total d'expédition pour l'ensemble de l'achat. Champ cible : u_shipping_amount Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /facture/sous-total | Montant total à payer au fournisseur, hors taxes et frais d’expédition. Champ cible : u_subtotal Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /Facture/Fournisseur | Identificateur du revendeur ou du fournisseur auprès duquel le client peut passer des commandes. Champ cible : u_supplier Table connexe : Importation de facture [sn_spend_intg_imp_invoice] |
| /FactureLigne/Centre de coûts | Numéro de compte du centre de coûts pour lequel la facture est générée. Répertorié dans la table Centre de coûts [cmn_cost_center]. Champ cible : u_cost_center |
| /InvoiceLine/Devise | Devise de l’élément de ligne. Par exemple, USD.Champ cible : u_currency Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/GLAccount | Numéro de compte de la comptabilité générale (GL) utilisé pour générer la facture. Champ cible : u_gl_account Voir aussi : |
| /InvoiceLine/LineAmountInvoiced | Coût total, hors taxes et coûts d'expédition, facturé à un client pour une ligne de bon de commande donnée. Champ cible : u_line_amount_invoiced Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/LineDescription | Description de la ligne de facture. Champ cible : u_line_description |
| /InvoiceLine/LineQuantity | Quantité de biens ou de services pour lesquels un client est facturé. Champ cible : u_line_quantity |
| /FactureLigne/LignePrix unitaire | Prix unitaire de l'élément de la ligne dans la facture Champ cible : u_line_unit_price Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/POLineDescription | Description de la ligne de bon de commande de la facture. Champ cible : u_po_line_description Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/PurchaseOrderLine | Numéro de bon de commande fourni par le client pour cette commande. Répertorié dans la table Bon de commande [sn_shop_purchase_order]. Champ cible : u_purchase_order Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToCity | Ville vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_city Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToCountry | Pays vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_country Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToStateOrProvince | État ou province vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_state_or_province |
| /InvoiceLine/ShipToStreet | Rue vers laquelle les articles du bon de commande sont expédiés. Champ cible : u_ship_to_street Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/ShipToZipOrPostalCode | Code postal vers lequel les articles du bon de commande sont expédiés. Champ cible : u_ship_to_zip_or_postal_code Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /FactureLigne/Sous-total | Montant total à payer au fournisseur, hors taxes et frais d’expédition. Champ cible : u_subtotal Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/SupplierPartNumber | Numéro de pièce généré par un fournisseur pour cette ligne de facture. Champ cible : u_supplier_part_number Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /InvoiceLine/TaxCode | Code fiscal unique généré à partir de la source ERP. Champ cible : u_tax_code Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /Ligne de facture/UOM | Unité de mesure de base (UdM) utilisée pour compter l’élément dans la facture Champ cible : u_uom Table connexe : Importation de ligne de facture [sn_spend_intg_imp_invoice_line] |
| /TaxDetail/TaxType | Type de taxe applicable sur la facture. Répertorié dans la table Type de taxe [sn_fin_tax_type]. Champ cible : u_tax_type Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] |
| /TaxDetail/TaxRate | Taux fiscal facturé par le fournisseur Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] Champ cible : u_supplier_tax_rate Table connexe : Importation de ligne fiscale de facture [sn_spend_intg_imp_invoice_tax_line] |
En-têtes
Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.
| En-tête | Description |
|---|---|
| Type de contenu | Format de données du corps de la demande. Prend uniquement en charge application/xml. |
| Système source | Spécifie le système source d’où provient la demande. Les systèmes disponibles sont répertoriés dans la table Informations d’identification du système source [sn_spend_intg_source_system_credential]. Ce paramètre permet de déterminer si la demande fournie suit la structure de la table Mappage de champ d’intégration de facture [sn_spend_intg_invoice_intg_field_mapping]. Ce paramètre est également utilisé pour extraire les informations d’identification de la table Informations d’identification du système source [sn_spend_intg_source_system_credential]. |
| En-tête | Description |
|---|---|
| Aucun |
Codes d'état
Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.
| Code d'état | Description |
|---|---|
| 202 | Demande acceptée. La demande a abouti et le traitement des factures est en cours. |
| 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. |
| 429 | Trop de demandes. Le taux de demandes a dépassé le maximum de 10 demandes par heure. |
Paramètres du corps de réponse
| Nom | Description |
|---|---|
| batch_id | Identificateur unique de la demande par lots. Cet ID peut être utilisé pour suivre l’état de la demande. Cet enregistrement est stocké dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Type de données : chaîne |
| erreur | Contient un message d’erreur et des détails lorsque la demande échoue.Type de données : objet |
| erreur.détail | Détails supplémentaires sur l’erreur de demande. Résultats possibles :
Type de données : chaîne |
| message.erreur | Message d’erreur indiquant le motif de l’échec de la demande Erreurs possibles :
Type de données : chaîne |
| message | Message de réussite, par exemple, Votre demande a été reçue avec succès et est en cours de traitement. Vous pouvez consulter l’état de la demande dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Type de données : chaîne |
| statut | Indique le résultat de la demande. Valeurs possibles :
Type de données : chaîne |
Demande cURL
L’exemple suivant montre comment traiter une facture fournie en tant que requête au format XML.
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>invoice</InvoiceType>
<SupplierInvoiceNumber>S-432432425</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-003</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder>0004511198</PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<InvoiceDate>2023-09-02</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<OriginalInvoice></OriginalInvoice>
<LegalEntity></LegalEntity>
<Subtotal>23985.00</Subtotal>
<ShippingAmount>750.00</ShippingAmount>
<OtherCharges></OtherCharges>
<Discounts></Discounts>
<AmountInvoiced>27073.54</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>2</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>CGST</TaxType>
<TaxAmount></TaxAmount>
<TaxRate>15</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>SGST</TaxType>
<TaxAmount>100</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
<LineDescription>NowX Laptop</LineDescription>
<PurchaseOrderLine></PurchaseOrderLine>
<LineQuantity>15</LineQuantity>
<LineUnitPrice>1500.00</LineUnitPrice>
<Subtotal>22500.00</Subtotal>
<LineAmountInvoiced>24693.75</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter></CostCenter>
<GLAccount></GLAccount>
<TaxCode></TaxCode>
<ShipToCity></ShipToCity>
<ShipToCountry></ShipToCountry>
<ShipToStateOrProvince></ShipToStateOrProvince>
<ShipToStreet></ShipToStreet>
<ShipToZipOrPostalCode></ShipToZipOrPostalCode>
<SupplierPartNumber></SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>WHTTax</TaxType>
<TaxAmount>2193.75</TaxAmount>
<TaxRate>9.75</TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
<LineDescription>NowX Charger</LineDescription>
<PurchaseOrderLine>PO-6789-001</PurchaseOrderLine>
<LineQuantity>15</LineQuantity>
<LineUnitPrice>99.00</LineUnitPrice>
<Subtotal>1485.00</Subtotal>
<LineAmountInvoiced>1629.79</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter></CostCenter>
<GLAccount></GLAccount>
<TaxCode></TaxCode>
<ShipToCity></ShipToCity>
<ShipToCountry></ShipToCountry>
<ShipToStateOrProvince></ShipToStateOrProvince>
<ShipToStreet></ShipToStreet>
<ShipToZipOrPostalCode></ShipToZipOrPostalCode>
<SupplierPartNumber></SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
<TaxDetail>
<TaxType>GSTTax</TaxType>
<TaxAmount>144.79</TaxAmount>
<TaxRate>9.75</TaxRate>
</TaxDetail>
<TaxDetail>
<TaxType>CGST</TaxType>
<TaxAmount>1000</TaxAmount>
<TaxRate>12</TaxRate>
</TaxDetail>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<Invoice>
<InvoiceType>invoice</InvoiceType>
<SupplierInvoiceNumber>S-432432426</SupplierInvoiceNumber>
<ExternalInvoiceNumber>EXT-INV-006</ExternalInvoiceNumber>
<Supplier>3245545</Supplier>
<PurchaseOrder>0004511198</PurchaseOrder>
<BusinessOwner>Paula Smith</BusinessOwner>
<InvoiceDate>2023-09-02</InvoiceDate>
<PaymentTerms>Net 60</PaymentTerms>
<OriginalInvoice></OriginalInvoice>
<LegalEntity></LegalEntity>
<Subtotal>23985.00</Subtotal>
<ShippingAmount>750.00</ShippingAmount>
<OtherCharges></OtherCharges>
<Discounts></Discounts>
<AmountInvoiced>27073.54</AmountInvoiced>
<Currency>USD</Currency>
<InvoiceLineCount>2</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>VATTax</TaxType>
<TaxAmount>2338.54</TaxAmount>
<TaxRate></TaxRate>
</TaxDetail>
</TaxDetails>
<InvoiceLines>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
<LineDescription>NowX Laptop</LineDescription>
<PurchaseOrderLine></PurchaseOrderLine>
<LineQuantity>15</LineQuantity>
<LineUnitPrice>1500.00</LineUnitPrice>
<Subtotal>22500.00</Subtotal>
<LineAmountInvoiced>24693.75</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter></CostCenter>
<GLAccount></GLAccount>
<TaxCode></TaxCode>
<ShipToCity></ShipToCity>
<ShipToCountry></ShipToCountry>
<ShipToStateOrProvince></ShipToStateOrProvince>
<ShipToStreet></ShipToStreet>
<ShipToZipOrPostalCode></ShipToZipOrPostalCode>
<SupplierPartNumber></SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
</TaxDetails>
</InvoiceLine>
<InvoiceLine>
<ExternalInvoiceNumber>EXT-INV-002</ExternalInvoiceNumber>
<LineDescription>NowX Charger</LineDescription>
<PurchaseOrderLine>PO-6789-001</PurchaseOrderLine>
<LineQuantity>15</LineQuantity>
<LineUnitPrice>99.00</LineUnitPrice>
<Subtotal>1485.00</Subtotal>
<LineAmountInvoiced>1629.79</LineAmountInvoiced>
<Currency>USD</Currency>
<CostCenter></CostCenter>
<GLAccount></GLAccount>
<TaxCode></TaxCode>
<ShipToCity></ShipToCity>
<ShipToCountry></ShipToCountry>
<ShipToStateOrProvince></ShipToStateOrProvince>
<ShipToStreet></ShipToStreet>
<ShipToZipOrPostalCode></ShipToZipOrPostalCode>
<SupplierPartNumber></SupplierPartNumber>
<UOM>Individual Unit</UOM>
<TaxDetails>
</TaxDetails>
</InvoiceLine>
</InvoiceLines>
</Invoice>
<TargetERP>ERP1</TargetERP>
</Invoices>'
Le résultat suivant montre que la demande a abouti et que les données de la facture sont en cours de traitement. Vous pouvez consulter l’état de la demande dans la table Journal d’intégration de facture [sn_spend_intg_invoice_integration_log]. Utilisez l’ID de lot répertorié dans la colonne ID de lot pour trouver la facture.
{
"batchId": "APIINV1736249646168148",
"status": "Success",
"message": "Your request has been successfully received and is being processed."
}