Difference between revisions of "ATOM Feed FAQ"

From FPDS-NG
Line 5: Line 5:
 
=Where can I find all the data elements in the atom feed?=
 
=Where can I find all the data elements in the atom feed?=
  
−
Here are the URLs that show the data elements in the data feed for different versions.  
+
Below are URLs that display the data elements within sample data feeds for different versions.  
 +
 
 +
<h3><u>FPDS</u></h3>
  
 
https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4
 
https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4
Line 22: Line 24:
  
 
https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.5.1
 
https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.5.1
 +
 +
https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.5.2
 +
 +
<h3><u>FAADC</u></h3>
 +
 +
https://www.fpds.gov/wiki/index.php/FAADC_Atom_Feed_Specifications_V_1.0
 +
 +
https://www.fpds.gov/wiki/index.php/FAADC_Atom_Feed_Specifications_V_1.1
  
 
=How do we fetch deleted contracts?=
 
=How do we fetch deleted contracts?=
Line 37: Line 47:
  
 
=Do I need an FPDS account to use atom feed?=
 
=Do I need an FPDS account to use atom feed?=
−
The atom feed is for public use so no account is required. If you are a DOD user please go to www.fsd.gov or call (866) 606-8220.
+
The atom feed is for public use so no account is required. If you are a user that needs access to DoD or FAADC feeds, please go to www.fsd.gov or call (866) 606-8220 to request an Authenticated ATOM Feed account.
  
 
=Atom feed is updated on a daily basis. What data element should I use to extract the contracts?=
 
=Atom feed is updated on a daily basis. What data element should I use to extract the contracts?=
  
−
Use the last modified date, different search criteria is available in the URL below with examples
+
Use the 'Last Modified Date' filter. For the Public and DoD feeds, different search criteria is available with examples in the URL below:
  
 
https://www.fpds.gov/wiki/index.php/Atom_Feed_Usage
 
https://www.fpds.gov/wiki/index.php/Atom_Feed_Usage
Line 47: Line 57:
 
=What are the basic differences between the Atom Feed versions?=
 
=What are the basic differences between the Atom Feed versions?=
  
−
V 1.4 - The initial version of the Atom Feed with the XML samples for Award, IDV, OT Award and OT Agreement are provided.
+
<h3><u>FPDS</u></h3>
 +
 
 +
<u>V 1.4</u> - The initial version of the Atom Feed with the XML samples for Award, IDV, OT Award and OT Agreement are provided.
  
−
V 1.4.1 - Cumulative Dollars Obligated, Base and Exercised Options Value and Base and All Options Value, US Government Entity, Alaskan Native Servicing Institution and Native Hawaiian Servicing Institution have been added.
+
<u>V 1.4.1</u>- Cumulative Dollars Obligated, Base and Exercised Options Value and Base and All Options Value, US Government Entity, Alaskan Native Servicing Institution and Native Hawaiian Servicing Institution have been added.
  
−
V 1.4.2 - Women Owned Small Business, Economically Disadvantaged Women Owned Small Business, Joint Venture Women Owned Small Business and Joint Venture Economically Disadvantaged Women Owned Small Business have been added.
+
<u>V 1.4.2</u> - Women Owned Small Business, Economically Disadvantaged Women Owned Small Business, Joint Venture Women Owned Small Business and Joint Venture Economically Disadvantaged Women Owned Small Business have been added.
  
−
V 1.4.3 - Department ID and Name have been added in the "contractingOfficeAgencyID" and "fundingRequestingAgencyID" tags, Region Code has been added in the "contractingOfficeID" tag, Part 8 or Part 13 has been added in the "contractActionType" tag and Product or Service Type has been added in the "productOrServiceCode" tag.
+
<u>V 1.4.3</u> - Department ID and Name have been added in the "contractingOfficeAgencyID" and "fundingRequestingAgencyID" tags, Region Code has been added in the "contractingOfficeID" tag, Part 8 or Part 13 has been added in the "contractActionType" tag and Product or Service Type has been added in the "productOrServiceCode" tag.
  
−
V 1.4.4 - The "inherentlyGovernmentalFunction description" tag has been added in the "Contract Data" section.
+
<u>V 1.4.4</u> - The "inherentlyGovernmentalFunction description" tag has been added in the "Contract Data" section.
  
−
V 1.4.5 – “Approved By” and "Approved Date” tags added in the “Transaction Information” section.  “Referenced IDV Type,” “Referenced IDV Multiple or Single,” and “Referenced IDV Part 8 or Part 13” tags added in the “Contract Data” section. "Cage Code" added in the "Vendor DUNS Information" section.
+
<u>V 1.4.5</u> – “Approved By” and "Approved Date” tags added in the “Transaction Information” section.  “Referenced IDV Type,” “Referenced IDV Multiple or Single,” and “Referenced IDV Part 8 or Part 13” tags added in the “Contract Data” section. "Cage Code" added in the "Vendor DUNS Information" section.
  
−
V 1.5.0 - Several new fields have been added to the Atom feeds.  
+
<u>V 1.5.0</u> - Several new fields have been added to the Atom feeds.  
  
 
Transaction Information
 
Transaction Information
Line 83: Line 95:
 
  - The tag "Maximum Order Limit" has been changed to "Individual Order / Call Limit"
 
  - The tag "Maximum Order Limit" has been changed to "Individual Order / Call Limit"
  
−
V 1.5.1 - "Country of Contracting Office" has been added to the Purchaser Information section. "HUBZone Joint Venture" has been added to the Vendor Certifications section. "Solicitation Date" has been added as "genericString01" under the Generic Tags section.
+
<u>V 1.5.1</u> - "Country of Contracting Office" has been added to the Purchaser Information section. "HUBZone Joint Venture" has been added to the Vendor Certifications section. "Solicitation Date" has been added as "genericString01" under the Generic Tags section.
 +
 
 +
<u>V 1.5.2</u> – Several new fields and updates have been added to the Atom feeds.
 +
 
 +
<ul>
 +
<li>A new 'entityIdentifiers' tag has been created, to display entity UEI (DUNS) and UEI (SAM) information.</li>
 +
<ul>
 +
<li>The ‘vendorDUNSInformation’ tag has been moved into this parent tag.</li>
 +
<li>A new ‘vendorUEIInformation’ tag and associated UEI element tags have been created.</li>
 +
<li>The ‘cageCode’ tag has been moved beneath the ‘vendorUEIInformation’ tag. This tag was previously located within the ‘vendorDUNSInformation’ tag.</li>
 +
</ul>
 +
<li>A new 'entityDataSource' tag has been created.</li>
 +
<li>A generic string tag, ‘genericString02,’ shall be used to populate UEI.</li>
 +
</ul>
 +
 
 +
 
 +
The new fields and corresponding tag are listed for reference below.
 +
 +
<b>Vendor section</b>
 +
- Entity Data Source: <entityDataSource>
 +
- Unique Entity ID (SAM): <UEI>
 +
- UEI Legal Business Name: <UEILegalBusinessName>
 +
- Immediate Parent UEI: <immediateParentUEI>
 +
- Immediate Parent UEI Name: <immediateParentUEIName>
 +
- Domestic Parent UEI: <domesticParentUEI>
 +
- Domestic Parent UEI Name: <domesticParentUEIName>
 +
- Ultimate Parent UEI: <ultimateParentUEI>
 +
- Ultimate Parent UEI Name: <ultimateParentUEIName>
 +
 
 +
<b>Generic Tag section</b><br>
 +
- Unique Entity ID (SAM): <genericString02>
 +
 
 +
 
 +
<h3><u>FAADC</u></h3>
 +
 
 +
<u>V 1.0</u> - The initial version of the FAADC Atom Feed. XML Samples for Assistance Award and Assistance Deleted can be found in the V1.0 Specifications link mentioned above.
 +
 
 +
<u>V 1.1</u> – Several new fields and updates have been added to the FAADC Atom feeds.
 +
 
 +
<ul>
 +
<li>A new “Entity Identifiers” tag has been created, to display entity UEI (DUNS) and UEI (SAM) information.</li>
 +
<ul>
 +
<li>The ‘vendorDUNSInformation’ tag has been moved into this parent tag.</li>
 +
<li>A new ‘vendorUEIInformation’ tag and associated UEI element tags have been created.</li>
 +
<li>The ‘cageCode’ tag has been moved beneath the ‘vendorUEIInformation’ tag. This tag was previously located within the ‘vendorDUNSInformation’ tag.</li>
 +
</ul>
 +
<li>A new 'entityDataSource' tag has been created.</li>
 +
<li>A set of generic tags has been created.</li>
 +
</ul>
 +
 
 +
 
 +
The new fields are listed below for reference:
 +
 +
<b>Vendor section</b>
 +
- Entity Data Source: <entityDataSource>
 +
- Unique Entity ID (SAM): <UEI>
 +
- UEI Legal Business Name: <UEILegalBusinessName>
 +
- Immediate Parent UEI: <immediateParentUEI>
 +
- Immediate Parent UEI Name: <immediateParentUEIName>
 +
- Domestic Parent UEI: <domesticParentUEI>
 +
- Domestic Parent UEI Name: <domesticParentUEIName>
 +
- Ultimate Parent UEI: <ultimateParentUEI>
 +
- Ultimate Parent UEI Name: <ultimateParentUEIName>
 +
 
 +
<b>Generic Tag section</b><br>
 +
- 18 Generic String tags
 +
- 2 Generic Boolean tags
 +
- 2 Generic Float tags
 +
- 2 Generic Integer tags
  
−
12/20/19 Update:<br>
 
−
Unique Entity Identifier (UEI) fields have been added using the generic tags. The UEI field and its corresponding tag are listed for reference below.
 
  
−
UEI: genericString02<br>
+
&#42;<u><b>Note</b></u>: Future use of the blank tags will be decided by the executive governance working group. The CWS will have to be certified to ensure that the new generic tags can be sent.
−
Immediate Parent UEI: genericString03<br>
 
−
Domestic Parent UEI: genericString04<br>
 
−
Global Parent UEI: genericString05<br>
 

Revision as of 18:35, 3 May 2021


You must click here for very important D&B information.

Where can I find all the data elements in the atom feed?

Below are URLs that display the data elements within sample data feeds for different versions.

FPDS

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4.1

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4.2

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4.3

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4.4

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.4.5

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.5.0

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.5.1

https://www.fpds.gov/wiki/index.php/Atom_Feed_Specifications_V_1.5.2

FAADC

https://www.fpds.gov/wiki/index.php/FAADC_Atom_Feed_Specifications_V_1.0

https://www.fpds.gov/wiki/index.php/FAADC_Atom_Feed_Specifications_V_1.1

How do we fetch deleted contracts?

The URL below will fetch the deleted contracts.

https://www.fpds.gov/ezsearch/FEEDS/ATOM?FEEDNAME=DELETED&q=

Would pulling thousands of records at a time be a problem for the atom feed?

Pulling 10K records per search in the limit for Atom Feed would not be feasible. 1 atom feed thread is limited to pull only 10 records per search, however, you can run 10 threads per search, so technically you would be able to pull 100 records per search

What time of day is good to schedule atom feed downloads?

Any time after 9:00 AM eastern time.

Do I need an FPDS account to use atom feed?

The atom feed is for public use so no account is required. If you are a user that needs access to DoD or FAADC feeds, please go to www.fsd.gov or call (866) 606-8220 to request an Authenticated ATOM Feed account.

Atom feed is updated on a daily basis. What data element should I use to extract the contracts?

Use the 'Last Modified Date' filter. For the Public and DoD feeds, different search criteria is available with examples in the URL below:

https://www.fpds.gov/wiki/index.php/Atom_Feed_Usage

What are the basic differences between the Atom Feed versions?

FPDS

V 1.4 - The initial version of the Atom Feed with the XML samples for Award, IDV, OT Award and OT Agreement are provided.

V 1.4.1- Cumulative Dollars Obligated, Base and Exercised Options Value and Base and All Options Value, US Government Entity, Alaskan Native Servicing Institution and Native Hawaiian Servicing Institution have been added.

V 1.4.2 - Women Owned Small Business, Economically Disadvantaged Women Owned Small Business, Joint Venture Women Owned Small Business and Joint Venture Economically Disadvantaged Women Owned Small Business have been added.

V 1.4.3 - Department ID and Name have been added in the "contractingOfficeAgencyID" and "fundingRequestingAgencyID" tags, Region Code has been added in the "contractingOfficeID" tag, Part 8 or Part 13 has been added in the "contractActionType" tag and Product or Service Type has been added in the "productOrServiceCode" tag.

V 1.4.4 - The "inherentlyGovernmentalFunction description" tag has been added in the "Contract Data" section.

V 1.4.5 – “Approved By” and "Approved Date” tags added in the “Transaction Information” section. “Referenced IDV Type,” “Referenced IDV Multiple or Single,” and “Referenced IDV Part 8 or Part 13” tags added in the “Contract Data” section. "Cage Code" added in the "Vendor DUNS Information" section.

V 1.5.0 - Several new fields have been added to the Atom feeds.

Transaction Information 

- Closed Status
- Closed Date
- Closed By

Legislative Mandates 

- Additional Reporting
- The tag "Walsh-Healey Act" has been changed to "Materials, Supplies, Articles, & Equipment"
- The tag "Service Contract Act" has been changed to "Labor Standards"
- The tag "Davis-Bacon Act" has been changed to "Construction Wage Rate Requirements"

Total Dollar Values 

- Total Estimated Order Value

Competition Information 

- IDV Type of Set Aside
- Type of Set Aside Source
- IDV Number of Offers Received
- Number of Offers Source

NASA Specific Elements 

- CFDA Program Identification Number
- Non-Federal Funding Amount

Contract Marketing Data 

- The tag "Maximum Order Limit" has been changed to "Individual Order / Call Limit"

V 1.5.1 - "Country of Contracting Office" has been added to the Purchaser Information section. "HUBZone Joint Venture" has been added to the Vendor Certifications section. "Solicitation Date" has been added as "genericString01" under the Generic Tags section.

V 1.5.2 – Several new fields and updates have been added to the Atom feeds.

  • A new 'entityIdentifiers' tag has been created, to display entity UEI (DUNS) and UEI (SAM) information.
    • The ‘vendorDUNSInformation’ tag has been moved into this parent tag.
    • A new ‘vendorUEIInformation’ tag and associated UEI element tags have been created.
    • The ‘cageCode’ tag has been moved beneath the ‘vendorUEIInformation’ tag. This tag was previously located within the ‘vendorDUNSInformation’ tag.
  • A new 'entityDataSource' tag has been created.
  • A generic string tag, ‘genericString02,’ shall be used to populate UEI.


The new fields and corresponding tag are listed for reference below.

Vendor section 

- Entity Data Source: <entityDataSource>
- Unique Entity ID (SAM): <UEI>
- UEI Legal Business Name: <UEILegalBusinessName>
- Immediate Parent UEI: <immediateParentUEI>
- Immediate Parent UEI Name: <immediateParentUEIName>
- Domestic Parent UEI: <domesticParentUEI>
- Domestic Parent UEI Name: <domesticParentUEIName>
- Ultimate Parent UEI: <ultimateParentUEI>
- Ultimate Parent UEI Name: <ultimateParentUEIName>

Generic Tag section

- Unique Entity ID (SAM): <genericString02>


FAADC

V 1.0 - The initial version of the FAADC Atom Feed. XML Samples for Assistance Award and Assistance Deleted can be found in the V1.0 Specifications link mentioned above.

V 1.1 – Several new fields and updates have been added to the FAADC Atom feeds.

  • A new “Entity Identifiers” tag has been created, to display entity UEI (DUNS) and UEI (SAM) information.
    • The ‘vendorDUNSInformation’ tag has been moved into this parent tag.
    • A new ‘vendorUEIInformation’ tag and associated UEI element tags have been created.
    • The ‘cageCode’ tag has been moved beneath the ‘vendorUEIInformation’ tag. This tag was previously located within the ‘vendorDUNSInformation’ tag.
  • A new 'entityDataSource' tag has been created.
  • A set of generic tags has been created.


The new fields are listed below for reference:

Vendor section 

- Entity Data Source: <entityDataSource>
- Unique Entity ID (SAM): <UEI>
- UEI Legal Business Name: <UEILegalBusinessName>
- Immediate Parent UEI: <immediateParentUEI>
- Immediate Parent UEI Name: <immediateParentUEIName>
- Domestic Parent UEI: <domesticParentUEI>
- Domestic Parent UEI Name: <domesticParentUEIName>
- Ultimate Parent UEI: <ultimateParentUEI>
- Ultimate Parent UEI Name: <ultimateParentUEIName>

Generic Tag section

- 18 Generic String tags
- 2 Generic Boolean tags
- 2 Generic Float tags
- 2 Generic Integer tags


*Note: Future use of the blank tags will be decided by the executive governance working group. The CWS will have to be certified to ensure that the new generic tags can be sent.

Retrieved from "https://fpds.gov/wiki/index.php?title=ATOM_Feed_FAQ&oldid=4814"