commandes cXML
Coupa prend en charge les documents OrderRequest et OrderResponse cXML.
Introduction
Coupa adhère aux normes cXML. Nous vous suggérons de vous référer au Guide de l'utilisateur cXML sur cXML.org pour en savoir plus. Voir aussi Gestion des caractères spéciaux communs dans cXML.
Utilisez les exemples de bon de commande ci-dessous :
Exemple de bon de commande cXML avec annotations
Si vous envisagez de recevoir des bons de commande via cXML, vous devez remplir le questionnaire fournisseur Coupa cXML et le remettre à votre client.
Comment ça marche
Coupa vous enverra un document cXML OrderResponse avec un document OrderResponse , qui comprend les champs de validation requis :
- Domaine du fournisseur
- Identité du fournisseur
- Domaine de l'acheteur
- Identité de l'acheteur
- Secret partagé
CXML pris en charge
Coupa prend en charge les documents de bon de commande cXML suivants. Les fournisseurs doivent renvoyer une OrderResponse dans les 60 secondes pour chaque OrderRequest reçue.
document cXML | Description |
---|---|
OrderRequest |
Inclure les éléments suivants :
|
OrderResponse | Publiez votre cXML à nouveau sur Coupa lorsque vous recevez OrderRequest. |
codes d'état de réponse de commande cXML
Code | Signification |
---|---|
2XX | Bravo ! |
5XX | Erreur, mais le système réessayera 5 fois à des intervalles d'une heure |
4XX | Erreur, et les tentatives ne seront pas réussies |
Liste de contrôle des tests
Parlez à votre client de la façon de tester votre intégration.
Exemple de cXML
Bon de commande avec annotations
<?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 Procurement 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.</Street>
<City>san leandro</City>
<State>ca</State>
<PostalCode>22222</PostalCode>
<Country isoCountryCode="US">États-Unis</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>Noah Sanity Attn : Noah Noah</DeliverTo>
<Street>3420 Flatiron Way</Street>
<City>Index Ouest</City>
<State>NJ</State>
<PostalCode>43023</PostalCode>
<Country isoCountryCode="US">États-Unis</Country>
</PostalAddress>
</Address>
</BillTo>
<Contact role="endUser">
<Name xml:lang="en">j maddedn</Name>
<Email name="default">jmadden@coupa1.com</Email>
</Contact>
<Comments xml:lang="en">le commentaire d'en-tête va ici s'il est entré par l'utilisateur</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">Minitour OptiPlex 755 Energy Smart ;Processeur IntelREG CoreTM 2 Quad Q6600 (2,40GHz, 2X4M, FSB 1066MHz)</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">le commentaire de l'élément de ligne va ici s'il est entré par l'utilisateur</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>
Traitement des erreurs
Si une erreur s'affiche lors de la configuration d'une connexion cXML, voir Gestion des erreurs cXML.
Coupa ne prend pas en charge l'authentification par certificat client SSL et exige que le fournisseur supprime cette restriction. Voir Erreurs TLS/SSL pendant la transmission du bon de commande pour plus d'informations.