• Dernière modification le: 06 April 2023

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

Remarque

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 :

  • URL d'acheminement
  • Domaine et identité du fournisseur
  • Domaine et identité de l'acheteur
  • Secret partagé
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.

Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.