• Zuletzt bearbeitet am: 06 April 2023

cXML-Bestellungen

Coupa unterstützt die Dokumente cXML OrderRequest und OrderResponse.

Einleitung

Coupa hält sich an cXML-Standards. Weitere Informationen finden Sie im cXML-Benutzerhandbuch unter cXML.org. Siehe auch Umgang mit gewöhnlichen Sonderzeichen in cXML.

Verwenden Sie die unten aufgeführten Bestellbeispiele:

Beispiel einer cXML-Bestellung mit Anmerkungen

Hinweis

Wenn Sie vorhaben, Bestellungen über cXML zu erhalten, sollten Sie den Coupa cXML-Lieferantenfragebogen ausfüllen und an Ihren Kunden weitergeben.

So funktioniert es

Coupa sendet Ihnen ein OrderResponse cXML-Dokument mit einem OrderResponse-Dokument, das diese erforderlichen Validierungsfelder enthält:

  • Domain des Lieferanten
  • Identität des Lieferanten
  • Einkäufer-Domain
  • Einkäuferidentität
  • Shared Secret

Unterstützte cXML

Coupa unterstützt die folgenden cXML-Bestelldokumente. Lieferanten müssen für jede erhaltene OrderRequest innerhalb von 60 Sekunden eine OrderResponse zurücksenden.

cXML-Dokument Beschreibung
OrderRequest

Die folgenden Elemente einschließen:

  • Routing-URL
  • Domäne und Identität des Lieferanten
  • Einkäuferdomäne und -identität
  • Shared Secret
OrderResponse Buchen Sie Ihre cXML zurück zu Coupa, wenn Sie OrderRequest erhalten.

cXML-Bestellantwort-Statuscodes

Code Bedeutung
2XX Erfolgreich
5XX Fehler, aber das System wird es 5 Mal in 1-Stunden-Intervallen wiederholen
4XX Fehler und Wiederholungen sind nicht erfolgreich

Testen Checkliste

Sprechen Sie mit Ihrem Kunden darüber, wie Sie Ihre Integration testen können.

Beispiel-cXML

Bestellung mit Anmerkungen

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.014/cXML.dtd">

<cXML xml:lang="en-US" payloadID="1452186890.009162@ip-10-7-14-126" timestamp="2008-01-07T09:14:50-08:00">

   <Header>

      <From>

         <Credential domain="duns">

            <!-- Customer domain typically provided by Supplier, typically DUNS -->

            <Identity>dell</Identity>

            <!-- Customer id typically provided by Supplier, string -->

         </Credential>

      </From>

      <To>

         <Credential domain="Duns">

            <!-- Supplier domain typically provided by Supplier, typically DUNS -->

            <Identity>128293714</Identity>

            <!-- Supplier id typically provided by Supplier, string -->

         </Credential>

      </To>

      <Sender>

         <Credential domain="duns">

            <Identity>dell</Identity>

            <!-- same as From -->

            <Identity>dell</Identity>

            <!-- same as From -->

         </Credential>

         <UserAgent>Coupa Beschaffung 1.0</UserAgent>

         <!-- does not change -->

      </Sender>

   </Header>

   <Request deploymentMode="production">

      <OrderRequest>

         <OrderRequestHeader orderID="6112" orderDate="2008-01-07T09:14:50-08:00" type="new">

         <!-- Coupa supports "new" and "update" -->

            <Total>

               <Money currency="USD">1505,0</Money>

               <!-- Currency code configured in Coupa -->

            </Total>

            <ShipTo>

               <Address isoCountryCode="US" addressID="3119">

                  <Name xml:lang="en">jmadden</Name>

                  <PostalAddress name="default">

                     <DeliverTo>j maddedn</DeliverTo>

                     <Street>333 East Hill Dr. med.</Street>

                     <City>san leandro</City>

                     <State>ca</State>

                     <PostalCode>22222</PostalCode>

                     <Country isoCountryCode="US">Vereinigte Staaten</Country>

                  </PostalAddress>

                  <Email name="default">jmadden@coupa1.com</Email>

               </Address>

            </ShipTo>

            <BillTo>

               <Address isoCountryCode="US" addressID="142">

                  <Name xml:lang="en">SOB1</Name>

                  <!-- Company Name under Company Information in Coupa -->

                  <PostalAddress name="default">

                     <DeliverTo>An: Noah Noah</DeliverTo>

                     <Street>3420 Flatiron Way</Street>

                     <City>West-Index</City>

                     <State>NJ</State>

                     <PostalCode>43023</PostalCode>

                     <Country isoCountryCode="US">Vereinigte Staaten</Country>

                  </PostalAddress>

               </Address>

            </BillTo>

            <Contact role="endUser">

               <Name xml:lang="en">j maddedn</Name>

               <Email name="default">jmadden@coupa1.com</Email>

            </Contact>

            kopfzeilen-Kommentar wird hier<Comments xml:lang="en"> angezeigt, wenn vom Benutzer eingegeben</Comments>

         </OrderRequestHeader>

         <ItemOut quantity="1" lineNumber="1">

            <ItemID>

               <SupplierPartID>223-4511</SupplierPartID>

               <!-- Coupa Item Part Number -->

               <SupplierPartAuxiliaryID>1005379527029\1</SupplierPartAuxiliaryID>

               <!-- Auxiliary Part Number is optional, typically used by punchout suppliers -->

            </ItemID>

            <ItemDetail>

               <UnitPrice>

                  <Money currency="USD">1505,0</Money>

                  <!-- Currency code configured in Coupa -->

               </UnitPrice>

               <Description xml:lang="en">OptiPlex 755 Energy Smart Minitower;IntelREG CoreTM 2 Quad-Prozessor Q6600 (2,40GHz, 2X4M, 1066 MHz FSB)</Description>

               <UnitOfMeasure>EA</UnitOfMeasure>

               <Classification domain="UNSPSC">44000000</Classification>

               <!-- Future expansion -->

            </ItemDetail>

            <Distribution>

               <Accounting name="bbbb">

                  <!-- Coupa Account name -->

                  <Segment id="bbb" description="ORG" type="Organization" />

                  <Segment id="b" description="DEPT" type="Department" />

                  <Segment id="bb" description="PROJ" type="Project" />

               </Accounting>

               <Charge>

                  <Money currency="USD">1505,0</Money>

               </Charge>

            </Distribution>

            <Comments xml:lang="en">einzelposten-Kommentar wird hier angezeigt, wenn vom Benutzer eingegeben</Comments>

         </ItemOut>

      </OrderRequest>

   </Request>

</cXML>

OrderResponse

<?xml version="1.0"?>

<cXML payloadID="111111111" xml:lang="en" timestamp="1999-03-12T18:39:09-08:00">

	<Response>

		 <Status code="200" text="OK"/>

	</Response>

</cXML>

Fehlerbehandlung

Wenn beim Einrichten einer cXML-Verbindung eine Fehlermeldung angezeigt wird, siehe cXML-Fehlerbehandlung

Coupa unterstützt keine SSL-Client-Zertifikat-Authentifizierung und fordert den Lieferanten auf, diese Einschränkung aufzuheben. Weitere Informationen finden Sie unter TLS/SSL-Fehler während der PO-Übertragung.