Sample messages
Order Export (ERP & Supplier)
<?xml version="1.0" encoding="UTF-8"?>
<!--Reference to the cXML.dtd and it's version that is used for initial validation-->
<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.051/cXML.dtd">
<!--payloadID: generated id for each request-->
<!--timestamp: date when the request message was generated-->
<!--xml:lang: language of the buying organization-->
<cXML version="0" payloadID="2022-12-21T09:51:[email protected]" timestamp="2022-12-21T09:51:17" xml:lang="en">
<!--Contains the From, To and Sender information of an invoice-->
<Header>
<!--Reference to the buying organization of the order-->
<From>
<!--domain: "NetworkId" (buying organization)-->
<Credential domain="NetworkId">
<Identity>Demo</Identity>
</Credential>
<!--domain: "GLN" (buying organization GLN number)-->
<Credential domain="GLN">
<Identity>1234567890123</Identity>
</Credential>
</From>
<!--Reference to the supplier of the order using the supplier number-->
<To>
<!--domain: "NetworkId" (supplier number)-->
<Credential domain="NetworkId">
<Identity>SUP10001</Identity>
</Credential>
<!--domain: "GLN" (supplier GLN number)-->
<Credential domain="GLN">
<Identity>1234567890123</Identity>
</Credential>
</To>
<!--Reference to the sender of the request-->
<Sender>
<!--domain: "NetworkId" (buying organization)-->
<Credential domain="NetworkId">
<Identity>Demo</Identity>
<SharedSecret></SharedSecret>
</Credential>
<!--User agent used for sending the request-->
<UserAgent>proactis-eu-agent</UserAgent>
</Sender>
</Header>
<!--deploymentMode: "test" or "production"-->
<Request deploymentMode="production">
<OrderRequest>
<!--orderID: order number of the request -->
<!--orderDate: date/time when the order was generated-->
<!--orderType: "regular"-->
<!--type: "new"-->
<OrderRequestHeader orderID="00041401" orderDate="2023-06-19T09:51:17" orderType="regular" type="new">
<!--total order amount including VAT-->
<Total>
<!--currency: 3 letter ISO currency code-->
<Money currency="EUR">121.0000</Money>
</Total>
<!--ship to address on header level-->
<ShipTo>
<Address isoCountryCode="NL">
<Name xml:lang="en">Delivery Address</Name>
<PostalAddress>
<DeliverTo>John Doe</DeliverTo>
<DeliverTo>12A</DeliverTo>
<Street>Damrak 123</Street>
<City>Amsterdam</City>
<State></State>
<PostalCode>1000 AB</PostalCode>
<Country isoCountryCode="NL">Netherlands</Country>
<Extrinsic name="ProactisAddressee">John Doe</Extrinsic>
</PostalAddress>
<Phone name="Business">
<TelephoneNumber>
<CountryCode isoCountryCode="NL">31</CountryCode>
<AreaOrCityCode>020</AreaOrCityCode>
<Number>12345678</Number>
<Extension></Extension>
</TelephoneNumber>
</Phone>
</Address>
</ShipTo>
<!--invoice address-->
<BillTo>
<Address isoCountryCode="NL">
<Name xml:lang="en">Invoice address</Name>
<PostalAddress>
<Street>Damrak 123</Street>
<City>Amsterdam</City>
<State></State>
<PostalCode>1000 AB</PostalCode>
<Country isoCountryCode="NL">Netherlands</Country>
</PostalAddress>
<Email name="default">[email protected]</Email>
<Phone name="Business">
<TelephoneNumber>
<CountryCode isoCountryCode="NL">31</CountryCode>
<AreaOrCityCode>030</AreaOrCityCode>
<Number>12345678</Number>
<Extension></Extension>
</TelephoneNumber>
</Phone>
</Address>
</BillTo>
<Tax>
<!--total invoice tax value-->
<Money currency="EUR">21.0000</Money>
<Description xml:lang="en"></Description>
<TaxDetail category="tax">
<!--total invoice value excluding VAT-->
<TaxableAmount>
<Money currency="EUR">100.0000</Money>
</TaxableAmount>
<!--total invoice tax value-->
<TaxAmount>
<Money currency="EUR">21.0000</Money>
</TaxAmount>
</TaxDetail>
</Tax>
<!--reference to the buyer-->
<Contact role="buyer">
<Name xml:lang="en">John Doe</Name>
<Email />
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode="NL">31</CountryCode>
<AreaOrCityCode>20</AreaOrCityCode>
<Number>1234567</Number>
<Extension></Extension>
</TelephoneNumber>
</Phone>
<!--user id of the buyer-->
<Extrinsic name="ProactisUserId">johndoe</Extrinsic>
</Contact>
<!--supplier information-->
<Contact role="supplierCorporate">
<Name xml:lang="en">Supplier Name</Name>
<PostalAddress name="supplierCorporate">
<Street>Street</Street>
<Street>Street</Street>
<City>Amsterdam</City>
<State>N-H</State>
<PostalCode>1234 AB</PostalCode>
<Country isoCountryCode="NL">Netherlands</Country>
</PostalAddress>
<Email>[email protected]</Email>
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode="NL"/>
<AreaOrCityCode></AreaOrCityCode>
<Number>0123456789</Number>
<Extension></Extension>
</TelephoneNumber>
</Phone>
<IdReference identifier="NL123456789B01" domain="vatID"/>
<IdReference identifier="987654321" domain="companyRegistrationNumber"/>
</Contact>
<!--order comments-->
<Comments>Comments
<!-- Reference to an attachments. Attachments will be added as multipart-->
<Attachment>
<URL>cid:PO00074651.pdf</URL>
</Attachment>
</Comments>
<!--Delivery terms-->
<TermsOfDelivery>
<TermsOfDeliveryCode value="Other"></TermsOfDeliveryCode>
<ShippingPaymentMethod value="Account"/>
</TermsOfDelivery>
<!--identifier: order reference -->
<!--domain: "OrderReference"-->
<IdReference identifier="00041401" domain="OrderReference" />
<!--Status of the order-->
<Extrinsic name="ProactisOrderStatus">ORDERED</Extrinsic>
<!--Show the processed status: open or closed-->
<Extrinsic name="ProactisProcessStatus">closed</Extrinsic>
<!-- Identifies whether the order has been imported -->
<Extrinsic name="ProactisImportStatus">true</Extrinsic>
</OrderRequestHeader>
<!--order line-->
<!--quantity: ordered number for the current order line-->
<!--lineNumber: position of the line in the order-->
<!--requestedDeliveryDate: date/time when delivery of the order line is expected-->
<!--isAdHoc: "yes"-->
<ItemOut quantity="5.0000" lineNumber="1" requestedDeliveryDate="2023-06-20T12:00:00" isAdHoc="yes">
<!--a unique identification of an item-->
<ItemID>
<SupplierPartID>FF1</SupplierPartID>
</ItemID>
<ItemDetail>
<UnitPrice>
<!--price per unit excluding VAT-->
<Money currency="EUR">10.0000</Money>
</UnitPrice>
<!--article name and long description-->
<Description xml:lang="en">Blue Pen 22 cm
<ShortName>Blue Pen</ShortName>
</Description>
<!--unit of measure-->
<UnitOfMeasure>PCE</UnitOfMeasure>
<PriceBasisQuantity quantity="1.0000" conversionFactor="1">
<UnitOfMeasure>PCE</UnitOfMeasure>
</PriceBasisQuantity>
<!--commodity code and spending pool-->
<!--domain: either "CommodityCode" or "SpendingPool"-->
<!--code: selected Commodity Code or Spending Pool-->
<Classification domain="CommodityCode" code="2000">Facilities</Classification>
<Classification domain="SpendingPool" code="2010">Office supplies</Classification>
<!--smart form-->
<!--name: smart form name-->
<Extrinsic name="Personal usage?">No</Extrinsic>
</ItemDetail>
<!--ship to address on line level-->
<ShipTo>
<Address isoCountryCode="NL">
<Name xml:lang="en">Delivery Address</Name>
<PostalAddress>
<DeliverTo>John Doe</DeliverTo>
<Street>Damrak 123</Street>
<City>Amsterdam</City>
<State />
<PostalCode>1000 AB</PostalCode>
<Country isoCountryCode="NL">Netherlands</Country>
<Extrinsic name="ProactisAddressee">John Doe</Extrinsic>
</PostalAddress>
<Email name="default" />
<Phone name="Business">
<TelephoneNumber>
<CountryCode isoCountryCode="NL" />
<AreaOrCityCode />
<Number />
<Extension />
</TelephoneNumber>
</Phone>
</Address>
</ShipTo>
<!--tax information of the order line-->
<Tax>
<!--total line tax amount-->
<Money currency="EUR">10.5000</Money>
<Description xml:lang="en">PLI Tax</Description>
<!--Tax information-->
<!--category: "tax"-->
<!--percentageRate: tax rate in percentage rounded to 4 decimals-->
<!--taxRateType: tax rate type code-->
<TaxDetail category="tax" percentageRate="21.0000" taxRateType="3">
<!--total line value excluding tax-->
<TaxableAmount>
<Money currency="EUR">50.0000</Money>
</TaxableAmount>
<!--total line tax value-->
<TaxAmount>
<Money currency="EUR">10.5000</Money>
</TaxAmount>
<TaxLocation xml:lang="en"></TaxLocation>
</TaxDetail>
</Tax>
<Distribution>
<!--Accounting information-->
<Accounting name="CostCoding">
<!--Department information-->
<!--type: "DepartmentId"-->
<!--id: department id-->
<!--description: Department name-->
<Segment type="DepartmentId" id="A-2000" description="Centrale Inkoop_update" />
<!--Cost center information-->
<!--type: "CostCenterId"-->
<!--id: id of the Cost center-->
<!--description: Cost center name-->
<Segment type="CostCenterId" id="cc007" description="HR" />
<!--Cost account information-->
<!--type: "CostAccountId"-->
<!--id: id of the Cost account-->
<!--description: Cost account name-->
<Segment type="CostAccountId" id="CA01" description="CA01" />
<!--cost dimension information-->
<!--type: parent dimension name-->
<!--id: name of the dimension-->
<!--description: description of the dimension-->
<Segment type="A10 Project code" id="A123" description="A123" />
</Accounting>
<!--total line value including vat-->
<Charge>
<Money currency="EUR">60.5000</Money>
</Charge>
</Distribution>
</ItemOut>
</OrderRequest>
</Request>
</cXML>
Order Import
<?xml version="1.0" encoding="UTF-8"?>
<!--Reference to the cXML.dtd and it's version that is used for initial validation-->
<!DOCTYPE cXML SYSTEM "http://xml.cxml.org/schemas/cXML/1.2.051/cXML.dtd">
<!--payloadID: generated id for each request-->
<!--timestamp: date when the request message was generated-->
<!--xml:lang: language of the buying organization-->
<cXML version="0" payloadID="2022-12-21T09:51:[email protected]" timestamp="2022-12-21T09:51:17" xml:lang="en">
<!--Contains the From, To and Sender information of an invoice-->
<Header>
<!--Reference to the buying organization of the order-->
<From>
<!--domain: "NetworkId" (buying organization)-->
<Credential domain="NetworkId">
<Identity>Demo</Identity>
</Credential>
</From>
<!--Reference to the supplier of the order using the supplier number-->
<To>
<!--domain:
"NetworkId" (supplier number)-->
<Credential domain="NetworkId">
<Identity>SUP10001</Identity>
</Credential>
</To>
<!--Reference to the sender of the request-->
<Sender>
<!--domain: "NetworkId" (buying organization)-->
<Credential domain="NetworkId">
<Identity>Demo</Identity>
<SharedSecret></SharedSecret>
</Credential>
<!--User agent used for sending the request-->
<UserAgent>proactis-eu-agent</UserAgent>
</Sender>
</Header>
<!--deploymentMode: "test" or "production"-->
<Request deploymentMode="production">
<OrderRequest>
<!--orderID: order number of the request -->
<!--orderDate: date/time when the order was generated-->
<!--orderType: "regular"-->
<!--type: "=new"-->
<OrderRequestHeader orderID="00041401" orderDate="2023-06-19T09:51:17" orderType="regular" type="new">
<!--total order amount including VAT-->
<Total>
<!--currency: 3 letter ISO currency code-->
<Money currency="EUR">121.0000</Money>
</Total>
<!--ship to address on header level-->
<ShipTo>
<Address isoCountryCode="NL">
<Name xml:lang="en">Delivery Address</Name>
<PostalAddress>
<Street>Damrak 123</Street>
<City>Amsterdam</City>
<State>N-H</State>
<PostalCode>1000 AB</PostalCode>
<Country isoCountryCode="NL">Netherlands</Country>
<Extrinsic name="ProactisAddressee">First Lastname</Extrinsic>
</PostalAddress>
<Phone name="Business">
<TelephoneNumber>
<CountryCode isoCountryCode="NL">31</CountryCode>
<AreaOrCityCode>020</AreaOrCityCode>
<Number>12345678</Number>
<Extension></Extension>
</TelephoneNumber>
</Phone>
</Address>
</ShipTo>
<!--invoice address-->
<BillTo>
<Address isoCountryCode="NL">
<Name xml:lang="en">Invoice address</Name>
<PostalAddress>
<Street>Damrak 123</Street>
<City>Amsterdam</City>
<State></State>
<PostalCode>1000 AB</PostalCode>
<Country isoCountryCode="NL">Netherlands</Country>
<Extrinsic name="ProactisContactName">John Doe</Extrinsic>
</PostalAddress>
<Phone name="Business">
<TelephoneNumber>
<CountryCode isoCountryCode="NL">31</CountryCode>
<AreaOrCityCode>030</AreaOrCityCode>
<Number>12345678</Number>
<Extension></Extension>
</TelephoneNumber>
</Phone>
</Address>
</BillTo>
<Tax>
<!--total invoice tax value-->
<Money currency="EUR">21.0000</Money>
<Description xml:lang="en"></Description>
<TaxDetail category="tax">
<!--total invoice value excluding VAT-->
<TaxableAmount>
<Money currency="EUR">100.0000</Money>
</TaxableAmount>
<!--total invoice tax value-->
<TaxAmount>
<Money currency="EUR">21.0000</Money>
</TaxAmount>
</TaxDetail>
</Tax>
<!--reference to the buyer-->
<Contact role="buyer">
<Name xml:lang="en">John Doe</Name>
<Email />
<Phone>
<TelephoneNumber>
<CountryCode isoCountryCode="NL">31</CountryCode>
<AreaOrCityCode>20</AreaOrCityCode>
<Number>1234567</Number>
<Extension></Extension>
</TelephoneNumber>
</Phone>
<!--user id of the buyer-->
<Extrinsic name="ProactisUserId">johndoe</Extrinsic>
</Contact>
<!--order comments-->
<Comments>Comments</Comments>
<!--identifier: order reference -->
<!--domain: "OrderReference"-->
<IdReference identifier="00041401" domain="OrderReference" />
<!--whether you want to export the order to a supplier after import. default is true-->
<Extrinsic name="ProactisSendSupplierOrder">true</Extrinsic>
<!--whether you want to export the order to the ERP environment (if this integration is present). default is true-->
<Extrinsic name="ProactisSendERPOrder">true</Extrinsic>
</OrderRequestHeader>
<!--order line-->
<!--quantity: ordered number for the current order line-->
<!--lineNumber: position of the line in the order-->
<!--requestedDeliveryDate: date/time when delivery of the order line is expected-->
<!--isAdHoc: "yes"-->
<ItemOut quantity="5.0000" lineNumber="1" requestedDeliveryDate="2023-06-20T12:00:00" isAdHoc="yes">
<!--a unique identification of an item-->
<ItemID>
<SupplierPartID>FF1</SupplierPartID>
</ItemID>
<ItemDetail>
<UnitPrice>
<!--price per unit excluding VAT-->
<Money currency="EUR">10.0000</Money>
</UnitPrice>
<!--article name and long description-->
<Description xml:lang="en">Blue Pen 22 cm
<ShortName>Blue Pen</ShortName>
</Description>
<!--unit of measure-->
<UnitOfMeasure>PCE</UnitOfMeasure>
<PriceBasisQuantity quantity="1.0000" conversionFactor="1">
<UnitOfMeasure>PCE</UnitOfMeasure>
</PriceBasisQuantity>
<!--commodity code and spending pool-->
<!--domain: either "CommodityCode" or "SpendingPool"-->
<!--code: selected Commodity Code or Spending Pool-->
<Classification domain="CommodityCode" code="2000">Facilities</Classification>
<Classification domain="SpendingPool" code="2010">Office supplies</Classification>
<!--optional: smart forms field if used for the specified catalog or supplier-->
<Extrinsic name="Concerns a requisition for:">Account</Extrinsic>
<Extrinsic name="Type of request - Account">New</Extrinsic>
<Extrinsic name="Create new user?"></Extrinsic>
</ItemDetail>
<!--ship to address on line level-->
<ShipTo>
<Address isoCountryCode="NL">
<Name xml:lang="en">Delivery Address</Name>
<PostalAddress>
<Street>Damrak 123</Street>
<City>Amsterdam</City>
<State />
<PostalCode>1000 AB</PostalCode>
<Country isoCountryCode="NL">Netherlands</Country>
<Extrinsic name="ProactisAddressee">John Doe</Extrinsic>
</PostalAddress>
<Email name="default" />
<Phone name="Business">
<TelephoneNumber>
<CountryCode isoCountryCode="NL" />
<AreaOrCityCode />
<Number />
<Extension />
</TelephoneNumber>
</Phone>
</Address>
</ShipTo>
<!--tax information of the order line-->
<Tax>
<!--total line tax amount-->
<Money currency="EUR">10.5000</Money>
<Description xml:lang="en">PLI Tax</Description>
<!--Tax information-->
<!--category: "tax"-->
<!--percentageRate: tax rate in percentage rounded to 4 decimals-->
<!--taxRateType: tax rate type code-->
<TaxDetail category="tax" percentageRate="21.0000" taxRateType="3">
<!--total line value excluding tax-->
<TaxableAmount>
<Money currency="EUR">50.0000</Money>
</TaxableAmount>
<!--total line tax value-->
<TaxAmount>
<Money currency="EUR">10.5000</Money>
</TaxAmount>
<TaxLocation xml:lang="en"></TaxLocation>
</TaxDetail>
</Tax>
<Distribution>
<!--Accounting information-->
<Accounting name="CostCoding">
<!--Department information-->
<!--type: "DepartmentId"-->
<!--id: department id-->
<!--description: Department name-->
<Segment type="DepartmentId" id="A-2000" description="Centrale Inkoop_update" />
<!--Cost center information-->
<!--type: "CostCenterId"-->
<!--id: id of the Cost center-->
<!--description: Cost center name-->
<Segment type="CostCenterId" id="cc007" description="HR" />
<!--Cost account information-->
<!--type: "CostAccountId"-->
<!--id: id of the Cost account-->
<!--description: Cost account name-->
<Segment type="CostAccountId" id="CA01" description="CA01" />
<!--cost dimension information-->
<!--type: parent dimension name-->
<!--id: name of the dimension-->
<!--description: description of the dimension-->
<Segment type="A10 Project code" id="A123" description="A123" />
</Accounting>
<!--total line value including vat-->
<Charge>
<Money currency="EUR">60.5000</Money>
</Charge>
</Distribution>
</ItemOut>
</OrderRequest>
</Request>
</cXML>