General Services Administration (GSA)
cXML Purchase Order Startup Packet
March 27, 2023
Table of Contents
1.cXML Implementation Process and Instructions1
2.cXML Vendor Checklist3
3.cXML References/Links5
4.GSA cXML Purchase Order Guidelines6
5.GSA cXML Purchase Order Change Guidelines11
6.GSA cXML Ship Notice Request Guidelines14
7.GSA cXML Confirmation Request Guidelines17
cXML Implementation Process and Instructions
This packet provides the documentation and instructions for Vendors to follow to begin receiving cXML purchase orders from GSA. This packet contains the following documents:
• GSA cXML Vendor Checklist
• cXML References and Links
• GSA cXML Purchase Order Guidelines
• GSA cXML Purchase Order Change Guidelines
• GSA cXML Ship Notice Request Guidelines
• GSA cXML Confirmation Request Guidelines
Please follow the GSA cXML Vendor Checklist to ensure that all required information is transmitted to your GSA point of contact. At a minimum, all mandatory tasks must be completed prior to entering the testing phase.
GSA is following the Commerce XML (cXML) resources, guidelines and standards/version 1.2.024. Please refer to the cXML Reference and Links document in this packet for further guidance. The document contains links to the cXML website, a downloadable User’s Guide, and/or a zip file containing the User’s Guide, DTD, and examples.
The GSA cXML Purchase Order Guidelines document provides an example of a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags.
The GSA cXML Purchase Order Change Guidelines document provides an example of a change to a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags.
The GSA cXML Ship Notice Request Guidelines document provides an example of a shipment/status transaction for a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags.
The GSA cXML Confirmation Request Guidelines document provides an example of shipment(accept)/backorder/reject(cancellation) status transactions for a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags.
3. cXML Vendor Checklist
GSA cXML Vendor Checklist
GSA POC:
Date Checklist Submitted to GSA:
Task
Mandatory/Optional
Response
What is your UEI code?
Mandatory
What is your Contract number(s)?
Mandatory
Who is your technical point of contact?
Mandatory
What is the email address of your technical contact?
Mandatory
What is the phone number of your technical contact?
Mandatory
#######Who is your business line point of contact?
Mandatory
########What is the email address of your business line contact?
Mandatory
#########What is the phone number of your business line contact?
Mandatory
##########What is the URL for your website?
Mandatory
###########Have you provided GSA with your Certification Authority (CA) certification?
Mandatory
Do you agree to send a 200 acknowledgement back to GSA upon the successful receipt of a cXML purchase order?
Anything other than a 200 return code will be considered an error.
Mandatory
200 Acknowledgement Example:
<?xml version="1.0" encoding="UTF-8"?>
What is your User id?
Optional
What is your Password?
Optional
What is your directory path?
Optional
Do you want to include the GSA NetworkID in your orders? (cXML/header/from)
Optional
Do you want to include a NetworkUserID and SharedSecret in your orders?
(cXML/header/sender)
Optional
Do you want to use a port other than the GSA standard/Port 443?
Optional
Is a 3rd party providing service for you? If so:
Optional
• What is the company’s name?
Mandatory
• What is the company’s UEI code?
Mandatory
• What is the company’s URL for their website?
Mandatory
• Who is the company’s technical contact?
Mandatory
• What is the email address of the company’s technical contact?
Mandatory
• What is the phone number of the company’s technical contact?
Mandatory
• Who is the company’s business line contact?
Mandatory
• What is the email address of the company’s business line contact?
Mandatory
• What is the phone number of the company’s business line contact?
Mandatory
• Have you provided written/email approval to GSA for 3rd party to provide this service for you?
Mandatory
012966339ADVTgsaadvan123456789ABC012966339ADVTgsaadvanABCD_1234Default1.60US ArmyDaniel B Leahy123 Grove Street2nd FloorArlingtonVA22202USir@wikiexchange.org123567890Invoicing DepartmentDaniel B Leahy123 Elm Street2nd FloorArlingtonVA22202USir@wikiexchange.org123456789022202USBuyer/Ordering Contact:Daniel B LeahyDaniel B Leahy123 Grove Street2nd FloorArlingtonVIC3555AUir@wikiexchange.org0423175714
Obtain credit card authorization prior to shipment
123456AB17496407-52800236GS999AVISADESTINATIONDepartment of the ArmyDaniel B Leahy, Building 123423175714ABC2013-06-05GSA ADVANTAGE ORDERABCDM001712156GCPCXXXDelivery Order14847141.60Quest Gel Ink Red Pens 0.5Mm Line Width - Box Of 12BXQU5768Quest International Ltd.
< Extrinsic name="Appropriation Data">123456AB
GS999ADESTINATIONDaniel B Leahy, Building 1239999-99-999-9999123456789ABCABCDM001712156GCPCXXXReceiving Contact: Daniel B LeahyHandle and package with care please
GSA cXML Purchase Order Change Guidelines
Only the elements and attributes present in this example are supported by GSA.
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
999999999ABCgsaadvan012966339ADVT999999999ABCgsaadvanabcd_1234DefaultFederal Express8202 8261 119499999999.999999991GS99F9991H99999999.999999992GS99F9992H99999999.999999993GS99F9993H
8. GSA cXML Confirmation Request Guidelines
Only the elements and attributes present in this example are supported by GSA.
999999999ABCgsaadvan012966339ADVT999999999ABCgsaadvanabcd_1234Default99999999.999999999GS99F9993HEAEAEAEAEAEAEA
GSA cXML Purchase Order Startup Packet –March 27, 2023Page 1
General Services Administration (GSA) cXML Purchase Order Startup Packet
March 27, 2023
Table of Contents
1.cXML Implementation Process and Instructions1 2.cXML Vendor Checklist3 3.cXML References/Links5 4.GSA cXML Purchase Order Guidelines6 5.GSA cXML Purchase Order Change Guidelines11 6.GSA cXML Ship Notice Request Guidelines14 7.GSA cXML Confirmation Request Guidelines17
This packet provides the documentation and instructions for Vendors to follow to begin receiving cXML purchase orders from GSA. This packet contains the following documents: • GSA cXML Vendor Checklist • cXML References and Links • GSA cXML Purchase Order Guidelines • GSA cXML Purchase Order Change Guidelines • GSA cXML Ship Notice Request Guidelines • GSA cXML Confirmation Request Guidelines Please follow the GSA cXML Vendor Checklist to ensure that all required information is transmitted to your GSA point of contact. At a minimum, all mandatory tasks must be completed prior to entering the testing phase. GSA is following the Commerce XML (cXML) resources, guidelines and standards/version 1.2.024. Please refer to the cXML Reference and Links document in this packet for further guidance. The document contains links to the cXML website, a downloadable User’s Guide, and/or a zip file containing the User’s Guide, DTD, and examples. The GSA cXML Purchase Order Guidelines document provides an example of a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags. The GSA cXML Purchase Order Change Guidelines document provides an example of a change to a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags. The GSA cXML Ship Notice Request Guidelines document provides an example of a shipment/status transaction for a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags. The GSA cXML Confirmation Request Guidelines document provides an example of shipment(accept)/backorder/reject(cancellation) status transactions for a GSA cXML order containing the elements and attributes supported by GSA. Notes about the elements/attributes are provided below each element in comment tags.
3. cXML Vendor Checklist
GSA cXML Vendor Checklist GSA POC: Date Checklist Submitted to GSA: Task Mandatory/Optional Response What is your UEI code? Mandatory
What is your Contract number(s)?
Mandatory
Who is your technical point of contact?
Mandatory
What is the email address of your technical contact?
Mandatory
What is the phone number of your technical contact?
Mandatory
#######Who is your business line point of contact? Mandatory
########What is the email address of your business line contact? Mandatory
#########What is the phone number of your business line contact? Mandatory
##########What is the URL for your website? Mandatory
###########Have you provided GSA with your Certification Authority (CA) certification? Mandatory
Do you agree to send a 200 acknowledgement back to GSA upon the successful receipt of a cXML purchase order? Anything other than a 200 return code will be considered an error. Mandatory 200 Acknowledgement Example: <?xml version="1.0" encoding="UTF-8"?>
What is your Password? Optional
What is your directory path? Optional
Do you want to include the GSA NetworkID in your orders? (cXML/header/from) Optional
Do you want to include a NetworkUserID and SharedSecret in your orders? (cXML/header/sender) Optional
Do you want to use a port other than the GSA standard/Port 443? Optional
Is a 3rd party providing service for you? If so: Optional
• What is the company’s name? Mandatory
• What is the company’s UEI code? Mandatory
• What is the company’s URL for their website? Mandatory
• Who is the company’s technical contact? Mandatory
• What is the email address of the company’s technical contact? Mandatory
• What is the phone number of the company’s technical contact? Mandatory
• Who is the company’s business line contact? Mandatory
• What is the email address of the company’s business line contact? Mandatory
• What is the phone number of the company’s business line contact? Mandatory
• Have you provided written/email approval to GSA for 3rd party to provide this service for you? Mandatory
http://cxml.org/ -> GSA is following Commerce XML (cXML) resources, guidelines and standards (version 1.2.024)
http://xml.cxml.org/current/cXMLUsersGuide.pdf -> User’s guide download in PDF format http://xml.cxml.org/current/cXML.zip -> Complete download in ZIP format (cXML User’s guide, DTD, and examples) http://xml.cxml.org/current/Fulfill.zip -> Complete download in ZIP format (Add on for ShipNoticeRequest/ConfirmationRequest, DTD, and examples)
Only the elements and attributes present in this example are supported by GSA. <?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.024/cXML.dtd" >
Only the elements and attributes present in this example are supported by GSA. <?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.024/cXML.dtd" >
Only the elements and attributes present in this example are supported by GSA. <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE cXML SYSTEM "http://xml.cXML.org/schemas/cXML/1.2.024/Fulfill.dtd">