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
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:
|
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.