From f2f20da9e629e2f5e3623d66bbe49f5e0cc32e5f Mon Sep 17 00:00:00 2001 From: kcho01 <49658475+kcho01@users.noreply.github.com> Date: Wed, 2 Oct 2019 09:54:25 -0400 Subject: [PATCH 001/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 742c8897d..90aa025ff 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -2939,7 +2939,7 @@ reason | string | | Yes | Reason for revision Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ -Reason | string | | Yes | Reason for cancelation +reason | string | | Yes | Reason for cancelation requestType | string | cancel_request | Yes | Type of request description | string | | Yes | Description for cancelation From 14e65b59caf74e26baf2dc2dbb255604c41da093 Mon Sep 17 00:00:00 2001 From: kcho01 <49658475+kcho01@users.noreply.github.com> Date: Thu, 3 Oct 2019 12:24:39 -0400 Subject: [PATCH 002/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index cf997e5a4..6f71ff6c6 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -13,7 +13,7 @@ The Opportunity Management SOAP APIs will allow authorized users to submit and r ## Web Services
Description Language (WSDL) To view the WSDL for all available methods and object definitions, refer below links: -* Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/services.wsdl
Download +* Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fbo.wsdl * Beta WSDL Link: Coming Soon ## SOAP Web Services Workflow Chart From dfa4f8bd0f997dabb4977f34ee79246312346274 Mon Sep 17 00:00:00 2001 From: kcho01 <49658475+kcho01@users.noreply.github.com> Date: Thu, 3 Oct 2019 14:51:29 -0400 Subject: [PATCH 003/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 90aa025ff..ec8310810 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -1094,7 +1094,7 @@ _NA_ ------- | ------- **Request Type** | POST -**URL** | /opps/v1/opportunities/{opportunityId}/requests +**URL** | /opps/v1/api/{opportunityId}/requests **Summary** | Deletes all the versions or latest version of a notice **Consumes** | application/json **Produces** | JSON @@ -2395,7 +2395,7 @@ N/A ------- | ------- **Request Type** | GET -**URL** | /v1/opportunities/access/{opportunityId}/accessRequest +**URL** | /opps/v1/api/opportunities/access/{opportunityId}/accessRequest **Summary** | Summary Get Authorized Party list for the explicit access requests submitted to an Opportunity **Consumes** | application/json **Produces** | JSON @@ -2475,7 +2475,7 @@ Examples ------- | ------- **Request Type** | POST -**URL** | /v1/opportunities/access/{opportunityId}/accessRequest +**URL** | /opps/v1/api/opportunities/access/{opportunityId}/accessRequest **Summary** | Add a Vendor as an Authorized Party for a notice to grant access to all the secured attachments across all the versions . This API will create and approve the request for the vendor. **Consumes** | application/json **Produces** | JSON From e72a178436d2af2b9f1a3fa224f190a4fbee3cad Mon Sep 17 00:00:00 2001 From: kcho01 <49658475+kcho01@users.noreply.github.com> Date: Thu, 3 Oct 2019 15:35:02 -0400 Subject: [PATCH 004/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index ec8310810..c9feb0645 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -522,7 +522,7 @@ Examples ------- | ------- **Request Type** | POST -**URL** | /opps/v1/opportunities/createAndPublish +**URL** | /opps/v1/api/createAndPublish **Summary** | Creates and publishes contract opportunity; JSON same as Create and Update API **Consumes** | application/json **Produces** | JSON From 3d4d91d66aa1ba7a2ad7f76e7fd9c7ac4349ab3a Mon Sep 17 00:00:00 2001 From: kcho01 <49658475+kcho01@users.noreply.github.com> Date: Wed, 9 Oct 2019 11:31:18 -0400 Subject: [PATCH 005/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index c9feb0645..7d35d724d 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -1154,7 +1154,6 @@ api_key | query | string | Yes | Valid System Account API Key archivedFrom | query | date-time | No | Archive From UTC Date and Time
Example: 2018-11-01 00:00:00 archivedTo | query | date-time | No | Archive To UTC Date and Time
Example: 2018-11-01 00:00:00 awardNumber | query | string | No | Award Number -cancelled (will be deprecated) | query | boolean | No | True or false doNumber | query | string | No | Delivery Order Number includeCount | query | boolean | No | True or false keyword | query | string | No | Enter any keyword from the description @@ -1172,7 +1171,7 @@ responseTo | query | date-time | No | ResponseTo UTC Date and Time
Example size | query | integer | No | Size limit is 10 by default solNumber | query | string | No | Solicitation Number sortBy | query | string | No | Sort (-createdOn, -modifiedOn) -status (To be updated) | query | Array[string] | No | 1.status= active (published, unarchive and uncancelled records)
2.status=inactive (published, archive and uncancelled records)
3.status=draft (draft records)
4.status=published (published and unarchive)
5.status=active_cancelled(published, unarchive and cancelled records)
6.status=inactive_cancelled(published, archive and cancelled records)
7. status=archived(published and archived)
(comma separated) +status| query | Array[string] | No | Active - All Published Active Notice
Draft - All Draft Notice
Published - All Published Notice
Inactive - All archived/Inactive Notice (before archive)
Cancelled - All Cancelled Notice
(comma separated)

Back to top

@@ -3335,6 +3334,6 @@ Date | Version | Description 8/19/2019 | v0.72 | API Names Updated
Valid File Types Updated 8/29/2019| v0.73| Error Codes Added 8/29/2019| v0.74| Updated the missing description for explicitAccess field in Update Attachment Contract JSON - +10/9/2019 | v0.75| Get List of Opportunities API Parameter Changes (cancelled field removed/status field updated)

Back to top

From 293da9d40a4f0e30039909f9a32d833449ef16b5 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Thu, 17 Oct 2019 10:53:35 -0400 Subject: [PATCH 006/149] Update get-opportunities-public-api.md --- _apidocs/get-opportunities-public-api.md | 34 ++++++++++++++++++++++-- 1 file changed, 32 insertions(+), 2 deletions(-) diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index bb057dcd4..0ec2dbed4 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -87,6 +87,35 @@ additionalInfoLink| Any additional info link if available for the opportunity |S uiLink |Direct UI link to the opportunity. To view the opportunity on UI, user must have either a contracting officer or a Contracting Specialist role. If user hits the link without logging in, user is directed to 404 not found page | String links |Every record in a response has this links array consisting of:
rel: self
href: link to the specific opportunity itself. User should provide an API key to access the opportunity directly

Also, every response has a master links array consisting of:
rel: self
href: link to the actual request. User should provide an API key to access the request| Array +#### Set-Aside Values +Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. + +Refer below table for valid Set-Aside values: + +Code | SetAside Values +-----|----------------- +1000 | FAR Set-Aside/Sole Source +1000001 | Total Small Business Set-Aside (FAR 19.5) +1000002 | Partial Small Business Set-Aside (FAR 19.5) +1000003 | 8(a) Set-Aside (FAR 19.8) +1000004 | 8(a) Sole Source (FAR 19.8) +1000005 | Historically Underutilized Business (HUBZone) Set-Aside (FAR 19.13) +1000006 | Historically Underutilized Business (HUBZone) Sole Source (FAR 19.13) +1000007 | Service-Disabled Veteran-Owned Small Business (SDVOSB) Set-Aside (FAR 19.14) +1000008 | Service-Disabled Veteran-Owned Small Business (SDVOSB) Sole Source (FAR 19.14) +1000009 | Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15) +1000010 | Women-Owned Small Business (WOSB) Program Sole Source (FAR 19.15) +1000011 | Economically Disadvantaged WOSB (EDWOSB) Program Set-Aside (FAR 19.15) +1000012 | Economically Disadvantaged WOSB (EDWOSB) Program Sole Source (FAR 19.15) +1000013 | Local Area Set-Aside (FAR 26.2) +2000 | Agency Specific Set-Aside/Sole Source (per FAR supplement) +2000001 | Indian Economic Enterprise (IEE) Set-Aside (specific to Department of Interior) +2000002 | Indian Small Business Economic Enterprise (ISBEE) Set-Aside (specific to Department of Interior) +2000003 | Buy Indian Set-Aside (specific to Department of Health and Human Services, Indian Health Services) +2000004 | Veteran-Owned Small Business Set-Aside (specific to Department of Veterans Affairs) +2000005 | Veteran-Owned Small Business Sole source (specific to Department of Veterans Affairs) + + ## Examples ### Example 1: Search opportunities for the given date @@ -398,7 +427,8 @@ User clicks on the description link available in the response and description co Date | Version | Description ------|---------------|--------- -5/20 | v1.0 | Base Version -8/6 | v1.1| Format updated +5/20/19 | v1.0 | Base Version +8/6/19 | v1.1| Format updated +10/17/19 | v1.2| Added Set-Aside Code

Back to top

From bbcfa19824b35905656645c56c0ddfc5f99e5d5c Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Thu, 17 Oct 2019 15:23:10 -0400 Subject: [PATCH 007/149] Update get-opportunities-public-api.md --- _apidocs/get-opportunities-public-api.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index 0ec2dbed4..96794f93e 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -90,6 +90,8 @@ links |Every record in a response has this links array consisting of:
rel: #### Set-Aside Values Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. +Only one Set-Aside value is accepted in the field at this time + Refer below table for valid Set-Aside values: Code | SetAside Values From adb90904abdd69546f8f563d240f54f17427d1a3 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Thu, 17 Oct 2019 15:23:12 -0400 Subject: [PATCH 008/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 7d35d724d..4aa642ea6 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -117,6 +117,8 @@ The API includes specific methods to submit each of the base notice types (i.e. #### Set-Aside Values Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. +Only one Set-Aside value is accepted in the field at this time + Refer below table for valid Set-Aside values: Code | SetAside Values From c5c806e6e852731e5988a4cc14d7583bea31156b Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Fri, 18 Oct 2019 13:31:06 -0400 Subject: [PATCH 009/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 31 ------------------------------- 1 file changed, 31 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 4aa642ea6..87a320b70 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -77,7 +77,6 @@ Download Metadata for All Attachments by Oppoprtunity ID |Yes |Yes |Yes Get Attachment | Yes | Yes | Yes Get IVL | Yes | Yes | Yes IVL settings | Yes | Yes | Yes -Delete Vendor | Yes | Yes | Yes Get Authorized Party | Yes | Yes | No Add Authorized Party | Yes | Yes | No Check Unique Solicitation Number | Yes | Yes | Yes @@ -2361,36 +2360,6 @@ Examples

Back to top

-### Delete Vendor - - -------- | ------- -**Request Type** | DELETE -**URL** | /v2/opportunities/{opportunityId}/ivl/{entityid} -**Summary** | Delete Vendor from IVL for Opportunity ID -**Consumes** | Request Parameters -**Produces** | JSON - -Request Parameters - -Parameter Name | Parameter Type | Data Type | Required | Description ----------------|----------------|------------|----------|------------ -Authorization | Header | string | Yes | Valid and authorized user ID -api_key | query | string | Yes | Valid System Account API Key -opportunityId | query | string | Yes | Opportunity ID -entityid | query | string | Yes | DUNS number for the business entity - -Responses - -HTTP Status Code | Response Type | Reason | Description ------------------|---------------|---------|------------ -204 | string | Vendor successfully deleted | NA - -Examples - -N/A - -

Back to top

### Get Authorized Party ### From f90a88bfaa538e1cb6c50343d29073dfa9692e57 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Tue, 22 Oct 2019 13:42:06 -0400 Subject: [PATCH 010/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 87a320b70..c8ef6b504 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -14,7 +14,7 @@ The Opportunity Management API will allow authorized users to submit and request ## Getting Started Opportunity Management API can be accessed from Beta or Alpha via the following endpoints: -* Beta: https://api.sam.gov/prod/opportunity (Coming Soon) +* Beta: https://api.sam.gov/prod/opportunity * Alpha: https://api-alpha.sam.gov/prodlike/opportunity **REST API Workflow Chart** From a804a22f1fa687565eab5a227f86ec483ce72b07 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Tue, 22 Oct 2019 13:42:08 -0400 Subject: [PATCH 011/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index 6f71ff6c6..b92845356 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -13,8 +13,8 @@ The Opportunity Management SOAP APIs will allow authorized users to submit and r ## Web Services
Description Language (WSDL) To view the WSDL for all available methods and object definitions, refer below links: -* Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fbo.wsdl -* Beta WSDL Link: Coming Soon +* Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/fboendpoint/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fboendpoint/fbo.wsdl +* Beta WSDL Link: ## SOAP Web Services Workflow Chart To view the current workflow of SOAP web service, refer below file: @@ -66,10 +66,6 @@ The complex type definition for this object (AuthenticationData) is located in t The authentication namespace must match for a web service call to be successful. This is due to core settings for the web services internals where the authorization header validates the namespace against the WSDL. So, when the namespace for your authentication header in soap xml does not match the namespace defined in the WSDL at the endpoint (in this case sam), it does not pass on the credentials (username/password/emailid). Therefore, the Contract Opportunities service is not able to authenticate the user and returns an authentication error. -* Test Server Namespace: https://www.sam.gov - -* Production Server Namespace: https://www.sam.gov - ## Method Overview All methods available can be found in the WSDL and will be listed in this document. Methods will take different parameters ranging from basic types (string/integer/boolean/date and array of these types) or complex data types that are further comprised of these basic types and sometimes other complex data types. Supported input content type formats are text/xml. From 120113b713dc77315e59f535562f6d8a8c92e628 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Tue, 22 Oct 2019 14:25:56 -0400 Subject: [PATCH 012/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index c8ef6b504..a3b9541a0 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -2779,7 +2779,7 @@ placeOfPerformance.
country.name | string | | No | No | Pop Country name placeOfPerformance.zip | string | | No | No | Pop Country zip archive | JSON | NA | NA | NA | archive.type | string | auto15, auto30, autocustom | No | Yes | Archive Type -archive.date | date | | No | Yes (if archive.type=
autocustom) | Archive Date +archive.date | date | | No (Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided) | Yes (if archive.type=autocustom OR Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided ) | Archive Date permissions | JSON | NA | NA | NA | permissions.ivl | JSON | NA | NA | NA | permissions.ivl.create | boolean | | No | No | permissions.ivl.create @@ -2789,7 +2789,7 @@ permissions.ivl.delete | boolean | Not In Use | Not In Use | Not In Use | Not In solicitation | JSON | NA | NA | NA | solicitation.setAside | string | See Set-Aside values table | No | No | setAside solicitation.deadlines | JSON | NA | NA | NA | -solicitation.
deadlines.response | date | YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o)
2) Yes (when archive.type=
auto1) | Deadline Date +solicitation.
deadlines.response | date | YYYY-MM-DDTHH:MM:SS-05:00 | No (Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided) | 1) Yes (for type=k,o)
2) Yes (when archive.type=auto1)
3) Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided | Deadline Date solicitation.deadlines.
responseresponseTz | string | | No | No | Time Zone for
Solicitation Deadline Date award | JSON | NA | NA | NA | award.date | date | YYYY-MM-DD |No | Yes only for type= a | Award Date @@ -3306,5 +3306,5 @@ Date | Version | Description 8/29/2019| v0.73| Error Codes Added 8/29/2019| v0.74| Updated the missing description for explicitAccess field in Update Attachment Contract JSON 10/9/2019 | v0.75| Get List of Opportunities API Parameter Changes (cancelled field removed/status field updated) - +10/22/2019 | v0.76| Create and Publish JSON field for Archive.Date and Response Date updated
Production Link Updated
API URLs updated

Back to top

From d9900a43d8e036b30b759919a483e928190904e3 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 09:17:36 -0400 Subject: [PATCH 013/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index b92845356..c5062b35b 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -14,7 +14,7 @@ The Opportunity Management SOAP APIs will allow authorized users to submit and r ## Web Services
Description Language (WSDL) To view the WSDL for all available methods and object definitions, refer below links: * Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/fboendpoint/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fboendpoint/fbo.wsdl -* Beta WSDL Link: +* Beta WSDL Link: https://api.sam.gov/prod/ws/fboendpoint/services.wsdl or https://api.sam.gov/prod/ws/fboendpoint/fbo.wsdl ## SOAP Web Services Workflow Chart To view the current workflow of SOAP web service, refer below file: From e6a409c39dbb67d9fce1e11e9fa0e24250b28f12 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 10:17:51 -0400 Subject: [PATCH 014/149] Update get-opportunities-public-api.md --- _apidocs/get-opportunities-public-api.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index 96794f93e..8c4e0a037 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -5,7 +5,13 @@ banner-heading: Beta.SAM.Gov Get Opportunities Public API ## Overview -Get Opportunities API provides all the published opportunity details based on the request parameters. This API supports pagination as needed. If pagination is requested, then the response will be provided to users synchronously else the call will be asynchronous. +Get Opportunities API provides all the published opportunity details based on the request parameters. This API supports pagination as needed. If pagination is requested, then the response will be provided to users synchronously, else the call will be asynchronous. + +This API only provides the latest active version of the opportunity. To view all version of the opportunity, please visit Data Services Section of Beta.Sam.Gov. All active notices in Beta.Sam.Gov are updated daily and all archived notices are updated on a weekly basis. + +Active Opportunities: https://beta.sam.gov/data-services?domain=Contract%20Opportunities%2Fdatagov + +Archived Opportunities: https://beta.sam.gov/data-services?domain=Contract%20Opportunities%2FArchived%20Data **API Version: v1.0** From 7602e9150d0b57c8c9af215006dddad62461f683 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 12:46:05 -0400 Subject: [PATCH 015/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index a3b9541a0..ef00de7cb 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -523,7 +523,7 @@ Examples ------- | ------- **Request Type** | POST -**URL** | /opps/v1/api/createAndPublish +**URL** | /v1/api/createAndPublish **Summary** | Creates and publishes contract opportunity; JSON same as Create and Update API **Consumes** | application/json **Produces** | JSON @@ -1095,7 +1095,7 @@ _NA_ ------- | ------- **Request Type** | POST -**URL** | /opps/v1/api/{opportunityId}/requests +**URL** | /v1/api/{opportunityId}/requests **Summary** | Deletes all the versions or latest version of a notice **Consumes** | application/json **Produces** | JSON @@ -2205,7 +2205,7 @@ ivl": [ ------- | ------- **Request Type** | GET -**URL** | /opps/v1/api/resource +**URL** | /v1/api/resource **Summary** | Download all attachments from resource ID **Consumes** | application/json **Produces** | JSON @@ -2261,7 +2261,7 @@ Examples ------- | ------- **Request Type** | GET -**URL** | /opps/v1/api/resources +**URL** | /v1/api/resources **Summary** | Download all attachments from opportunity ID **Consumes** | application/json **Produces** | JSON @@ -2365,7 +2365,7 @@ Examples ------- | ------- **Request Type** | GET -**URL** | /opps/v1/api/opportunities/access/{opportunityId}/accessRequest +**URL** | /v1/api/opportunities/access/{opportunityId}/accessRequest **Summary** | Summary Get Authorized Party list for the explicit access requests submitted to an Opportunity **Consumes** | application/json **Produces** | JSON @@ -2445,7 +2445,7 @@ Examples ------- | ------- **Request Type** | POST -**URL** | /opps/v1/api/opportunities/access/{opportunityId}/accessRequest +**URL** | /v1/api/opportunities/access/{opportunityId}/accessRequest **Summary** | Add a Vendor as an Authorized Party for a notice to grant access to all the secured attachments across all the versions . This API will create and approve the request for the vendor. **Consumes** | application/json **Produces** | JSON From 04edfdb9f103790e5587c7de0f8fdb1c557a8c1f Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:31:11 -0400 Subject: [PATCH 016/149] Update exclusions-api.md --- _apidocs/exclusions-api.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/_apidocs/exclusions-api.md b/_apidocs/exclusions-api.md index c8d461750..5cd7f9fd0 100644 --- a/_apidocs/exclusions-api.md +++ b/_apidocs/exclusions-api.md @@ -24,10 +24,9 @@ The response will be provided in the JSON format in a paginated manner. ## Getting Started -**IMPORTANT:** Please note the version number of the end point you are using as it is subject to change. Version 0.9 of the API will be deprecated in Alpha starting the evening of 8/14/19 and Version 1 will be made active. The same will occur in Beta on a date to be determined. Exclusions API can be accessed from Beta or Alpha via the following end points: -* Beta: https://api.sam.gov/prod/entity-information/v0.9/api/exclusions?api_key= < value > +* Beta: https://api.sam.gov/prod/entity-information/v1/api/exclusions?api_key= < value > * Alpha: https://api-alpha.sam.gov/prodlike/entity-information/v1/api/exclusions?api_key= < value > Generating a personal API Key: @@ -179,7 +178,7 @@ Functionality of the Exclusion API has been explained with the following example To get Individual or Special Entity Designation Exclusion records that are based off of Korea, that are not excluded by DOJ and that contain CHONG anywhere in the response. **API request:** -https://api.sam.gov/prodlike/entity-information/v0.9/api/exclusions?api_key=&classification=[Individual~Special Entity Designation] +https://api.sam.gov/prodlike/entity-information/v1/api/exclusions?api_key=&classification=[Individual~Special Entity Designation] &excludingAgencyCode=!DOJ&country=KOR&q=CHONG **User requirement:** @@ -187,7 +186,7 @@ To receive the JSON file downloadable link in the email for only exclusionDetail Firm records of type Ineligible (Proceedings Completed) or Prohibition/Restriction that are based off of Korea, China or Germany and that have a non-null ueiDUNS. **API request:** -https://api.sam.gov/prod/entity-information/v0.9/api/exclusions?api_key=&ueiDUNS=!””&q=(country=KOR OR country=CHN OR country=DEU)&classification=Firm +https://api.sam.gov/prod/entity-information/v1/api/exclusions?api_key=&ueiDUNS=!””&q=(country=KOR OR country=CHN OR country=DEU)&classification=Firm &exclusionType=[Ineligible (Proceedings Completed)~Prohibition/Restriction]&includeSections=exclusionDetails,exclusionIdentification,exclusionAddress&format=JSON &emailId= < a valid email address > @@ -211,5 +210,8 @@ Date | Version | Description ------|---------------|--------- 06/03/2019 | v1.0 | Base Version 08/15/2019 | v1.1 | * Added Beta.SAM.Gov to the page title.

*Updated the Alpha endpoint to v1.

*Added Secondary Address fields. +09/25/2019 | v1.2 | Beta endpoints for public FOUO and Sensitive API were updated from version 0.9 to version 1.0. + +

Back to top

From 4a8870b30f541f338a020585b98560c33409ac3d Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:31:14 -0400 Subject: [PATCH 017/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 56 +++++++++++++++++++---------------- 1 file changed, 30 insertions(+), 26 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index ef00de7cb..81c9cb9d3 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -114,7 +114,7 @@ The API includes specific methods to submit each of the base notice types (i.e.

Back to top

#### Set-Aside Values -Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. +Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. Use the Set-Aside codes to submit notices. Only one Set-Aside value is accepted in the field at this time @@ -122,26 +122,24 @@ Refer below table for valid Set-Aside values: Code | SetAside Values -----|----------------- -1000 | FAR Set-Aside/Sole Source -1000001 | Total Small Business Set-Aside (FAR 19.5) -1000002 | Partial Small Business Set-Aside (FAR 19.5) -1000003 | 8(a) Set-Aside (FAR 19.8) -1000004 | 8(a) Sole Source (FAR 19.8) -1000005 | Historically Underutilized Business (HUBZone) Set-Aside (FAR 19.13) -1000006 | Historically Underutilized Business (HUBZone) Sole Source (FAR 19.13) -1000007 | Service-Disabled Veteran-Owned Small Business (SDVOSB) Set-Aside (FAR 19.14) -1000008 | Service-Disabled Veteran-Owned Small Business (SDVOSB) Sole Source (FAR 19.14) -1000009 | Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15) -1000010 | Women-Owned Small Business (WOSB) Program Sole Source (FAR 19.15) -1000011 | Economically Disadvantaged WOSB (EDWOSB) Program Set-Aside (FAR 19.15) -1000012 | Economically Disadvantaged WOSB (EDWOSB) Program Sole Source (FAR 19.15) -1000013 | Local Area Set-Aside (FAR 26.2) -2000 | Agency Specific Set-Aside/Sole Source (per FAR supplement) -2000001 | Indian Economic Enterprise (IEE) Set-Aside (specific to Department of Interior) -2000002 | Indian Small Business Economic Enterprise (ISBEE) Set-Aside (specific to Department of Interior) -2000003 | Buy Indian Set-Aside (specific to Department of Health and Human Services, Indian Health Services) -2000004 | Veteran-Owned Small Business Set-Aside (specific to Department of Veterans Affairs) -2000005 | Veteran-Owned Small Business Sole source (specific to Department of Veterans Affairs) +SBA | Total Small Business Set-Aside (FAR 19.5) +SBP | Partial Small Business Set-Aside (FAR 19.5) +8A | 8(a) Set-Aside (FAR 19.8) +8AN | 8(a) Sole Source (FAR 19.8) +HZC | Historically Underutilized Business (HUBZone) Set-Aside (FAR 19.13) +HZS | Historically Underutilized Business (HUBZone) Sole Source (FAR 19.13) +SDVOSBC | Service-Disabled Veteran-Owned Small Business (SDVOSB) Set-Aside (FAR 19.14) +SDVOSBS | Service-Disabled Veteran-Owned Small Business (SDVOSB) Sole Source (FAR 19.14) +WOSB | Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15) +WOSBSS | Women-Owned Small Business (WOSB) Program Sole Source (FAR 19.15) +EDWOSB | Economically Disadvantaged WOSB (EDWOSB) Program Set-Aside (FAR 19.15) +EDWOSBSS | Economically Disadvantaged WOSB (EDWOSB) Program Sole Source (FAR 19.15) +LAS | Local Area Set-Aside (FAR 26.2) +IEE | Indian Economic Enterprise (IEE) Set-Aside (specific to Department of Interior) +ISBEE | Indian Small Business Economic Enterprise (ISBEE) Set-Aside (specific to Department of Interior) +BICiv | Buy Indian Set-Aside (specific to Department of Health and Human Services, Indian Health Services) +VSA | Veteran-Owned Small Business Set-Aside (specific to Department of Veterans Affairs) +VSS | Veteran-Owned Small Business Sole source (specific to Department of Veterans Affairs)

Back to top

@@ -290,7 +288,7 @@ Examples } }, "solicitation": { - "setAside": "10", + "setAside": "SBA", "deadlines": { "response": "2019-08-08T11:20:20-05:00" } @@ -377,7 +375,7 @@ Examples } }, "solicitation": { - "setAside": "10", + "setAside": "SBA", "deadlines": { "response": "2019-08-08" } @@ -707,7 +705,7 @@ Examples } }, "solicitation": { - "setAside": "10", + "setAside": "SBA", "deadlines": { "response": "2019-08-08T11:20:20-05:00" } @@ -800,7 +798,7 @@ Examples } }, "solicitation": { - "setAside": "10", + "setAside": "SBA", "deadlines": { "response": "2019-08-08" } @@ -2686,7 +2684,7 @@ Examples } }, "solicitation": { - "setAside": "10", + "setAside": "SBA", "deadlines": { "response": "2019-08-08" } @@ -3305,6 +3303,12 @@ Date | Version | Description 8/19/2019 | v0.72 | API Names Updated
Valid File Types Updated 8/29/2019| v0.73| Error Codes Added 8/29/2019| v0.74| Updated the missing description for explicitAccess field in Update Attachment Contract JSON +<<<<<<< HEAD 10/9/2019 | v0.75| Get List of Opportunities API Parameter Changes (cancelled field removed/status field updated) 10/22/2019 | v0.76| Create and Publish JSON field for Archive.Date and Response Date updated
Production Link Updated
API URLs updated +======= +10/10/2019 | v0.8 | Updated the Set-Aside values with the latest codes + + +>>>>>>> master

Back to top

From 1e93ab59ab9cef5a62f84f4704805a8b189fef49 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:31:16 -0400 Subject: [PATCH 018/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 85 +++++++++++++++++------------- 1 file changed, 48 insertions(+), 37 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index c5062b35b..1bf51617a 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -13,8 +13,13 @@ The Opportunity Management SOAP APIs will allow authorized users to submit and r ## Web Services
Description Language (WSDL) To view the WSDL for all available methods and object definitions, refer below links: +<<<<<<< HEAD * Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/fboendpoint/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fboendpoint/fbo.wsdl * Beta WSDL Link: https://api.sam.gov/prod/ws/fboendpoint/services.wsdl or https://api.sam.gov/prod/ws/fboendpoint/fbo.wsdl +======= +* Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/services.wsdl
+* Beta WSDL Link: Coming Soon +>>>>>>> master ## SOAP Web Services Workflow Chart To view the current workflow of SOAP web service, refer below file: @@ -86,25 +91,30 @@ messages | string [] - array of strings **Note**: Some methods will have a different response value format due to the nature of the data being returned. These custom cases will be outlined below. ### Set-Aside Values -Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. +Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. Use the Set-Aside codes to submit notices. Refer below table for mapping between legacy SetAside Values to modern SetAside Value: -Modern SetAside Values | Legacy SetAside values -------- | ------- -Total Small Business Set-Aside (FAR 19.5) | Total Small Business -Partial Small Business Set-Aside (FAR 19.5) | Partial Small Business -8(a) Set-Aside (FAR 19.8) | Competitive 8(a) -8(a) Sole Source (FAR 19.8) | Competitive 8(a) -Historically Underutilized Business (HUBZone) Set-Aside (FAR 19.13) | HUBZone -Historically Underutilized Business (HUBZone) Sole Source (FAR 19.13) | HUBZone -Service-Disabled Veteran-Owned Small Business (SDVOSB) Set-Aside (FAR 19.14) | Service-Disabled Veteran-Owned Small Business -Service-Disabled Veteran-Owned Small Business (SDVOSB) Sole Source (FAR 19.14) | Service-Disabled Veteran-Owned Small Business -Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15) | Women-Owned Small Business -Women-Owned Small Business (WOSB) Program Sole Source (FAR 19.15) | Women-Owned Small Business -Economically Disadvantaged WOSB (EDWOSB) Program Set-Aside (FAR 19.15) | Economically Disadvantaged Women-Owned Small Business -Economically Disadvantaged WOSB (EDWOSB) Program Sole Source (FAR 19.15) | Economically Disadvantaged Women-Owned Small Business -Local Area Set-Aside (FAR 26.2) | +Code | Modern SetAside Values | Legacy SetAside values +-----|------- | ------- +SBA | Total Small Business Set-Aside (FAR 19.5) | Total Small Business +SBP | Partial Small Business Set-Aside (FAR 19.5) | Partial Small Business +8A | 8(a) Set-Aside (FAR 19.8) | Competitive 8(a) +8AN | 8(a) Sole Source (FAR 19.8) | Competitive 8(a) +HZC | Historically Underutilized Business (HUBZone) Set-Aside (FAR 19.13) | HUBZone +HZS | Historically Underutilized Business (HUBZone) Sole Source (FAR 19.13) | HUBZone +SDVOSBC | Service-Disabled Veteran-Owned Small Business (SDVOSB) Set-Aside (FAR 19.14) | Service-Disabled Veteran-Owned Small Business +SDVOSBS | Service-Disabled Veteran-Owned Small Business (SDVOSB) Sole Source (FAR 19.14) | Service-Disabled Veteran-Owned Small Business +WOSB | Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15) | Women-Owned Small Business +WOSBSS | Women-Owned Small Business (WOSB) Program Sole Source (FAR 19.15) | Women-Owned Small Business +EDWOSB | Economically Disadvantaged WOSB (EDWOSB) Program Set-Aside (FAR 19.15) | Economically Disadvantaged Women-Owned Small Business +EDWOSBSS | Economically Disadvantaged WOSB (EDWOSB) Program Sole Source (FAR 19.15) | Economically Disadvantaged Women-Owned Small Business +LAS | Local Area Set-Aside (FAR 26.2) | +IEE | Indian Economic Enterprise (IEE) Set-Aside (specific to Department of Interior) | +ISBEE | Indian Small Business Economic Enterprise (ISBEE) Set-Aside (specific to Department of Interior) | +BICiv | Buy Indian Set-Aside (specific to Department of Health and Human Services, Indian Health Services) | +VSA | Veteran-Owned Small Business Set-Aside (specific to Department of Veterans Affairs) | +VSS | Veteran-Owned Small Business Sole source (specific to Department of Veterans Affairs) | ### Notice Types The web service API includes specific methods to submit each of the base notice types (i.e. presolicitation, combined/synopsis, award, etc.). You will find these outlined in the sections below. @@ -172,7 +182,7 @@ link | GovURL | No | Government Link 255 characters, consist of a restricted set email | GovEmail | No | Government Email | 128 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | -setaside | string | No | Set Aside | See Set Aside Value Section for valid values +setaside | string | No | Set-Aside code | See Set Aside Value Section for valid codes recovery_act | boolean | No | Recovery Act | True or False correction | boolean | No | Correction of previous Award | True or False
If correcting a previously submitted award notice, specify true and the system will lookup the award by award number and sol number if applicable. @@ -209,7 +219,7 @@ export_controlled | boolean | No | Export Controlled. * Captured for future JCP ### Delete Notice/ Document Package
(deleteNoticeOrDocumentPackage) -This method is used to permanently delete an entire notice or delete attachments across all versions of the notice. Modifications/Amendments are recommended instead of using this method. Specify the solicitation number or award number to delete a notice. To delete attachments, also specify the attachment deletetype. +This method is used to permanently delete a notice or delete all attachments/links for all the versions or the latest version of the notice. Modifications/Amendments are recommended instead of using this method. Specify the solicitation number or award number to delete a notice. To delete attachments, also specify the attachment deletetype. Input Parameters: @@ -230,7 +240,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions solnbr | string | Yes, if Non-Award | Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { } ntype | string | no | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation awdnbr | string | Yes, if Award| Award # | 255 characters -deletetype | string | no | Notice or Attachment delete operation type | Valid Values: “notice” for notice, “attachment” for attachment. Defaults to “notice” if not provided +deletetype | string | no | Notice or Attachment delete operation type | Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided deletemethod | string | no | Delete latest or all versions | Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided ### Archive Notice
(ArchiveNotice) @@ -328,7 +338,7 @@ link | GovURL – complex type | No | Government Link has URL & description | 25 email | GovEmail – complex type | No | Government Email | 128 characters links | DocumentLink[] | No | Array of links | files | DocumentFile[] | No | Array of files | -setaside | string | No | Set-aside | See Set Aside Values Section for valid values +setaside | string | No | Set-Aside code | See Set Aside Values Section for valid codes popaddress | string | No | Pop Add | 65535 characters popzip |string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters @@ -399,7 +409,7 @@ link | GovURL – complex type | No | Government Link | 255 characters, consist email | GovEmail – complex type | No | Government Email | 128 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | -setaside | string | No | Set-aside | See Set Aside Values section for valid values +setaside | string | No | Set-Aside code | See Set Aside Values section for valid codes popaddress | string | No | Pop Add | 65535 characters popzip | string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters @@ -471,7 +481,7 @@ link | GovURL – complex type | no | Government Link | 255 characters, consist email | GovEmail – complex type | no | Government Email | 128 characters links | DocumentLink[] | no | Array Of links | files | DocumentFile[] | no | Array of files | -setaside | string | no | Set-aside | See Set Aside Value Section for valid values +setaside | string | no | Set-Aside code | See Set Aside Value Section for valid codes popaddress | string | no | Pop Add | 65535 characters popzip | string | no | Pop Zip | 5 digits popcountry | string | no | Pop Country | 32 characters @@ -616,7 +626,7 @@ link | GovURL – complex type | No | Government Link | 255 characters, consist email | GovEmail – complex type | No | Government Email | 128 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | -setaside | string | No | Set-aside | See Set Aside Value Section +setaside | string | No | Set-Aside code | See Set Aside Value Section for valid codes popaddress | string | No | Pop Add | 65535 characters popzip | string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters @@ -823,7 +833,7 @@ link | GovURL – complex type | No | Government Link | 255 characters, consist email | GovEmail – complex type | Yes | Government Email | 128 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | -setaside | string | No | Set-aside | See Set Aside Values section for valid values +setaside | string | No | Set-Aside code | See Set Aside Values section for valid codes popaddress | string | No | Pop Add | 65535 characters popzip | string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters @@ -987,7 +997,7 @@ link| GovernmentURL| No| Government Link |255 characters, consist of a restricte email| GovernmentEmail| No| Government Email |128 characters links |DocumentLink []| no |Array Of links | files |DocumentFile[]| no| Array of files | -setaside| string| no| Set-aside types| See Set Aside Section for valid values +setaside| string| no| Set-Aside code | See Set Aside Section for valid codes popaddress| string| No| POP Address |65535 characters popzip| string |No |POP Zip |5 digits popcountry| string| Yes – For wards; No – For rest| POP Country| 32 characters @@ -1518,7 +1528,7 @@ desc| string| Main Description link| GovernmentURL |Government Link email| Government Email| Government Email files |DocumentPack ageData[]| Array of package data if applicable -setaside |string |Set-aside types +setaside |string |Set-Aside value popaddress |string |POP Address popzip |string| POP Zip popcountry| string| POP Country @@ -1673,7 +1683,7 @@ Please note that variances may exist between SOAP requests generated by differen - + SBA @@ -1771,7 +1781,7 @@ Please note that variances may exist between SOAP requests generated by differen - + SBA @@ -2685,7 +2695,7 @@ Note: This service gets a list of all notices - 1000002 + SBA 124356 Rockridge Dr Ashburn @@ -2948,7 +2958,7 @@ Note: This service gets a list of all notices - + SBA @@ -4094,7 +4104,7 @@ link| No| 255 characters, consist of a restricted set of characters (see URL spe email| Yes
No if type=Award| 128 characters| NA |NA links |No |Array of links |NA |NA files| No| Array of files| NA| NA -setaside| No| See SetAside Section for valid values| NA |NA +setaside| No| See Set-Aside Values section for valid codes| NA |NA popaddress| No| 65535 characters| This is a free Text. No validation is performed on this field | popzip |No |5 digits| NA| NA popcountry| Yes – Only Award type No – For rest |32 characters| 1. This required field should be validated for Award type only| 1. Award Details Section - Country is a required field @@ -4126,7 +4136,7 @@ link| No| 255 characters, consist of a restricted set of characters (see URL spe email | Yes
No if type=Award| 128 characters| | NA links| No| Array of links| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete files| No| Array of files| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete -setaside| No| See SetAside section for valid values |NA |NA +setaside| No| See Set-Aside Values section for valid codes |NA |NA popaddress| No| 65535 characters| This is a free Text. No validation is performed on this field | popzip| No| 5 digits| NA| NA popcountry |No| 32 characters| NA| NA @@ -4155,7 +4165,7 @@ link |No| 255 characters, consist of a restricted set of characters (see URL spe email |Yes
No if type=Award |128 characters |NA | NA links| No |Array of links| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files |No |Array of files| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete -setaside| No| See SetAside section for valid values| NA| NA +setaside| No| See Set-Aside Values section for valid codes| NA| NA popaddress| No| 65535 characters| This is a free Text. No validation is performed on this field | popzip| No| 5 digits| NA| NA popcountry| No| 32 characters |NA |NA @@ -4214,7 +4224,7 @@ link| No |255 characters, consist of a restricted set of characters (see URL spe links |No |Collection |1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete email |Yes
No if type=Award|128 characters| NA|NA -setaside| No| See SetAside section for valid values| NA| NA +setaside| No| See Set-Aside Values section for valid codes| NA| NA popaddress| No |65535 characters| NA| NA popzip |No |5 digit |NA | NA popcountry| No |32 characters| NA| NA @@ -4290,7 +4300,7 @@ link| No| 255 characters, consist of a restricted set of characters (see URL spe email| Yes
No if type=Award| 128 characters| NA| NA links| No| |1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete -setaside| No| See SetAside section for valid values| NA| NA +setaside| No| See Set-Aside Values section for valid codes| NA| NA recovery_act |No |True or False| NA| NA correction| No| True or False

If correcting a previously submitted award notice, specify true and the system will lookup the award by award number and sol number if applicable| If correction = true, system checks if an opportunity exists or not. If exists, then a new modified record will be posted of the same type and will be set as the latest. If No, then the request will be rejected | @@ -4365,7 +4375,7 @@ link |No| 255 characters, consist of a restricted set of characters (see URL spe email |Yes |128 characters |1. This field is required

2. If an invalid email address is provided, then the service throws an error | 1. Primary Contact - Email is required

2. Primary Contact - Please enter a valid Internet email address. Format: username@host.domain links| No |Array of links| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files |No |Array of files| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete -setaside| No| See SetAside section for valid values| NA| NA +setaside| No| See Set-Aside Values section for valid codes| NA| NA popaddress| No| 65535 characters| This is a free Text. No validation is performed on this field | popzip| No| 5 digits| NA| NA popcountry| No| 32 characters |NA |NA @@ -4404,7 +4414,7 @@ Element Name | Required | Character Limit / Restrictions | Business Rules | Erro solnbr| Yes if non-award| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces awdnbr| Yes if award| 255 characters| If neither solnbr or awdnbr is provided, then the system throws an error| Solicitation Number or Award Number is required ntype|No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid -deletetype| no| Valid values: “notice” to delete the notice, “attachment” to delete attachments from the notice| 1. If an invalid deletetype is provided, then service throws an error | Delete type provided is not “notice” or “attachment” +deletetype| no| Valid values: “notice” to delete the notice, “attachment” to delete attachments and links from the notice| 1. If an invalid deletetype is provided, then service throws an error | Delete type provided is not “notice” or “attachment” deletemethod| no| Valid Values: “all” to delete all versions or “latest” to delete latest version |1. If an invalid deletemethod is provided, then service throws an error | Delete method provided is not “latest” or “all” #### archiveNotice @@ -4644,5 +4654,6 @@ Date | Version | Description 8/01/2019 | v0.4 | Added the details for the Solicitation notice type and business rules for nType 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated
User Account Section Updated 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions +10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes

Back to top

From 7e2dae327c4c52247c8d93a4a53c999d841f5e02 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:31:23 -0400 Subject: [PATCH 019/149] Update sam-entity-extracts-api.md --- _apidocs/sam-entity-extracts-api.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_apidocs/sam-entity-extracts-api.md b/_apidocs/sam-entity-extracts-api.md index d2bc8e7b0..95e221862 100644 --- a/_apidocs/sam-entity-extracts-api.md +++ b/_apidocs/sam-entity-extracts-api.md @@ -90,7 +90,6 @@ Generating a System Account API Key: api_key Required element to identify API users and validate role-based access
-Example: df234124fgv8v23il4lk12l341kkl0124kc @@ -238,6 +237,8 @@ The API will return one of the following responses: ## Contact Us +* Reach out to the beta.sam.gov team at [newsamtesting@gsa.gov](mailto:newsamtesting@gsa.gov). +

Back to top

## Change Log From 0d6c8e11cea3b3d09685fd6e269bbab587923a9b Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:31:25 -0400 Subject: [PATCH 020/149] Update api-list.yml --- _data/api-list.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_data/api-list.yml b/_data/api-list.yml index e3c3dbce3..288b92fdf 100644 --- a/_data/api-list.yml +++ b/_data/api-list.yml @@ -39,7 +39,7 @@ url: https://open.gsa.gov/api/opportunities-soap-api/ - title: Code.gov API description: Provides information from Code.gov, which leverages the power of code sharing and collaboration to help the US Government cut down on duplicative software development and save millions of taxpayer dollars for the American people. - url: https://developers.code.gov + url: https://open.gsa.gov/api/codedotgov - title: Contract-Awarded Labor Category (CALC) API description: CALC's API is used by CALC's front-end Data Explorer application to display labor rate data for awarded prices on GSA services schedules, and can also be accessed by any third-party application over the public internet. CALC (Contract Awarded Labor Category) tool searches awarded hourly rate prices on the eight GSA professional services schedules and returns comparable labor categories and prices based on search criteria and filters used. url: https://calc.gsa.gov/api/docs/# From 93401c64ef9df1152167dfaa4eece81afcd41bc1 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:31:26 -0400 Subject: [PATCH 021/149] Update search.yml --- _data/search.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_data/search.yml b/_data/search.yml index af3a62d73..7f75e5ac5 100644 --- a/_data/search.yml +++ b/_data/search.yml @@ -13210,7 +13210,7 @@ - Sales - title: Code.gov API body: Provides information from Code.gov, which leverages the power of code sharing and collaboration to help the US Government cut down on duplicative software development and save millions of taxpayer dollars for the American people. - url: https://developers.code.gov + url: https://open.gsa.gov/api/codedotgov category: APIs tags: - Code From 78b123a3fd13be21e07f78e3085e8d341f24da3d Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:31:28 -0400 Subject: [PATCH 022/149] Update data.json --- data.json | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/data.json b/data.json index 115be4d52..e86b4bad5 100644 --- a/data.json +++ b/data.json @@ -1249,7 +1249,7 @@ "mediaType": "application/json", "format": "json", "title": "GSA DCOI Strategic Plan February 2019", - "description": "Under the Data Center Optimization Initiative (DCOI), covered agencies are required to post DCOI Strategic Plans and updates to their FITARA milestones publicly. Updated 11/19/2018 at 8:52 pm Eastern. Updated 05/16/2019 to change tiered closures. Updated on 06/25/2019 to change planned value. Updated on 7/11/2019 to change achieved closures. Updated on 8/5/2019 to change closures for FYs16-20", + "description": "Under the Data Center Optimization Initiative (DCOI), covered agencies are required to post DCOI Strategic Plans and updates to their FITARA milestones publicly. Updated 11/19/2018 at 8:52 pm Eastern. Updated 05/16/2019 to change tiered closures. Updated on 06/25/2019 to change planned value. Updated on 7/11/2019 to change achieved closures. Updated on 8/5/2019 to change closures for FYs16-20. Updated on 10/7/19 to reflect FY20 Achieved closure values.", "conformsTo": "https://management.cio.gov/schemaexamples/DCOI_StrategicPlans_fy2016Schema.json", "downloadURL": "https://inventory.data.gov/dataset/20d5c816-e31a-46be-81d2-abc59d0f4fdb/resource/b8d9e71b-963b-4398-8d37-04628e64871d/download/datacenteroptimizationstrategicplan.json" }, { @@ -3573,7 +3573,7 @@ "@type": "dcat:Dataset", "title": "GSA Enterprise Data Inventory (EDI)", "description": "GSA Enterprise Data Inventory (EDI)", - "modified": "2019-09-13", + "modified": "2019-10-16", "accessLevel": "public", "identifier": "GSA-2015-11-13-01", "dataQuality": true, @@ -3596,8 +3596,8 @@ "mediaType": "application/json", "format": "JSON", "title": "EDI JSON", - "description": "EDI JSON 09/13/19", - "downloadURL": "https://inventory.data.gov/dataset/acf8e47e-24d2-4e4d-a786-847643f101fd/resource/32606067-7bfa-4040-b089-f790c2c01473/download/edi-09-13-19.json" + "description": "EDI JSON 10/16/19", + "downloadURL": "https://inventory.data.gov/dataset/acf8e47e-24d2-4e4d-a786-847643f101fd/resource/32606067-7bfa-4040-b089-f790c2c01473/download/edi-10-16-19.json" } ], "keyword": ["EDI", "Enterprise Data Inventory", "GSA EDI", "JSON"], @@ -3903,7 +3903,7 @@ "@type": "dcat:Dataset", "title": "Inventory of Owned and Leased Properties (IOLP)", "description": "The Inventory of Owned and Leased Properties (IOLP) allows users to search properties owned and leased by the General Services Administration (GSA) across the United States, Puerto Rico, Guam and American Samoa.\r\n\r\nThe Owned and Leased Data Sets include the following data except where noted below for Leases:\r\n\r\n- Location Code - GSA’s alphanumeric identifier for the building \r\n- Owned or Leased - Indicates the building is Federally Owned (F) or Leased (L) \r\n- GSA Region - GSA assigned region for building location. \r\n- Street Address/City/State/Zip Code - Building Address. \r\n- Latitude and Longitude - Map coordinates of the building. \r\n- Building Rentable Square Feet - Total Rentable Square Feet in building. \r\n- Available Square Feet - Vacant Space in building. \r\n- Construction Date - Date of year built. \r\n- Congressional District - Congressional District building is located. -\r\n Senator/Representative/URL - Senator/Representative of the Congressional District and their web address.\r\n\r\nThe Leased Data set also includes the following: \r\n\r\n- Lease Number - GSA’s alphanumeric identifier for the lease. \r\n- Lease Effective Date - Date lease starts. \r\n- Lease Expiration Date - Date lease expires.", - "modified": "2019-09-13", + "modified": "2019-10-16", "accessLevel": "public", "identifier": "GSA-4495", "dataQuality": true, @@ -8218,7 +8218,7 @@ "@type": "dcat:Dataset", "title": "Real Estate Across the United States (REXUS) Inventory (Building)", "description": "Real Estate Across the United States (REXUS) is the primary tool used by PBS to track and manage the government's real property assets and to store inventory data, building data, customer data, and lease information. STAR manages aspects of real property space management, including identification of all building space and daily management of 22,000 assignments for all property to its client Federal agencies. This data set contains PBS building inventory that consists of both owned and leased buildings with active and excess status.", - "modified": "2019-09-09", + "modified": "2019-10-16", "accessLevel": "public", "identifier": "GSA-25251", "dataQuality": true, @@ -8241,7 +8241,7 @@ "mediaType": "text/csv", "format": "csv", "title": "data_gov_bldg_rexus", - "description": "September - Rexus Building file", + "description": "October - Rexus Building file", "downloadURL": "https://inventory.data.gov/dataset/04247624-1d6b-4e03-84eb-9eda1a6ea638/resource/e8972de5-310c-49e2-be42-c1089eee98fd/download/datagovbldgrexus.csv" } ], @@ -8252,7 +8252,7 @@ "@type": "dcat:Dataset", "title": "Real Estate Across the United States (REXUS) (Lease)", "description": "Real Estate Across the United States (REXUS) is the primary tool used by PBS to track and manage the government's real property assets and to store inventory data, building data, customer data, and lease information. STAR manages aspects of real property space management, including identification of all building space and daily management of 22,000 assignments for all property to its client Federal agencies. This data set contains PBS building inventory that consists of both owned and leased buildings with active and excess status.", - "modified": "2019-09-09", + "modified": "2019-10-16", "accessLevel": "public", "identifier": "GSA-25261", "dataQuality": true, @@ -8275,7 +8275,7 @@ "mediaType": "text/csv", "format": "csv", "title": "data_gov_lse_rexus", - "description": "September - Rexus Lease file", + "description": "October - Rexus Lease file", "downloadURL": "https://inventory.data.gov/dataset/2cdc97b5-3029-4ec3-b3bf-baec7948bad1/resource/dc2e6239-5c72-465d-a23e-43ee976a0910/download/datagovlserexus.csv" } ], From 39a185c90c9dea20be0a7630fe1f5faeef109b20 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:32:28 -0400 Subject: [PATCH 023/149] Update get-opportunities-public-api.md --- _apidocs/get-opportunities-public-api.md | 40 +++++++++++------------- 1 file changed, 19 insertions(+), 21 deletions(-) diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index 8c4e0a037..cf80a9059 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -94,7 +94,7 @@ uiLink |Direct UI link to the opportunity. To view the opportunity on UI, user m links |Every record in a response has this links array consisting of:
rel: self
href: link to the specific opportunity itself. User should provide an API key to access the opportunity directly

Also, every response has a master links array consisting of:
rel: self
href: link to the actual request. User should provide an API key to access the request| Array #### Set-Aside Values -Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. +Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. Use the Set-Aside codes to submit notices. Only one Set-Aside value is accepted in the field at this time @@ -102,26 +102,24 @@ Refer below table for valid Set-Aside values: Code | SetAside Values -----|----------------- -1000 | FAR Set-Aside/Sole Source -1000001 | Total Small Business Set-Aside (FAR 19.5) -1000002 | Partial Small Business Set-Aside (FAR 19.5) -1000003 | 8(a) Set-Aside (FAR 19.8) -1000004 | 8(a) Sole Source (FAR 19.8) -1000005 | Historically Underutilized Business (HUBZone) Set-Aside (FAR 19.13) -1000006 | Historically Underutilized Business (HUBZone) Sole Source (FAR 19.13) -1000007 | Service-Disabled Veteran-Owned Small Business (SDVOSB) Set-Aside (FAR 19.14) -1000008 | Service-Disabled Veteran-Owned Small Business (SDVOSB) Sole Source (FAR 19.14) -1000009 | Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15) -1000010 | Women-Owned Small Business (WOSB) Program Sole Source (FAR 19.15) -1000011 | Economically Disadvantaged WOSB (EDWOSB) Program Set-Aside (FAR 19.15) -1000012 | Economically Disadvantaged WOSB (EDWOSB) Program Sole Source (FAR 19.15) -1000013 | Local Area Set-Aside (FAR 26.2) -2000 | Agency Specific Set-Aside/Sole Source (per FAR supplement) -2000001 | Indian Economic Enterprise (IEE) Set-Aside (specific to Department of Interior) -2000002 | Indian Small Business Economic Enterprise (ISBEE) Set-Aside (specific to Department of Interior) -2000003 | Buy Indian Set-Aside (specific to Department of Health and Human Services, Indian Health Services) -2000004 | Veteran-Owned Small Business Set-Aside (specific to Department of Veterans Affairs) -2000005 | Veteran-Owned Small Business Sole source (specific to Department of Veterans Affairs) +SBA | Total Small Business Set-Aside (FAR 19.5) +SBP | Partial Small Business Set-Aside (FAR 19.5) +8A | 8(a) Set-Aside (FAR 19.8) +8AN | 8(a) Sole Source (FAR 19.8) +HZC | Historically Underutilized Business (HUBZone) Set-Aside (FAR 19.13) +HZS | Historically Underutilized Business (HUBZone) Sole Source (FAR 19.13) +SDVOSBC | Service-Disabled Veteran-Owned Small Business (SDVOSB) Set-Aside (FAR 19.14) +SDVOSBS | Service-Disabled Veteran-Owned Small Business (SDVOSB) Sole Source (FAR 19.14) +WOSB | Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15) +WOSBSS | Women-Owned Small Business (WOSB) Program Sole Source (FAR 19.15) +EDWOSB | Economically Disadvantaged WOSB (EDWOSB) Program Set-Aside (FAR 19.15) +EDWOSBSS | Economically Disadvantaged WOSB (EDWOSB) Program Sole Source (FAR 19.15) +LAS | Local Area Set-Aside (FAR 26.2) +IEE | Indian Economic Enterprise (IEE) Set-Aside (specific to Department of Interior) +ISBEE | Indian Small Business Economic Enterprise (ISBEE) Set-Aside (specific to Department of Interior) +BICiv | Buy Indian Set-Aside (specific to Department of Health and Human Services, Indian Health Services) +VSA | Veteran-Owned Small Business Set-Aside (specific to Department of Veterans Affairs) +VSS | Veteran-Owned Small Business Sole source (specific to Department of Veterans Affairs) ## Examples From 63ddeb98e0ef38e20c2c52f1098129c7c6aafc12 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:33:34 -0400 Subject: [PATCH 024/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index 1bf51617a..9d71c7779 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -16,10 +16,6 @@ To view the WSDL for all available methods and object definitions, refer below l <<<<<<< HEAD * Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/fboendpoint/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fboendpoint/fbo.wsdl * Beta WSDL Link: https://api.sam.gov/prod/ws/fboendpoint/services.wsdl or https://api.sam.gov/prod/ws/fboendpoint/fbo.wsdl -======= -* Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/services.wsdl
-* Beta WSDL Link: Coming Soon ->>>>>>> master ## SOAP Web Services Workflow Chart To view the current workflow of SOAP web service, refer below file: From cb71c2e0adcc1c74d0a9b2ac30bc7db1ad0d1581 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Wed, 23 Oct 2019 16:35:10 -0400 Subject: [PATCH 025/149] Update get-opportunities-public-api.md --- _apidocs/get-opportunities-public-api.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index cf80a9059..0717a0391 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -434,7 +434,8 @@ User clicks on the description link available in the response and description co Date | Version | Description ------|---------------|--------- 5/20/19 | v1.0 | Base Version -8/6/19 | v1.1| Format updated +8/6/19 | v1.1| Format Updated 10/17/19 | v1.2| Added Set-Aside Code +10/23/19 | v1.3| Set-Aside Values Updated

Back to top

From 17e4e863629d16c2f4168d7482e47ced68ee793a Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Thu, 24 Oct 2019 12:32:47 -0400 Subject: [PATCH 026/149] Update get-opportunities-public-api.md --- _apidocs/get-opportunities-public-api.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index 0717a0391..0241913f7 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -40,11 +40,10 @@ Request Parameters that API accepts | Description | Mandatory?| Data Type api_key | Public Key of users | Yes| String ptype | Procurement Type. Below are the available Procurement Types:
u= Justification (J&A)
p = Pre solicitation
a = Award Notice
r = Sources Sought
s = Special Notice
g = Sale of Surplus Property
k = Combined Synopsis/Solicitation
i = Intent to Bundle Requirements (DoD-Funded)

Note: Below services are now retired:
f = Foreign Government Standard
l = Fair Opportunity / Limited Sources

Use Justification (u) instead of fair Opportunity |No |String solnum| Solicitation Number| No| String +noticeid| Notice ID | No | String title| Title| No |String -description| Description| No| String postedFrom | Posted date From
Format must be MM/dd/yyyy
Note: Date range between Posted Date From and To is 1 year |Yes| String postedTo| Posted date To Format must be MM/dd/yyyy
Note: Date range between Posted Date From and To is 1 year |Yes |String -status | Status of record. Must be one of Active/Inactive/Both
Default status: Active |No| String deptname | Department Name (L1) |No| String subtier| Agency Name (L2)| No| String state| Place of Performance (State)| No |String From 3b42b82c66815cab669df44a14570dc36d9f4294 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Thu, 24 Oct 2019 15:19:36 -0400 Subject: [PATCH 027/149] Update get-opportunities-public-api.md --- _apidocs/get-opportunities-public-api.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index 0241913f7..753a74986 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -7,7 +7,7 @@ banner-heading: Beta.SAM.Gov Get Opportunities Public API Get Opportunities API provides all the published opportunity details based on the request parameters. This API supports pagination as needed. If pagination is requested, then the response will be provided to users synchronously, else the call will be asynchronous. -This API only provides the latest active version of the opportunity. To view all version of the opportunity, please visit Data Services Section of Beta.Sam.Gov. All active notices in Beta.Sam.Gov are updated daily and all archived notices are updated on a weekly basis. +**This API only provides the latest active version of the opportunity. To view all version of the opportunity, please visit Data Services Section of Beta.Sam.Gov. All active notices in Beta.Sam.Gov are updated daily and all archived notices are updated on a weekly basis.** Active Opportunities: https://beta.sam.gov/data-services?domain=Contract%20Opportunities%2Fdatagov @@ -86,8 +86,8 @@ award| Award Information (If Available):
Award amount
Awardee
Awar pointofContact| Point of Contact Information. It can have below fields if available:
Fax
Type
Email
Phone
Title
Full name |JSON description| A link to an opportunity description.
Note: To download the description, user should append the public API Key. If no description is available then, user is shown an error message “ Description not found”| String organizationType| Type of an organization – department/sub-tier/office| String -officeAddress| Office Mailing Address| String -placeOfPerformance| Place of performance information. It can have below fields if available:
Street Address
City (City code & Name)
State (State Code Only)
Country (Country Code Only)
Zip| JSON +officeAddress| Office Address Information. It can have below fields if available:
City
State
Zip| String +placeOfPerformance| Place of performance information. It can have below fields if available:
City
State
Zip| JSON additionalInfoLink| Any additional info link if available for the opportunity |String uiLink |Direct UI link to the opportunity. To view the opportunity on UI, user must have either a contracting officer or a Contracting Specialist role. If user hits the link without logging in, user is directed to 404 not found page | String links |Every record in a response has this links array consisting of:
rel: self
href: link to the specific opportunity itself. User should provide an API key to access the opportunity directly

Also, every response has a master links array consisting of:
rel: self
href: link to the actual request. User should provide an API key to access the request| Array @@ -436,5 +436,6 @@ Date | Version | Description 8/6/19 | v1.1| Format Updated 10/17/19 | v1.2| Added Set-Aside Code 10/23/19 | v1.3| Set-Aside Values Updated +10/24/19| v1.4| Office Address Description Updated

Back to top

From f813efaa706b3911a7af6e51292c00ed0a6f7bff Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Thu, 24 Oct 2019 16:08:38 -0400 Subject: [PATCH 028/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index 9d71c7779..6508aece3 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -331,7 +331,7 @@ archdate | date | No | Archive Date | YYYYMMDD contact | string | Yes | Contact Info | 65535 characters desc |string |Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link has URL & description | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | No | Government Email | 128 characters +email | GovEmail – complex type | Yes | Government Email | 128 characters links | DocumentLink[] | No | Array of links | files | DocumentFile[] | No | Array of files | setaside | string | No | Set-Aside code | See Set Aside Values Section for valid codes @@ -402,7 +402,7 @@ archdate | date | No | Archive Date | YYYYMMDD contact | string |Yes | Contact Info | 65535 characters desc | string | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | No | Government Email | 128 characters +email | GovEmail – complex type | Yes | Government Email | 128 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | setaside | string | No | Set-Aside code | See Set Aside Values section for valid codes @@ -553,7 +553,7 @@ desc | String | No | Description | 65535 characters link | GovURL | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | -email | GovEmail | No | Government Email | 128 characters +email | GovEmail | Yes | Government Email | 128 characters recovery_act | boolean | No | Recovery Act | True or False; correction | boolean | No | Correction of previous J&A | True or False
If correcting a previously submitted j&a notice, specify true and the system will lookup the j&a by award number and sol number if applicable. @@ -619,7 +619,7 @@ archdate | date | No | Archive Date | YYYYMMDD contact | string | Yes | Contact Info | 65535 characters
Default value: Primary
Other types: Secondary, Owner desc | string | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | No | Government Email | 128 characters +email | GovEmail – complex type | Yes | Government Email | 128 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | setaside | string | No | Set-Aside code | See Set Aside Value Section for valid codes @@ -693,7 +693,7 @@ archdate | Date | No | Archive Date | YYYYMMDD contact | String | No | Contact Info | 65535 characters desc | String | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | No | Government Email | 128 characters +email | GovEmail – complex type | Yes | Government Email | 128 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | recovery_act | boolean | No | Recovery Act | True or False @@ -759,7 +759,7 @@ archdate| date| No| Archive Date| YYYYMMDD contact| string| Yes| Contact Info| 65535 characters desc| string |Yes| Description |65535 characters link |GovURL – complex type| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email |GovEmail – complex type |No| Government Email| 128 characters +email |GovEmail – complex type |Yes| Government Email| 128 characters links| DocumentLink[]| No |Array Of links | files |DocumentFile[]| No |Array of files | recovery_act| boolean |No |Recovery Act |True or False @@ -901,7 +901,7 @@ desc |String |Yes |Description| 65535 characters link| GovURL| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) links |DocumentLink[]| No| Array Of links | files| DocumentFile[] |No |Array of files | -email |GovEmail| No| Government Email| 128 characters +email |GovEmail| Yes| Government Email| 128 characters recovery_act| boolean |No |Recovery Act |True or False correction |boolean |No |Correction of previous ITB| True or False

If correcting a previously submitted itb notice, specify true and the system will lookup the itb by award number, delivery number and sol number if applicable. @@ -990,7 +990,7 @@ awardee_duns| string |no |Awardee DUNS |9 digits with optional plus 4 contact| string| Yes – for presol, submitSourcesSought, combined, itb, ja, award, saleofSurplus, Solicitation

No – for rest| Contact Info| 65535 characters desc |string| Yes – For presol, submitSourcesSought, combined, ITB, special and saleOfSurplus, Solicitation

No – For rest| Main Description| 65535 characters link| GovernmentURL| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email| GovernmentEmail| No| Government Email |128 characters +email| GovernmentEmail| Yes / No: Only for Award| Government Email |128 characters links |DocumentLink []| no |Array Of links | files |DocumentFile[]| no| Array of files | setaside| string| no| Set-Aside code | See Set Aside Section for valid codes From 0627c407ac135b299290faaef0f39f92aa3be7e9 Mon Sep 17 00:00:00 2001 From: "anusha.paladugu" Date: Thu, 24 Oct 2019 16:20:47 -0400 Subject: [PATCH 029/149] charcter limit updates --- _apidocs/opportunities-soap-api.md | 308 ++++++++++++++--------------- 1 file changed, 152 insertions(+), 156 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index e180a9a6a..cfb55b916 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -169,7 +169,7 @@ solnbr | string | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) ntype | string | No | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation awdnbr | string | Yes | Award Number | 255 characters awdnbr | open text, label: Agency assigned number for control tracking and identification.
Please use ONLY alphanumeric and - _ ( ) { } characters [no spaces]. | Yes | Award Number | 255 characters -awdamt | string | Yes | Award Amount | 64 characters +awdamt | string | Yes | Award Amount | 64 digits linenbr | string | No | Line Number | 255 characters awddate | date | Yes | Award Date | YYYYMMDD archdate | date | No | Archive Date | YYYYMMDD @@ -178,7 +178,7 @@ awardee_duns | string | No | Awardee DUNS | 9 digits with optional plus 4 contact | string | No | Contact Info | 65535 characters desc | string | No | Description | 65535 characters link | GovURL | No | Government Link 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| -email | GovEmail | No | Government Email | 128 characters +email | GovEmail | No | Government Email | 255 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | setaside | string | No | Set-Aside code | See Set Aside Value Section for valid codes @@ -196,7 +196,7 @@ GovEmail Complex Type Definition Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address | string | Yes | Email Address | 128 characters +address | string | Yes | Email Address | 255 characters desc | string | Yes | Description | 255 characters DocumentLink Complex Type Definition @@ -211,8 +211,8 @@ DocumentFile Complex Type Definition Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -237,10 +237,10 @@ DeleteNoticeOrDocumentPackage Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- solnbr | string | Yes, if Non-Award | Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { } -ntype | string | no | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation +ntype | string | No | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award awdnbr | string | Yes, if Award| Award # | 255 characters -deletetype | string | no | Notice or Attachment delete operation type | Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided -deletemethod | string | no | Delete latest or all versions | Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided +deletetype | string | No | Notice or Attachment delete operation type | Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided +deletemethod | string | No | Delete latest or all versions | Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided ### Archive Notice
(ArchiveNotice) @@ -334,7 +334,7 @@ archdate | date | No | Archive Date | YYYYMMDD contact | string | Yes | Contact Info | 65535 characters desc |string |Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link has URL & description | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | No | Government Email | 128 characters +email | GovEmail – complex type | No | Government Email | 255 characters links | DocumentLink[] | No | Array of links | files | DocumentFile[] | No | Array of files | setaside | string | No | Set-Aside code | See Set Aside Values Section for valid codes @@ -343,7 +343,7 @@ popzip |string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters recovery_act | boolean | no | Recovery Act | True or False -GovURL Complex Type Definition: This field is not implemented +GovURL Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- @@ -354,23 +354,23 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address | string | no |Email Address |128 characters +address | string | no |Email Address |255 characters desc | string | no | Description | 255 characters -DocumentLink Complex Type Definition: This field is not implemented +DocumentLink Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- url | string | Yes | External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) desc | string | Yes | Description/Title | 255 characters -DocumentFile Complex Type Definition: This field is not implemented +DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -405,7 +405,7 @@ archdate | date | No | Archive Date | YYYYMMDD contact | string |Yes | Contact Info | 65535 characters desc | string | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | No | Government Email | 128 characters +email | GovEmail – complex type | No | Government Email | 255 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | setaside | string | No | Set-Aside code | See Set Aside Values section for valid codes @@ -414,7 +414,7 @@ popzip | string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters recovery_act | boolean | No | Recovery Act | True or False -GovURL Complex Type Definition: This field is not implemented +GovURL Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- @@ -425,23 +425,23 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address | string | Yes | Email Address | 128 characters +address | string | Yes | Email Address | 255 characters desc | string | Yes | Description | 255 characters -DocumentLink Complex Type Definition: This field is not implemented +DocumentLink Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- url | string | Yes | External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) desc | string | Yes | Description/Title | 255 characters -DocumentFile Complex Type Definition: This field is not implemented +DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -477,7 +477,7 @@ archdate | date | no | Archive Date | YYYYMMDD contact | string | No – For Special notice, Yes – For rest | Contact Info | 65535 characters desc | string | Yes | Description | 65535 characters link | GovURL – complex type | no | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | no | Government Email | 128 characters +email | GovEmail – complex type | no | Government Email | 255 characters links | DocumentLink[] | no | Array Of links | files | DocumentFile[] | no | Array of files | setaside | string | no | Set-Aside code | See Set Aside Value Section for valid codes @@ -497,7 +497,7 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address | string | Yes | Email Address | 128 characters +address | string | Yes | Email Address | 255 characters desc | string | Yes | Description | 255 characters DocumentLink Complex Type Definition: @@ -512,8 +512,8 @@ DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -547,7 +547,7 @@ ntype | string | No | Base Notice Type | Valid values: "PRESOL" - for Presolicit stauth | String | Yes | Stat. Authority – Both foja & stauth values will be given under stauth in legacy | Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7
Description of each of these stauth values is captured in section 4.4

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ awdnbr | String | Yes | Award Number | 255 characters modnbr | String | No | Mod Number | 32 characters -awdamt | String | No | Award Amount | 64 characters +awdamt | String | No | Award Amount. This field has been deprecated for JA notice type | 64 digits awddate | Date | No – May change in future | Award Date | YYYYMMDD donbr | String | Yes | Task/Delivery Order Number | 255 characters from the set: a-z A-Z 0-9 - _ ( ) archdate | Date | No | Archive Date | YYYYMMDD @@ -556,7 +556,7 @@ desc | String | No | Description | 65535 characters link | GovURL | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | -email | GovEmail | No | Government Email | 128 characters +email | GovEmail | No | Government Email | 255 characters recovery_act | boolean | No | Recovery Act | True or False; correction | boolean | No | Correction of previous J&A | True or False
If correcting a previously submitted j&a notice, specify true and the system will lookup the j&a by award number and sol number if applicable. @@ -571,7 +571,7 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address | string | yes | Email Address | 128 characters +address | string | yes | Email Address | 255 characters desc | string | yes | Description | 255 characters DocumentLink Complex Type Definition: @@ -586,8 +586,8 @@ DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -631,7 +631,7 @@ popzip | string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters recovery_act | boolean | No | Recovery Act | True or False -GovURL Complex Type Definition: This field is not implemented +GovURL Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- @@ -642,23 +642,23 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address | string | yes | Email Address | 128 characters +address | string | yes | Email Address | 255 characters desc | string | yes | Description | 255 characters -DocumentLink Complex Type Definition: This field is not implemented +DocumentLink Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- url | string | Yes | External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) desc | string | Yes | Description/Title | 255 characters -DocumentFile Complex Type Definition: This field is not implemented +DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -696,7 +696,7 @@ archdate | Date | No | Archive Date | YYYYMMDD contact | String | No | Contact Info | 65535 characters desc | String | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | No | Government Email | 128 characters +email | GovEmail – complex type | No | Government Email | 255 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | recovery_act | boolean | No | Recovery Act | True or False @@ -712,7 +712,7 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address |string| yes| Email Address |128 characters +address |string| yes| Email Address |255 characters desc |string |yes |Description |255 characters DocumentLink Complex Type Definition: @@ -727,8 +727,8 @@ DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -778,7 +778,7 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address| string| yes| Email Address |128 characters +address| string| yes| Email Address |255 characters desc |string |yes |Description |255 characters DocumentLink Complex Type Definition: @@ -793,8 +793,8 @@ DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -829,7 +829,7 @@ archdate | date | No | Archive Date | YYYYMMDD contact | string |Yes | Contact Info | 65535 characters desc | string | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email | GovEmail – complex type | Yes | Government Email | 128 characters +email | GovEmail – complex type | Yes | Government Email | 255 characters links | DocumentLink[] | No | Array Of links | files | DocumentFile[] | No | Array of files | setaside | string | No | Set-Aside code | See Set Aside Values section for valid codes @@ -838,7 +838,7 @@ popzip | string | No | Pop Zip | 5 digits popcountry | string | No | Pop Country | 32 characters recovery_act | boolean | No | Recovery Act | True or False -GovURL Complex Type Definition: This field is not implemented +GovURL Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- @@ -849,7 +849,7 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address | string | Yes | Email Address | 128 characters +address | string | Yes | Email Address | 255 characters desc | string | Yes | Description | 255 characters DocumentLink Complex Type Definition: @@ -864,8 +864,8 @@ DocumentFile Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -904,7 +904,7 @@ desc |String |Yes |Description| 65535 characters link| GovURL| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) links |DocumentLink[]| No| Array Of links | files| DocumentFile[] |No |Array of files | -email |GovEmail| No| Government Email| 128 characters +email |GovEmail| No| Government Email| 255 characters recovery_act| boolean |No |Recovery Act |True or False correction |boolean |No |Correction of previous ITB| True or False

If correcting a previously submitted itb notice, specify true and the system will lookup the itb by award number, delivery number and sol number if applicable. @@ -919,7 +919,7 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address |string |yes| Email Address |128 characters +address |string |yes| Email Address |255 characters desc| string| yes |Description| 255 characters DocumentLink Complex Type Definition: @@ -932,8 +932,8 @@ desc| string| Yes| Description/Title |255 characters Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -981,7 +981,7 @@ solnbr| string| Yes – For presol, combined, itb, ja, award, special, document, ntype |string |no |Base Notice Type |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation awdnbr| string| Yes – For Award & JA, ITB

No – For rest| Award # |255 characters donbr |string |Yes – For JA

No – For rest| Delivery/Task Order Number |255 characters -awdamt |string| Yes – For Award

No – For rest |Award Amount| 64 characters +awdamt |string| Yes – For Award

No – For rest |Award Amount| 64 digits linenbr| string |No| Award Line Item Number |255 characters awddate |date| Yes – for award; No – for rest| Award Date |YYYYMMDD stauth |string |Yes – for JA; No – for test |J&A StatutoryAuthority

Note: Both foja & stauth values will be given under stauth in legacy| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

Description of each of these stauth values is captured in Stauth Value section

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ @@ -993,7 +993,7 @@ awardee_duns| string |no |Awardee DUNS |9 digits with optional plus 4 contact| string| Yes – for presol, submitSourcesSought, combined, itb, ja, award, saleofSurplus, Solicitation

No – for rest| Contact Info| 65535 characters desc |string| Yes – For presol, submitSourcesSought, combined, ITB, special and saleOfSurplus, Solicitation

No – For rest| Main Description| 65535 characters link| GovernmentURL| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) -email| GovernmentEmail| No| Government Email |128 characters +email| GovernmentEmail| No| Government Email |255 characters links |DocumentLink []| no |Array Of links | files |DocumentFile[]| no| Array of files | setaside| string| no| Set-Aside code | See Set Aside Section for valid codes @@ -1016,7 +1016,7 @@ GovEmail Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- -address| string| yes |Email Address| 128 characters +address| string| yes |Email Address| 255 characters desc |string| yes |Description |255 characters DocumentLink Complex Type Definition: @@ -1029,8 +1029,8 @@ desc| string| Yes| Description/Title| 255 characters Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -1073,8 +1073,8 @@ DocumentFile Complex Type Definition Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- filename | string | Yes | File Name | 255 characters -filedata | base64binary | Yes | File Data | 100 MB -desc | string | No | Description | 255 characters +filedata | base64binary | Yes | File Data | 250 MB +desc | string | No | Description | 65535 characters explicit_access | boolean | No | Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".| export_controlled | boolean | No | Export Controlled. * Captured for future JCP validation. | @@ -1159,10 +1159,10 @@ Response | IVLListResponse | Complex type defined below IVLListRequest Complex Type Definition: -Element Name | Type | Required | Description ------- | ------- | ------- | ------- -solnbr| string| yes| Solicitation # -ntype |string |no |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation +Element Name | Type | Required | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- | ------- +solnbr| string| Yes| Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +ntype |string |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | IVLListResponse Complex Type Definition: @@ -1204,16 +1204,12 @@ Response | AuthorizedPartyListResponse | Complex type defined below AuthorizedPartyListRequest Complex Type Definition: -Element Name | Type | Required | Description ------- | ------- | ------- | ------- -solnbr| string| yes |Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below -ntype| string| no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation -nonfbo_solbr| string| no| Non-fbo Solicitation #. Not supported for this method -status| string |no |Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned

Note, use “pending” to pull the pending explicit access requests. -resource_name |string |Yes |Only populates if the type_of_request is a resource. -type_of_request |string |Yes |Indicates if the id is a resource or a notice level request - - +Element Name | Type | Required | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- | ------- +solnbr| string| Yes |Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +ntype| string| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | +nonfbo_solbr| string| No| Non-fbo Solicitation #. Not supported for this method | +status| string |No |Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned

Note, use “pending” to pull the pending explicit access requests. | AuthorizedPartyListResponse Complex Type Definition: @@ -1252,14 +1248,14 @@ data |ExplicitAccessRequest| Complex type defined below ExplicitAccessRequestComplex Type Definition: -Element Name | Type | Required | Description ------- | ------- | ------- | ------- -solnbr| string |yes| Solicitation # -ntype |string |no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation -nonfbo_solbr |string| no| Non-fbo Solicitation #. Not supported for this method -Id| string| yes| Matches internal record ID. This is retrieved from getAuthorizedPartyList method above. -vendor| VendorData| no| Complex type not used in this method -reason |string| no| rejection reason not used in this method +Element Name | Type | Required | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- | ------- +solnbr| string |Yes| Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +ntype |string |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | +nonfbo_solbr |string| No| Non-fbo Solicitation #. Not supported for this method | +Id| string| Yes| Matches internal record ID. This is retrieved from getAuthorizedPartyList method above. | 32 characters +vendor| VendorData| No| Complex type not used in this method | +reason |string| No| rejection reason not used in this method | Response: @@ -1279,14 +1275,14 @@ data| ExplicitAccessRequest |Complex type defined below ExplicitAccessRequestComplex Type Definition: -Element Name |Type |Required| Description ------|-----|-----|---- -solnbr |string |yes| Solicitation # -ntype| string| no| Valid values: "PRESOL" - for Presolicitation
"COMBINE" - for Combined Synopsis/Solicitation
"SRCSGT" - for Sources Sought
"SSALE" - for Sale of Surplus Property
"SNOTE" - for Special Notice
“ITB” – for Intent to Bundle Requirements (DoD- Funded) -nonfbo_solbr| string| no| Non-fbo Solicitation #. Not supported for this method -Id| string| no| Not used in this method -vendor| VendorData |yes| Complex type defined below -reason |string| no |Rejection reason not used in this method +Element Name |Type |Required| Description | Character Limit / Restrictions +-----|-----|-----|---- | ------- +solnbr |string |Yes| Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +ntype| string| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | +nonfbo_solbr| string| no| Non-fbo Solicitation #. Not supported for this method | +Id| string| no| Not used in this method | +vendor| VendorData |yes| Complex type defined below | +reason |string| no |Rejection reason not used in this method | Response: @@ -1296,14 +1292,14 @@ Response | PostingResponse | Complex type VendorData Complex Type Definition: -Element Name | Type | Description ------- | ------- | ------- -lname| string| Last Name -fname |string| First Name -email |string| Email -contractor_name |string |Contractor Name -duns |string |DUNS # -cage_code| string| Cage Code +Element Name | Type | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- +lname| string| Last Name | 255 characters +fname |string| First Name | 255 characters +email |string| Email | 255 characters +contractor_name |string |Contractor Name | 255 characters +duns |string |DUNS # | 9 digits +cage_code| string| Cage Code | 5 alpha/numeric characters ### Reject Explicit Access Requests
(rejectExplicitAccessRequestByID) @@ -1318,14 +1314,14 @@ data |ExplicitAccessRequest| Complex type defined below ExplicitAccessRequestComplex Type Definition: -Element Name | Type | Required | Description ------- | ------- | ------- | ------- -solnbr| string |yes| Solicitation # -ntype |string |no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation +Element Name | Type | Required | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- | ------- +solnbr| string |Yes| Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +ntype |string |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | nonfbo_solbr |string| no| Non-fbo Solicitation #. Not supported for this method -Id| string| yes| Matches internal record ID. This is retrieved from getAuthorizedPartyList method above. -vendor| VendorData| no| Complex type not used in this method -reason |string| no| rejection reason not used in this method +Id| string| Yes| Matches internal record ID. This is retrieved from getAuthorizedPartyList method above. | 32 characters +vendor| VendorData| No| Complex type not used in this method | +reason |string| Yes| rejection reason | 65535 characters Response: @@ -1346,14 +1342,14 @@ data |ExplicitAccessRequest| Complex type defined below ExplicitAccessRequestComplex Type Definition: -Element Name | Type | Required | Description ------- | ------- | ------- | ------- -solnbr| string| yes| Solicitation # -ntype |string |no| Valid values: "PRESOL" - for Presolicitation
"COMBINE" - forCombined Synopsis/Solicitation
"SRCSGT" - for Sources Sought
"SSALE" - for Sale of Surplus Property
"SNOTE" - for Special Notice
“ITB” – for Intent to Bundle Requirements (DoD- Funded) -nonfbo_solbr |string |no |Non-fbo Solicitation #. Not supported for this method -Id |string| no |Not used in this method -vendor |VendorData| yes| Complex type defined below -reason| string| yes |Rejection Reason +Element Name | Type | Required | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- | ------- +solnbr| string| Yes| Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +ntype |string |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | +nonfbo_solbr |string |No |Non-fbo Solicitation #. Not supported for this method | +Id |string| No |Not used in this method | +vendor |VendorData| Yes| Complex type defined below | +reason| string| Yes |Rejection Reason | 65535 characters Response: @@ -1363,14 +1359,14 @@ Response | PostingResponse | Complex type VendorData Complex Type Definition: -Element Name | Type | Description ------- | ------- | ------- -lname| string| Last Name -fname |string| First Name -email |string| Email -contractor_name |string |Contractor Name -duns |string |DUNS # -cage_code| string| Cage Code +Element Name | Type | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- +lname| string| Last Name | 255 characters +fname |string| First Name | 255 characters +email |string| Email | 255 characters +contractor_name |string |Contractor Name | 255 characters +duns |string |DUNS # | 9 digits +cage_code| string| Cage Code | 5 alpha/numeric characters ### Add Authorized Party
(addAuthorizedParty) @@ -1383,14 +1379,14 @@ data |ExplicitAccessRequest| Complex type defined below ExplicitAccessRequest Complex Type Definition: -Element Name | Type | Required | Description ------- | ------- | ------- | ------- -solnbr| string| yes| Solicitation # -ntype |string |no |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation -nonfbo_solbr| string| no |Non-fbo Solicitation #. Not supported for this method. -Id |string |no |Not used in this method -vendor |VendorData| yes| Complex type defined below -reason |string |no |rejection reason not used in this method +Element Name | Type | Required | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- | ------- +solnbr| string| Yes| Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +ntype |string |No | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | +nonfbo_solbr| string| No | Non-fbo Solicitation #. Not supported for this method| +Id |string |No |Not used in this method | +vendor |VendorData| Yes| Complex type defined below | +reason |string |No |rejection reason not used in this method | Response: @@ -1400,14 +1396,14 @@ Response | PostingResponse | Complex type VendorData Complex Type Definition: -Element Name | Type | Description ------- | ------- | ------- -lname |string |Last Name -fname| string |First Name -email| string |Email -contractor_name |string |Contractor Name -duns| string |DUNS # -cage_code| string| Cage Code +Element Name | Type | Description | Character Limit / Restrictions +------ | ------- | ------- | ------- +lname| string| Last Name | 255 characters +fname |string| First Name | 255 characters +email |string| Email | 255 characters +contractor_name |string |Contractor Name | 255 characters +duns |string |DUNS # | 9 digits +cage_code| string| Cage Code | 5 alpha/numeric characters ## Method Available for Data Export @@ -1423,14 +1419,14 @@ data| NoticeListRequest| Complex type defined below NoticeListRequest Complex Type Definition: -Element Name| Type| Required| Description ------|-----|-----|----- -notice_type |string| No| Solicitation #. Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL. Note:Searches for awardsj&as, itb’s and fairopps will return both standalone notices AND base notices that contain one of these type -solnbr |string |No |Solicitation # -awdnbr |string |No |Award # -posted_from |date| No| Posted From Date. YYYYMMDD. -posted_to |date| |No Posted To Date. YYYYMMDD -documents_to_search |string| No| Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided. +Element Name| Type| Required| Description | Character Limit / Restrictions +-----|-----|-----|-----|----- +notice_type |string| No| Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL. Note:Searches for awardsj&as, itb’s and fairopps will return both standalone notices AND base notices that contain one of these type | +solnbr |string |No |Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } +awdnbr |string |No |Award # | 255 characters +posted_from |date| No| Posted From Date. YYYYMMDD. | +posted_to |date| |No Posted To Date. YYYYMMDD | +documents_to_search |string| No| Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided. | Response: @@ -1473,12 +1469,12 @@ data| NoticeDataRequest| Complex type defined below NoticeDataRequest Complex Type Definition: -Element Name| Type| Required| Description ------|-----|-----|----- -notice_id |string |Yes| Unique ID found from getList call or ID’s for changes found in getNoticeData call. -get_changes |boolean| No| True or false
Pass in true to get the full notice history with all changes -get_changes_from_date |date| No| If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned. -get_file_data| boolean| No| True or False
Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the meta details/links will still be provided. +Element Name| Type| Required| Description | Character Limit / Restrictions +-----|-----|-----|----- |----- +notice_id |string |Yes| Unique ID found from getList call or ID’s for changes found in getNoticeData call | 32 characters +get_changes |boolean| No| True or false
Pass in true to get the full notice history with all changes | +get_changes_from_date |date| No| If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned.| +get_file_data| boolean| No| True or False
Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the metadata for attachments/links will still be provided.| Response: @@ -1580,9 +1576,9 @@ data| FileDataRequest| Complex type defined below FileDataRequest Complex Type Definition: -Element Name| Type| Required| Description ------|-----|-----|----- -file_id |string| yes| Unique ID of a file found from getNoticeData call (i.e. file_id element) +Element Name| Type| Required| Description | Character Limit / Restrictions +-----|-----|-----|----- |----- +file_id |string| yes| Unique ID of a file found from getNoticeData call (i.e. file_id element) | 32 characters Response: @@ -4095,7 +4091,7 @@ awddate |Yes – For award; No – for rest |YYYYMMDD| 1. This field should meet stauth| Yes – For JA

No – for rest | Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

Description of each of these stauth values is captured in Stauth Values section

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ | Both foja & stauth values will be given under stauth in legacy | NA respdate| Yes – For SubmitCombined No- For rest| YYYYMMDD | 1. No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2)

3. For submitCombined this field is required | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Inactive date provided is in the past

4. Response Date is required archdate| No| YYYYMMDD |1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction

2. This date cannot be current or in past; has to be in future| 1. DATE field in unexpected format Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past. -awardee |Yes – for award

No – for Rest| 6553 characters| NA| NA +awardee |Yes – for award

No – for Rest| 65535 characters| NA| NA awardee_duns| No |9 digits with optional plus 4| NA| NA contact |Yes – For presol, submitSourcesSought, combined, ITB, JA, award, solicitation and submitSaleofSurplus

No – For rest |65535 characters Default value = Primary Other types are: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required desc| Yes – For presol, submitSourcesSought , combined, ITB, special, solicitation and surplus

No – For rest |65535 characters| 1. This required field should be validated.| 1. Description is required @@ -4412,7 +4408,7 @@ Element Name | Required | Character Limit / Restrictions | Business Rules | Erro ------ | ------- | ------- | ------- | -------- solnbr| Yes if non-award| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces awdnbr| Yes if award| 255 characters| If neither solnbr or awdnbr is provided, then the system throws an error| Solicitation Number or Award Number is required -ntype|No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid +ntype|No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid deletetype| no| Valid values: “notice” to delete the notice, “attachment” to delete attachments and links from the notice| 1. If an invalid deletetype is provided, then service throws an error | Delete type provided is not “notice” or “attachment” deletemethod| no| Valid Values: “all” to delete all versions or “latest” to delete latest version |1. If an invalid deletemethod is provided, then service throws an error | Delete method provided is not “latest” or “all” From 1e941f6ba9dc5791fc8f1e37b22c50db1840b74b Mon Sep 17 00:00:00 2001 From: "anusha.paladugu" Date: Thu, 24 Oct 2019 17:31:33 -0400 Subject: [PATCH 030/149] updated the character limits for subject and contact --- _apidocs/opportunities-soap-api.md | 124 +++++++++++++++-------------- 1 file changed, 63 insertions(+), 61 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index cfb55b916..59264bb24 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -164,7 +164,7 @@ classcod | string | No | Class-Code | Valid classification code (FAR, Section 5. naics | string | No | NAICS Code | Valid NAICS Code NAICS Reference offadd | string | No | Office Address | 65535 characters officeid | string | Yes | Office id of the office where an opportunity is being submitted | 20 characters -subject | string | Yes | Subject | 255 characters +subject | string | Yes | Subject | 256 characters solnbr | string | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) {} ntype | string | No | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation awdnbr | string | Yes | Award Number | 255 characters @@ -175,7 +175,7 @@ awddate | date | Yes | Award Date | YYYYMMDD archdate | date | No | Archive Date | YYYYMMDD awardee | string | Yes | Awardee | 65535 characters awardee_duns | string | No | Awardee DUNS | 9 digits with optional plus 4 -contact | string | No | Contact Info | 65535 characters +contact | string | No | Contact Info | 255 characters desc | string | No | Description | 65535 characters link | GovURL | No | Government Link 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| email | GovEmail | No | Government Email | 255 characters @@ -291,12 +291,12 @@ Element Name | Type | Required | Description | Character Limit / Restrictions date | date | No | Posting Date | YYYYMMDD offadd | string | No | Office Address | 65535 characters officeid | String | No | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters -subject | string | No | Subject | 255 characters +subject | string | No | Subject | 256 characters solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } ntype | string | No | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation awdnbr | string | No | Award # |255 characters archdate | date | No | Archive Date | YYYYMMDD -contact | string | No | Contact Info | 65535 characters +contact | string | No | Contact Info | 255 characters desc | string | Yes | Cancellation Description | 65535 characters ## Contracting Officer/Contracting
Specialist Method Details @@ -327,11 +327,11 @@ classcod | string | Yes | Class-Code | Valid classification code (FAR, Section 5 naics | string | No | NAICS Code | Valid NAICS Code NAICS Reference officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters offadd | string | No | Office Address | 65535 characters -subject | string | Yes| Title of the Pre-solicitation | 255 characters +subject | string | Yes| Subject | 256 characters solnbr | string | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } respdate | date | No | Response Date | YYYYMMDD archdate | date | No | Archive Date | YYYYMMDD -contact | string | Yes | Contact Info | 65535 characters +contact | string | Yes | Contact Info | 255 characters desc |string |Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link has URL & description | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email | GovEmail – complex type | No | Government Email | 255 characters @@ -398,11 +398,11 @@ classcod | string | Yes | Class-Code | Valid classification code (FAR, Section 5 naics | string | Yes | NAICS Code | Valid NAICS Code NAICS Reference officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters offadd | string | No | Office Address | 65535 characters -subject | string | Yes | Subject | 255 characters +subject | string | Yes | Subject | 256 characters solnbr | string | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } respdate | date | Yes | Response Date | YYYYMMDD archdate | date | No | Archive Date | YYYYMMDD -contact | string |Yes | Contact Info | 65535 characters +contact | string |Yes | Contact Info | 255 characters desc | string | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email | GovEmail – complex type | No | Government Email | 255 characters @@ -469,12 +469,12 @@ classcod | string | Yes – For combined type, presol type, Sale of surplus, No naics | string | Yes – For combined type, No – For rest | NAICS Code | Valid NAICS Code NAICS Reference officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters offadd | string | no | Office Address | 65535 characters -subject | string | no | Subject | 255 characters +subject | string | no | Subject | 256 characters solnbr | string | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) {} ntype | string | Yes | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation respdate | date | Yes – Combined, No – For rest | Response Date | YYYYMMDD archdate | date | no | Archive Date | YYYYMMDD -contact | string | No – For Special notice, Yes – For rest | Contact Info | 65535 characters +contact | string | No – For Special notice, Yes – For rest | Contact Info | 255 characters desc | string | Yes | Description | 65535 characters link | GovURL – complex type | no | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email | GovEmail – complex type | no | Government Email | 255 characters @@ -541,7 +541,7 @@ classcod | String | Yes | Class-Code | Valid classification code naics | String | No | NAICS Code | Valid NAICS Code NAICS Reference offadd | String | No | Office Address | 65535 characters officeid | String | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters -subject | String | Yes | Subject | 255 characters +subject | String | Yes | Subject | 256 characters solnbr | String | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}.

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required ntype | string | No | Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation stauth | String | Yes | Stat. Authority – Both foja & stauth values will be given under stauth in legacy | Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7
Description of each of these stauth values is captured in section 4.4

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ @@ -551,7 +551,7 @@ awdamt | String | No | Award Amount. This field has been deprecated for JA notic awddate | Date | No – May change in future | Award Date | YYYYMMDD donbr | String | Yes | Task/Delivery Order Number | 255 characters from the set: a-z A-Z 0-9 - _ ( ) archdate | Date | No | Archive Date | YYYYMMDD -contact | String | Yes | Contact Info | 65535 characters +contact | String | Yes | Contact Info | 255 characters desc | String | No | Description | 65535 characters link | GovURL | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) links | DocumentLink[] | No | Array Of links | @@ -615,11 +615,11 @@ classcod | string | No | Class-Code | Valid classification code (FAR, Section 5. naics | string | No | NAICS Code | Valid NAICS Code officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters offadd | string | No | Office Address | 65535 characters -subject | string | Yes | Subject | 255 characters +subject | string | Yes | Subject | 256 characters solnbr | string | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } respdate | date | No | Response Date | YYYYMMDD archdate | date | No | Archive Date | YYYYMMDD -contact | string | Yes | Contact Info | 65535 characters
Default value: Primary
Other types: Secondary, Owner +contact | string | Yes | Contact Info | 255 characters
Default value: Primary
Other types: Secondary, Owner desc | string | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email | GovEmail – complex type | No | Government Email | 128 characters @@ -690,10 +690,10 @@ classcod | String | No | Class-Code | Valid classification code (FAR, Section 5 naics | String | No | NAICS Code | Valid NAICS Code NAICS Reference officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters offadd | String | No | Office Address | 65535 characters -subject | String | Yes | Subject | 255 characters +subject | String | Yes | Subject | 256 characters solnbr | String | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } archdate | Date | No | Archive Date | YYYYMMDD -contact | String | No | Contact Info | 65535 characters +contact | String | No | Contact Info | 255 characters desc | String | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email | GovEmail – complex type | No | Government Email | 255 characters @@ -756,10 +756,10 @@ classcod| string| Yes |Class-Code| Valid classification code (FAR, Section 5.207 naics| string| No| NAICS Code| Valid NAICS Code NAICS Reference officeid |string |Yes| Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters offadd| string| No |Office Address |65535 characters -subject| string| Yes| Subject |255 characters +subject| string| Yes| Subject |256 characters solnbr| string |Yes |Sol #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } archdate| date| No| Archive Date| YYYYMMDD -contact| string| Yes| Contact Info| 65535 characters +contact| string| Yes| Contact Info| 255 characters desc| string |Yes| Description |65535 characters link |GovURL – complex type| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email |GovEmail – complex type |No| Government Email| 128 characters @@ -822,11 +822,11 @@ classcod | string | Yes | Class-Code | Valid classification code (FAR, Section 5 naics | string | Yes | NAICS Code | Valid NAICS Code NAICS Reference officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters offadd | string | No | Office Address | 65535 characters -subject | string | Yes | Subject | 255 characters +subject | string | Yes | Subject | 256 characters solnbr | string | Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } respdate | date | Yes | Response Date | YYYYMMDD archdate | date | No | Archive Date | YYYYMMDD -contact | string |Yes | Contact Info | 65535 characters +contact | string |Yes | Contact Info | 255 characters desc | string | Yes | Description | 65535 characters link | GovURL – complex type | No | Government Link | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email | GovEmail – complex type | Yes | Government Email | 255 characters @@ -893,13 +893,13 @@ classcod| String| Yes| Class-Code| Valid classification code (FAR, Section 5.207 naics| String| No| NAICS Code| Valid NAICS Code officeid| String| Yes| Office id of the office where an opportunity is being submitted. Officeid must be associated with user account| 20 characters offadd| String |No| Office Address| 65535 characters -subject| String| Yes| Subject |255 characters +subject| String| Yes| Subject |256 characters solnbr |String |Yes| Sol # |128 characters from the set: a-z A-Z 0-9 - _ ( ) {} ntype |string |No| Base Notice Type| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation awdnbr| String |Yes |Award Number| 255 characters from the set: a-z A-Z 0-9 - _ ( ) {} donbr| String| No |Task/Delivery Order Number |255 characters from the set: a-z A-Z 0-9 - _ ( ) archdate |Date |No |Archive Date| YYYYMMDD -contact| String| Yes| Contact Info |65535 characters; Default value = Primary, Other types are: Secondary, Owner +contact| String| Yes| Contact Info |255 characters; Default value = Primary, Other types are: Secondary, Owner desc |String |Yes |Description| 65535 characters link| GovURL| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) links |DocumentLink[]| No| Array Of links | @@ -976,7 +976,7 @@ classcod| string| No| Class-Code |Valid classification code (FAR, Section 5.207( naics |string |No |NAICS Code| Valid NAICS Code NAICS Reference officeid| String| No| Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |20 characters offadd |string| No| Office Address |65535 characters -subject| string| Yes – For presol, combined, itb, ja, award, special, surplus

No – for rest| Subject| 255 characters +subject| string| Yes| Subject| 256 characters solnbr| string| Yes – For presol, combined, itb, ja, award, special, document, surplus

No – for rest| Sol # |128 characters from the set: a-z A-Z 0-9 - _ ( ) { } ntype |string |no |Base Notice Type |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation awdnbr| string| Yes – For Award & JA, ITB

No – For rest| Award # |255 characters @@ -990,7 +990,7 @@ respdate| date| Yes – for combined

No – for rest |Response Date |YYY archdate| date| No| Archive Date| YYYYMMDD awardee| string| Yes - award

No – for rest| Awardee |65535 characters awardee_duns| string |no |Awardee DUNS |9 digits with optional plus 4 -contact| string| Yes – for presol, submitSourcesSought, combined, itb, ja, award, saleofSurplus, Solicitation

No – for rest| Contact Info| 65535 characters +contact| string| Yes – for presol, submitSourcesSought, combined, itb, ja, award, saleofSurplus, Solicitation

No – for rest| Contact Info| 255 characters desc |string| Yes – For presol, submitSourcesSought, combined, ITB, special and saleOfSurplus, Solicitation

No – For rest| Main Description| 65535 characters link| GovernmentURL| No| Government Link |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) email| GovernmentEmail| No| Government Email |255 characters @@ -1162,7 +1162,7 @@ IVLListRequest Complex Type Definition: Element Name | Type | Required | Description | Character Limit / Restrictions ------ | ------- | ------- | ------- | ------- solnbr| string| Yes| Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { } -ntype |string |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | +ntype |string |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | IVLListResponse Complex Type Definition: @@ -4069,7 +4069,7 @@ This section details possible error messages for specific methods. Note that the Individual business rules per field are listed across each of the fields in below table. Note: * Through this service, users can create all the requests and also users can convert between requests. For e.g. Users can create pre-sol or any type and also this can be converted to say ITB anytime. -* When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required +* When none of the fields are given, then the service throws an error - title: is missing but it is required Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- @@ -4080,7 +4080,7 @@ classcod |No| Valid classification code (FAR, Section 5.207(g)) |1. This require naics |No| Valid NAICS Code NAICS Reference |NA | NA offadd| No| 65535 characters| NA| NA officeid |No |20 characters |1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided


3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check -subject |Yes – for all; NA – for submitDocumentAndLinks |255 characters| 1. This required field should be validated |1. $.data.title: is missing but it is required +subject |Yes – for all; NA – for submitDocumentAndLinks |256 characters| 1. This required field should be validated |1. title: is missing but it is required solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

2. If duplicate solicitation number is given, then system throws an error

3. For an invalid solnbr and notice_type combination, the service throws an error| 1.Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Opportunity not found with given solicitation number and ntype ntype| no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |NTYPE value provided is not valid awdnbr| Yes – For Award, ITB & JA; No – For rest| 255 characters| 1. This required field should be validated| 1. Award Details Section - Contract Award Number is a required field @@ -4093,7 +4093,7 @@ respdate| Yes – For SubmitCombined No- For rest| YYYYMMDD | 1. No validation i archdate| No| YYYYMMDD |1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction

2. This date cannot be current or in past; has to be in future| 1. DATE field in unexpected format Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past. awardee |Yes – for award

No – for Rest| 65535 characters| NA| NA awardee_duns| No |9 digits with optional plus 4| NA| NA -contact |Yes – For presol, submitSourcesSought, combined, ITB, JA, award, solicitation and submitSaleofSurplus

No – For rest |65535 characters Default value = Primary Other types are: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required +contact |Yes – For presol, submitSourcesSought, combined, ITB, JA, award, solicitation and submitSaleofSurplus

No – For rest |255 characters Default value = Primary Other types are: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required desc| Yes – For presol, submitSourcesSought , combined, ITB, special, solicitation and surplus

No – For rest |65535 characters| 1. This required field should be validated.| 1. Description is required link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA | NA email| Yes
No if type=Award| 128 characters| NA |NA @@ -4111,7 +4111,7 @@ correction| No| True or False

If correcting a previously submitted J&A n #### submitPresol and submitSourcesSought Individual business rules per field are listed across each of the fields in below table. -* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required +* Note: When none of the fields are given, then the service throws an error - title: is missing but it is required Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- @@ -4121,11 +4121,11 @@ classcod| Yes – For submitpresol
No - SourcesSought | Valid classification naics |No| Valid NAICS Code NAICS Reference| NA| NA offadd| No |65535 characters |NA| NA officeid |Yes |20 characters | 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check -subject |Yes |255 characters| 1. This required field should be validated| 1. $.data.title: is missing but it is required +subject |Yes |256 characters| 1. This required field should be validated| 1. title: is missing but it is required solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces respdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future

3. When giving future date, response date cannot exceed 5 years from the current date |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Response Date cannot exceed 5 years from current date archdate |No |YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Inactive date provided is in the past. -contact| Yes| 65535 characters

Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated| 1. Primary Contact is required +contact| Yes| 255 characters

Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated| 1. Primary Contact is required desc |Yes | 65535 characters| 1. This required field should be validated |1. Description is required link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA |NA email | Yes
No if type=Award| 128 characters| | NA @@ -4140,7 +4140,7 @@ recovery_act| No |True or False| NA| NA #### submitCombined Individual business rules per field are listed across each of the fields in below table. -* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required +* Note: When none of the fields are given, then the service throws an error - title: is missing but it is required Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- @@ -4150,11 +4150,11 @@ classcod |Yes| Valid classification code (FAR, Section 5.207(g))| 1. This requir naics |Yes |Valid NAICS Code NAICS Reference| 1. This required field should be validated |1. NAICS code is required officeid |Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check offadd| No| 65535 characters| NA| NA -subject |Yes| 255 characters| 1. This required field should be validated| 1. $.data.title: is missing but it is required +subject |Yes| 256 characters| 1. This required field should be validated| 1. title: is missing but it is required solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces respdate| Yes |YYYYMMDD |1. This required field should be validated

2. This field should meet the character limit/restrictions

3. This date cannot be in past; has to be in future

4. When giving future date, response date cannot exceed 5 years from the current date.| 1. This opportunity cannot be published. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. This opportunity cannot be published. Response date provided is in the past

4. This opportunity cannot be published. Response Date cannot exceed 5 years from current date archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past -contact| Yes| 65535 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated| 1. Primary Contact is Required +contact| Yes| 255 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated| 1. Primary Contact is Required desc| Yes | 65535 characters| 1. This required field should be validated| 1. Description is required link |No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA email |Yes
No if type=Award |128 characters |NA | NA @@ -4169,7 +4169,7 @@ recovery_act |No| True or False| NA| NA #### submitITB Individual business rules per field are listed across each of the fields in below table. -* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required +* Note: When none of the fields are given, then the service throws an error - title: is missing but it is required Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- @@ -4179,13 +4179,13 @@ classcod |Yes | Valid classification code (FAR, Section 5.207(g))| 1. This requi naics |No |Valid NAICS Code NAICS Reference| NA| NA officeid| Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check offadd| No| 65535 characters| NA| NA -subject |Yes| 255 characters| 1. This required field should be validated| 1. $.data.title: is missing but it is required +subject |Yes| 256 characters| 1. This required field should be validated| 1. title: is missing but it is required solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype ntype| no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error |1. Opportunity not found with given solicitation number and ntype

2. Invalid NTYPE value provided awdnbr| Yes| 255 characters from the set: a-z A-Z 0-9 - _ ( ) {} |1. This required field should be validated

2. This field accepts only valid characters as mentioned under character limit/restrictions column | 1. Award Details Section - Contract Award Number is a required field

2. Award Details Section - Contract Award Number - Please enter a valid number donbr| No| 255 characters from the set: a-z A-Z 0-9 - _ ( ) | NA| NA archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past -contact| Yes |65535 characters

65535 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated | 1. Primary Contact is Required +contact| Yes |255 characters

255 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated | 1. Primary Contact is Required desc| Yes| 65535 characters| 1. This required field should be validated |1. Description is required link| No |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) |NA |NA link |No | | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete @@ -4208,12 +4208,12 @@ classcod |Yes – For combined type, presol type, Sale of surplus

No naics |Yes – For combined type

No – For rest| Valid NAICS Code NAICS Reference |1. For combined, this field is required and should be validated| 1. NAICS code is required officeid| Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make modifications to an opportunity associated to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check offadd| No |65535 characters| NA| NA -subject |Yes| 255 characters| 1. This required field should be validated |1. $.data.title: is missing but it is required +subject |Yes| 256 characters| 1. This required field should be validated |1. title: is missing but it is required solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required |1a. This required field if not given, service will throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If a space is given along with numbers in this field, then service throws an error

3. If solicitation & ntype combination is not matched, then service throws an error| 1. Multiple notices found. Please input more details

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

3. Notice not found for correction ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. NTYPE value provided is not valid respdate |Yes – Combined No – For rest |YYYYMMDD |1. This required field is validated for combined type

2. No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction

3. This date cannot be in past; has to be in future| 1. This opportunity cannot be published. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. This opportunity cannot be published. Response date provided is in the past archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past -contac| No – For Special notice

Yes – For rest |65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required +contac| No – For Special notice

Yes – For rest |255 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required desc |Yes| 65535 characters| 1. This required field should be validated |1. Description is required link| No |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA |NA links |No |Collection |1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete @@ -4228,7 +4228,7 @@ recovery_act| No| True or False| NA| NA #### submitJA Individual business rules per field are listed across each of the fields in below table. -* Note: If none of the fields are given, then service throws an error – $.data.title: is missing but it is required. +* Note: If none of the fields are given, then service throws an error – title: is missing but it is required. * Note: If only subject is given, then service throws multiple errors: * Award Details Section - Task/Delivery Order Number is required field. * Contracting office is required @@ -4236,7 +4236,7 @@ Individual business rules per field are listed across each of the fields in belo * Award Details Section - Contract Award Number is a required field. * This opportunity cannot be published. Authority is required * Primary Contact is required - * Notice Id is required + * solicitation number is required Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) @@ -4247,7 +4247,7 @@ classcod| Yes| Valid classification code (FAR, Section 5.207(g))| 1. This requir naics| No – this may change in future |Valid NAICS Code NAICS Reference| NA| NA offadd| No| 65535 characters| NA| NA officeid| Yes| 20 characters |1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue -subject |Yes| 255 characters |1. This required field should be validated |1. $.data.title: is missing but it is required +subject |Yes| 256 characters |1. This required field should be validated |1. title: is missing but it is required solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required| 1. This required field if not given will throw an error

2. Duplicate solicitation number cannot be submitted

(Refer error #2) 3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error. |1. Notice Id is required

2. Notice ID for the selected opportunity type already exits

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype ntype |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation|1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Invalid NTYPE value provided stauth |Yes| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

Description of each of these stauth values is captured in Stauth Value section

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’| 1. This required field should be validated

Note: Both foja & stauth values will be given under stauth in legacy |1. This opportunity cannot be published. Authority is required @@ -4256,7 +4256,7 @@ modnbr| No |32 characters| NA| NA awddate |No – May change in future| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions| 1. DATE field in unexpected format. Expects YYYYMMDD awdamt| No| 64 characters| NA| NA archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future| 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past. -contact| Yes | 65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required +contact| Yes | 255 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required desc| No| 65535 characters| NA |NA link| No |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA links |No | | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete @@ -4279,7 +4279,7 @@ classcod| No| Valid classification code (FAR, Section 5.207(g))| 1. If a wrong c naics | No| Valid NAICS Code NAICS Reference| NA| NA offadd| No |65535 characters| NA| NA officeid |Yes |20 characters |1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check -subject |Yes| 255 characters| 1. This required field should be validated |$.data.title: is missing but it is required +subject |Yes| 256 characters| 1. This required field should be validated | 1. title: is missing but it is required solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}| 1. This required field should be validated

2. If a space is given along with numbers in this field, then service throws an error

3. If solicitation & ntype combination is not matched, then service throws an error| 1. Notice Id is required

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

3. Opportunity not found with given solicitation number and ntype ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation| 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. awdnbr| Yes| Valid numbers| 1. This required field should be validated

2. If an invalid number is given (e.g with special characters), then service throws an error| 1. Award Details Section - Contract Award Number is a required field

2. Award Details Section - Contract Award Number - Please enter a valid number @@ -4289,7 +4289,7 @@ awddate |Yes| YYYYMMDD |1. This required field should be validated

2. I archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future| 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past awardee| Yes| 65535 characters| 1. This required field should be validated |1. Award Details Section - Contractor Awarded Name is a required field awardee_duns |No| 9 digits with optional plus 4 |NA |NA -contact| Yes| 65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required +contact| Yes| 255 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required desc| No| 65535 characters| NA| NA link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA email| Yes
No if type=Award| 128 characters| NA| NA @@ -4328,7 +4328,7 @@ This service is now deprecated. #### submitSpecialNotice Individual business rules per field are listed across each of the fields in below table. -* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required +* Note: When none of the fields are given, then the service throws an error - title: is missing but it is required Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- @@ -4338,10 +4338,10 @@ classcod |No| Valid classification code (FAR, Section 5.207(g))| 1. This field d naics| No| Valid NAICS Code NAICS Reference| NA| NA offadd| No| 65535 characters| NA |NA officeid| Yes |20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check -subject |Yes| 255 characters| 1. This required field should be validated |1. $.data.title: is missing but it is required +subject |Yes| 256 characters| 1. This required field should be validated |1. title: is missing but it is required solnbr| No |128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required| 1. This required field should be validated

2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces archdate |No |YYYYMMDD |1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past -contact| No| 65535 characters Default value: Primary

Other types: Secondary, Owner| NA| NA +contact| No| 255 characters Default value: Primary

Other types: Secondary, Owner| NA| NA desc| Yes |65535 characters| 1. This required field should be validated| 1. Description is required link| No |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) |NA| NA links| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete @@ -4361,10 +4361,11 @@ classcod |Yes| Valid classification code (FAR, Section 5.207(g))| 1. This requir naics |Yes |Valid NAICS Code NAICS Reference| 1. This required field should be validated |1. NAICS code is required officeid |Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Invalid officeid provided

2. Insufficient privileges to create opportunity. offadd| No| 65535 characters| NA| NA -subject |Yes| 255 characters| 1. This required field should be validated| 1. Title is a required field. +subject |Yes| 256 characters| 1. This required field should be validated| 1. title: is missing but it is required solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Notice ID is a required field

2. Notice ID must be unique based on selected notice type

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces respdate| Yes |YYYYMMDD |1. This required field should be validated

2. This field should meet the character limit/restrictions

3. This date cannot be in past; has to be in future

4. When giving future date, response date cannot exceed 5 years from the current date.| 1. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. Response Date cannot be in the past

4. Response Date cannot exceed 5 years from current date archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. Inactive date provided is in the past +contact| Yes| 255 characters Default value: Primary

Other types: Secondary, Owner| NA| NA desc| Yes | 65535 characters| 1. This required field should be validated| 1. Description is a required field link |No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA email |Yes |128 characters |1. This field is required

2. If an invalid email address is provided, then the service throws an error | 1. Primary Contact - Email is required

2. Primary Contact - Please enter a valid Internet email address. Format: username@host.domain @@ -4379,7 +4380,7 @@ recovery_act |No| True or False| NA| NA #### submitSaleofSurplus Individual business rules per field are listed across each of the fields in below table. -* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required +* Note: When none of the fields are given, then the service throws an error - title: is missing but it is required Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- @@ -4389,10 +4390,10 @@ classcod| Yes| Valid classification code (FAR, Section 5.207(g))| 1. This requir naics |No |Valid NAICS Code NAICS Reference| NA| NA offadd| No| 65535 characters| NA| NA officeid| Yes |20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue -subject| Yes |255 characters |1. This required field should be validated |1. $.data.title: is missing but it is required +subject| Yes |256 characters |1. This required field should be validated |1. title: is missing but it is required solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required |1. This required field should be validated

2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past -contact |Yes| 65535 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required +contact |Yes| 255 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required desc| Yes| 65535 characters |1. This required field should be validated |1. Description is required link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA links| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete @@ -4407,7 +4408,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- solnbr| Yes if non-award| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces -awdnbr| Yes if award| 255 characters| If neither solnbr or awdnbr is provided, then the system throws an error| Solicitation Number or Award Number is required +awdnbr| Yes if award| 255 characters| If neither solnbr or awdnbr is provided, then the system throws an error| Solicitation Number or Award Number is required for Award Notice ntype|No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid deletetype| no| Valid values: “notice” to delete the notice, “attachment” to delete attachments and links from the notice| 1. If an invalid deletetype is provided, then service throws an error | Delete type provided is not “notice” or “attachment” deletemethod| no| Valid Values: “all” to delete all versions or “latest” to delete latest version |1. If an invalid deletemethod is provided, then service throws an error | Delete method provided is not “latest” or “all” @@ -4449,12 +4450,12 @@ Element Name | Required | Character Limit / Restrictions | Business Rules | Erro ------ | ------- | ------- | ------- | -------- date| No| YYYYMMDD |Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD officeid| No |20 characters| Officeid must be associated with user account |NA -subject| No| 255 characters| NA| NA +subject| No| 256 characters| NA| NA solnbr| Yes |128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If valid solnbr is given with a different ntype, then service throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple Notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces ntype |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Notice Type value provided is not valid awdnbr| No| 255 characters| NA| NA archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future| 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be cancelled -contact| No| 65535 characters Default value: Primary

Other types: Secondary, Owner| NA| NA +contact| No| 255 characters Default value: Primary

Other types: Secondary, Owner| NA| NA desc| Yes| 65535 characters| 1. This required field should be validated | 1. Unable to process request. Please try again #### getNoticeData @@ -4507,7 +4508,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details -ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation| If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid +ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award| If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. addAuthoizedParty service is deprecated for Non-FBO Solicitations status| No| Valid Options: approved, pending, rejected, “empty value”

If empty, all status will be returned

Note, use “pending” to pull the pending explicit access requests |1. If the status value entered doesn’t match the valid values , then the system throws an error| 1. Status value is invalid @@ -4518,7 +4519,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- solnbr |Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error |1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details -ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid +ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations id| Yes| | 1. If the request Id is not provided, then the system throws an error

2. If the request Id provided is already approved, then the service throws an error

3. If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

4. If the solicitation number provided matches with the solicitation number of the request Id but does not match with the provided N type, then the service throws an error |1. Internal ID is required. Use getAuthorizedPartyList to retrieve this information

2. Request with Request ID: #id already approved

3. You have request that is tied to different solicitation number

4. You have request that is tied to the same solicitation number but different notice type @@ -4529,7 +4530,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- solnbr |Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. -ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. +ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations vendor |Yes| Vendor Data |1. If all the elements in the Vendor Data complex definition are not provided, then the system throws an error.
2. If no match is found in the system for the vendor data provided, then the system throws an error.
3. If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error.| 1. This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown.
2. No contact match on vendor data provided.
3. Request with Request ID: #id already approved. @@ -4540,7 +4541,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- solnbr| Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details -ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid +ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr |No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. addAuthoizedParty service is deprecated for Non-FBO Solicitations vendor| Yes| Vendor Data| 1. If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

2. If no match is found in the system for the vendor data provided, then the system throws an error
3. If the vendor is already added as an authorized party on the notice, then the system throws an error.| 1. This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

2. No contact match on vendor data provided
3. Duplicate request. Vendor is already added as an authorized party on the notice @@ -4551,7 +4552,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- solnbr| Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error| 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
4. Multiple notices found. Please input more details -ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid +ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations id| Yes || 1. If the request Id is not provided, then the system throws an error

2. If the request Id provided is already rejected, then the service throws an error

3. If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

4. If the solicitation number provided matches with the solicitation number of the request Id but does not match with the provided N type, then the service throws an error| 1. Internal ID is required. Use getAuthorizedPartyList to retrieve this information

2. Request with Request ID: #id already rejected

3. You have request that is tied to different solicitation number

4. You have request that is tied to the same solicitation number but different notice type reason| Yes| Rejection Reason| 1. This is a required field. If no value is provided, then the system throws an error.| 1. A reason must be provided with an explicit access rejection. @@ -4562,7 +4563,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- solnbr |Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. -ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. +ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations vendor| Yes| Vendor Data| 1. If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

2. If no match is found in the system for the vendor data provided, then the system throws an error
3. If the vendor is already added as an authorized party on the notice, then the system throws an error.| 1. This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

2. No contact match on vendor data provided
3. Duplicate request. Vendor is already added as an authorized party on the notice reason| Yes| Rejection Reason| 1. This is a required field. If no value is provided, then the system throws an error.| 1. A reason must be provided with an explicit access rejection. @@ -4650,5 +4651,6 @@ Date | Version | Description 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated
User Account Section Updated 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes +10/10/2019 | v0.8 | Updated the character limits

Back to top

From fce1155c9f1d972aa29151020d502216999204c9 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Fri, 25 Oct 2019 01:52:12 -0400 Subject: [PATCH 031/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 60 +++++++++++++++--------------- 1 file changed, 30 insertions(+), 30 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index 6508aece3..d946cd1e4 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -4074,15 +4074,15 @@ Note: Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -date | No | YYYYMMDD |1. This field should meet the character limit/restrictions

Note: Date field allows current date and also any date in past/future | 1. DATE field in unexpected format. Expects YYYYMMDD -Notice_type |Yes| Valid Options mentioned General Notice (submitNotice) section | 1. This required field should be validated | 1. Opportunity type is required +date | No (Yes for Award) | YYYYMMDD |1. This field should meet the character limit/restrictions

Note: Date field allows current date and also any date in past/future | 1. DATE field in unexpected format. Expects YYYYMMDD +notice_type |Yes| Valid Options mentioned General Notice (submitNotice) section | 1. This required field should be validated | 1. Opportunity type is required zip| No| 5 digits| NA |NA classcod |No| Valid classification code (FAR, Section 5.207(g)) |1. This required field should be validated where applicable

2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required

2. This opportunity cannot be published. Classification Code provided did not match expected codes. -naics |No| Valid NAICS Code NAICS Reference |NA | NA +naics |No (Yes for Combined Synopsis/Solicitation & Solicitation)| Valid NAICS Code NAICS Reference |NA | NA offadd| No| 65535 characters| NA| NA officeid |No |20 characters |1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided


3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check subject |Yes – for all; NA – for submitDocumentAndLinks |255 characters| 1. This required field should be validated |1. $.data.title: is missing but it is required -solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

2. If duplicate solicitation number is given, then system throws an error

3. For an invalid solnbr and notice_type combination, the service throws an error| 1.Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Opportunity not found with given solicitation number and ntype +solnbr| (No for Special Notice)| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

2. If duplicate solicitation number is given, then system throws an error

3. For an invalid solnbr and notice_type combination, the service throws an error| 1.Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Opportunity not found with given solicitation number and ntype ntype| no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |NTYPE value provided is not valid awdnbr| Yes – For Award, ITB & JA; No – For rest| 255 characters| 1. This required field should be validated| 1. Award Details Section - Contract Award Number is a required field donbr| Yes – For JA; No – For rest |255 characters |1. This is required field for JA |1. Award Details Section - Task/Delivery Order Number is required field @@ -4090,12 +4090,12 @@ awdamt |Yes – For Award; No – For rest| 64 characters| 1. This required fiel linenbr| No| 255 characters| NA |NA awddate |Yes – For award; No – for rest |YYYYMMDD| 1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

2. This required field should be validated| 1. DATE field in unexpected format. Expects YYYYMMDD

2. Award Details Section - Contract Award Date is required field. stauth| Yes – For JA

No – for rest | Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

Description of each of these stauth values is captured in Stauth Values section

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ | Both foja & stauth values will be given under stauth in legacy | NA -respdate| Yes – For SubmitCombined No- For rest| YYYYMMDD | 1. No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2)

3. For submitCombined this field is required | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Inactive date provided is in the past

4. Response Date is required +respdate| Yes – For Combined Synopsis/Solicitation & Solicitation; No- For rest| YYYYMMDD | 1. No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2)

3. For submitCombined this field is required | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Inactive date provided is in the past

4. Response Date is required archdate| No| YYYYMMDD |1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction

2. This date cannot be current or in past; has to be in future| 1. DATE field in unexpected format Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past. awardee |Yes – for award

No – for Rest| 6553 characters| NA| NA awardee_duns| No |9 digits with optional plus 4| NA| NA -contact |Yes – For presol, submitSourcesSought, combined, ITB, JA, award, solicitation and submitSaleofSurplus

No – For rest |65535 characters Default value = Primary Other types are: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required -desc| Yes – For presol, submitSourcesSought , combined, ITB, special, solicitation and surplus

No – For rest |65535 characters| 1. This required field should be validated.| 1. Description is required +contact |No - for Award & Special Notice; Yes - for Rest |65535 characters Default value = Primary Other types are: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required +desc| No – Justfication & Award ; Yes - for Rest |65535 characters| 1. This required field should be validated.| 1. Description is required link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA | NA email| Yes
No if type=Award| 128 characters| NA |NA links |No |Array of links |NA |NA @@ -4103,7 +4103,7 @@ files| No| Array of files| NA| NA setaside| No| See Set-Aside Values section for valid codes| NA |NA popaddress| No| 65535 characters| This is a free Text. No validation is performed on this field | popzip |No |5 digits| NA| NA -popcountry| Yes – Only Award type No – For rest |32 characters| 1. This required field should be validated for Award type only| 1. Award Details Section - Country is a required field +popcountry| No| 1. Award Details Section - Country is a required field city |No |NA |NA| NA state |No |NA| NA| NA recovery_act| No| True or False| NA |NA @@ -4123,13 +4123,13 @@ naics |No| Valid NAICS Code NAICS Reference| NA| NA offadd| No |65535 characters |NA| NA officeid |Yes |20 characters | 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check subject |Yes |255 characters| 1. This required field should be validated| 1. $.data.title: is missing but it is required -solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces -respdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future

3. When giving future date, response date cannot exceed 5 years from the current date |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Response Date cannot exceed 5 years from current date +solnbr |No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces +respdate| No for Presol and Sources Sought; Yes - for Presol IF 15 days after response is selected| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future

3. When giving future date, response date cannot exceed 5 years from the current date |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Response Date cannot exceed 5 years from current date archdate |No |YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Inactive date provided is in the past. contact| Yes| 65535 characters

Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated| 1. Primary Contact is required desc |Yes | 65535 characters| 1. This required field should be validated |1. Description is required link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA |NA -email | Yes
No if type=Award| 128 characters| | NA +email | Yes | 128 characters| | NA links| No| Array of links| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete files| No| Array of files| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete setaside| No| See Set-Aside Values section for valid codes |NA |NA @@ -4152,13 +4152,13 @@ naics |Yes |Valid NAICS Code NAICS Reference| 1. This required field should be officeid |Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check offadd| No| 65535 characters| NA| NA subject |Yes| 255 characters| 1. This required field should be validated| 1. $.data.title: is missing but it is required -solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces +solnbr |No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces respdate| Yes |YYYYMMDD |1. This required field should be validated

2. This field should meet the character limit/restrictions

3. This date cannot be in past; has to be in future

4. When giving future date, response date cannot exceed 5 years from the current date.| 1. This opportunity cannot be published. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. This opportunity cannot be published. Response date provided is in the past

4. This opportunity cannot be published. Response Date cannot exceed 5 years from current date archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past contact| Yes| 65535 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated| 1. Primary Contact is Required desc| Yes | 65535 characters| 1. This required field should be validated| 1. Description is required link |No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA -email |Yes
No if type=Award |128 characters |NA | NA +email |Yes |128 characters |NA | NA links| No |Array of links| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files |No |Array of files| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete setaside| No| See Set-Aside Values section for valid codes| NA| NA @@ -4181,17 +4181,17 @@ naics |No |Valid NAICS Code NAICS Reference| NA| NA officeid| Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check offadd| No| 65535 characters| NA| NA subject |Yes| 255 characters| 1. This required field should be validated| 1. $.data.title: is missing but it is required -solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype -ntype| no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error |1. Opportunity not found with given solicitation number and ntype

2. Invalid NTYPE value provided +solnbr |No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype +ntype| no| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error |1. Opportunity not found with given solicitation number and ntype

2. Invalid NTYPE value provided awdnbr| Yes| 255 characters from the set: a-z A-Z 0-9 - _ ( ) {} |1. This required field should be validated

2. This field accepts only valid characters as mentioned under character limit/restrictions column | 1. Award Details Section - Contract Award Number is a required field

2. Award Details Section - Contract Award Number - Please enter a valid number donbr| No| 255 characters from the set: a-z A-Z 0-9 - _ ( ) | NA| NA archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past -contact| Yes |65535 characters

65535 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated | 1. Primary Contact is Required -desc| Yes| 65535 characters| 1. This required field should be validated |1. Description is required +contact| No |65535 characters

65535 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated | 1. Primary Contact is Required +desc| No| 65535 characters| 1. This required field should be validated |1. Description is required link| No |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) |NA |NA link |No | | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files| No | | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete -email| Yes
No if type=Award| 128 characters| NA | +email| Yes| 128 characters| NA | recovery_act| No| True or False| NA| NA correction| No| True or False

If correcting a previously submitted itb notice, specify true and the system will lookup the itb by award number, delivery number and sol number if applicable| 1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice and correction = true, then the service throws an error

2. If correction = True and the system cannot return a single record for the same delivery number/ award number / sol-number or combination of all three, then the service throws an error

3. If correction = True and the system returns more than one record for the same delivery number/ award number / sol-number or combination of all three, then service throws an error| 1. Notice could not be found for correction

2. Notice could not be found for correction

3. Multiple Notices found. Please input more details @@ -4205,17 +4205,17 @@ Element Name | Required | Character Limit / Restrictions | Business Rules | Erro ------ | ------- | ------- | ------- | -------- date| No| YYYYMMDD| 1. This field should meet the character limit/restrictions

Note: Date field allows current date and also any date in past/future| 1. DATE field in unexpected format. Expects YYYYMMDD zip| No| 5 digits| NA| NA -classcod |Yes – For combined type, presol type, Sale of surplus

No – For test |Valid classification code (FAR, Section 5.207(g)) |1. This field is required and should be validated

2. If a wrong classification code is given, then service throws an error |1. PSC code is required

2. This opportunity cannot be published. Classification Code provided did not match expected codes -naics |Yes – For combined type

No – For rest| Valid NAICS Code NAICS Reference |1. For combined, this field is required and should be validated| 1. NAICS code is required +classcod |Yes – For Combined/Sale of Surplus/ITB/Justification

No – For rest |Valid classification code (FAR, Section 5.207(g)) |1. This field is required and should be validated

2. If a wrong classification code is given, then service throws an error |1. PSC code is required

2. This opportunity cannot be published. Classification Code provided did not match expected codes +naics |Yes – For Combined/Solicitation

No – For rest| Valid NAICS Code NAICS Reference |1. For combined, this field is required and should be validated| 1. NAICS code is required officeid| Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make modifications to an opportunity associated to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check offadd| No |65535 characters| NA| NA subject |Yes| 255 characters| 1. This required field should be validated |1. $.data.title: is missing but it is required -solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required |1a. This required field if not given, service will throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If a space is given along with numbers in this field, then service throws an error

3. If solicitation & ntype combination is not matched, then service throws an error| 1. Multiple notices found. Please input more details

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

3. Notice not found for correction +solnbr| No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required |1a. This required field if not given, service will throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If a space is given along with numbers in this field, then service throws an error

3. If solicitation & ntype combination is not matched, then service throws an error| 1. Multiple notices found. Please input more details

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

3. Notice not found for correction ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. NTYPE value provided is not valid -respdate |Yes – Combined No – For rest |YYYYMMDD |1. This required field is validated for combined type

2. No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction

3. This date cannot be in past; has to be in future| 1. This opportunity cannot be published. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. This opportunity cannot be published. Response date provided is in the past +respdate |Yes – for Combined/Solicitation/ Sources Sought & Presol (when 15 days after resposne is selected) No – For rest |YYYYMMDD |1. This required field is validated for combined type

2. No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction

3. This date cannot be in past; has to be in future| 1. This opportunity cannot be published. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. This opportunity cannot be published. Response date provided is in the past archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past -contac| No – For Special notice

Yes – For rest |65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required -desc |Yes| 65535 characters| 1. This required field should be validated |1. Description is required +contact| No – For Award/Special notice

Yes – For rest |65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required +desc |Yes - for Award/Justification; No - For Rest| 65535 characters| 1. This required field should be validated |1. Description is required link| No |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA |NA links |No |Collection |1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete @@ -4249,8 +4249,8 @@ naics| No – this may change in future |Valid NAICS Code NAICS Reference| NA| offadd| No| 65535 characters| NA| NA officeid| Yes| 20 characters |1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue subject |Yes| 255 characters |1. This required field should be validated |1. $.data.title: is missing but it is required -solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required| 1. This required field if not given will throw an error

2. Duplicate solicitation number cannot be submitted

(Refer error #2) 3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error. |1. Notice Id is required

2. Notice ID for the selected opportunity type already exits

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype -ntype |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation|1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Invalid NTYPE value provided +solnbr| No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required| 1. This required field if not given will throw an error

2. Duplicate solicitation number cannot be submitted

(Refer error #2) 3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error. |1. Notice Id is required

2. Notice ID for the selected opportunity type already exits

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype +ntype |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation|1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Invalid NTYPE value provided stauth |Yes| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

Description of each of these stauth values is captured in Stauth Value section

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’| 1. This required field should be validated

Note: Both foja & stauth values will be given under stauth in legacy |1. This opportunity cannot be published. Authority is required awdnbr |Yes| 255 characters| 1. This required field should be validated |1. Award Details Section - Contract Award Number is a required field modnbr| No |32 characters| NA| NA @@ -4281,8 +4281,8 @@ naics | No| Valid NAICS Code NAICS Reference| NA| NA offadd| No |65535 characters| NA| NA officeid |Yes |20 characters |1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check subject |Yes| 255 characters| 1. This required field should be validated |$.data.title: is missing but it is required -solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}| 1. This required field should be validated

2. If a space is given along with numbers in this field, then service throws an error

3. If solicitation & ntype combination is not matched, then service throws an error| 1. Notice Id is required

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

3. Opportunity not found with given solicitation number and ntype -ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation| 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. +solnbr |No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}| 1. This required field should be validated

2. If a space is given along with numbers in this field, then service throws an error

3. If solicitation & ntype combination is not matched, then service throws an error| 1. Notice Id is required

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

3. Opportunity not found with given solicitation number and ntype +ntype| No| Valid values: "COMBINE" - for Combined Synopsis/Solicitation, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation| 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. awdnbr| Yes| Valid numbers| 1. This required field should be validated

2. If an invalid number is given (e.g with special characters), then service throws an error| 1. Award Details Section - Contract Award Number is a required field

2. Award Details Section - Contract Award Number - Please enter a valid number awdamt| Yes| Valid integer values| 1. This required field should be validated

2. If an invalid integer values is given, then service throws an error |1. Award Details Section - Amount is a required field

2. Award Details Section - Please enter valid integer for Amount Field linenbr |No| 255 characters| NA| NA @@ -4290,10 +4290,10 @@ awddate |Yes| YYYYMMDD |1. This required field should be validated

2. I archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future| 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past awardee| Yes| 65535 characters| 1. This required field should be validated |1. Award Details Section - Contractor Awarded Name is a required field awardee_duns |No| 9 digits with optional plus 4 |NA |NA -contact| Yes| 65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required +contact| No| 65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required desc| No| 65535 characters| NA| NA link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA -email| Yes
No if type=Award| 128 characters| NA| NA +email| No | 128 characters| NA| NA links| No| |1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete files| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete setaside| No| See Set-Aside Values section for valid codes| NA| NA From 7bea935180f13ffa270cf528421556fe524a83ad Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Fri, 25 Oct 2019 02:38:05 -0400 Subject: [PATCH 032/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 56 +++++++++++++++--------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index d946cd1e4..e86a408e2 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -4090,7 +4090,7 @@ awdamt |Yes – For Award; No – For rest| 64 characters| 1. This required fiel linenbr| No| 255 characters| NA |NA awddate |Yes – For award; No – for rest |YYYYMMDD| 1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

2. This required field should be validated| 1. DATE field in unexpected format. Expects YYYYMMDD

2. Award Details Section - Contract Award Date is required field. stauth| Yes – For JA

No – for rest | Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

Description of each of these stauth values is captured in Stauth Values section

Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ | Both foja & stauth values will be given under stauth in legacy | NA -respdate| Yes – For Combined Synopsis/Solicitation & Solicitation; No- For rest| YYYYMMDD | 1. No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2)

3. For submitCombined this field is required | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Inactive date provided is in the past

4. Response Date is required +respdate|Yes – for Combined/Solicitation; No – For rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)| YYYYMMDD | 1. No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2)

3. For submitCombined this field is required | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Response date provided is in the past

3. This opportunity cannot be published. Inactive date provided is in the past

4. Response Date is required archdate| No| YYYYMMDD |1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction

2. This date cannot be current or in past; has to be in future| 1. DATE field in unexpected format Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past. awardee |Yes – for award

No – for Rest| 6553 characters| NA| NA awardee_duns| No |9 digits with optional plus 4| NA| NA @@ -4211,8 +4211,8 @@ officeid| Yes| 20 characters| 1. This field is required

2. If an invalid offadd| No |65535 characters| NA| NA subject |Yes| 255 characters| 1. This required field should be validated |1. $.data.title: is missing but it is required solnbr| No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required |1a. This required field if not given, service will throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If a space is given along with numbers in this field, then service throws an error

3. If solicitation & ntype combination is not matched, then service throws an error| 1. Multiple notices found. Please input more details

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

3. Notice not found for correction -ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. NTYPE value provided is not valid -respdate |Yes – for Combined/Solicitation/ Sources Sought & Presol (when 15 days after resposne is selected) No – For rest |YYYYMMDD |1. This required field is validated for combined type

2. No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction

3. This date cannot be in past; has to be in future| 1. This opportunity cannot be published. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. This opportunity cannot be published. Response date provided is in the past +ntype| No|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. NTYPE value provided is not valid +respdate |Yes – for Combined/Solicitation; No – For rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected) |YYYYMMDD |1. This required field is validated for combined type

2. No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction

3. This date cannot be in past; has to be in future| 1. This opportunity cannot be published. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. This opportunity cannot be published. Response date provided is in the past archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past contact| No – For Award/Special notice

Yes – For rest |65535 characters Default value: Primary

Other types: Secondary, Owner |1. This required field should be validated| 1. Primary Contact is Required desc |Yes - for Award/Justification; No - For Rest| 65535 characters| 1. This required field should be validated |1. Description is required @@ -4312,9 +4312,9 @@ Element Name | Required | Character Limit / Restrictions | Business Rules | Erro date| No| YYYYMMDD| Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD officeid| No |20 characters| 1. If an invalid officeid is given, then service throws an error

2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

3. Officeid must be associated with user account |1. Invalid officeid provided

2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check solnbr| Yes |128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If solicitation & ntype combination is not matched, then service throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces -ntype |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation| 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Notice Type value provided is not valid +ntype |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation| 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Notice Type value provided is not valid uploadtype| No – May change in future Upload type accepts 2 types – link or file| A for amendment, S for solicitation or any title for other; 255 characters| NA| NA -respdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions |1. DATE field in unexpected format. Expects YYYYMMDD +respdate|Yes – for Combined/Solicitation; No – For rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions |1. DATE field in unexpected format. Expects YYYYMMDD links| No| Array of files| 1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

2. If a link with same name already exists on the notice, then the system throws an error.

3. If the Url is empty for a link, then the system throws an error.

4. If the description is missing for a link, then the system throws an error.| 1. Links and/or files are not complete

2. Resource with the same name already exists

3. Link Resource must have a link

4. Link Resource must have a description files |No| Array of files| 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error

2. If the filename is not provided for a file, then the system throws an error

3. If the filedata is empty for a file, then the system throws an error

4. If the filename provided has either no type specified or is an unsupported type, then the system throws an error

5. If the file size exceeds 250MB, then the system throws an error

6. If a file with same name already exists on the notice, then the system throwns an error |1. Links and/or files are not complete

2. Attachment must have a name

3. Attachment must have content

4. The file type that you are trying to upload is not supported

5. The file type that you are trying to upload is not supported

6. Resource with the same name already exists @@ -4347,7 +4347,7 @@ desc| Yes |65535 characters| 1. This required field should be validated| 1. Desc link| No |255 characters, consist of a restricted set of characters (see URL specification - RFC 2396) |NA| NA links| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete files| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete -email| No| 128 characters| NA| NA +email| Yes| 128 characters| NA| NA recovery_act| No| True or False| NA| NA #### submitSolicitation @@ -4363,7 +4363,7 @@ naics |Yes |Valid NAICS Code NAICS Reference| 1. This required field should be officeid |Yes| 20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account |1. Invalid officeid provided

2. Insufficient privileges to create opportunity. offadd| No| 65535 characters| NA| NA subject |Yes| 255 characters| 1. This required field should be validated| 1. Title is a required field. -solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Notice ID is a required field

2. Notice ID must be unique based on selected notice type

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces +solnbr |No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated

2. If submitting a notice with same solnbr number, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Notice ID is a required field

2. Notice ID must be unique based on selected notice type

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces respdate| Yes |YYYYMMDD |1. This required field should be validated

2. This field should meet the character limit/restrictions

3. This date cannot be in past; has to be in future

4. When giving future date, response date cannot exceed 5 years from the current date.| 1. Response date is required

2. DATE field in unexpected format. Expects YYYYMMDD

3. Response Date cannot be in the past

4. Response Date cannot exceed 5 years from current date archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. Inactive date provided is in the past desc| Yes | 65535 characters| 1. This required field should be validated| 1. Description is a required field @@ -4391,14 +4391,14 @@ naics |No |Valid NAICS Code NAICS Reference| NA| NA offadd| No| 65535 characters| NA| NA officeid| Yes |20 characters| 1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account| 1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue subject| Yes |255 characters |1. This required field should be validated |1. $.data.title: is missing but it is required -solnbr |Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required |1. This required field should be validated

2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces +solnbr |No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required |1. This required field should be validated

2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future | 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past contact |Yes| 65535 characters Default value: Primary

Other types: Secondary, Owner| 1. This required field should be validated |1. Primary Contact is Required desc| Yes| 65535 characters |1. This required field should be validated |1. Description is required link| No| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)| NA| NA links| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error| 1. Links and/or files are not complete files| No| | 1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error |1. Links and/or files are not complete -email| No| 128 characters| NA| NA +email| Yes| 128 characters| NA| NA recovery_act| No| True or False| NA| NA #### deleteNoticeOrDocumentPackage @@ -4407,8 +4407,8 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr| Yes if non-award| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces -awdnbr| Yes if award| 255 characters| If neither solnbr or awdnbr is provided, then the system throws an error| Solicitation Number or Award Number is required +solnbr| No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces +awdnbr| Yes - for Award/ITP/JA; No - for Rest| 255 characters| If neither solnbr or awdnbr is provided, then the system throws an error| Solicitation Number or Award Number is required ntype|No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid deletetype| no| Valid values: “notice” to delete the notice, “attachment” to delete attachments and links from the notice| 1. If an invalid deletetype is provided, then service throws an error | Delete type provided is not “notice” or “attachment” deletemethod| no| Valid Values: “all” to delete all versions or “latest” to delete latest version |1. If an invalid deletemethod is provided, then service throws an error | Delete method provided is not “latest” or “all” @@ -4421,7 +4421,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- date| No| YYYYMMDD| Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD -solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error| 1. Multiple notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces +solnbr| No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error| 1. Multiple notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces officeid |No| 20 characters| Officeid must be associated with user account |NA ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If an invalid ntype is provided, then service throws an error

2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be current or in past; has to be in future |1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be published. Archive date provided is in the past @@ -4434,10 +4434,10 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If solicitation & ntype combination is not matched, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found for correction +solnbr| No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If solicitation & ntype combination is not matched, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found for correction officeid| No |20 characters| Officeid must be associated with user account |NA ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. NTYPE value provided is not valid -awdnbr |No| 255 characters| NA| NA +awdnbr |Yes - for Award/ITB/Justification; No - for Rest| 255 characters| NA| NA archdate| Yes| YYYYMMDD| 1. This required field should be validated

2. If this value is available, this field should meet the character limit/restrictions

3. If current date or a past date is provided, then the system throws an error

3. If no archive date is given, then the system throws an error| 1. DATE field in unexpected format. Expects YYYYMMDD

2. New archive date provided is in the past

3. $.reason: null found, string expected. Unable to process request. Please try again #### cancelNotice @@ -4451,12 +4451,12 @@ Element Name | Required | Character Limit / Restrictions | Business Rules | Erro date| No| YYYYMMDD |Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD officeid| No |20 characters| Officeid must be associated with user account |NA subject| No| 255 characters| NA| NA -solnbr| Yes |128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If valid solnbr is given with a different ntype, then service throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple Notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces +solnbr| No |128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If valid solnbr is given with a different ntype, then service throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple Notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces ntype |No |Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error | 1. Notice Type value provided is not valid -awdnbr| No| 255 characters| NA| NA +awdnbr| Yes - for Award/ITB/Justification; No - for Rest| 255 characters| NA| NA archdate| No| YYYYMMDD| 1. No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

2. This date cannot be in past; has to be in future| 1. DATE field in unexpected format. Expects YYYYMMDD

2. This opportunity cannot be cancelled -contact| No| 65535 characters Default value: Primary

Other types: Secondary, Owner| NA| NA -desc| Yes| 65535 characters| 1. This required field should be validated | 1. Unable to process request. Please try again +contact|No – For Award/Special Notice; Yes – For Rest| 65535 characters Default value: Primary

Other types: Secondary, Owner| NA| NA +desc| No - For Award/Justification; Yes - For Rest| 65535 characters| 1. This required field should be validated | 1. Unable to process request. Please try again #### getNoticeData @@ -4464,7 +4464,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -notice_id |Yes| Unique ID found from getList call or ID’s for changes found in getNoticeData call| Notice_id is required| notice_id from getList is required +notice_id |No – For Special Notice; Yes – For Rest| Unique ID found from getList call or ID’s for changes found in getNoticeData call| Notice_id is required| notice_id from getList is required Get_changes| No |True or False

Pass in true to get the full notice history with all changes| NA| NA get_changes_from_date| No| If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned| Date field should meet the expected format.| DATE field in unexpected format. Expects YYYYMMDD get_file_data |No |True or False

Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the meta details/links will still be provided |NA |NA @@ -4476,9 +4476,9 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -notice_type |No| Solicitation type

Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL

Note: Searches for awards, ja and itb’s will return both standalone notices AND base notices that contain one of these type |Notice_type if given should be valid | Notice Type is not recognized

Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB +notice_type |No| Solicitation type

Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL

Note: Searches for AWARDS, JA and ITB will return both standalone notices AND base notices that contain one of these type |Notice_type if given should be valid | Notice Type is not recognized

Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB solnbr| No| Solicitation #| NA| NA -awdnbr| No| Award #| NA| NA +awdnbr| Yes for Award/ITB/Justification; No for Rest| Award #| NA| NA posted_from |No |Posted From Date. YYYYMMDD| Date field should meet the expected format| DATE field in unexpected format. Expects YYYYMMDD posted_to| No |Posted To Date. YYYYMMDD |Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD documents_to_search| No |Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided| NA| NA @@ -4498,7 +4498,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr| Yes| Solicitation Number| 1. If an incorrect solicitation number and ntype combination is given, the service throws an error

2a. If this required field if not given, service throws an error

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found

2a. Notice not found

2b. Multiple Notices found. Please input more details +solnbr| No| Solicitation Number| 1. If an incorrect solicitation number and ntype combination is given, the service throws an error

2a. If this required field if not given, service throws an error

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found

2a. Notice not found

2b. Multiple Notices found. Please input more details ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | NA |NA #### getAuthorizedPartyList @@ -4507,7 +4507,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr| Yes| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details +solnbr| No| 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation| If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. addAuthoizedParty service is deprecated for Non-FBO Solicitations status| No| Valid Options: approved, pending, rejected, “empty value”

If empty, all status will be returned

Note, use “pending” to pull the pending explicit access requests |1. If the status value entered doesn’t match the valid values , then the system throws an error| 1. Status value is invalid @@ -4518,7 +4518,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr |Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error |1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details +solnbr |No | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error |1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations id| Yes| | 1. If the request Id is not provided, then the system throws an error

2. If the request Id provided is already approved, then the service throws an error

3. If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

4. If the solicitation number provided matches with the solicitation number of the request Id but does not match with the provided N type, then the service throws an error |1. Internal ID is required. Use getAuthorizedPartyList to retrieve this information

2. Request with Request ID: #id already approved

3. You have request that is tied to different solicitation number

4. You have request that is tied to the same solicitation number but different notice type @@ -4529,7 +4529,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr |Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. +solnbr |No | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations vendor |Yes| Vendor Data |1. If all the elements in the Vendor Data complex definition are not provided, then the system throws an error.
2. If no match is found in the system for the vendor data provided, then the system throws an error.
3. If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error.| 1. This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown.
2. No contact match on vendor data provided.
3. Request with Request ID: #id already approved. @@ -4540,7 +4540,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr| Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details +solnbr| No | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr |No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. addAuthoizedParty service is deprecated for Non-FBO Solicitations vendor| Yes| Vendor Data| 1. If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

2. If no match is found in the system for the vendor data provided, then the system throws an error
3. If the vendor is already added as an authorized party on the notice, then the system throws an error.| 1. This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

2. No contact match on vendor data provided
3. Duplicate request. Vendor is already added as an authorized party on the notice @@ -4551,7 +4551,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr| Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error| 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
4. Multiple notices found. Please input more details +solnbr| No | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error| 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
4. Multiple notices found. Please input more details ntype| No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation | 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations id| Yes || 1. If the request Id is not provided, then the system throws an error

2. If the request Id provided is already rejected, then the service throws an error

3. If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

4. If the solicitation number provided matches with the solicitation number of the request Id but does not match with the provided N type, then the service throws an error| 1. Internal ID is required. Use getAuthorizedPartyList to retrieve this information

2. Request with Request ID: #id already rejected

3. You have request that is tied to different solicitation number

4. You have request that is tied to the same solicitation number but different notice type @@ -4562,7 +4562,7 @@ Individual business rules per field are listed across each of the fields in belo Element Name | Required | Character Limit / Restrictions | Business Rules | Error Messages with respect to business rules (If any) ------ | ------- | ------- | ------- | -------- -solnbr |Yes | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. +solnbr |No | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. ntype |No| Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. nonfbo_solbr | No| | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations vendor| Yes| Vendor Data| 1. If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

2. If no match is found in the system for the vendor data provided, then the system throws an error
3. If the vendor is already added as an authorized party on the notice, then the system throws an error.| 1. This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

2. No contact match on vendor data provided
3. Duplicate request. Vendor is already added as an authorized party on the notice From 01c3e2c0e3ee699eca5c7b81fd3d75b9533d46d9 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Fri, 25 Oct 2019 02:39:16 -0400 Subject: [PATCH 033/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 81c9cb9d3..2f3c74559 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -3303,12 +3303,9 @@ Date | Version | Description 8/19/2019 | v0.72 | API Names Updated
Valid File Types Updated 8/29/2019| v0.73| Error Codes Added 8/29/2019| v0.74| Updated the missing description for explicitAccess field in Update Attachment Contract JSON -<<<<<<< HEAD 10/9/2019 | v0.75| Get List of Opportunities API Parameter Changes (cancelled field removed/status field updated) 10/22/2019 | v0.76| Create and Publish JSON field for Archive.Date and Response Date updated
Production Link Updated
API URLs updated -======= 10/10/2019 | v0.8 | Updated the Set-Aside values with the latest codes ->>>>>>> master

Back to top

From ead0b84c0b73a63a1452d194a0b4dd45b8591ee6 Mon Sep 17 00:00:00 2001 From: Prashant Pillai Date: Fri, 25 Oct 2019 12:05:20 -0400 Subject: [PATCH 034/149] update attachments --- _apidocs/opportunities-api.md | 76 ++++++++++++++++++++++++++--------- 1 file changed, 58 insertions(+), 18 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 6d60b8481..5881d1ffe 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -1984,7 +1984,7 @@ Parameter Name | Parameter Type | Data Type | Required | Description Authorization | Header | string | Yes | Valid and authorized user ID api_key | query | string | Yes | Valid System Account API Key opportunityId | query | string | Yes | Opportunity ID -resourceId | query | string | Yes | Attachment ID +resourceId | query | string | Yes | Resource ID Request JSON | Body | JSON | Yes | [Refer Update Attachment Contract JSON](#update-attachment-contract-json)

Back to top

@@ -1998,30 +1998,71 @@ HTTP Status Code | Response Type | Reason | Description Examples
-Update Attachment Request - file +Update Attachment Request - Change File Access : Controlled Unclassified (Only applicable to files that are not published) 

 {
   "attType": "file",
   "packageAccessLevel": "private",
-   "explicitAccess": "1",
- "content": "SGVsbG8=",
- "fileType": "text/plain"
+  "explicitAccess": "1"
 }

-Update Attachment Request - link +Update Attachment Request - Change File Access : Public (Only applicable to files that are not published) 

 {
   "attType": "file",
-  "packageAccessLevel": "private",
-   "explicitAccess": "1",
- "content": "SGVsbG8=",
- "fileType": "text/plain"
+  "packageAccessLevel": "public",
+  "explicitAccess": "0"
+}
+
+

+
+ +
+Update Attachment Request - Change File Name (Only applicable to files that are not published) +

+

+{
+  "resourceName": "newFileName.pdf"
+}
+
+

+
+ +
+Update Attachment Request - Change Resource Order (Applicable to both files and links) +

+

+{
+  "sortOrderChanged": true,
+  "resourceIdBelow": "292dc517a19b4e43846f39d20e6f7ecf"
+}
+
+

+
+ +
+Update Attachment Request - Change Resource Order (Move resource to the bottom.(Applicable to both files and links)) +

+

+{
+  "sortOrderChanged": true
+}
+
+

+
+ +
+Update Attachment Request - Change Link Display text +

+

+{
+  "resourceName": "New Display Text"
 }

@@ -3128,9 +3169,7 @@ Flash Video (.flv, .f4v)| video/x-flv { "attType": "file", "packageAccessLevel": "private", - "explicitAccess": "1", -"content": "SGVsbG8=", -"fileType": "text/plain" + "explicitAccess": "1" }

@@ -3141,11 +3180,12 @@ Flash Video (.flv, .f4v)| video/x-flv Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ -attType | string | link, file | Yes | Type of attachment, either link or file -link | string | | Yes (if attType=link) | Resource link or URL -packageAccessLevel | string | public,private(default public) | No | Type of access to file or link -resourceName | string | | Yes (if attType=file) | Name of file -explicitAccess | string | 0, 1 | No | Defaults to '0' (public access) if not provided. '1' is used for Controlled Unclassified files. +attType | string | link, file | No | Should be provided if file access level is changed. +packageAccessLevel | string | public,private(default public) | No | Type of access to file or link. Should be provided if file access level is changed +resourceName | string | | No | Name of file +explicitAccess | string | 0, 1 | No | Defaults to '0' (public access) if not provided. '1' is used for Controlled Unclassified files. Should be provided if file access level is changed. +sortOrderChanged | boolean | true, false | No | Should be provided if file order is changed. +resourceIdBelow | string | | No | This should be Resource ID of the file/link that will display below the attachment/file that is moved.

Back to top

From 10e8a0120d436477e862b0b814bba773115f872d Mon Sep 17 00:00:00 2001 From: "anusha.paladugu" Date: Fri, 25 Oct 2019 12:17:47 -0400 Subject: [PATCH 035/149] added field lengths --- _apidocs/opportunities-api.md | 213 ++++++++++++++++++---------------- 1 file changed, 112 insertions(+), 101 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 5881d1ffe..9b611d39d 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -2812,96 +2812,95 @@ Examples * Field headers in the table must match with field headers shown in JSON example -Name | Data Type | Allowed Values | Required (Create/Update) | Required (to Publish) | Description ------|-----------|----------------|--------------------------|-----------------------|------------ -type | string | See Notice Types table | Yes | Yes | Notice Type -solicitationNumber | string | | No | Yes | Solicitation Number -title | string | | Yes | Yes | Title of the Opportunity -organizationId | string | | No for Create (Yes for Update) | Yes | FH Org Id/AAC code of the office where an Opportunity is being submitted -organizationLocationId | string | | No|No| Organization Location ID +Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (to Publish) | Description +-----|-----------|----------------|--------------------------|-----------------------|------------ |------------ +type | string | 1 character | See Notice Types table | Yes | Yes | Notice Type +solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number +title | string | 256 characters | |Yes | Yes | Title of the Opportunity +organizationId | string | 32 characters | No for Create (Yes for Update) | Yes | FH Org Id/AAC code of the office where an Opportunity is being submitted +organizationLocationId | string | | No|No| This field has been deprecated.Organization Location details will be pulled from the Federal Hierarchy classificationCode | string | | No | Yes (not required for type= r) | Product Service Code (PSC) -naics | JSON | NA | NA | NA | -naics.code | string | | No | Yes | NAICS Code -naics.type | string | primary | No | Yes | NAICS Type Note: 'p' must be in lower case -flags | JSON | NA | NA | NA | -flags.code | string | Recovery act | No | No | This is a recovery or Reinvestment Act Action -flags.IsSelected | boolean | default = True | No | No | -pointOfContact | JSON | NA | NA | NA | -pointOfContact.type | string | p | No | Yes | Contact Type Note: 'p' must be in lower case -pointOfContact.title | string | | No | No | Contact title -pointOfContact.fullname | string | | No | Yes | Contact Full Name -pointOfContact.email | string | | No | Yes (no if type = a) | Contact email -pointOfContact.phone | string | | No | No | Contact Phone -pointOfContact.fax | string | | No | No | Contact Fax -placeOfPerformance | JSON | NA | NA | NA | -placeOfPerformance.
streetAddess | string | | No | No | Pop Address -placeOfPerformance.
streetAddess2 | string | | No | No | Pop Address2 -placeOfPerformance.city | JSON | NA | NA | NA | Pop City -placeOfPerformance.city.
code | string | | No | No | Pop City code -placeOfPerformance.city.
name | string | | No | No | Pop City name -placeOfPerformance.state | JSON | NA | NA | NA | Pop City state -placeOfPerformance.state.
code | string | | No | No | Pop city state code -placeOfPerformance.state.
name | string | | No | No | Pop city state name -placeOfPerformance.country | JSON | NA | NA | NA | Pop Country -placeOfPerformance.
country.code | string | | No | No | Pop Country Code -placeOfPerformance.
country.name | string | | No | No | Pop Country name -placeOfPerformance.zip | string | | No | No | Pop Country zip -archive | JSON | NA | NA | NA | -archive.type | string | auto15, auto30, autocustom | No | Yes | Archive Type +naics | JSON | | NA | NA | NA | +naics.code | string | | No | Yes | valid NAICS Code +naics.type | string | |primary | No | Yes | NAICS Type Note: 'p' must be in lower case +flags | JSON | |NA | NA | NA | +flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action +flags.IsSelected | boolean | |default is 'True' | No | No | +pointOfContact | JSON | |NA | NA | NA | +pointOfContact.type | string | | p | No | Yes | Contact Type Note: 'p' must be in lower case +pointOfContact.title | string | | | No | No | Contact title +pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name +pointOfContact.email | string |255 characters | | No | Yes (no if type = a) | Contact email +pointOfContact.phone | string |255 characters | | No | No | Contact Phone +pointOfContact.fax | string | 255 characters | | No | No | Contact Fax +placeOfPerformance | JSON | | NA | NA | NA | +placeOfPerformance.
streetAddess | string | | | No | No | Pop Address +placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2 +placeOfPerformance.city | JSON | | NA | NA | NA | Pop City +placeOfPerformance.city.
code | string | | | No | No | Pop City code +placeOfPerformance.city.
name | string | | | No | No | Pop City name +placeOfPerformance.state | JSON | | NA | NA | NA | Pop City state +placeOfPerformance.state.
code | string | | | No | No | Pop city state code +placeOfPerformance.state.
name | string | | | No | No | Pop city state name +placeOfPerformance.country | JSON | | NA | NA | NA | Pop Country +placeOfPerformance.
country.code | string | | | No | No | Pop Country Code +placeOfPerformance.
country.name | string | | | No | No | Pop Country name +placeOfPerformance.zip | string | | | No | No | Pop Country zip +archive | JSON | | NA | NA | NA | +archive.type | string | | auto15, auto30, autocustom | No | Yes | Archive Type archive.date | date | | No | Yes (if archive.type=
autocustom) | Archive Date -permissions | JSON | NA | NA | NA | -permissions.ivl | JSON | NA | NA | NA | -permissions.ivl.create | boolean | | No | No | permissions.ivl.create -permissions.ivl.read | boolean | | No | No | permissions.ivl.read -permissions.ivl.update | boolean | Not In Use | Not In Use | Not In Use | Not In Use -permissions.ivl.delete | boolean | Not In Use | Not In Use | Not In Use | Not In Use -solicitation | JSON | NA | NA | NA | -solicitation.setAside | string | See Set-Aside values table | No | No | setAside -solicitation.deadlines | JSON | NA | NA | NA | -solicitation.
deadlines.response | date | YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o)
2) Yes (when archive.type=
auto1) | Deadline Date -solicitation.deadlines.
responseresponseTz | string | | No | No | Time Zone for
Solicitation Deadline Date -award | JSON | NA | NA | NA | -award.date | date | YYYY-MM-DD |No | Yes only for type= a | Award Date -award.number | string | | No | Yes only for type= i, j, a | Award Number -award.deliverOrderNumber | string | | No | No | Award Deliver Order Number -award.amount | number | | No | No | Award Amount -award.lineitemNumber | string | | No | No | Award Line item Number -award.awardee | JSON | NA | NA | NA | -award.awardee.manual | string | boolean | Yes | Yes | Awardee -award.awardee.name | string | | No | No | Awardee Name -award.awardee.duns | string | | No | No | Awardee Duns -award.awardee.location | JSON | NA | NA | NA | -award.awardee.location.
streetAddress | string | | No | No | Awardee Street Address 1 -award.awardee.location.
streetAddress2 | string | | No | No | Awardee Street Address 1 -award.awardee.location.
city | string | | No | No | Awardee City -award.awardee.location.
city.code | string | | No | No | Awardee City code -award.awardee.location.
city.name | string | | No | No | Awardee City name -award.awardee.location.
state | JSON | NA | NA | NA | -award.awardee.location.
state.code | string | | No | No | Awardee State code -award.awardee.location.
state.name | string | | No | No | Awardee State name -award.awardee.location.
country | JSON | NA | NA | NA | -award.awardee.location.
country.code | string | | No | No | Awardee Country code -award.awardee.location.
country.name | string | | No | No | Awardee Country Name -award.awardee.location.
zip | string | | No | No | Awardee Country Zip -justificationAuthority | JSON | NA | NA | NA | -justificationAuthority.
modificationNumber | string | | No | No | Justification Authority Modification Number -justificationAuthority.
authority | string | | No | No | Justification Authority +permissions | JSON | | NA | NA | NA | +permissions.ivl | JSON | | NA | NA | NA | +permissions.ivl.create | boolean | | | No | No | permissions.ivl.create +permissions.ivl.read | boolean | | | No | No | permissions.ivl.read +permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | Not In Use +permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | Not In Use +solicitation | JSON | | NA | NA | NA | +solicitation.setAside | string | |See Set-Aside values table | No | No | setAside +solicitation.deadlines | JSON | | NA | NA | NA | +solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o)
2) Yes (when archive.type=
auto1) | Deadline Date +solicitation.deadlines.
responseresponseTz | |string | | No | No | Time Zone for
Solicitation Deadline Date +award | JSON | | NA | NA | NA | +award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date +award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number +award.deliverOrderNumber | string | 255 characters| | No | No | Award Deliver Order Number +award.amount | number |64 digits | | No | No | Award Amount +award.lineitemNumber | string |255 characters | | No | No | Award Line item Number +award.awardee | JSON | | NA | NA | NA | +award.awardee.manual | string | |boolean | Yes | Yes | Awardee +award.awardee.name | string | 255 characters | | No | No | Awardee Name +award.awardee.duns | string | 9 digits | | No | No | Awardee Duns +award.awardee.location | JSON | | NA | NA | NA | +award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 1 +award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 1 +award.awardee.location.
city | string | | | No | No | Awardee City +award.awardee.location.
city.code | string | | | No | No | Awardee City code +award.awardee.location.
city.name | string | | | No | No | Awardee City name +award.awardee.location.
state | JSON | | NA | NA | NA | +award.awardee.location.
state.code | string | | | No | No | Awardee State code +award.awardee.location.
state.name | string | | | No | No | Awardee State name +award.awardee.location.
country | JSON | | NA | NA | NA | +award.awardee.location.
country.code | string | | | No | No | Awardee Country code +award.awardee.location.
country.name | string | | | No | No | Awardee Country Name +award.awardee.location.
zip | string | | | No | No | Awardee Country Zip +justificationAuthority | JSON | |NA | NA | NA | +justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number +justificationAuthority.
authority | | string | | No | No | Justification Authority link | JSON | NA | NA | NA | +link.href | string | | | No | No | Url for the notice on SAM.gov link.additionalInfo | JSON | NA | NA | NA | -link.additionalInfo.cotent | string | | No | No | Additional info -link.href | string | | No | No | Website Address +link.additionalInfo.content | string | | | No | No | Additional info additionalReporting | string | none/
auto_recovery | No | Yes | -description | JSON | NA | NA | NA | -description.body | string | | No | Yes | Description of notice -attType | string | link, file | No |No| Type of attachment, either link or file -content | byte | | No|No | File content in byte format -link | string | | |No|No | Resource link or URL -packageAccessLevel | string | public,private(default public) | No | No| Type of access to file or link -resourceName | string | | No|No | Name of file -fairOpportunity | string | |No|No| Fair Opportunity| -fairOpportunity.authority|string | |No|No| Fair Opportunity Authority -postedDate| date| |No|No| Posted Date -archived| string| | |No|No| Archived Status +description | JSON | | NA | NA | NA | +description.body | string | 65535 characters| | No | Yes | Description of notice +resources | JSON | | NA | NA | NA | +resources.attType | string | link, file | No |No| Type of attachment, either link or file +resources.content | byte |250MB | | No|No | File content in base64 format +resources.link | string | | |No|No | Resource link URL +resources.packageAccessLevel | string | | public,private(default public) | No | No| Type of access to file or link +resources.resourceName | string | 255 characters | | No|No | Name of file +postedDate| date| | |No|No| Posted Date +archived| boolean| | true or false |No|No| Archived Status

Back to top

@@ -3112,8 +3111,7 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) { "attType": "link", "link": "", - "description": "", - "packageAccessLevel": "" + "description": "" }

@@ -3125,11 +3123,12 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ attType | string | link, file | Yes | Type of attachment, either link or file -content | byte | | Yes (if attType=file) | File content in byte format -link | string | | Yes (if attType=link) | Resource link or URL -packageAccessLevel | string | public,private(default public) | No | Type of access to file or link +content | byte | | Yes (if attType=file) | File content in base64 format +packageAccessLevel | string | public,private(default public) | No | Type of access to file. Only used with attType 'file'. resourceName | string | | Yes (if attType=file) | Name of file - +fileType | string | | No | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#Valid File Types) +link | string | | Yes (if attType=link) | Resource link URL +description | string | | Yes (if attType=link) | Description of the link #### Valid File Types @@ -3159,17 +3158,27 @@ Flash Video (.flv, .f4v)| video/x-flv

Back to top

-### Update Attachment Contract JSON +### Update Attachment/Link Contract JSON -
+
-Update_Attachment_Contract_Json +Update_Attachment/Link_Contract_Json - To modify the access level of a draft attachment on a draft notice 

 {
  "attType": "file",
- "packageAccessLevel": "private",
- "explicitAccess": "1"
+ "packageAccessLevel": "",
+ "explicitAccess": ""
+}
+
+

+
+ +Update_Attachment/Link_Contract_Json - To modify the name of a draft attachment/link on a draft notice +

+

+{
+ "resourceName": ""
 }

@@ -3180,12 +3189,12 @@ Flash Video (.flv, .f4v)| video/x-flv Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ -attType | string | link, file | No | Should be provided if file access level is changed. -packageAccessLevel | string | public,private(default public) | No | Type of access to file or link. Should be provided if file access level is changed -resourceName | string | | No | Name of file -explicitAccess | string | 0, 1 | No | Defaults to '0' (public access) if not provided. '1' is used for Controlled Unclassified files. Should be provided if file access level is changed. +attType | string | link, file | No | Required only for file access level changes +packageAccessLevel | string | public,private(default public) | No | Type of access to file. Only used with attType 'file' +resourceName | string | | No | Name of file or link +explicitAccess | string | 0, 1 | No | Defaults to '0' (public access) if not provided. '1' is used for Controlled Unclassified files. Required only for file access level changes sortOrderChanged | boolean | true, false | No | Should be provided if file order is changed. -resourceIdBelow | string | | No | This should be Resource ID of the file/link that will display below the attachment/file that is moved. +resourceIdBelow | string | | No | This should be Resource ID of the file/link that will display below the file/link that is moved

Back to top

@@ -3374,6 +3383,8 @@ Date | Version | Description 8/29/2019| v0.73| Error Codes Added 8/29/2019| v0.74| Updated the missing description for explicitAccess field in Update Attachment Contract JSON 10/10/2019 | v0.8 | Updated the Set-Aside values with the latest codes +10/25/2019 | v0.9 | Updated the field lengths +

Back to top

From 44d44c6f4372b4c8cbf349280f0e47badb7816ba Mon Sep 17 00:00:00 2001 From: "anusha.paladugu" Date: Fri, 25 Oct 2019 12:41:46 -0400 Subject: [PATCH 036/149] minor fix --- _apidocs/opportunities-api.md | 52 ++++++++++++++++++----------------- 1 file changed, 27 insertions(+), 25 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 9b611d39d..b71eb4090 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -2817,50 +2817,50 @@ Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Req type | string | 1 character | See Notice Types table | Yes | Yes | Notice Type solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number title | string | 256 characters | |Yes | Yes | Title of the Opportunity -organizationId | string | 32 characters | No for Create (Yes for Update) | Yes | FH Org Id/AAC code of the office where an Opportunity is being submitted -organizationLocationId | string | | No|No| This field has been deprecated.Organization Location details will be pulled from the Federal Hierarchy -classificationCode | string | | No | Yes (not required for type= r) | Product Service Code (PSC) -naics | JSON | | NA | NA | NA | -naics.code | string | | No | Yes | valid NAICS Code +organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Org Id/AAC code of the office where an Opportunity is being submitted +organizationLocationId | string | | | No|No| This field has been deprecated.Organization Location details will be pulled from the Federal Hierarchy +classificationCode | string | | | No | Yes (not required for type= r) | Product Service Code (PSC) +naics | JSON | NA |NA | NA | NA | +naics.code | string | | | No | Yes | Valid NAICS Code naics.type | string | |primary | No | Yes | NAICS Type Note: 'p' must be in lower case -flags | JSON | |NA | NA | NA | +flags | JSON | NA |NA | NA | NA | flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action flags.IsSelected | boolean | |default is 'True' | No | No | -pointOfContact | JSON | |NA | NA | NA | +pointOfContact | JSON | NA |NA | NA | NA | pointOfContact.type | string | | p | No | Yes | Contact Type Note: 'p' must be in lower case pointOfContact.title | string | | | No | No | Contact title pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name pointOfContact.email | string |255 characters | | No | Yes (no if type = a) | Contact email pointOfContact.phone | string |255 characters | | No | No | Contact Phone pointOfContact.fax | string | 255 characters | | No | No | Contact Fax -placeOfPerformance | JSON | | NA | NA | NA | +placeOfPerformance | JSON | NA | NA | NA | NA | placeOfPerformance.
streetAddess | string | | | No | No | Pop Address placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2 -placeOfPerformance.city | JSON | | NA | NA | NA | Pop City +placeOfPerformance.city | JSON | NA | NA | NA | NA | Pop City placeOfPerformance.city.
code | string | | | No | No | Pop City code placeOfPerformance.city.
name | string | | | No | No | Pop City name -placeOfPerformance.state | JSON | | NA | NA | NA | Pop City state +placeOfPerformance.state | JSON |NA | NA | NA | NA | Pop City state placeOfPerformance.state.
code | string | | | No | No | Pop city state code placeOfPerformance.state.
name | string | | | No | No | Pop city state name -placeOfPerformance.country | JSON | | NA | NA | NA | Pop Country +placeOfPerformance.country | JSON | NA | NA | NA | NA | Pop Country placeOfPerformance.
country.code | string | | | No | No | Pop Country Code placeOfPerformance.
country.name | string | | | No | No | Pop Country name placeOfPerformance.zip | string | | | No | No | Pop Country zip -archive | JSON | | NA | NA | NA | +archive | JSON |NA | NA | NA | NA | archive.type | string | | auto15, auto30, autocustom | No | Yes | Archive Type -archive.date | date | | No | Yes (if archive.type=
autocustom) | Archive Date -permissions | JSON | | NA | NA | NA | -permissions.ivl | JSON | | NA | NA | NA | +archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date +permissions | JSON | NA | NA | NA | NA | +permissions.ivl | JSON | NA | NA | NA | NA | permissions.ivl.create | boolean | | | No | No | permissions.ivl.create permissions.ivl.read | boolean | | | No | No | permissions.ivl.read permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | Not In Use permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | Not In Use -solicitation | JSON | | NA | NA | NA | +solicitation | JSON |NA | NA | NA | NA | solicitation.setAside | string | |See Set-Aside values table | No | No | setAside -solicitation.deadlines | JSON | | NA | NA | NA | +solicitation.deadlines | JSON | NA | NA | NA | NA | solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o)
2) Yes (when archive.type=
auto1) | Deadline Date -solicitation.deadlines.
responseresponseTz | |string | | No | No | Time Zone for
Solicitation Deadline Date -award | JSON | | NA | NA | NA | +solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for
Solicitation Deadline Date +award | JSON | NA | NA | NA | NA | award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number award.deliverOrderNumber | string | 255 characters| | No | No | Award Deliver Order Number @@ -3097,8 +3097,8 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) "attType": "file", "content": "", "resourceName": "", - "fileType": "text/plain", - "packageAccessLevel": "public" + "fileType": "", + "packageAccessLevel": "" }

@@ -3162,19 +3162,21 @@ Flash Video (.flv, .f4v)| video/x-flv
-Update_Attachment/Link_Contract_Json - To modify the access level of a draft attachment on a draft notice +Update_Attachment_Contract_Json 

 {
  "attType": "file",
  "packageAccessLevel": "",
- "explicitAccess": ""
+ "explicitAccess": "",
+ "resourceName": "",
+ "sortOrderChanged":true ,
+ "resourceIdBelow": ""
 }

-
-Update_Attachment/Link_Contract_Json - To modify the name of a draft attachment/link on a draft notice +Update_Link_Contract_Json 

 {

From 2e4381820141db6b803a089eb9c44a5a7266b69e Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Fri, 25 Oct 2019 13:25:50 -0400
Subject: [PATCH 037/149] formatting fix

---
 _apidocs/opportunities-api.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index b71eb4090..9d21ee343 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -1985,7 +1985,7 @@ Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
 resourceId | query | string | Yes | Resource ID
-Request JSON | Body | JSON | Yes | [Refer Update Attachment Contract JSON](#update-attachment-contract-json)
+Request JSON | Body | JSON | Yes | [Refer Update Attachment Link Contract JSON](#update-attachment-link-contract-json)
 
 
Back to top

 
@@ -3126,7 +3126,7 @@ attType | string | link, file | Yes | Type of attachment, either link or file
 content | byte |  | Yes (if attType=file) | File content in base64 format
 packageAccessLevel | string | public,private(default public) | No | Type of access to file. Only used with attType 'file'.
 resourceName | string |  | Yes (if attType=file) | Name of file
-fileType | string |  | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#Valid File Types)
+fileType | string |  | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#Valid-File-Types)
 link | string |  | Yes (if attType=link) | Resource link  URL
 description | string |  | Yes (if attType=link) | Description of the link
 
@@ -3158,7 +3158,7 @@ Flash Video (.flv, .f4v)|	video/x-flv
 
 
Back to top

 
-### Update Attachment/Link Contract JSON
+### Update Attachment Link Contract JSON
 
 

 


From 3909ab81d7ba836d3c32a1c5eefa79fde7b2d457 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Fri, 25 Oct 2019 13:29:13 -0400
Subject: [PATCH 038/149] minor fix

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 9d21ee343..e3a4cb2ac 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3126,7 +3126,7 @@ attType | string | link, file | Yes | Type of attachment, either link or file
 content | byte |  | Yes (if attType=file) | File content in base64 format
 packageAccessLevel | string | public,private(default public) | No | Type of access to file. Only used with attType 'file'.
 resourceName | string |  | Yes (if attType=file) | Name of file
-fileType | string |  | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#Valid-File-Types)
+fileType | string |  | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
 link | string |  | Yes (if attType=link) | Resource link  URL
 description | string |  | Yes (if attType=link) | Description of the link
 

From 1926ce279c6954711eb23fd7c647f3846635332c Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Fri, 25 Oct 2019 13:40:36 -0400
Subject: [PATCH 039/149] formatting fix

---
 _apidocs/opportunities-api.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index e3a4cb2ac..a03bcfd7d 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2813,8 +2813,8 @@ Examples
 * Field headers in the table must match with field headers shown in JSON example  
 
 Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (to Publish) | Description
------|-----------|----------------|--------------------------|-----------------------|------------ |------------
-type | string | 1 character | See Notice Types table | Yes | Yes | Notice Type
+-----|-----------|-------|-------------------|------------|------------ |----------
+type | string | 1 character| See Notice Types table | Yes | Yes | Notice Type
 solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number
 title | string | 256 characters | |Yes | Yes | Title of the Opportunity
 organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Org Id/AAC code of the office where an Opportunity is being submitted
@@ -2871,8 +2871,8 @@ award.awardee.manual | string | |boolean  | Yes | Yes  | Awardee
 award.awardee.name | string | 255 characters | | No | No | Awardee Name
 award.awardee.duns | string | 9 digits | | No | No | Awardee Duns
 award.awardee.location | JSON | | NA | NA | NA |
-award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 1
-award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 1
+award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 
+award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 2
 award.awardee.location.
city | string | | | No | No | Awardee City
 award.awardee.location.
city.code | string | | | No | No | Awardee City code
 award.awardee.location.
city.name | string | | | No | No | Awardee City name

From 5ea05b752206ee1b3418780e1676a63bd26d5fc9 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Fri, 25 Oct 2019 13:58:51 -0400
Subject: [PATCH 040/149] minor updates

---
 _apidocs/opportunities-api.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index a03bcfd7d..6c5f52d43 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2866,7 +2866,7 @@ award.number | string | 255 characters | |No | Yes only for type= i, j, a | Awar
 award.deliverOrderNumber | string | 255 characters| | No | No | Award Deliver Order Number
 award.amount | number |64 digits |  | No | No | Award Amount
 award.lineitemNumber | string |255 characters | | No | No | Award Line item Number
-award.awardee | JSON | | NA | NA | NA |
+award.awardee | JSON | NA| NA | NA | NA |
 award.awardee.manual | string | |boolean  | Yes | Yes  | Awardee
 award.awardee.name | string | 255 characters | | No | No | Awardee Name
 award.awardee.duns | string | 9 digits | | No | No | Awardee Duns
@@ -2876,27 +2876,27 @@ award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Stre
 award.awardee.location.
city | string | | | No | No | Awardee City
 award.awardee.location.
city.code | string | | | No | No | Awardee City code
 award.awardee.location.
city.name | string | | | No | No | Awardee City name
-award.awardee.location.
state | JSON | | NA | NA | NA |
+award.awardee.location.
state | JSON | NA | NA | NA | NA |
 award.awardee.location.
state.code | string | | | No | No | Awardee State code
 award.awardee.location.
state.name | string | | | No | No | Awardee State name
 award.awardee.location.
country | JSON | | NA | NA | NA |
 award.awardee.location.
country.code | string | | | No | No | Awardee Country code
 award.awardee.location.
country.name | string | | | No | No | Awardee Country Name
 award.awardee.location.
zip | string | | | No | No | Awardee Country Zip
-justificationAuthority | JSON | |NA | NA | NA |
+justificationAuthority | JSON |NA |NA | NA | NA |
 justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
 justificationAuthority.
authority | | string |  | No | No | Justification Authority
-link | JSON | NA | NA | NA |
+link | JSON | NA |NA | NA | NA |
 link.href | string |  | | No | No | Url for the notice on SAM.gov
-link.additionalInfo | JSON | NA | NA | NA |
+link.additionalInfo | JSON | NA |NA | NA | NA |
 link.additionalInfo.content | string | | | No | No | Additional info
-additionalReporting | string | none/
auto_recovery | No | Yes |
-description | JSON | | NA | NA | NA |
+additionalReporting | string | |none/
auto_recovery | No | Yes |
+description | JSON | NA | NA | NA | NA |
 description.body | string | 65535 characters| | No | Yes | Description of notice
-resources | JSON | | NA | NA | NA |
-resources.attType | string | link, file | No |No| Type of attachment, either link or file
+resources | JSON |NA | NA | NA | NA |
+resources.attType | string | |link, file | No |No| Type of attachment, either link or file
 resources.content | byte |250MB |  | No|No | File content in base64 format
-resources.link | string |  | |No|No | Resource link URL
+resources.link | string | 255 characters | |No|No | Resource link URL
 resources.packageAccessLevel | string | | public,private(default public) | No | No| Type of access to file or link
 resources.resourceName | string | 255 characters |  | No|No | Name of file
 postedDate| date| | |No|No| Posted Date

From 8f0df753433c183f3667ccd4b7ce167cc06df2e7 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Fri, 25 Oct 2019 14:06:19 -0400
Subject: [PATCH 041/149] formmattinmg fix for table

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 6c5f52d43..43173e313 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2885,7 +2885,7 @@ award.awardee.location.
country.name | string | | | No | No | Awardee Countr
 award.awardee.location.
zip | string | | | No | No | Awardee Country Zip
 justificationAuthority | JSON |NA |NA | NA | NA |
 justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
-justificationAuthority.
authority | | string |  | No | No | Justification Authority
+justificationAuthority.
authority | string|  |  | No | No | Justification Authority
 link | JSON | NA |NA | NA | NA |
 link.href | string |  | | No | No | Url for the notice on SAM.gov
 link.additionalInfo | JSON | NA |NA | NA | NA |

From caaa062185869470fffd9309f169c74fa122ea4f Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 14:45:48 -0400
Subject: [PATCH 042/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 172 +++++++++++++++++------------
 1 file changed, 103 insertions(+), 69 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index e86a408e2..829eedaba 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -134,6 +134,34 @@ far5 | FAR 6.302-5 - Authorized or required by statute
 far6 | FAR 6.302-6  - National security
 far7 | FAR 6.302-7 - Public interest
 
+### Related Notices
+
+This section indicates the list of  notices that can be used in the SOAP services
+
+PRESOL - Presolicitation
+COMBINE - Combined Synopsis/Solicitation
+SRCSGT - for Sources Sought
+SSALE - Sale of Surplus Property
+SNOTE - Special Notice
+JA – Justification
+ITB – Intent to Bundle 
+SOL - Solicitation
+AWARD - Award
+
+This is a conversion table for notices using SOAP services
+
+||SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE
+-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|
+|**SRCSGT**||O|O|O|O|O|||O
+|**PRESOL**|O||O|O||O|O|O|O|O|O
+|**COMBINE**|O|O|||O||O|O|O
+|**SOL**|O|O|||O||O|O|O
+|**AWARD**|||O|O|||O|O|O
+|**SSALE**|O|O|||||O|O|O
+|**ITB**||O|O|O|O|O||O|O
+|**JA**||O|O|O|O|O|O||O
+|**SNOTE**|O|O|O|O|O|O|O|O|
+
 ## Contracting Officer
 Method Details
 
 ### Award Notice (submitAward)
@@ -892,7 +920,7 @@ officeid|	String|	Yes|	Office id of the office where an opportunity is being sub
 offadd|	String	|No|	Office Address|	65535 characters
 subject|	String|	Yes|	Subject	|255 characters
 solnbr	|String	|Yes|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	|string	|No|	Base Notice Type|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation
+ntype	|string	|No|	Base Notice Type|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation, "AWARD" - for Award
 awdnbr|	String	|Yes	|Award Number|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 donbr|	String|	No	|Task/Delivery Order Number	|255 characters from the set: a-z A-Z 0-9 - _ ( )
 archdate	|Date	|No	|Archive Date|	YYYYMMDD
@@ -4074,16 +4102,16 @@ Note:
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date |	No (Yes for Award)	| YYYYMMDD	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	1. DATE field in unexpected format. Expects YYYYMMDD
+date |	No; Yes for Award)	| YYYYMMDD	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	1. DATE field in unexpected format. Expects YYYYMMDD
 notice_type	|Yes| Valid Options mentioned General Notice (submitNotice) section |	1. This required field should be validated |	1. Opportunity type is required
 zip|	No|	5 digits|	NA |NA
 classcod	|No|	Valid classification code (FAR, Section 5.207(g))	|1. This required field should be validated where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required                   

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
 naics	|No (Yes for Combined Synopsis/Solicitation & Solicitation)| 	Valid NAICS Code NAICS Reference	|NA |	NA
-offadd|	No|	65535 characters|	NA|	NA
-officeid	|No	|20 characters 	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided


 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
+offadd|	No|	65535 characters|	Not-Used|	NA
+officeid	|Yes	|20 characters 	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided


 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes – for all; NA – for submitDocumentAndLinks	|255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	 (No for Special Notice)|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

 2. If duplicate solicitation number is given, then system throws an error

 3. For an invalid solnbr and notice_type combination, the service throws an error|	1.Notice Id is required

 2. Notice Id for the selected opportunity type already exists

 3. Opportunity not found with given solicitation number and ntype
-ntype|	no|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error 	|NTYPE value provided is not valid
+solnbr|	 Yes (No for Special Notice)|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

 2. If duplicate solicitation number is given, then system throws an error

 3. For an invalid solnbr and notice_type combination, the service throws an error|	1.Notice Id is required

 2. Notice Id for the selected opportunity type already exists

 3. Opportunity not found with given solicitation number and ntype
+ntype|	no|	[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error 	|NTYPE value provided is not valid
 awdnbr|	Yes – For Award, ITB & JA; No – For rest|	255 characters|	1. This required field should be validated|	1. Award Details Section - Contract Award Number is a required field
 donbr|	Yes – For JA; No – For rest	|255 characters	|1. This is required field for JA	|1. Award Details Section - Task/Delivery Order Number is required field
 awdamt	|Yes – For Award; No – For rest|	64 characters|	1. This required field should be validated	|1. Award Details Section – Amount is a required field.
@@ -4118,14 +4146,14 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
 zip	|No	|5 digits|	NA| NA
-classcod|	Yes – For submitpresol
 No - SourcesSought |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
+classcod|	 No  |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	|No|  Valid NAICS Code  NAICS Reference|	NA| 	NA
 offadd|	No	|65535 characters	|NA|	NA
 officeid	|Yes	|20 characters |	1.	This field is required 

2.	If an invalid officeid is given, then service throws an error

  3.	If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4.	Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes	|255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
-solnbr	|No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-respdate|	No for Presol and Sources Sought; Yes - for Presol IF 15 days after response is selected|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be in past; has to be in future 

3.	When giving future date, response date cannot exceed 5 years from the current date 	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
-archdate	|No	|YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Inactive date provided is in the past.
+solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+respdate|	No; Either Respdate or Archdate must be selected |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be in past; has to be in future 

3.	When giving future date, response date cannot exceed 5 years from the current date 	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
+archdate	|No; Either Respdate or Archdate must be selected	|YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Inactive date provided is in the past.
 contact|	Yes|	65535 characters 

Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated|	1. Primary Contact is required
 desc	|Yes |	65535 characters|	1. This required field should be validated	|1. Description is required
 link|	No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	|NA
@@ -4152,7 +4180,7 @@ naics	|Yes |Valid NAICS Code  NAICS Reference|	1. This required field should be
 officeid	|Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

  3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 offadd|	No|	65535 characters|	NA|	NA
 subject	|Yes|	255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
-solnbr	|No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	This opportunity cannot be published. Response date is required

  2.	DATE field in unexpected format. Expects YYYYMMDD  

3.	This opportunity cannot be published. Response date provided is in the past

 4.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact|	Yes|	65535 characters Default value: Primary 

Other types: Secondary, Owner|	1. This required field should be validated|	1. Primary Contact is Required
@@ -4181,13 +4209,13 @@ naics	|No	|Valid NAICS Code  NAICS Reference| 	NA|	NA
 officeid|	Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 offadd|	No|	65535 characters|	NA|	NA
 subject	|Yes|	255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
-solnbr	|No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype
-ntype|	no|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
+solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype
+ntype|	no|	[Refer Related Notices](#related-notices) |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
 awdnbr|	Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}	|1. This required field should be validated

 2. This field accepts only valid characters as mentioned under character limit/restrictions column |	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
 donbr|	No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) |	NA|	NA
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
-contact|	No	|65535 characters

 65535 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	| 1. Primary Contact is Required
-desc|	No|	65535 characters|	1. This required field should be validated	|1. Description is required
+contact|	Yes	|65535 characters

 65535 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	| 1. Primary Contact is Required
+desc|	Yes |	65535 characters|	1. This required field should be validated	|1. Description is required
 link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)	|NA	|NA
 link	|No	| |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
 files|	No	| |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
@@ -4203,16 +4231,16 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
+date|	No; Yes - for Award|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
 zip|	No|	5 digits|	NA|	NA
-classcod	|Yes – For Combined/Sale of Surplus/ITB/Justification

  No – For rest	|Valid classification code (FAR, Section 5.207(g))	|1. This field is required and should be validated

 2. If a wrong classification code is given, then service throws an error |1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
+classcod	|Yes – For Solicitation/Combined/Sale of Surplus/ITB/Justification

  No – For rest	|Valid classification code (FAR, Section 5.207(g))	|1. This field is required and should be validated

 2. If a wrong classification code is given, then service throws an error |1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	|Yes – For Combined/Solicitation 

No – For rest|	Valid NAICS Code  NAICS Reference	|1. For combined, this field is required and should be validated|	1. NAICS code is required
 officeid|	Yes|	20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make modifications to an opportunity associated to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 offadd|	No	|65535 characters|	NA|	NA
 subject	|Yes|	255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1a. This required field if not given, service will throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 3.	Notice not found for correction
-ntype|	No|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation	 |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |	1.	NTYPE value provided is not valid
-respdate	|Yes – for Combined/Solicitation; No – For rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)	|YYYYMMDD	|1.	This required field is validated for combined type

 2.	No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction 

 3.	This date cannot be in past; has to be in future|	1.	This opportunity cannot be published. Response date is required

 2.	DATE field in unexpected format. Expects YYYYMMDD

 3.	This opportunity cannot be published. Response date provided is in the past
+solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1a. This required field if not given, service will throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 3.	Notice not found for correction
+ntype|	Yes |[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |	1.	NTYPE value provided is not valid
+respdate	|Yes – for Combined/Solicitation; No – For rest|YYYYMMDD	|1.	This required field is validated for combined type

 2.	No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction 

 3.	This date cannot be in past; has to be in future|	1.	This opportunity cannot be published. Response date is required

 2.	DATE field in unexpected format. Expects YYYYMMDD

 3.	This opportunity cannot be published. Response date provided is in the past
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact|	No – For Award/Special notice

 Yes – For rest	|65535 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
 desc	|Yes - for Award/Justification; No - For Rest|	65535 characters|	1. This required field should be validated	|1. Description is required
@@ -4249,8 +4277,8 @@ naics|	No – this may change in future	|Valid NAICS Code  NAICS Reference|	NA|
 offadd|	No|	65535 characters|	NA|	NA
 officeid|	Yes|	20 characters	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
 subject	|Yes|	255 characters	|1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field if not given will throw an error 

 2. Duplicate solicitation number cannot be submitted

 (Refer error #2) 3. If a space is given along with numbers in this field, then service throws an error

 4. If solicitation & ntype combination is not matched, then service throws an error.	|1. Notice Id is required 

2. Notice ID for the selected opportunity type already exits

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Opportunity not found with given solicitation number and ntype
-ntype	|No	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation|1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |   1. Invalid NTYPE value provided
+solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field if not given will throw an error 

 2. Duplicate solicitation number cannot be submitted

 (Refer error #2) 3. If a space is given along with numbers in this field, then service throws an error

 4. If solicitation & ntype combination is not matched, then service throws an error.	|1. Notice Id is required 

2. Notice ID for the selected opportunity type already exits

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Opportunity not found with given solicitation number and ntype
+ntype	|No	|[Refer Related Notices](#related-notices)|1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |   1. Invalid NTYPE value provided
 stauth	|Yes|	Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7  

Description of each of these stauth values is captured in Stauth Value section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’|	1. This required field should be validated 

Note: Both foja & stauth values will be given under stauth in legacy	|1. This opportunity cannot be published. Authority is required
 awdnbr	|Yes|	255 characters|	1. This required field should be validated	|1. Award Details Section - Contract Award Number is a required field
 modnbr|	No	|32 characters|	NA|	NA
@@ -4274,15 +4302,15 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date|	No	|YYYYMMDD|	1. If this field is given, then this field should meet the character limit/restrictions |1. DATE field in unexpected format. Expects YYYYMMDD
+date|	Yes	|YYYYMMDD|	1. If this field is given, then this field should meet the character limit/restrictions |1. DATE field in unexpected format. Expects YYYYMMDD
 zip	|No|	5 digits|	NA|	NA
 classcod|	No|	Valid classification code (FAR, Section 5.207(g))|	1. If a wrong classification code is given, then the service throws an error | 1. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	| No|	Valid NAICS Code  NAICS Reference|	NA|	NA
 offadd|	No	|65535 characters|	NA|	NA
 officeid	|Yes	|20 characters	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes|	255 characters|	1. This required field should be validated	|$.data.title: is missing but it is required
-solnbr	|No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

3. Opportunity not found with given solicitation number and ntype
-ntype|	No|	Valid values: "COMBINE" - for Combined Synopsis/Solicitation, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  | 	1. Invalid NTYPE value provided.
+solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

3. Opportunity not found with given solicitation number and ntype
+ntype|	No|	[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  | 	1. Invalid NTYPE value provided.
 awdnbr|	Yes|	Valid numbers|	1. This required field should be validated 

2. If an invalid number is given (e.g with special characters), then service throws an error|	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
 awdamt|	Yes|	Valid integer values| 	1. This required field should be validated

 2. If an invalid integer values is given, then service throws an error 	|1. Award Details Section - Amount is a required field

 2. Award Details Section - Please enter valid integer for Amount Field
 linenbr	|No|	255 characters|	NA|	NA
@@ -4309,14 +4337,14 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
+date|	No |	YYYYMMDD|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 officeid|	No	|20 characters|	1. If an invalid officeid is given, then service throws an error

 2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 3. Officeid must be associated with user account	|1. Invalid officeid provided

 2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-ntype	|No	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |  1. Notice Type value provided is not valid
-uploadtype|	No – May change in future Upload type accepts 2 types – link or file|	A for amendment, S for solicitation or any title for other; 255 characters|	NA|	NA
-respdate|Yes – for Combined/Solicitation; No – For rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
-links|	No|	Array of files|	1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

 2. If a link with same name already exists on the notice, then the system throws an error.

 3. If the Url is empty for a link, then the system throws an error.

 4.	If the description is missing for a link, then the system throws an error.| 1.	Links and/or files are not complete

 2.	Resource with the same name already exists

 3.	Link Resource must have a link

 4. Link Resource must have a description
-files	|No|	Array of files|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file type that you are trying to upload is not supported

6.	Resource with the same name already exists
+solnbr|	No |128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+ntype	| No |[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |  1. Notice Type value provided is not valid
+uploadtype|	No  – link or file|	A for amendment, S for solicitation or any title for other; 255 characters|	NA|	NA
+respdate| No |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
+links|	Yes; Either Links or Files needs to be provided |	Array of files|	1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

 2. If a link with same name already exists on the notice, then the system throws an error.

 3. If the Url is empty for a link, then the system throws an error.

 4.	If the description is missing for a link, then the system throws an error.| 1.	Links and/or files are not complete

 2.	Resource with the same name already exists

 3.	Link Resource must have a link

 4. Link Resource must have a description
+files	| Yes; Either Links or Files needs to be provided |	Array of files|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file type that you are trying to upload is not supported

6.	Resource with the same name already exists
 
 #### submitFairOpps
 
@@ -4340,7 +4368,7 @@ naics|	No|	Valid NAICS Code  NAICS Reference|	NA|	NA
 offadd|	No|	65535 characters|	NA	|NA
 officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes|	255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	No	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 archdate	|No	|YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact|	No|	65535 characters Default value: Primary 

Other types: Secondary, Owner|	NA|	NA
 desc|	Yes	|65535 characters|	1. This required field should be validated|	1. Description is required
@@ -4363,7 +4391,7 @@ naics	|Yes |Valid NAICS Code  NAICS Reference|	1. This required field should be
 officeid	|Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

  3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1.   Invalid officeid provided

 2.   Insufficient privileges to create opportunity.
 offadd|	No|	65535 characters|	NA|	NA
 subject	|Yes|	255 characters|	1. This required field should be validated|	1. Title is a required field.
-solnbr	|No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1.   Notice ID is a required field 

2. Notice ID must be unique based on selected notice type 

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces
+solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1.   Notice ID is a required field 

2. Notice ID must be unique based on selected notice type 

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces
 respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	Response date is required

  2.    DATE field in unexpected format. Expects YYYYMMDD  

3.	Response Date cannot be in the past

 4.	Response Date cannot exceed 5 years from current date
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	Inactive date provided is in the past
 desc|	Yes |	65535 characters|	1. This required field should be validated|	1. Description is a required field
@@ -4391,7 +4419,7 @@ naics	|No	|Valid NAICS Code  NAICS Reference|	NA|	NA
 offadd|	No|	65535 characters|	NA|	NA
 officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
 subject|	Yes	|255 characters	|1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr	|No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1. This required field should be validated

 2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1. This required field should be validated

 2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact	|Yes|	65535 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
 desc|	Yes|	65535 characters	|1. This required field should be validated	|1. Description is required
@@ -4407,9 +4435,9 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-awdnbr|	Yes - for Award/ITP/JA; No - for Rest|	255 characters| If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required
-ntype|No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If an invalid ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
+solnbr|	Yes; Solicitation Number or Award Number is required|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+awdnbr|	Yes; Solicitation Number or Award Number is required|	255 characters| If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required
+ntype|No|	 [Refer Related Notices](#related-notices)|	1. If an invalid ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
 deletetype|	no|	Valid values: “notice” to delete the notice, “attachment” to delete attachments and links from the notice|	1. If an invalid deletetype is provided, then service throws an error  |	Delete type provided is not “notice” or “attachment”
 deletemethod|	no|	Valid Values: “all” to delete all versions or “latest” to delete latest version	|1. If an invalid deletemethod is provided, then service throws an error  |	Delete method provided is not “latest” or “all”
 
@@ -4423,8 +4451,8 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 date|	No|	YYYYMMDD|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice not found for correction

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 officeid	|No|	20 characters|	Officeid must be associated with user account	|NA
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If an invalid ntype is provided, then service throws an error

    2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+ntype|	No|	[Refer Related Notices](#related-notices)|	1. If an invalid ntype is provided, then service throws an error

    2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction
+archdate|	Yes |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 
 #### unarchiveNotice
 
@@ -4436,7 +4464,7 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 ------ | ------- | ------- | ------- | --------
 solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction
 officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
+ntype|	No|[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
 awdnbr	|Yes - for Award/ITB/Justification; No - for Rest|	255 characters|	NA|	NA
 archdate|	Yes|	YYYYMMDD|	1. This required field should be validated  

2. If this value is available, this field should meet the character limit/restrictions 

3.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	New archive date provided is in the past

 3.	$.reason: null found, string expected. Unable to process request. Please try again
 
@@ -4451,12 +4479,12 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 date|	No|	YYYYMMDD	|Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
 subject|	No|	255 characters|	NA|	NA
-solnbr|	No	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error

 1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If valid solnbr is given with a different ntype, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple Notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-ntype	|No	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
+solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error

 1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If valid solnbr is given with a different ntype, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple Notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+ntype	|No	|[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
 awdnbr|	Yes - for Award/ITB/Justification; No - for Rest|	255 characters|	NA|	NA
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be cancelled
-contact|No – For Award/Special Notice; Yes – For Rest|	65535 characters Default value: Primary 

Other types: Secondary, Owner| NA| NA
-desc|	No - For Award/Justification; Yes - For Rest|	65535 characters|	1. This required field should be validated |	1. Unable to process request. Please try again
+contact|Yes|	65535 characters Default value: Primary 

Other types: Secondary, Owner| NA| NA
+desc|	Yes|	65535 characters|	1. This required field should be validated |	1. Unable to process request. Please try again
 
 #### getNoticeData
 
@@ -4464,10 +4492,10 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-notice_id	|No – For Special Notice; Yes – For Rest|	Unique ID found from getList call or ID’s for changes found in getNoticeData call|	Notice_id is required|	notice_id from getList is required
-Get_changes|	No	|True or False

 Pass in true to get the full notice history with all changes|	NA|	NA
-get_changes_from_date|	No|	If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned|	Date field should meet the expected format.|	DATE field in unexpected format. Expects YYYYMMDD
-get_file_data	|No	|True or False

 Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the meta details/links will still be provided	|NA	|NA
+notice_id	|No (at least 1 field is required)|	Unique ID found from getList call or ID’s for changes found in getNoticeData call|	Notice_id is required|	notice_id from getList is required
+Get_changes|	No (at least 1 field is required)	|True or False

 Pass in true to get the full notice history with all changes|	NA|	NA
+get_changes_from_date|	No (at least 1 field is required)|	If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned|	Date field should meet the expected format.|	DATE field in unexpected format. Expects YYYYMMDD
+get_file_data	|No (at least 1 field is required)	|True or False

 Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the meta details/links will still be provided	|NA	|NA
 
 #### getList
 
@@ -4476,12 +4504,12 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-notice_type	|No|	Solicitation type 

  Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL

   Note: Searches for AWARDS, JA and ITB will return both standalone notices AND base notices that contain one of these type	|Notice_type if given should be valid |	Notice Type is not recognized

 Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE,  ITB
-solnbr|	No|	Solicitation #|	NA|	NA
-awdnbr|	Yes for Award/ITB/Justification; No for Rest|	Award #|	NA|	NA
-posted_from	|No	|Posted From Date. YYYYMMDD|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
-posted_to|	No	|Posted To Date. YYYYMMDD	|Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
-documents_to_search|	No	|Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided|	NA|	NA
+notice_type	|No (at least 1 field is required) |	Solicitation type 

  Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL

   Note: Searches for AWARDS, JA and ITB will return both standalone notices AND base notices that contain one of these type	|Notice_type if given should be valid |	Notice Type is not recognized

 Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE,  ITB
+solnbr|	No (at least 1 field is required)|	Solicitation #|	NA|	NA
+awdnbr|	No (at least 1 field is required)|	Award #|	NA|	NA
+posted_from	|No	(at least 1 field is required)|Posted From Date. YYYYMMDD|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
+posted_to|	No (at least 1 field is required)	|Posted To Date. YYYYMMDD	|Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
+documents_to_search|	No (at least 1 field is required)	|Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided|	NA|	NA
 
 #### getFileData
 
@@ -4498,8 +4526,8 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	No|	Solicitation Number|	1. If an incorrect solicitation number and ntype combination is given, the service throws an error

   2a. If this required field if not given, service throws an error 

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found 

2a. Notice not found

 2b. Multiple Notices found. Please input more details
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	NA	|NA
+solnbr|	Yes |	Solicitation Number|	1. If an incorrect solicitation number and ntype combination is given, the service throws an error

   2a. If this required field if not given, service throws an error 

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found 

2a. Notice not found

 2b. Multiple Notices found. Please input more details
+ntype|	No|	[Refer Related Notices](#related-notices) |	NA	|NA
 
 #### getAuthorizedPartyList
 
@@ -4507,19 +4535,21 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	No| 	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation|	If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
+solnbr|	Yes | 	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
+ntype|	No|	[Refer Related Notices](#related-notices)|	If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
 nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together 

2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
 status|	No|	Valid Options: approved, pending, rejected, “empty value”

 If empty, all status will be returned

 Note, use “pending” to pull the pending explicit access requests |1.	If the status value entered doesn’t match the valid values , then the system throws an error|	1.	Status value is invalid
 
 #### approveExplicitAccessRequestByID
 
-Individual business rules per field are listed across each of the fields in below table.  
+Individual business rules per field are listed across each of the fields in below table.
+
+ID can be obtained through getAuthorizedPartyList   
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr	|No |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4. Multiple notices found. Please input more details
-ntype	|No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation	|If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
+solnbr	|Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4. Multiple notices found. Please input more details
+ntype	|No|	[Refer Related Notices](#related-notices)	|If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
 nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
 id|	Yes|	|	1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already approved, then the service throws an error

3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error	|1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already approved

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
 
@@ -4527,10 +4557,13 @@ id|	Yes|	|	1.	If the request Id is not provided, then the system throws an error
 
 Individual business rules per field are listed across each of the fields in below table.
 
+Vendor can be obtained through getAuthorizedPartyList   
+
+
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr	|No |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
-ntype	|No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
+solnbr	|Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
+ntype	|No|	[Refer Related Notices](#related-notices)	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
 nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
 vendor	|Yes|	Vendor Data	|1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error. 
2.	If no match is found in the system for the vendor data provided, then the system throws an error. 
 3.	If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown. 
 2.	No contact match on vendor data provided.  
 3.	Request with Request ID: #id already approved.
 
@@ -4540,8 +4573,8 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	No |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |If an invalid ntype is provided, then service throws an error |  1. NTYPE value provided is not valid
+solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
+ntype|	No|	[Refer Related Notices](#related-notices) |If an invalid ntype is provided, then service throws an error |  1. NTYPE value provided is not valid
 nonfbo_solbr 	|No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
 vendor|	Yes|	Vendor Data|	1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
 
@@ -4551,8 +4584,8 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	No |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1. This required field should be validated. If no value is provided, then service throws an error 

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error|	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 
 4. Multiple notices found. Please input more details
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1.	If an invalid ntype is provided, then service throws an error   |	1. NTYPE value provided is not valid
+solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1. This required field should be validated. If no value is provided, then service throws an error 

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error|	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 
 4. Multiple notices found. Please input more details
+ntype|	No|	[Refer Related Notices](#related-notices) |	1.	If an invalid ntype is provided, then service throws an error   |	1. NTYPE value provided is not valid
 nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
 id|	Yes	||	1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already rejected, then the service throws an error

 3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error|	1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already rejected

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
 reason| Yes| Rejection Reason| 1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
@@ -4563,7 +4596,7 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 solnbr	|No |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
-ntype	|No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
+ntype	|No|	[Refer Related Notices](#related-notices)	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
 nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
 vendor|	Yes|	Vendor Data|	1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
 reason| Yes| Rejection Reason| 1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
@@ -4653,3 +4686,4 @@ Date | Version | Description
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
 
 
Back to top

+

From aa322639a937a2f90ce664c9a01e96de41b4985e Mon Sep 17 00:00:00 2001
From: Prashant Pillai 
Date: Fri, 25 Oct 2019 14:57:40 -0400
Subject: [PATCH 043/149] delete attachment

---
 _apidocs/opportunities-api.md | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 5881d1ffe..01289f30b 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2070,6 +2070,39 @@ Examples
 
 
Back to top

 
+### Delete Attachment in Opportunity
+
+------- | -------
+**Request Type** | DELETE
+**URL** |/v1/api/{opportunityId}/attachments/{resourceId}
+**Summary** | Delete an attachment from an opportunity
+**Consumes** | Request Parameters
+**Produces** | NA
+
+Request Parameters
+
+Parameter Name | Parameter Type | Data Type  | Required | Description
+---------------|----------------|------------|----------|------------
+Authorization | Header |  string | Yes | Valid and authorized user ID
+api_key | query | string | Yes | Valid System Account API Key
+opportunityId | query | string | Yes | Opportunity ID
+resourceId | query | string | Yes | Resource ID
+deleteAll | query | boolean | No | Should be true if deleting attachment from all versions of a notice; else false
+
+
Back to top

+
+Responses
+
+HTTP Status Code | Response Type | Reason  | Description
+-----------------|---------------|---------|------------
+204 | string | Attachment successfully deleted | NA
+
+Examples
+
+_NA_
+
+
Back to top

+
 ### Download Attachment as Original File Type
 
 

From 993a21df6a27dcd7f94c111f29229fd90d718257 Mon Sep 17 00:00:00 2001
From: Prashant Pillai 
Date: Fri, 25 Oct 2019 15:01:35 -0400
Subject: [PATCH 044/149] delete attachment

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index b89a988ce..b09d06d5d 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2087,7 +2087,7 @@ Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
 resourceId | query | string | Yes | Resource ID
-deleteAll | query | boolean | No | Should be true if deleting attachment from all versions of a notice; else false
+deleteAll | query | boolean | Yes | Should be true if deleting attachment from all versions of a notice; else false
 
 
Back to top

 

From 1384c24d2e7eded10227d4c20914cb925ab2e501 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 15:31:57 -0400
Subject: [PATCH 045/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 84 +++++++++++++++---------------
 1 file changed, 42 insertions(+), 42 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 829eedaba..efbdb16a2 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4102,30 +4102,30 @@ Note:
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date |	No; Yes for Award)	| YYYYMMDD	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	1. DATE field in unexpected format. Expects YYYYMMDD
+date |	Yes - Only Award
No - Rest	| YYYYMMDD	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	- Award Details Section - Contract Award Date is required field 

 - Award Details Section - Contract Award Date provided should have 4 digit year 

 - Award Details Section - Contract Award Date provided is in an invalid format
 notice_type	|Yes| Valid Options mentioned General Notice (submitNotice) section |	1. This required field should be validated |	1. Opportunity type is required
 zip|	No|	5 digits|	NA |NA
-classcod	|No|	Valid classification code (FAR, Section 5.207(g))	|1. This required field should be validated where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required                   

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
-naics	|No (Yes for Combined Synopsis/Solicitation & Solicitation)| 	Valid NAICS Code NAICS Reference	|NA |	NA
+classcod	|No|	Valid classification code (FAR, Section 5.207(g))	|1. This required field should be validated where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
+naics	|Yes - Combined Synopsis/Solicitation & Solicitation 
 No - Rest| 	Valid NAICS Code NAICS Reference	|NA | -  NAICS code is required
 offadd|	No|	65535 characters|	Not-Used|	NA
 officeid	|Yes	|20 characters 	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided


 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-subject	|Yes – for all; NA – for submitDocumentAndLinks	|255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	 Yes (No for Special Notice)|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

 2. If duplicate solicitation number is given, then system throws an error

 3. For an invalid solnbr and notice_type combination, the service throws an error|	1.Notice Id is required

 2. Notice Id for the selected opportunity type already exists

 3. Opportunity not found with given solicitation number and ntype
+subject	|Yes	|255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
+solnbr|	 Yes - Rest 
 No - Only Special Notice|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

 2. If duplicate solicitation number is given, then system throws an error

 3. For an invalid solnbr and notice_type combination, the service throws an error|	1.Notice Id is required

 2. Notice Id for the selected opportunity type already exists

 3. Opportunity not found with given solicitation number and ntype
 ntype|	no|	[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error 	|NTYPE value provided is not valid
-awdnbr|	Yes – For Award, ITB & JA; No – For rest|	255 characters|	1. This required field should be validated|	1. Award Details Section - Contract Award Number is a required field
-donbr|	Yes – For JA; No – For rest	|255 characters	|1. This is required field for JA	|1. Award Details Section - Task/Delivery Order Number is required field
-awdamt	|Yes – For Award; No – For rest|	64 characters|	1. This required field should be validated	|1. Award Details Section – Amount is a required field.
-linenbr|	No|	255 characters|	NA	|NA
-awddate	|Yes – For award; No – for rest	|YYYYMMDD|	1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

 2. This required field should be validated|	1. DATE field in unexpected format. Expects YYYYMMDD

 2. Award Details Section - Contract Award Date is required field.
-stauth|	Yes – For JA

 No – for rest	| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

  Description of each of these stauth values is captured in Stauth Values section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ | Both foja & stauth values will be given under stauth in legacy |	NA
-respdate|Yes – for Combined/Solicitation; No – For rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)|	YYYYMMDD |	1.	No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions 

 2.	This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2) 

3.	For submitCombined this field is required	| 1.	DATE field in unexpected format. Expects YYYYMMDD 

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Inactive date provided is in the past

 4.	Response Date is required
-archdate|	No|	YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past.
-awardee	|Yes – for award

 No – for Rest|	6553 characters|	NA|	NA
+awdnbr|	Yes –  Award, ITB & JA 
 No – Rest|	255 characters|	1. This required field should be validated|	1. Award Details Section - Contract Award Number is a required field
+donbr|	Yes – JA 
 No – Rest	|255 characters	|1. This is required field for JA	|1. Award Details Section - Task/Delivery Order Number is required field
+awdamt	|Yes – Award 
 No – Rest|	64 characters|	1. This required field should be validated	|1. Award Details Section – Amount is a required field.
+linenbr|No |	255 characters|	NA	|NA
+awddate	|Yes – Award 
 No – Rest	|YYYYMMDD|	1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

 2. This required field should be validated|	1. DATE field in unexpected format. Expects YYYYMMDD

 2. Award Details Section - Contract Award Date is required field.
+stauth|	Yes – JA
 No – Rest	| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

  Description of each of these stauth values is captured in Stauth Values section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ | Both foja & stauth values will be given under stauth in legacy |	NA
+respdate|Yes – Only Combined/Solicitation
 No – Rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)|	YYYYMMDD |	1.	No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions 

 2.	This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2) 

3.	For submitCombined this field is required	| 1.	DATE field in unexpected format. Expects YYYYMMDD 

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Inactive date provided is in the past

 4.	Response Date is required
+**archdate** (updated needed)|	No|	YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past.
+awardee	|Yes – Only Award
 No – Rest|	6553 characters|	NA|	NA
 awardee_duns|	No	|9 digits with optional plus 4|	NA|	NA
-contact	|No - for Award & Special Notice; Yes - for Rest 	|65535 characters Default value = Primary Other types are: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
-desc| No – Justfication & Award ; Yes - for Rest 	|65535 characters|	1. This required field should be validated.|	1. Description is required
-link|	No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	| NA
-email|	Yes 
 No if type=Award|	128 characters|	NA	 |NA
+contact	| Yes - Rest 
 No - Award & Special Notice;	|65535 characters Default value = Primary Other types are: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
+desc| Yes - Rest 
 No – Justfication & Award 	|65535 characters|	1. This required field should be validated.|	1. Description is required
+link|No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	| NA
+email|	Yes - Rest 
 No - Only Award|	128 characters|	NA	 |NA
 links	|No	|Array of links	|NA	|NA
 files|	No|	Array of files|	NA|	NA
 setaside|	No|	See Set-Aside Values section for valid codes|	NA	|NA
@@ -4146,15 +4146,15 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
 zip	|No	|5 digits|	NA| NA
-classcod|	 No  |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
+classcod|	No  |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	|No|  Valid NAICS Code  NAICS Reference|	NA| 	NA
 offadd|	No	|65535 characters	|NA|	NA
 officeid	|Yes	|20 characters |	1.	This field is required 

2.	If an invalid officeid is given, then service throws an error

  3.	If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4.	Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes	|255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-respdate|	No; Either Respdate or Archdate must be selected |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be in past; has to be in future 

3.	When giving future date, response date cannot exceed 5 years from the current date 	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
-archdate	|No; Either Respdate or Archdate must be selected	|YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Inactive date provided is in the past.
-contact|	Yes|	65535 characters 

Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated|	1. Primary Contact is required
+respdate|	No - However either Respdate or Archdate must be selected |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be in past; has to be in future 

3.	When giving future date, response date cannot exceed 5 years from the current date 	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
+**archdate** (updated needed) |No - However either Respdate or Archdate must be selected	|YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Inactive date provided is in the past.
+contact|Yes|	65535 characters 

Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated|	1. Primary Contact is required
 desc	|Yes |	65535 characters|	1. This required field should be validated	|1. Description is required
 link|	No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	|NA
 email	| Yes |	128 characters|		| NA
@@ -4182,7 +4182,7 @@ offadd|	No|	65535 characters|	NA|	NA
 subject	|Yes|	255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	This opportunity cannot be published. Response date is required

  2.	DATE field in unexpected format. Expects YYYYMMDD  

3.	This opportunity cannot be published. Response date provided is in the past

 4.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact|	Yes|	65535 characters Default value: Primary 

Other types: Secondary, Owner|	1. This required field should be validated|	1. Primary Contact is Required
 desc|	Yes |	65535 characters|	1. This required field should be validated|	1. Description is required
 link	|No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
@@ -4213,7 +4213,7 @@ solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This requi
 ntype|	no|	[Refer Related Notices](#related-notices) |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
 awdnbr|	Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}	|1. This required field should be validated

 2. This field accepts only valid characters as mentioned under character limit/restrictions column |	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
 donbr|	No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) |	NA|	NA
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact|	Yes	|65535 characters

 65535 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	| 1. Primary Contact is Required
 desc|	Yes |	65535 characters|	1. This required field should be validated	|1. Description is required
 link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)	|NA	|NA
@@ -4231,23 +4231,23 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date|	No; Yes - for Award|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
+date|	Yes - Only Award 
 No - Rest|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
 zip|	No|	5 digits|	NA|	NA
-classcod	|Yes – For Solicitation/Combined/Sale of Surplus/ITB/Justification

  No – For rest	|Valid classification code (FAR, Section 5.207(g))	|1. This field is required and should be validated

 2. If a wrong classification code is given, then service throws an error |1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics	|Yes – For Combined/Solicitation 

No – For rest|	Valid NAICS Code  NAICS Reference	|1. For combined, this field is required and should be validated|	1. NAICS code is required
+classcod	|Yes – Solicitation/Combined/Sale of Surplus/ITB/Justification
  No – Rest	|Valid classification code (FAR, Section 5.207(g))	|1. This field is required and should be validated

 2. If a wrong classification code is given, then service throws an error |1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
+naics	|Yes –  Combined & Solicitation 
No – Rest|	Valid NAICS Code  NAICS Reference	|1. For combined, this field is required and should be validated|	1. NAICS code is required
 officeid|	Yes|	20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make modifications to an opportunity associated to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 offadd|	No	|65535 characters|	NA|	NA
 subject	|Yes|	255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
 solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1a. This required field if not given, service will throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 3.	Notice not found for correction
 ntype|	Yes |[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |	1.	NTYPE value provided is not valid
-respdate	|Yes – for Combined/Solicitation; No – For rest|YYYYMMDD	|1.	This required field is validated for combined type

 2.	No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction 

 3.	This date cannot be in past; has to be in future|	1.	This opportunity cannot be published. Response date is required

 2.	DATE field in unexpected format. Expects YYYYMMDD

 3.	This opportunity cannot be published. Response date provided is in the past
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
-contact|	No – For Award/Special notice

 Yes – For rest	|65535 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
-desc	|Yes - for Award/Justification; No - For Rest|	65535 characters|	1. This required field should be validated	|1. Description is required
+respdate	|Yes – for Combined/Solicitation 
  No – Rest (Special Notice/Sale of Surplus/Sources Sought/Presol must have either respdate or archdate)|YYYYMMDD	|1.	This required field is validated for combined type

 2.	No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction 

 3.	This date cannot be in past; has to be in future|	1.	This opportunity cannot be published. Response date is required

 2.	DATE field in unexpected format. Expects YYYYMMDD

 3.	This opportunity cannot be published. Response date provided is in the past
+**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+contact|	Yes – Rest 
 No – For Award/Special notice
	|65535 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
+desc	|Yes - Award/Justification 
  No - Rest|	65535 characters|	1. This required field should be validated	|1. Description is required
 link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	|NA
 links	|No	|Collection	|1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
 files|	No|	 |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-email	|Yes 
 No if type=Award|128 characters|	NA|NA
+email	|Yes - Rest 
 No - Only Award|128 characters|	NA|NA
 setaside|	No|	See Set-Aside Values section for valid codes|	NA|	NA
 popaddress|	No	|65535 characters|	NA|	NA
 popzip	|No	|5 digit	|NA |	NA
@@ -4273,7 +4273,7 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 date|	No	|YYYYMMDD	|1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
 zip	|No	|5 digits|	NA|	NA
 classcod|	Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error	|1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics|	No – this may change in future	|Valid NAICS Code  NAICS Reference|	NA|	NA
+naics|	No |Valid NAICS Code  NAICS Reference|	NA|	NA
 offadd|	No|	65535 characters|	NA|	NA
 officeid|	Yes|	20 characters	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
 subject	|Yes|	255 characters	|1. This required field should be validated	|1. $.data.title: is missing but it is required
@@ -4284,13 +4284,13 @@ awdnbr	|Yes|	255 characters|	1. This required field should be validated	|1. Awar
 modnbr|	No	|32 characters|	NA|	NA
 awddate	|No – May change in future|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions| 	1.	DATE field in unexpected format. Expects YYYYMMDD
 awdamt|	No|	64 characters|	NA|	NA
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be published. Archive date provided is in the past.
+**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be published. Archive date provided is in the past.
 contact|	Yes |	65535 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
 desc|	No|	65535 characters|	NA	|NA
 link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
 links	|No	| |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
 files	|No|	 |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-email	|Yes 
 No if type=Award |	128 characters|	NA|	NA
+email	|Yes  |	128 characters|	NA|	NA
 recovery_act	|No	|True or False|	NA	|NA
 correction	|No	|True or False

 If correcting a previously submitted J&A notice, specify true and the system will lookup the j&a by award number and sol number if applicable.|	If correction = true, system checks if an opportunity exists or not. If exists, then a new modified record will be posted of the same type and will be set as the latest. If No, then the request will be rejected |	 NA
 donbr	|Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( )|1. This field is required

 2. In value provided for this field does not meet the character limit/restrictions mentioned, then service throws an error|	1. Award Details Section - Task/Delivery Order Number is required field

 2. Award Details Section - Task/Delivery Order Number - Please enter a valid number
@@ -4342,7 +4342,7 @@ officeid|	No	|20 characters|	1. If an invalid officeid is given, then service th
 solnbr|	No |128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 ntype	| No |[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |  1. Notice Type value provided is not valid
 uploadtype|	No  – link or file|	A for amendment, S for solicitation or any title for other; 255 characters|	NA|	NA
-respdate| No |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
+respdate| No (Special Notice/Sale of Surplus/Sources Sought/Presol must have either respdate or archdate) |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
 links|	Yes; Either Links or Files needs to be provided |	Array of files|	1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

 2. If a link with same name already exists on the notice, then the system throws an error.

 3. If the Url is empty for a link, then the system throws an error.

 4.	If the description is missing for a link, then the system throws an error.| 1.	Links and/or files are not complete

 2.	Resource with the same name already exists

 3.	Link Resource must have a link

 4. Link Resource must have a description
 files	| Yes; Either Links or Files needs to be provided |	Array of files|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file type that you are trying to upload is not supported

6.	Resource with the same name already exists
 
@@ -4369,7 +4369,7 @@ offadd|	No|	65535 characters|	NA	|NA
 officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes|	255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
 solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-archdate	|No	|YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+**archdate** (updated needed)	|No	|YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact|	No|	65535 characters Default value: Primary 

Other types: Secondary, Owner|	NA|	NA
 desc|	Yes	|65535 characters|	1. This required field should be validated|	1. Description is required
 link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)	|NA|	NA
@@ -4393,7 +4393,7 @@ offadd|	No|	65535 characters|	NA|	NA
 subject	|Yes|	255 characters|	1. This required field should be validated|	1. Title is a required field.
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1.   Notice ID is a required field 

2. Notice ID must be unique based on selected notice type 

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces
 respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	Response date is required

  2.    DATE field in unexpected format. Expects YYYYMMDD  

3.	Response Date cannot be in the past

 4.	Response Date cannot exceed 5 years from current date
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	Inactive date provided is in the past
+**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	Inactive date provided is in the past
 desc|	Yes |	65535 characters|	1. This required field should be validated|	1. Description is a required field
 link	|No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
 email	|Yes	|128 characters	|1. This field is required 

  2. If an invalid email address is provided, then the service throws an error	| 1. Primary Contact - Email is required 

  2. Primary Contact - Please enter a valid Internet email address. Format: username@host.domain
@@ -4420,7 +4420,7 @@ offadd|	No|	65535 characters|	NA|	NA
 officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
 subject|	Yes	|255 characters	|1. This required field should be validated	|1. $.data.title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1. This required field should be validated

 2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact	|Yes|	65535 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
 desc|	Yes|	65535 characters	|1. This required field should be validated	|1. Description is required
 link|	No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
@@ -4465,7 +4465,7 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction
 officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
 ntype|	No|[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
-awdnbr	|Yes - for Award/ITB/Justification; No - for Rest|	255 characters|	NA|	NA
+awdnbr	|Yes - Award/ITB/Justification; No - Rest|	255 characters|	NA|	NA
 archdate|	Yes|	YYYYMMDD|	1. This required field should be validated  

2. If this value is available, this field should meet the character limit/restrictions 

3.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	New archive date provided is in the past

 3.	$.reason: null found, string expected. Unable to process request. Please try again
 
 #### cancelNotice
@@ -4481,7 +4481,7 @@ officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
 subject|	No|	255 characters|	NA|	NA
 solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error

 1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If valid solnbr is given with a different ntype, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple Notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 ntype	|No	|[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
-awdnbr|	Yes - for Award/ITB/Justification; No - for Rest|	255 characters|	NA|	NA
+awdnbr|	Yes - Award/ITB/Justification; No - Rest|	255 characters|	NA|	NA
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be cancelled
 contact|Yes|	65535 characters Default value: Primary 

Other types: Secondary, Owner| NA| NA
 desc|	Yes|	65535 characters|	1. This required field should be validated |	1. Unable to process request. Please try again
@@ -4504,7 +4504,7 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-notice_type	|No (at least 1 field is required) |	Solicitation type 

  Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL

   Note: Searches for AWARDS, JA and ITB will return both standalone notices AND base notices that contain one of these type	|Notice_type if given should be valid |	Notice Type is not recognized

 Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE,  ITB
+notice_type	|No (at least 1 field is required) |[Refer Related Notices](#related-notices) |	Notice Type is not recognized

 Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE,  ITB
 solnbr|	No (at least 1 field is required)|	Solicitation #|	NA|	NA
 awdnbr|	No (at least 1 field is required)|	Award #|	NA|	NA
 posted_from	|No	(at least 1 field is required)|Posted From Date. YYYYMMDD|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD

From 3ee7b159cad6dc01ffbee9e85888f39ede957d6c Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 15:39:07 -0400
Subject: [PATCH 046/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index efbdb16a2..b731902c5 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4468,7 +4468,7 @@ ntype|	No|[Refer Related Notices](#related-notices) |	1. If all the required fie
 awdnbr	|Yes - Award/ITB/Justification; No - Rest|	255 characters|	NA|	NA
 archdate|	Yes|	YYYYMMDD|	1. This required field should be validated  

2. If this value is available, this field should meet the character limit/restrictions 

3.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	New archive date provided is in the past

 3.	$.reason: null found, string expected. Unable to process request. Please try again
 
-#### cancelNotice
+#### cancelNotice (NEEDS FIX)
 
 Individual business rules per field are listed across each of the fields in below table.  
 * Note: : If user tries to cancel already cancelled opportunity, service throws an error - This opportunity cannot be cancelled. This opportunity is already cancelled. Unable to process request. Please try again.
@@ -4684,6 +4684,7 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
+10/25/2019 | v0.71| Updated Business Rules
 
 
Back to top

 

From f89807f438aa7c639be161c7426b5684d7ad9023 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 15:41:22 -0400
Subject: [PATCH 047/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index b731902c5..4d90c3610 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -153,7 +153,7 @@ This is a conversion table for notices using SOAP services
 ||SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE
 -----|-----|-----|-----|-----|-----|-----|-----|-----|-----|
 |**SRCSGT**||O|O|O|O|O|||O
-|**PRESOL**|O||O|O||O|O|O|O|O|O
+|**PRESOL**|O||O|O||O|O|O|O
 |**COMBINE**|O|O|||O||O|O|O
 |**SOL**|O|O|||O||O|O|O
 |**AWARD**|||O|O|||O|O|O

From 7b459566af2a14d9a8bb3a5dbd21c1bf545a1fce Mon Sep 17 00:00:00 2001
From: Prashant Pillai 
Date: Fri, 25 Oct 2019 16:20:14 -0400
Subject: [PATCH 048/149] updates

---
 _apidocs/opportunities-api.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index b09d06d5d..5458a6ee9 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2070,12 +2070,12 @@ Examples
 
 
Back to top

 
-### Delete Attachment in Opportunity
+### Delete Resource from Draft Opportunity
 
 ------- | -------
 **Request Type** | DELETE
 **URL** |/v1/api/{opportunityId}/attachments/{resourceId}
-**Summary** | Delete an attachment from an opportunity
+**Summary** | Delete a resource from a draft opportunity.
 **Consumes** | Request Parameters
 **Produces** | NA
 
@@ -2087,7 +2087,7 @@ Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
 resourceId | query | string | Yes | Resource ID
-deleteAll | query | boolean | Yes | Should be true if deleting attachment from all versions of a notice; else false
+deleteAll | query | boolean | Yes | Should be true if deleting resource from all versions of a notice; else false. The deleted published resources will not show up if there are any further revisions made for the current opportunity. 
 
 
Back to top

 

From 2ab536d946ab93828284f6007abc80c3469677cf Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 16:29:26 -0400
Subject: [PATCH 049/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 299 ++++++++++++++---------------
 1 file changed, 144 insertions(+), 155 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 4d90c3610..0e9f093e1 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -183,7 +183,7 @@ Award Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date |	date |	No |	Posting Date |	YYYYMMDD
+date |	date |	Yes |	Posting Date |	YYYYMMDD
 zip |	string |	No |	Zip Code |	5 digits
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
 naics |	string |	No |	NAICS Code |	Valid NAICS Code NAICS Reference
@@ -191,7 +191,7 @@ offadd |	string |	No |	Office Address |	65535 characters
 officeid |	string |	Yes |	Office id of the office where an opportunity is being submitted |	20 characters
 subject |	string |	Yes |	Subject |	255 characters
 solnbr |	string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	| string |	No |	Base Notice Type |	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype	| string |	No |	Base Notice Type |		[Refer Related Notices](#related-notices)
 awdnbr |	string |	 Yes |	Award Number |	255 characters
 awdnbr |	open text, label: Agency assigned number for control tracking and identification.
 Please use ONLY alphanumeric and - _ ( ) { } characters [no spaces]. |	 Yes |	Award Number |	255 characters
 awdamt |	string |	Yes |	Award Amount |	64 characters
@@ -262,8 +262,8 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr |	string |	Yes, if Non-Award |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	no |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
-awdnbr |  string | Yes, if Award| Award # |	255 characters
+ntype |	string |	no |	[Refer Related Notices](#related-notices)
+awdnbr |  string | Yes; Solicitation Number or Award Number is required| Award # |	255 characters
 deletetype |	string |	no |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | no | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
 
@@ -288,12 +288,12 @@ ArchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date | YYYYMMDD
-solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string | No |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
-archdate | date |	No | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
+solnbr | string |	No |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
+ntype |	string | No |	[Refer Related Notices](#related-notices)
+archdate | date |	Yes | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
 officeid | string |	No |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
 
-### Cancel Notice
 (CancelNotice)
+### Cancel Notice
 (CancelNotice) NEEDS FIX
 
 This method is used to post a cancellation notice to any base notice type already in the Opportunities system. Provide a Solicitation Number or an Award Number (for stand- alone awards) and other data outlined below for the cancellation notice.
 
@@ -348,14 +348,14 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
 zip |	string | No |	Zip Code | 5 digits
-classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
+classcod | string |	No |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics |	string | No |	NAICS Code | Valid NAICS Code  NAICS Reference
 officeid | string |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters
 offadd | string |	No | Office Address |	65535 characters
 subject |	string | Yes|	Title of the Pre-solicitation |	255 characters
 solnbr | string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-respdate | date |	No |	Response Date |	YYYYMMDD
-archdate | date |	No |	Archive Date | YYYYMMDD
+respdate | date |	No - However either Respdate or Archdate must be selected |	Response Date |	YYYYMMDD
+**archdate** (update needed) | date |	No - However either Respdate or Archdate must be selected |	Archive Date | YYYYMMDD
 contact |	string | Yes |	Contact Info | 65535 characters
 desc |string |Yes |	Description | 65535 characters
 link | GovURL – complex type | No |	Government Link has URL & description |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -426,7 +426,7 @@ offadd | string | No | Office Address	| 65535 characters
 subject | string | Yes | Subject | 255 characters
 solnbr | string |	Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes | Response Date | YYYYMMDD
-archdate | date |	No | Archive Date | YYYYMMDD
+**archdate** (update needed) | date |	No | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 65535 characters
 desc | string |	Yes |	Description |	65535 characters
 link | GovURL – complex type | No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -488,21 +488,21 @@ Mod Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	No |	Posting Date |	YYYYMMDD
+date | date |	Yes - Only Award 
 No - Rest |	Posting Date |	YYYYMMDD
 zip |	string |	No |	Zip Code |	5 digits
-classcod |	string	 | Yes – For combined type, presol type, Sale of surplus, No – For rest |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
-naics | 	string |	Yes – For combined type, No – For rest | 	NAICS Code |	Valid NAICS Code  NAICS Reference
+classcod |	string	 | Yes – Solicitation/Combined/Sale of Surplus/ITB/Justification 
No – Rest |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
+naics | 	string |	Yes – Combined & Solicitation 
 No – Rest | 	NAICS Code |	Valid NAICS Code  NAICS Reference
 officeid |	string	| Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
 offadd |	string	| no	| Office Address |	65535 characters
-subject	| string	| no |	Subject |	255 characters
+subject	| string	| Yes |	Subject |	255 characters
 solnbr | string |	Yes | 	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype |	string |	Yes |	Base Notice Type |	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation
-respdate |	date |	Yes – Combined, No – For rest |	Response Date |	YYYYMMDD
-archdate |	date |	no	| Archive Date |	YYYYMMDD
-contact |	string |	No – For Special notice, Yes – For rest |	Contact Info |	65535 characters
-desc |	string |	Yes	| Description |	65535 characters
+ntype |	string |	Yes |	Base Notice Type |	[Refer Related Notices](#related-notices)
+respdate |	date |	Yes – for Combined/Solicitation 
 No – Rest (Special Notice/Sale of Surplus/Sources Sought/Presol must have either respdate or archdate)|	Response Date |	YYYYMMDD
+**archdate** (update needed) |	date |	no	| Archive Date |	YYYYMMDD
+contact |	string |	Yes – Rest 
 No – For Award/Special notice|	Contact Info |	65535 characters
+desc |	string |	Yes - Award/Justification 
 No - Rest	| Description |	65535 characters
 link	| GovURL – complex type |	no |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email |	GovEmail – complex type |	no |	Government Email |	128 characters
+email |	GovEmail – complex type |	Yes - Rest 
 No - Only Award |	Government Email |	128 characters
 links |	DocumentLink[] |	no |	Array Of links |
 files |	DocumentFile[] |	no |	Array of files |
 setaside |	string |	no |	Set-Aside code |	See Set Aside Value Section for valid codes
@@ -568,14 +568,14 @@ offadd |	String	| No |	Office Address	| 65535 characters
 officeid |	String |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
 subject |	String |	Yes |	Subject |	255 characters
 solnbr	| String |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. 

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required
-ntype	| string |	No	| Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation
+ntype	| string |	No	| Base Notice Type | 	[Refer Related Notices](#related-notices)
 stauth	| String	| Yes |	Stat. Authority – Both foja & stauth values will be given under stauth in legacy |	Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7 
 Description of each of these stauth values is captured in section 4.4

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’
 awdnbr |	String |	Yes |	Award Number |	255 characters
 modnbr |	String |	No |	Mod Number |	32 characters
 awdamt |	String |	No |	Award Amount |	64 characters
-awddate |	Date |	No – May change in future	| Award Date |	YYYYMMDD
+awddate |	Date |	No	| Award Date |	YYYYMMDD
 donbr	| String |	Yes |	Task/Delivery Order Number |	255 characters from the set: a-z A-Z 0-9 - _ ( )
-archdate |	Date |	No |	Archive Date |	YYYYMMDD
+**archdate** (update needed)  |	Date |	No |	Archive Date |	YYYYMMDD
 contact |	String |	Yes | 	Contact Info |	65535 characters
 desc |	String |	No |	Description	| 65535 characters
 link |	GovURL |	No	| Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -643,7 +643,7 @@ offadd	| string	 | No |	Office Address |	65535 characters
 subject |	string |	Yes |	Subject |	255 characters
 solnbr	| string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate |	date |	No |	Response Date |	YYYYMMDD
-archdate |	date |	No |	Archive Date	| YYYYMMDD
+**archdate** (update needed) |	date |	No |	Archive Date	| YYYYMMDD
 contact	| string	| Yes |	Contact Info	| 65535 characters
 Default value: Primary 
Other types: Secondary, Owner
 desc | string |	Yes |	Description |	65535 characters
 link |	GovURL – complex type |	No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -717,7 +717,7 @@ officeid	| string |	Yes |	Office id of the office where an opportunity is being
 offadd |	String |	No |	Office Address	| 65535 characters
 subject | 	String |	Yes |	Subject |	255 characters
 solnbr	| String |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-archdate |	Date |	No |	Archive Date |	YYYYMMDD
+**archdate** (update needed) |	Date |	No |	Archive Date |	YYYYMMDD
 contact |	String |	No	| Contact Info |	65535 characters
 desc |	String |	Yes |	Description |	65535 characters
 link	| GovURL – complex type	| No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -783,7 +783,7 @@ officeid	|string	|Yes|	Office id of the office where an opportunity is being sub
 offadd|	string|	No	|Office Address	|65535 characters
 subject|	string|	Yes|	Subject	|255 characters
 solnbr|	string	|Yes	|Sol #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-archdate|	date|	No|	Archive Date|	YYYYMMDD
+**archdate** (update needed)|	date|	No|	Archive Date|	YYYYMMDD
 contact|	string|	Yes|	Contact Info|	65535 characters
 desc|	string	|Yes|	Description	|65535 characters
 link	|GovURL – complex type|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -850,7 +850,7 @@ offadd | string | No | Office Address	| 65535 characters
 subject | string | Yes | Subject | 255 characters
 solnbr | string |	Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes | Response Date | YYYYMMDD
-archdate | date |	No | Archive Date | YYYYMMDD
+**archdate** (update needed) | date |	No | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 65535 characters
 desc | string |	Yes |	Description |	65535 characters
 link | GovURL – complex type | No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -920,10 +920,10 @@ officeid|	String|	Yes|	Office id of the office where an opportunity is being sub
 offadd|	String	|No|	Office Address|	65535 characters
 subject|	String|	Yes|	Subject	|255 characters
 solnbr	|String	|Yes|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	|string	|No|	Base Notice Type|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation, "AWARD" - for Award
+ntype	|string	|No|	[Refer Related Notices](#related-notices)
 awdnbr|	String	|Yes	|Award Number|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 donbr|	String|	No	|Task/Delivery Order Number	|255 characters from the set: a-z A-Z 0-9 - _ ( )
-archdate	|Date	|No	|Archive Date|	YYYYMMDD
+**archdate** (update needed) 	|Date	|No	|Archive Date|	YYYYMMDD
 contact|	String|	Yes|	Contact Info	|65535 characters; Default value = Primary, Other types are: Secondary, Owner
 desc	|String	|Yes	|Description|	65535 characters
 link|	GovURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -994,31 +994,30 @@ Complete notice Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date|	date|	No	|Posting Date|	YYYYMMDD
+date|	date|	Yes - Only Award
No - Rest	|Posting Date|	YYYYMMDD
 notice_type	|string	|Yes|	Notice type	|Valid options outlined above
 zip	|string	|No	|Zip Code|	5 digits
 classcod|	string|	No|	Class-Code	|Valid classification code (FAR, Section 5.207(g))
-naics	|string	|No	|NAICS Code|	Valid NAICS Code  NAICS Reference
-officeid|	String|	No|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	|20 characters
+naics	|string	|Yes - Combined Synopsis/Solicitation & Solicitation  
 No - Rest	|NAICS Code|	Valid NAICS Code  NAICS Reference
+officeid|	String|	Yes|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	|20 characters
 offadd	|string|	No|	Office Address	|65535 characters
 subject|	string|	Yes – For presol, combined, itb, ja, award, special, surplus

 No – for rest|	Subject|	255 characters
-solnbr|	string|	Yes – For presol, combined, itb, ja, award, special, document, surplus

 No – for rest|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|string	|no	|Base Notice Type	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation 
-awdnbr|	string|	Yes – For Award & JA, ITB

 No – For rest|	Award #	|255 characters
-donbr	|string	|Yes – For JA

 No – For rest|	Delivery/Task Order Number	|255 characters
-awdamt	|string|	Yes – For Award

 No – For rest	|Award Amount|	64 characters
+solnbr|	string|	Yes - Rest  
 No - Only Special Notice|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+ntype	|string	|no	|[Refer Related Notices](#related-notices)
+awdnbr|	string|	Yes – Award, ITB & JA 
 No – Rest|	Award #	|255 characters
+donbr	|string	|Yes – JA 
 No – Rest|	Delivery/Task Order Number	|255 characters
+awdamt	|string|	Yes – Award 
 No – Rest	|Award Amount|	64 characters
 linenbr|	string	|No|	Award Line Item Number	|255 characters
-awddate	|date|	Yes – for award; No – for rest|	Award Date	|YYYYMMDD
-stauth	|string	|Yes – for JA; No – for test	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

 Description of each of these stauth values is captured in Stauth Value section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’
-modnbr	|string	|No	|J&A and FairOpp Contract Modification Number|	32 digits
-respdate|	date|	Yes – for combined

 No – for rest	|Response Date	|YYYYMMDD
-archdate|	date|	No|	Archive Date|	YYYYMMDD
-awardee|	string|	Yes - award

 No – for rest|	Awardee	|65535 characters
+awddate	|date|	Yes – Award 
 No – Rest|	Award Date	|YYYYMMDD
+stauth	|string	|Yes –  JA 
 No – Rest	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

 Description of each of these stauth values is captured in Stauth Value section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’
+respdate|	date|	Yes – Only Combined/Solicitation
 No – Rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)	|Response Date	|YYYYMMDD
+**archdate** (update needed) |	date|	No|	Archive Date|	YYYYMMDD
+awardee|	string|	Yes – Only Award 
 No – Rest|	Awardee	|65535 characters
 awardee_duns|	string	|no	|Awardee DUNS	|9 digits with optional plus 4
-contact|	string|	Yes – for presol, submitSourcesSought, combined, itb, ja, award, saleofSurplus, Solicitation

 No – for rest|	Contact Info|	65535 characters
-desc	|string|	Yes – For presol, submitSourcesSought, combined, ITB, special and saleOfSurplus, Solicitation

 No – For rest|	Main Description|	65535 characters
+contact|	string|	Yes - Rest 
 No - Award & Special Notice|	Contact Info|	65535 characters
+desc	|string|	Yes - Rest  
 No – Justfication & Award|	Main Description|	65535 characters
 link|	GovernmentURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email|	GovernmentEmail|	Yes / No: Only for Award|	Government Email	|128 characters
+email|	GovernmentEmail|	Yes - Rest 
No - Only Award|	Government Email	|128 characters
 links	|DocumentLink []|	no	|Array Of links	|
 files	|DocumentFile[]|	no|	Array of files	|
 setaside|	string|	no|	Set-Aside code |	See Set Aside Section for valid codes
@@ -1078,12 +1077,12 @@ DocumentUpload Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 Date|	Date|	No	|Posting Date	|YYYYMMDD
-solnbr	|String	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|String	|No|	Base Notice Type|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation
-uploadtype|	String|	No – May change in future|	Upload Type|	A for amendment, S for solicitation or any title for other; 255 characters
-respdate	|Date	|No	|Response Date|	YYYYMMDD
-links|	DocumentLin k[]|	No|	Array Of links	|
-files	|DocumentFile []|	No|	Array of files	|
+solnbr	|String	|No|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+ntype	|String	|No|	[Refer Related Notices](#related-notices)
+uploadtype|	String|	No |	Upload Type|	A for amendment, S for solicitation or any title for other; 255 characters
+respdate	|Date	|No |Response Date|	YYYYMMDD
+links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
+files	|DocumentFile []|	Yes; Either Links or Files needs to be provided|	Array of files	|
 officeid	|String|	No|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account|	20 characters
 
 DocumentLink Complex Type Definition:
@@ -1122,7 +1121,7 @@ UnarchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	|Base Notice Type	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype	|string	|No	|[Refer Related Notices](#related-notices)
 awdnbr	|string|	No|	Award #|	255 characters
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
 
@@ -1187,7 +1186,7 @@ IVLListRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	yes|	Solicitation #
-ntype	|string	|no	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice,  “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype	|string	|no	|[Refer Related Notices](#related-notices)
 
 IVLListResponse Complex Type Definition:
 
@@ -1232,13 +1231,9 @@ AuthorizedPartyListRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	yes	|Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below
-ntype|	string|	no|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype|	string|	no|	V[Refer Related Notices](#related-notices)
 nonfbo_solbr|	string|	no|	Non-fbo Solicitation #. Not supported for this method
 status| string	|no	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests.
-resource_name	|string	|Yes |Only populates if the type_of_request is a resource.
-type_of_request 	|string	|Yes |Indicates if the id is a resource or a notice level request
-
-
 
 AuthorizedPartyListResponse Complex Type Definition:
 
@@ -1280,11 +1275,10 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string	|yes|	Solicitation #
-ntype	|string	|no|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice,  “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype	|string	|no|	[Refer Related Notices](#related-notices)
 nonfbo_solbr	|string|	no|	Non-fbo Solicitation #.  Not supported for this method
 Id|	string|	yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
-vendor|	VendorData|	no|	Complex type not used in this method
-reason	|string|	no|	rejection reason not used in this method
+
 
 Response:
 
@@ -1307,11 +1301,9 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name	|Type	|Required|	Description
 -----|-----|-----|----
 solnbr	|string	|yes|	Solicitation #
-ntype|	string|	no|	Valid values: "PRESOL" - for Presolicitation 
 "COMBINE" - for Combined Synopsis/Solicitation 
 "SRCSGT" - for Sources Sought 
 "SSALE" - for Sale of Surplus Property
 "SNOTE" - for Special Notice
  “ITB” – for Intent to Bundle Requirements (DoD- Funded)
+ntype|	string|	no|	[Refer Related Notices](#related-notices)
 nonfbo_solbr|	string|	no|	Non-fbo Solicitation #.  Not supported for this method
-Id|	string|	no| Not used in this method 
 vendor|	VendorData	|yes|	Complex type defined below
-reason	|string|	no	|Rejection reason not used in this method
 
 Response:
 
@@ -1346,11 +1338,10 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string	|yes|	Solicitation #
-ntype	|string	|no|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice,  “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype	|string	|no|[Refer Related Notices](#related-notices)
 nonfbo_solbr	|string|	no|	Non-fbo Solicitation #.  Not supported for this method
-Id|	string|	yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
-vendor|	VendorData|	no|	Complex type not used in this method
-reason	|string|	no|	rejection reason not used in this method
+Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
+reason	|string|	Yes|	rejection reason not used in this method
 
 Response:
 
@@ -1374,9 +1365,8 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	yes|	Solicitation #
-ntype	|string	|no|	Valid values: "PRESOL" - for Presolicitation
 "COMBINE" - forCombined Synopsis/Solicitation
 "SRCSGT" - for Sources Sought
 "SSALE" - for Sale of Surplus Property
 "SNOTE" - for Special Notice 
  “ITB” – for Intent to Bundle Requirements (DoD- Funded)
+ntype	|string	|no|	[Refer Related Notices](#related-notices)
 nonfbo_solbr	|string	|no	|Non-fbo Solicitation #.  Not supported for this method
-Id	|string|	no |Not used in this method 
 vendor	|VendorData|	yes|	Complex type defined below
 reason|	string|	yes	|Rejection Reason 
 
@@ -1411,11 +1401,10 @@ ExplicitAccessRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	yes|	Solicitation #
-ntype	|string	|no	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice,  “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype	|string	|no	|[Refer Related Notices](#related-notices)
 nonfbo_solbr|	string|	no	|Non-fbo Solicitation #.   Not supported for this method.
 Id	|string	|no	|Not used in this method
 vendor	|VendorData|	yes|	Complex type defined below
-reason	|string	|no	|rejection reason not used in this method
 
 Response:
 
@@ -1450,12 +1439,12 @@ NoticeListRequest Complex Type Definition:
 
 Element Name|	Type|	Required|	Description
 -----|-----|-----|-----
-notice_type	|string|	No|	Solicitation #.  Valid Values: PRESOL, COMBINE,  AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL.  Note:Searches for awardsj&as, itb’s and fairopps will return both standalone notices AND base notices that contain one of these type
-solnbr	|string	|No	|Solicitation #
-awdnbr	|string	|No	|Award #
-posted_from	|date|	No|	Posted From Date. YYYYMMDD.
-posted_to	|date|	|No	Posted To Date. YYYYMMDD
-documents_to_search	|string|	No|	Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided.
+notice_type	|string|	No (at least 1 field is required)|	[Refer Related Notices](#related-notices)  Note:Searches for awardsj&as, itb’s and fairopps will return both standalone notices AND base notices that contain one of these type
+solnbr	|string	|No (at least 1 field is required)	|Solicitation #
+awdnbr	|string	|No	(at least 1 field is required)|Award #
+posted_from	|date|	No (at least 1 field is required)|	Posted From Date. YYYYMMDD.
+posted_to	|date|	|No (at least 1 field is required)|	Posted To Date. YYYYMMDD
+documents_to_search	|string|	No(at least 1 field is required)|	Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided.
 
 Response:
 
@@ -1500,10 +1489,10 @@ NoticeDataRequest Complex Type Definition:
 
 Element Name|	Type|	Required|	Description
 -----|-----|-----|-----
-notice_id	|string	|Yes|	Unique ID found from getList call or ID’s for changes found in getNoticeData call.
-get_changes	|boolean|	No|	True or false
 Pass in true to get the full notice history with all changes
-get_changes_from_date	|date|	No|	If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned.
-get_file_data|	boolean|	No|	True or False
 Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the meta details/links will still be provided.
+notice_id	|string	|No (at least 1 field is required)|	Unique ID found from getList call or ID’s for changes found in getNoticeData call.
+get_changes	|boolean|	No (at least 1 field is required)|	True or false
 Pass in true to get the full notice history with all changes
+get_changes_from_date	|date|	No (at least 1 field is required)|	If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned.
+get_file_data|	boolean|	No (at least 1 field is required)|	True or False
 Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the meta details/links will still be provided.
 
 Response:
 
@@ -2149,75 +2138,75 @@ Please note that variances may exist between SOAP requests generated by differen
     Response Sample – Success
 
 

@@ -4122,7 +4111,7 @@ respdate|Yes – Only Combined/Solicitation
 No – Rest (Required for Source
 **archdate** (updated needed)|	No|	YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past.
 awardee	|Yes – Only Award
 No – Rest|	6553 characters|	NA|	NA
 awardee_duns|	No	|9 digits with optional plus 4|	NA|	NA
-contact	| Yes - Rest 
 No - Award & Special Notice;	|65535 characters Default value = Primary Other types are: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
+contact	| Yes - Rest 
 No - Award & Special Notice	|65535 characters Default value = Primary Other types are: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
 desc| Yes - Rest 
 No – Justfication & Award 	|65535 characters|	1. This required field should be validated.|	1. Description is required
 link|No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	| NA
 email|	Yes - Rest 
 No - Only Award|	128 characters|	NA	 |NA

From 3a1c12622614a7e32bede16c6bdaf2de3f7380c9 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 16:34:51 -0400
Subject: [PATCH 050/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 146 ++++++++++++++---------------
 1 file changed, 73 insertions(+), 73 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 0e9f093e1..b3ecee684 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -214,8 +214,8 @@ GovURL Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	yes |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	yes |	Description |	255 characters
+url |	string |	Yes |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string |	Yes |	Description |	255 characters
 
 GovEmail Complex Type Definition
 
@@ -262,10 +262,10 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr |	string |	Yes, if Non-Award |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	no |	[Refer Related Notices](#related-notices)
+ntype |	string |	No |	[Refer Related Notices](#related-notices)
 awdnbr |  string | Yes; Solicitation Number or Award Number is required| Award # |	255 characters
 deletetype |	string |	no |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
-deletemethod |	string | no | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
+deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
 
 ### Archive Notice 
(ArchiveNotice)
 
@@ -372,15 +372,15 @@ GovURL Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | no |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	no | Description |	255 characters
+url	| string | No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc | string |	No | Description |	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address	| string | no |Email Address |128 characters
-desc | string	| no | Description | 255 characters
+address	| string | No |Email Address |128 characters
+desc | string	| No | Description | 255 characters
 
 DocumentLink Complex Type Definition: This field is not implemented
 
@@ -493,23 +493,23 @@ zip |	string |	No |	Zip Code |	5 digits
 classcod |	string	 | Yes – Solicitation/Combined/Sale of Surplus/ITB/Justification 
No – Rest |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
 naics | 	string |	Yes – Combined & Solicitation 
 No – Rest | 	NAICS Code |	Valid NAICS Code  NAICS Reference
 officeid |	string	| Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
-offadd |	string	| no	| Office Address |	65535 characters
+offadd |	string	| No	| Office Address |	65535 characters
 subject	| string	| Yes |	Subject |	255 characters
 solnbr | string |	Yes | 	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype |	string |	Yes |	Base Notice Type |	[Refer Related Notices](#related-notices)
 respdate |	date |	Yes – for Combined/Solicitation 
 No – Rest (Special Notice/Sale of Surplus/Sources Sought/Presol must have either respdate or archdate)|	Response Date |	YYYYMMDD
-**archdate** (update needed) |	date |	no	| Archive Date |	YYYYMMDD
+**archdate** (update needed) |	date |	No	| Archive Date |	YYYYMMDD
 contact |	string |	Yes – Rest 
 No – For Award/Special notice|	Contact Info |	65535 characters
 desc |	string |	Yes - Award/Justification 
 No - Rest	| Description |	65535 characters
-link	| GovURL – complex type |	no |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+link	| GovURL – complex type |	No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 email |	GovEmail – complex type |	Yes - Rest 
 No - Only Award |	Government Email |	128 characters
-links |	DocumentLink[] |	no |	Array Of links |
-files |	DocumentFile[] |	no |	Array of files |
-setaside |	string |	no |	Set-Aside code |	See Set Aside Value Section for valid codes
-popaddress |	string |	no	 | Pop Add |	65535 characters
-popzip	| string |	no	 | Pop Zip |	5 digits
-popcountry |	string |	no	 | Pop Country |	32 characters
-recovery_act |	boolean |	no |	Recovery Act |	True or False
+links |	DocumentLink[] |	No |	Array Of links |
+files |	DocumentFile[] |	No |	Array of files |
+setaside |	string |	No |	Set-Aside code |	See Set Aside Value Section for valid codes
+popaddress |	string |	No	 | Pop Add |	65535 characters
+popzip	| string |	No	 | Pop Zip |	5 digits
+popcountry |	string |	No	 | Pop Country |	32 characters
+recovery_act |	boolean |	No |	Recovery Act |	True or False
 
 GovURL Complex Type Definition:
 
@@ -589,15 +589,15 @@ GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	yes |	Website Address	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	| string	| yes |	Description |	255 characters
+url |	string |	Yes |	Website Address	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	| string	| Yes |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address |	string	| yes |	Email Address	| 128 characters
-desc |	string |	yes |	Description |	255 characters
+address |	string	| Yes |	Email Address	| 128 characters
+desc |	string |	Yes |	Description |	255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -660,15 +660,15 @@ GovURL Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	 | string	| yes |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	yes |	Description |	255 characters
+url	 | string	| Yes |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string |	Yes |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address	| string |	yes |	Email Address |	128 characters
-desc	| string |	yes |	Description |	255 characters
+address	| string |	Yes |	Email Address |	128 characters
+desc	| string |	Yes |	Description |	255 characters
 
 DocumentLink Complex Type Definition: This field is not implemented
 
@@ -730,15 +730,15 @@ GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|yes|	Website Address|	255 characters, consist of a restricted set of characters (see URL specification - RFC2396)
-desc|	string	|yes|	Description|	255 characters
+url	|string	|Yes|	Website Address|	255 characters, consist of a restricted set of characters (see URL specification - RFC2396)
+desc|	string	|Yes|	Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address	|string|	yes|	Email Address	|128 characters
-desc	|string	|yes	|Description	|255 characters
+address	|string|	Yes|	Email Address	|128 characters
+desc	|string	|Yes	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -796,15 +796,15 @@ GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|yes	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string	|yes	|Description	|255 characters
+url	|string	|Yes	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	|string	|Yes	|Description	|255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address|	string|	yes|	Email Address	|128 characters
-desc	|string	|yes	|Description	|255 characters
+address|	string|	Yes|	Email Address	|128 characters
+desc	|string	|Yes	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -937,15 +937,15 @@ GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|yes	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string|	yes|	Description|	255 characters
+url	|string	|Yes	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	|string|	Yes|	Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address	|string	|yes|	Email Address	|128 characters
-desc|	string|	yes	|Description|	255 characters
+address	|string	|Yes|	Email Address	|128 characters
+desc|	string|	Yes	|Description|	255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -1013,14 +1013,14 @@ stauth	|string	|Yes –  JA 
 No – Rest	|J&A StatutoryAuthority

 Not
 respdate|	date|	Yes – Only Combined/Solicitation
 No – Rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)	|Response Date	|YYYYMMDD
 **archdate** (update needed) |	date|	No|	Archive Date|	YYYYMMDD
 awardee|	string|	Yes – Only Award 
 No – Rest|	Awardee	|65535 characters
-awardee_duns|	string	|no	|Awardee DUNS	|9 digits with optional plus 4
+awardee_duns|	string	|No	|Awardee DUNS	|9 digits with optional plus 4
 contact|	string|	Yes - Rest 
 No - Award & Special Notice|	Contact Info|	65535 characters
 desc	|string|	Yes - Rest  
 No – Justfication & Award|	Main Description|	65535 characters
 link|	GovernmentURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 email|	GovernmentEmail|	Yes - Rest 
No - Only Award|	Government Email	|128 characters
-links	|DocumentLink []|	no	|Array Of links	|
-files	|DocumentFile[]|	no|	Array of files	|
-setaside|	string|	no|	Set-Aside code |	See Set Aside Section for valid codes
+links	|DocumentLink []|	No	|Array Of links	|
+files	|DocumentFile[]|	No|	Array of files	|
+setaside|	string|	No|	Set-Aside code |	See Set Aside Section for valid codes
 popaddress|	string|	No|	POP Address	|65535 characters
 popzip|	string	|No	|POP Zip	|5 digits
 popcountry|	string|	Yes – For wards; No – For rest|	POP Country|	32 characters
@@ -1033,15 +1033,15 @@ GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url|	string|	yes|	Website Address|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	yes	|Description|	255 characters
+url|	string|	Yes|	Website Address|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc|	string|	Yes	|Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address|	string|	yes	|Email Address|	128 characters
-desc	|string|	yes	|Description	|255 characters
+address|	string|	Yes	|Email Address|	128 characters
+desc	|string|	Yes	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -1185,8 +1185,8 @@ IVLListRequest Complex Type Definition:
 
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
-solnbr|	string|	yes|	Solicitation #
-ntype	|string	|no	|[Refer Related Notices](#related-notices)
+solnbr|	string|	Yes|	Solicitation #
+ntype	|string	|No	|[Refer Related Notices](#related-notices)
 
 IVLListResponse Complex Type Definition:
 
@@ -1230,10 +1230,10 @@ AuthorizedPartyListRequest Complex Type Definition:
 
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
-solnbr|	string|	yes	|Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below
-ntype|	string|	no|	V[Refer Related Notices](#related-notices)
+solnbr|	string|	Yes	|Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below
+ntype|	string|	No|	V[Refer Related Notices](#related-notices)
 nonfbo_solbr|	string|	no|	Non-fbo Solicitation #. Not supported for this method
-status| string	|no	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests.
+status| string	|No	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests.
 
 AuthorizedPartyListResponse Complex Type Definition:
 
@@ -1274,10 +1274,10 @@ ExplicitAccessRequestComplex Type Definition:
 
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
-solnbr|	string	|yes|	Solicitation #
-ntype	|string	|no|	[Refer Related Notices](#related-notices)
+solnbr|	string	|Yes|	Solicitation #
+ntype	|string	|No|	[Refer Related Notices](#related-notices)
 nonfbo_solbr	|string|	no|	Non-fbo Solicitation #.  Not supported for this method
-Id|	string|	yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
+Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
 
 
 Response:
@@ -1300,10 +1300,10 @@ ExplicitAccessRequestComplex Type Definition:
 
 Element Name	|Type	|Required|	Description
 -----|-----|-----|----
-solnbr	|string	|yes|	Solicitation #
-ntype|	string|	no|	[Refer Related Notices](#related-notices)
-nonfbo_solbr|	string|	no|	Non-fbo Solicitation #.  Not supported for this method
-vendor|	VendorData	|yes|	Complex type defined below
+solnbr	|string	|Yes|	Solicitation #
+ntype|	string|	No|	[Refer Related Notices](#related-notices)
+nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method
+vendor|	VendorData	|Yes|	Complex type defined below
 
 Response:
 
@@ -1337,9 +1337,9 @@ ExplicitAccessRequestComplex Type Definition:
 
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
-solnbr|	string	|yes|	Solicitation #
-ntype	|string	|no|[Refer Related Notices](#related-notices)
-nonfbo_solbr	|string|	no|	Non-fbo Solicitation #.  Not supported for this method
+solnbr|	string	|Yes|	Solicitation #
+ntype	|string	|No|[Refer Related Notices](#related-notices)
+nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
 reason	|string|	Yes|	rejection reason not used in this method
 
@@ -1364,11 +1364,11 @@ ExplicitAccessRequestComplex Type Definition:
 
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
-solnbr|	string|	yes|	Solicitation #
-ntype	|string	|no|	[Refer Related Notices](#related-notices)
-nonfbo_solbr	|string	|no	|Non-fbo Solicitation #.  Not supported for this method
-vendor	|VendorData|	yes|	Complex type defined below
-reason|	string|	yes	|Rejection Reason 
+solnbr|	string|	Yes|	Solicitation #
+ntype	|string	|No|	[Refer Related Notices](#related-notices)
+nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method
+vendor	|VendorData|	Yes|	Complex type defined below
+reason|	string|	Yes	|Rejection Reason 
 
 Response:
 
@@ -1400,11 +1400,11 @@ ExplicitAccessRequest Complex Type Definition:
 
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
-solnbr|	string|	yes|	Solicitation #
-ntype	|string	|no	|[Refer Related Notices](#related-notices)
-nonfbo_solbr|	string|	no	|Non-fbo Solicitation #.   Not supported for this method.
-Id	|string	|no	|Not used in this method
-vendor	|VendorData|	yes|	Complex type defined below
+solnbr|	string|	Yes|	Solicitation #
+ntype	|string	|No	|[Refer Related Notices](#related-notices)
+nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.
+Id	|string	|No	|Not used in this method
+vendor	|VendorData|	Yes|	Complex type defined below
 
 Response:
 
@@ -1596,7 +1596,7 @@ FileDataRequest Complex Type Definition:
 
 Element Name|	Type|	Required|	Description
 -----|-----|-----|-----
-file_id	|string|	yes|	Unique ID of a file found from getNoticeData call  (i.e. file_id element)
+file_id	|string|	Yes|	Unique ID of a file found from getNoticeData call  (i.e. file_id element)
 
 Response:
 
@@ -4100,7 +4100,7 @@ offadd|	No|	65535 characters|	Not-Used|	NA
 officeid	|Yes	|20 characters 	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided


 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes	|255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
 solnbr|	 Yes - Rest 
 No - Only Special Notice|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

 2. If duplicate solicitation number is given, then system throws an error

 3. For an invalid solnbr and notice_type combination, the service throws an error|	1.Notice Id is required

 2. Notice Id for the selected opportunity type already exists

 3. Opportunity not found with given solicitation number and ntype
-ntype|	no|	[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error 	|NTYPE value provided is not valid
+ntype|	No|	[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error 	|NTYPE value provided is not valid
 awdnbr|	Yes –  Award, ITB & JA 
 No – Rest|	255 characters|	1. This required field should be validated|	1. Award Details Section - Contract Award Number is a required field
 donbr|	Yes – JA 
 No – Rest	|255 characters	|1. This is required field for JA	|1. Award Details Section - Task/Delivery Order Number is required field
 awdamt	|Yes – Award 
 No – Rest|	64 characters|	1. This required field should be validated	|1. Award Details Section – Amount is a required field.

From ae187591b0b92c695740e1692d458ff6700ce9c5 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 16:41:05 -0400
Subject: [PATCH 051/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index b3ecee684..6578b0b03 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -31,10 +31,10 @@ To perform an operation, user who is registered with beta.sam.gov should have ei
 * On beta.sam.gov, please log in and click on the profile and go to Account Details. AAC is listed under 'Organization Information' section.
 * On alpha.sam.gov, please log in and click on the profile and go to Account Details. AAC is listed under 'Organization Information' section.
 
-### *Type of Connection Validation (Future Implementation)*
+### Type of Connection Validation 
 All SOAP Web Service requests will be validated against the Type of Connection within the system account profile. All requests without "SOAP" type of connection in the system account profile will be rejected with an error.
 
-### *IP Address Validation (Future Implementation)*
+### IP Address Validation
 All SOAP Web Service requests will be validated against the IP Addresses registered within the system account profile. All requests that are not from registered IP address(es) in the system account profile will be rejected with an error.
 
 ### Authentication Methods
@@ -4668,7 +4668,7 @@ Date | Version | Description
 ------|---------------|---------
 5/10/2019 | v0.1 | Base Version
 7/22/2019 | v0.2 | Workflow Chart Added
-8/01/2019  | v0.3 | Added Future Implementation for IP Address Validation and Type of Connection 
+8/01/2019  | v0.3 | Added IP Address Validation and Type of Connection 
 8/01/2019 | v0.4 | Added the details for the Solicitation notice type and business rules for nType
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions

From 4890569bfe7232b1b24b3cdc450e8729af831c9c Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Fri, 25 Oct 2019 16:43:14 -0400
Subject: [PATCH 052/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 6578b0b03..06a5db4db 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -138,15 +138,15 @@ far7 | FAR 6.302-7 - Public interest
 
 This section indicates the list of  notices that can be used in the SOAP services
 
-PRESOL - Presolicitation
-COMBINE - Combined Synopsis/Solicitation
-SRCSGT - for Sources Sought
-SSALE - Sale of Surplus Property
-SNOTE - Special Notice
-JA – Justification
-ITB – Intent to Bundle 
-SOL - Solicitation
-AWARD - Award
+PRESOL - Presolicitation

+COMBINE - Combined Synopsis/Solicitation

+SRCSGT - for Sources Sought

+SSALE - Sale of Surplus Property

+SNOTE - Special Notice

+JA – Justification

+ITB – Intent to Bundle 

+SOL - Solicitation

+AWARD - Award

 
 This is a conversion table for notices using SOAP services
 

From c47effc14a1c0cc17397cffb89dfc5ef00250287 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Sat, 26 Oct 2019 10:21:49 -0400
Subject: [PATCH 053/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 06a5db4db..dc9c8cab6 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -115,6 +115,16 @@ VSS | Veteran-Owned Small Business Sole source (specific to Department of Vetera
 ### Notice Types
 The web service API includes specific methods to submit each of the base notice types (i.e. presolicitation, combined/synopsis, award, etc.). You will find these outlined in the sections below.
 
+PRESOL - Presolicitation

+COMBINE - Combined Synopsis/Solicitation

+SRCSGT - for Sources Sought

+SSALE - Sale of Surplus Property

+SNOTE - Special Notice

+JA – Justification

+ITB – Intent to Bundle 

+SOL - Solicitation

+AWARD - Award

+
 ### Stauth Valid Values
 Below table captures stauth values to use while making requests as needed.
 
@@ -136,18 +146,6 @@ far7 | FAR 6.302-7 - Public interest
 
 ### Related Notices
 
-This section indicates the list of  notices that can be used in the SOAP services
-
-PRESOL - Presolicitation

-COMBINE - Combined Synopsis/Solicitation

-SRCSGT - for Sources Sought

-SSALE - Sale of Surplus Property

-SNOTE - Special Notice

-JA – Justification

-ITB – Intent to Bundle 

-SOL - Solicitation

-AWARD - Award

-
 This is a conversion table for notices using SOAP services
 
 ||SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE

From 922d3f94e816324ffeeaa966903cdf2de282a2d5 Mon Sep 17 00:00:00 2001
From: Prashant Pillai 
Date: Mon, 28 Oct 2019 09:19:40 -0400
Subject: [PATCH 054/149] updates

---
 _apidocs/opportunities-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 5458a6ee9..8c6ad274a 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -1910,7 +1910,7 @@ Examples
 
 
Back to top

 
-### Create Attachment in Draft Opportunity
+### Create Resource in Draft Opportunity
 
 ------- | -------
 **Request Type** | POST
@@ -1968,7 +1968,7 @@ Examples
 
 
Back to top

 
-### Update Attachment in Draft Opportunity
+### Update Resource in Draft Opportunity
 
 ------- | -------
 **Request Type** | PATCH

From bdc2179725a3620a56aee8356392187d5ac3bacf Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Mon, 28 Oct 2019 10:10:42 -0400
Subject: [PATCH 055/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 1116 +++++++++++-----------------
 1 file changed, 421 insertions(+), 695 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index dc9c8cab6..be0d070c3 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -13,7 +13,7 @@ The Opportunity Management SOAP APIs will allow authorized users to submit and r
 
 ## Web Services 
 Description Language (WSDL)
 To view the WSDL for all available methods and object definitions, refer below links:
-<<<<<<< HEAD
+
 * Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/fboendpoint/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fboendpoint/fbo.wsdl 
 * Beta WSDL Link: https://api.sam.gov/prod/ws/fboendpoint/services.wsdl or https://api.sam.gov/prod/ws/fboendpoint/fbo.wsdl
 
@@ -26,7 +26,6 @@ To view the current workflow of SOAP web service, refer below file:
 ### User Accounts
 To perform an operation, user who is registered with beta.sam.gov should have either Contracting Officer role OR Contracting Specialist role. Note that to perform an operation, user must have only one role.
 
-
 **Note** To submit any opportunity for an office, user should provide office org key or AAC. If office org key is known, please provide the same in the 'officeid' field in the requests. If office org key is not available, then users can provide AAC in place of office org key in 'officeid' field. In order to get AAC:
 * On beta.sam.gov, please log in and click on the profile and go to Account Details. AAC is listed under 'Organization Information' section.
 * On alpha.sam.gov, please log in and click on the profile and go to Account Details. AAC is listed under 'Organization Information' section.
@@ -89,9 +88,9 @@ messages | string [] - array of strings
 ### Set-Aside Values
 Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. Use the Set-Aside codes to submit notices.
 
-Refer below table for mapping between legacy SetAside Values to modern SetAside Value:
+Refer below table for mapping between legacy Set-Aside Values to modern Set-Aside Value:
 
-Code | Modern SetAside Values | Legacy SetAside values
+Code | Modern Set-Aside Values | Legacy Set-Aside values
 -----|------- | -------
 SBA     | Total Small Business Set-Aside (FAR 19.5)	| Total Small Business
 SBP     | Partial Small Business Set-Aside (FAR 19.5) |	Partial Small Business
@@ -115,15 +114,33 @@ VSS | Veteran-Owned Small Business Sole source (specific to Department of Vetera
 ### Notice Types
 The web service API includes specific methods to submit each of the base notice types (i.e. presolicitation, combined/synopsis, award, etc.). You will find these outlined in the sections below.
 
-PRESOL - Presolicitation

-COMBINE - Combined Synopsis/Solicitation

-SRCSGT - for Sources Sought

-SSALE - Sale of Surplus Property

-SNOTE - Special Notice

-JA – Justification

-ITB – Intent to Bundle 

-SOL - Solicitation

-AWARD - Award

+The Notice Types valid options are:
+
+* PRESOL – for Presolicitation Notices
+* COMBINE – for Combined/Synopsis Notices
+* AWARD – for Award Notices
+* JA – for Justification & Approval (J&A) Notices
+* SRCSGT – for Sources Sought Notices
+* SSALE – for Sale of Surplus Property Notices
+* SNOTE – for Special Notices
+* ITB – for Intent to Bundle Requirements (DoD-Funded) Notices
+* SOL - for Solicitation Notices
+
+#### Related Notices
+
+This is a conversion table for notices using submitNotice method.
+
+||SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE
+-----|-----|-----|-----|-----|-----|-----|-----|-----|-----|
+|**SRCSGT**||O|O|O|O|O|||O
+|**PRESOL**|O||O|O||O|O|O|O
+|**COMBINE**|O|O|||O||O|O|O
+|**SOL**|O|O|||O||O|O|O
+|**AWARD**|||O|O|||O|O|O
+|**SSALE**|O|O|||||O|O|O
+|**ITB**||O|O|O|O|O||O|O
+|**JA**||O|O|O|O|O|O||O
+|**SNOTE**|O|O|O|O|O|O|O|O|
 
 ### Stauth Valid Values
 Below table captures stauth values to use while making requests as needed.
@@ -143,22 +160,7 @@ far4 | FAR 6.302-4 - International agreement
 far5 | FAR 6.302-5 - Authorized or required by statute
 far6 | FAR 6.302-6  - National security
 far7 | FAR 6.302-7 - Public interest
-
-### Related Notices
-
-This is a conversion table for notices using SOAP services
-
-||SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE
------|-----|-----|-----|-----|-----|-----|-----|-----|-----|
-|**SRCSGT**||O|O|O|O|O|||O
-|**PRESOL**|O||O|O||O|O|O|O
-|**COMBINE**|O|O|||O||O|O|O
-|**SOL**|O|O|||O||O|O|O
-|**AWARD**|||O|O|||O|O|O
-|**SSALE**|O|O|||||O|O|O
-|**ITB**||O|O|O|O|O||O|O
-|**JA**||O|O|O|O|O|O||O
-|**SNOTE**|O|O|O|O|O|O|O|O|
+far13 | FAR 13.5 - Simplified Procedures for One Source
 
 ## Contracting Officer
 Method Details
 
@@ -183,15 +185,14 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	Yes |	Posting Date |	YYYYMMDD
 zip |	string |	No |	Zip Code |	5 digits
-classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
-naics |	string |	No |	NAICS Code |	Valid NAICS Code NAICS Reference
-offadd |	string |	No |	Office Address |	65535 characters
-officeid |	string |	Yes |	Office id of the office where an opportunity is being submitted |	20 characters
+classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g)) 
+naics |	string |	No |	NAICS Code |	Valid NAICS Code 
NAICS Reference
+offadd |	string |	No |	Office Address (Not used) |	65535 characters 
+officeid |	string |	Yes |	Office ID of the office where an opportunity is being submitted |	20 characters
 subject |	string |	Yes |	Subject |	255 characters
-solnbr |	string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	| string |	No |	Base Notice Type |		[Refer Related Notices](#related-notices)
-awdnbr |	string |	 Yes |	Award Number |	255 characters
-awdnbr |	open text, label: Agency assigned number for control tracking and identification.
 Please use ONLY alphanumeric and - _ ( ) { } characters [no spaces]. |	 Yes |	Award Number |	255 characters
+solnbr |	string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+ntype	| string |	No |	[Refer Notice Types](#notice-types) |		
+awdnbr |String |	 Yes |	Award Number |	255 characters 
 Agency assigned number for control tracking and identification.
 Alphanumeric and - _ ( ) { } characters [no spaces]
 awdamt |	string |	Yes |	Award Amount |	64 characters
 linenbr |	string |	No |	Line Number |	255 characters
 awddate |	date |	Yes |	Award Date |	YYYYMMDD
@@ -200,41 +201,41 @@ awardee |	string |	Yes |	Awardee |	65535 characters
 awardee_duns |	string |	No |	Awardee DUNS |	9 digits with optional plus 4
 contact |	string |	No |	Contact Info |	65535 characters
 desc |	string |	No |	Description |	65535 characters
-link |	GovURL |	No |	Government Link	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|
+link |	GovURL |	No |	Government Link	|255 characters| Consist of a restricted set of characters (see URL specification - RFC 2396)|
 email |	GovEmail |	No |	Government Email |	128 characters
 links |	DocumentLink[] |	No |	Array Of links |
 files |	DocumentFile[] |	No |	Array of files |
-setaside |	string |	No |	Set-Aside code |	See Set Aside Value Section for valid codes
+setaside |	string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
 recovery_act |	boolean |	No |	Recovery Act |	True or False
-correction |	boolean |	No |	Correction of previous Award |	True or False 
 If correcting a previously submitted award notice, specify true and the system will lookup the award by award number and sol number if applicable.
+correction |	boolean |	No |	Correction of previous Award |	True or False 
 If correcting a previously submitted Award notice, specify True and the system will lookup the award by award number and sol number if applicable.
 
 GovURL Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	Yes |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	Yes |	Description |	255 characters
+url |	string |	No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string |	No |	Description |	255 characters
 
 GovEmail Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address | string |	Yes |	Email Address |	128 characters
-desc |	string |	Yes |	Description |	255 characters
+address | string |	No |	Email Address |	128 characters
+desc |	string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	Yes |	External URL |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-Desc |	string |	Yes |	Description/Title |	255 characters
+url |	string |	No |	External URL |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+Desc |	string |	No |	Description/Title |	255 characters
 
 DocumentFile Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	Yes |	File Name |	255 characters
-filedata |	base64binary |	Yes |	File Data |	100 MB
+filename |	string |	No |	File Name |	255 characters
+filedata |	base64binary |	No |	File Data |	100 MB
 desc |	string |	No |	Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -259,10 +260,10 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-solnbr |	string |	Yes, if Non-Award |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	No |	[Refer Related Notices](#related-notices)
-awdnbr |  string | Yes; Solicitation Number or Award Number is required| Award # |	255 characters
-deletetype |	string |	no |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
+solnbr |	string |	Yes; Solicitation # or Award # is required |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
+ntype |	string |	No |	[Refer Notice Types](#notice-types) 
+awdnbr |  string | Yes; Solicitation # or Award # is required| Award # |	255 characters
+deletetype |	string |	No |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
 
 ### Archive Notice 
(ArchiveNotice)
@@ -286,12 +287,12 @@ ArchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date | YYYYMMDD
-solnbr | string |	No |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string | No |	[Refer Related Notices](#related-notices)
-archdate | date |	Yes | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
-officeid | string |	No |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
+solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
+ntype |	string | No |	[Refer Notice Types](#notice-types)
+archdate | date |	No | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
+officeid | string |	No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 
-### Cancel Notice
 (CancelNotice) NEEDS FIX
+### Cancel Notice
 (CancelNotice) 
 
 This method is used to post a cancellation notice to any base notice type already in the Opportunities system. Provide a Solicitation Number or an Award Number (for stand- alone awards) and other data outlined below for the cancellation notice.
 
@@ -313,13 +314,13 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
 offadd | string |	No | Office Address |	65535 characters
-officeid | String | No |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
+officeid | String | No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	string | No |	Subject |	255 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype | string | No |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice,  “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype | string | No |	[Refer Notice Types](#notice-types) | 
 awdnbr | string |	No | Award # |255 characters
 archdate | date |	No | Archive Date | YYYYMMDD
-contact | string | No | Contact Info | 65535 characters
+contact | string | Yes | Contact Info | 65535 characters
 desc | string | Yes |	Cancellation Description | 65535 characters
 
 ## Contracting Officer/Contracting 
Specialist Method Details
@@ -347,24 +348,24 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date | date |	No | Posting Date |	YYYYMMDD
 zip |	string | No |	Zip Code | 5 digits
 classcod | string |	No |	Class-Code | Valid classification code (FAR, Section 5.207(g))
-naics |	string | No |	NAICS Code | Valid NAICS Code  NAICS Reference
-officeid | string |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters
-offadd | string |	No | Office Address |	65535 characters
+naics |	string | No |	NAICS Code | Valid NAICS Code  
NAICS Reference
+officeid | string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
+offadd | string |	No | Office Address (Not Used) |	65535 characters
 subject |	string | Yes|	Title of the Pre-solicitation |	255 characters
-solnbr | string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-respdate | date |	No - However either Respdate or Archdate must be selected |	Response Date |	YYYYMMDD
-**archdate** (update needed) | date |	No - However either Respdate or Archdate must be selected |	Archive Date | YYYYMMDD
+solnbr | string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+respdate | date |	Yes - either respdate or archdate is required |	Response Date |	YYYYMMDD
+archdate | date |	Yes - either respdate or archdate is required |	Archive Date | YYYYMMDD
 contact |	string | Yes |	Contact Info | 65535 characters
 desc |string |Yes |	Description | 65535 characters
 link | GovURL – complex type | No |	Government Link has URL & description |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 email |	GovEmail – complex type |	Yes | Government Email | 128 characters
 links | DocumentLink[] | No |	Array of links |
 files |	DocumentFile[] | No |	Array of files |
-setaside | string |	No | Set-Aside code | See Set Aside Values Section for valid codes
-popaddress | string |	No | Pop Add | 65535 characters
-popzip |string | No |	Pop Zip | 5 digits
-popcountry | string |	No | Pop Country | 32 characters
-recovery_act	| boolean |	no | Recovery Act | True or False
+setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
+popaddress | string |	No | Place of Performace Address | 65535 characters
+popzip |string | No |	Place of Performace Zip | 5 digits
+popcountry | string |	No | Place of Performace Country | 32 characters
+recovery_act	| boolean |	No | Recovery Act | True or False
 
 GovURL Complex Type Definition: This field is not implemented
 
@@ -377,22 +378,22 @@ GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address	| string | No |Email Address |128 characters
+address	| string | Yes |Email Address |128 characters
 desc | string	| No | Description | 255 characters
 
 DocumentLink Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url | string | Yes |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	Yes | Description/Title | 255 characters
+url | string | No |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc | string |	No | Description/Title | 255 characters
 
 DocumentFile Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename | string |	Yes | File Name | 255 characters
-filedata | base64binary |	Yes | File Data | 100 MB
+filename | string |	No | File Name | 255 characters
+filedata | base64binary |	No | File Data | 100 MB
 desc | string |	No | Description | 255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -418,31 +419,31 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date | date |	No | Posting Date |	YYYYMMDD
 zip |	string | No |	Zip Code | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
-naics | string | Yes | NAICS Code	| Valid NAICS Code NAICS Reference
-officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters
+naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
+officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
 offadd | string | No | Office Address	| 65535 characters
 subject | string | Yes | Subject | 255 characters
-solnbr | string |	Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+solnbr | string |	Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes | Response Date | YYYYMMDD
-**archdate** (update needed) | date |	No | Archive Date | YYYYMMDD
+archdate | date |	No | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 65535 characters
 desc | string |	Yes |	Description |	65535 characters
 link | GovURL – complex type | No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 email |	GovEmail – complex type |	Yes | Government Email | 128 characters
 links |	DocumentLink[] | No |	Array Of links |
 files |	DocumentFile[] | No |	Array of files |
-setaside | string |	No | Set-Aside code | See Set Aside Values section for valid codes
-popaddress | string |	No | Pop Add | 65535 characters
-popzip | string |	No | Pop Zip | 5 digits
-popcountry | string |	No | Pop Country | 32 characters
+setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
+popaddress | string |	No | Place of Performace Address | 65535 characters
+popzip | string |	No | Place of Performace Zip | 5 digits
+popcountry | string |	No | Place of Performace Country | 32 characters
 recovery_act | boolean | No |	Recovery Act | True or False
 
 GovURL Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | Yes | Website Address | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	Yes |	Description |	255 characters
+url	| string | No | Website Address | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc | string |	No |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -455,15 +456,15 @@ DocumentLink Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | Yes |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	Yes | Description/Title | 255 characters
+url	| string | No |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc | string |	No | Description/Title | 255 characters
 
 DocumentFile Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename | string | Yes | File Name | 255 characters
-filedata | base64binary |	Yes | File Data | 100 MB
+filename | string | No | File Name | 255 characters
+filedata | base64binary |	No | File Data | 100 MB
 desc | string |	No | Description | 255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -486,56 +487,56 @@ Mod Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	Yes - Only Award 
 No - Rest |	Posting Date |	YYYYMMDD
+date | date |	Yes - for AWARD  |	Posting Date |	YYYYMMDD
 zip |	string |	No |	Zip Code |	5 digits
-classcod |	string	 | Yes – Solicitation/Combined/Sale of Surplus/ITB/Justification 
No – Rest |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
-naics | 	string |	Yes – Combined & Solicitation 
 No – Rest | 	NAICS Code |	Valid NAICS Code  NAICS Reference
-officeid |	string	| Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
-offadd |	string	| No	| Office Address |	65535 characters
+classcod |	string	 | Yes - for SOL, COMBINE, SSALE, ITB, JA   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
+naics | 	string |	Yes - for COMBINE, SOL  | 	NAICS Code |	Valid NAICS Code  
NAICS Reference
+officeid |	string	| Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
+offadd |	string	| No	| Office Address (Not Used)|	65535 characters
 subject	| string	| Yes |	Subject |	255 characters
-solnbr | string |	Yes | 	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype |	string |	Yes |	Base Notice Type |	[Refer Related Notices](#related-notices)
-respdate |	date |	Yes – for Combined/Solicitation 
 No – Rest (Special Notice/Sale of Surplus/Sources Sought/Presol must have either respdate or archdate)|	Response Date |	YYYYMMDD
-**archdate** (update needed) |	date |	No	| Archive Date |	YYYYMMDD
-contact |	string |	Yes – Rest 
 No – For Award/Special notice|	Contact Info |	65535 characters
-desc |	string |	Yes - Award/Justification 
 No - Rest	| Description |	65535 characters
+solnbr | string |	Yes, EXCEPT No - Only for SNOTE | 	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+ntype |	string |	Yes |	 Notice Type |	Valid values: PRESOL, COMBINE, SRCSGT, SSALE, SNOTE, SOL
+respdate |	date |	Yes – for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL |	Response Date |	YYYYMMDD
+archdate |	date |	Yes	| Archive Date |	YYYYMMDD
+contact |	string |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL |	Contact Info |	65535 characters
+desc |	string |	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE	| Description |	65535 characters
 link	| GovURL – complex type |	No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email |	GovEmail – complex type |	Yes - Rest 
 No - Only Award |	Government Email |	128 characters
+email |	GovEmail – complex type |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL, SNOTE |	Government Email |	128 characters
 links |	DocumentLink[] |	No |	Array Of links |
 files |	DocumentFile[] |	No |	Array of files |
-setaside |	string |	No |	Set-Aside code |	See Set Aside Value Section for valid codes
-popaddress |	string |	No	 | Pop Add |	65535 characters
-popzip	| string |	No	 | Pop Zip |	5 digits
-popcountry |	string |	No	 | Pop Country |	32 characters
+setaside |	string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
+popaddress |	string |	No	 | Place of Performace Address |	65535 characters
+popzip	| string |	No	 | Place of Performace Zip |	5 digits
+popcountry |	string |	No	 | Place of Performace Country |	32 characters
 recovery_act |	boolean |	No |	Recovery Act |	True or False
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string	| Yes |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	Yes |	Description |	255 characters
+url	| string	| No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string |	No |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	| string |	Yes |	Email Address	| 128 characters
-desc |	string |	Yes |	Description |	255 characters
+desc |	string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url | 	string	| Yes |	External URL |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	Yes |	Description/Title |	255 characters
+url | 	string	| No |	External URL |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string |	No |	Description/Title |	255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string	| Yes | 	File Name |	255 characters
-filedata |	base64binary |	Yes |	File Data	| 100 MB
+filename |	string	| No | 	File Name |	255 characters
+filedata |	base64binary |	No |	File Data	| 100 MB
 desc |	string |	No |	Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -561,19 +562,19 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date | Date	| No |	Posting Date |	YYYYMMDD
 zip |	String |	No	| Zip Code |	5 digits
 classcod	| String |	Yes |	Class-Code |	Valid classification code
-naics	| String |	No	| NAICS Code	| Valid NAICS Code  NAICS Reference
+naics	| String |	No	| NAICS Code	| Valid NAICS Code  
NAICS Reference
 offadd |	String	| No |	Office Address	| 65535 characters
-officeid |	String |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
+officeid |	String |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	String |	Yes |	Subject |	255 characters
-solnbr	| String |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. 

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required
-ntype	| string |	No	| Base Notice Type | 	[Refer Related Notices](#related-notices)
-stauth	| String	| Yes |	Stat. Authority – Both foja & stauth values will be given under stauth in legacy |	Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7 
 Description of each of these stauth values is captured in section 4.4

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’
+solnbr	| String |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+ntype	| string |	No	| Notice Type   | 	Valid Value: JA
+stauth	| String	| Yes |	J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy |	[Refer Stauth Valid Values](#stauth-valid-values)
 awdnbr |	String |	Yes |	Award Number |	255 characters
 modnbr |	String |	No |	Mod Number |	32 characters
 awdamt |	String |	No |	Award Amount |	64 characters
 awddate |	Date |	No	| Award Date |	YYYYMMDD
 donbr	| String |	Yes |	Task/Delivery Order Number |	255 characters from the set: a-z A-Z 0-9 - _ ( )
-**archdate** (update needed)  |	Date |	No |	Archive Date |	YYYYMMDD
+archdate  |	Date |	Yes |	Archive Date |	YYYYMMDD
 contact |	String |	Yes | 	Contact Info |	65535 characters
 desc |	String |	No |	Description	| 65535 characters
 link |	GovURL |	No	| Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -581,35 +582,35 @@ links |	DocumentLink[]	| No |	Array Of links	|
 files |	DocumentFile[]	| No |	Array of files	|
 email |	GovEmail |	Yes | 	Government Email |	128 characters
 recovery_act |	boolean |	No |	Recovery Act |	True or False;
-correction	| boolean |	No |	Correction of previous J&A |	True or False 
 If correcting a previously submitted j&a notice, specify true and the system will lookup the j&a by award number and sol number if applicable.
+correction	| boolean |	No |	Correction of previous J&A |	True or False 
 If correcting a previously submitted J&A notice, specify True and the system will lookup the j&a by award number and sol number if applicable.
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	Yes |	Website Address	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	| string	| Yes |	Description |	255 characters
+url |	string |	No |	Website Address	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	| string	| No |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address |	string	| Yes |	Email Address	| 128 characters
-desc |	string |	Yes |	Description |	255 characters
+desc |	string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string	| Yes |	External URL	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	Yes |	Description/Title |	255 characters
+url |	string	| No |	External URL	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string |	No |	Description/Title |	255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string	| Yes |	File Name	| 255 characters
-filedata |	base64binary |	Yes |	File Data	| 100 MB
+filename |	string	| No |	File Name	| 255 characters
+filedata |	base64binary |	No |	File Data	| 100 MB
 desc	| string |	No |	Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -635,59 +636,59 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date |	date |	No |	Posting Date |	YYYYMMDD
 zip	 | string |	No |	Zip Code |	5 digits
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
-naics	| string |	No |	NAICS Code |	Valid NAICS Code
-officeid |	string |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	| 20 characters
+naics	| string |	No |	NAICS Code |	Valid NAICS Code
NAICS Reference
+officeid |	string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	| 20 characters
 offadd	| string	 | No |	Office Address |	65535 characters
 subject |	string |	Yes |	Subject |	255 characters
-solnbr	| string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-respdate |	date |	No |	Response Date |	YYYYMMDD
-**archdate** (update needed) |	date |	No |	Archive Date	| YYYYMMDD
-contact	| string	| Yes |	Contact Info	| 65535 characters
 Default value: Primary 
Other types: Secondary, Owner
+solnbr	| string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+respdate |	date |	Yes - either respdate or archdate is required |	Response Date |	YYYYMMDD
+archdate |	date |	Yes - either respdate or archdate is required |	Archive Date	| YYYYMMDD
+contact	| string	| Yes |	Contact Info	| 65535 characters
 desc | string |	Yes |	Description |	65535 characters
 link |	GovURL – complex type |	No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 email	| GovEmail – complex type |	Yes |	Government Email	| 128 characters
 links |	DocumentLink[] |	No |	Array Of links	|
 files |	DocumentFile[] |	No |	Array of files |
-setaside	| string |	No |	Set-Aside code |	See Set Aside Value Section for valid codes
-popaddress |	string |	No |	Pop Add |	65535 characters
-popzip |	string	| No |	Pop Zip	| 5 digits
-popcountry |	string |	No |	Pop Country |	32 characters
+setaside	| string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
+popaddress |	string |	No |	Place of Performace Address |	65535 characters
+popzip |	string	| No |	Place of Performace Zip	| 5 digits
+popcountry |	string |	No |	Place of Performace Country |	32 characters
 recovery_act |	boolean |	No	 | Recovery Act |	True or False
 
 GovURL Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	 | string	| Yes |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	Yes |	Description |	255 characters
+url	 | string	| No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string |	No |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	| string |	Yes |	Email Address |	128 characters
-desc	| string |	Yes |	Description |	255 characters
+desc	| string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string	| Yes |	External URL	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string	| Yes	| Description/Title |	255 characters
+url	| string	| No |	External URL	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc |	string	| No	| Description/Title |	255 characters
 
 DocumentFile Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	Yes |	File Name |	255 characters
-filedata |	base64binary |	Yes	| File Data |	100 MB
+filename |	string |	No |	File Name |	255 characters
+filedata |	base64binary |	No	| File Data |	100 MB
 desc	| string |	No	 | Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
 
 ### Foreign Government Standard 
 (submitForeignGovernment)
 
-This service is now deprecated. Hence no longer available.
+This service is deprecated. 
 
 ### Special Notice 
 (submitSpecialNotice)
 
@@ -710,12 +711,12 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date	| Date |	No	| Posting Date |	YYYYMMDD
 zip |	String |	No	 | Zip Code |	5 digits
 classcod |	String	| No	| Class-Code | 	Valid classification code (FAR, Section 5.207(g))
-naics |	String |	No	| NAICS Code |	Valid NAICS Code  NAICS Reference
-officeid	| string |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	 | 20 characters
+naics |	String |	No	| NAICS Code |	Valid NAICS Code  
NAICS Reference
+officeid	| string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	 | 20 characters
 offadd |	String |	No |	Office Address	| 65535 characters
 subject | 	String |	Yes |	Subject |	255 characters
-solnbr	| String |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-**archdate** (update needed) |	Date |	No |	Archive Date |	YYYYMMDD
+solnbr	| String |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
+archdate |	Date |	Yes |	Archive Date |	YYYYMMDD
 contact |	String |	No	| Contact Info |	65535 characters
 desc |	String |	Yes |	Description |	65535 characters
 link	| GovURL – complex type	| No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -728,29 +729,29 @@ GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|Yes|	Website Address|	255 characters, consist of a restricted set of characters (see URL specification - RFC2396)
-desc|	string	|Yes|	Description|	255 characters
+url	|string	|No|	Website Address|	255 characters, consist of a restricted set of characters (see URL specification - RFC2396)
+desc|	string	|No|	Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	|string|	Yes|	Email Address	|128 characters
-desc	|string	|Yes	|Description	|255 characters
+desc	|string	|No	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string|	Yes	|External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string	|Yes	|Description/Title	|255 characters
+url	|string|	No	|External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	|string	|No	|Description/Title	|255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	Yes |	File Name |	255 characters
-filedata |	base64binary |	Yes	| File Data |	100 MB
+filename |	string |	No |	File Name |	255 characters
+filedata |	base64binary |	No	| File Data |	100 MB
 desc	| string |	No	 | Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -776,12 +777,12 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date |	date|	No|	Posting Date|	YYYYMMDD
 zip|	string|	No|	Zip Code|	5 digits
 classcod|	string|	Yes	|Class-Code|	Valid classification code (FAR, Section 5.207(g))
-naics|	string|	No|	NAICS Code|	Valid NAICS Code  NAICS Reference
-officeid	|string	|Yes|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
+naics|	string|	No|	NAICS Code|	Valid NAICS Code  
NAICS Reference
+officeid	|string	|Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 offadd|	string|	No	|Office Address	|65535 characters
 subject|	string|	Yes|	Subject	|255 characters
-solnbr|	string	|Yes	|Sol #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-**archdate** (update needed)|	date|	No|	Archive Date|	YYYYMMDD
+solnbr|	string	|Yes	|Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
+archdate|	date|	Yes|	Archive Date|	YYYYMMDD
 contact|	string|	Yes|	Contact Info|	65535 characters
 desc|	string	|Yes|	Description	|65535 characters
 link	|GovURL – complex type|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -794,29 +795,29 @@ GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|Yes	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string	|Yes	|Description	|255 characters
+url	|string	|No	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	|string	|No	|Description	|255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address|	string|	Yes|	Email Address	|128 characters
-desc	|string	|Yes	|Description	|255 characters
+desc	|string	|No	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url|	string|	Yes|	External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string|	Yes|	Description/Title	|255 characters
+url|	string|	No|	External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	|string|	No|	Description/Title	|255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	Yes |	File Name |	255 characters
-filedata |	base64binary |	Yes	| File Data |	100 MB
+filename |	string |	No |	File Name |	255 characters
+filedata |	base64binary |	No	| File Data |	100 MB
 desc	| string |	No	 | Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -842,52 +843,52 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date | date |	No | Posting Date |	YYYYMMDD
 zip |	string | No |	Zip Code | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
-naics | string | Yes | NAICS Code	| Valid NAICS Code NAICS Reference
-officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters
+naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
+officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
 offadd | string | No | Office Address	| 65535 characters
 subject | string | Yes | Subject | 255 characters
-solnbr | string |	Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-respdate | date |	Yes | Response Date | YYYYMMDD
-**archdate** (update needed) | date |	No | Archive Date | YYYYMMDD
+solnbr | string |	Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+respdate | date |	Yes  | Response Date | YYYYMMDD
+archdate | date |	No  | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 65535 characters
 desc | string |	Yes |	Description |	65535 characters
 link | GovURL – complex type | No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 email |	GovEmail – complex type |	Yes | Government Email | 128 characters
 links |	DocumentLink[] | No |	Array Of links |
 files |	DocumentFile[] | No |	Array of files |
-setaside | string |	No | Set-Aside code | See Set Aside Values section for valid codes
-popaddress | string |	No | Pop Add | 65535 characters
-popzip | string |	No | Pop Zip | 5 digits
-popcountry | string |	No | Pop Country | 32 characters
+setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
+popaddress | string |	No | Place of Performace Address | 65535 characters
+popzip | string |	No | Place of Performace Zip | 5 digits
+popcountry | string |	No | Place of Performace Country | 32 characters
 recovery_act | boolean | No |	Recovery Act | True or False
 
 GovURL Complex Type Definition: This field is not implemented
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | Yes | Website Address | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	Yes |	Description |	255 characters
+url	| string | No | Website Address | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc | string |	No |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	| string | Yes | Email Address | 128 characters
-desc | string |	Yes |	Description |	255 characters
+desc | string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | Yes |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	Yes | Description/Title | 255 characters
+url	| string | No |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc | string |	No | Description/Title | 255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename | string | Yes | File Name | 255 characters
-filedata | base64binary |	Yes | File Data | 100 MB
+filename | string | No | File Name | 255 characters
+filedata | base64binary |	No | File Data | 100 MB
 desc | string |	No | Description | 255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -913,15 +914,15 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date	|Date	|No	|Posting Date	|YYYYMMDD
 zip	|String|	No|	Zip Code|	5 digits
 classcod|	String|	Yes|	Class-Code|	Valid classification code (FAR, Section 5.207(g))
-naics|	String|	No|	NAICS Code|	Valid NAICS Code
-officeid|	String|	Yes|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account|	20 characters
+naics|	String|	No|	NAICS Code|	Valid NAICS Code 
NAICS Reference
+officeid|	String|	Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account|	20 characters
 offadd|	String	|No|	Office Address|	65535 characters
 subject|	String|	Yes|	Subject	|255 characters
-solnbr	|String	|Yes|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	|string	|No|	[Refer Related Notices](#related-notices)
+solnbr	|String	|Yes|	Solicitation #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+ntype	|string	|No|	[Refer Notice Types](#notice-types)
 awdnbr|	String	|Yes	|Award Number|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 donbr|	String|	No	|Task/Delivery Order Number	|255 characters from the set: a-z A-Z 0-9 - _ ( )
-**archdate** (update needed) 	|Date	|No	|Archive Date|	YYYYMMDD
+archdate 	|Date	|Yes	|Archive Date|	YYYYMMDD
 contact|	String|	Yes|	Contact Info	|65535 characters; Default value = Primary, Other types are: Secondary, Owner
 desc	|String	|Yes	|Description|	65535 characters
 link|	GovURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -929,33 +930,33 @@ links	|DocumentLink[]|	No|	Array Of links	|
 files|	DocumentFile[]	|No	|Array of files	|
 email	|GovEmail|	Yes|	Government Email|	128 characters
 recovery_act|	boolean	|No	|Recovery Act	|True or False
-correction	|boolean	|No	|Correction of previous ITB|	True or False 

If correcting a previously submitted itb notice, specify true and the system will lookup the itb by award number, delivery number and sol number if applicable.
+correction	|boolean	|No	|Correction of previous ITB|	True or False 

If correcting a previously submitted ITB notice, specify True and the system will lookup the itb by award number, delivery number and sol number if applicable.
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|Yes	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string|	Yes|	Description|	255 characters
+url	|string	|No	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc	|string|	No|	Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	|string	|Yes|	Email Address	|128 characters
-desc|	string|	Yes	|Description|	255 characters
+desc|	string|	No	|Description|	255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url|	string|	Yes	|External URL|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	Yes|	Description/Title	|255 characters
+url|	string|	No	|External URL|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc|	string|	No|	Description/Title	|255 characters
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	Yes |	File Name |	255 characters
-filedata |	base64binary |	Yes	| File Data |	100 MB
+filename |	string |	No |	File Name |	255 characters
+filedata |	base64binary |	No	| File Data |	100 MB
 desc	| string |	No	 | Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -966,17 +967,7 @@ This service is now deprecated. Instead, please use submitJA to perform the oper
 
 ### General Notice 
 (submitNotice)
 
-This is a general method that supports submitting all of the above notice types. The complex type for the input data consists of all possible data elements across all notice types. Users may setup their web service client to use this general method instead of calling the specific methods outlined above.  The functionality is the same regardless of whether you use this general method, or the specific methods above. The valid options for this field are:
-
-* PRESOL – for Presolicitation Notices
-* COMBINE – for Combined/Synopsis Notices
-* AWARD – for Award Notices
-* JA – for Justification & Approval (J&A) Notices
-* SRCSGT – for Sources Sought Notices
-* SSALE – for Sale of Surplus Property Notices
-* SNOTE – for Special Notices
-* ITB – for Intent to Bundle Requirements (DoD-Funded) Notices
-* SOL - for Solicitation Notices
+This is a general method that supports submitting all of the above notice types. The complex type for the input data consists of all possible data elements across all notice types. Users may setup their web service client to use this general method instead of calling the specific methods outlined above.  **The functionality is the same regardless of whether you use this general method, or the specific methods above. **
 
 Input Parameter |	Type |	Description
 ------- | ------ | -------
@@ -992,66 +983,66 @@ Complete notice Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date|	date|	Yes - Only Award
No - Rest	|Posting Date|	YYYYMMDD
-notice_type	|string	|Yes|	Notice type	|Valid options outlined above
+date|	date|	No	|Posting Date|	YYYYMMDD
+notice_type	|string	|Yes|	[Refer Notice Types](#notice-types)	|
 zip	|string	|No	|Zip Code|	5 digits
-classcod|	string|	No|	Class-Code	|Valid classification code (FAR, Section 5.207(g))
-naics	|string	|Yes - Combined Synopsis/Solicitation & Solicitation  
 No - Rest	|NAICS Code|	Valid NAICS Code  NAICS Reference
-officeid|	String|	Yes|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	|20 characters
-offadd	|string|	No|	Office Address	|65535 characters
-subject|	string|	Yes – For presol, combined, itb, ja, award, special, surplus

 No – for rest|	Subject|	255 characters
-solnbr|	string|	Yes - Rest  
 No - Only Special Notice|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|string	|no	|[Refer Related Notices](#related-notices)
-awdnbr|	string|	Yes – Award, ITB & JA 
 No – Rest|	Award #	|255 characters
-donbr	|string	|Yes – JA 
 No – Rest|	Delivery/Task Order Number	|255 characters
-awdamt	|string|	Yes – Award 
 No – Rest	|Award Amount|	64 characters
+classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA  |	Class-Code	|Valid classification code (FAR, Section 5.207(g))
+naics	|string	|Yes - for COMBINE, SOL	|NAICS Code|	Valid NAICS Code  
NAICS Reference
+officeid|	String|	Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	|20 characters
+offadd	|string|	No|	Office Address (Not Used)	|65535 characters
+subject|	string|	Yes|	Subject|	255 characters
+solnbr|	string|	Yes, EXCEPT No - Only for SNOTE|	Solicitation #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+ntype	|string	|No	|[Refer Notice Types](#notice-types)
+awdnbr|	string|	Yes - for AWARD, ITB & JA |	Award #	|255 characters
+donbr	|string	|Yes - for JA|	Delivery/Task Order Number	|255 characters
+awdamt	|string|	Yes - for AWARD 	|Award Amount|	64 characters
 linenbr|	string	|No|	Award Line Item Number	|255 characters
-awddate	|date|	Yes – Award 
 No – Rest|	Award Date	|YYYYMMDD
-stauth	|string	|Yes –  JA 
 No – Rest	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

 Description of each of these stauth values is captured in Stauth Value section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’
-respdate|	date|	Yes – Only Combined/Solicitation
 No – Rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)	|Response Date	|YYYYMMDD
-**archdate** (update needed) |	date|	No|	Archive Date|	YYYYMMDD
-awardee|	string|	Yes – Only Award 
 No – Rest|	Awardee	|65535 characters
+awddate	|date|	Yes - for AWARD|	Award Date	|YYYYMMDD
+stauth	|string	|Yes - for JA 	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| [Refer Stauth Valid Values](#stauth-valid-values)
+respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL	|Response Date	|YYYYMMDD
+archdate  |	date|	Yes|	Archive Date|	YYYYMMDD
+awardee|	string|	Yes – for AWARD |	Awardee	|65535 characters
 awardee_duns|	string	|No	|Awardee DUNS	|9 digits with optional plus 4
-contact|	string|	Yes - Rest 
 No - Award & Special Notice|	Contact Info|	65535 characters
-desc	|string|	Yes - Rest  
 No – Justfication & Award|	Main Description|	65535 characters
+contact|	string|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL|	Contact Info|	65535 characters
+desc	|string|	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE|	Main Description|	65535 characters
 link|	GovernmentURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email|	GovernmentEmail|	Yes - Rest 
No - Only Award|	Government Email	|128 characters
+email|	GovernmentEmail|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL, SNOTE|	Government Email	|128 characters
 links	|DocumentLink []|	No	|Array Of links	|
 files	|DocumentFile[]|	No|	Array of files	|
-setaside|	string|	No|	Set-Aside code |	See Set Aside Section for valid codes
-popaddress|	string|	No|	POP Address	|65535 characters
-popzip|	string	|No	|POP Zip	|5 digits
-popcountry|	string|	Yes – For wards; No – For rest|	POP Country|	32 characters
+setaside|	string|	No|	[Refer Set-Aside Values](#set-aside-values) |	
+popaddress|	string|	No|	Place of Performace Addressress	|65535 characters
+popzip|	string	|No	|Place of Performace Zip	|5 digits
+popcountry|	string|	Yes – For wards; No – For rest|	Place of Performace Country|	32 characters
 city|	string|	No	|City	|NA
 state|	string|	No|	State	|NA
 recovery_act	|boolean|	No|	Recovery Act|	True or False
-correction|	boolean|	No|	Correction of previous notice for the following types:  Award #, Delivery Order #) – Awards, J&A’s, Intent to Bundle Requirements (DoD-Funded), Limited Source Justification 

 This is used to modify/correct notice types that whose uniqueness is potentially determined by fields other than Solicitation # (i.e. Award #, Delivery Order #)	|True or False

 If correcting a previously submitted award notice, specify true and the system will lookup the notice by award number, delivery order number, and sol number if applicable.
+correction|	boolean|	No|	Correction of previous notice for the following types:  Award #, Delivery Order #) – Awards, J&A’s, Intent to Bundle Requirements (DoD-Funded), Limited Source Justification 

 This is used to modify/correct notice types where uniqueness is potentially determined by fields other than Solicitation # (i.e. Award #, Delivery Order #)	|True or False

 If correcting a previously submitted notice, specify True and the system will lookup the notice by award number, delivery order number, and sol number if applicable.
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url|	string|	Yes|	Website Address|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	Yes	|Description|	255 characters
+url|	string|	No|	Website Address|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc|	string|	No	|Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address|	string|	Yes	|Email Address|	128 characters
-desc	|string|	Yes	|Description	|255 characters
+desc	|string|	No	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string|	Yes	|External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	Yes|	Description/Title|	255 characters
+url	|string|	No	|External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+desc|	string|	No|	Description/Title|	255 characters
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	Yes |	File Name |	255 characters
-filedata |	base64binary |	Yes	| File Data |	100 MB
+filename |	string |	No |	File Name |	255 characters
+filedata |	base64binary |	No	| File Data |	100 MB
 desc	| string |	No	 | Description |	255 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -1076,12 +1067,12 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 Date|	Date|	No	|Posting Date	|YYYYMMDD
 solnbr	|String	|No|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|String	|No|	[Refer Related Notices](#related-notices)
+ntype	|String	|No|	[Refer Notice Types](#notice-types)
 uploadtype|	String|	No |	Upload Type|	A for amendment, S for solicitation or any title for other; 255 characters
 respdate	|Date	|No |Response Date|	YYYYMMDD
 links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
 files	|DocumentFile []|	Yes; Either Links or Files needs to be provided|	Array of files	|
-officeid	|String|	No|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account|	20 characters
+officeid	|String|	No|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account|	20 characters
 
 DocumentLink Complex Type Definition:
 
@@ -1119,49 +1110,49 @@ UnarchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	|[Refer Related Notices](#related-notices)
+ntype	|string	|No	|[Refer Notice Types](#notice-types)
 awdnbr	|string|	No|	Award #|	255 characters
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
 
 ### Secure Document Package 
 (attachSecureDocumentPackagesToNotice)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Non-FBO Solicitation 
 (createNonFBOSolicitation)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Secure Document Packages 
 (attachSecureDocumentPackagesToNonFBOSolicitation)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Remove Secure Document Package 
 (removeSecureDocumentPackagesFromNonFBOSolicitation)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Non-FBO Solicitation Release 
 (releaseNonFBOSolicitation)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Un-Release-Non-FBO-Solicitation 
 (unreleaseNonFBOSolicitation)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Secure Technical Document Package 
 (createSecureDocumentPackage)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Add Files to Secure Document Package 
 (addFilesToSecureDocumentPackage)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Delete Files from Secure Document Package 
 (deleteFilesFromSecureDocumentPackage)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ### Delete Secure Document Package 
 (deleteSecureDocumentPackage)
 
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 ## Methods Available 
 to All Office Location Users
 
@@ -1184,7 +1175,7 @@ IVLListRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #
-ntype	|string	|No	|[Refer Related Notices](#related-notices)
+ntype	|string	|No	|[Refer Notice Types](#notice-types)
 
 IVLListResponse Complex Type Definition:
 
@@ -1208,7 +1199,7 @@ duns|	string|	DUNS #
 cage_code	|string|	Cage Code
 address	|string	|Address
 bus_types|	string|	Business Types
-naics_codes|	string	|Naics Codes
+naics_codes|	string	|Naics Codes 
NAICS Reference
 
 ### Authorized Parties List 
 (getAuthorizedPartyList)
 
@@ -1229,8 +1220,8 @@ AuthorizedPartyListRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes	|Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below
-ntype|	string|	No|	V[Refer Related Notices](#related-notices)
-nonfbo_solbr|	string|	no|	Non-fbo Solicitation #. Not supported for this method
+ntype|	string|	No|	[Refer Notice Types](#notice-types)
+nonfbo_solbr|	string|	No|	Non-fbo Solicitation #. Not supported for this method
 status| string	|No	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests.
 
 AuthorizedPartyListResponse Complex Type Definition:
@@ -1273,8 +1264,8 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation #
-ntype	|string	|No|	[Refer Related Notices](#related-notices)
-nonfbo_solbr	|string|	no|	Non-fbo Solicitation #.  Not supported for this method
+ntype	|string	|No|	[Refer Notice Types](#notice-types)
+nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
 
 
@@ -1299,7 +1290,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name	|Type	|Required|	Description
 -----|-----|-----|----
 solnbr	|string	|Yes|	Solicitation #
-ntype|	string|	No|	[Refer Related Notices](#related-notices)
+ntype|	string|	No|	[Refer Notice Types](#notice-types)
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method
 vendor|	VendorData	|Yes|	Complex type defined below
 
@@ -1336,7 +1327,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation #
-ntype	|string	|No|[Refer Related Notices](#related-notices)
+ntype	|string	|No|[Refer Notice Types](#notice-types)
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
 reason	|string|	Yes|	rejection reason not used in this method
@@ -1363,7 +1354,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #
-ntype	|string	|No|	[Refer Related Notices](#related-notices)
+ntype	|string	|No|	[Refer Notice Types](#notice-types)
 nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method
 vendor	|VendorData|	Yes|	Complex type defined below
 reason|	string|	Yes	|Rejection Reason 
@@ -1399,7 +1390,7 @@ ExplicitAccessRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #
-ntype	|string	|No	|[Refer Related Notices](#related-notices)
+ntype	|string	|No	|[Refer Notice Types](#notice-types)
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.
 Id	|string	|No	|Not used in this method
 vendor	|VendorData|	Yes|	Complex type defined below
@@ -1437,12 +1428,12 @@ NoticeListRequest Complex Type Definition:
 
 Element Name|	Type|	Required|	Description
 -----|-----|-----|-----
-notice_type	|string|	No (at least 1 field is required)|	[Refer Related Notices](#related-notices)  Note:Searches for awardsj&as, itb’s and fairopps will return both standalone notices AND base notices that contain one of these type
+notice_type	|string|	No (at least 1 field is required)|	[Refer Notice Types](#notice-types)  Note:Searches for award, j&a, itb and fairopps will return both standalone notices AND base notices that contain one of these type
 solnbr	|string	|No (at least 1 field is required)	|Solicitation #
 awdnbr	|string	|No	(at least 1 field is required)|Award #
 posted_from	|date|	No (at least 1 field is required)|	Posted From Date. YYYYMMDD.
-posted_to	|date|	|No (at least 1 field is required)|	Posted To Date. YYYYMMDD
-documents_to_search	|string|	No(at least 1 field is required)|	Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided.
+posted_to	|date|	No (at least 1 field is required)|	Posted To Date. YYYYMMDD
+documents_to_search	|string|	No (at least 1 field is required)|	Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided.
 
 Response:
 
@@ -1521,7 +1512,7 @@ classcod|	string|	Class-Code
 naics	|string|	NAICS Code
 offadd	|string	|Office Address
 subject	|string	|Subject
-solnbr|	string	|Sol #
+solnbr|	string	|Solicitation #
 awdnbr|	string|	Award #
 donbr	|string	|Delivery/Task Order Number
 awdamt	|string	|Award Amount
@@ -1540,9 +1531,9 @@ link|	GovernmentURL	|Government Link
 email|	Government Email|	Government Email
 files	|DocumentPack ageData[]|	Array of package data if applicable
 setaside	|string	|Set-Aside value
-popaddress	|string	|POP Address
-popzip	|string|	POP Zip
-popcountry|	string|	POP Country
+popaddress	|string	|Place of Performace Addressress
+popzip	|string|	Place of Performace Zip
+popcountry|	string|	Place of Performace Country
 recovery_act	|boolean	|Recovery Act
 correction|	boolean	|Correction of previous notice for the following types: Award #, Delivery Order #) – Awards, J&A’s, Intent to Bundle Requirements (DoD-Funded), Fair Opportunity / Limited Source Justification.
 changes	|NoticeData[]	|This element will only be present on the base/original posting and will contain an array of changes (for any mods/awards/etc.). Each change uses the same complex type.
@@ -1656,7 +1647,7 @@ Please note that variances may exist between SOAP requests generated by differen
                         
                         
                         20300101
-                        Veera
+                        John Doe
                         test
                         
                         
@@ -1775,7 +1766,7 @@ Please note that variances may exist between SOAP requests generated by differen
             20181001
             
             20450101
-            test veera
+            John Doe
             test
             
             
@@ -1879,7 +1870,7 @@ Please note that variances may exist between SOAP requests generated by differen
             
             
             
-            Veera
+            John Doe
             test desc
             
             
@@ -2163,9 +2154,9 @@ Note: This service gets a list of all notices
 					ST_PRESOL_Oct_0012
 					2020-01-01T23:59:59-05:00
 					2020-01-01
-					Description by Veera
-					https://***REMOVED***/opp/bf20590c11c74f209f992c074dbbb0d1/view
-					Veera Sareddy primary<a href=""> Gmail Desc</a>
+					Description by XYZ
+					https://xyz.com
+					John Doe primary<a href=""> Gmail Desc</a>
 					
 						

 						
@@ -2263,10 +2254,10 @@ Note: This service gets a list of all notices
             20180101
             
             
-            veera
+            XYZ Copr
             
             
-            Veera
+            John Doe
             
             
             
@@ -2372,7 +2363,7 @@ Note: This service gets a list of all notices
             
             
             
-            Veera
+            John Doe
             
             
             
@@ -2475,7 +2466,7 @@ Note: This service gets a list of all notices
            
            
            
-           Veera
+           John Doe
            
            Test desc
            
@@ -2575,7 +2566,7 @@ Note: This service gets a list of all notices
            
            
            
-           veera
+           John Doe
            
            
               
@@ -2789,7 +2780,7 @@ Note: This service gets a list of all notices
             testsalesur3
             
             
-            Veera
+            John Doe
             test desc
             
             
@@ -2954,7 +2945,7 @@ Note: This service gets a list of all notices
             20190101
             
             
-            Veera 
+            John Doe 
             Test Description
             
             
@@ -3145,7 +3136,7 @@ Note: This service gets a list of all notices
             
             
             
-            Veera
+            John Doe
             
             test desc
             
@@ -4080,240 +4071,48 @@ The following error messages may be returned as part of the response to various
 
 This section details possible error messages for specific methods. Note that these rules are reflective of time of implementation and are subject to change in future.
 
-#### submitNotice
-
-Individual business rules per field are listed across each of the fields in below table.  
+#### Submit Methods
+Individual business rules per field for all submit methods are listed in the table below.  
 Note:
-* Through this service, users can create all the requests and also users can convert between requests. For e.g. Users can create pre-sol or any type and also this can be converted to say ITB anytime.
-* When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date |	Yes - Only Award
No - Rest	| YYYYMMDD	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	- Award Details Section - Contract Award Date is required field 

 - Award Details Section - Contract Award Date provided should have 4 digit year 

 - Award Details Section - Contract Award Date provided is in an invalid format
-notice_type	|Yes| Valid Options mentioned General Notice (submitNotice) section |	1. This required field should be validated |	1. Opportunity type is required
-zip|	No|	5 digits|	NA |NA
-classcod	|No|	Valid classification code (FAR, Section 5.207(g))	|1. This required field should be validated where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
-naics	|Yes - Combined Synopsis/Solicitation & Solicitation 
 No - Rest| 	Valid NAICS Code NAICS Reference	|NA | -  NAICS code is required
-offadd|	No|	65535 characters|	Not-Used|	NA
-officeid	|Yes	|20 characters 	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided


 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-subject	|Yes	|255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	 Yes - Rest 
 No - Only Special Notice|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

 2. If duplicate solicitation number is given, then system throws an error

 3. For an invalid solnbr and notice_type combination, the service throws an error|	1.Notice Id is required

 2. Notice Id for the selected opportunity type already exists

 3. Opportunity not found with given solicitation number and ntype
-ntype|	No|	[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error 	|NTYPE value provided is not valid
-awdnbr|	Yes –  Award, ITB & JA 
 No – Rest|	255 characters|	1. This required field should be validated|	1. Award Details Section - Contract Award Number is a required field
-donbr|	Yes – JA 
 No – Rest	|255 characters	|1. This is required field for JA	|1. Award Details Section - Task/Delivery Order Number is required field
-awdamt	|Yes – Award 
 No – Rest|	64 characters|	1. This required field should be validated	|1. Award Details Section – Amount is a required field.
-linenbr|No |	255 characters|	NA	|NA
-awddate	|Yes – Award 
 No – Rest	|YYYYMMDD|	1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

 2. This required field should be validated|	1. DATE field in unexpected format. Expects YYYYMMDD

 2. Award Details Section - Contract Award Date is required field.
-stauth|	Yes – JA
 No – Rest	| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

  Description of each of these stauth values is captured in Stauth Values section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ | Both foja & stauth values will be given under stauth in legacy |	NA
-respdate|Yes – Only Combined/Solicitation
 No – Rest (Required for Sources Sought/Presol/Sale of Surplus/Special Notice when Required when 15 Days after Response is selected)|	YYYYMMDD |	1.	No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions 

 2.	This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2) 

3.	For submitCombined this field is required	| 1.	DATE field in unexpected format. Expects YYYYMMDD 

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Inactive date provided is in the past

 4.	Response Date is required
-**archdate** (updated needed)|	No|	YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restriction 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past.
-awardee	|Yes – Only Award
 No – Rest|	6553 characters|	NA|	NA
-awardee_duns|	No	|9 digits with optional plus 4|	NA|	NA
-contact	| Yes - Rest 
 No - Award & Special Notice	|65535 characters Default value = Primary Other types are: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
-desc| Yes - Rest 
 No – Justfication & Award 	|65535 characters|	1. This required field should be validated.|	1. Description is required
-link|No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	| NA
-email|	Yes - Rest 
 No - Only Award|	128 characters|	NA	 |NA
-links	|No	|Array of links	|NA	|NA
-files|	No|	Array of files|	NA|	NA
-setaside|	No|	See Set-Aside Values section for valid codes|	NA	|NA
-popaddress|	No|	65535 characters|	This is a free Text. No validation is performed on this field	 |
+date 	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	1. DATE field in unexpected format. Expects YYYYMMDD
+notice_type	|	1. This field is required where applicable |	1. Opportunity type is required
+zip|	NA |NA
+classcod	|1. This field is required where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
+naics		|NA |  NAICS code is required
+offadd| Not Used|	NA
+officeid	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If user does not have access to an office but is trying to make a submission to that office, then the service throws an error

	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
+subject	|	1. This field is required where appicable 	|1. $.data.title: is missing but it is required
+solnbr|	1. This field is required where applicable

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If solnbr is in invalid format, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype
+ntype	 |1. When user tries to convert a notice and the solicitation number/ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values listed. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
+awdnbr|	1. This field is required where applicable|	1. Award Details Section - Contract Award Number is a required field
+donbr	|1. This field is required where applicable

 2. If value provided does not meet the character limit/restrictions, then service throws an error|	1. Award Details Section - Task/Delivery Order Number is required field

 2. Award Details Section - Task/Delivery Order Number - Please enter a valid number
+awdamt|	 	1. This field is required where applicable

 2. If an invalid integer values is given, then service throws an error 	|1. Award Details Section - Amount is a required field

 2. Award Details Section - Please enter valid integer for Amount Field
+linenbr|	NA	|NA
+awddate	|	1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

 2. This field is required where applicable|	1. DATE field in unexpected format. Expects YYYYMMDD

 2. Award Details Section - Contract Award Date is required field 

 3. Award Details Section - Contract Award Date provided is in an invalid format
+stauth|	 Both foja & stauth values will be given under stauth in legacy |	NA
+respdate|	1.	This field is required where applicable 

 2.	This date cannot be in past; has to be in future. If the given date is in past, then system throws errors 	| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date 

 4. One of Response date or Archive date is required 

 5. One of Response date or Archive date is required
+archdate|	1.	This field is required where applicable. Note user may receive "Auto 30 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past. 

 3. One of Response date or Archive date is required
+awardee	|	NA|	NA
+awardee_duns|	NA|	NA
+contact	|	1. This field is required where applicable	|1. Primary Contact is Required
+desc| 	1. This field is required where applicable.|	1. Description is required
+link|	NA	| NA
+email	|1. This field is required where applicable 

  2. If an invalid email address is provided, then the service throws an error	| 1. Primary Contact - Email is required 

  2. Primary Contact - Please enter a valid Internet email address. Format: username@host.domain
+links|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
+files|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
+setaside|	NA	|NA
+popaddress|	This is a free Text. No validation is performed on this field	 | NA
 popzip	|No	|5 digits|	NA|	NA
 popcountry|	 No|	1. Award Details Section - Country is a required field
-city	|No	|NA	|NA|	NA
-state	|No	|NA|	NA|	NA
-recovery_act|	No|	True or False|	NA	|NA
-correction|	No|	True or False

 If correcting a previously submitted J&A notice, specify true and the system will lookup the j&a by award number and sol number if applicable.	|If correction = true, system checks if an opportunity exists or not. If exists, then a new modified record will be posted of the same type and will be set as the latest. If No, then the request will be rejected.|
-
-#### submitPresol and submitSourcesSought
-
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA| NA
-classcod|	No  |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics	|No|  Valid NAICS Code  NAICS Reference|	NA| 	NA
-offadd|	No	|65535 characters	|NA|	NA
-officeid	|Yes	|20 characters |	1.	This field is required 

2.	If an invalid officeid is given, then service throws an error

  3.	If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4.	Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-subject	|Yes	|255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
-solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-respdate|	No - However either Respdate or Archdate must be selected |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be in past; has to be in future 

3.	When giving future date, response date cannot exceed 5 years from the current date 	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
-**archdate** (updated needed) |No - However either Respdate or Archdate must be selected	|YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Inactive date provided is in the past.
-contact|Yes|	65535 characters 

Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated|	1. Primary Contact is required
-desc	|Yes |	65535 characters|	1. This required field should be validated	|1. Description is required
-link|	No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	|NA
-email	| Yes |	128 characters|		| NA
-links|	No|	Array of links|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-files|	No|	Array of files|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-setaside|	No|	See Set-Aside Values section for valid codes	|NA	|NA
-popaddress|	No|	65535 characters|	This is a free Text. No validation is performed on this field	 |
-popzip|	No|	5 digits|	NA|	NA
-popcountry	|No|	32 characters|	NA|	NA
-recovery_act|	No	|True or False|	NA|	NA
-
-#### submitCombined
-
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA|	NA
-classcod	|Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated

 2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

2. This opportunity cannot be published. Classification Code provided did not match expected codes.
-naics	|Yes |Valid NAICS Code  NAICS Reference|	1. This required field should be validated |1. NAICS code is required
-officeid	|Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

  3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-offadd|	No|	65535 characters|	NA|	NA
-subject	|Yes|	255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
-solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	This opportunity cannot be published. Response date is required

  2.	DATE field in unexpected format. Expects YYYYMMDD  

3.	This opportunity cannot be published. Response date provided is in the past

 4.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
-**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
-contact|	Yes|	65535 characters Default value: Primary 

Other types: Secondary, Owner|	1. This required field should be validated|	1. Primary Contact is Required
-desc|	Yes |	65535 characters|	1. This required field should be validated|	1. Description is required
-link	|No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
-email	|Yes 	|128 characters	|NA	| NA
-links|	No	|Array of links|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-files	|No	|Array of files|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-setaside|	No|	See Set-Aside Values section for valid codes|	NA|	NA
-popaddress|	No|	65535 characters|	This is a free Text. No validation is performed on this field	 |
-popzip|	No|	5 digits|	NA|	NA
-popcountry|	No|	32 characters	|NA	|NA
-recovery_act	|No|	True or False|	NA|	NA
-
-#### submitITB
-
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
-classcod	|Yes |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

 2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics	|No	|Valid NAICS Code  NAICS Reference| 	NA|	NA
-officeid|	Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-offadd|	No|	65535 characters|	NA|	NA
-subject	|Yes|	255 characters|	1. This required field should be validated|	1. $.data.title: is missing but it is required
-solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype
-ntype|	no|	[Refer Related Notices](#related-notices) |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
-awdnbr|	Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}	|1. This required field should be validated

 2. This field accepts only valid characters as mentioned under character limit/restrictions column |	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
-donbr|	No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) |	NA|	NA
-**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
-contact|	Yes	|65535 characters

 65535 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	| 1. Primary Contact is Required
-desc|	Yes |	65535 characters|	1. This required field should be validated	|1. Description is required
-link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)	|NA	|NA
-link	|No	| |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-files|	No	| |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-email|	Yes|	128 characters|	NA	 |
-recovery_act|	No|	True or False|	NA|	 NA
-correction|	No|		True or False 

 If correcting a previously submitted itb notice, specify true and the system will lookup the itb by award number, delivery number and sol number if applicable|	1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice and correction = true, then the service throws an error

 2. If correction = True and the system cannot return a single record for the same delivery number/ award number / sol-number or combination of all three, then the service throws an error

 3. If correction = True and the system returns more than one record for the same delivery number/ award number / sol-number or combination of all three, then service throws an error|	1. Notice could not be found for correction 

 2. Notice could not be found for correction

 3. Multiple Notices found. Please input more details
-
-#### submitMod
-
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: If none of the fields are given, then service throws an error – ntype provided is not valid.
-* Note: If ntype value is provided and then submitted, then service throws an error - Multiple Notices found. Please input more details
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	Yes - Only Award 
 No - Rest|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
-classcod	|Yes – Solicitation/Combined/Sale of Surplus/ITB/Justification
  No – Rest	|Valid classification code (FAR, Section 5.207(g))	|1. This field is required and should be validated

 2. If a wrong classification code is given, then service throws an error |1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics	|Yes –  Combined & Solicitation 
No – Rest|	Valid NAICS Code  NAICS Reference	|1. For combined, this field is required and should be validated|	1. NAICS code is required
-officeid|	Yes|	20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make modifications to an opportunity associated to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-offadd|	No	|65535 characters|	NA|	NA
-subject	|Yes|	255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1a. This required field if not given, service will throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 3.	Notice not found for correction
-ntype|	Yes |[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |	1.	NTYPE value provided is not valid
-respdate	|Yes – for Combined/Solicitation 
  No – Rest (Special Notice/Sale of Surplus/Sources Sought/Presol must have either respdate or archdate)|YYYYMMDD	|1.	This required field is validated for combined type

 2.	No validation is performed on this field for rest of the types. However, if this value is available, this field should meet the character limit/restriction 

 3.	This date cannot be in past; has to be in future|	1.	This opportunity cannot be published. Response date is required

 2.	DATE field in unexpected format. Expects YYYYMMDD

 3.	This opportunity cannot be published. Response date provided is in the past
-**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
-contact|	Yes – Rest 
 No – For Award/Special notice
	|65535 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
-desc	|Yes - Award/Justification 
  No - Rest|	65535 characters|	1. This required field should be validated	|1. Description is required
-link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA	|NA
-links	|No	|Collection	|1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-files|	No|	 |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-email	|Yes - Rest 
 No - Only Award|128 characters|	NA|NA
-setaside|	No|	See Set-Aside Values section for valid codes|	NA|	NA
-popaddress|	No	|65535 characters|	NA|	NA
-popzip	|No	|5 digit	|NA |	NA
-popcountry|	No	|32 characters|	NA|	NA
-recovery_act|	No|	True or False|	NA|	NA
-
-#### submitJA
-
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: If none of the fields are given, then service throws an error – $.data.title: is missing but it is required.
-* Note: If only subject is given, then service throws multiple errors:
-      * Award Details Section - Task/Delivery Order Number is required field.  
-      * Contracting office is required
-      * PSC code is required
-      * Award Details Section - Contract Award Number is a required field.
-      * This opportunity cannot be published. Authority is required
-      * Primary Contact is required
-      * Notice Id is required
-
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	No	|YYYYMMDD	|1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA|	NA
-classcod|	Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error	|1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics|	No |Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No|	65535 characters|	NA|	NA
-officeid|	Yes|	20 characters	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
-subject	|Yes|	255 characters	|1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field if not given will throw an error 

 2. Duplicate solicitation number cannot be submitted

 (Refer error #2) 3. If a space is given along with numbers in this field, then service throws an error

 4. If solicitation & ntype combination is not matched, then service throws an error.	|1. Notice Id is required 

2. Notice ID for the selected opportunity type already exits

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Opportunity not found with given solicitation number and ntype
-ntype	|No	|[Refer Related Notices](#related-notices)|1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |   1. Invalid NTYPE value provided
-stauth	|Yes|	Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7  

Description of each of these stauth values is captured in Stauth Value section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’|	1. This required field should be validated 

Note: Both foja & stauth values will be given under stauth in legacy	|1. This opportunity cannot be published. Authority is required
-awdnbr	|Yes|	255 characters|	1. This required field should be validated	|1. Award Details Section - Contract Award Number is a required field
-modnbr|	No	|32 characters|	NA|	NA
-awddate	|No – May change in future|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions| 	1.	DATE field in unexpected format. Expects YYYYMMDD
-awdamt|	No|	64 characters|	NA|	NA
-**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be published. Archive date provided is in the past.
-contact|	Yes |	65535 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
-desc|	No|	65535 characters|	NA	|NA
-link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
-links	|No	| |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-files	|No|	 |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-email	|Yes  |	128 characters|	NA|	NA
-recovery_act	|No	|True or False|	NA	|NA
-correction	|No	|True or False

 If correcting a previously submitted J&A notice, specify true and the system will lookup the j&a by award number and sol number if applicable.|	If correction = true, system checks if an opportunity exists or not. If exists, then a new modified record will be posted of the same type and will be set as the latest. If No, then the request will be rejected |	 NA
-donbr	|Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( )|1. This field is required

 2. In value provided for this field does not meet the character limit/restrictions mentioned, then service throws an error|	1. Award Details Section - Task/Delivery Order Number is required field

 2. Award Details Section - Task/Delivery Order Number - Please enter a valid number
-
-#### submitAward
+city	|NA|	NA
+state	|	NA|	NA
+recovery_act|	NA	|NA
+correction|	1. When user tries to convert a notice and the solicitation number/ntype do not match the notice and correction = true, then the service throws an error

 2. If correction = True and the system cannot return a single record for the same delivery number/ award number / soliciation number or combination of all three, then the service throws an error

 3. If correction = True and the system returns more than one record for the same delivery number/ award number / sol-number or combination of all three, then service throws an error|	1. Notice could not be found for correction 

 2. Multiple Notices found. Please input more details
 
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: If none of the fields are given, then service throws an error – ntype provided is not valid.
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	Yes	|YYYYMMDD|	1. If this field is given, then this field should meet the character limit/restrictions |1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No|	5 digits|	NA|	NA
-classcod|	No|	Valid classification code (FAR, Section 5.207(g))|	1. If a wrong classification code is given, then the service throws an error | 1. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics	| No|	Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No	|65535 characters|	NA|	NA
-officeid	|Yes	|20 characters	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-subject	|Yes|	255 characters|	1. This required field should be validated	|$.data.title: is missing but it is required
-solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

3. Opportunity not found with given solicitation number and ntype
-ntype|	No|	[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  | 	1. Invalid NTYPE value provided.
-awdnbr|	Yes|	Valid numbers|	1. This required field should be validated 

2. If an invalid number is given (e.g with special characters), then service throws an error|	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
-awdamt|	Yes|	Valid integer values| 	1. This required field should be validated

 2. If an invalid integer values is given, then service throws an error 	|1. Award Details Section - Amount is a required field

 2. Award Details Section - Please enter valid integer for Amount Field
-linenbr	|No|	255 characters|	NA|	NA
-awddate	|Yes|	YYYYMMDD	|1. This required field should be validated

  2. If this field is given, then this field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future	|1. Award Details Section - Contract Award Date is required field

 2. DATE field in unexpected format. Expects YYYYMMDD
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be published. Archive date provided is in the past
-awardee|	Yes|	65535 characters|	1. This required field should be validated	|1. Award Details Section - Contractor Awarded Name is a required field
-awardee_duns	|No|	9 digits with optional plus 4	|NA	|NA
-contact|	No|	65535 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
-desc|	No|	65535 characters|	NA|	NA
-link|	No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
-email|	No |	128 characters|	NA|	NA
-links|	No|	 	|1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-files|	No|	| 	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-setaside|	No|	See Set-Aside Values section for valid codes|	NA|	NA
-recovery_act	|No	|True or False|	NA|	NA
-correction|	No|	True or False 

 If correcting a previously submitted award notice, specify true and the system will lookup the award by award number and sol number if applicable|	If correction = true, system checks if an opportunity exists or not. If exists, then a new modified record will be posted of the same type and will be set as the latest. If No, then the request will be rejected	 |
 
 #### submitDocumentsAndLinksToNotice
 
@@ -4322,124 +4121,43 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: When none of the fields are given the service throws an error - Links and/or Files are not complete
 * Note: When links/files are given but none of the other fields are given, then service throws an error - Multiple Notices found. Please input more details
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date|	No |	YYYYMMDD|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
-officeid|	No	|20 characters|	1. If an invalid officeid is given, then service throws an error

 2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 3. Officeid must be associated with user account	|1. Invalid officeid provided

 2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-solnbr|	No |128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-ntype	| No |[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |  1. Notice Type value provided is not valid
-uploadtype|	No  – link or file|	A for amendment, S for solicitation or any title for other; 255 characters|	NA|	NA
-respdate| No (Special Notice/Sale of Surplus/Sources Sought/Presol must have either respdate or archdate) |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
-links|	Yes; Either Links or Files needs to be provided |	Array of files|	1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

 2. If a link with same name already exists on the notice, then the system throws an error.

 3. If the Url is empty for a link, then the system throws an error.

 4.	If the description is missing for a link, then the system throws an error.| 1.	Links and/or files are not complete

 2.	Resource with the same name already exists

 3.	Link Resource must have a link

 4. Link Resource must have a description
-files	| Yes; Either Links or Files needs to be provided |	Array of files|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file type that you are trying to upload is not supported

6.	Resource with the same name already exists
+date|		Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
+officeid|		1. If an invalid officeid is given, then service throws an error

 2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 3. Office ID must be associated with user account	|1. Invalid officeid provided

 2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
+solnbr|1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+ntype	|	1. If field is not provided OR a wrong ntype is provided, then service throws an error  |  1. Notice Type value provided is not valid
+uploadtype|	NA|	NA
+respdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
+links|	1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

 2. If a link with same name already exists on the notice, then the system throws an error.

 3. If the Url is empty for a link, then the system throws an error.

 4.	If the description is missing for a link, then the system throws an error.| 1.	Links and/or files are not complete

 2.	Resource with the same name already exists

 3.	Link Resource must have a link

 4. Link Resource must have a description
+files	|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file type that you are trying to upload is not supported

6.	Resource with the same name already exists
 
-#### submitFairOpps
 
-This service is now deprecated. Instead, please use submitJA to perform the operation.
-
-#### submitForeignGovernment
-
-This service is now deprecated.
-
-#### submitSpecialNotice
-
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
-classcod	|No|	Valid classification code (FAR, Section 5.207(g))|	1. This field does not take invalid codes	|1. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics|	No|	Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No|	65535 characters|	NA	|NA
-officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-subject	|Yes|	255 characters|	1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-**archdate** (updated needed)	|No	|YYYYMMDD	|1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
-contact|	No|	65535 characters Default value: Primary 

Other types: Secondary, Owner|	NA|	NA
-desc|	Yes	|65535 characters|	1. This required field should be validated|	1. Description is required
-link|	No	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)	|NA|	NA
-links|	No|	 |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-files|	No|	 |	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-email|	Yes|	128 characters|	NA|	NA
-recovery_act|	No|	True or False|	NA|	NA
-
-#### submitSolicitation
-
-Individual business rules per field are listed across each of the fields in below table.  
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA|	NA
-classcod	|Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated

 2. If a wrong classification code is given, then the service throws an error | 1. Product Service Code is a required field  

2. Classification Code provided did not match expected codes
-naics	|Yes |Valid NAICS Code  NAICS Reference|	1. This required field should be validated |1. NAICS code is required
-officeid	|Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

  3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1.   Invalid officeid provided

 2.   Insufficient privileges to create opportunity.
-offadd|	No|	65535 characters|	NA|	NA
-subject	|Yes|	255 characters|	1. This required field should be validated|	1. Title is a required field.
-solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1.   Notice ID is a required field 

2. Notice ID must be unique based on selected notice type 

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces
-respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	Response date is required

  2.    DATE field in unexpected format. Expects YYYYMMDD  

3.	Response Date cannot be in the past

 4.	Response Date cannot exceed 5 years from current date
-**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	Inactive date provided is in the past
-desc|	Yes |	65535 characters|	1. This required field should be validated|	1. Description is a required field
-link	|No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
-email	|Yes	|128 characters	|1. This field is required 

  2. If an invalid email address is provided, then the service throws an error	| 1. Primary Contact - Email is required 

  2. Primary Contact - Please enter a valid Internet email address. Format: username@host.domain
-links|	No	|Array of links|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-files	|No	|Array of files|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-setaside|	No|	See Set-Aside Values section for valid codes|	NA|	NA
-popaddress|	No|	65535 characters|	This is a free Text. No validation is performed on this field	 |
-popzip|	No|	5 digits|	NA|	NA
-popcountry|	No|	32 characters	|NA	|NA
-recovery_act	|No|	True or False|	NA|	NA
-
-#### submitSaleofSurplus
-
-Individual business rules per field are listed across each of the fields in below table.  
-* Note: When none of the fields are given, then the service throws an error - $.data.title: is missing but it is required
-
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
-classcod|	Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error  |1. PSC code is required 

2. This opportunity cannot be published. Classification Code provided did not match expected codes
-naics	|No	|Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No|	65535 characters|	NA|	NA
-officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
-subject|	Yes	|255 characters	|1. This required field should be validated	|1. $.data.title: is missing but it is required
-solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1. This required field should be validated

 2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-**archdate** (updated needed)|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future |	1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
-contact	|Yes|	65535 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	|1. Primary Contact is Required
-desc|	Yes|	65535 characters	|1. This required field should be validated	|1. Description is required
-link|	No|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)|	NA|	NA
-links|	No|	| 	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error|	1. Links and/or files are not complete
-files|	No|	| 	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
-email|	Yes|	128 characters|	NA|	NA
-recovery_act|	No|	True or False|	NA|	NA
 
 #### deleteNoticeOrDocumentPackage
 
 Individual business rules per field are listed across each of the fields in below table.  
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	Yes; Solicitation Number or Award Number is required|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-awdnbr|	Yes; Solicitation Number or Award Number is required|	255 characters| If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required
-ntype|No|	 [Refer Related Notices](#related-notices)|	1. If an invalid ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
-deletetype|	no|	Valid values: “notice” to delete the notice, “attachment” to delete attachments and links from the notice|	1. If an invalid deletetype is provided, then service throws an error  |	Delete type provided is not “notice” or “attachment”
-deletemethod|	no|	Valid Values: “all” to delete all versions or “latest” to delete latest version	|1. If an invalid deletemethod is provided, then service throws an error  |	Delete method provided is not “latest” or “all”
+solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+awdnbr|	 If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required
+ntype|	1. If an invalid ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
+deletetype|		1. If an invalid deletetype is provided, then service throws an error  |	Delete type provided is not “notice” or “attachment”
+deletemethod|	1. If an invalid deletemethod is provided, then service throws an error  |	Delete method provided is not “latest” or “all”
 
 #### archiveNotice
 
 Individual business rules per field are listed across each of the fields in below table.  
 * Note: : If a user tries to archive a notice that is already archived, then the service throws an error -  Opportunity already archived
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
-solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice not found for correction

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-officeid	|No|	20 characters|	Officeid must be associated with user account	|NA
-ntype|	No|	[Refer Related Notices](#related-notices)|	1. If an invalid ntype is provided, then service throws an error

    2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction
-archdate|	Yes |	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+date|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
+solnbr|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice not found for correction

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+officeid	|	Office ID must be associated with user account	|NA
+ntype|	1. If an invalid ntype is provided, then service throws an error

    2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction
+archdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 
 #### unarchiveNotice
 
@@ -4447,85 +4165,85 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: : If a user tries to unarchive a notice that is already unarchived, then the service throws an error - Opportunity is not archived.
 * Note: If a user tries to unarchive an active notice, then the service throws an error - Opportunity is active
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction
-officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
-ntype|	No|[Refer Related Notices](#related-notices) |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
-awdnbr	|Yes - Award/ITB/Justification; No - Rest|	255 characters|	NA|	NA
-archdate|	Yes|	YYYYMMDD|	1. This required field should be validated  

2. If this value is available, this field should meet the character limit/restrictions 

3.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	New archive date provided is in the past

 3.	$.reason: null found, string expected. Unable to process request. Please try again
+solnbr|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction
+officeid|	Office ID must be associated with user account	|NA
+ntype|		1. If field is not provided OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
+awdnbr	|	NA|	NA
+archdate|	1. This field is required where applicable  

2. If this value is available, this field should meet the character limit/restrictions 

3.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	New archive date provided is in the past

 3.	$.reason: null found, string expected. Unable to process request. Please try again
 
-#### cancelNotice (NEEDS FIX)
+#### cancelNotice 
 
 Individual business rules per field are listed across each of the fields in below table.  
 * Note: : If user tries to cancel already cancelled opportunity, service throws an error - This opportunity cannot be cancelled. This opportunity is already cancelled. Unable to process request. Please try again.
 * Note: -	When user tries to cancel a notice without giving any input, then the service throws an error ‘Unable to process request. Please try again’
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-date|	No|	YYYYMMDD	|Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
-officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
-subject|	No|	255 characters|	NA|	NA
-solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error

 1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If valid solnbr is given with a different ntype, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple Notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-ntype	|No	|[Refer Related Notices](#related-notices)|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
-awdnbr|	Yes - Award/ITB/Justification; No - Rest|	255 characters|	NA|	NA
-archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be cancelled
-contact|Yes|	65535 characters Default value: Primary 

Other types: Secondary, Owner| NA| NA
-desc|	Yes|	65535 characters|	1. This required field should be validated |	1. Unable to process request. Please try again
+date|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
+officeid|	Office ID must be associated with user account	|NA
+subject|		NA|	NA
+solnbr|	1a. This required field if not given, service throws an error

 1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If valid solnbr is given with a different ntype, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple Notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+ntype	|	1. If field is not provided OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
+awdnbr|		NA|	NA
+archdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be cancelled
+contact| NA| NA
+desc|	1. This field is required where applicable |	1. Unable to process request. Please try again
 
 #### getNoticeData
 
 Individual business rules per field are listed across each of the fields in below table.  
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-notice_id	|No (at least 1 field is required)|	Unique ID found from getList call or ID’s for changes found in getNoticeData call|	Notice_id is required|	notice_id from getList is required
-Get_changes|	No (at least 1 field is required)	|True or False

 Pass in true to get the full notice history with all changes|	NA|	NA
-get_changes_from_date|	No (at least 1 field is required)|	If maintaining a sync of changes, can specify a date so that only changes that have occurred since provided date will be returned|	Date field should meet the expected format.|	DATE field in unexpected format. Expects YYYYMMDD
-get_file_data	|No (at least 1 field is required)	|True or False

 Pass in true and the method will return any file content stored in Contract Opportunities (attachment data will be retuned as Base64Encoding Format). If false, the meta details/links will still be provided	|NA	|NA
+notice_id	|	notice_id is required|	notice_id from getList is required
+Get_changes|		NA|	NA
+get_changes_from_date|		Date field should meet the expected format.|	DATE field in unexpected format. Expects YYYYMMDD
+get_file_data	|NA	|NA
 
 #### getList
 
 Individual business rules per field are listed across each of the fields in below table.  
 * Note: Although none of the individual elements are mandatory, at least one filter should be given to perform the operation. If no filters are entered, then system throws an error - Insufficient Search Criteria.
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	 |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-notice_type	|No (at least 1 field is required) |[Refer Related Notices](#related-notices) |	Notice Type is not recognized

 Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE,  ITB
-solnbr|	No (at least 1 field is required)|	Solicitation #|	NA|	NA
-awdnbr|	No (at least 1 field is required)|	Award #|	NA|	NA
-posted_from	|No	(at least 1 field is required)|Posted From Date. YYYYMMDD|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
-posted_to|	No (at least 1 field is required)	|Posted To Date. YYYYMMDD	|Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
-documents_to_search|	No (at least 1 field is required)	|Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided|	NA|	NA
+notice_type	 |	

 Valid Notice Type must be provided | Notice Type is not recognized
+solnbr|	NA|	NA
+awdnbr|		NA|	NA
+posted_from	|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
+posted_to|Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
+documents_to_search|	NA|	NA
 
 #### getFileData
 
 Individual business rules per field are listed across each of the fields in below table.  
 * Note: If a wrong combination of file_id and notice_id is given, then the service throws a success message without any data.
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-file_id	|Yes|	Unique ID of a file found from getNoticeData call (i.e. file_id element) |1. This required field should be validated 
 2. If an invalid file Id is provided, then the system throws an error.|	1. file_id is required 
 2.	File Id not found. Please enter a valid Id.
+file_id	|1. This field is required where applicable 
 2. If an invalid file Id is provided, then the system throws an error.|	1. file_id is required 
 2.	File Id not found. Please enter a valid Id.
 
 #### getIVLListResponse
 
 Individual business rules per field are listed across each of the fields in below table.  
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	Yes |	Solicitation Number|	1. If an incorrect solicitation number and ntype combination is given, the service throws an error

   2a. If this required field if not given, service throws an error 

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found 

2a. Notice not found

 2b. Multiple Notices found. Please input more details
-ntype|	No|	[Refer Related Notices](#related-notices) |	NA	|NA
+solnbr|		1. If an incorrect solicitation number and ntype combination is given, the service throws an error

   2a. If this required field if not given, service throws an error 

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found 

2a. Notice not found

 2b. Multiple Notices found. Please input more details
+ntype|	NA	|NA
 
 #### getAuthorizedPartyList
 
 Individual business rules per field are listed across each of the fields in below table.  
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	Yes | 	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
-ntype|	No|	[Refer Related Notices](#related-notices)|	If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
-nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together 

2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
-status|	No|	Valid Options: approved, pending, rejected, “empty value”

 If empty, all status will be returned

 Note, use “pending” to pull the pending explicit access requests |1.	If the status value entered doesn’t match the valid values , then the system throws an error|	1.	Status value is invalid
+solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
+ntype|		If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
+nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together 

2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
+status|	1.	If the status value entered doesn’t match the valid values , then the system throws an error|	1.	Status value is invalid
 
 #### approveExplicitAccessRequestByID
 
@@ -4533,12 +4251,12 @@ Individual business rules per field are listed across each of the fields in belo
 
 ID can be obtained through getAuthorizedPartyList   
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr	|Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4. Multiple notices found. Please input more details
-ntype	|No|	[Refer Related Notices](#related-notices)	|If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
-nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
-id|	Yes|	|	1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already approved, then the service throws an error

3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error	|1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already approved

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
+solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4. Multiple notices found. Please input more details
+ntype	|If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
+nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
+id|		1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already approved, then the service throws an error

3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error	|1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already approved

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
 
 #### approveExplicitAccessRequestByVendorData
 
@@ -4547,46 +4265,46 @@ Individual business rules per field are listed across each of the fields in belo
 Vendor can be obtained through getAuthorizedPartyList   
 
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr	|Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
-ntype	|No|	[Refer Related Notices](#related-notices)	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
-nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
-vendor	|Yes|	Vendor Data	|1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error. 
2.	If no match is found in the system for the vendor data provided, then the system throws an error. 
 3.	If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown. 
 2.	No contact match on vendor data provided.  
 3.	Request with Request ID: #id already approved.
+solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
+ntype	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
+nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
+vendor	|1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error. 
2.	If no match is found in the system for the vendor data provided, then the system throws an error. 
 3.	If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown. 
 2.	No contact match on vendor data provided.  
 3.	Request with Request ID: #id already approved.
 
 #### addAuthorizedParty
 
 Individual business rules per field are listed across each of the fields in below table.  
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
-ntype|	No|	[Refer Related Notices](#related-notices) |If an invalid ntype is provided, then service throws an error |  1. NTYPE value provided is not valid
-nonfbo_solbr 	|No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
-vendor|	Yes|	Vendor Data|	1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
+solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
+ntype|	If an invalid ntype is provided, then service throws an error |  1. NTYPE value provided is not valid
+nonfbo_solbr 	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
+vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
 
 #### rejectExplicitAccessRequestByID
 
 Individual business rules per field are listed across each of the fields in below table.  
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	 |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	Yes |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { } |1. This required field should be validated. If no value is provided, then service throws an error 

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error|	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 
 4. Multiple notices found. Please input more details
-ntype|	No|	[Refer Related Notices](#related-notices) |	1.	If an invalid ntype is provided, then service throws an error   |	1. NTYPE value provided is not valid
-nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
-id|	Yes	||	1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already rejected, then the service throws an error

 3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error|	1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already rejected

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
-reason| Yes| Rejection Reason| 1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
+solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error|	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 
 4. Multiple notices found. Please input more details
+ntype|	1.	If an invalid ntype is provided, then service throws an error   |	1. NTYPE value provided is not valid
+nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
+id|		1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already rejected, then the service throws an error

 3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error|	1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already rejected

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
+reason|  1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
 
 #### rejectExplicitAccessRequestByVendorData
 Individual business rules per field are listed across each of the fields in below table.  
 
-Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
+Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr	|No |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
-ntype	|No|	[Refer Related Notices](#related-notices)	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
-nonfbo_solbr |	No|	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
-vendor|	Yes|	Vendor Data|	1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
-reason| Yes| Rejection Reason| 1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
+solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
+ntype		|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
+nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
+vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
+reason|  1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
 
 
 
@@ -4605,47 +4323,54 @@ reason| Yes| Rejection Reason| 1.	This is a required field. If no value is provi
 
 
 
-#### rejectExplicitAccessRequestByVendorData
-Details will be added in future.
+
+
+#### submitFairOpps
+
+This service is now deprecated. Instead, please use submitJA to perform the operation.
+
+#### submitForeignGovernment
+
+This service is now deprecated.
 
 #### setBidModuleOptions
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### getBidModuleResponses
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### createSecureDocumentPackage
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### addFilesToSecureDocumentPackage
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### deleteFilesFromSecureDocumentPackage
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### deleteSecureDocumentPackage
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### releaseSecureDocumentPackage
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### attachSecureDocumentPackagesToNotice
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### createNonFBOSolicitation
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### attachSecureDocumentPackagesToNonFBOSolicitation
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### removeSecureDocumentPackagesFromNonFBOSolicitation
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### releaseNonFBOSolicitation
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 #### unreleaseNonFBOSolicitation
-Service is now deprecated. Hence no longer available.
+Service is now deprecated. 
 
 
 
@@ -4671,7 +4396,8 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/25/2019 | v0.71| Updated Business Rules
+10/28/2019 | v0.8| Removed redundant Required and Character Limit columns from Business Rules section. Consolidated Business Rules section for all Submit methods. Updated submitMod and submitNotice methods to align with implemenation. 
+
 
 
Back to top

 

From 7d3f1e1f827458e0f7776b611a92568a08fe1bac Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Mon, 28 Oct 2019 11:26:03 -0400
Subject: [PATCH 056/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 137 +++++++++++++++--------------
 1 file changed, 69 insertions(+), 68 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index be0d070c3..2367f54c9 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -2127,76 +2127,77 @@ Please note that variances may exist between SOAP requests generated by differen
     Response Sample – Success
From eb07bece2788a2c03da5d1718d10894bc60ea140 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Mon, 28 Oct 2019 11:26:05 -0400 Subject: [PATCH 057/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 2f3c74559..e43e21a81 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -93,7 +93,7 @@ In order to download secure attachment, user should have at least one of the bel * Edit Draft Attachment * Delete Draft Attachment -### Lookup/Meta Data +### Lookup/Meta-Data #### Notice Types @@ -143,7 +143,7 @@ VSS | Veteran-Owned Small Business Sole source (specific to Department of Vetera

Back to top

-#### Stauth valid values +#### Stauth Valid Values Below table captures stauth values to use while making requests as needed. Code | Description From d8eaee369a9962b4ae7a2182ccf0e5b325bfd7fc Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Mon, 28 Oct 2019 11:33:03 -0400 Subject: [PATCH 058/149] Update opportunities-api.md --- _apidocs/opportunities-api.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index e43e21a81..212874ef7 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -2777,7 +2777,7 @@ placeOfPerformance.
country.name | string | | No | No | Pop Country name placeOfPerformance.zip | string | | No | No | Pop Country zip archive | JSON | NA | NA | NA | archive.type | string | auto15, auto30, autocustom | No | Yes | Archive Type -archive.date | date | | No (Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided) | Yes (if archive.type=autocustom OR Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided ) | Archive Date +archive.date | date | | No | Yes (if archive.type=
autocustom) | Archive Date permissions | JSON | NA | NA | NA | permissions.ivl | JSON | NA | NA | NA | permissions.ivl.create | boolean | | No | No | permissions.ivl.create @@ -2787,7 +2787,7 @@ permissions.ivl.delete | boolean | Not In Use | Not In Use | Not In Use | Not In solicitation | JSON | NA | NA | NA | solicitation.setAside | string | See Set-Aside values table | No | No | setAside solicitation.deadlines | JSON | NA | NA | NA | -solicitation.
deadlines.response | date | YYYY-MM-DDTHH:MM:SS-05:00 | No (Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided) | 1) Yes (for type=k,o)
2) Yes (when archive.type=auto1)
3) Yes for Presol, Sources Sought, Special Notice, Sale of Surplus; Either Archive Date or Response Date must be provided | Deadline Date +solicitation.
deadlines.response | date | YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o)
2) Yes (when archive.type=auto1)| Deadline Date solicitation.deadlines.
responseresponseTz | string | | No | No | Time Zone for
Solicitation Deadline Date award | JSON | NA | NA | NA | award.date | date | YYYY-MM-DD |No | Yes only for type= a | Award Date From 083fbcc0774f14167b5d1ba053fbe61d8f2c8bf8 Mon Sep 17 00:00:00 2001 From: whrkddnjs135 <> Date: Mon, 28 Oct 2019 11:55:51 -0400 Subject: [PATCH 059/149] Update opportunities-soap-api.md --- _apidocs/opportunities-soap-api.md | 32 +++++++++++++++--------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index 2367f54c9..73640cb68 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -4078,7 +4078,7 @@ Note: Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- date |1. This field should meet the character limit/restrictions

Note: Date field allows current date and also any date in past/future | 1. DATE field in unexpected format. Expects YYYYMMDD notice_type | 1. This field is required where applicable | 1. Opportunity type is required zip| NA |NA @@ -4123,7 +4123,7 @@ Individual business rules per field are listed across each of the fields in belo * Note: When links/files are given but none of the other fields are given, then service throws an error - Multiple Notices found. Please input more details Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- date| Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD officeid| 1. If an invalid officeid is given, then service throws an error

2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

3. Office ID must be associated with user account |1. Invalid officeid provided

2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check solnbr|1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If solicitation & ntype combination is not matched, then service throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces @@ -4140,7 +4140,7 @@ files | 1. This field is not required but if url & description fields within the Individual business rules per field are listed across each of the fields in below table. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces awdnbr| If neither solnbr or awdnbr is provided, then the system throws an error| Solicitation Number or Award Number is required ntype| 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid @@ -4153,7 +4153,7 @@ Individual business rules per field are listed across each of the fields in belo * Note: : If a user tries to archive a notice that is already archived, then the service throws an error - Opportunity already archived Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- date| Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD solnbr| 1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error| 1. Multiple notices found. Please input more details

2. Notice not found for correction

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces officeid | Office ID must be associated with user account |NA @@ -4167,7 +4167,7 @@ Individual business rules per field are listed across each of the fields in belo * Note: If a user tries to unarchive an active notice, then the service throws an error - Opportunity is active Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr| 1a. This required field if not given, service throws an error

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

2. If solicitation & ntype combination is not matched, then service throws an error |1. Multiple notices found. Please input more details

2. Notice not found for correction officeid| Office ID must be associated with user account |NA ntype| 1. If field is not provided OR a wrong ntype is provided, then service throws an error | 1. NTYPE value provided is not valid @@ -4181,7 +4181,7 @@ Individual business rules per field are listed across each of the fields in belo * Note: - When user tries to cancel a notice without giving any input, then the service throws an error ‘Unable to process request. Please try again’ Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- date| Date field should meet the expected format |DATE field in unexpected format. Expects YYYYMMDD officeid| Office ID must be associated with user account |NA subject| NA| NA @@ -4197,7 +4197,7 @@ desc| 1. This field is required where applicable | 1. Unable to process request. Individual business rules per field are listed across each of the fields in below table. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- notice_id | notice_id is required| notice_id from getList is required Get_changes| NA| NA get_changes_from_date| Date field should meet the expected format.| DATE field in unexpected format. Expects YYYYMMDD @@ -4209,7 +4209,7 @@ Individual business rules per field are listed across each of the fields in belo * Note: Although none of the individual elements are mandatory, at least one filter should be given to perform the operation. If no filters are entered, then system throws an error - Insufficient Search Criteria. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- notice_type |

Valid Notice Type must be provided | Notice Type is not recognized solnbr| NA| NA awdnbr| NA| NA @@ -4223,7 +4223,7 @@ Individual business rules per field are listed across each of the fields in belo * Note: If a wrong combination of file_id and notice_id is given, then the service throws a success message without any data. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- file_id |1. This field is required where applicable
2. If an invalid file Id is provided, then the system throws an error.| 1. file_id is required
2. File Id not found. Please enter a valid Id. #### getIVLListResponse @@ -4231,7 +4231,7 @@ file_id |1. This field is required where applicable
2. If an invalid file I Individual business rules per field are listed across each of the fields in below table. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr| 1. If an incorrect solicitation number and ntype combination is given, the service throws an error

2a. If this required field if not given, service throws an error

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found

2a. Notice not found

2b. Multiple Notices found. Please input more details ntype| NA |NA @@ -4240,7 +4240,7 @@ ntype| NA |NA Individual business rules per field are listed across each of the fields in below table. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details ntype| If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. addAuthoizedParty service is deprecated for Non-FBO Solicitations @@ -4253,7 +4253,7 @@ Individual business rules per field are listed across each of the fields in belo ID can be obtained through getAuthorizedPartyList Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr | 1. This field is required where applicable. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error |1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details ntype |If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations @@ -4267,7 +4267,7 @@ Vendor can be obtained through getAuthorizedPartyList Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr | 1. This field is required where applicable. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. ntype |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. nonfbo_solbr | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations @@ -4278,7 +4278,7 @@ vendor |1. If all the elements in the Vendor Data complex definition are not pro Individual business rules per field are listed across each of the fields in below table. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error | 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Multiple notices found. Please input more details ntype| If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. addAuthoizedParty service is deprecated for Non-FBO Solicitations @@ -4289,7 +4289,7 @@ vendor| 1. If all the elements in the Vendor Data complex definition are not pr Individual business rules per field are listed across each of the fields in below table. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If a space is given along with numbers in this field, then service throws an error

4. If ntype value is not provided and the solnbr is not unique, then the system throws an error| 1. Solicitation Number is required

2. Notice not found

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
4. Multiple notices found. Please input more details ntype| 1. If an invalid ntype is provided, then service throws an error | 1. NTYPE value provided is not valid nonfbo_solbr | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations @@ -4300,7 +4300,7 @@ reason| 1. This is a required field. If no value is provided, then the system t Individual business rules per field are listed across each of the fields in below table. Element Name | Business Rules | Error Messages with respect to business rules (If any) ------- | ------- | ------- | ------- | -------- +------ | ------- | ------- solnbr | 1. This field is required where applicable. If no value is provided, then service throws an error

2. If invalid combination of ntype and solnbr is provided, then system throws an error

3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. |1. Solicitation Number is required

2. Notice not found

3. Multiple notices found. Please input more details. ntype |If an invalid ntype is provided, then service throws an error | 1. Invalid NTYPE value provided. nonfbo_solbr | 1. If both solnbr and nonfbo_solbr are provided, then the service throws an error

2. If only nonfbo_solbr is provided, then the service throws an error| 1. Solicitation Number and Non-FBO Solicitation Number cannot be specified together

2. rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations From e4ac9bf5fc0291d13321cd170c3efe2ff82c1000 Mon Sep 17 00:00:00 2001 From: Prashant Pillai Date: Mon, 28 Oct 2019 14:49:13 -0400 Subject: [PATCH 060/149] updates --- _apidocs/opportunities-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 8c6ad274a..24bcf5943 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -2047,7 +2047,7 @@ Examples
-Update Attachment Request - Change Resource Order (Move resource to the bottom.(Applicable to both files and links)) +Update Attachment Request - Change Resource Order (Move resource to the bottom of the list. Applicable to both files and links) 

 {

From 4452656594884e8689cd9599ff6d7ab544bcdd29 Mon Sep 17 00:00:00 2001
From: Prashant Pillai 
Date: Mon, 28 Oct 2019 14:50:53 -0400
Subject: [PATCH 061/149] updates

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 24bcf5943..3e2b3c660 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2087,7 +2087,7 @@ Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
 resourceId | query | string | Yes | Resource ID
-deleteAll | query | boolean | Yes | Should be true if deleting resource from all versions of a notice; else false. The deleted published resources will not show up if there are any further revisions made for the current opportunity. 
+deleteAll | query | boolean | Yes | Should be true if deleting resource from all versions of a notice; else false. The deleted published resources will not show up for any further revisions that will be created. 
 
 
Back to top

 

From c2cf48f4ef2ee52b187a6b64072b7492b110361b Mon Sep 17 00:00:00 2001
From: Prashant Pillai 
Date: Mon, 28 Oct 2019 14:58:52 -0400
Subject: [PATCH 062/149] updates

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 3e2b3c660..62a815d50 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2070,7 +2070,7 @@ Examples
 
 
Back to top

 
-### Delete Resource from Draft Opportunity
+### Delete Resource in Draft Opportunity
 
 ------- | -------
 **Request Type** | DELETE

From 2dc1bf4b7b2406b8cb2a34b336ff34dd28ddb78c Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Mon, 28 Oct 2019 17:32:05 -0400
Subject: [PATCH 063/149] updating the field restrictions for awdnbr..

---
 _apidocs/opportunities-api.md      | 613 +++++++++++++----------------
 _apidocs/opportunities-soap-api.md | 205 +++++-----
 2 files changed, 384 insertions(+), 434 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 62a815d50..0373787db 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -202,122 +202,73 @@ Examples
 

 
 {
-  "data": {
-    "solicitationNumber": "ITB_Test1",
-    "title": "TST_T1",
-    "type": "i",
-    "classificationCode": "13",
-    "organizationId": "100120624",
-    "naics": [
-      {
-        "type": "primary",
-        "code": [
-          "111150"
-        ]
-      }
-    ],
-    "pointOfContact": [
-      {
-        "additionalInfo": {
-          "content": ""
+    "data": {
+        "type": "i",
+        "award": {
+            "date": "2222-02-22",
+            "number": "ContractAwardNumber123-_(){}",
+            "deliveryOrderNumber": "TaskOrderNumber1234-_()"
         },
-        "email": "",
-        "fax": "",
-        "fullName": "GSA",
-        "phone": "",
-        "title": "",
-        "type": "primary"
-      }
-    ],
-    "placeOfPerformance": {
-      "city": {
-        "code": "",
-        "name": ""
-      },
-      "country": {
-        "code": "",
-        "name": ""
-      },
-      "state": {
-        "code": "",
-        "name": ""
-      },
-      "streetAddress": "",
-      "streetAddress2": "",
-      "zip": ""
+        "naics": [
+            {
+                "code": [
+                    "111160"
+                ],
+                "type": "primary"
+            }
+        ],
+        "title": "Create Intent To Bundle Requirements notice",
+        "archive": {
+            "date": null,
+            "type": "auto30"
+        },
+        "permissions": {
+            "IVL": {
+                "read": false,
+                "create": false,
+                "delete": false,
+                "update": false
+            }
+        },
+        "solicitation": {
+            "deadlines": {
+                "response": null,
+                "responseTz": null
+            }
+        },
+        "organizationId": "100186612",
+        "pointOfContact": [
+            {
+                "fax": "1234567890",
+                "type": "primary",
+                "email": "test.email2@gmail.com",
+                "phone": "1234567890",
+                "title": null,
+                "fullName": "Test User"
+            },
+            {
+                "fax": "4512367890",
+                "type": "secondary",
+                "email": "test.email@gmail.com",
+                "phone": "1234567890",
+                "title": null,
+                "fullName": "Test User 2"
+            }
+        ],
+        "classificationCode": "1005",
+        "solicitationNumber": "Test-ITB-123",
+        "additionalReporting": [
+            "recovery_act"
+        ]
     },
-    "award": {
-      "date": "2019-08-08T11:20:20-05:00",
-      "number": "12345",
-      "deliveryOrderNumber": "",
-      "amount": "number",
-      "lineItemNumber": "",
-      "awardee": {
-        "name": "",
-        "duns": "",
-        "location": {
-          "streetAddress": "",
-          "streetAddress2": "",
-          "city": {
-            "code": "",
-            "name": ""
-          },
-          "state": {
-            "code": "",
-            "name": ""
-          },
-          "zip": "",
-          "country": {
-            "code": "",
-            "name": ""
-          }
+    "related": {},
+    "description": [
+        {
+            "body": "Test Description"
         }
-      },
-      "justificationAuthority": {
-        "modificationNumber": "",
-        "authority": "dictionary"
-      },
-    },
-    "permissions": {
-      "IVL": {
-        "create": false,
-        "delete": false,
-        "read": false,
-        "update": false
-      }
-    },
-    "solicitation": {
-      "setAside": "SBA",
-      "deadlines": {
-        "response": "2019-08-08T11:20:20-05:00"
-      }
-    },
-    "archive": {
-      "type": "autocustom",
-      "date": "2019-09-09"
-    },
-    "flags": [
-      {
-        "code": "",
-        "isSelected": true
-      }
-    ],
-    "link": {
-      "additionalInfo": {
-        "content": ""
-      },
-      "href": ""
-    },
-    "additionalReporting": [
-      "none"
     ]
-  },
-  "description": [
-    {
-      "body": "Description"
-    }
-  ]
 }
+
@@ -332,7 +283,7 @@ Examples "title": "PRESOLTEST_T1", "type": "p", "classificationCode": "13", - "organizationId": "100120624", + "organizationId": "100186612", "naics": [{ "type": "primary", "code": ["111150"] @@ -341,9 +292,9 @@ Examples "additionalInfo": { "content": "" }, - "email": "", + "email": "testemail@gsa.gov", "fax": "", - "fullName": "gsa", + "fullName": "test user", "phone": "", "title": "", "type": "primary" @@ -376,12 +327,12 @@ Examples "solicitation": { "setAside": "SBA", "deadlines": { - "response": "2019-08-08" + "response": "2023-08-08" } }, "archive": { "type": "autocustom", - "date": "2019-09-09" + "date": "2023-09-09" }, "flags": [{ "code": "", @@ -410,62 +361,62 @@ Examples 

 {
-  "data": {
-    "solicitationNumber": "Test1combine1",
-    "title": "TST_T1",
-    "type": "k",
-    "classificationCode": "13",
-    "organizationId": "100000136",
-    "archive": {
-      "type": "autocustom",
-      "date": "2019-09-09"
-    },
-    "naics": [
-      {
-        "type": "primary",
-        "code": [
-          "111150"
-        ]
-      }
-    ],
-    "pointOfContact": [
-      {
-        "additionalInfo": {
-          "content": ""
-        },
-        "email": "",
-        "fax": "",
-        "fullName": "gsa",
-        "phone": "",
-        "title": "",
-        "type": "primary"
-      }
-    ],
-    "permissions": {
-      "IVL": {
-        "create": false,
-        "delete": false,
-        "read": false,
-        "update": false
-      }
-    },
-    "solicitation": {
-      "setAside": "",
-      "deadlines": {
-        "responseTz": "YYYY-MM-DDTHH:MM:SS-05:00",
-        "response": "2019-11-11T11:12:00-05:00"
-      }
-    },
-    "additionalReporting": [
-      "none"
-    ]
-  },
-  "description": [
-    {
-      "body": "Description_TEST "
-    }
-  ]
-}
+   "data": {
+     "solicitationNumber": "Test1combine1",
+     "title": "TST_T1",
+     "type": "k",
+     "classificationCode": "13",
+     "organizationId": "100186612",
+     "archive": {
+       "type": "autocustom",
+       "date": "2022-09-09"
+     },
+     "naics": [
+       {
+         "type": "primary",
+         "code": [
+           "111150"
+         ]
+       }
+     ],
+     "pointOfContact": [
+       {
+         "additionalInfo": {
+           "content": ""
+         },
+         "email": "testemail@gsa.gov",
+         "fax": "",
+         "fullName": "test user",
+         "phone": "",
+         "title": "",
+         "type": "primary"
+       }
+     ],
+     "permissions": {
+       "IVL": {
+         "create": false,
+         "delete": false,
+         "read": false,
+         "update": false
+       }
+     },
+     "solicitation": {
+       "setAside": "",
+       "deadlines": {
+         "responseTz": "YYYY-MM-DDTHH:MM:SS-05:00",
+         "response": "2022-11-11T11:12:00-05:00"
+       }
+     },
+     "additionalReporting": [
+       "none"
+     ]
+   },
+   "description": [
+     {
+       "body": "Description_TEST "
+     }
+   ]
+ }

@@ -2495,7 +2446,6 @@ Examples 

 {
-
     "_embedded": {
         "authorizedPartyList": [
             {
@@ -2570,16 +2520,16 @@ HTTP Status Code | Response Type | Reason  | Description
 Examples
 
 

-Response – Add Authorized Party
+Request – Add Authorized Party
 

 
 {
 "lname":"test",
 "fname":"test123",
-"email":"reitestuser.de@gmail.com",
-"contractorName":"",
-"duns":"608999520",
-"cageCode":""
+"email":"testuser.de@gmail.com",
+"contractorName":"test contractor",
+"duns":"608999570",
+"cageCode":"4CHY"
 }
 

 

@@ -2704,140 +2654,140 @@ Examples
 

 
 {
-   "data": {
-        "solicitationNumber": "Test1",
-        "title": "TST_T1",
-        "type": "p",
-        "classificationCode": "13",
-        "organizationId": "100000136",
+    "data":
+    {
+        "type": "",
+        "solicitationNumber": "",
+        "title": "",
+        "organizationId": "",
         "organizationLocationId": "",
-        "naics": [{
+        "classificationCode": "",
+        "naics": [
+        {
             "type": "primary",
-            "code": ["111150"]
+            "code": [""]
         }],
-        "pointOfContact": [{
-                "additionalInfo": {
-                        "content": ""
-                },
-                "email": "",
-                "fax": "",
-                "fullName": "Veera",
-                "phone": "",
-                "title": "",
-                "type": "primary"
+        "flags": [
+        {
+            "code": "",
+            "isSelected": true
+        }],
+        "pointOfContact": [
+        {
+            "type": "primary",
+            "title": "",
+            "fullName": "",
+            "email": "",
+            "phone": "",
+            "fax": "",
+            "additionalInfo":
+            {
+                "content": ""
+            }
         }],
-        "placeOfPerformance": {
-                "city": {
+        "placeOfPerformance":
+        {
+            "streetAddress": "",
+            "streetAddress2": "",
+            "city":
+            {
+                "code": "",
+                "name": ""
+            },
+            "country":
+            {
+                "code": "",
+                "name": ""
+            },
+            "state":
+            {
+                "code": "",
+                "name": ""
+            },
+            "zip": ""
+        },
+        "archive":
+        {
+            "type": "autocustom",
+            "date": "2019-09-09"
+        },
+        "permissions":
+        {
+            "IVL":
+            {
+                "create": false,
+                "delete": false,
+                "read": false,
+                "update": false
+            }
+        },
+        "solicitation":
+        {
+            "setAside": "SBA",
+            "deadlines":
+            {
+                "response": "2019-08-08"
+            }
+        },
+        "award":
+        {
+            "date": "",
+            "number": "",
+            "deliveryOrderNumber": "",
+            "amount": "",
+            "lineItemNumber": "",
+            "awardee":
+            {
+                "manual": false,
+                "name": "",
+                "duns": "",
+                "location":
+                {
+                    "streetAddress": "",
+                    "streetAddress2": "",
+                    "city":
+                    {
                         "code": "",
                         "name": ""
-                },
-                "country": {
+                    },
+                    "state":
+                    {
                         "code": "",
                         "name": ""
-                },
-                "state": {
+                    },
+                    "zip": "",
+                    "country":
+                    {
                         "code": "",
                         "name": ""
-                },
-                "streetAddress": "",
-                "streetAddress2": "",
-                "zip": ""
-        },
-        "award": {
-                "date": "",
-                "number": "",
-                "deliveryOrderNumber": "",
-                "amount": "number",
-                "lineItemNumber": "",
-                "awardee": {
-                        "manual": false,
-                        "name": "",
-                        "duns": "",
-                        "location": {
-                                "streetAddress": "",
-                                "streetAddress2": "",
-                                "city": {
-                                        "code": "",
-                                        "name": ""
-                                },
-                                "state": {
-                                        "code": "",
-                                        "name": ""
-                                },
-                                "zip": "",
-                                "country": {
-                                        "code": "",
-                                        "name": ""
-                                }
-                        }
-                },
-                "justificationAuthority": {
-                        "modificationNumber": "",
-                        "authority": "dictionary"
-                },
-                "fairOpportunity": {
-                        "authority": ""
-                }
-        },
-        "permissions": {
-                "IVL": {
-                        "create": false,
-                        "delete": false,
-                        "read": false,
-                        "update": false
+                    }
                 }
-        }, 
-          "solicitation": {
-            "setAside": "SBA",
-            "deadlines": {
-                "response": "2019-08-08"
             }
-        },
-       "archive": {
-            "type": "autocustom",
-            "date": "2019-09-09"
-        },
-        "flags": [{
-                "code": "",
-                "isSelected": true
-        }],
-        "link": {
-                "additionalInfo": {
-                        "content": ""
+            },
+            "justificationAuthority":
+            {
+                "modificationNumber": "",
+                "authority": "dictionary"
+            },
+            "link":
+            {
+                "additionalInfo":
+                {
+                    "content": ""
                 },
                 "href": ""
+            },
+            "additionalReporting": ["none"]
         },
-         "additionalReporting": [
-                "none"
-        ]
-        },
- "description": [{
-        "body": ""
-    }],
-     "resources": [{
-        "attType": "link",
-
-        "link": "http://beta.sam.gov",
-
-        "description": "test beta sam link",
-
-        "packageAccessLevel": null
-    },
-    {
-       "attType": "link",
-
-        "link": "https://faaco.faa.gov/index.cfm/attachment/download/84723",
-
-        "description": "test attachment pdf link",
-
-        "packageAccessLevel": null
-
-    }],
-
-    "postedDate": "20190423",
-
-    "archived": false
-}
+        "description": [
+        {
+            "body": ""
+        }],
+        "related":
+        {
+            "opportunityId": ""
+        }
+    }
 

 

 

@@ -2850,22 +2800,24 @@ Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Req
 type | string | 1 character| See Notice Types table | Yes | Yes | Notice Type
 solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number
 title | string | 256 characters | |Yes | Yes | Title of the Opportunity
-organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Org Id/AAC code of the office where an Opportunity is being submitted
+organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
 organizationLocationId | string | | | No|No| This field has been deprecated.Organization Location details will be pulled from the Federal Hierarchy 
 classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
-naics | JSON | NA |NA | NA | NA |
-naics.code | string |  | | No | Yes | Valid NAICS Code
-naics.type | string | |primary  | No | Yes | NAICS Type Note: 'p' must be in lower case
-flags | JSON | NA |NA | NA | NA |
+naics | JSON Array | NA |NA | NA | NA |
+naics.code | Array of String | | | No | Yes | Valid NAICS Code
+naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
+flags | JSON Array| NA |NA | NA | NA |
 flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
 flags.IsSelected | boolean | |default is 'True' | No | No |
-pointOfContact | JSON | NA |NA | NA | NA |
-pointOfContact.type | string | | p | No | Yes | Contact Type Note: 'p' must be in lower case
+pointOfContact | JSON Array | NA |NA | NA | NA |
+pointOfContact.type | string | | primary, secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
 pointOfContact.title | string | |  | No | No | Contact title
 pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
 pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
 pointOfContact.phone | string |255 characters | | No | No | Contact Phone
 pointOfContact.fax | string | 255 characters | | No  | No | Contact Fax
+pointOfContact.additionalInfo | JSON |NA |NA | NA  | NA |  Any additional information on Point of Contact
+pointOfContact.additionalInfo.content | String | | | No  | No | Details of the additional information on Point of Contact 
 placeOfPerformance | JSON | NA | NA | NA | NA |
 placeOfPerformance.
streetAddess | string | | | No | No | Pop Address
 placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2
@@ -2879,61 +2831,60 @@ placeOfPerformance.country | JSON | NA | NA | NA | NA | Pop Country
 placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
 placeOfPerformance.
country.name | string | | | No | No | Pop Country name
 placeOfPerformance.zip | string | | | No | No | Pop Country zip
-archive | JSON |NA | NA | NA | NA |
-archive.type | string | | auto15, auto30, autocustom | No | Yes | Archive Type
-archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date
+archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
+archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date. This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA | NA |
-permissions.ivl | JSON | NA | NA | NA | NA |
-permissions.ivl.create | boolean | | | No | No | permissions.ivl.create
-permissions.ivl.read | boolean | | | No | No | permissions.ivl.read
-permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | Not In Use
-permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | Not In Use
+permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
+permissions.ivl.create | boolean | | | No | No | IVL create permission
+permissions.ivl.read | boolean | | | No | No | IVL read permission
+permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | IVL update permission
+permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | IVL delete permission
 solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |See Set-Aside values table | No | No | setAside
-solicitation.deadlines | JSON | NA | NA | NA | NA |
+solicitation.setAside | string | |See Set-Aside values table | No | No | Set-Aside code. The designator for type of set aside determined for the contract action
+solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
 solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
 solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
-award | JSON | NA | NA | NA | NA |
+award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for  'Award Notice' and 'Justification' opportunity types
 award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date
 award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number
-award.deliverOrderNumber | string | 255 characters| | No | No | Award Deliver Order Number
+award.deliverOrderNumber | string | 255 characters| | No | No | Award Delivery Order Number
 award.amount | number |64 digits |  | No | No | Award Amount
-award.lineitemNumber | string |255 characters | | No | No | Award Line item Number
-award.awardee | JSON | NA| NA | NA | NA |
-award.awardee.manual | string | |boolean  | Yes | Yes  | Awardee
+award.lineitemNumber | string |255 characters | | No | No | Contract Line item Number
+award.awardee | JSON | NA| NA | NA | NA |Awardee details
 award.awardee.name | string | 255 characters | | No | No | Awardee Name
 award.awardee.duns | string | 9 digits | | No | No | Awardee Duns
-award.awardee.location | JSON | | NA | NA | NA |
+award.awardee.location | JSON |NA | NA | NA | NA | Awardee Location details
 award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 
 award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 2
-award.awardee.location.
city | string | | | No | No | Awardee City
+award.awardee.location.
city | JSON |NA |NA |NA | NA | Awardee City details
 award.awardee.location.
city.code | string | | | No | No | Awardee City code
 award.awardee.location.
city.name | string | | | No | No | Awardee City name
-award.awardee.location.
state | JSON | NA | NA | NA | NA |
+award.awardee.location.
state | JSON | NA | NA | NA | NA | Awardee State details
 award.awardee.location.
state.code | string | | | No | No | Awardee State code
 award.awardee.location.
state.name | string | | | No | No | Awardee State name
-award.awardee.location.
country | JSON | | NA | NA | NA |
+award.awardee.location.
country | JSON | NA| NA | NA | NA |Awardee Country details
 award.awardee.location.
country.code | string | | | No | No | Awardee Country code
 award.awardee.location.
country.name | string | | | No | No | Awardee Country Name
-award.awardee.location.
zip | string | | | No | No | Awardee Country Zip
+award.awardee.location.
zip | string | | | No | No | Awardee Country Zip code
 justificationAuthority | JSON |NA |NA | NA | NA |
 justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
 justificationAuthority.
authority | string|  |  | No | No | Justification Authority
 link | JSON | NA |NA | NA | NA |
-link.href | string |  | | No | No | Url for the notice on SAM.gov
-link.additionalInfo | JSON | NA |NA | NA | NA |
-link.additionalInfo.content | string | | | No | No | Additional info
-additionalReporting | string | |none/
auto_recovery | No | Yes |
+link.href | string | | | No | No | Url for the notice on SAM.gov
+link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
+link.additionalInfo.content | string | | | No | No | Additional information details
+additionalReporting | string | |none/
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
 description | JSON | NA | NA | NA | NA |
-description.body | string | 65535 characters| | No | Yes | Description of notice
+description.body | string | 65535 characters| | No | Yes | Description of the notice
+related | JSON | NA | NA | NA | NA | Related Notice information
+related.opportunityId | string | 32 characters| | No | No | Opportunity Id of the related notice
 resources | JSON |NA | NA | NA | NA |
 resources.attType | string | |link, file | No |No| Type of attachment, either link or file
 resources.content | byte |250MB |  | No|No | File content in base64 format
 resources.link | string | 255 characters | |No|No | Resource link URL
 resources.packageAccessLevel | string | | public,private(default public) | No | No| Type of access to file or link
 resources.resourceName | string | 255 characters |  | No|No | Name of file
-postedDate| date| | |No|No| Posted Date
-archived| boolean| | true or false |No|No| Archived Status
 
 
Back to top

 
diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 59264bb24..fc5b7e9b4 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -159,21 +159,20 @@ Award Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date |	YYYYMMDD
-zip |	string |	No |	Zip Code |	5 digits
+zip |	string |	No |	Zip Code |	5 digits.This field has been deprecated
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
 naics |	string |	No |	NAICS Code |	Valid NAICS Code NAICS Reference
-offadd |	string |	No |	Office Address |	65535 characters
+offadd |	string |	No |	Office Address |	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 officeid |	string |	Yes |	Office id of the office where an opportunity is being submitted |	20 characters
 subject |	string |	Yes |	Subject |	256 characters
 solnbr |	string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype	| string |	No |	Base Notice Type |	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
-awdnbr |	string |	 Yes |	Award Number |	255 characters
-awdnbr |	open text, label: Agency assigned number for control tracking and identification.
 Please use ONLY alphanumeric and - _ ( ) { } characters [no spaces]. |	 Yes |	Award Number |	255 characters
+awdnbr |	string |	 Yes |	Award Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 awdamt |	string |	Yes |	Award Amount |	64 digits
-linenbr |	string |	No |	Line Number |	255 characters
+linenbr |	string |	No |	Line Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 awddate |	date |	Yes |	Award Date |	YYYYMMDD
 archdate |	date |	No |	Archive Date |	YYYYMMDD
-awardee |	string |	Yes |	Awardee |	65535 characters
+awardee |	string |	Yes |	Awardee |	255 characters
 awardee_duns |	string |	No |	Awardee DUNS |	9 digits with optional plus 4
 contact |	string |	No |	Contact Info |	255 characters
 desc |	string |	No |	Description |	65535 characters
@@ -212,9 +211,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename |	string |	Yes |	File Name |	255 characters
 filedata |	base64binary |	Yes |	File Data |	250 MB
-desc |	string |	No |	Description |	65535 characters
-explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
-export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
+desc |	string |	No |	Description |	65535 characters. This field has been deprecated
+explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true"|  
+export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation	| 
 
 ### Delete Notice/ Document Package 
(deleteNoticeOrDocumentPackage)
 
@@ -238,7 +237,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr |	string |	Yes, if Non-Award |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
 ntype |	string |	No |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award
-awdnbr |  string | Yes, if Award| Award # |	255 characters
+awdnbr |  string | Yes, if Award| Award # |	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 deletetype |	string |	No |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
 
@@ -264,7 +263,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date | YYYYMMDD
 solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string | No |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
+ntype |	string | No |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award
 archdate | date |	No | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
 officeid | string |	No |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
 
@@ -289,12 +288,12 @@ CancelNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-offadd | string |	No | Office Address |	65535 characters
+offadd | string |	No | Office Address |	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 officeid | String | No |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
 subject |	string | No |	Subject |	256 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype | string | No |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice,  “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
-awdnbr | string |	No | Award # |255 characters
+ntype | string | No |	Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice,  “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award
+awdnbr | string |	No | Award # |255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 archdate | date |	No | Archive Date | YYYYMMDD
 contact | string | No | Contact Info | 255 characters
 desc | string | Yes |	Cancellation Description | 65535 characters
@@ -322,11 +321,11 @@ Presol Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-zip |	string | No |	Zip Code | 5 digits
+zip |	string | No |	Zip Code | 5 digits. This field has been deprecated
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics |	string | No |	NAICS Code | Valid NAICS Code  NAICS Reference
 officeid | string |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters
-offadd | string |	No | Office Address |	65535 characters
+offadd | string |	No | Office Address |	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject |	string | Yes|	Subject |	256 characters
 solnbr | string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	No |	Response Date |	YYYYMMDD
@@ -370,9 +369,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename | string |	Yes | File Name | 255 characters
 filedata | base64binary |	Yes | File Data | 250 MB
-desc | string |	No | Description | 65535 characters
-explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
-export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
+desc | string |	No | Description | 65535 characters. This field has been deprecated
+explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true"|  
+export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation	| 
 
 ### Combined/Synopsis
 (submitCombined)
 
@@ -393,11 +392,11 @@ Combined Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-zip |	string | No |	Zip Code | 5 digits
+zip |	string | No |	Zip Code | 5 digits. This field has been deprecated
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
-naics | string | Yes | NAICS Code	| Valid NAICS Code NAICS Reference
+naics | string | Yes | NAICS Code	| Valid NAICS Code
 officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters
-offadd | string | No | Office Address	| 65535 characters
+offadd | string | No | Office Address	| 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject | string | Yes | Subject | 256 characters
 solnbr | string |	Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes | Response Date | YYYYMMDD
@@ -441,9 +440,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename | string | Yes | File Name | 255 characters
 filedata | base64binary |	Yes | File Data | 250 MB
-desc | string |	No | Description | 65535 characters
-explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
-export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
+desc | string |	No | Description | 65535 characters. This field has been deprecated
+explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true"|  
+export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation	| 
 
 ### Modification/Amendment 
 (submitMod)
 
@@ -464,11 +463,11 @@ Mod Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No |	Posting Date |	YYYYMMDD
-zip |	string |	No |	Zip Code |	5 digits
+zip |	string |	No |	Zip Code |	5 digits. This field has been deprecated
 classcod |	string	 | Yes – For combined type, presol type, Sale of surplus, No – For rest |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
 naics | 	string |	Yes – For combined type, No – For rest | 	NAICS Code |	Valid NAICS Code  NAICS Reference
 officeid |	string	| Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
-offadd |	string	| no	| Office Address |	65535 characters
+offadd |	string	| no	| Office Address |	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject	| string	| no |	Subject |	256 characters
 solnbr | string |	Yes | 	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype |	string |	Yes |	Base Notice Type |	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation
@@ -513,9 +512,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename |	string	| Yes | 	File Name |	255 characters
 filedata |	base64binary |	Yes |	File Data	| 250 MB
-desc |	string |	No |	Description |	65535 characters
-explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
-export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
+desc |	string |	No |	Description |	65535 characters. This field has been deprecated
+explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true"|  
+export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation	| 
 
 ### Justification and Authorization 
 (J&A) Notice (submitJA)
 
@@ -536,16 +535,16 @@ JA Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | Date	| No |	Posting Date |	YYYYMMDD
-zip |	String |	No	| Zip Code |	5 digits
-classcod	| String |	Yes |	Class-Code |	Valid classification code
-naics	| String |	No	| NAICS Code	| Valid NAICS Code  NAICS Reference
-offadd |	String	| No |	Office Address	| 65535 characters
+zip |	String |	No	| Zip Code |	5 digits. This field has been deprecated
+classcod	| String |	Yes |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
+naics	| String |	No	| NAICS Code	| Valid NAICS Code NAICS Reference
+offadd |	String	| No |	Office Address	| 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 officeid |	String |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
 subject |	String |	Yes |	Subject |	256 characters
 solnbr	| String |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. 

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required
 ntype	| string |	No	| Base Notice Type | Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation
 stauth	| String	| Yes |	Stat. Authority – Both foja & stauth values will be given under stauth in legacy |	Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7 
 Description of each of these stauth values is captured in section 4.4

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’
-awdnbr |	String |	Yes |	Award Number |	255 characters
+awdnbr |	String |	Yes |	Award Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 modnbr |	String |	No |	Mod Number |	32 characters
 awdamt |	String |	No |	Award Amount. This field has been deprecated for JA notice type |	64 digits
 awddate |	Date |	No – May change in future	| Award Date |	YYYYMMDD
@@ -587,7 +586,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename |	string	| Yes |	File Name	| 255 characters
 filedata |	base64binary |	Yes |	File Data	| 250 MB
-desc	| string |	No |	Description |	65535 characters
+desc	| string |	No |	Description |	65535 characters. This field has been deprecated.
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
 
@@ -610,11 +609,11 @@ SourcesSought Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date |	YYYYMMDD
-zip	 | string |	No |	Zip Code |	5 digits
+zip	 | string |	No |	Zip Code |	5 digits. This field has been deprecated
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
-naics	| string |	No |	NAICS Code |	Valid NAICS Code
+naics	| string |	No |	NAICS Code |	Valid NAICS Code NAICS Reference
 officeid |	string |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	| 20 characters
-offadd	| string	 | No |	Office Address |	65535 characters
+offadd	| string	 | No |	Office Address | 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject |	string |	Yes |	Subject |	256 characters
 solnbr	| string |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate |	date |	No |	Response Date |	YYYYMMDD
@@ -658,7 +657,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename |	string |	Yes |	File Name |	255 characters
 filedata |	base64binary |	Yes	| File Data |	250 MB
-desc	| string |	No	 | Description |	65535 characters
+desc	| string |	No	 | Description |	65535 characters. This field has been deprecated
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
 
@@ -685,11 +684,11 @@ SpecialNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date	| Date |	No	| Posting Date |	YYYYMMDD
-zip |	String |	No	 | Zip Code |	5 digits
+zip |	String |	No	 | Zip Code |	5 digits. This field has been deprecated
 classcod |	String	| No	| Class-Code | 	Valid classification code (FAR, Section 5.207(g))
 naics |	String |	No	| NAICS Code |	Valid NAICS Code  NAICS Reference
 officeid	| string |	Yes |	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	 | 20 characters
-offadd |	String |	No |	Office Address	| 65535 characters
+offadd |	String |	No |	Office Address	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject | 	String |	Yes |	Subject |	256 characters
 solnbr	| String |	Yes |	Sol # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 archdate |	Date |	No |	Archive Date |	YYYYMMDD
@@ -728,7 +727,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename |	string |	Yes |	File Name |	255 characters
 filedata |	base64binary |	Yes	| File Data |	250 MB
-desc	| string |	No	 | Description |	65535 characters
+desc	| string |	No	 | Description |	65535 characters. This field has been deprecated
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
 
@@ -751,11 +750,11 @@ SaleOfSurplus Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date|	No|	Posting Date|	YYYYMMDD
-zip|	string|	No|	Zip Code|	5 digits
+zip|	string|	No|	Zip Code|	5 digits. This field has been deprecated
 classcod|	string|	Yes	|Class-Code|	Valid classification code (FAR, Section 5.207(g))
-naics|	string|	No|	NAICS Code|	Valid NAICS Code  NAICS Reference
+naics|	string|	No|	NAICS Code|	Valid NAICS Code NAICS Reference
 officeid	|string	|Yes|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account |	20 characters
-offadd|	string|	No	|Office Address	|65535 characters
+offadd|	string|	No	|Office Address	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject|	string|	Yes|	Subject	|256 characters
 solnbr|	string	|Yes	|Sol #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 archdate|	date|	No|	Archive Date|	YYYYMMDD
@@ -817,11 +816,11 @@ Solicitation Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-zip |	string | No |	Zip Code | 5 digits
+zip |	string | No |	Zip Code | 5 digits. This field has been deprecated
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code NAICS Reference
 officeid | string | Yes | Office id of the office where an opportunity is being submitted. Officeid must be associated with user account | 20 characters
-offadd | string | No | Office Address	| 65535 characters
+offadd | string | No | Office Address	| 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject | string | Yes | Subject | 256 characters
 solnbr | string |	Yes | Sol # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes | Response Date | YYYYMMDD
@@ -865,9 +864,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename | string | Yes | File Name | 255 characters
 filedata | base64binary |	Yes | File Data | 250 MB
-desc | string |	No | Description | 65535 characters
-explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
-export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
+desc | string |	No | Description | 65535 characters. This field has been deprecated
+explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true"|  
+export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation	| 
 
 ### Intent to Bundle Requirements 
 (DoD- Funded) (submitITB)
 
@@ -888,15 +887,15 @@ ITB Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date	|Date	|No	|Posting Date	|YYYYMMDD
-zip	|String|	No|	Zip Code|	5 digits
+zip	|String|	No|	Zip Code|	5 digits. This field has been deprecated
 classcod|	String|	Yes|	Class-Code|	Valid classification code (FAR, Section 5.207(g))
-naics|	String|	No|	NAICS Code|	Valid NAICS Code
+naics|	String|	No|	NAICS Code|	Valid NAICS Code NAICS Reference
 officeid|	String|	Yes|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account|	20 characters
-offadd|	String	|No|	Office Address|	65535 characters
+offadd|	String	|No|	Office Address|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject|	String|	Yes|	Subject	|256 characters
 solnbr	|String	|Yes|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype	|string	|No|	Base Notice Type|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation
-awdnbr|	String	|Yes	|Award Number|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+awdnbr|	String	|Yes	|Award Number|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 donbr|	String|	No	|Task/Delivery Order Number	|255 characters from the set: a-z A-Z 0-9 - _ ( )
 archdate	|Date	|No	|Archive Date|	YYYYMMDD
 contact|	String|	Yes|	Contact Info	|255 characters; Default value = Primary, Other types are: Secondary, Owner
@@ -971,18 +970,18 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date|	date|	No	|Posting Date|	YYYYMMDD
 notice_type	|string	|Yes|	Notice type	|Valid options outlined above
-zip	|string	|No	|Zip Code|	5 digits
+zip	|string	|No	|Zip Code|	5 digits. This field has been deprecated
 classcod|	string|	No|	Class-Code	|Valid classification code (FAR, Section 5.207(g))
 naics	|string	|No	|NAICS Code|	Valid NAICS Code  NAICS Reference
 officeid|	String|	No|	Office id of the office where an opportunity is being submitted. Officeid must be associated with user account	|20 characters
-offadd	|string|	No|	Office Address	|65535 characters
+offadd	|string|	No|	Office Address	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject|	string|	Yes|	Subject|	256 characters
 solnbr|	string|	Yes – For presol, combined, itb, ja, award, special, document, surplus

 No – for rest|	Sol #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 ntype	|string	|no	|Base Notice Type	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation 
-awdnbr|	string|	Yes – For Award & JA, ITB

 No – For rest|	Award #	|255 characters
-donbr	|string	|Yes – For JA

 No – For rest|	Delivery/Task Order Number	|255 characters
+awdnbr|	string|	Yes – For Award & JA, ITB

 No – For rest| 255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+donbr	|string	|Yes – For JA

 No – For rest|	Delivery/Task Order Number	|255 characters from the set: a-z A-Z 0-9 - _ ( )
 awdamt	|string|	Yes – For Award

 No – For rest	|Award Amount|	64 digits
-linenbr|	string	|No|	Award Line Item Number	|255 characters
+linenbr|	string	|No|	Award Line Item Number	|255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 awddate	|date|	Yes – for award; No – for rest|	Award Date	|YYYYMMDD
 stauth	|string	|Yes – for JA; No – for test	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

 Description of each of these stauth values is captured in Stauth Value section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’
 modnbr	|string	|No	|J&A and FairOpp Contract Modification Number|	32 digits
@@ -1030,9 +1029,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename |	string |	Yes |	File Name |	255 characters
 filedata |	base64binary |	Yes	| File Data |	250 MB
-desc	| string |	No	 | Description |	65535 characters
-explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
-export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
+desc	| string |	No	 | Description |	65535 characters. This field has been deprecated.
+explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true"|  
+export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation	| 
 
 ### Document Packages 
 (submitDocumentsAndLinksToNotice)
 
@@ -1097,8 +1096,8 @@ UnarchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	|Base Notice Type	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation
-awdnbr	|string|	No|	Award #|	255 characters
+ntype	|string	|No	|Base Notice Type	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award
+awdnbr	|string|	No|	Award #|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
 
 ### Secure Document Package 
 (attachSecureDocumentPackagesToNotice)
@@ -1423,7 +1422,7 @@ Element Name|	Type|	Required|	Description | Character Limit / Restrictions
 -----|-----|-----|-----|-----
 notice_type	|string|	No| Valid Values: PRESOL, COMBINE,  AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL.  Note:Searches for awardsj&as, itb’s and fairopps will return both standalone notices AND base notices that contain one of these type |
 solnbr	|string	|No	|Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-awdnbr	|string	|No	|Award # | 255 characters
+awdnbr	|string	|No	|Award # | 255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 posted_from	|date|	No|	Posted From Date. YYYYMMDD. |
 posted_to	|date|	|No	Posted To Date. YYYYMMDD |
 documents_to_search	|string|	No|	Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided. |
@@ -4075,18 +4074,18 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 ------ | ------- | ------- | ------- | --------
 date |	No	| YYYYMMDD	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	1. DATE field in unexpected format. Expects YYYYMMDD
 Notice_type	|Yes| Valid Options mentioned General Notice (submitNotice) section |	1. This required field should be validated |	1. Opportunity type is required
-zip|	No|	5 digits|	NA |NA
+zip|	No|	5 digits. This field has been deprecated|	NA |NA
 classcod	|No|	Valid classification code (FAR, Section 5.207(g))	|1. This required field should be validated where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required                   

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
 naics	|No| 	Valid NAICS Code NAICS Reference	|NA |	NA
-offadd|	No|	65535 characters|	NA|	NA
+offadd|	No|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 officeid	|No	|20 characters 	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided


 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes – for all; NA – for submitDocumentAndLinks	|256 characters|	1. This required field should be validated	|1. title: is missing but it is required
 solnbr|	Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated. If this field is not given, then system throws an errors as shown on the right hand side

 2. If duplicate solicitation number is given, then system throws an error

 3. For an invalid solnbr and notice_type combination, the service throws an error|	1.Notice Id is required

 2. Notice Id for the selected opportunity type already exists

 3. Opportunity not found with given solicitation number and ntype
 ntype|	no|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error 	|NTYPE value provided is not valid
-awdnbr|	Yes – For Award, ITB & JA; No – For rest|	255 characters|	1. This required field should be validated|	1. Award Details Section - Contract Award Number is a required field
-donbr|	Yes – For JA; No – For rest	|255 characters	|1. This is required field for JA	|1. Award Details Section - Task/Delivery Order Number is required field
+awdnbr|	Yes – For Award, ITB & JA; No – For rest|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated|	1. Award Details Section - Contract Award Number is a required field
+donbr|	Yes – For JA; No – For rest	|255 characters from the set: a-z A-Z 0-9 - _ ( )	|1. This is required field for JA	|1. Award Details Section - Task/Delivery Order Number is required field
 awdamt	|Yes – For Award; No – For rest|	64 characters|	1. This required field should be validated	|1. Award Details Section – Amount is a required field.
-linenbr|	No|	255 characters|	NA	|NA
+linenbr|	No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	NA	|NA
 awddate	|Yes – For award; No – for rest	|YYYYMMDD|	1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

 2. This required field should be validated|	1. DATE field in unexpected format. Expects YYYYMMDD

 2. Award Details Section - Contract Award Date is required field.
 stauth|	Yes – For JA

 No – for rest	| Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7

  Description of each of these stauth values is captured in Stauth Values section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’ | Both foja & stauth values will be given under stauth in legacy |	NA
 respdate|	Yes – For SubmitCombined No- For rest|	YYYYMMDD |	1.	No validation is performed on this field for all services except submitCombined. However, if this value is available, this field should meet the character limit/restrictions 

 2.	This date cannot be in past; has to be in future. If the given date is in past, then system throws 2 errors (#2) 

3.	For submitCombined this field is required	| 1.	DATE field in unexpected format. Expects YYYYMMDD 

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Inactive date provided is in the past

 4.	Response Date is required
@@ -4116,10 +4115,10 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA| NA
+zip	|No	|5 digits. This field has been deprecated|	NA| NA
 classcod|	Yes – For submitpresol
 No - SourcesSought |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	|No|  Valid NAICS Code  NAICS Reference|	NA| 	NA
-offadd|	No	|65535 characters	|NA|	NA
+offadd|	No	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy	|NA|	NA
 officeid	|Yes	|20 characters |	1.	This field is required 

2.	If an invalid officeid is given, then service throws an error

  3.	If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4.	Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes	|256 characters|	1. This required field should be validated|	1. title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
@@ -4145,11 +4144,11 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA|	NA
+zip	|No	|5 digits. This field has been deprecated|	NA|	NA
 classcod	|Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated

 2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

2. This opportunity cannot be published. Classification Code provided did not match expected codes.
 naics	|Yes |Valid NAICS Code  NAICS Reference|	1. This required field should be validated |1. NAICS code is required
 officeid	|Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

  3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-offadd|	No|	65535 characters|	NA|	NA
+offadd|	No|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 subject	|Yes|	256 characters|	1. This required field should be validated|	1. title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	This opportunity cannot be published. Response date is required

  2.	DATE field in unexpected format. Expects YYYYMMDD  

3.	This opportunity cannot be published. Response date provided is in the past

 4.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date
@@ -4174,15 +4173,15 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
+zip|	No|	5 digits. This field has been deprecated|	NA|	NA
 classcod	|Yes |	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

 2. If a wrong classification code is given, then the service throws an error | 1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	|No	|Valid NAICS Code  NAICS Reference| 	NA|	NA
 officeid|	Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-offadd|	No|	65535 characters|	NA|	NA
+offadd|	No|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 subject	|Yes|	256 characters|	1. This required field should be validated|	1. title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype
 ntype|	no|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation |1. When user tries to convert a notice to ITB and the solicitation number and ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values mentioned. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
-awdnbr|	Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}	|1. This required field should be validated

 2. This field accepts only valid characters as mentioned under character limit/restrictions column |	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
+awdnbr|	Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1. This required field should be validated

 2. This field accepts only valid characters as mentioned under character limit/restrictions column |	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
 donbr|	No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) |	NA|	NA
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 contact|	Yes	|255 characters

 255 characters Default value: Primary

 Other types: Secondary, Owner|	1. This required field should be validated	| 1. Primary Contact is Required
@@ -4203,11 +4202,11 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
+zip|	No|	5 digits. This field has been deprecated|	NA|	NA
 classcod	|Yes – For combined type, presol type, Sale of surplus

  No – For test	|Valid classification code (FAR, Section 5.207(g))	|1. This field is required and should be validated

 2. If a wrong classification code is given, then service throws an error |1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	|Yes – For combined type 

No – For rest|	Valid NAICS Code  NAICS Reference	|1. For combined, this field is required and should be validated|	1. NAICS code is required
 officeid|	Yes|	20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make modifications to an opportunity associated to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-offadd|	No	|65535 characters|	NA|	NA
+offadd|	No	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 subject	|Yes|	256 characters|	1. This required field should be validated	|1. title: is missing but it is required
 solnbr|	Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1a. This required field if not given, service will throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 3.	Notice not found for correction
 ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation	 |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  |	1.	NTYPE value provided is not valid
@@ -4242,19 +4241,19 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No	|YYYYMMDD	|1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA|	NA
+zip	|No	|5 digits. This field has been deprecated|	NA|	NA
 classcod|	Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error	|1. PSC code is required

 2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics|	No – this may change in future	|Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No|	65535 characters|	NA|	NA
+offadd|	No|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 officeid|	Yes|	20 characters	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
 subject	|Yes|	256 characters	|1. This required field should be validated	|1. title: is missing but it is required
 solnbr|	Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field if not given will throw an error 

 2. Duplicate solicitation number cannot be submitted

 (Refer error #2) 3. If a space is given along with numbers in this field, then service throws an error

 4. If solicitation & ntype combination is not matched, then service throws an error.	|1. Notice Id is required 

2. Notice ID for the selected opportunity type already exits

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Opportunity not found with given solicitation number and ntype
 ntype	|No	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, "SOL" - for Solicitation|1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |   1. Invalid NTYPE value provided
 stauth	|Yes|	Valid values: 1, 2, 3, 4, 5, brand, far1, far2, far3, far4, far5, far6, far7  

Description of each of these stauth values is captured in Stauth Value section

 Foja values are: Valid values: 'Urgency’, ‘Only One Source (except brand name)’, ‘Follow-on Delivery Order Following Competitive Initial Order’, ‘Minimum Guarantee’, ‘Other Statutory Authority’|	1. This required field should be validated 

Note: Both foja & stauth values will be given under stauth in legacy	|1. This opportunity cannot be published. Authority is required
-awdnbr	|Yes|	255 characters|	1. This required field should be validated	|1. Award Details Section - Contract Award Number is a required field
+awdnbr	|Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated	|1. Award Details Section - Contract Award Number is a required field
 modnbr|	No	|32 characters|	NA|	NA
 awddate	|No – May change in future|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions| 	1.	DATE field in unexpected format. Expects YYYYMMDD
-awdamt|	No|	64 characters|	NA|	NA
+awdamt|	No|	64 digits|	NA|	NA
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions 

2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be published. Archive date provided is in the past.
 contact|	Yes |	255 characters Default value: Primary 

Other types: Secondary, Owner	|1. This required field should be validated|	1. Primary Contact is Required
 desc|	No|	65535 characters|	NA	|NA
@@ -4274,17 +4273,17 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No	|YYYYMMDD|	1. If this field is given, then this field should meet the character limit/restrictions |1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No|	5 digits|	NA|	NA
+zip	|No|	5 digits. This field has been deprecated|	NA|	NA
 classcod|	No|	Valid classification code (FAR, Section 5.207(g))|	1. If a wrong classification code is given, then the service throws an error | 1. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	| No|	Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No	|65535 characters|	NA|	NA
+offadd|	No	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 officeid	|Yes	|20 characters	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes|	256 characters|	1. This required field should be validated	| 1. title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error

 3. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

3. Opportunity not found with given solicitation number and ntype
 ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation|	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error  | 	1. Invalid NTYPE value provided.
-awdnbr|	Yes|	Valid numbers|	1. This required field should be validated 

2. If an invalid number is given (e.g with special characters), then service throws an error|	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
-awdamt|	Yes|	Valid integer values| 	1. This required field should be validated

 2. If an invalid integer values is given, then service throws an error 	|1. Award Details Section - Amount is a required field

 2. Award Details Section - Please enter valid integer for Amount Field
-linenbr	|No|	255 characters|	NA|	NA
+awdnbr|	Yes|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated 

2. If an invalid number is given (e.g with special characters), then service throws an error|	1. Award Details Section - Contract Award Number is a required field

 2. Award Details Section - Contract Award Number - Please enter a valid number
+awdamt|	Yes|	64 digits| 	1. This required field should be validated

 2. If an invalid integer values is given, then service throws an error 	|1. Award Details Section - Amount is a required field

 2. Award Details Section - Please enter valid integer for Amount Field
+linenbr	|No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	NA|	NA
 awddate	|Yes|	YYYYMMDD	|1. This required field should be validated

  2. If this field is given, then this field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future	|1. Award Details Section - Contract Award Date is required field

 2. DATE field in unexpected format. Expects YYYYMMDD
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be published. Archive date provided is in the past
 awardee|	Yes|	65535 characters|	1. This required field should be validated	|1. Award Details Section - Contractor Awarded Name is a required field
@@ -4333,10 +4332,10 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
+zip|	No|	5 digits. This field has been deprecated|	NA|	NA
 classcod	|No|	Valid classification code (FAR, Section 5.207(g))|	1. This field does not take invalid codes	|1. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics|	No|	Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No|	65535 characters|	NA	|NA
+offadd|	No|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA	|NA
 officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required 

2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|Yes|	256 characters|	1. This required field should be validated	|1. title: is missing but it is required
 solnbr|	No	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}. Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required|	1. This required field should be validated

  2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
@@ -4356,11 +4355,11 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD|	1. This field should meet the character limit/restrictions 

Note: Date field allows current date and also any date in past/future	|1. DATE field in unexpected format. Expects YYYYMMDD
-zip	|No	|5 digits|	NA|	NA
+zip	|No	|5 digits. This field has been deprecated|	NA|	NA
 classcod	|Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated

 2. If a wrong classification code is given, then the service throws an error | 1. Product Service Code is a required field  

2. Classification Code provided did not match expected codes
 naics	|Yes |Valid NAICS Code  NAICS Reference|	1. This required field should be validated |1. NAICS code is required
 officeid	|Yes|	20 characters|	1. This field is required

 2. If an invalid officeid is given, then service throws an error

  3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account	|1.   Invalid officeid provided

 2.   Insufficient privileges to create opportunity.
-offadd|	No|	65535 characters|	NA|	NA
+offadd|	No|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 subject	|Yes|	256 characters|	1. This required field should be validated|	1. title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1. This required field should be validated

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If a space is given along with numbers in this field, then service throws an error	|1.   Notice ID is a required field 

2. Notice ID must be unique based on selected notice type 

3. Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces
 respdate|	Yes	|YYYYMMDD	|1.	This required field should be validated

 2.	This field should meet the character limit/restrictions

 3.	This date cannot be in past; has to be in future 

4.	When giving future date, response date cannot exceed 5 years from the current date.|	1.	Response date is required

  2.    DATE field in unexpected format. Expects YYYYMMDD  

3.	Response Date cannot be in the past

 4.	Response Date cannot exceed 5 years from current date
@@ -4385,10 +4384,10 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	No|	YYYYMMDD	|1. This field should meet the character limit/restrictions Note: Date field allows current date and also any date in past/future|	1. DATE field in unexpected format. Expects YYYYMMDD
-zip|	No|	5 digits|	NA|	NA
+zip|	No|	5 digits. This field has been deprecated|	NA|	NA
 classcod|	Yes|	Valid classification code (FAR, Section 5.207(g))|	1. This required field should be validated 

2. If a wrong classification code is given, then the service throws an error  |1. PSC code is required 

2. This opportunity cannot be published. Classification Code provided did not match expected codes
 naics	|No	|Valid NAICS Code  NAICS Reference|	NA|	NA
-offadd|	No|	65535 characters|	NA|	NA
+offadd|	No|	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy|	NA|	NA
 officeid|	Yes	|20 characters|	1. This field is required 

2. If an invalid officeid is given, then service throws an error

 3. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 4. Officeid must be associated with user account|	1. Contracting Office is required

 2. Invalid officeid provided 

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue
 subject|	Yes	|256 characters	|1. This required field should be validated	|1. title: is missing but it is required
 solnbr	|Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}

 Note for statutory authority FAR 6.302- 1(c) - Brand name, this is required	|1. This required field should be validated

 2. If a space is given along with numbers in this field, then service throws an error |1. Notice Id is required 

2. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
@@ -4408,7 +4407,7 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 solnbr|	Yes if non-award|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }| 1. This required field should be validated. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-awdnbr|	Yes if award|	255 characters| If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required for Award Notice
+awdnbr|	Yes if award|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }| If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required for Award Notice
 ntype|No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |	1. If an invalid ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
 deletetype|	no|	Valid values: “notice” to delete the notice, “attachment” to delete attachments and links from the notice|	1. If an invalid deletetype is provided, then service throws an error  |	Delete type provided is not “notice” or “attachment”
 deletemethod|	no|	Valid Values: “all” to delete all versions or “latest” to delete latest version	|1. If an invalid deletemethod is provided, then service throws an error  |	Delete method provided is not “latest” or “all”
@@ -4423,7 +4422,7 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 date|	No|	YYYYMMDD|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 solnbr|	Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice not found for correction

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 officeid	|No|	20 characters|	Officeid must be associated with user account	|NA
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If an invalid ntype is provided, then service throws an error

    2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction
+ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |	1. If an invalid ntype is provided, then service throws an error

    2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
 
 #### unarchiveNotice
@@ -4436,8 +4435,8 @@ Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Erro
 ------ | ------- | ------- | ------- | --------
 solnbr|	Yes|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction
 officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
-ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
-awdnbr	|No|	255 characters|	NA|	NA
+ntype|	No|	Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
+awdnbr	|No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	NA|	NA
 archdate|	Yes|	YYYYMMDD|	1. This required field should be validated  

2. If this value is available, this field should meet the character limit/restrictions 

3.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	New archive date provided is in the past

 3.	$.reason: null found, string expected. Unable to process request. Please try again
 
 #### cancelNotice
@@ -4452,8 +4451,8 @@ date|	No|	YYYYMMDD	|Date field should meet the expected format	|DATE field in un
 officeid|	No	|20 characters|	Officeid must be associated with user account	|NA
 subject|	No|	256 characters|	NA|	NA
 solnbr|	Yes	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }	|1a. This required field if not given, service throws an error

 1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If valid solnbr is given with a different ntype, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple Notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-ntype	|No	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
-awdnbr|	No|	255 characters|	NA|	NA
+ntype	|No	|Valid values: "PRESOL" - for Presolicitation, "COMBINE" - for Combined Synopsis/Solicitation, "SRCSGT" - for Sources Sought, "SSALE" - for Sale of Surplus Property, "SNOTE" - for Special Notice, “JA” – For Justification, “ITB” – for Intent to Bundle Requirements (DoD- Funded), "SOL" - for Solicitation, "AWARD" - for Award |	1. If all the required field is given and this field is not given OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
+awdnbr|	No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	NA|	NA
 archdate|	No|	YYYYMMDD|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be cancelled
 contact|	No|	255 characters Default value: Primary 

Other types: Secondary, Owner| NA| NA
 desc|	Yes|	65535 characters|	1. This required field should be validated |	1. Unable to process request. Please try again
@@ -4477,8 +4476,8 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| Required |	Character Limit / Restrictions |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 notice_type	|No|	Solicitation type 

  Valid Values: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL

   Note: Searches for awards, ja and itb’s will return both standalone notices AND base notices that contain one of these type	|Notice_type if given should be valid |	Notice Type is not recognized

 Expects one of the following: PRESOL, COMBINE, AWARD, JA, SRCSGT, SSALE, SNOTE,  ITB
-solnbr|	No|	Solicitation #|	NA|	NA
-awdnbr|	No|	Award #|	NA|	NA
+solnbr|	No|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	NA|	NA
+awdnbr|	No|	255 characters from the set: a-z A-Z 0-9 - _ ( ) { }|	NA|	NA
 posted_from	|No	|Posted From Date. YYYYMMDD|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
 posted_to|	No	|Posted To Date. YYYYMMDD	|Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 documents_to_search|	No	|Valid Values: ‘active’ or ‘archived’. Default is ALL if nothing provided|	NA|	NA

From d09add7feb4873257be90fa0be72fc857da43c81 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Mon, 28 Oct 2019 19:00:08 -0400
Subject: [PATCH 064/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 225 ++++++++++++++---------------
 1 file changed, 112 insertions(+), 113 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 73640cb68..a33816b5a 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -128,7 +128,7 @@ The Notice Types valid options are:
 
 #### Related Notices
 
-This is a conversion table for notices using submitNotice method.
+This is a conversion table for notices using following functions: submitNotice, submitJA, submitAward, submitITB
 
 ||SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE
 -----|-----|-----|-----|-----|-----|-----|-----|-----|-----|
@@ -191,7 +191,7 @@ offadd |	string |	No |	Office Address (Not used) |	65535 characters
 officeid |	string |	Yes |	Office ID of the office where an opportunity is being submitted |	20 characters
 subject |	string |	Yes |	Subject |	255 characters
 solnbr |	string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	| string |	No |	[Refer Notice Types](#notice-types) |		
+ntype	| string |	No |	 [Refer Related Notices](#related-notices) |		
 awdnbr |String |	 Yes |	Award Number |	255 characters 
 Agency assigned number for control tracking and identification.
 Alphanumeric and - _ ( ) { } characters [no spaces]
 awdamt |	string |	Yes |	Award Amount |	64 characters
 linenbr |	string |	No |	Line Number |	255 characters
@@ -261,7 +261,7 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr |	string |	Yes; Solicitation # or Award # is required |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	No |	[Refer Notice Types](#notice-types) 
+ntype |	string |	No |	 [Refer Related Notices](#related-notices) 
 awdnbr |  string | Yes; Solicitation # or Award # is required| Award # |	255 characters
 deletetype |	string |	No |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
@@ -288,7 +288,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date | YYYYMMDD
 solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string | No |	[Refer Notice Types](#notice-types)
+ntype |	string | No |	 [Refer Related Notices](#related-notices)
 archdate | date |	No | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
 officeid | string |	No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 
@@ -317,7 +317,7 @@ offadd | string |	No | Office Address |	65535 characters
 officeid | String | No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	string | No |	Subject |	255 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype | string | No |	[Refer Notice Types](#notice-types) | 
+ntype | string | No |	 [Refer Related Notices](#related-notices) | 
 awdnbr | string |	No | Award # |255 characters
 archdate | date |	No | Archive Date | YYYYMMDD
 contact | string | Yes | Contact Info | 65535 characters
@@ -353,8 +353,8 @@ officeid | string |	Yes |	Office ID of the office where an opportunity is being
 offadd | string |	No | Office Address (Not Used) |	65535 characters
 subject |	string | Yes|	Title of the Pre-solicitation |	255 characters
 solnbr | string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-respdate | date |	Yes - either respdate or archdate is required |	Response Date |	YYYYMMDD
-archdate | date |	Yes - either respdate or archdate is required |	Archive Date | YYYYMMDD
+respdate | date |	No - either respdate or archdate is required |	Response Date |	YYYYMMDD
+archdate | date |	No - either respdate or archdate is required |	Archive Date | YYYYMMDD
 contact |	string | Yes |	Contact Info | 65535 characters
 desc |string |Yes |	Description | 65535 characters
 link | GovURL – complex type | No |	Government Link has URL & description |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -496,8 +496,8 @@ offadd |	string	| No	| Office Address (Not Used)|	65535 characters
 subject	| string	| Yes |	Subject |	255 characters
 solnbr | string |	Yes, EXCEPT No - Only for SNOTE | 	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype |	string |	Yes |	 Notice Type |	Valid values: PRESOL, COMBINE, SRCSGT, SSALE, SNOTE, SOL
-respdate |	date |	Yes – for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL |	Response Date |	YYYYMMDD
-archdate |	date |	Yes	| Archive Date |	YYYYMMDD
+respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL	|Response Date	|YYYYMMDD
+archdate  |	date|	No - Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
 contact |	string |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL |	Contact Info |	65535 characters
 desc |	string |	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE	| Description |	65535 characters
 link	| GovURL – complex type |	No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -567,14 +567,14 @@ offadd |	String	| No |	Office Address	| 65535 characters
 officeid |	String |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	String |	Yes |	Subject |	255 characters
 solnbr	| String |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	| string |	No	| Notice Type   | 	Valid Value: JA
+ntype	| string |	No	| [Refer Related Notices](#related-notices)  | 	
 stauth	| String	| Yes |	J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy |	[Refer Stauth Valid Values](#stauth-valid-values)
 awdnbr |	String |	Yes |	Award Number |	255 characters
 modnbr |	String |	No |	Mod Number |	32 characters
 awdamt |	String |	No |	Award Amount |	64 characters
 awddate |	Date |	No	| Award Date |	YYYYMMDD
 donbr	| String |	Yes |	Task/Delivery Order Number |	255 characters from the set: a-z A-Z 0-9 - _ ( )
-archdate  |	Date |	Yes |	Archive Date |	YYYYMMDD
+archdate  |	Date |	No |	Archive Date |	YYYYMMDD
 contact |	String |	Yes | 	Contact Info |	65535 characters
 desc |	String |	No |	Description	| 65535 characters
 link |	GovURL |	No	| Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -641,8 +641,8 @@ officeid |	string |	Yes |	Office ID of the office where an opportunity is being
 offadd	| string	 | No |	Office Address |	65535 characters
 subject |	string |	Yes |	Subject |	255 characters
 solnbr	| string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-respdate |	date |	Yes - either respdate or archdate is required |	Response Date |	YYYYMMDD
-archdate |	date |	Yes - either respdate or archdate is required |	Archive Date	| YYYYMMDD
+respdate |	date |	No - either respdate or archdate is required |	Response Date |	YYYYMMDD
+archdate |	date |	No - either respdate or archdate is required |	Archive Date	| YYYYMMDD
 contact	| string	| Yes |	Contact Info	| 65535 characters
 desc | string |	Yes |	Description |	65535 characters
 link |	GovURL – complex type |	No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -919,10 +919,10 @@ officeid|	String|	Yes|	Office ID of the office where an opportunity is being sub
 offadd|	String	|No|	Office Address|	65535 characters
 subject|	String|	Yes|	Subject	|255 characters
 solnbr	|String	|Yes|	Solicitation #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	|string	|No|	[Refer Notice Types](#notice-types)
+ntype	|string	|No|	 [Refer Related Notices](#related-notices)
 awdnbr|	String	|Yes	|Award Number|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 donbr|	String|	No	|Task/Delivery Order Number	|255 characters from the set: a-z A-Z 0-9 - _ ( )
-archdate 	|Date	|Yes	|Archive Date|	YYYYMMDD
+archdate 	|Date	|No	|Archive Date|	YYYYMMDD
 contact|	String|	Yes|	Contact Info	|65535 characters; Default value = Primary, Other types are: Secondary, Owner
 desc	|String	|Yes	|Description|	65535 characters
 link|	GovURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -984,7 +984,7 @@ Complete notice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date|	date|	No	|Posting Date|	YYYYMMDD
-notice_type	|string	|Yes|	[Refer Notice Types](#notice-types)	|
+notice_type	|string	|Yes|	 [Refer Notice Types](#notice-types)	|
 zip	|string	|No	|Zip Code|	5 digits
 classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA  |	Class-Code	|Valid classification code (FAR, Section 5.207(g))
 naics	|string	|Yes - for COMBINE, SOL	|NAICS Code|	Valid NAICS Code  
NAICS Reference
@@ -992,7 +992,7 @@ officeid|	String|	Yes|	Office ID of the office where an opportunity is being sub
 offadd	|string|	No|	Office Address (Not Used)	|65535 characters
 subject|	string|	Yes|	Subject|	255 characters
 solnbr|	string|	Yes, EXCEPT No - Only for SNOTE|	Solicitation #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|string	|No	|[Refer Notice Types](#notice-types)
+ntype	|string	|No	| [Refer Related Notices](#related-notices)
 awdnbr|	string|	Yes - for AWARD, ITB & JA |	Award #	|255 characters
 donbr	|string	|Yes - for JA|	Delivery/Task Order Number	|255 characters
 awdamt	|string|	Yes - for AWARD 	|Award Amount|	64 characters
@@ -1000,7 +1000,7 @@ linenbr|	string	|No|	Award Line Item Number	|255 characters
 awddate	|date|	Yes - for AWARD|	Award Date	|YYYYMMDD
 stauth	|string	|Yes - for JA 	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| [Refer Stauth Valid Values](#stauth-valid-values)
 respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL	|Response Date	|YYYYMMDD
-archdate  |	date|	Yes|	Archive Date|	YYYYMMDD
+archdate  |	date|	No - Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
 awardee|	string|	Yes – for AWARD |	Awardee	|65535 characters
 awardee_duns|	string	|No	|Awardee DUNS	|9 digits with optional plus 4
 contact|	string|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL|	Contact Info|	65535 characters
@@ -1067,7 +1067,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 Date|	Date|	No	|Posting Date	|YYYYMMDD
 solnbr	|String	|No|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|String	|No|	[Refer Notice Types](#notice-types)
+ntype	|String	|No|	 [Refer Related Notices](#related-notices)
 uploadtype|	String|	No |	Upload Type|	A for amendment, S for solicitation or any title for other; 255 characters
 respdate	|Date	|No |Response Date|	YYYYMMDD
 links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
@@ -1110,7 +1110,7 @@ UnarchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	|[Refer Notice Types](#notice-types)
+ntype	|string	|No	| [Refer Related Notices](#related-notices)
 awdnbr	|string|	No|	Award #|	255 characters
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
 
@@ -1175,7 +1175,7 @@ IVLListRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #
-ntype	|string	|No	|[Refer Notice Types](#notice-types)
+ntype	|string	|No	| [Refer Related Notices](#related-notices)
 
 IVLListResponse Complex Type Definition:
 
@@ -1220,7 +1220,7 @@ AuthorizedPartyListRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes	|Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below
-ntype|	string|	No|	[Refer Notice Types](#notice-types)
+ntype|	string|	No|	 [Refer Related Notices](#related-notices)
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #. Not supported for this method
 status| string	|No	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests.
 
@@ -1264,7 +1264,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation #
-ntype	|string	|No|	[Refer Notice Types](#notice-types)
+ntype	|string	|No|	 [Refer Related Notices](#related-notices)
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
 
@@ -1290,7 +1290,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name	|Type	|Required|	Description
 -----|-----|-----|----
 solnbr	|string	|Yes|	Solicitation #
-ntype|	string|	No|	[Refer Notice Types](#notice-types)
+ntype|	string|	No|	 [Refer Related Notices](#related-notices)
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method
 vendor|	VendorData	|Yes|	Complex type defined below
 
@@ -1327,7 +1327,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation #
-ntype	|string	|No|[Refer Notice Types](#notice-types)
+ntype	|string	|No| [Refer Related Notices](#related-notices)
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.
 reason	|string|	Yes|	rejection reason not used in this method
@@ -1354,7 +1354,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #
-ntype	|string	|No|	[Refer Notice Types](#notice-types)
+ntype	|string	|No|	 [Refer Related Notices](#related-notices)
 nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method
 vendor	|VendorData|	Yes|	Complex type defined below
 reason|	string|	Yes	|Rejection Reason 
@@ -1390,7 +1390,7 @@ ExplicitAccessRequest Complex Type Definition:
 Element Name | Type | Required | Description
 ------ | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #
-ntype	|string	|No	|[Refer Notice Types](#notice-types)
+ntype	|string	|No	| [Refer Related Notices](#related-notices)
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.
 Id	|string	|No	|Not used in this method
 vendor	|VendorData|	Yes|	Complex type defined below
@@ -1428,7 +1428,7 @@ NoticeListRequest Complex Type Definition:
 
 Element Name|	Type|	Required|	Description
 -----|-----|-----|-----
-notice_type	|string|	No (at least 1 field is required)|	[Refer Notice Types](#notice-types)  Note:Searches for award, j&a, itb and fairopps will return both standalone notices AND base notices that contain one of these type
+notice_type	|string|	No (at least 1 field is required)|	 [Refer Notice Types](#notice-types)(#related-notices)  Note:Searches for award, j&a, itb and fairopps will return both standalone notices AND base notices that contain one of these type
 solnbr	|string	|No (at least 1 field is required)	|Solicitation #
 awdnbr	|string	|No	(at least 1 field is required)|Award #
 posted_from	|date|	No (at least 1 field is required)|	Posted From Date. YYYYMMDD.
@@ -2127,77 +2127,76 @@ Please note that variances may exist between SOAP requests generated by differen
     Response Sample – Success
 
 
 
@@ -4078,7 +4077,7 @@ Note:
 
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | -------
 date 	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	1. DATE field in unexpected format. Expects YYYYMMDD
 notice_type	|	1. This field is required where applicable |	1. Opportunity type is required
 zip|	NA |NA
@@ -4123,7 +4122,7 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: When links/files are given but none of the other fields are given, then service throws an error - Multiple Notices found. Please input more details
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | -------
 date|		Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 officeid|		1. If an invalid officeid is given, then service throws an error

 2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 3. Office ID must be associated with user account	|1. Invalid officeid provided

 2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 solnbr|1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
@@ -4140,7 +4139,7 @@ files	|	1.	This field is not required but if url & description fields within the
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 awdnbr|	 If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required
 ntype|	1. If an invalid ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
@@ -4153,7 +4152,7 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: : If a user tries to archive a notice that is already archived, then the service throws an error -  Opportunity already archived
 
 Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 date|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 solnbr|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice not found for correction

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
 officeid	|	Office ID must be associated with user account	|NA
@@ -4167,7 +4166,7 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: If a user tries to unarchive an active notice, then the service throws an error - Opportunity is active
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction
 officeid|	Office ID must be associated with user account	|NA
 ntype|		1. If field is not provided OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
@@ -4181,7 +4180,7 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: -	When user tries to cancel a notice without giving any input, then the service throws an error ‘Unable to process request. Please try again’
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 date|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 officeid|	Office ID must be associated with user account	|NA
 subject|		NA|	NA
@@ -4197,7 +4196,7 @@ desc|	1. This field is required where applicable |	1. Unable to process request.
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 notice_id	|	notice_id is required|	notice_id from getList is required
 Get_changes|		NA|	NA
 get_changes_from_date|		Date field should meet the expected format.|	DATE field in unexpected format. Expects YYYYMMDD
@@ -4209,7 +4208,7 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: Although none of the individual elements are mandatory, at least one filter should be given to perform the operation. If no filters are entered, then system throws an error - Insufficient Search Criteria.
 
 Element Name	 |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 notice_type	 |	

 Valid Notice Type must be provided | Notice Type is not recognized
 solnbr|	NA|	NA
 awdnbr|		NA|	NA
@@ -4223,7 +4222,7 @@ Individual business rules per field are listed across each of the fields in belo
 * Note: If a wrong combination of file_id and notice_id is given, then the service throws a success message without any data.
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 file_id	|1. This field is required where applicable 
 2. If an invalid file Id is provided, then the system throws an error.|	1. file_id is required 
 2.	File Id not found. Please enter a valid Id.
 
 #### getIVLListResponse
@@ -4231,7 +4230,7 @@ file_id	|1. This field is required where applicable 
 2. If an invalid file I
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr|		1. If an incorrect solicitation number and ntype combination is given, the service throws an error

   2a. If this required field if not given, service throws an error 

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found 

2a. Notice not found

 2b. Multiple Notices found. Please input more details
 ntype|	NA	|NA
 
@@ -4240,7 +4239,7 @@ ntype|	NA	|NA
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
 ntype|		If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together 

2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
@@ -4253,7 +4252,7 @@ Individual business rules per field are listed across each of the fields in belo
 ID can be obtained through getAuthorizedPartyList   
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4. Multiple notices found. Please input more details
 ntype	|If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
@@ -4267,7 +4266,7 @@ Vendor can be obtained through getAuthorizedPartyList
 
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
 ntype	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
@@ -4278,7 +4277,7 @@ vendor	|1.	If all the elements in the Vendor Data complex definition are not pro
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
 ntype|	If an invalid ntype is provided, then service throws an error |  1. NTYPE value provided is not valid
 nonfbo_solbr 	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
@@ -4289,7 +4288,7 @@ vendor|		1.	If all the elements in the Vendor Data complex definition are not pr
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	 |	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error|	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 
 4. Multiple notices found. Please input more details
 ntype|	1.	If an invalid ntype is provided, then service throws an error   |	1. NTYPE value provided is not valid
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
@@ -4300,7 +4299,7 @@ reason|  1.	This is a required field. If no value is provided, then the system t
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
------- | ------- | ------- 
+------ | ------- | ------- | ------- | --------
 solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
 ntype		|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations

From 7ebf6514e9dae1047b622e53c5416fe6cf00036f Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 03:24:50 -0400
Subject: [PATCH 065/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index d08910291..7eb0f06c0 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4209,7 +4209,7 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	 |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-notice_type	 |	

 Valid Notice Type must be provided | Notice Type is not recognized
+notice_type	 |	 Valid Notice Type must be provided | Notice Type is not recognized
 solnbr|	NA|	NA
 awdnbr|		NA|	NA
 posted_from	|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD

From 4860d50b159493b1a9bfd8d68907029d95de2360 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 03:34:00 -0400
Subject: [PATCH 066/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 7eb0f06c0..0eb11b6fe 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -1429,7 +1429,7 @@ NoticeListRequest Complex Type Definition:
 Element Name|	Type|	Required|	Description | Character Limit / Restrictions
 -----|-----|-----|-----|-----
 notice_type	|string|	No (at least 1 field is required)|	 [Refer Notice Types](#notice-types)(#related-notices)  Note:Searches for award, j&a, itb and fairopps will return both standalone notices AND base notices that contain one of these type
-solnbr	|string	|No (at least 1 field is required)	|Solicitation #|| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
+solnbr	|string	|No (at least 1 field is required)	|Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 awdnbr	|string	|No	(at least 1 field is required)|Award # | 255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 posted_from	|date|	No (at least 1 field is required)|	Posted From Date. YYYYMMDD.
 posted_to	|date|	No (at least 1 field is required)|	Posted To Date. YYYYMMDD

From b934fd7def8a4dad357dc5ad721b86d91b4cae8b Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 03:35:29 -0400
Subject: [PATCH 067/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 0eb11b6fe..594a7197b 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4106,7 +4106,7 @@ links|	1. This field is not required but if url & description fields within the
 files|	1. This field is not required but if url & description fields within the links and files are empty, then the service throws an error	|1. Links and/or files are not complete
 setaside|	NA	|NA
 popaddress|	This is a free Text. No validation is performed on this field	 | NA
-popzip	|No	|5 digits|	NA|	NA
+popzip	|No	|5 digits
 popcountry|	 No|	1. Award Details Section - Country is a required field
 city	|NA|	NA
 state	|	NA|	NA

From 43ba7c32cffe5f86a988ffbca7c0ee2f7d655101 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Tue, 29 Oct 2019 06:39:30 -0400
Subject: [PATCH 068/149] resolving the issues with code merge

---
 _apidocs/opportunities-api.md      | 253 ++++++++++++++++++++++++++++-
 _apidocs/opportunities-soap-api.md | 109 ++++++-------
 2 files changed, 299 insertions(+), 63 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 0bcdbbf28..66b73348d 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -441,7 +441,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-Request JSON | Body | JSON | Yes | [Refer Publish Draft Opportunity Contract JSON](#publish-json)
+Request JSON | Body | JSON | Yes | [Refer Publish Draft Opportunity Contract JSON](#publish-opportunity-contract-json)
 
 
Back to top

 
@@ -483,7 +483,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 ---------------|----------------|------------|----------|------------
 Authorization | header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
-Request JSON | Body | JSON | Yes | [Refer Create and Update Opportunity Contract JSON](#create-and-update-opportunity-contract-json)
+Request JSON | Body | JSON | Yes | [Refer Create and Publish Opportunity Contract JSON](#create-and-publish-opportunity-contract-json)
 
 
Back to top

 
@@ -2849,12 +2849,6 @@ description | JSON | NA | NA | NA | NA |
 description.body | string | 65535 characters| | No | Yes | Description of the notice
 related | JSON | NA | NA | NA | NA | Related Notice information
 related.opportunityId | string | 32 characters| | No | No | Opportunity Id of the related notice
-resources | JSON |NA | NA | NA | NA |
-resources.attType | string | |link, file | No |No| Type of attachment, either link or file
-resources.content | byte |250MB |  | No|No | File content in base64 format
-resources.link | string | 255 characters | |No|No | Resource link URL
-resources.packageAccessLevel | string | | public,private(default public) | No | No| Type of access to file or link
-resources.resourceName | string | 255 characters |  | No|No | Name of file
 
 
Back to top

 
@@ -2883,6 +2877,249 @@ reason | string |  | No | Publish reason
 
 
Back to top

 
+### Create and Publish Opportunity Contract JSON
+
+
+

+

+Create_Publish_Opportunity_Contract_Json
+

+
+{
+    "data":
+    {
+        "type": "",
+        "solicitationNumber": "",
+        "title": "",
+        "organizationId": "",
+        "organizationLocationId": "",
+        "classificationCode": "",
+        "naics": [
+        {
+            "type": "primary",
+            "code": [""]
+        }],
+        "flags": [
+        {
+            "code": "",
+            "isSelected": true
+        }],
+        "pointOfContact": [
+        {
+            "type": "primary",
+            "title": "",
+            "fullName": "",
+            "email": "",
+            "phone": "",
+            "fax": "",
+            "additionalInfo":
+            {
+                "content": ""
+            }
+        }],
+        "placeOfPerformance":
+        {
+            "streetAddress": "",
+            "streetAddress2": "",
+            "city":
+            {
+                "code": "",
+                "name": ""
+            },
+            "country":
+            {
+                "code": "",
+                "name": ""
+            },
+            "state":
+            {
+                "code": "",
+                "name": ""
+            },
+            "zip": ""
+        },
+        "archive":
+        {
+            "type": "autocustom",
+            "date": "2019-09-09"
+        },
+        "permissions":
+        {
+            "IVL":
+            {
+                "create": false,
+                "delete": false,
+                "read": false,
+                "update": false
+            }
+        },
+        "solicitation":
+        {
+            "setAside": "SBA",
+            "deadlines":
+            {
+                "response": "2019-08-08"
+            }
+        },
+        "award":
+        {
+            "date": "",
+            "number": "",
+            "deliveryOrderNumber": "",
+            "amount": "",
+            "lineItemNumber": "",
+            "awardee":
+            {
+                "manual": false,
+                "name": "",
+                "duns": "",
+                "location":
+                {
+                    "streetAddress": "",
+                    "streetAddress2": "",
+                    "city":
+                    {
+                        "code": "",
+                        "name": ""
+                    },
+                    "state":
+                    {
+                        "code": "",
+                        "name": ""
+                    },
+                    "zip": "",
+                    "country":
+                    {
+                        "code": "",
+                        "name": ""
+                    }
+                }
+            }
+            },
+            "justificationAuthority":
+            {
+                "modificationNumber": "",
+                "authority": "dictionary"
+            },
+            "link":
+            {
+                "additionalInfo":
+                {
+                    "content": ""
+                },
+                "href": ""
+            },
+            "additionalReporting": ["none"]
+        },
+        "description": [
+        {
+            "body": ""
+        }],
+        "related":
+        {
+            "opportunityId": ""
+        }
+    }
+

+

+

+

+
+* Field headers in the table must match with field headers shown in JSON example  
+
+Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (to Publish) | Description
+-----|-----------|-------|-------------------|------------|------------ |----------
+type | string | 1 character| See Notice Types table | Yes | Yes | Notice Type
+solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number
+title | string | 256 characters | |Yes | Yes | Title of the Opportunity
+organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
+organizationLocationId | string | | | No|No| This field has been deprecated.Organization Location details will be pulled from the Federal Hierarchy 
+classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
+naics | JSON Array | NA |NA | NA | NA |
+naics.code | Array of String | | | No | Yes | Valid NAICS Code
+naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
+flags | JSON Array| NA |NA | NA | NA |
+flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
+flags.IsSelected | boolean | |default is 'True' | No | No |
+pointOfContact | JSON Array | NA |NA | NA | NA |
+pointOfContact.type | string | | primary, secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
+pointOfContact.title | string | |  | No | No | Contact title
+pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
+pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
+pointOfContact.phone | string |255 characters | | No | No | Contact Phone
+pointOfContact.fax | string | 255 characters | | No  | No | Contact Fax
+pointOfContact.additionalInfo | JSON |NA |NA | NA  | NA |  Any additional information on Point of Contact
+pointOfContact.additionalInfo.content | String | | | No  | No | Details of the additional information on Point of Contact 
+placeOfPerformance | JSON | NA | NA | NA | NA |
+placeOfPerformance.
streetAddess | string | | | No | No | Pop Address
+placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2
+placeOfPerformance.city | JSON | NA | NA | NA | NA | Pop City
+placeOfPerformance.city.
code | string | | | No | No | Pop City code
+placeOfPerformance.city.
name | string | | | No | No | Pop City name
+placeOfPerformance.state | JSON |NA | NA | NA | NA | Pop City state
+placeOfPerformance.state.
code | string | | | No | No | Pop city state code
+placeOfPerformance.state.
name | string | | | No | No | Pop city state name
+placeOfPerformance.country | JSON | NA | NA | NA | NA | Pop Country
+placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
+placeOfPerformance.
country.name | string | | | No | No | Pop Country name
+placeOfPerformance.zip | string | | | No | No | Pop Country zip
+archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
+archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date. This date will indicate when a notice will be moved to the inactive status. This date must be in the future
+permissions | JSON | NA | NA | NA | NA |
+permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
+permissions.ivl.create | boolean | | | No | No | IVL create permission
+permissions.ivl.read | boolean | | | No | No | IVL read permission
+permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | IVL update permission
+permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | IVL delete permission
+solicitation | JSON |NA | NA | NA | NA |
+solicitation.setAside | string | |See Set-Aside values table | No | No | Set-Aside code. The designator for type of set aside determined for the contract action
+solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
+solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
+solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
+award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for  'Award Notice' and 'Justification' opportunity types
+award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date
+award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number
+award.deliverOrderNumber | string | 255 characters| | No | No | Award Delivery Order Number
+award.amount | number |64 digits |  | No | No | Award Amount
+award.lineitemNumber | string |255 characters | | No | No | Contract Line item Number
+award.awardee | JSON | NA| NA | NA | NA |Awardee details
+award.awardee.name | string | 255 characters | | No | No | Awardee Name
+award.awardee.duns | string | 9 digits | | No | No | Awardee Duns
+award.awardee.location | JSON |NA | NA | NA | NA | Awardee Location details
+award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 
+award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 2
+award.awardee.location.
city | JSON |NA |NA |NA | NA | Awardee City details
+award.awardee.location.
city.code | string | | | No | No | Awardee City code
+award.awardee.location.
city.name | string | | | No | No | Awardee City name
+award.awardee.location.
state | JSON | NA | NA | NA | NA | Awardee State details
+award.awardee.location.
state.code | string | | | No | No | Awardee State code
+award.awardee.location.
state.name | string | | | No | No | Awardee State name
+award.awardee.location.
country | JSON | NA| NA | NA | NA |Awardee Country details
+award.awardee.location.
country.code | string | | | No | No | Awardee Country code
+award.awardee.location.
country.name | string | | | No | No | Awardee Country Name
+award.awardee.location.
zip | string | | | No | No | Awardee Country Zip code
+justificationAuthority | JSON |NA |NA | NA | NA |
+justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
+justificationAuthority.
authority | string|  |  | No | No | Justification Authority
+link | JSON | NA |NA | NA | NA |
+link.href | string | | | No | No | Url for the notice on SAM.gov
+link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
+link.additionalInfo.content | string | | | No | No | Additional information details
+additionalReporting | string | |none/
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
+description | JSON | NA | NA | NA | NA |
+description.body | string | 65535 characters| | No | Yes | Description of the notice
+related | JSON | NA | NA | NA | NA | Related Notice information
+related.opportunityId | string | 32 characters| | No | No | Opportunity Id of the related notice
+resources | JSON |NA | NA | NA | NA |
+resources.attType | string | |link, file | No |No| Type of attachment, either link or file
+resources.content | byte |250MB |  | No|No | File content in base64 format
+resources.link | string | 255 characters | |No|No | Resource link URL
+resources.packageAccessLevel | string | | public,private(default public) | No | No| Type of access to file
+resources.resourceName | string | 255 characters |  | No|No | Name of file
+
+
Back to top

+
 ### Revise Opportunity Contract JSON
 
 

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 594a7197b..5e278ccb0 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -184,24 +184,24 @@ Award Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	Yes |	Posting Date |	YYYYMMDD
-zip |	string |	No |	Zip Code |	5 digits
+zip |	string |	No |	Zip Code (Deprecated) |	5 digits
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g)) 
 naics |	string |	No |	NAICS Code |	Valid NAICS Code 
NAICS Reference
-offadd |	string |	No |	Office Address (Not used) |	65535 characters 
+offadd |	string |	No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
 officeid |	string |	Yes |	Office ID of the office where an opportunity is being submitted |	20 characters
 subject |	string |	Yes |	Subject |	256 characters
 solnbr |	string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype	| string |	No |	 [Refer Related Notices](#related-notices) |		
-awdnbr |String |	 Yes |	Award Number |	255 characters 
 Agency assigned number for control tracking and identification.
 Alphanumeric and - _ ( ) { } characters [no spaces]
+awdnbr |String |	 Yes |	Award Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {} 
 awdamt |	string |	Yes |	Award Amount |	64 digits
-linenbr |	string |	No |	Line Number |	255 characters
+linenbr |	string |	No |	Line Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 awddate |	date |	Yes |	Award Date |	YYYYMMDD
 archdate |	date |	No |	Archive Date |	YYYYMMDD
 awardee |	string |	Yes |	Awardee |	255 characters
 awardee_duns |	string |	No |	Awardee DUNS |	9 digits with optional plus 4
 contact |	string |	No |	Contact Info |	255 characters
 desc |	string |	No |	Description |	65535 characters
-link |	GovURL |	No |	Government Link	|255 characters| Consist of a restricted set of characters (see URL specification - RFC 2396)|
+link |	GovURL |	No |	Government Link	|255 characters. Consist of a restricted set of characters (see URL specification - RFC 2396)
 email |	GovEmail |	No |	Government Email |	255 characters
 links |	DocumentLink[] |	No |	Array Of links |
 files |	DocumentFile[] |	No |	Array of files |
@@ -261,8 +261,8 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr |	string |	Yes; Solicitation # or Award # is required |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	No |	 [Refer Related Notices](#related-notices) 
-awdnbr |  string | Yes; Solicitation # or Award # is required| Award # |	255 characters
+ntype |	string |	No | Notice Type	| [Refer Notice Types](#Notice Types) 
+awdnbr |  string | Yes; Solicitation # or Award # is required| Award # |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 deletetype |	string |	No |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
 
@@ -288,7 +288,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date | YYYYMMDD
 solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string | No |	 [Refer Related Notices](#related-notices)
+ntype |	string | No |	Notice Type	| [Refer Notice Types](#Notice Types) 
 archdate | date |	No | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
 officeid | string |	No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 
@@ -300,7 +300,7 @@ Input Parameters:
 
 Input Parameter |	Type |	Description
 ------- | ------ | -------
-data |	CancelNotice | Complex type defined below
+data |	  Notice | Complex type defined below
 
 Response:
 
@@ -313,12 +313,12 @@ CancelNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-offadd | string |	No | Office Address |	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
+offadd | string |	No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
 officeid | String | No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	string | No |	Subject |	256 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype | string | No |	 [Refer Related Notices](#related-notices) | 
-awdnbr | string |	No | Award # |255 characters
+ntype | string | No | Notice Type	| [Refer Notice Types](#Notice Types)  
+awdnbr | string |	No | Award # |255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate | date |	No | Archive Date | YYYYMMDD
 contact | string | Yes | Contact Info | 255 characters
 desc | string | Yes |	Cancellation Description | 65535 characters
@@ -346,12 +346,12 @@ Presol Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-zip |	string | No |	Zip Code | 5 digits. This field has been deprecated
+zip |	string | No |	Zip Code (Deprecated) | 5 digits
 classcod | string |	No |	Class-Code | Valid classification code (FAR, Section 5.207(g))
-naics |	string | No |	NAICS Code | Valid NAICS Code  
NAICS Reference
+naics |	string | No |	NAICS Code | Valid NAICS Code  
NAICS Reference
 officeid | string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
-offadd | string |	No | Office Address (Not Used) |	65535 characters
-subject |	string | Yes|	Title of the Pre-solicitation |	256 characters
+offadd | string |	No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
+subject |	string | Yes|	Subject|	256 characters
 solnbr | string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	No - either respdate or archdate is required |	Response Date |	YYYYMMDD
 archdate | date |	No - either respdate or archdate is required |	Archive Date | YYYYMMDD
@@ -417,12 +417,11 @@ Combined Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-zip |	string | No |	Zip Code | 5 digits. This field has been deprecated
+zip |	string | No |	Zip Code (Deprecated) | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
 officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
-offadd | string | No | Office Address	| 65535 characters
-subject | string | Yes | Subject | 256 characters
+offadd | string | No |Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	| 65535 characters
 solnbr | string |	Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes | Response Date | YYYYMMDD
 archdate | date |	No | Archive Date | YYYYMMDD
@@ -488,11 +487,11 @@ Mod Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	Yes - for AWARD  |	Posting Date |	YYYYMMDD
-zip |	string |	No |	Zip Code |	5 digits
+zip |	string |	No |Zip Code (Deprecated) |	5 digits
 classcod |	string	 | Yes - for SOL, COMBINE, SSALE, ITB, JA   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
 naics | 	string |	Yes - for COMBINE, SOL  | 	NAICS Code |	Valid NAICS Code  
NAICS Reference
 officeid |	string	| Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
-offadd |	string	| No	| Office Address |	65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
+offadd |	string	| No	| Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
 subject	| string	| no |	Subject |	256 characters
 solnbr | string |	Yes, EXCEPT No - Only for SNOTE | 	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype |	string |	Yes |	 Notice Type |	Valid values: PRESOL, COMBINE, SRCSGT, SSALE, SNOTE, SOL
@@ -560,16 +559,16 @@ JA Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | Date	| No |	Posting Date |	YYYYMMDD
-zip |	String |	No	| Zip Code |	5 digits
+zip |	String |	No	| Zip Code (Deprecated) |	5 digits
 classcod	| String |	Yes |	Class-Code |	Valid classification code
 naics	| String |	No	| NAICS Code	| Valid NAICS Code  
NAICS Reference
-offadd |	String	| No |	Office Address	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
+offadd |	String	| No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	|65535 characters
 officeid |	String |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	String |	Yes |	Subject |	256 characters
 solnbr	| String |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype	| string |	No	| [Refer Related Notices](#related-notices)  | 	
 stauth	| String	| Yes |	J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy |	[Refer Stauth Valid Values](#stauth-valid-values)
-awdnbr |	String |	Yes |	Award Number |	255 characters
+awdnbr |	String |	Yes |	Award Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 modnbr |	String |	No |	Mod Number |	32 characters
 awdamt |	String |	No |	Award Amount |	64 digits
 awddate |	Date |	No	| Award Date |	YYYYMMDD
@@ -634,11 +633,11 @@ SourcesSought Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date |	YYYYMMDD
-zip	 | string |	No |	Zip Code |	5 digits. This field has been deprecated
+zip	 | string |	No |	Zip Code (Deprecated) |	5 digits
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
 naics	| string |	No |	NAICS Code |	Valid NAICS Code
NAICS Reference
 officeid |	string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	| 20 characters
-offadd	| string	 | No |	Office Address |	65535 characters
+offadd	| string	 | No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
 subject |	string |	Yes |	Subject |	256 characters
 solnbr	| string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate |	date |	No - either respdate or archdate is required |	Response Date |	YYYYMMDD
@@ -709,11 +708,11 @@ SpecialNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date	| Date |	No	| Posting Date |	YYYYMMDD
-zip |	String |	No	 | Zip Code |	5 digits. This field has been deprecated
+zip |	String |	No	 | Zip Code (Deprecated)|	5 digits
 classcod |	String	| No	| Class-Code | 	Valid classification code (FAR, Section 5.207(g))
 naics |	String |	No	| NAICS Code |	Valid NAICS Code  
NAICS Reference
-officeid	| string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	 | 20 characters
-offadd |	String |	No |	Office Address	| 65535 characters
+officeid	| String |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	 | 20 characters
+offadd |	String |	No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	| 65535 characters
 subject | 	String |	Yes |	Subject |	256 characters
 solnbr	| String |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 archdate |	Date |	Yes |	Archive Date |	YYYYMMDD
@@ -775,11 +774,11 @@ SaleOfSurplus Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date|	No|	Posting Date|	YYYYMMDD
-zip|	string|	No|	Zip Code|	5 digits. This field has been deprecated
+zip|	string|	No|	Zip Code (Deprecated) |	5 digits
 classcod|	string|	Yes	|Class-Code|	Valid classification code (FAR, Section 5.207(g))
-naics|	string|	No|	NAICS Code|	Valid NAICS Code  
NAICS Reference
+naics|	string|	No|	NAICS Code|	Valid NAICS Code  
NAICS Reference
 officeid	|string	|Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
-offadd|	string|	No	|Office Address	|65535 characters
+offadd|	string|	No	|Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	|65535 characters
 subject|	string|	Yes|	Subject	|256 characters
 solnbr|	string	|Yes	|Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 archdate|	date|	Yes|	Archive Date|	YYYYMMDD
@@ -841,11 +840,11 @@ Solicitation Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
-zip |	string | No |	Zip Code | 5 digits. This field has been deprecated
+zip |	string | No |	Zip Code (Deprecated) | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
 officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
-offadd | string | No | Office Address	| 65535 characters
+offadd | string | No | Office Address	| 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject | string | Yes | Subject | 256 characters
 solnbr | string |	Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes  | Response Date | YYYYMMDD
@@ -912,11 +911,11 @@ ITB Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date	|Date	|No	|Posting Date	|YYYYMMDD
-zip	|String|	No|	Zip Code|	5 digits. This field has been deprecated
+zip	|String|	No|	Zip Code (Deprecated)|	5 digits
 classcod|	String|	Yes|	Class-Code|	Valid classification code (FAR, Section 5.207(g))
 naics|	String|	No|	NAICS Code|	Valid NAICS Code 
NAICS Reference
 officeid|	String|	Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account|	20 characters
-offadd|	String	|No|	Office Address|	65535 characters
+offadd|	String	|No|	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy|	65535 characters
 subject|	String|	Yes|	Subject	|256 characters
 solnbr	|String	|Yes|	Solicitation #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype	|string	|No|	 [Refer Related Notices](#related-notices)
@@ -985,18 +984,18 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date|	date|	No	|Posting Date|	YYYYMMDD
 notice_type	|string	|Yes|	 [Refer Notice Types](#notice-types)	|
-zip	|string	|No	|Zip Code|	5 digits. This field has been deprecated
+zip	|string	|No	|Zip Code (Deprecated)|	5 digits
 classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA  |	Class-Code	|Valid classification code (FAR, Section 5.207(g))
-naics	|string	|Yes - for COMBINE, SOL	|NAICS Code|	Valid NAICS Code  
NAICS Reference
+naics	|string	|Yes - for COMBINE, SOL	|NAICS Code|	Valid NAICS Code  
NAICS Reference
 officeid|	String|	Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	|20 characters
-offadd	|string|	No|	Office Address	|65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
-subject|	string|	Yes|	Subject|	255 characters
+offadd	|string|	No|	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	|65535 characters
+subject|	string|	Yes|	Subject|	256 characters
 solnbr|	string|	Yes, EXCEPT No - Only for SNOTE|	Solicitation #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 ntype	|string	|No	| [Refer Related Notices](#related-notices)
-awdnbr|	string|	Yes - for AWARD, ITB & JA |	Award #	|255 characters
-donbr	|string	|Yes - for JA|	Delivery/Task Order Number	|255 characters
+awdnbr|	string|	Yes - for AWARD, ITB & JA |	Award #	|255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+donbr	|string	|Yes - for JA|	Delivery/Task Order Number	|	255 characters from the set: a-z A-Z 0-9 - _ ( )
 awdamt	|string|	Yes - for AWARD 	|Award Amount|	64 digits
-linenbr|	string	|No|	Award Line Item Number	|255 characters
+linenbr|	string	|No|	Award Line Item Number	|255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 awddate	|date|	Yes - for AWARD|	Award Date	|YYYYMMDD
 stauth	|string	|Yes - for JA 	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| [Refer Stauth Valid Values](#stauth-valid-values)
 respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL	|Response Date	|YYYYMMDD
@@ -1067,7 +1066,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 Date|	Date|	No	|Posting Date	|YYYYMMDD
 solnbr	|String	|No|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|String	|No|	 [Refer Related Notices](#related-notices)
+ntype	|String	|No|	Notice Type	| [Refer Notice Types](#Notice Types) 
 uploadtype|	String|	No |	Upload Type|	A for amendment, S for solicitation or any title for other; 255 characters
 respdate	|Date	|No |Response Date|	YYYYMMDD
 links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
@@ -1110,8 +1109,8 @@ UnarchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| [Refer Related Notices](#related-notices)
-awdnbr	|string|	No|	Award #|	255 characters
+ntype	|string	|No	| Notice Type	| [Refer Notice Types](#Notice Types) 
+awdnbr	|string|	No|	Award #|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
 
 ### Secure Document Package 
 (attachSecureDocumentPackagesToNotice)
@@ -1175,7 +1174,7 @@ IVLListRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| [Refer Related Notices](#related-notices)
+ntype	|string	|No	| Notice Type	| [Refer Notice Types](#Notice Types) 
 
 IVLListResponse Complex Type Definition:
 
@@ -1199,7 +1198,7 @@ duns|	string|	DUNS #
 cage_code	|string|	Cage Code
 address	|string	|Address
 bus_types|	string|	Business Types
-naics_codes|	string	|Naics Codes 
NAICS Reference
+naics_codes|	string	|Naics Codes 
NAICS Reference
 
 ### Authorized Parties List 
 (getAuthorizedPartyList)
 
@@ -1220,7 +1219,7 @@ AuthorizedPartyListRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes	|Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype|	string|	No|	 [Refer Related Notices](#related-notices) |
+ntype|	string|	No|	Notice Type	| [Refer Notice Types](#Notice Types) 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #. Not supported for this method |
 status| string	|No	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests. |
 
@@ -1264,7 +1263,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No|	 [Refer Related Notices](#related-notices)|
+ntype	|string	|No|	Notice Type	| [Refer Notice Types](#Notice Types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.|  32 characters
 
@@ -1290,7 +1289,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name	|Type	|Required|	Description | Character Limit / Restrictions
 -----|-----|-----|---- | -------
 solnbr	|string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype|	string|	No|	 [Refer Related Notices](#related-notices)|
+ntype|	string|	No|	Notice Type	| [Refer Notice Types](#Notice Types) 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 vendor|	VendorData	|Yes|	Complex type defined below|
 
@@ -1327,7 +1326,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No| [Refer Related Notices](#related-notices)|
+ntype	|string	|No| Notice Type	| [Refer Notice Types](#Notice Types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.| 32 characters
 reason	|string|	Yes|	rejection reason not used in this method|
@@ -1354,7 +1353,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No|	 [Refer Related Notices](#related-notices)
+ntype	|string	|No| Notice Type	| [Refer Notice Types](#Notice Types) 
 nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method|
 vendor	|VendorData|	Yes|	Complex type defined below|
 reason|	string|	Yes	|Rejection Reason | 65535 characters
@@ -1390,7 +1389,7 @@ ExplicitAccessRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| [Refer Related Notices](#related-notices)|
+ntype	|string	|No	| Notice Type	| [Refer Notice Types](#Notice Types) 
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.|
 Id	|string	|No	|Not used in this method|
 vendor	|VendorData|	Yes|	Complex type defined below|
@@ -1428,7 +1427,7 @@ NoticeListRequest Complex Type Definition:
 
 Element Name|	Type|	Required|	Description | Character Limit / Restrictions
 -----|-----|-----|-----|-----
-notice_type	|string|	No (at least 1 field is required)|	 [Refer Notice Types](#notice-types)(#related-notices)  Note:Searches for award, j&a, itb and fairopps will return both standalone notices AND base notices that contain one of these type
+notice_type	|string|	No (at least 1 field is required)|	 [Refer Notice Types](#notice-types) Note:Searches for award, j&a, itb and fairopps will return both standalone notices AND base notices that contain one of these type
 solnbr	|string	|No (at least 1 field is required)	|Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 awdnbr	|string	|No	(at least 1 field is required)|Award # | 255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 posted_from	|date|	No (at least 1 field is required)|	Posted From Date. YYYYMMDD.

From b7e485a82f546e10b5f025ba235d3281291f45d7 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Tue, 29 Oct 2019 08:24:16 -0400
Subject: [PATCH 069/149] updating opportunities.md

---
 _apidocs/opportunities-api.md | 166 +++++++++++++++++++++++++++++++---
 1 file changed, 154 insertions(+), 12 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 66b73348d..51d776683 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -422,6 +422,148 @@ Examples
 

 
 
+

+SOLICITATION Request related to a PRESOL Notice
+

+
+
+{
+    "data":
+    {
+        "type": "o",
+        "solicitationNumber": "test-12345678901",
+        "title": "Test submit solicitation",
+        "organizationId": "100186612",
+        "organizationLocationId": "",
+        "classificationCode": "1260",
+        "naics": [
+        {
+            "type": "primary",
+            "code": ["111150"]
+        }],
+        "flags": [
+        {
+            "code": "",
+            "isSelected": true
+        }],
+        "pointOfContact": [
+        {
+            "type": "primary",
+            "title": "",
+            "fullName": "test contact",
+            "email": "test@test.com",
+            "phone": "",
+            "fax": "",
+            "additionalInfo":
+            {
+                "content": "Primary contact info"
+            }
+        }],
+        "placeOfPerformance":
+        {
+            "streetAddress": "1234 XYZ street",
+            "streetAddress2": "",
+            "city": {
+                "code": "75376",
+                "name": "Sterling"
+            },
+            "state": {
+                "code": "VA",
+                "name": "Virginia"
+            },
+            "country": {
+                "code": "USA",
+                "name":"USA"
+            }
+,
+            "zip": ""
+        },
+        "archive":
+        {
+            "type": "autocustom",
+            "date": "2022-09-09"
+        },
+        "permissions":
+        {
+            "IVL":
+            {
+                "create": false,
+                "delete": false,
+                "read": false,
+                "update": false
+            }
+        },
+        "solicitation":
+        {
+            "setAside": "SBA",
+            "deadlines":
+            {
+                "response": "2022-08-08"
+            }
+        },
+        "award":
+        {
+            "date": "",
+            "number": "",
+            "deliveryOrderNumber": "",
+            "amount": "",
+            "lineItemNumber": "",
+            "awardee":
+            {
+                "manual": false,
+                "name": "",
+                "duns": "",
+                "location":
+                {
+                    "streetAddress": "",
+                    "streetAddress2": "",
+                    "city":
+                    {
+                        "code": "",
+                        "name": ""
+                    },
+                    "state":
+                    {
+                        "code": "",
+                        "name": ""
+                    },
+                    "zip": "",
+                    "country":
+                    {
+                        "code": "",
+                        "name": ""
+                    }
+                }
+            }
+            },
+            "justificationAuthority":
+            {
+                "modificationNumber": "",
+                "authority": "dictionary"
+            },
+            "link":
+            {
+                "additionalInfo":
+                {
+                    "content": ""
+                },
+                "href": ""
+            },
+            "additionalReporting": ["none"]
+        },
+        "description": [
+        {
+            "body": "test description"
+        }],
+        "related":
+        {
+            "opportunityId": "bc14e9f810a44e468c31fd120dd41b4f"
+        }
+    }
+

+

+

+
 
Back to top

 
 ### Publish Draft Opportunity
@@ -2787,7 +2929,7 @@ pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  |
 pointOfContact.phone | string |255 characters | | No | No | Contact Phone
 pointOfContact.fax | string | 255 characters | | No  | No | Contact Fax
 pointOfContact.additionalInfo | JSON |NA |NA | NA  | NA |  Any additional information on Point of Contact
-pointOfContact.additionalInfo.content | String | | | No  | No | Details of the additional information on Point of Contact 
+pointOfContact.additionalInfo.
content | String | | | No  | No | Details of the additional information on Point of Contact 
 placeOfPerformance | JSON | NA | NA | NA | NA |
 placeOfPerformance.
streetAddess | string | | | No | No | Pop Address
 placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2
@@ -2843,7 +2985,7 @@ justificationAuthority.
authority | string|  |  | No | No | Justification Au
 link | JSON | NA |NA | NA | NA |
 link.href | string | | | No | No | Url for the notice on SAM.gov
 link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
-link.additionalInfo.content | string | | | No | No | Additional information details
+link.additionalInfo.
content | string | | | No | No | Additional information details
 additionalReporting | string | |none/
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
 description | JSON | NA | NA | NA | NA |
 description.body | string | 65535 characters| | No | Yes | Description of the notice
@@ -3049,7 +3191,7 @@ pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  |
 pointOfContact.phone | string |255 characters | | No | No | Contact Phone
 pointOfContact.fax | string | 255 characters | | No  | No | Contact Fax
 pointOfContact.additionalInfo | JSON |NA |NA | NA  | NA |  Any additional information on Point of Contact
-pointOfContact.additionalInfo.content | String | | | No  | No | Details of the additional information on Point of Contact 
+pointOfContact.additionalInfo.
content | String | | | No  | No | Details of the additional information on Point of Contact 
 placeOfPerformance | JSON | NA | NA | NA | NA |
 placeOfPerformance.
streetAddess | string | | | No | No | Pop Address
 placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2
@@ -3105,7 +3247,7 @@ justificationAuthority.
authority | string|  |  | No | No | Justification Au
 link | JSON | NA |NA | NA | NA |
 link.href | string | | | No | No | Url for the notice on SAM.gov
 link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
-link.additionalInfo.content | string | | | No | No | Additional information details
+link.additionalInfo.
content | string | | | No | No | Additional information details
 additionalReporting | string | |none/
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
 description | JSON | NA | NA | NA | NA |
 description.body | string | 65535 characters| | No | Yes | Description of the notice
@@ -3311,15 +3453,15 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided)
 
 * Field headers in the table must match with field headers shown in JSON example  
 
-Name | Data Type | Allowed Values | Required | Description
+Name | Data Type | Field Length |Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
-attType | string | link, file | Yes | Type of attachment, either link or file
-content | byte |  | Yes (if attType=file) | File content in base64 format
-packageAccessLevel | string | public,private(default public) | No | Type of access to file. Only used with attType 'file'.
-resourceName | string |  | Yes (if attType=file) | Name of file
-fileType | string |  | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
-link | string |  | Yes (if attType=link) | Resource link  URL
-description | string |  | Yes (if attType=link) | Description of the link
+attType | string | 32 characters |link, file | Yes | Type of attachment, either link or file
+content | byte | 250MB| | Yes (if attType=file) | File content in base64 format
+packageAccessLevel | string | 32 characters|public,private(default public) | No | Type of access to file. Only used with attType 'file'.
+resourceName | string | 255 characters| | Yes (if attType=file) | Name of file
+fileType | string | 64 characters | | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
+link | string | 255 characters| | Yes (if attType=link) | Resource link  URL
+description | string |255 characters | | Yes (if attType=link) | Description of the link
 
 #### Valid File Types 
 

From 31585b94472ea76af602f5de761c01e6d8c946fc Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Tue, 29 Oct 2019 08:39:31 -0400
Subject: [PATCH 070/149] build error fix

---
 _apidocs/opportunities-api.md      |  2 +-
 _apidocs/opportunities-soap-api.md | 24 ++++++++++++------------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 51d776683..5516f8bfe 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3022,7 +3022,7 @@ reason | string |  | No | Publish reason
 ### Create and Publish Opportunity Contract JSON
 
 
-

+

 

 Create_Publish_Opportunity_Contract_Json
 

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 5e278ccb0..3f6edb65a 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -261,7 +261,7 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr |	string |	Yes; Solicitation # or Award # is required |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	No | Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype |	string |	No | Notice Type	| [Refer Notice Types](#notice-types) 
 awdnbr |  string | Yes; Solicitation # or Award # is required| Award # |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 deletetype |	string |	No |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
@@ -288,7 +288,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date | YYYYMMDD
 solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string | No |	Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype |	string | No |	Notice Type	| [Refer Notice Types](#notice-types) 
 archdate | date |	No | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
 officeid | string |	No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 
@@ -317,7 +317,7 @@ offadd | string |	No | Office Address (Deprecated). The Contracting office addre
 officeid | String | No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	string | No |	Subject |	256 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype | string | No | Notice Type	| [Refer Notice Types](#Notice Types)  
+ntype | string | No | Notice Type	| [Refer Notice Types](#notice-types)  
 awdnbr | string |	No | Award # |255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate | date |	No | Archive Date | YYYYMMDD
 contact | string | Yes | Contact Info | 255 characters
@@ -1066,7 +1066,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 Date|	Date|	No	|Posting Date	|YYYYMMDD
 solnbr	|String	|No|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|String	|No|	Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype	|String	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
 uploadtype|	String|	No |	Upload Type|	A for amendment, S for solicitation or any title for other; 255 characters
 respdate	|Date	|No |Response Date|	YYYYMMDD
 links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
@@ -1109,7 +1109,7 @@ UnarchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
 awdnbr	|string|	No|	Award #|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
 
@@ -1174,7 +1174,7 @@ IVLListRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
 
 IVLListResponse Complex Type Definition:
 
@@ -1219,7 +1219,7 @@ AuthorizedPartyListRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes	|Solicitation #. Provide an empty string for this argument if using nonfbo_solnbr below | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype|	string|	No|	Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype|	string|	No|	Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #. Not supported for this method |
 status| string	|No	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests. |
 
@@ -1263,7 +1263,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No|	Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype	|string	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.|  32 characters
 
@@ -1289,7 +1289,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name	|Type	|Required|	Description | Character Limit / Restrictions
 -----|-----|-----|---- | -------
 solnbr	|string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype|	string|	No|	Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype|	string|	No|	Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 vendor|	VendorData	|Yes|	Complex type defined below|
 
@@ -1326,7 +1326,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No| Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.| 32 characters
 reason	|string|	Yes|	rejection reason not used in this method|
@@ -1353,7 +1353,7 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No| Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method|
 vendor	|VendorData|	Yes|	Complex type defined below|
 reason|	string|	Yes	|Rejection Reason | 65535 characters
@@ -1389,7 +1389,7 @@ ExplicitAccessRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| Notice Type	| [Refer Notice Types](#Notice Types) 
+ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.|
 Id	|string	|No	|Not used in this method|
 vendor	|VendorData|	Yes|	Complex type defined below|

From fbf8dcdca3ed383462244443998249f3363076f9 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Tue, 29 Oct 2019 08:56:53 -0400
Subject: [PATCH 071/149] update to opportunities.md

---
 _apidocs/opportunities-api.md | 140 +++++++++++++++++-----------------
 1 file changed, 71 insertions(+), 69 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 5516f8bfe..ff415a24e 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3028,8 +3028,7 @@ reason | string |  | No | Publish reason
 

 
 {
-    "data":
-    {
+    "data": {
         "type": "",
         "solicitationNumber": "",
         "title": "",
@@ -3037,131 +3036,134 @@ reason | string |  | No | Publish reason
         "organizationLocationId": "",
         "classificationCode": "",
         "naics": [
-        {
-            "type": "primary",
-            "code": [""]
-        }],
+            {
+                "type": "primary",
+                "code": [
+                    ""
+                ]
+            }
+        ],
         "flags": [
-        {
-            "code": "",
-            "isSelected": true
-        }],
+            {
+                "code": "",
+                "isSelected": true
+            }
+        ],
         "pointOfContact": [
-        {
-            "type": "primary",
-            "title": "",
-            "fullName": "",
-            "email": "",
-            "phone": "",
-            "fax": "",
-            "additionalInfo":
             {
-                "content": ""
+                "type": "primary",
+                "title": "",
+                "fullName": "",
+                "email": "",
+                "phone": "",
+                "fax": "",
+                "additionalInfo": {
+                    "content": ""
+                }
             }
-        }],
-        "placeOfPerformance":
-        {
+        ],
+        "placeOfPerformance": {
             "streetAddress": "",
             "streetAddress2": "",
-            "city":
-            {
+            "city": {
                 "code": "",
                 "name": ""
             },
-            "country":
-            {
+            "country": {
                 "code": "",
                 "name": ""
             },
-            "state":
-            {
+            "state": {
                 "code": "",
                 "name": ""
             },
             "zip": ""
         },
-        "archive":
-        {
+        "archive": {
             "type": "autocustom",
             "date": "2019-09-09"
         },
-        "permissions":
-        {
-            "IVL":
-            {
+        "permissions": {
+            "IVL": {
                 "create": false,
                 "delete": false,
                 "read": false,
                 "update": false
             }
         },
-        "solicitation":
-        {
+        "solicitation": {
             "setAside": "SBA",
-            "deadlines":
-            {
+            "deadlines": {
                 "response": "2019-08-08"
             }
         },
-        "award":
-        {
+        "award": {
             "date": "",
             "number": "",
             "deliveryOrderNumber": "",
             "amount": "",
             "lineItemNumber": "",
-            "awardee":
-            {
+            "awardee": {
                 "manual": false,
                 "name": "",
                 "duns": "",
-                "location":
-                {
+                "location": {
                     "streetAddress": "",
                     "streetAddress2": "",
-                    "city":
-                    {
+                    "city": {
                         "code": "",
                         "name": ""
                     },
-                    "state":
-                    {
+                    "state": {
                         "code": "",
                         "name": ""
                     },
                     "zip": "",
-                    "country":
-                    {
+                    "country": {
                         "code": "",
                         "name": ""
                     }
                 }
             }
+        },
+        "justificationAuthority": {
+            "modificationNumber": "",
+            "authority": "dictionary"
+        },
+        "link": {
+            "additionalInfo": {
+                "content": ""
             },
-            "justificationAuthority":
-            {
-                "modificationNumber": "",
-                "authority": "dictionary"
-            },
-            "link":
-            {
-                "additionalInfo":
-                {
-                    "content": ""
-                },
-                "href": ""
-            },
-            "additionalReporting": ["none"]
+            "href": ""
         },
-        "description": [
+        "additionalReporting": [
+            "none"
+        ]
+    },
+    "description": [
         {
             "body": ""
-        }],
-        "related":
+        }
+    ],
+    "related": {
+        "opportunityId": ""
+    },
+    "resources": [
         {
-            "opportunityId": ""
+            "attType": "link",
+            "link": "",
+            "description": ""
+        },
+        {
+            "attType": "file",
+            "content": "",
+            "resourceName": "",
+            "packageAccessLevel": "",
+            "explicitAccess": "",
+            "exportControlled": null
         }
-    }
+    ]
+}
 

 

 


From 3aa66a697a425480caee05b17a0a15bfaa11fd73 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 10:12:39 -0400
Subject: [PATCH 072/149] Update get-opportunities-public-api.md

---
 _apidocs/get-opportunities-public-api.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md
index 753a74986..9e9298b7a 100644
--- a/_apidocs/get-opportunities-public-api.md
+++ b/_apidocs/get-opportunities-public-api.md
@@ -409,13 +409,11 @@ Since Opportunities data volume is huge, API works as follows:
 
 Scenario | Error Messages
 ------| ------
-For status, user provides a value apart from Both or Active or InActive.|	Invalid Status value. Allowed values are any of Both/Active/InActive
 For limit, user provides range beyond 1000.|	Limit valid range is 0-1000. Please provide valid input.
 For limit or offset, user inputs characters/special characters.|	limit/offset must be a positive number.
 For postedFrom, postedTo, rdlfrom, rdlto user enters an invalid date format. |	Invalid Date Entered. Expected date format is MM/dd/yyyy
 User does not provide postedFrom and postedTo values.	|PostedFrom and PostedTo are mandatory
 User provides more than 1 year of date range for postedFrom and postedTo 
OR
User provides more than 1 year of date range for rdlfrom and rdlto	|Date range must be 1 year(s) apart
-User provides more than 25 characters for description field. |	Description length is limited to 25 characters
 User provides invalid API Key|	An invalid api_key was supplied
 User does not provide any API key	|No api_key was supplied
 User clicks on the description link available in the response and description content is not available	|Description Not Found

From 51b788f4d0bc3249af1fafc67d333f7609720aee Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 10:13:56 -0400
Subject: [PATCH 073/149] Update get-opportunities-public-api.md

---
 _apidocs/get-opportunities-public-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md
index 9e9298b7a..d8b7954a7 100644
--- a/_apidocs/get-opportunities-public-api.md
+++ b/_apidocs/get-opportunities-public-api.md
@@ -87,7 +87,7 @@ pointofContact|	Point of Contact Information. It can have below fields if availa
 description|	A link to an opportunity description. 
Note: To download the description, user should append the public API Key. If no description is available then, user is shown an error message “ Description not found”|	String
 organizationType|	Type of an organization – department/sub-tier/office|	String
 officeAddress|	Office Address Information. It can have below fields if available: 
 City
 State
Zip|	String
-placeOfPerformance|	Place of performance information. It can have below fields if available:
 City
 State
Zip|	JSON
+placeOfPerformance|	Place of performance information. It can have below fields if available: Street
 City
 State
Zip|	JSON
 additionalInfoLink|	Any additional info link if available for the opportunity	|String
 uiLink	|Direct UI link to the opportunity. To view the opportunity on UI, user must have either a contracting officer or a Contracting Specialist role. If user hits the link without logging in, user is directed to 404 not found page |	String
 links	|Every record in a response has this links array consisting of: 
 rel: self
href: link to the specific opportunity itself. User should provide an API key to access the opportunity directly

Also, every response has a master links array consisting of:
    rel: self
href: link to the actual request. User should provide an API key to access the request|	Array

From a2c35bc513f8ac567a377f4c929f55e253b820f1 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 14:32:57 -0400
Subject: [PATCH 074/149] Update get-opportunities-public-api.md

---
 _apidocs/get-opportunities-public-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md
index d8b7954a7..6ac8b2f77 100644
--- a/_apidocs/get-opportunities-public-api.md
+++ b/_apidocs/get-opportunities-public-api.md
@@ -92,7 +92,7 @@ additionalInfoLink|	Any additional info link if available for the opportunity	|S
 uiLink	|Direct UI link to the opportunity. To view the opportunity on UI, user must have either a contracting officer or a Contracting Specialist role. If user hits the link without logging in, user is directed to 404 not found page |	String
 links	|Every record in a response has this links array consisting of: 
 rel: self
href: link to the specific opportunity itself. User should provide an API key to access the opportunity directly

Also, every response has a master links array consisting of:
    rel: self
href: link to the actual request. User should provide an API key to access the request|	Array
 
-#### Set-Aside Values
+### Set-Aside Values
 Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. Use the Set-Aside codes to submit notices.
 
 Only one Set-Aside value is accepted in the field at this time

From 9bc3478df894f17d518e5add3850680efe0d65b5 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 14:32:59 -0400
Subject: [PATCH 075/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index ff415a24e..037950258 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -14,7 +14,7 @@ The Opportunity Management API will allow authorized users to submit and request
 ## Getting Started
 
 Opportunity Management API can be accessed from Beta or Alpha via the following endpoints:
-* Beta: https://api.sam.gov/prod/opportunity 
+* Beta: https://api.sam.gov/prod/opportunity (Coming Soon)
 * Alpha: https://api-alpha.sam.gov/prodlike/opportunity
 
 **REST API Workflow Chart**

From 932c4c4eab6d7b2c43e20d5e24e48897dbd2f700 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Tue, 29 Oct 2019 14:58:02 -0400
Subject: [PATCH 076/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 252 ++++++++++++++++++++++++++--------
 1 file changed, 195 insertions(+), 57 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index ff415a24e..5619cc224 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -68,8 +68,9 @@ Cancel Published Opportunity | Yes | Yes | No
 Uncancel Canceled Opportunity | Yes | Yes | No
 Archive Opportunity | Yes | Yes | Yes
 Unarchive Archived Opportunity | Yes | Yes | No
-Create Attachment in Draft Opportunity| Yes | Yes | Yes
-Update Attachment in Draft Opportunity| Yes | Yes | Yes
+Create Resource in Draft Opportunity| Yes | Yes | Yes
+Update Resource in Draft Opportunity| Yes | Yes | Yes
+Delete Resource in Draft Opportunity| Yes | Yes | Yes
 Download Attachment as Original File Type | Yes | Yes | Yes
 Download All Attachments as Zip for an Opportunity | Yes | Yes | Yes
 Download Metadata for an Attachment by Resource ID|	Yes|	Yes|	Yes
@@ -635,6 +636,154 @@ HTTP Status Code | Response Type | Reason  | Description
 -----------------|---------------|---------|------------
 201 | string | Draft Opportunity successfully created | returns Opportunity ID in response header
 
+Examples
+
+

+Create and Publish  'SOLICITATION' Opportunity with attachments/links related to a 'PRESOL' notice:
+

+
+{
+    "data": {
+        "type": "o",
+        "solicitationNumber": "test-12345457",
+        "title": "Test Create and Publish SOL notice",
+        "organizationId": "100186612",
+        "organizationLocationId": "",
+        "classificationCode": "1260",
+        "naics": [
+            {
+                "type": "primary",
+                "code": [
+                    "111150"
+                ]
+            }
+        ],
+        "flags": [
+            {
+                "code": "",
+                "isSelected": true
+            }
+        ],
+        "pointOfContact": [
+            {
+                "type": "primary",
+                "title": "",
+                "fullName": "test contact",
+                "email": "test@test.com",
+                "phone": "",
+                "fax": "",
+                "additionalInfo": {
+                    "content": "Primary contact info"
+                }
+            }
+        ],
+        "placeOfPerformance": {
+            "streetAddress": "1234 XYZ street",
+            "streetAddress2": "",
+            "city": {
+                "code": "75376",
+                "name": "Sterling"
+            },
+            "state": {
+                "code": "VA",
+                "name": "Virginia"
+            },
+            "country": {
+                "code": "USA",
+                "name": "USA"
+            },
+            "zip": ""
+        },
+        "archive": {
+            "type": "autocustom",
+            "date": "2022-09-09"
+        },
+        "permissions": {
+            "IVL": {
+                "create": false,
+                "delete": false,
+                "read": false,
+                "update": false
+            }
+        },
+        "solicitation": {
+            "setAside": "SBA",
+            "deadlines": {
+                "response": "2022-08-08"
+            }
+        },
+        "award": {
+            "date": "",
+            "number": "",
+            "deliveryOrderNumber": "",
+            "amount": "",
+            "lineItemNumber": "",
+            "awardee": {
+                "manual": false,
+                "name": "",
+                "duns": "",
+                "location": {
+                    "streetAddress": "",
+                    "streetAddress2": "",
+                    "city": {
+                        "code": "",
+                        "name": ""
+                    },
+                    "state": {
+                        "code": "",
+                        "name": ""
+                    },
+                    "zip": "",
+                    "country": {
+                        "code": "",
+                        "name": ""
+                    }
+                }
+            }
+        },
+        "justificationAuthority": {
+            "modificationNumber": "",
+            "authority": "dictionary"
+        },
+        "link": {
+            "additionalInfo": {
+                "content": ""
+            },
+            "href": ""
+        },
+        "additionalReporting": [
+            "none"
+        ]
+    },
+    "description": [
+        {
+            "body": "test description"
+        }
+    ],
+    "related": {
+        "opportunityId": "f8ccfca94d794e07855ebe0d6f55c7d5"
+    },
+    "resources": [
+        {
+            "attType": "link",
+            "link": "https://faaco.faa.gov/index.cfm/attachment/download/84723",
+            "description": "test attachment pdf link"
+        },
+        {
+            "attType": "file",
+            "content": "SGVsbG8=",
+            "resourceName": "Hello.txt",
+            "fileType": "text/plain",
+            "packageAccessLevel": "private",
+            "explicitAccess": "1"
+        }
+    ]
+}
+

+

+

+
+
Back to top

 
 ### Revise Published Opportunity
 
@@ -1150,8 +1299,6 @@ Examples
 
 ### Delete Draft Opportunity
 
-
-
 ------- | -------
 **Request Type** | DELETE
 **URL** | /v1/api/delete/{opportunityId}
@@ -1197,7 +1344,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 ---------------|----------------|------------|----------|------------
 Authorization	| Header | string |	Yes |	Valid and authorized user ID
 api_key |	query |	string |	Yes |	Valid System Account API Key
-Request JSON|	Body|	JSON|	Yes|	Refer Delete Notice JSON
+Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice JSON](#delete-notice-json)
 
 Responses
 
@@ -1208,19 +1355,16 @@ HTTP Status Code | Response Type | Reason  | Description
 Examples
 
 

-Delete Notice:
+Delete latest version of a notice:
 

 
 {
-   "requestType":"delete_request",
-    "reason":"test",
-     "data":{
-              "description":"test",
-               "title":null,
-                "newArchiveDate":null,
-                "newArchiveType":null,
-                 "deleteOption":"latest"  ( “all”  - to delete all versions)
-              }
+  "reason": "test",
+  "requestType": "delete_request",
+  "data": {
+    "description": "test",
+    "deleteOption": "latest"
+  }
 }
 

 

@@ -1475,7 +1619,6 @@ Examples
           "opportunityId": "8de3d88fc7642d9adcdb8d4ff9070399"
         },
         "related": {
-
         },
         "status": {
           "code": "draft",
@@ -2008,7 +2151,7 @@ Examples
 ------- | -------
 **Request Type** | POST
 **URL** |/v1/api/{opportunityId}/attachments
-**Summary** | Create attachment/link to a draft Opportunity
+**Summary** | Add attachment/link to a draft Opportunity
 **Consumes** | application/json
 **Produces** | JSON
 
@@ -2036,11 +2179,12 @@ Examples
 

 
 {
- "attType": "file",
- "content": "SGVsbG8=",
- "resourceName": "Hello.txt",
- "fileType": "text/plain",
- "packageAccessLevel": "public"
+    "attType": "file",
+    "content": "SGVsbG8=",
+    "resourceName": "Hello.txt",
+    "fileType": "text/plain",
+    "packageAccessLevel": "private",
+    "explicitAccess": "1"
 }
 

 

@@ -2050,10 +2194,10 @@ Examples
 Create Attachment Request - link
 

 
-{"attType":"link",
- "link":"https://faaco.faa.gov/index.cfm/attachment/download/84723",
- "description":"test attachment pdf link",
-"packageAccessLevel":null
+{
+    "attType": "link",
+    "link": "https://faaco.faa.gov/index.cfm/attachment/download/84723",
+    "description": "test attachment pdf link"
 }
 

 

@@ -2066,7 +2210,7 @@ Examples
 ------- | -------
 **Request Type** | PATCH
 **URL** |/v1/api/{opportunityId}/attachments/{resourceId}
-**Summary** | Update an attachment metadata on a draft Opportunity
+**Summary** | Update draft attachment/link metadata on a draft Opportunity
 **Consumes** | application/json
 **Produces** | JSON
 
@@ -2168,7 +2312,7 @@ Examples
 ------- | -------
 **Request Type** | DELETE
 **URL** |/v1/api/{opportunityId}/attachments/{resourceId}
-**Summary** | Delete a resource from a draft opportunity.
+**Summary** | Delete an attachment/link from a draft opportunity.
 **Consumes** | Request Parameters
 **Produces** | NA
 
@@ -2909,11 +3053,11 @@ Examples
 
 Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (to Publish) | Description
 -----|-----------|-------|-------------------|------------|------------ |----------
-type | string | 1 character| See Notice Types table | Yes | Yes | Notice Type
+type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Yes | Notice Type
 solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number
 title | string | 256 characters | |Yes | Yes | Title of the Opportunity
 organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
-organizationLocationId | string | | | No|No| This field has been deprecated.Organization Location details will be pulled from the Federal Hierarchy 
+organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
 classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA | NA |
 naics.code | Array of String | | | No | Yes | Valid NAICS Code
@@ -2922,7 +3066,7 @@ flags | JSON Array| NA |NA | NA | NA |
 flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
 flags.IsSelected | boolean | |default is 'True' | No | No |
 pointOfContact | JSON Array | NA |NA | NA | NA |
-pointOfContact.type | string | | primary, secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
+pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
 pointOfContact.title | string | |  | No | No | Contact title
 pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
 pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
@@ -2944,8 +3088,8 @@ placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
 placeOfPerformance.
country.name | string | | | No | No | Pop Country name
 placeOfPerformance.zip | string | | | No | No | Pop Country zip
 archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date. This date will indicate when a notice will be moved to the inactive status. This date must be in the future
+archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. 
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA | NA |
 permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
 permissions.ivl.create | boolean | | | No | No | IVL create permission
@@ -2953,7 +3097,7 @@ permissions.ivl.read | boolean | | | No | No | IVL read permission
 permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | IVL update permission
 permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | IVL delete permission
 solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |See Set-Aside values table | No | No | Set-Aside code. The designator for type of set aside determined for the contract action
+solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code.
 The designator for type of set aside determined for the contract action
 solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
 solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
 solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
@@ -2986,7 +3130,7 @@ link | JSON | NA |NA | NA | NA |
 link.href | string | | | No | No | Url for the notice on SAM.gov
 link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
 link.additionalInfo.
content | string | | | No | No | Additional information details
-additionalReporting | string | |none/
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
+additionalReporting | string | |none, 
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
 description | JSON | NA | NA | NA | NA |
 description.body | string | 65535 characters| | No | Yes | Description of the notice
 related | JSON | NA | NA | NA | NA | Related Notice information
@@ -3173,11 +3317,11 @@ reason | string |  | No | Publish reason
 
 Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (to Publish) | Description
 -----|-----------|-------|-------------------|------------|------------ |----------
-type | string | 1 character| See Notice Types table | Yes | Yes | Notice Type
+type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Yes | Notice Type
 solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number
 title | string | 256 characters | |Yes | Yes | Title of the Opportunity
 organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
-organizationLocationId | string | | | No|No| This field has been deprecated.Organization Location details will be pulled from the Federal Hierarchy 
+organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
 classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA | NA |
 naics.code | Array of String | | | No | Yes | Valid NAICS Code
@@ -3186,7 +3330,7 @@ flags | JSON Array| NA |NA | NA | NA |
 flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
 flags.IsSelected | boolean | |default is 'True' | No | No |
 pointOfContact | JSON Array | NA |NA | NA | NA |
-pointOfContact.type | string | | primary, secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
+pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
 pointOfContact.title | string | |  | No | No | Contact title
 pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
 pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
@@ -3208,8 +3352,8 @@ placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
 placeOfPerformance.
country.name | string | | | No | No | Pop Country name
 placeOfPerformance.zip | string | | | No | No | Pop Country zip
 archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date. This date will indicate when a notice will be moved to the inactive status. This date must be in the future
+archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. 
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA | NA |
 permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
 permissions.ivl.create | boolean | | | No | No | IVL create permission
@@ -3217,7 +3361,7 @@ permissions.ivl.read | boolean | | | No | No | IVL read permission
 permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | IVL update permission
 permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | IVL delete permission
 solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |See Set-Aside values table | No | No | Set-Aside code. The designator for type of set aside determined for the contract action
+solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code. 
The designator for type of set aside determined for the contract action
 solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
 solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
 solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
@@ -3250,7 +3394,7 @@ link | JSON | NA |NA | NA | NA |
 link.href | string | | | No | No | Url for the notice on SAM.gov
 link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
 link.additionalInfo.
content | string | | | No | No | Additional information details
-additionalReporting | string | |none/
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
+additionalReporting | string | |none,
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
 description | JSON | NA | NA | NA | NA |
 description.body | string | 65535 characters| | No | Yes | Description of the notice
 related | JSON | NA | NA | NA | NA | Related Notice information
@@ -3259,7 +3403,7 @@ resources | JSON |NA | NA | NA | NA |
 resources.attType | string | |link, file | No |No| Type of attachment, either link or file
 resources.content | byte |250MB |  | No|No | File content in base64 format
 resources.link | string | 255 characters | |No|No | Resource link URL
-resources.packageAccessLevel | string | | public,private(default public) | No | No| Type of access to file
+resources.packageAccessLevel | string | | public,private
(default public) | No | No| Type of access to file
 resources.resourceName | string | 255 characters |  | No|No | Name of file
 
 
Back to top

@@ -3578,26 +3722,20 @@ Name | Data Type | Allowed Values | Required | Description
 reason|	string|	|	Yes|	Reason for deletion
 requestType	|string	|delete_request |Yes	|Type of request
 description	|string|		|Yes|	Description for deletion of a notice
-title	|string	|	|No|	
-newArchiveDate|	date|	YYYY-MM-DD|	No|	New Archive Date
-newArchiveType|	string|	|	No|	New Archive Type
 deleteOption|	string|	latest, all|	Yes|	Option to delete either the latest or all versions of a notice
 
 

-Response
+Delete Notice Request
 

 
    {
-   "requestType”: delete_request",
-    "reason":"test",
+     "reason": "",
+     "requestType": "delete_request",
      "data": {
-                           "description”: “test",
-                            "title”: null,
-                            "newArchiveDate":null,
-                             "newArchiveType":null,
-                             "deleteOption”: latest"  ( “all”  - to delete all versions)
-              }
-}
+       "description": "",
+       "deleteOption": "all"   -- "latest" to delete the latest published version of a notice 
+     }
+   }
 

 

 

@@ -3669,7 +3807,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Justification Authority |	This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type | Justification Authority Modification Number is only valid for Type "u" Justification and Authorization | Publish
 400|NAICS Code | This opportunity cannot be published. NAICS provided did not match expected codes | NAICS Code is invalid | Create Opportunity, Publish
 400|NAICS Type | $.data.naics[0].type: does not have a value in the enumeration [primary] | NAICS Type is required | Create Opportunity
-400|Notice Type |	This opportunity cannot be published. The opportunity type `j` is no longer supported	| See Notice Types table for valid notice types |	Publish
+400|Notice Type |	This opportunity cannot be published. The opportunity type `j` is no longer supported	| [Refer Notice Types](#notice-types) for valid notice types |	Publish
 400|Opportunity ID | Opportunity ID for the selected opportunity type already exists | Cannot publish an existing published record | Publish
 400|Opportunity ID | Opportunity cannot be updated | An Opportunity cannot be revised if that Opporutnity was revised previously and is currently in draft state  | Revise
 404|Opportunity ID | Opportunity ID is required	| Opportunity ID is required | All

From e225f3899ba32602f08268f76162edfba63a8168 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Tue, 29 Oct 2019 15:32:20 -0400
Subject: [PATCH 077/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 34 ++++++++++++++++------------------
 1 file changed, 16 insertions(+), 18 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 5c713532d..4f3c2d9c5 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -639,7 +639,7 @@ HTTP Status Code | Response Type | Reason  | Description
 Examples
 
 

-Create and Publish  'SOLICITATION' Opportunity with attachments/links related to a 'PRESOL' notice:
+Create and Publish Request for a 'SOLICITATION' Opportunity with attachments/links related to a 'PRESOL' notice:
 

 
 {
@@ -1661,10 +1661,8 @@ Examples
           ]
         },
         "parent": {
-
         },
         "related": {
-
         },
         "status": {
           "code": "draft",
@@ -3060,13 +3058,13 @@ organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes
 organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
 classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA | NA |
-naics.code | Array of String | | | No | Yes | Valid NAICS Code
+naics.code | Array of String | | | No | Yes | Valid NAICS Code
NAICS Reference
 naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
 flags | JSON Array| NA |NA | NA | NA |
 flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
 flags.IsSelected | boolean | |default is 'True' | No | No |
 pointOfContact | JSON Array | NA |NA | NA | NA |
-pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
+pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
 pointOfContact.title | string | |  | No | No | Contact title
 pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
 pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
@@ -3088,16 +3086,16 @@ placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
 placeOfPerformance.
country.name | string | | | No | No | Pop Country name
 placeOfPerformance.zip | string | | | No | No | Pop Country zip
 archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. 
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
+archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type.
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA | NA |
 permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
 permissions.ivl.create | boolean | | | No | No | IVL create permission
 permissions.ivl.read | boolean | | | No | No | IVL read permission
-permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | IVL update permission
-permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | IVL delete permission
+permissions.ivl.update | boolean | |  | No | No | IVL update permission
+permissions.ivl.delete | boolean | | | No | No | IVL delete permission
 solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code.
 The designator for type of set aside determined for the contract action
+solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code.
 The designator for type of set aside determined for the contract action
 solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
 solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
 solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
@@ -3324,13 +3322,13 @@ organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes
 organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
 classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA | NA |
-naics.code | Array of String | | | No | Yes | Valid NAICS Code
+naics.code | Array of String | | | No | Yes | Valid NAICS Code
NAICS Reference
 naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
 flags | JSON Array| NA |NA | NA | NA |
 flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
 flags.IsSelected | boolean | |default is 'True' | No | No |
 pointOfContact | JSON Array | NA |NA | NA | NA |
-pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
+pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
 pointOfContact.title | string | |  | No | No | Contact title
 pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
 pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
@@ -3352,16 +3350,16 @@ placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
 placeOfPerformance.
country.name | string | | | No | No | Pop Country name
 placeOfPerformance.zip | string | | | No | No | Pop Country zip
 archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. 
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
+archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. 
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA | NA |
 permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
 permissions.ivl.create | boolean | | | No | No | IVL create permission
 permissions.ivl.read | boolean | | | No | No | IVL read permission
-permissions.ivl.update | boolean | | Not In Use | Not In Use | Not In Use | IVL update permission
-permissions.ivl.delete | boolean | | Not In Use | Not In Use | Not In Use | IVL delete permission
+permissions.ivl.update | boolean | |  | No | No | IVL update permission
+permissions.ivl.delete | boolean | |  | No | No | IVL delete permission
 solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code. 
The designator for type of set aside determined for the contract action
+solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code. 
The designator for type of set aside determined for the contract action
 solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
 solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
 solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
@@ -3403,7 +3401,7 @@ resources | JSON |NA | NA | NA | NA |
 resources.attType | string | |link, file | No |No| Type of attachment, either link or file
 resources.content | byte |250MB |  | No|No | File content in base64 format
 resources.link | string | 255 characters | |No|No | Resource link URL
-resources.packageAccessLevel | string | | public,private
(default public) | No | No| Type of access to file
+resources.packageAccessLevel | string | | public,
private
(default public) | No | No| Type of access to file
 resources.resourceName | string | 255 characters |  | No|No | Name of file
 
 
Back to top


From 65f614ca5f185651660069cf4be4d80aace4723d Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Tue, 29 Oct 2019 15:40:12 -0400
Subject: [PATCH 078/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 4f3c2d9c5..e084c3799 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3058,7 +3058,7 @@ organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes
 organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
 classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA | NA |
-naics.code | Array of String | | | No | Yes | Valid NAICS Code
NAICS Reference
+naics.code | Array of String | | NAICS Reference| No | Yes | Valid NAICS Code
 naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
 flags | JSON Array| NA |NA | NA | NA |
 flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
@@ -3322,7 +3322,7 @@ organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes
 organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
 classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA | NA |
-naics.code | Array of String | | | No | Yes | Valid NAICS Code
NAICS Reference
+naics.code | Array of String | | NAICS Reference| No | Yes | Valid NAICS Code
 naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
 flags | JSON Array| NA |NA | NA | NA |
 flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action

From 4ecdbbe1e0d5eb64daad75c98ec4e1f058e93318 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 15:59:19 -0400
Subject: [PATCH 079/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 5c713532d..39cc9479d 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -1344,6 +1344,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 ---------------|----------------|------------|----------|------------
 Authorization	| Header | string |	Yes |	Valid and authorized user ID
 api_key |	query |	string |	Yes |	Valid System Account API Key
+opportunityId | query | string | Yes | Opportunity ID
 Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice JSON](#delete-notice-json)
 
 Responses
@@ -2526,7 +2527,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization|	Header|	string|	Yes|Valid and authorized user ID
 Api_key	query	| string|	Yes|	Valid System Account API Key
 ResourceID	|query|	string|	Yes	| Resource ID
-
+excludeDeleted | query | string | No|
 
 Responses
 
@@ -2582,7 +2583,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization|	Header|	string|	Yes|Valid and authorized user ID
 Api_key	query	| string|	Yes|	Valid System Account API Key
 OpportunityID	|query|	string|	Yes	| Opportunity ID
-
+excludeDeleted | query | string | No|
 
 Responses
 
@@ -2686,7 +2687,6 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization|	Header	|string	|Yes	|Valid and authorized user ID
 api_key|	query|	string|	Yes|	Valid API Key
 opportunityId	|query	|string|	Yes|	Opportunity ID
-status|	query|	string|	No|	Request access status can be: Pending, Approved, Rejected, or blank to get all request details for a notice
 
 
 Responses

From 60ffd5e87b49f880f897b14d75f379444e846dfc Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 16:20:38 -0400
Subject: [PATCH 080/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 9e6be441f..75ef05499 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3635,7 +3635,7 @@ Flash Video (.flv, .f4v)|	video/x-flv
 
 
Back to top

 
-### Update Attachment Link Contract JSON
+### Update Attachment Contract JSON
 
 

 

@@ -3652,7 +3652,9 @@ Flash Video (.flv, .f4v)|	video/x-flv
 }
 

 

+

 
+

 Update_Link_Contract_Json 
 

 

From 0becb1a53d5584e6109af9f1f5bcfa4fbb601771 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 16:22:18 -0400
Subject: [PATCH 081/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 56 ++++++++++++++++--------------
 1 file changed, 29 insertions(+), 27 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 3f6edb65a..9c3edc584 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -128,9 +128,9 @@ The Notice Types valid options are:
 
 #### Related Notices
 
-This is a conversion table for notices using following functions: submitNotice, submitJA, submitAward, submitITB
+The table below lists notices that can be related.
 
-||SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE
+|*Below Notice can be Related to:*|SRCSGT | PRESOL | COMBINE | SOL| AWARD | SSALE | ITB | JA | SNOTE
 -----|-----|-----|-----|-----|-----|-----|-----|-----|-----|
 |**SRCSGT**||O|O|O|O|O|||O
 |**PRESOL**|O||O|O||O|O|O|O
@@ -228,7 +228,7 @@ DocumentLink Complex Type Definition
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 url |	string |	No |	External URL |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-Desc |	string |	No |	Description/Title |	255 characters
+desc |	string |	No |	Description/Title |	255 characters
 
 DocumentFile Complex Type Definition
 
@@ -317,7 +317,7 @@ offadd | string |	No | Office Address (Deprecated). The Contracting office addre
 officeid | String | No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 subject |	string | No |	Subject |	256 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype | string | No | Notice Type	| [Refer Notice Types](#notice-types)  
+ntype | string | No | [Refer Notice Types](#notice-types) 	| 
 awdnbr | string |	No | Award # |255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate | date |	No | Archive Date | YYYYMMDD
 contact | string | Yes | Contact Info | 255 characters
@@ -378,7 +378,7 @@ GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address	| string | No |Email Address |255 characters
+address	| string | Yes |Email Address |255 characters
 desc | string	| No | Description | 255 characters
 
 DocumentLink Complex Type Definition: 
@@ -449,7 +449,7 @@ GovEmail Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	| string | Yes | Email Address | 255 characters
-desc | string |	Yes |	Description |	255 characters
+desc | string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition: 
 
@@ -495,8 +495,8 @@ offadd |	string	| No	| Office Address (Deprecated). The Contracting office addre
 subject	| string	| no |	Subject |	256 characters
 solnbr | string |	Yes, EXCEPT No - Only for SNOTE | 	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype |	string |	Yes |	 Notice Type |	Valid values: PRESOL, COMBINE, SRCSGT, SSALE, SNOTE, SOL
-respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL	|Response Date	|YYYYMMDD
-archdate  |	date|	No - Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
+respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL	|Response Date	|YYYYMMDD
+archdate  |	date|	Yes - for SNOTE, SSALE 

 Either respdate or archdate required for SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
 contact |	string |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL |	Contact Info |	255 characters
 desc |	string |	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE	| Description |	65535 characters
 link	| GovURL – complex type |	No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
@@ -521,7 +521,7 @@ GovEmail Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	| string |	Yes |	Email Address	| 255 characters
-desc |	string |	Yes |	Description |	255 characters
+desc |	string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -666,7 +666,7 @@ GovEmail Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	| string |	Yes |	Email Address |	255 characters
-desc	| string |	Yes |	Description |	255 characters
+desc	| string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition: 
 
@@ -736,7 +736,7 @@ GovEmail Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	|string|	Yes|	Email Address	|255 characters
-desc	|string	|Yes	|Description	|255 characters
+desc	|string	|No	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -749,8 +749,8 @@ DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	No |	File Name |	255 characters
-filedata |	base64binary |	No	| File Data |	250 MB
+filename |	string |	No  |	File Name |	255 characters
+filedata |	base64binary |	No 	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -802,7 +802,7 @@ GovEmail Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address|	string|	Yes|	Email Address	|255 characters
-desc	|string	|Yes	|Description	|255 characters
+desc	|string	|No	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -873,7 +873,7 @@ GovEmail Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	| string | Yes | Email Address | 255 characters
-desc | string |	Yes |	Description |	255 characters
+desc | string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -936,14 +936,14 @@ GovURL Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 url	|string	|No	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string|	No|	Description|	255 characters
+desc	|string|	No - Yes, if URL provided|	Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 address	|string	|Yes|	Email Address	|255 characters
-desc|	string|	No	|Description|	255 characters
+desc|	string|	No 	|Description|	255 characters
 
 DocumentLink Complex Type Definition:
 
@@ -952,6 +952,8 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 url|	string|	No	|External URL|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 desc|	string|	No|	Description/Title	|255 characters
 
+DocumentFile Complex Type Definition
+
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 filename |	string |	No |	File Name |	255 characters
@@ -998,8 +1000,8 @@ awdamt	|string|	Yes - for AWARD 	|Award Amount|	64 digits
 linenbr|	string	|No|	Award Line Item Number	|255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 awddate	|date|	Yes - for AWARD|	Award Date	|YYYYMMDD
 stauth	|string	|Yes - for JA 	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| [Refer Stauth Valid Values](#stauth-valid-values)
-respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL	|Response Date	|YYYYMMDD
-archdate  |	date|	No - Either respdate or archdate required for SNOTE, SSALE, SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
+respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL	|Response Date	|YYYYMMDD
+archdate  |	date|	Yes - for SNOTE, SSALE 

 Either respdate or archdate required for SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
 awardee|	string|	Yes – for AWARD |	Awardee	|65535 characters
 awardee_duns|	string	|No	|Awardee DUNS	|9 digits with optional plus 4
 contact|	string|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL|	Contact Info|	255 characters
@@ -4080,23 +4082,23 @@ Element Name	|	Business Rules |	Error Messages with respect to business rules (I
 date 	|1. This field should meet the character limit/restrictions

 Note: Date field allows current date and also any date in past/future |	1. DATE field in unexpected format. Expects YYYYMMDD
 notice_type	|	1. This field is required where applicable |	1. Opportunity type is required
 zip|	NA |NA
-classcod	|1. This field is required where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. PSC code is required 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
+classcod	|1. This field is required where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. Product Service Code is a required field 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
 naics		|NA |  NAICS code is required
 offadd| Not Used|	NA
 officeid	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If user does not have access to an office but is trying to make a submission to that office, then the service throws an error

	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|	1. This field is required where appicable 	|1. $.data.title: is missing but it is required
-solnbr|	1. This field is required where applicable

  2. If submitting a notice with same solnbr number, then system throws an error 

3. If solnbr is in invalid format, then service throws an error

4. If solicitation & ntype combination is not matched, then service throws an error|	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype
+solnbr|	1. This field is required where applicable

  2. If submitting a notice with a duplicabe solnbr, then system throws an error 

3. If solnbr is in invalid format, then service throws an error

4. If solnbr & ntype combination is not matched, then service throws an error 

 |	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype 

5. Notice ID must be unique based on selected notice type
 ntype	 |1. When user tries to convert a notice and the solicitation number/ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values listed. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
 awdnbr|	1. This field is required where applicable|	1. Award Details Section - Contract Award Number is a required field
 donbr	|1. This field is required where applicable

 2. If value provided does not meet the character limit/restrictions, then service throws an error|	1. Award Details Section - Task/Delivery Order Number is required field

 2. Award Details Section - Task/Delivery Order Number - Please enter a valid number
 awdamt|	 	1. This field is required where applicable

 2. If an invalid integer values is given, then service throws an error 	|1. Award Details Section - Amount is a required field

 2. Award Details Section - Please enter valid integer for Amount Field
 linenbr|	NA	|NA
-awddate	|	1. This field should meet the character limit/restrictions (Note: Date field allows current date and also any date in past/future)

 2. This field is required where applicable|	1. DATE field in unexpected format. Expects YYYYMMDD

 2. Award Details Section - Contract Award Date is required field 

 3. Award Details Section - Contract Award Date provided is in an invalid format
-stauth|	 Both foja & stauth values will be given under stauth in legacy |	NA
+awddate	|	1. This field should meet the character limit/restrictions 

 2. This field is required where applicable 

 3. Date cannot be in the past|	1. DATE field in unexpected format. Expects YYYYMMDD

 2. Award Details Section - Contract Award Date is required field 

 3. Award Details Section - Contract Award Date provided is in an invalid format 

4. Award date provided is in the past. 

 5.Contract Award Date set would result in inactive date being in the past.
+stauth|	 1. This field is required where applicable 

 2. This field accepts only valid values listed. If invalid values are provided, then system throws an error.|	1. Contract Award Number is a required field 

2. Invalid Authority Fields, please refer to Contract Opportunities SOAP Web Service Tech Document valid authority fields
 respdate|	1.	This field is required where applicable 

 2.	This date cannot be in past; has to be in future. If the given date is in past, then system throws errors 	| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date 

 4. One of Response date or Archive date is required 

 5. One of Response date or Archive date is required
 archdate|	1.	This field is required where applicable. Note user may receive "Auto 30 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past. 

 3. One of Response date or Archive date is required
 awardee	|	NA|	NA
-awardee_duns|	NA|	NA
+awardee_duns|	1. Must provide a valid DUNS|	1. Unique Entity Identifier (duns) is invalid.
 contact	|	1. This field is required where applicable	|1. Primary Contact is Required
 desc| 	1. This field is required where applicable.|	1. Description is required
 link|	NA	| NA
@@ -4116,7 +4118,7 @@ correction|	1. When user tries to convert a notice and the solicitation number/n
 #### submitDocumentsAndLinksToNotice
 
 Individual business rules per field are listed across each of the fields in below table.  
-* Note: Users cannot verify the attachments/links on front end (UI.)
+* Note: Users cannot verify the attachments/links on front end (UI)
 * Note: When none of the fields are given the service throws an error - Links and/or Files are not complete
 * Note: When links/files are given but none of the other fields are given, then service throws an error - Multiple Notices found. Please input more details
 
@@ -4395,8 +4397,8 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8| Removed redundant Required and Character Limit columns from Business Rules section. Consolidated Business Rules section for all Submit methods. Updated submitMod and submitNotice methods to align with implemenation. 
-10/28/2019 | v0.81 | Updated the character limits
+10/28/2019 | v0.8| Added Notice Type and Related Notice sections for reference. Updated the character limits. Removed redundant Required and Character Limit columns from Business Rules section. Consolidated Business Rules section for all Submit methods. Updated submitMod and submitNotice methods to align with implemenation. 
+
 
 
Back to top

 

From 6f29d29e1b7dca5743f28e224a68d1be70dbb79f Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 16:28:33 -0400
Subject: [PATCH 082/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 75ef05499..90cf9312b 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2221,7 +2221,7 @@ Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
 resourceId | query | string | Yes | Resource ID
-Request JSON | Body | JSON | Yes | [Refer Update Attachment Link Contract JSON](#update-attachment-link-contract-json)
+Request JSON | Body | JSON | Yes | [Refer Update Attachment Link Contract JSON](#update-attachment-contract-json)
 
 
Back to top

 

From 713b55f542dd854083e994e896a6248145292564 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 16:42:18 -0400
Subject: [PATCH 083/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 9c3edc584..f65391127 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -1331,7 +1331,7 @@ solnbr|	string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -
 ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.| 32 characters
-reason	|string|	Yes|	rejection reason not used in this method|
+reason	|string|	Yes|	rejection reason not used in this method| 65535 characters
 
 Response:
 

From b9825566324d6116ca92a04a95f34c7242da7363 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Tue, 29 Oct 2019 19:44:13 -0400
Subject: [PATCH 084/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index f65391127..9e3d3a43c 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -15,7 +15,7 @@ The Opportunity Management SOAP APIs will allow authorized users to submit and r
 To view the WSDL for all available methods and object definitions, refer below links:
 
 * Alpha WSDL Link: https://api-alpha.sam.gov/prodlike/ws/fboendpoint/services.wsdl or https://api-alpha.sam.gov/prodlike/ws/fboendpoint/fbo.wsdl 
-* Beta WSDL Link: https://api.sam.gov/prod/ws/fboendpoint/services.wsdl or https://api.sam.gov/prod/ws/fboendpoint/fbo.wsdl
+* Beta WSDL Link: https://api.sam.gov/prod/ws/fboendpoint/services.wsdl or https://api.sam.gov/prod/ws/fboendpoint/fbo.wsdl (Coming Soon)
 
 ## SOAP Web Services Workflow Chart
 To view the current workflow of SOAP web service, refer below file:
@@ -716,8 +716,8 @@ offadd |	String |	No |	Office Address (Deprecated). The Contracting office addre
 subject | 	String |	Yes |	Subject |	256 characters
 solnbr	| String |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 archdate |	Date |	Yes |	Archive Date |	YYYYMMDD
-contact |	String |	No	| Contact Info |	65535 characters
-desc |	String |	Yes |	Description |	255 characters
+contact |	String |	No	| Contact Info |	255 characters
+desc |	String |	Yes |	Description |	65535 characters
 link	| GovURL – complex type	| No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
 email |	GovEmail – complex type |	Yes |	Government Email	| 255 characters
 links |	DocumentLink[] 	| No |	Array Of links |
@@ -1013,7 +1013,7 @@ files	|DocumentFile[]|	No|	Array of files	|
 setaside|	string|	No|	[Refer Set-Aside Values](#set-aside-values) |	
 popaddress|	string|	No|	Place of Performace Addressress	|65535 characters
 popzip|	string	|No	|Place of Performace Zip	|5 digits
-popcountry|	string|	Yes – For wards; No – For rest|	Place of Performace Country|	32 characters
+popcountry|	string|	Yes – For Awards; No – For rest|	Place of Performace Country|	32 characters
 city|	string|	No	|City	|NA
 state|	string|	No|	State	|NA
 recovery_act	|boolean|	No|	Recovery Act|	True or False

From fc5add45b5269d4b48c47f5202114bbc63094cbf Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Wed, 30 Oct 2019 08:59:03 -0400
Subject: [PATCH 085/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 90cf9312b..dcdace768 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -37,10 +37,10 @@ To view the current workflow of REST APIs, refer below file:
 In order to utilize the Contract Opportunity Management API, the following is required:
 * Valid beta.SAM.GOV federal government system account with Read and Write permissions under Contract Opportunity domain.
 
-### *Type of Connection Validation (Future Implementation)*
+### Type of Connection Validation 
 All REST API requests will be validated against the Type of Connection within the system account profile. All requests without "REST API" type of connection in the system account profile will be rejected with an error.
 
-### *IP Address Validation (Future Implementation)*
+### IP Address Validation 
 All REST API requests will be validated against the IP Addresses registered within the system account profile. All requests that are not from registered IP address(es) in the system account profile will be rejected with an error.
 
 #### User Account Authorization

From e0d7dcaf84955fa141c1e413bb6680342e03444d Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Wed, 30 Oct 2019 11:29:51 -0400
Subject: [PATCH 086/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 9e3d3a43c..6d334de5c 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -183,7 +183,7 @@ Award Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date |	date |	Yes |	Posting Date |	YYYYMMDD
+date |	date |	No |	Posting Date |	YYYYMMDD
 zip |	string |	No |	Zip Code (Deprecated) |	5 digits
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g)) 
 naics |	string |	No |	NAICS Code |	Valid NAICS Code 
NAICS Reference
@@ -486,7 +486,7 @@ Mod Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	Yes - for AWARD  |	Posting Date |	YYYYMMDD
+date | date |	No  |	Posting Date |	YYYYMMDD
 zip |	string |	No |Zip Code (Deprecated) |	5 digits
 classcod |	string	 | Yes - for SOL, COMBINE, SSALE, ITB, JA   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
 naics | 	string |	Yes - for COMBINE, SOL  | 	NAICS Code |	Valid NAICS Code  
NAICS Reference

From 947e1527ea090a2c7cb89b02ef16219e3c30fba7 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Wed, 30 Oct 2019 13:23:31 -0400
Subject: [PATCH 087/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 6d334de5c..a317cd5ff 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -347,7 +347,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date |	YYYYMMDD
 zip |	string | No |	Zip Code (Deprecated) | 5 digits
-classcod | string |	No |	Class-Code | Valid classification code (FAR, Section 5.207(g))
+classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics |	string | No |	NAICS Code | Valid NAICS Code  
NAICS Reference
 officeid | string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
 offadd | string |	No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
@@ -987,7 +987,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date|	date|	No	|Posting Date|	YYYYMMDD
 notice_type	|string	|Yes|	 [Refer Notice Types](#notice-types)	|
 zip	|string	|No	|Zip Code (Deprecated)|	5 digits
-classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA  |	Class-Code	|Valid classification code (FAR, Section 5.207(g))
+classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA, PRESOL  |	Class-Code	|Valid classification code (FAR, Section 5.207(g))
 naics	|string	|Yes - for COMBINE, SOL	|NAICS Code|	Valid NAICS Code  
NAICS Reference
 officeid|	String|	Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	|20 characters
 offadd	|string|	No|	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	|65535 characters
@@ -1000,8 +1000,8 @@ awdamt	|string|	Yes - for AWARD 	|Award Amount|	64 digits
 linenbr|	string	|No|	Award Line Item Number	|255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 awddate	|date|	Yes - for AWARD|	Award Date	|YYYYMMDD
 stauth	|string	|Yes - for JA 	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| [Refer Stauth Valid Values](#stauth-valid-values)
-respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL	|Response Date	|YYYYMMDD
-archdate  |	date|	Yes - for SNOTE, SSALE 

 Either respdate or archdate required for SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
+respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL, SSALE	|Response Date	|YYYYMMDD
+archdate  |	date| Either respdate or archdate required for SRCSGT, PRESOL, SSALE, SNOTE|	Archive Date|	YYYYMMDD
 awardee|	string|	Yes – for AWARD |	Awardee	|65535 characters
 awardee_duns|	string	|No	|Awardee DUNS	|9 digits with optional plus 4
 contact|	string|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL|	Contact Info|	255 characters

From 9b71867258f82092b33ec4764f5f253440101e28 Mon Sep 17 00:00:00 2001
From: Diego Ruiz 
Date: Wed, 30 Oct 2019 15:41:18 -0400
Subject: [PATCH 088/149] tweak

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index dcdace768..cff6a3e6c 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3098,7 +3098,7 @@ solicitation | JSON |NA | NA | NA | NA |
 solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code.
 The designator for type of set aside determined for the contract action
 solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
 solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
-solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
+solicitation.deadlines.
responseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
 award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for  'Award Notice' and 'Justification' opportunity types
 award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date
 award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number

From dc53a030022839d1972341f14264537c0ef62033 Mon Sep 17 00:00:00 2001
From: Diego Ruiz 
Date: Wed, 30 Oct 2019 16:19:43 -0400
Subject: [PATCH 089/149] tweak

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index cff6a3e6c..02e860f4f 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3362,7 +3362,7 @@ solicitation | JSON |NA | NA | NA | NA |
 solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code. 
The designator for type of set aside determined for the contract action
 solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
 solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
-solicitation.deadlines.
responseresponseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
+solicitation.deadlines.
responseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
 award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for  'Award Notice' and 'Justification' opportunity types
 award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date
 award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number

From 6ca9ff49134c82559cf240bac8e7d4aa2a1cfa0a Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Wed, 30 Oct 2019 17:08:41 -0400
Subject: [PATCH 090/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 37 +++++++++++++++++++++++++++++------
 1 file changed, 31 insertions(+), 6 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 02e860f4f..9f0a6ea39 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3776,12 +3776,17 @@ Error codes may change depending on the error given; document will be updated ac
 Error Code|Field | Error Message | Reason/Description | Operation
 -----|------|---------------|--------------------|----------
 400|Additional Reporting |	This opportunity cannot be published. Additional reporting is required. |	Additional Reporting is required with valid values of “none” or “recovery_act”	| Publish
+400|Additional Reporting |	Additional Reporting/Initiative is required. |	Additional Reporting/Initiative is required when opportunity is not a special notice | Publish
+400|Title |	Title max character length is 256. |	Title max character length is 256.	| Publish
 400|ARCHIVE |	This opportunity is not the latest published. |	Draft Opportunity cannot be archived.	| Archive
 400|Archive Date |	$.archive.date: does not match the date pattern ^\\d{4}-(?:0[0-9]{1}\1[0-2]{1})-(0?[1-9]\[12][0-9]\3[01])$ |	Archive Date must be in specified format |	Create, Publish, Uncancel, Unarchive
 400|Archive Date |	This opportunity cannot be published. Inactive date is a required field. |	Archive Date is required if Archive Type = autocustom |	Create, Publish, Uncancel, Unarchive
+400|Archive Date Response Date   |	One of Response date or Archive date is required |	Either Response date or archive date is required for presolicitation, sources sought, special notice, sale surplus  |	Publish
+400|Archive Date |	Inactive date provided is an invalid format. |	Date is not in specified format  |	Create, Publish, Uncancel, Unarchive
 400|Archive Type |	This opportunity cannot be published. Inactive Policy is a required field. |	Archive Type is required |	Publish
 400|Archive Type |	$.archive.type: does not have a value in the enumeration[auto15, auto30, autocustom] |	Archive type must be specified value | Create, Publish, Uncancel, Unarchive
 400|Archive Type |	This opportunity cannot be published. Auto 15 archive type is not allowed for this opportunity type. | Archive Type = auto15 not allowed |	Publish
+400|Archive Type |	Auto 30 archive type is not allowed for this opportunity type. | Archive Type = auto30   not allowed for Intent bundle and Justification |	Publish
 400|attType |	Attachment must have AttType of file or link |	Attachment type must be a file or a line |	Create Attachment
 401|Authorization |	Insufficient privileges to edit opportunity |	See User Account Authorization section |	Update, Publish, Revise
 401|Authorization |	Insufficient privileges to create opportunity |	Insufficient privileges to create an award notice. See User Account Authorization section for more details. |	Create Opportunity
@@ -3791,7 +3796,9 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Award Amount |	Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type |	Contract Award Amount only valid for Type "a" Award |	Publish
 400|Award Date |	Award Details Section - Contract Award Date provided is in an invalid format. |	Date is not in specified format |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Award Details section -Award date provided is in the past. |	Award Date must be current or future date. |	Create Opportunity, Publish, Uncancel, Unarchive
+400|Award Date |	Award Details section -Contract Award Date set would result in inactive date being in the past. |	Contract Award Date set would result in inactive date being in the past. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Number |	Award Details Section - Contract Award Number is a required field	| Contract Award Number is missing | Publish, Uncancel, Unarchive
+400|Contract Line Item number |	The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.	| The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | All
 400|Classification Code |	This opportunity cannot be published. Classification Code provided did not match expected codes |	Invalid PSC provided |	Publish
 400|CANCEL |	This opportunity cannot be cancelled. This opportunity is a revision. |	Cannot cancel a revised Opportunity. |	Cancel
 400|Content |	File Resource must have content. |	File Resource must be filled out | Create Attachment
@@ -3801,25 +3808,43 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Deadlines Response | This opportunity cannot be published. | Response Deadline Date is required |	Publish
 400|Description |	Description is required |	Description is required |	Publish
 400|IVL |	This opportunity cannot be published. Interested Vendors List Add is a required field. |Interested Vendors List Add is a required |	Publish
+400|IVL |	Interested Vendors List Read is a required field. |Interested Vendors List Read is a required field. |	Publish
+400|IVL |	Interested Vendors List should be enabled for this organization. |Interested Vendors List should be enabled for this organization when FORCE ON |	Publish
+400|IVL |	Interested Vendors List should not be enabled for this organization. |Interested Vendors List should not be enabled for this organization when FORCE OFF |	Publish
 400|Justification Authority |	This opportunity cannot be published. Justification Authority is not valid field for this opportunity type | Justification Authority Section is not valid for Base Notice Types (s, o, p, r, g, k, i) | Publish
 400|Justification Authority |	This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type. | Justification Authority Section is not valid for Base Notice Types (s, o, p, r, g, k, i) | Publish
 400|Justification Authority |	This opportunity cannot be published. Justification Authority is not valid field for this opportunity type | Justification Authority only valid for Type "u" Justification and Authorization | Publish
 400|Justification Authority |	This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type | Justification Authority Modification Number is only valid for Type "u" Justification and Authorization | Publish
 400|NAICS Code | This opportunity cannot be published. NAICS provided did not match expected codes | NAICS Code is invalid | Create Opportunity, Publish
 400|NAICS Type | $.data.naics[0].type: does not have a value in the enumeration [primary] | NAICS Type is required | Create Opportunity
-400|Notice Type |	This opportunity cannot be published. The opportunity type `j` is no longer supported	| [Refer Notice Types](#notice-types) for valid notice types |	Publish
+400|Notice Type |	This opportunity cannot be published. The inactive type `manual` is no longer supported.	| See Notice Types table for valid notice types |	Publish
+400|Notice Type |	The opportunity type `j` is no longer supported	| See Notice Types table for valid notice types |	Publish
+400|Notice Type |	The opportunity type `m` is no longer supported	| See Notice Types table for valid notice types |	Publish
+400|Notice Type |	The opportunity type `l` is no longer supported	| See Notice Types table for valid notice types |	Publish
 400|Opportunity ID | Opportunity ID for the selected opportunity type already exists | Cannot publish an existing published record | Publish
 400|Opportunity ID | Opportunity cannot be updated | An Opportunity cannot be revised if that Opporutnity was revised previously and is currently in draft state  | Revise
-404|Opportunity ID | Opportunity ID is required	| Opportunity ID is required | All
+404|Notice ID | Notice ID is required	| Notice ID is required | All
+400|Notice ID | Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.	| Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | All
+400|Notice ID | Notice ID must be unique based on selected notice type.	| Notice ID must be unique when selected notice type is not an award notice. | All
+400|Notice ID | Submitted solicitation number doesn't match the previous published opportunity	| Submitted solicitation number doesn't match the previous published opportunity for award notice type | All
+400|Related Notice ID | This Related Notice's ID is invalid	| The Related Notice's ID is not found | All
+400|Related Notice ID | The Related Notice's Type is invalid for this Opportunity	| The Related Notice's Type cannot be related  | All
+400|Related Notice ID | Related Notice's ID needs to match previous Opportunity's Related Notice ID	| Related Notice's ID needs to match previous Opportunity's Related Notice ID  | All
 400|Opportunity Type | Opportunity type is required | Opportunity type is required | Create Opportunity
 400|Opportunity Type | errorCode":400,"message":"Opportunity type given is not a valid type." |	Opportunity type is empty |	Create Opportunity
-400|Organization Id |	Contracting office is required | FH Org Id/AAC code is required |	Publish
-400|Organization Id |	The Organization ID that you provided is an inactive and/or invalid. | Inactive/Invalid Organization Id |	Create Opportunity
-400|Organization Id |	The Organization ID that you provided is not an office level, and it must be for this opportunity type.	| Organization ID is not valid for opportunity type. Note: Organization ID must be Office level unless creating a Special Notice.	| Create Opportunity
+400|Organization Id |	Contracting Office is a required field. | FH Org Id/AAC code is required |	Publish
+400|Organization Id |	The Federal Organization ID that you provided is inactive and/or invalid. | Inactive/Invalid Organization Id |	Create Opportunity
+400|Organization Id |	The Federal Organization ID that you provided is not an office level, and it must be for this opportunity type.	| Organization ID is not valid for opportunity type. Note: Organization ID must be Office level unless creating a Special Notice.	| Create Opportunity
+400|Organization Id |	The Federal Organization ID that you provided is unmapped in Federal Hierarchy. | Organization ID length should be greater than 10 |	Publish
 400|Point of Contact Type |	$.data.pointOfContact[0].type: does not have a value in the enumeration [primary, secondary, owner] |	Point of Contact Type is required |	Create Opportunity
 400|Point of Contact Email |	Primary Contact – Email is required	| If Contact email is missing. This is a required field	| Publish
 400|Primary Contact Full Name |	Primary Contact - Name is required | Point of Contact Full Name is required | Publish
-400|Response Date |	This opportunity cannot be published. Response Date is a required field |	Response Date is only valid for Notice Type “o” |	Publish
+400|Response Date |	Response Date is a required field |	Response Date is only valid for Notice Type “o” |	Publish
+400|Response Date |	Response Date provided is an invalid format. |	Response Date provided is an invalid format. |	Publish
+400|Response Date |	Response Date cannot be in the past. |	Response Date cannot be in the past. |	Publish
+400|Response Date |	Response Date set would result in inactive date being in the past. |	Response Date provided is within 15 days |	Publish
+400|Response Date |	Auto 15 archive type is not allowed for this opportunity type. |	Auto 15 archive type is not allowed for award notice |	Publish
+400|Response Date |	Response Date cannot exceed 5 years from current date. |	Response Date cannot exceed 5 years from current date. |	Publish 
 400|Title |	Title is required |	Title is required |	Publish
 400|UNARCHIVE |	This opportunity is not the latest published |	Only archived notices can be unarchived | UNARCHIVE
 400|resourceName | Attachment must have a name | File Name is a required field |	Create Attachment

From d118af1fba583c86c246a0a43ba7989aa6033a90 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Wed, 30 Oct 2019 17:19:08 -0400
Subject: [PATCH 091/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 9f0a6ea39..380224283 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3806,7 +3806,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 401|CREATE | Insufficient privileges to create opportunity |	Account does not have appropriate privileges to create opportunity | CREATE
 401|CREATE ATTACHMENT |	Insufficient privileges to upload attachment | Attachments cannot be added to published notices |	Create Attachment
 400|Deadlines Response | This opportunity cannot be published. | Response Deadline Date is required |	Publish
-400|Description |	Description is required |	Description is required |	Publish
+400|Description |	Description is a required field |	Description is a required field except for award notice |	Publish
 400|IVL |	This opportunity cannot be published. Interested Vendors List Add is a required field. |Interested Vendors List Add is a required |	Publish
 400|IVL |	Interested Vendors List Read is a required field. |Interested Vendors List Read is a required field. |	Publish
 400|IVL |	Interested Vendors List should be enabled for this organization. |Interested Vendors List should be enabled for this organization when FORCE ON |	Publish

From 5aec74f5ee8f1ae7162fb254a9575e0a61beaa70 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Wed, 30 Oct 2019 18:06:12 -0400
Subject: [PATCH 092/149] update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 3f6edb65a..f2cf6d41a 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -844,7 +844,7 @@ zip |	string | No |	Zip Code (Deprecated) | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
 officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
-offadd | string | No | Office Address	| 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
+offadd | string | No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	| 65535 characters
 subject | string | Yes | Subject | 256 characters
 solnbr | string |	Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes  | Response Date | YYYYMMDD
@@ -1266,7 +1266,8 @@ solnbr|	string	|Yes|	Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_
 ntype	|string	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.|  32 characters
-
+vendor	|VendorData|	No|	Complex type not used in this method|
+reason	|string|	No|	rejection reason not used in this method| 65535 characters
 
 Response:
 
@@ -1291,7 +1292,9 @@ Element Name	|Type	|Required|	Description | Character Limit / Restrictions
 solnbr	|string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 ntype|	string|	No|	Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method|
-vendor|	VendorData	|Yes|	Complex type defined below|
+Id	|string	|No	|Not used in this method| 32 characters
+vendor	|VendorData|	Yes|	Complex type defined below|
+reason	|string|	No|	rejection reason not used in this method| 65535 characters
 
 Response:
 
@@ -1329,7 +1332,8 @@ solnbr|	string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -
 ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.| 32 characters
-reason	|string|	Yes|	rejection reason not used in this method|
+vendor	|VendorData|	No|	Complex type not used in this method|
+reason|	string|	Yes	|Rejection Reason | 65535 characters
 
 Response:
 
@@ -1355,6 +1359,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method|
+Id	|string	|No	|Not used in this method| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
 reason|	string|	Yes	|Rejection Reason | 65535 characters
 
@@ -1391,8 +1396,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.|
-Id	|string	|No	|Not used in this method|
+Id	|string	|No	|Not used in this method| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
+reason	|string|	No|	rejection reason not used in this method| 65535 characters
 
 Response:
 

From 1b066302cb00957ad49b721e6cc1d9208b9a9fff Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Wed, 30 Oct 2019 18:30:13 -0400
Subject: [PATCH 093/149] update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index b36b9215c..0ee8dfdb6 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -1269,7 +1269,7 @@ ntype	|string	|No|	Notice Type	| [Refer Notice Types](#notice-types)
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.|  32 characters
 vendor	|VendorData|	No|	Complex type not used in this method|
-reason	|string|	No|	rejection reason not used in this method| 65535 characters
+reason	|string|	No|	Rejection reason not used in this method| 65535 characters
 
 Response:
 
@@ -1296,7 +1296,7 @@ ntype|	string|	No|	Notice Type	| [Refer Notice Types](#notice-types)
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id	|string	|No	|Not used in this method| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
-reason	|string|	No|	rejection reason not used in this method| 65535 characters
+reason	|string|	No|	Rejection reason not used in this method| 65535 characters
 
 Response:
 
@@ -1400,7 +1400,7 @@ ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types)
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.|
 Id	|string	|No	|Not used in this method| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
-reason	|string|	No|	rejection reason not used in this method| 65535 characters
+reason	|string|	No|	Rejection reason not used in this method| 65535 characters
 
 Response:
 

From c598f0e675ce0f6da5120f7c97877273660c3060 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Wed, 30 Oct 2019 23:27:49 -0400
Subject: [PATCH 094/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 380224283..eb140809e 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3838,7 +3838,13 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Organization Id |	The Federal Organization ID that you provided is unmapped in Federal Hierarchy. | Organization ID length should be greater than 10 |	Publish
 400|Point of Contact Type |	$.data.pointOfContact[0].type: does not have a value in the enumeration [primary, secondary, owner] |	Point of Contact Type is required |	Create Opportunity
 400|Point of Contact Email |	Primary Contact – Email is required	| If Contact email is missing. This is a required field	| Publish
+400|Primary Contact |	Primary Contact is required | Primary Contact is required | Publish
 400|Primary Contact Full Name |	Primary Contact - Name is required | Point of Contact Full Name is required | Publish
+400|Primary Contact Full Name |	Primary Contact - Name limit is 255 characters. | Point of Contact Name limit is 255 characters | Publish
+400|Primary Contact Email |	Primary Contact - Please enter a valid Internet email address. Format: username@host.domain. | Primary Contact invalid Email format | Publish
+400|Primary Contact Email |	Primary Contact - email character limit is 255 characters. | Primary Contact email limit is 255 | Publish
+400|Primary Contact Phone |	Primary Contact - phone character limit is 255 characters. | Primary Contact phone limit is 255 | Publish
+400|Primary Contact Phone |	Primary Contact - fax character limit is 255 characters. | Primary Contact fax limit is 255 | Publish
 400|Response Date |	Response Date is a required field |	Response Date is only valid for Notice Type “o” |	Publish
 400|Response Date |	Response Date provided is an invalid format. |	Response Date provided is an invalid format. |	Publish
 400|Response Date |	Response Date cannot be in the past. |	Response Date cannot be in the past. |	Publish

From 4b78f75708a5814665d6dde5ff4f0d367fdf1be0 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Wed, 30 Oct 2019 23:31:05 -0400
Subject: [PATCH 095/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index eb140809e..252e4e598 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3815,7 +3815,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Justification Authority |	This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type. | Justification Authority Section is not valid for Base Notice Types (s, o, p, r, g, k, i) | Publish
 400|Justification Authority |	This opportunity cannot be published. Justification Authority is not valid field for this opportunity type | Justification Authority only valid for Type "u" Justification and Authorization | Publish
 400|Justification Authority |	This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type | Justification Authority Modification Number is only valid for Type "u" Justification and Authorization | Publish
-400|NAICS Code | This opportunity cannot be published. NAICS provided did not match expected codes | NAICS Code is invalid | Create Opportunity, Publish
+400|NAICS Code | NAICS provided did not match expected codes | NAICS Code is invalid | Create Opportunity, Publish
 400|NAICS Type | $.data.naics[0].type: does not have a value in the enumeration [primary] | NAICS Type is required | Create Opportunity
 400|Notice Type |	This opportunity cannot be published. The inactive type `manual` is no longer supported.	| See Notice Types table for valid notice types |	Publish
 400|Notice Type |	The opportunity type `j` is no longer supported	| See Notice Types table for valid notice types |	Publish

From a92eb559f9305c09f428fb4b634e1abcef8873fd Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Wed, 30 Oct 2019 23:33:36 -0400
Subject: [PATCH 096/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 252e4e598..0904993d4 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3799,7 +3799,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Award Date |	Award Details section -Contract Award Date set would result in inactive date being in the past. |	Contract Award Date set would result in inactive date being in the past. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Number |	Award Details Section - Contract Award Number is a required field	| Contract Award Number is missing | Publish, Uncancel, Unarchive
 400|Contract Line Item number |	The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.	| The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | All
-400|Classification Code |	This opportunity cannot be published. Classification Code provided did not match expected codes |	Invalid PSC provided |	Publish
+400|Classification Code | Classification Code provided did not match expected codes |	Invalid PSC provided |	Publish
 400|CANCEL |	This opportunity cannot be cancelled. This opportunity is a revision. |	Cannot cancel a revised Opportunity. |	Cancel
 400|Content |	File Resource must have content. |	File Resource must be filled out | Create Attachment
 400|Contract Award Dollar Amount |	Award Details Section – Please enter valid integer for Amount Field	| Valid integer amount must be entered for award dollar amount | Publish

From 7f5356031e1038010c3bb3a2e9c51cb82da2790a Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Wed, 30 Oct 2019 23:47:13 -0400
Subject: [PATCH 097/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 0904993d4..d9e0664dd 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3816,6 +3816,9 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Justification Authority |	This opportunity cannot be published. Justification Authority is not valid field for this opportunity type | Justification Authority only valid for Type "u" Justification and Authorization | Publish
 400|Justification Authority |	This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type | Justification Authority Modification Number is only valid for Type "u" Justification and Authorization | Publish
 400|NAICS Code | NAICS provided did not match expected codes | NAICS Code is invalid | Create Opportunity, Publish
+400|Set Aside | Set Aside is not valid field for this opportunity type. | Set Aside is invalid | Create Opportunity, Publish
+400|Set Aside | Contracting Office is a required for Set Aside. | Contracting Office is a required for Set Aside. | Create Opportunity, Publish
+400|Set Aside | Set Aside provided did not match expected codes | Set Aside provided did not match expected codes | Create Opportunity, Publish
 400|NAICS Type | $.data.naics[0].type: does not have a value in the enumeration [primary] | NAICS Type is required | Create Opportunity
 400|Notice Type |	This opportunity cannot be published. The inactive type `manual` is no longer supported.	| See Notice Types table for valid notice types |	Publish
 400|Notice Type |	The opportunity type `j` is no longer supported	| See Notice Types table for valid notice types |	Publish

From e07bed3bb2bd62df79f1371bd0686675dd68dca4 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 00:03:41 -0400
Subject: [PATCH 098/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index d9e0664dd..a214dc75a 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3792,6 +3792,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 401|Authorization |	Insufficient privileges to create opportunity |	Insufficient privileges to create an award notice. See User Account Authorization section for more details. |	Create Opportunity
 401|Authorization |	Insufficient privileges to create request |	Insufficient privileges to publish an award notice. See User Account Authorization section for more details. |	Create
 400|Award |	Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type |	Award Section is not valid for Base Notice Types (s, o, p, r, g, k, i) |	Publish
+400|Award |	Award Details Section is missing data. | Award Details Section is missing data. |	Publish
 400|Award Amount |	Award Detail Section-Please enter valid integer for Amount Field |	Award Amount required |	Publish
 400|Award Amount |	Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type |	Contract Award Amount only valid for Type "a" Award |	Publish
 400|Award Date |	Award Details Section - Contract Award Date provided is in an invalid format. |	Date is not in specified format |	Create Opportunity, Publish, Uncancel, Unarchive

From 5830f5138d4b7d1d3cc3a7eed0d4255a007dc7ef Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 00:10:08 -0400
Subject: [PATCH 099/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index a214dc75a..d492eed3a 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3795,7 +3795,9 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Award |	Award Details Section is missing data. | Award Details Section is missing data. |	Publish
 400|Award Amount |	Award Detail Section-Please enter valid integer for Amount Field |	Award Amount required |	Publish
 400|Award Amount |	Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type |	Contract Award Amount only valid for Type "a" Award |	Publish
+400|Award Date |	Contract Award Date is required field. |	Contract Award Date is required field. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Award Details Section - Contract Award Date provided is in an invalid format. |	Date is not in specified format |	Create Opportunity, Publish, Uncancel, Unarchive
+400|Award Date |	Contract Award Date provided should have 4 digit year. | Contract Award Date provided should have 4 digit year. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Award Details section -Award date provided is in the past. |	Award Date must be current or future date. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Award Details section -Contract Award Date set would result in inactive date being in the past. |	Contract Award Date set would result in inactive date being in the past. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Number |	Award Details Section - Contract Award Number is a required field	| Contract Award Number is missing | Publish, Uncancel, Unarchive

From a6b36adcb3e6dd677d896f003513c7bdf6e11339 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 00:23:24 -0400
Subject: [PATCH 100/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index d492eed3a..a1ec08ffa 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3796,11 +3796,12 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Award Amount |	Award Detail Section-Please enter valid integer for Amount Field |	Award Amount required |	Publish
 400|Award Amount |	Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type |	Contract Award Amount only valid for Type "a" Award |	Publish
 400|Award Date |	Contract Award Date is required field. |	Contract Award Date is required field. |	Create Opportunity, Publish, Uncancel, Unarchive
-400|Award Date |	Award Details Section - Contract Award Date provided is in an invalid format. |	Date is not in specified format |	Create Opportunity, Publish, Uncancel, Unarchive
+400|Award Date |	Contract Award Date provided is in an invalid format. |	Date is not in specified format |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Contract Award Date provided should have 4 digit year. | Contract Award Date provided should have 4 digit year. |	Create Opportunity, Publish, Uncancel, Unarchive
-400|Award Date |	Award Details section -Award date provided is in the past. |	Award Date must be current or future date. |	Create Opportunity, Publish, Uncancel, Unarchive
-400|Award Date |	Award Details section -Contract Award Date set would result in inactive date being in the past. |	Contract Award Date set would result in inactive date being in the past. |	Create Opportunity, Publish, Uncancel, Unarchive
-400|Award Number |	Award Details Section - Contract Award Number is a required field	| Contract Award Number is missing | Publish, Uncancel, Unarchive
+400|Award Date |	Award date provided is in the past. |	Award Date must be current or future date. |	Create Opportunity, Publish, Uncancel, Unarchive
+400|Award Date |	Contract Award Date set would result in inactive date being in the past. |	Contract Award Date set would result in inactive date being in the past. |	Create Opportunity, Publish, Uncancel, Unarchive
+400|Award Number |	Contract Award Number is a required field	| Contract Award Number is missing | Publish, Uncancel, Unarchive
+400|Award Number |	Contract Award Number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.| Contract Award Number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | Publish, Uncancel, Unarchive
 400|Contract Line Item number |	The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.	| The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | All
 400|Classification Code | Classification Code provided did not match expected codes |	Invalid PSC provided |	Publish
 400|CANCEL |	This opportunity cannot be cancelled. This opportunity is a revision. |	Cannot cancel a revised Opportunity. |	Cancel

From fd365adc3283ecf7cc9f19021d6131aae7674d42 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 01:10:29 -0400
Subject: [PATCH 101/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 420 ++++++++++++++---------------
 1 file changed, 210 insertions(+), 210 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index a317cd5ff..6bf2f06cc 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -183,7 +183,7 @@ Award Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date |	date |	No |	Posting Date |	YYYYMMDD
+date |	date |	No |	Posting Date (Deprecated) |	YYYYMMDD
 zip |	string |	No |	Zip Code (Deprecated) |	5 digits
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g)) 
 naics |	string |	No |	NAICS Code |	Valid NAICS Code 
NAICS Reference
@@ -192,50 +192,50 @@ officeid |	string |	Yes |	Office ID of the office where an opportunity is being
 subject |	string |	Yes |	Subject |	256 characters
 solnbr |	string |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype	| string |	No |	 [Refer Related Notices](#related-notices) |		
-awdnbr |String |	 Yes |	Award Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {} 
+awdnbr | string |	 Yes |	Award Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {} 
 awdamt |	string |	Yes |	Award Amount |	64 digits
 linenbr |	string |	No |	Line Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 awddate |	date |	Yes |	Award Date |	YYYYMMDD
 archdate |	date |	No |	Archive Date |	YYYYMMDD
-awardee |	string |	Yes |	Awardee |	255 characters
-awardee_duns |	string |	No |	Awardee DUNS |	9 digits with optional plus 4
+awardee |	string |	No; Either awardee or awardee_duns is required |	Awardee |	255 characters
+awardee_duns |	string |	No; No; Either awardee or awardee_duns is required |	Awardee DUNS |	9 digits with optional plus 4
 contact |	string |	No |	Contact Info |	255 characters
 desc |	string |	No |	Description |	65535 characters
-link |	GovURL |	No |	Government Link	|255 characters. Consist of a restricted set of characters (see URL specification - RFC 2396)
+link |	GovURL |	No |	Government Link	|
 email |	GovEmail |	No |	Government Email |	255 characters
 links |	DocumentLink[] |	No |	Array Of links |
 files |	DocumentFile[] |	No |	Array of files |
 setaside |	string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
-recovery_act |	boolean |	No |	Recovery Act |	True or False
+recovery_act |	boolean |	No |	Recovery Act |	True or False (default=False)
 correction |	boolean |	No |	Correction of previous Award |	True or False 
 If correcting a previously submitted Award notice, specify True and the system will lookup the award by award number and sol number if applicable.
 
 GovURL Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	No |	Description |	255 characters
+url |	string |	Yes |	Website Address |	255 characters
+desc |	string |	Yes |	Description |	255 characters
 
 GovEmail Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address | string |	No |	Email Address |	255 characters
+address | string |	Yes |	Email Address |	255 characters
 desc |	string |	No |	Description |	255 characters
 
 DocumentLink Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	No |	External URL |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	No |	Description/Title |	255 characters
+url |	string |	Yes |	External URL |	255 characters
+desc |	string |	Yes |	Description/Title |	255 characters
 
 DocumentFile Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	No |	File Name |	255 characters
-filedata |	base64binary |	No |	File Data |	250 MB
+filename |	string |	Yes |	File Name |	255 characters
+filedata |	base64binary |	Yes |	File Data |	250 MB
 desc |	string |	No |	Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -260,9 +260,9 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-solnbr |	string |	Yes; Solicitation # or Award # is required |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	No | Notice Type	| [Refer Notice Types](#notice-types) 
-awdnbr |  string | Yes; Solicitation # or Award # is required| Award # |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+solnbr |	string |	Yes; Either Solicitation # or Award # is required only for Award|	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
+ntype |	string |	No; Yes if there are multiple notices with same Solicitation # | Notice Type	| [Refer Notice Types](#notice-types) 
+awdnbr |  string | Yes; Either Solicitation # or Award # is required ony for Award| Award # |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 deletetype |	string |	No |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
 
@@ -286,10 +286,10 @@ ArchiveNotice Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date |	date |	No |	Posting Date | YYYYMMDD
+date |	date |	No |	Posting Date (Deprecated)| YYYYMMDD
 solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
 ntype |	string | No |	Notice Type	| [Refer Notice Types](#notice-types) 
-archdate | date |	No | New Archive Date – If none provided, notice will archive immediately | YYYYMMDD
+archdate | date |	No | Deprecated. Notice will archive immediately | YYYYMMDD
 officeid | string |	No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 
 ### Cancel Notice
 (CancelNotice) 
@@ -312,15 +312,15 @@ CancelNotice Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	No | Posting Date |	YYYYMMDD
+date | date |	No | Posting Date (Deprecated) |	YYYYMMDD
 offadd | string |	No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
-officeid | String | No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
+officeid | String | No |	OfficeID (Not in Use)|	20 characters
 subject |	string | No |	Subject |	256 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 ntype | string | No | [Refer Notice Types](#notice-types) 	| 
 awdnbr | string |	No | Award # |255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate | date |	No | Archive Date | YYYYMMDD
-contact | string | Yes | Contact Info | 255 characters
+contact | string | No | Contact Info | 255 characters
 desc | string | Yes |	Cancellation Description | 65535 characters
 
 ## Contracting Officer/Contracting 
Specialist Method Details
@@ -345,7 +345,7 @@ Presol Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	No | Posting Date |	YYYYMMDD
+date | date |	No | Posting Date (Deprecated) |	YYYYMMDD
 zip |	string | No |	Zip Code (Deprecated) | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics |	string | No |	NAICS Code | Valid NAICS Code  
NAICS Reference
@@ -357,21 +357,21 @@ respdate | date |	No - either respdate or archdate is required |	Response Date |
 archdate | date |	No - either respdate or archdate is required |	Archive Date | YYYYMMDD
 contact |	string | Yes |	Contact Info | 255 characters
 desc |string |Yes |	Description | 65535 characters
-link | GovURL – complex type | No |	Government Link has URL & description |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+link | GovURL – complex type | No |	Government Link has URL & description |	255 characters
 email |	GovEmail – complex type |	Yes | Government Email | 255 characters
 links | DocumentLink[] | No |	Array of links |
 files |	DocumentFile[] | No |	Array of files |
 setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
-popaddress | string |	No | Place of Performace Address | 65535 characters
-popzip |string | No |	Place of Performace Zip | 5 digits
-popcountry | string |	No | Place of Performace Country | 32 characters
-recovery_act	| boolean |	No | Recovery Act | True or False
+popaddress | string |	No | Place of Performance Address | 65535 characters
+popzip |string | No |	Place of Performance Zip | 5 digits
+popcountry | string |	No | Place of Performance Country | 32 characters
+recovery_act	| boolean |	No | Recovery Act | True or False (default=False)
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+url	| string | No |	Website Address |	255 characters
 desc | string |	No | Description |	255 characters
 
 GovEmail Complex Type Definition:
@@ -385,15 +385,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url | string | No |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	No | Description/Title | 255 characters
+url | string | Yes |	External URL | 255 characters
+desc | string |	Yes | Description/Title | 255 characters
 
 DocumentFile Complex Type Definition: 
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename | string |	No | File Name | 255 characters
-filedata | base64binary |	No | File Data | 250 MB
+filename | string |	Yes  | File Name | 255 characters
+filedata | base64binary |	Yes | File Data | 250 MB
 desc | string |	No | Description | 65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -416,7 +416,7 @@ Combined Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	No | Posting Date |	YYYYMMDD
+date | date |	No | Posting Date (Deprecated) |	YYYYMMDD
 zip |	string | No |	Zip Code (Deprecated) | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
@@ -427,22 +427,22 @@ respdate | date |	Yes | Response Date | YYYYMMDD
 archdate | date |	No | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 255 characters
 desc | string |	Yes |	Description |	65535 characters
-link | GovURL – complex type | No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+link | GovURL – complex type | No |	Government Link	| 255 characters
 email |	GovEmail – complex type |	Yes | Government Email | 255 characters
 links |	DocumentLink[] | No |	Array Of links |
 files |	DocumentFile[] | No |	Array of files |
 setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
-popaddress | string |	No | Place of Performace Address | 65535 characters
-popzip | string |	No | Place of Performace Zip | 5 digits
-popcountry | string |	No | Place of Performace Country | 32 characters
-recovery_act | boolean | No |	Recovery Act | True or False
+popaddress | string |	No | Place of Performance Address | 65535 characters
+popzip | string |	No | Place of Performance Zip | 5 digits
+popcountry | string |	No | Place of Performance Country | 32 characters
+recovery_act | boolean | No |	Recovery Act | True or False (default = false)
 
 GovURL Complex Type Definition: 
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | No | Website Address | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	No |	Description |	255 characters
+url	| string | Yes | Website Address | 255 characters
+desc | string |	Yes  |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -455,15 +455,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | No |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	No | Description/Title | 255 characters
+url	| string | Yes |	External URL | 255 characters
+desc | string |	Yes | Description/Title | 255 characters
 
 DocumentFile Complex Type Definition: 
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename | string | No | File Name | 255 characters
-filedata | base64binary |	No | File Data | 250 MB
+filename | string | Yes | File Name | 255 characters
+filedata | base64binary |	Yes | File Data | 250 MB
 desc | string |	No | Description | 65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -486,35 +486,35 @@ Mod Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	No  |	Posting Date |	YYYYMMDD
+date | date |	No  |	Posting Date (Deprecated) |	YYYYMMDD
 zip |	string |	No |Zip Code (Deprecated) |	5 digits
-classcod |	string	 | Yes - for SOL, COMBINE, SSALE, ITB, JA   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
+classcod |	string	 | Yes - for SOL, COMBINE, SSALE, ITB, JA, PRESOL   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
 naics | 	string |	Yes - for COMBINE, SOL  | 	NAICS Code |	Valid NAICS Code  
NAICS Reference
 officeid |	string	| Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 offadd |	string	| No	| Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
-subject	| string	| no |	Subject |	256 characters
-solnbr | string |	Yes, EXCEPT No - Only for SNOTE | 	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
+subject	| string	| Yes |	Subject |	256 characters
+solnbr | string |	Yes | 	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype |	string |	Yes |	 Notice Type |	Valid values: PRESOL, COMBINE, SRCSGT, SSALE, SNOTE, SOL
-respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL	|Response Date	|YYYYMMDD
-archdate  |	date|	Yes - for SNOTE, SSALE 

 Either respdate or archdate required for SRCSGT, PRESOL|	Archive Date|	YYYYMMDD
-contact |	string |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL |	Contact Info |	255 characters
-desc |	string |	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE	| Description |	65535 characters
-link	| GovURL – complex type |	No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email |	GovEmail – complex type |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL, SNOTE |	Government Email |	255 characters
+respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL, SNOTE, SSALE	|Response Date	|YYYYMMDD
+archdate  |	date|	No- Either respdate or archdate required for SRCSGT, PRESOL, SNOTE, SSALE|	Archive Date|	YYYYMMDD
+contact |	string |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, SOL |	Contact Info |	255 characters
+desc |	string |	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, SOL, SNOTE	| Description |	65535 characters
+link	| GovURL – complex type |	No |	Government Link |	255 characters
+email |	GovEmail – complex type |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, SOL |	Government Email |	255 characters
 links |	DocumentLink[] |	No |	Array Of links |
 files |	DocumentFile[] |	No |	Array of files |
 setaside |	string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
-popaddress |	string |	No	 | Place of Performace Address |	65535 characters
-popzip	| string |	No	 | Place of Performace Zip |	5 digits
-popcountry |	string |	No	 | Place of Performace Country |	32 characters
-recovery_act |	boolean |	No |	Recovery Act |	True or False
+popaddress |	string |	No	 | Place of Performance Address |	65535 characters
+popzip	| string |	No	 | Place of Performance Zip |	5 digits
+popcountry |	string |	No	 | Place of Performance Country |	32 characters
+recovery_act |	boolean |	No |	Recovery Act |	True or False (Default = False)
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string	| No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	No |	Description |	255 characters
+url	| string	| Yes |	Website Address |	255 characters
+desc |	string |	Yes |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -527,15 +527,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url | 	string	| No |	External URL |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	No |	Description/Title |	255 characters
+url | 	string	| Yes |	External URL |	255 characters
+desc |	string |	Yes |	Description/Title |	255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string	| No | 	File Name |	255 characters
-filedata |	base64binary |	No |	File Data	| 250 MB
+filename |	string	| Yes | 	File Name |	255 characters
+filedata |	base64binary |	Yes |	File Data	| 250 MB
 desc |	string |	No |	Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -558,7 +558,7 @@ JA Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | Date	| No |	Posting Date |	YYYYMMDD
+date | Date	| No |	Posting Date (Deprecated) |	YYYYMMDD
 zip |	String |	No	| Zip Code (Deprecated) |	5 digits
 classcod	| String |	Yes |	Class-Code |	Valid classification code
 naics	| String |	No	| NAICS Code	| Valid NAICS Code  
NAICS Reference
@@ -570,25 +570,25 @@ ntype	| string |	No	| [Refer Related Notices](#related-notices)  |
 stauth	| String	| Yes |	J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy |	[Refer Stauth Valid Values](#stauth-valid-values)
 awdnbr |	String |	Yes |	Award Number |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 modnbr |	String |	No |	Mod Number |	32 characters
-awdamt |	String |	No |	Award Amount |	64 digits
+awdamt |	String |	No |	Award Amount (Not in Use) |	64 digits
 awddate |	Date |	No	| Award Date |	YYYYMMDD
 donbr	| String |	Yes |	Task/Delivery Order Number |	255 characters from the set: a-z A-Z 0-9 - _ ( )
 archdate  |	Date |	No |	Archive Date |	YYYYMMDD
 contact |	String |	Yes | 	Contact Info |	255 characters
 desc |	String |	No |	Description	| 65535 characters
-link |	GovURL |	No	| Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+link |	GovURL |	No	| Government Link |	255 characters
 links |	DocumentLink[]	| No |	Array Of links	|
 files |	DocumentFile[]	| No |	Array of files	|
 email |	GovEmail |	Yes | 	Government Email |	255 characters
-recovery_act |	boolean |	No |	Recovery Act |	True or False;
+recovery_act |	boolean |	No |	Recovery Act |	True or False (Default = False)
 correction	| boolean |	No |	Correction of previous J&A |	True or False 
 If correcting a previously submitted J&A notice, specify True and the system will lookup the j&a by award number and sol number if applicable.
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string |	No |	Website Address	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	| string	| No |	Description |	255 characters
+url |	string |	Yes |	Website Address	| 255 characters
+desc	| string	| Yes |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -601,15 +601,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url |	string	| No |	External URL	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	No |	Description/Title |	255 characters
+url |	string	| Yes |	External URL	| 255 characters
+desc |	string |	Yes |	Description/Title |	255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string	| No |	File Name	| 255 characters
-filedata |	base64binary |	No |	File Data	| 250 MB
+filename |	string	| Yes  |	File Name	| 255 characters
+filedata |	base64binary |	Yes |	File Data	| 250 MB
 desc	| string |	No |	Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -632,7 +632,7 @@ SourcesSought Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date |	date |	No |	Posting Date |	YYYYMMDD
+date |	date |	No |	Posting Date (Deprecated)|	YYYYMMDD
 zip	 | string |	No |	Zip Code (Deprecated) |	5 digits
 classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
 naics	| string |	No |	NAICS Code |	Valid NAICS Code
NAICS Reference
@@ -644,22 +644,22 @@ respdate |	date |	No - either respdate or archdate is required |	Response Date |
 archdate |	date |	No - either respdate or archdate is required |	Archive Date	| YYYYMMDD
 contact	| string	| Yes |	Contact Info	| 255 characters
 desc | string |	Yes |	Description |	65535 characters
-link |	GovURL – complex type |	No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email	| GovEmail – complex type |	Yes |	Government Email	| 128 characters
+link |	GovURL – complex type |	No |	Government Link	| 255 characters
+email	| GovEmail – complex type |	Yes |	Government Email	| 255 characters
 links |	DocumentLink[] |	No |	Array Of links	|
 files |	DocumentFile[] |	No |	Array of files |
 setaside	| string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
-popaddress |	string |	No |	Place of Performace Address |	65535 characters
-popzip |	string	| No |	Place of Performace Zip	| 5 digits
-popcountry |	string |	No |	Place of Performace Country |	32 characters
-recovery_act |	boolean |	No	 | Recovery Act |	True or False
+popaddress |	string |	No |	Place of Performance Address |	65535 characters
+popzip |	string	| No |	Place of Performance Zip	| 5 digits
+popcountry |	string |	No |	Place of Performance Country |	32 characters
+recovery_act |	boolean |	No	 | Recovery Act |	True or False (Default = False_)
 
 GovURL Complex Type Definition: 
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	 | string	| No |	Website Address |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string |	No |	Description |	255 characters
+url	 | string	| Yes |	Website Address |	255 characters
+desc |	string |	Yes|	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -672,15 +672,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string	| No |	External URL	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc |	string	| No	| Description/Title |	255 characters
+url	| string	| Yes |	External URL	| 255 characters
+desc |	string	| Yes	| Description/Title |	255 characters
 
 DocumentFile Complex Type Definition: 
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	No |	File Name |	255 characters
-filedata |	base64binary |	No	| File Data |	250 MB
+filename |	string |	Yes |	File Name |	255 characters
+filedata |	base64binary |	Yes	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -707,50 +707,50 @@ SpecialNotice Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date	| Date |	No	| Posting Date |	YYYYMMDD
+date	| Date |	No	| Posting Date (Deprecated) |	YYYYMMDD
 zip |	String |	No	 | Zip Code (Deprecated)|	5 digits
 classcod |	String	| No	| Class-Code | 	Valid classification code (FAR, Section 5.207(g))
 naics |	String |	No	| NAICS Code |	Valid NAICS Code  
NAICS Reference
 officeid	| String |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	 | 20 characters
 offadd |	String |	No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	| 65535 characters
 subject | 	String |	Yes |	Subject |	256 characters
-solnbr	| String |	Yes |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
+solnbr	| String |	No |	Solicitation # |	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 archdate |	Date |	Yes |	Archive Date |	YYYYMMDD
 contact |	String |	No	| Contact Info |	255 characters
 desc |	String |	Yes |	Description |	65535 characters
-link	| GovURL – complex type	| No |	Government Link |	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email |	GovEmail – complex type |	Yes |	Government Email	| 255 characters
+link	| GovURL – complex type	| No |	Government Link |	255 characters
+email |	GovEmail – complex type |	Yes if contact is provided |	Government Email	| 255 characters
 links |	DocumentLink[] 	| No |	Array Of links |
 files	| DocumentFile[]	 | No	| Array of files	 |
-recovery_act |	boolean |	No |	Recovery Act	| True or False
+recovery_act |	boolean |	No |	Recovery Act	| True or False (Default = False)
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|No|	Website Address|	255 characters, consist of a restricted set of characters (see URL specification - RFC2396)
-desc|	string	|No|	Description|	255 characters
+url	|string	|Yes|	Website Address|	255 characters
+desc|	string	|Yes|	Description|	255 characters
 
 GovEmail Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-address	|string|	Yes|	Email Address	|255 characters
+address	|string|	Yes |	Email Address	|255 characters
 desc	|string	|No	|Description	|255 characters
 
 DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string|	No	|External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string	|No	|Description/Title	|255 characters
+url	|string|	Yes	|External URL	|255 characters
+desc	|string	|Yes	|Description/Title	|255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	No  |	File Name |	255 characters
-filedata |	base64binary |	No 	| File Data |	250 MB
+filename |	string |Yes |	File Name |	255 characters
+filedata |	base64binary |	Yes 	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -773,7 +773,7 @@ SaleOfSurplus Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date |	date|	No|	Posting Date|	YYYYMMDD
+date |	date|	No|	Posting Date (Deprecated|	YYYYMMDD
 zip|	string|	No|	Zip Code (Deprecated) |	5 digits
 classcod|	string|	Yes	|Class-Code|	Valid classification code (FAR, Section 5.207(g))
 naics|	string|	No|	NAICS Code|	Valid NAICS Code  
NAICS Reference
@@ -784,18 +784,18 @@ solnbr|	string	|Yes	|Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_
 archdate|	date|	Yes|	Archive Date|	YYYYMMDD
 contact|	string|	Yes|	Contact Info|	255 characters
 desc|	string	|Yes|	Description	|65535 characters
-link	|GovURL – complex type|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email	|GovEmail – complex type	|Yes|	Government Email|	128 characters
+link	|GovURL – complex type|	No|	Government Link	|255 characters
+email	|GovEmail – complex type	|Yes|	Government Email|	255 characters
 links|	DocumentLink[]|	No	|Array Of links	|
 files	|DocumentFile[]|	No	|Array of files	|
-recovery_act|	boolean	|No	|Recovery Act	|True or False
+recovery_act|	boolean	|No	|Recovery Act	|True or False (Default = False)
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|No	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string	|No	|Description	|255 characters
+url	|string	|Yes	|Website Address	|255 characters
+desc	|string	|Yes	|Description	|255 characters
 
 GovEmail Complex Type Definition:
 
@@ -808,15 +808,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url|	string|	No|	External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string|	No|	Description/Title	|255 characters
+url|	string|	Yes|	External URL	|255 characters
+desc	|string|	Yes|	Description/Title	|255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	No |	File Name |	255 characters
-filedata |	base64binary |	No	| File Data |	250 MB
+filename |	string |	Yes |	File Name |	255 characters
+filedata |	base64binary |	Yes	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -839,34 +839,34 @@ Solicitation Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date | date |	No | Posting Date |	YYYYMMDD
+date | date |	No | Posting Date (Deprecated)|	YYYYMMDD
 zip |	string | No |	Zip Code (Deprecated) | 5 digits
 classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
 officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
-offadd | string | No | Office Address	| 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
+offadd | string | No | Office Address (Deprecated)	| 65535 characters. This field has been deprecated. The Contracting office address details are retrieved from the Federal Hierarchy
 subject | string | Yes | Subject | 256 characters
 solnbr | string |	Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 respdate | date |	Yes  | Response Date | YYYYMMDD
 archdate | date |	No  | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 255 characters
 desc | string |	Yes |	Description |	65535 characters
-link | GovURL – complex type | No |	Government Link	| 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+link | GovURL – complex type | No |	Government Link	| 255 characters
 email |	GovEmail – complex type |	Yes | Government Email | 255 characters
 links |	DocumentLink[] | No |	Array Of links |
 files |	DocumentFile[] | No |	Array of files |
 setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
-popaddress | string |	No | Place of Performace Address | 65535 characters
-popzip | string |	No | Place of Performace Zip | 5 digits
-popcountry | string |	No | Place of Performace Country | 32 characters
-recovery_act | boolean | No |	Recovery Act | True or False
+popaddress | string |	No | Place of Performance Address | 65535 characters
+popzip | string |	No | Place of Performance Zip | 5 digits
+popcountry | string |	No | Place of Performance Country | 32 characters
+recovery_act | boolean | No |	Recovery Act | True or False (Default = False)
 
 GovURL Complex Type Definition: 
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | No | Website Address | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	No |	Description |	255 characters
+url	| string | Yes | Website Address | 255 characters
+desc | string |	Yes |	Description |	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -879,15 +879,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	| string | No |	External URL | 255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc | string |	No | Description/Title | 255 characters
+url	| string | Yes |	External URL | 255 characters
+desc | string |	Yes | Description/Title | 255 characters
 
 DocumentFile Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename | string | No | File Name | 255 characters
-filedata | base64binary |	No | File Data | 250 MB
+filename | string | Yes | File Name | 255 characters
+filedata | base64binary |	Yes | File Data | 250 MB
 desc | string |	No | Description | 65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -910,7 +910,7 @@ ITB Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date	|Date	|No	|Posting Date	|YYYYMMDD
+date	|Date	|No	|Posting Date (Deprecated)	|YYYYMMDD
 zip	|String|	No|	Zip Code (Deprecated)|	5 digits
 classcod|	String|	Yes|	Class-Code|	Valid classification code (FAR, Section 5.207(g))
 naics|	String|	No|	NAICS Code|	Valid NAICS Code 
NAICS Reference
@@ -918,25 +918,25 @@ officeid|	String|	Yes|	Office ID of the office where an opportunity is being sub
 offadd|	String	|No|	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy|	65535 characters
 subject|	String|	Yes|	Subject	|256 characters
 solnbr	|String	|Yes|	Solicitation #	|128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
-ntype	|string	|No|	 [Refer Related Notices](#related-notices)
+ntype	|String	|No|	 [Refer Related Notices](#related-notices)
 awdnbr|	String	|Yes	|Award Number|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 donbr|	String|	No	|Task/Delivery Order Number	|255 characters from the set: a-z A-Z 0-9 - _ ( )
 archdate 	|Date	|No	|Archive Date|	YYYYMMDD
 contact|	String|	Yes|	Contact Info	|255 characters; Default value = Primary, Other types are: Secondary, Owner
 desc	|String	|Yes	|Description|	65535 characters
-link|	GovURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
+link|	GovURL|	No|	Government Link	|255 characters
 links	|DocumentLink[]|	No|	Array Of links	|
 files|	DocumentFile[]	|No	|Array of files	|
 email	|GovEmail|	Yes|	Government Email|	255 characters
-recovery_act|	boolean	|No	|Recovery Act	|True or False
+recovery_act|	boolean	|No	|Recovery Act	|True or False (Default = False)
 correction	|boolean	|No	|Correction of previous ITB|	True or False 

If correcting a previously submitted ITB notice, specify True and the system will lookup the itb by award number, delivery number and sol number if applicable.
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|No	|Website Address	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc	|string|	No - Yes, if URL provided|	Description|	255 characters
+url	|string	|Yes	|Website Address	|255 characters
+desc	|string|	Yes|	Description|	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -949,15 +949,15 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url|	string|	No	|External URL|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	No|	Description/Title	|255 characters
+url|	string|	Yes	|External URL|	255 characters
+desc|	string|	Yes|	Description/Title	|255 characters
 
 DocumentFile Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	No |	File Name |	255 characters
-filedata |	base64binary |	No	| File Data |	250 MB
+filename |	string |	Yes |	File Name |	255 characters
+filedata |	base64binary |	Yes	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -984,7 +984,7 @@ Complete notice Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date|	date|	No	|Posting Date|	YYYYMMDD
+date|	date|	No	|Posting Date (Deprecated)|	YYYYMMDD
 notice_type	|string	|Yes|	 [Refer Notice Types](#notice-types)	|
 zip	|string	|No	|Zip Code (Deprecated)|	5 digits
 classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA, PRESOL  |	Class-Code	|Valid classification code (FAR, Section 5.207(g))
@@ -1001,30 +1001,30 @@ linenbr|	string	|No|	Award Line Item Number	|255 characters from the set: a-z A-
 awddate	|date|	Yes - for AWARD|	Award Date	|YYYYMMDD
 stauth	|string	|Yes - for JA 	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| [Refer Stauth Valid Values](#stauth-valid-values)
 respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL, SSALE	|Response Date	|YYYYMMDD
-archdate  |	date| Either respdate or archdate required for SRCSGT, PRESOL, SSALE, SNOTE|	Archive Date|	YYYYMMDD
+archdate  |	date| No; Either respdate or archdate required for SRCSGT, PRESOL, SSALE, SNOTE|	Archive Date|	YYYYMMDD
 awardee|	string|	Yes – for AWARD |	Awardee	|65535 characters
-awardee_duns|	string	|No	|Awardee DUNS	|9 digits with optional plus 4
+awardee_duns|	string	|Yes - for AWARD	|Awardee DUNS	|9 digits with optional plus 4
 contact|	string|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL|	Contact Info|	255 characters
 desc	|string|	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE|	Main Description|	65535 characters
-link|	GovernmentURL|	No|	Government Link	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-email|	GovernmentEmail|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL, SNOTE|	Government Email	|255 characters
+link|	GovernmentURL|	No|	Government Link	|255 characters
+email|	GovernmentEmail|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL, SNOTE (SNOTE only required if contact is provided)|	Government Email	|255 characters
 links	|DocumentLink []|	No	|Array Of links	|
 files	|DocumentFile[]|	No|	Array of files	|
 setaside|	string|	No|	[Refer Set-Aside Values](#set-aside-values) |	
-popaddress|	string|	No|	Place of Performace Addressress	|65535 characters
-popzip|	string	|No	|Place of Performace Zip	|5 digits
-popcountry|	string|	Yes – For Awards; No – For rest|	Place of Performace Country|	32 characters
+popaddress|	string|	No|	Place of Performance Address	|65535 characters
+popzip|	string	|No	|Place of Performance Zip	|5 digits
+popcountry|	string|	No|	Place of Performance Country|	32 characters
 city|	string|	No	|City	|NA
 state|	string|	No|	State	|NA
-recovery_act	|boolean|	No|	Recovery Act|	True or False
-correction|	boolean|	No|	Correction of previous notice for the following types:  Award #, Delivery Order #) – Awards, J&A’s, Intent to Bundle Requirements (DoD-Funded), Limited Source Justification 

 This is used to modify/correct notice types where uniqueness is potentially determined by fields other than Solicitation # (i.e. Award #, Delivery Order #)	|True or False

 If correcting a previously submitted notice, specify True and the system will lookup the notice by award number, delivery order number, and sol number if applicable.
+recovery_act	|boolean|	No|	Recovery Act|	True or False (Default = False)
+correction|	boolean|	No| If correcting a previously submitted notice, specify True and the system will lookup the notice by award number, delivery order number, and sol number if applicable.	|True or False
 
 GovURL Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url|	string|	No|	Website Address|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	No	|Description|	255 characters
+url|	string|	Yes|	Website Address|255 characters
+desc|	string|	Yes	|Description|	255 characters
 
 GovEmail Complex Type Definition:
 
@@ -1037,13 +1037,13 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string|	No	|External URL	|255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	No|	Description/Title|	255 characters
+url	|string|	Yes	|External URL	|255 characters
+desc|	string|	Yes|	Description/Title|	255 characters
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	No |	File Name |	255 characters
-filedata |	base64binary |	No	| File Data |	250 MB
+filename |	string |	Yes |	File Name |	255 characters
+filedata |	base64binary |	Yes	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
 export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
@@ -1066,10 +1066,10 @@ DocumentUpload Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-Date|	Date|	No	|Posting Date	|YYYYMMDD
-solnbr	|String	|No|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+date|	Date|	No	|Posting Date	(Deprecated) |YYYYMMDD
+solnbr	|String	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 ntype	|String	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
-uploadtype|	String|	No |	Upload Type|	A for amendment, S for solicitation or any title for other; 255 characters
+uploadtype|	String|	No |	Upload Type (Deprecated)| 255 characters
 respdate	|Date	|No |Response Date|	YYYYMMDD
 links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
 files	|DocumentFile []|	Yes; Either Links or Files needs to be provided|	Array of files	|
@@ -1079,14 +1079,14 @@ DocumentLink Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-url	|string	|Yes|	External URL|	255 characters, consist of a restricted set of characters (see URL specification - RFC 2396)
-desc|	string|	Yes|	Description/Title	|255 characters
+url	|string	|Yes|	External URL|	255 characters
+desc|	string|	Yes |	Description/Title	|255 characters
 
 DocumentFile Complex Type Definition
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-filename |	string |	Yes |	File Name |	255 characters
+filename |	string |	Yes  |	File Name |	255 characters
 filedata |	base64binary |	Yes	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
 explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
@@ -1114,6 +1114,7 @@ solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_
 ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
 awdnbr	|string|	No|	Award #|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
+officeid|	String|	No|	Office ID (Not in Use)
 
 ### Secure Document Package 
 (attachSecureDocumentPackagesToNotice)
 
@@ -1204,7 +1205,7 @@ naics_codes|	string	|Naics Codes 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past. 

 3. One of Response date or Archive date is required
+archdate|	1.	This field is required where applicable. 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past. 

 3. One of Response date or Archive date is required
 awardee	|	NA|	NA
 awardee_duns|	1. Must provide a valid DUNS|	1. Unique Entity Identifier (duns) is invalid.
 contact	|	1. This field is required where applicable	|1. Primary Contact is Required

From 18e9e0a0ac392223ca4dbc199f374e7ff8b18b60 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 01:13:25 -0400
Subject: [PATCH 102/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index a1ec08ffa..7628373a3 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3787,6 +3787,14 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Archive Type |	$.archive.type: does not have a value in the enumeration[auto15, auto30, autocustom] |	Archive type must be specified value | Create, Publish, Uncancel, Unarchive
 400|Archive Type |	This opportunity cannot be published. Auto 15 archive type is not allowed for this opportunity type. | Archive Type = auto15 not allowed |	Publish
 400|Archive Type |	Auto 30 archive type is not allowed for this opportunity type. | Archive Type = auto30   not allowed for Intent bundle and Justification |	Publish
+400|Attachment |	has unknown issue/missing, please remove this attachment and republish. | has unknown issue/missing, please remove this attachment and republish. |	Publish
+400|Attachment |	is PENDING, please try to publish at a later time. | is PENDING, please try to publish at a later time. |	Publish
+400|Attachment |	is ENCRYPTED, please remove this attachment and republish. | is ENCRYPTED, please remove this attachment and republish. |	Publish
+400|Attachment |	is INFECTED, please remove this attachment and republish. | is INFECTED, please remove this attachment and republish. |	Publish
+400|Attachment |	FILE SIZE GT 250MB or larger, please remove this attachment and republish. | FILE SIZE GT 250MB or larger, please remove this attachment and republish. |	Publish
+400|Attachment |	is a UNSUPPORTED FILE TYPE, please remove this attachment and republish. | is a UNSUPPORTED FILE TYPE, please remove this attachment and republish. |	Publish
+400|Attachment |	Exception occured while trying to validate attachments, Please retry at a later time. | Exception occured while trying to validate attachments, Please retry at a later time. |	Publish
+400|Attachment |	Unknown type was found for Resource named: | Unknown type was found for Resource named: |	Publish
 400|attType |	Attachment must have AttType of file or link |	Attachment type must be a file or a line |	Create Attachment
 401|Authorization |	Insufficient privileges to edit opportunity |	See User Account Authorization section |	Update, Publish, Revise
 401|Authorization |	Insufficient privileges to create opportunity |	Insufficient privileges to create an award notice. See User Account Authorization section for more details. |	Create Opportunity
@@ -3795,6 +3803,10 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Award |	Award Details Section is missing data. | Award Details Section is missing data. |	Publish
 400|Award Amount |	Award Detail Section-Please enter valid integer for Amount Field |	Award Amount required |	Publish
 400|Award Amount |	Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type |	Contract Award Amount only valid for Type "a" Award |	Publish
+400|Total Contract Value |	Base and All Options Value is a required field. |	Base and All Options Value is a required field. |	Publish
+400|Total Contract Value |	Base and All Options Value max length is 64 digits. |	Base and All Options Value max length is 64 digits. |	Publish
+400|Total Contract Value |	Base and All Options Value - Invalid input: Please enter a valid number. |	Base and All Options Value - Invalid input: Please enter a valid number. |	Publish
+400|Modification Number |	Modification Number max character limit is 32 characters. |	Modification Number max character limit is 32 characters. |	Publish
 400|Award Date |	Contract Award Date is required field. |	Contract Award Date is required field. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Contract Award Date provided is in an invalid format. |	Date is not in specified format |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Contract Award Date provided should have 4 digit year. | Contract Award Date provided should have 4 digit year. |	Create Opportunity, Publish, Uncancel, Unarchive
@@ -3803,10 +3815,22 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Award Number |	Contract Award Number is a required field	| Contract Award Number is missing | Publish, Uncancel, Unarchive
 400|Award Number |	Contract Award Number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.| Contract Award Number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | Publish, Uncancel, Unarchive
 400|Contract Line Item number |	The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.	| The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | All
+400|DUNS | Unique Entity Identifier (duns) is invalid. |	Invalid DUNS provided |	Publish
+400|Awardee Name | Contractor Awarded Name is a required field. |	Contractor Awarded Name is a required field. |	Publish
+400|Awardee Name | Contractor Awarded Name max character length is 255. |	Contractor Awarded Name max character length is 255. |	Publish
+400|Awardee | Required fields from Awardee section is missing. |Required fields from Awardee section is missing. |	Publish
+400|Awardee Country | Award Details Section - Country is required. |Country is required. |	Publish
+400|Awardee Country | Award Details Section - Country provided is invalid. |Country provided is invalid. |	Publish
+400|Awardee State | Award Details Section - State is required. |State is required. |	Publish
+400|Awardee State | Award Details Section - State provided is invalid. |State provided is invalid. |	Publish
+400|Awardee City | Award Details Section - City is required. |City is required. |	Publish
+400|Awardee City | Award Details Section - City provided is invalid. |City provided is invalid. |	Publish
 400|Classification Code | Classification Code provided did not match expected codes |	Invalid PSC provided |	Publish
 400|CANCEL |	This opportunity cannot be cancelled. This opportunity is a revision. |	Cannot cancel a revised Opportunity. |	Cancel
 400|Content |	File Resource must have content. |	File Resource must be filled out | Create Attachment
 400|Contract Award Dollar Amount |	Award Details Section – Please enter valid integer for Amount Field	| Valid integer amount must be entered for award dollar amount | Publish
+400|Task/Delivery Order Number |	Task/Delivery Order Number is required field.	| Task/Delivery Order Number is required field. | Publish
+400|Task/Delivery Order Number |	Task/Delivery Order Number max length is 255 characters and allows only alphanumeric and - _ ( ) characters with no spaces.	| Task/Delivery Order Number max length is 255 characters and allows only alphanumeric and - _ ( ) characters with no spaces. | Publish
 401|CREATE | Insufficient privileges to create opportunity |	Account does not have appropriate privileges to create opportunity | CREATE
 401|CREATE ATTACHMENT |	Insufficient privileges to upload attachment | Attachments cannot be added to published notices |	Create Attachment
 400|Deadlines Response | This opportunity cannot be published. | Response Deadline Date is required |	Publish
@@ -3858,6 +3882,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Response Date |	Response Date set would result in inactive date being in the past. |	Response Date provided is within 15 days |	Publish
 400|Response Date |	Auto 15 archive type is not allowed for this opportunity type. |	Auto 15 archive type is not allowed for award notice |	Publish
 400|Response Date |	Response Date cannot exceed 5 years from current date. |	Response Date cannot exceed 5 years from current date. |	Publish 
+
 400|Title |	Title is required |	Title is required |	Publish
 400|UNARCHIVE |	This opportunity is not the latest published |	Only archived notices can be unarchived | UNARCHIVE
 400|resourceName | Attachment must have a name | File Name is a required field |	Create Attachment

From d80f53b734a7c499ea62a8ac332281abbfa995fe Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 02:06:53 -0400
Subject: [PATCH 103/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index fce11257e..33437754b 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -423,6 +423,7 @@ naics | string | Yes | NAICS Code	| Valid NAICS Code 

Date: Thu, 31 Oct 2019 05:14:31 -0400
Subject: [PATCH 104/149] update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 88 +++++++++++++++---------------
 1 file changed, 43 insertions(+), 45 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 0ee8dfdb6..0e8ee53e1 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4104,7 +4104,7 @@ stauth|	 1. This field is required where applicable 

 2. This field accep
 respdate|	1.	This field is required where applicable 

 2.	This date cannot be in past; has to be in future. If the given date is in past, then system throws errors 	| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Response date provided is in the past

 3.	This opportunity cannot be published. Response Date cannot exceed 5 years from current date 

 4. One of Response date or Archive date is required 

 5. One of Response date or Archive date is required
 archdate|	1.	This field is required where applicable. Note user may receive "Auto 30 

 2.	This date cannot be current or in past; has to be in future|	1.	DATE field in unexpected format  Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past. 

 3. One of Response date or Archive date is required
 awardee	|	NA|	NA
-awardee_duns|	1. Must provide a valid DUNS|	1. Unique Entity Identifier (duns) is invalid.
+awardee_duns|	1. Must provide a valid DUNS|	1. Unique Entity Identifier (duns) is invalid
 contact	|	1. This field is required where applicable	|1. Primary Contact is Required
 desc| 	1. This field is required where applicable.|	1. Description is required
 link|	NA	| NA
@@ -4124,7 +4124,7 @@ correction|	1. When user tries to convert a notice and the solicitation number/n
 #### submitDocumentsAndLinksToNotice
 
 Individual business rules per field are listed across each of the fields in below table.  
-* Note: Users cannot verify the attachments/links on front end (UI)
+* Note: Users can verify the attachments/links on SAM.gov
 * Note: When none of the fields are given the service throws an error - Links and/or Files are not complete
 * Note: When links/files are given but none of the other fields are given, then service throws an error - Multiple Notices found. Please input more details
 
@@ -4132,12 +4132,12 @@ Element Name	|	Business Rules |	Error Messages with respect to business rules (I
 ------ | ------- | -------
 date|		Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 officeid|		1. If an invalid officeid is given, then service throws an error

 2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 3. Office ID must be associated with user account	|1. Invalid officeid provided

 2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
-solnbr|1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  	|1. Multiple notices found. Please input more details

  2. Notice not found

 
 ntype	|	1. If field is not provided OR a wrong ntype is provided, then service throws an error  |  1. Notice Type value provided is not valid
 uploadtype|	NA|	NA
 respdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
 links|	1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

 2. If a link with same name already exists on the notice, then the system throws an error.

 3. If the Url is empty for a link, then the system throws an error.

 4.	If the description is missing for a link, then the system throws an error.| 1.	Links and/or files are not complete

 2.	Resource with the same name already exists

 3.	Link Resource must have a link

 4. Link Resource must have a description
-files	|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file type that you are trying to upload is not supported

6.	Resource with the same name already exists
+files	|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file size should be greater than zero bytes and less than 250 MB 

6.	Resource with the same name already exists
 
 
 
@@ -4147,11 +4147,11 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  	|1. Multiple notices found. Please input more details

  2. Notice not found

 
 awdnbr|	 If neither solnbr or awdnbr is provided, then the system throws an error|	Solicitation Number or Award Number is required
-ntype|	1. If an invalid ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
-deletetype|		1. If an invalid deletetype is provided, then service throws an error  |	Delete type provided is not “notice” or “attachment”
-deletemethod|	1. If an invalid deletemethod is provided, then service throws an error  |	Delete method provided is not “latest” or “all”
+ntype|	1. If an invalid ntype is provided, then service throws an error |  	1. Invalid NTYPE value provided
+deletetype|		1. If an invalid deletetype is provided, then service throws an error  |	1.Delete type provided is not “notice” or “attachment”
+deletemethod|	1. If an invalid deletemethod is provided, then service throws an error  |	1. Delete method provided is not “latest” or “all”
 
 #### archiveNotice
 
@@ -4161,42 +4161,42 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
-solnbr|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error|	1. Multiple notices found. Please input more details

  2. Notice not found for correction

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
+solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
 officeid	|	Office ID must be associated with user account	|NA
-ntype|	1. If an invalid ntype is provided, then service throws an error

    2. If a valid ntype but a wrong ntype is not provided for the solnbrthen service throws an error | 1. NTYPE value provided is not valid 2. Notice not found for correction
-archdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be current or in past; has to be in future	|1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	This opportunity cannot be published. Archive date provided is in the past
+ntype	|	1. If an invalid ntype is provided, then service throws an error   | 1. Invalid NTYPE value provided
+archdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 	|1.	DATE field in unexpected format. Expects YYYYMMDD

 
 
 #### unarchiveNotice
 
 Individual business rules per field are listed across each of the fields in below table.  
-* Note: : If a user tries to unarchive a notice that is already unarchived, then the service throws an error - Opportunity is not archived.
+* Note: : If a user tries to unarchive a notice that is already unarchived, then the service throws an error - Opportunity is not archived
 * Note: If a user tries to unarchive an active notice, then the service throws an error - Opportunity is active
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	1a. This required field if not given, service throws an error 

1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If solicitation & ntype combination is not matched, then service throws an error	|1. Multiple notices found. Please input more details

  2. Notice not found for correction
+solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
 officeid|	Office ID must be associated with user account	|NA
-ntype|		1. If field is not provided OR a wrong ntype is provided, then service throws an error |  	1. NTYPE value provided is not valid
+ntype	|	1. If an invalid ntype is provided, then service throws an error   | 1. Invalid NTYPE value provided
 awdnbr	|	NA|	NA
-archdate|	1. This field is required where applicable  

2. If this value is available, this field should meet the character limit/restrictions 

3.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1.	DATE field in unexpected format. Expects YYYYMMDD

 2.	New archive date provided is in the past

 3.	$.reason: null found, string expected. Unable to process request. Please try again
+archdate|	1. If this value is available, this field should meet the character limit/restrictions 

2.	If current date or a past date is provided, then the system throws an error

  3.	If no archive date is given, then the system throws an error| 1. DATE field in unexpected format. Expects YYYYMMDD

 2. New archive date provided is in the past

 3.	New archive date is required
 
 #### cancelNotice 
 
 Individual business rules per field are listed across each of the fields in below table.  
-* Note: : If user tries to cancel already cancelled opportunity, service throws an error - This opportunity cannot be cancelled. This opportunity is already cancelled. Unable to process request. Please try again.
-* Note: -	When user tries to cancel a notice without giving any input, then the service throws an error ‘Unable to process request. Please try again’
+* Note:  If user tries to cancel already cancelled opportunity, service throws an error - This opportunity cannot be cancelled. This opportunity is already cancelled. Unable to process request. Please try again.
+* Note: When user tries to cancel a notice without giving any input, then the service throws an error ‘Unable to process request. Please try again’
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 date|	Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 officeid|	Office ID must be associated with user account	|NA
 subject|		NA|	NA
-solnbr|	1a. This required field if not given, service throws an error

 1b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination

 2. If valid solnbr is given with a different ntype, then service throws an error

 3. If a space is given along with numbers in this field, then service throws an error	|1. Multiple Notices found. Please input more details

  2. Notice not found for correction

  3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces
-ntype	|	1. If field is not provided OR a wrong ntype is provided, then service throws an error   | 1. Notice Type value provided is not valid
+solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
+ntype	|	1. If an invalid ntype is provided, then service throws an error   | 1. Invalid NTYPE value provided
 awdnbr|		NA|	NA
 archdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions

 2.	This date cannot be in past; has to be in future|	1.	DATE field in unexpected format. Expects YYYYMMDD

  2.	This opportunity cannot be cancelled
 contact| NA| NA
-desc|	1. This field is required where applicable |	1. Unable to process request. Please try again
+desc|	1. This field is required where applicable |	1. This opportunity cannot be cancelled. The cancel request is missing 'Cancellation description' field.
 
 #### getNoticeData
 
@@ -4206,7 +4206,7 @@ Element Name	|	Business Rules |	Error Messages with respect to business rules (I
 ------ | ------- | ------- | ------- | --------
 notice_id	|	notice_id is required|	notice_id from getList is required
 Get_changes|		NA|	NA
-get_changes_from_date|		Date field should meet the expected format.|	DATE field in unexpected format. Expects YYYYMMDD
+get_changes_from_date|		Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
 get_file_data	|NA	|NA
 
 #### getList
@@ -4216,7 +4216,7 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	 |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-notice_type	 |	 Valid Notice Type must be provided | Notice Type is not recognized
+notice_type	 |	 Valid Notice Type must be provided | Notice Type is not recognized. Expects one of the following: PRESOL, COMBINE, MOD, AWARD, JA, SRCSGT, SSALE, SNOTE, ITB, SOL
 solnbr|	NA|	NA
 awdnbr|		NA|	NA
 posted_from	|	Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
@@ -4226,20 +4226,18 @@ documents_to_search|	NA|	NA
 #### getFileData
 
 Individual business rules per field are listed across each of the fields in below table.  
-* Note: If a wrong combination of file_id and notice_id is given, then the service throws a success message without any data.
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-file_id	|1. This field is required where applicable 
 2. If an invalid file Id is provided, then the system throws an error.|	1. file_id is required 
 2.	File Id not found. Please enter a valid Id.
+file_id	|1. This field is required where applicable 
 2. If an invalid file Id is provided, then the system throws an error.|	1. file_id is required 
 2.	Unable to find details for the resourceId
 
-#### getIVLListResponse
+#### getIVLList
 
 Individual business rules per field are listed across each of the fields in below table.  
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|		1. If an incorrect solicitation number and ntype combination is given, the service throws an error

   2a. If this required field if not given, service throws an error 

2b. If multiple notices are found with solicitation number given, then provide ntype and solicitation number combination |1. Notice not found 

2a. Notice not found

 2b. Multiple Notices found. Please input more details
-ntype|	NA	|NA
+solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
 
 #### getAuthorizedPartyList
 
@@ -4247,9 +4245,9 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
-ntype|		If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
-nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together 

2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
+solnbr|	 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
+ntype|	1. If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided
+nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2. If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together 

2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
 status|	1.	If the status value entered doesn’t match the valid values , then the system throws an error|	1.	Status value is invalid
 
 #### approveExplicitAccessRequestByID
@@ -4260,8 +4258,8 @@ ID can be obtained through getAuthorizedPartyList
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4. Multiple notices found. Please input more details
-ntype	|If an invalid ntype is provided, then service throws an error  | 1. NTYPE value provided is not valid
+solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
+ntype	|1. If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
 id|		1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already approved, then the service throws an error

3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error	|1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already approved

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
 
@@ -4274,10 +4272,10 @@ Vendor can be obtained through getAuthorizedPartyList
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
-ntype	|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
+solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
+ntype	|   1. If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
-vendor	|1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error. 
2.	If no match is found in the system for the vendor data provided, then the system throws an error. 
 3.	If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown. 
 2.	No contact match on vendor data provided.  
 3.	Request with Request ID: #id already approved.
+vendor	|1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error 
2.	If no match is found in the system for the vendor data provided, then the system throws an error 
 3.	If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown 
 2.	No contact match on vendor data provided  
 3.	Request with Request ID: #id already approved
 
 #### addAuthorizedParty
 
@@ -4285,10 +4283,10 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

 4. Multiple notices found. Please input more details
-ntype|	If an invalid ntype is provided, then service throws an error |  1. NTYPE value provided is not valid
-nonfbo_solbr 	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	addAuthoizedParty service is deprecated for Non-FBO Solicitations
-vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
+solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

 3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
+ntype|	1. If an invalid ntype is provided, then service throws an error |  1. Invalid NTYPE value provided
+nonfbo_solbr 	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	addAuthorizedParty service is deprecated for Non-FBO Solicitations
+vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
 
 #### rejectExplicitAccessRequestByID
 
@@ -4296,11 +4294,11 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	 |	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If a space is given along with numbers in this field, then service throws an error

 4. If ntype value is not provided and the solnbr is not unique, then the system throws an error|	1. Solicitation Number is required

 2. Notice not found

 3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 
 4. Multiple notices found. Please input more details
-ntype|	1.	If an invalid ntype is provided, then service throws an error   |	1. NTYPE value provided is not valid
+solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

 3. If ntype value is not provided and the solnbr is not unique, then the system throws an error|	1. Solicitation Number is required

 2. Notice not found

  3. Multiple notices found. Please input more details
+ntype|	1.	If an invalid ntype is provided, then service throws an error   |	1. Invalid NTYPE value provided
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
 id|		1.	If the request Id is not provided, then the system throws an error

 2.	If the request Id provided is already rejected, then the service throws an error

 3.	If the solicitation number provided does not match the solicitation number of the request Id, then the service throws an error

 4.	If the solicitation number provided matches with the solicitation number of the  request Id  but does not match with the provided N type, then the service throws an error|	1.	Internal ID is required. Use getAuthorizedPartyList to retrieve this information

 2.	Request with Request ID: #id already rejected

 3.	You have request that is tied to different solicitation number

 4.	You have request that is tied to the same solicitation number but different notice type
-reason|  1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
+reason|  1.	This is a required field. If no value is provided, then the system throws an error| 1.	A reason must be provided with an explicit access rejection
 
 #### rejectExplicitAccessRequestByVendorData
 Individual business rules per field are listed across each of the fields in below table.  
@@ -4308,10 +4306,10 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
-ntype		|If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided.
-nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
+ntype		|1. If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided
+nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByVendorData service is deprecated for Non-FBO Solicitations
 vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
-reason|  1.	This is a required field. If no value is provided, then the system throws an error.| 1.	A reason must be provided with an explicit access rejection.
+reason|  1.	This is a required field. If no value is provided, then the system throws an error| 1.	A reason must be provided with an explicit access rejection
 
 
 

From ddb58eb709e66daa19027e464b0d2aae3c1a3478 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 05:32:46 -0400
Subject: [PATCH 105/149] update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index d802014d4..9f12cc9c1 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4230,7 +4230,7 @@ Individual business rules per field are listed across each of the fields in belo
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
-file_id	|1. This field is required where applicable 
 2. If an invalid file Id is provided, then the system throws an error.|	1. file_id is required 
 2.	Unable to find details for the resourceId
+file_id	|1. This field is required where applicable 

 2. If an invalid file Id is provided, then the system throws an error.|	1. file_id is required 

 2.	Unable to find details for the resourceId
 
 #### getIVLList
 
@@ -4276,7 +4276,7 @@ Element Name	|	Business Rules |	Error Messages with respect to business rules (I
 solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
 ntype	|   1. If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	approveExplicitAccessRequestByID service is deprecated for Non-FBO Solicitations
-vendor	|1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error 
2.	If no match is found in the system for the vendor data provided, then the system throws an error 
 3.	If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown 
 2.	No contact match on vendor data provided  
 3.	Request with Request ID: #id already approved
+vendor	|1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error 

2.	If no match is found in the system for the vendor data provided, then the system throws an error 

 3.	If the Explicit Access request found for the vendor and solnum is already approved, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown 

 2.	No contact match on vendor data provided  

 3.	Request with Request ID: #id already approved
 
 #### addAuthorizedParty
 
@@ -4287,7 +4287,7 @@ Element Name	| 	Business Rules |	Error Messages with respect to business rules (
 solnbr|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

 3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error |	1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details
 ntype|	1. If an invalid ntype is provided, then service throws an error |  1. Invalid NTYPE value provided
 nonfbo_solbr 	|	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	addAuthorizedParty service is deprecated for Non-FBO Solicitations
-vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
+vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error

 3. If the vendor is already added as an authorized party on the notice, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 

 3.	Duplicate request. Vendor is already added as an authorized party on the notice
 
 #### rejectExplicitAccessRequestByID
 
@@ -4309,7 +4309,7 @@ Element Name	|	Business Rules |	Error Messages with respect to business rules (I
 solnbr	|	1. This field is required where applicable. If no value is provided, then service throws an error 

2. If invalid combination of ntype and solnbr is provided, then system throws an error

  3. If ntype value is not provided and the solnbr is not unique or if multiple notices are found with same solnbr and ntype, then the system throws an error. 	|1. Solicitation Number is required

 2. Notice not found

 3. Multiple notices found. Please input more details. 
 ntype		|1. If an invalid ntype is provided, then service throws an error  | 1. Invalid NTYPE value provided
 nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service throws an error

 2.	If only nonfbo_solbr is provided, then the service throws an error| 1.	Solicitation Number and Non-FBO Solicitation Number cannot be specified together

 2.	rejectExplicitAccessRequestByVendorData service is deprecated for Non-FBO Solicitations
-vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error
 3. If the vendor is already added as an authorized party on the notice, then the system throws an error.|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 
 3.	Duplicate request. Vendor is already added as an authorized party on the notice
+vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error

3. If the Explicit Access request found for the vendor and solnum is already rejected, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 

 3.	Request with Request ID: #id already rejected
 reason|  1.	This is a required field. If no value is provided, then the system throws an error| 1.	A reason must be provided with an explicit access rejection
 
 

From 2c1d5aff21d75b4835b2785375711a9137a23f5e Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 05:37:26 -0400
Subject: [PATCH 106/149] update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 9f12cc9c1..31423d26d 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -1067,14 +1067,14 @@ DocumentUpload Complex Type Definition:
 
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
-date|	Date|	No	|Posting Date	(Deprecated) |YYYYMMDD
-solnbr	|String	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|String	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
-uploadtype|	String|	No |	Upload Type (Deprecated)| 255 characters
-respdate	|Date	|No |Response Date|	YYYYMMDD
+date|	date|	No	|Posting Date	(Deprecated) |YYYYMMDD
+solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
+ntype	|string	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
+uploadtype|	string|	No |	Upload Type (Deprecated)| 255 characters
+respdate	|date	|No |Response Date|	YYYYMMDD
 links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
 files	|DocumentFile []|	Yes; Either Links or Files needs to be provided|	Array of files	|
-officeid	|String|	No|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account|	20 characters
+officeid	|string|	No|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account|	20 characters
 
 DocumentLink Complex Type Definition:
 

From 9427ddd7263d69207c26d5bdf6eba3990bd37fe1 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 07:38:05 -0400
Subject: [PATCH 107/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md      | 105 +++++++++++++++++++----------
 _apidocs/opportunities-soap-api.md |  27 +-------
 2 files changed, 71 insertions(+), 61 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 380224283..f545c155d 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -791,7 +791,7 @@ Examples
 ------- | -------
 **Request Type** | POST
 **URL** | /v1/api/revise/{opportunityId}
-**Summary** | Create a draft version of an Opportunity for a Published Opportunity.
+**Summary** | Create a draft version for a Published Opportunity.
 **Consumes** | application/json
 **Produces** | JSON
 
@@ -1763,10 +1763,8 @@ Examples
           ]
         },
         "parent": {
-
         },
         "related": {
-
         },
         "status": {
           "code": "published",
@@ -2019,23 +2017,9 @@ HTTP Status Code | Response Type | Reason  | Description
 
 Examples
 
-

-Uncancel Request (active Opportunity):
-

-
-{
-  "reason": "",
-  "requestType": "uncancel_request",
-  "data": {
-    "description": "test"
-  }
-}
-

-

-

 
 

-Uncancel Request (inactive Opportunity):
+Uncancel Request:
 

 
 {
@@ -2126,17 +2110,36 @@ HTTP Status Code | Response Type | Reason  | Description
 Examples
 
 

-Unarchive:
+Unarchive Request for a Non-Award notice
 

 
 {
   "reason": "test",
   "requestType": "unarchive_request",
   "data": {
-    "newArchiveDate": null,
+    "newResponseDate": "2019-12-12T00:12:00-05:00",
+    "newResponseTz": "America/New_York",
     "newArchiveType": "auto15",
-    "newResponseDate": "2019-11-11T10:58:00-05:00",
-    "newResponseTz": "America/New_York"
+    "newArchiveDate": null
+  }
+}
+

+

+

+
+

+Unarchive Request for a Award notice
+

+
+{
+  "reason": "test unarchive for award notice",
+  "requestType": "unarchive_request",
+  "data": {
+    "newResponseDate": null,
+    "newResponseTz": null,
+    "newArchiveType": "autocustom",
+    "newArchiveDate": "2020-03-01",
+    "newContractAwardDate": "2020-02-02"
   }
 }
 

@@ -3403,6 +3406,10 @@ resources.content | byte |250MB |  | No|No | File content in base64 format
 resources.link | string | 255 characters | |No|No | Resource link URL
 resources.packageAccessLevel | string | | public,
private
(default public) | No | No| Type of access to file
 resources.resourceName | string | 255 characters |  | No|No | Name of file
+resources.description | string |255 characters | | No|No | Description of the link
+resources.explicitAccess | string |1 character | 0, 1 (defaults to '0' public access, if not provided) | No |No |Explicit Access. For Controlled Unclassified files, specify '1'
+resources.exportControlled | string |1 character | 0 | No |No |Export Controlled. * Captured for future JCP validation
+
 
 
Back to top

 
@@ -3477,7 +3484,6 @@ description | string |  | Yes | Description for cancelation
     "newArchiveType": "",
     "newResponseDate": "",
     "newResponseTz": "America/New_York",
-    "newContractAwardDate": ""
   }
 }
 

@@ -3497,7 +3503,6 @@ newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustome) | New A
 newArchiveType | string | auto15, auto30, autocustom | Yes  | New Archive Type
 newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | Yes (if newArchiveType = auto15) | New Response Date
 newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) | New Response Time Zone
-newContractAwardDate | date | YYYY-MM-DD | Yes (if type=a) | New Contract Award Date
 
 
Back to top

 
@@ -3575,7 +3580,9 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided)
  "content": "",
  "resourceName": "",
  "fileType": "",
- "packageAccessLevel": ""
+ "packageAccessLevel": "",
+ "explicitAccess":"",
+ "exportControlled": null
 }
 

 

@@ -3606,6 +3613,8 @@ resourceName | string | 255 characters| | Yes (if attType=file) | Name of file
 fileType | string | 64 characters | | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
 link | string | 255 characters| | Yes (if attType=link) | Resource link  URL
 description | string |255 characters | | Yes (if attType=link) | Description of the link
+explicitAccess | string |1 character | 0, 1 (defaults to '0' public access, if not provided) | No  |Explicit Access. For Controlled Unclassified files, specify '1'
+exportControlled | string |1 character | 0 | No  |Export Controlled. * Captured for future JCP validation
 
 #### Valid File Types 
 
@@ -3704,28 +3713,41 @@ ivlView | string | forcedon, forcedoff | Yes | Indicates whether vendors can vie
 
 ### Vendor Data JSON
 
+

+

+Vendor_Data_Contract_JSON
+

+
+{
+"lname":"",
+"fname":"",
+"email":"",
+"contractorName":"",
+"duns":"",
+"cageCode":""
+}
+

+

+

+
+* Field headers in the table must match with field headers shown in JSON example  
+
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 fname | string | | Yes | First name of the user
 lname | string | | Yes | Last name of the user
 email | string | | Yes | Email Id of the user
-contractorName | string | | No | Contractor Name
+contractorName | string | | Yes | Contractor Name
 duns | string | | Yes | DUNS#
-cageCode | string | | No | Cage Code
-
-### Delete Notice JSON
+cageCode | string | | Yes | Cage Code
 
-* Field headers in the table must match with field headers shown in JSON example  
+
Back to top

 
-Name | Data Type | Allowed Values | Required | Description
------|-----------|----------------|----------|------------
-reason|	string|	|	Yes|	Reason for deletion
-requestType	|string	|delete_request |Yes	|Type of request
-description	|string|		|Yes|	Description for deletion of a notice
-deleteOption|	string|	latest, all|	Yes|	Option to delete either the latest or all versions of a notice
+### Delete Notice JSON
 
+

 

-Delete Notice Request
+Delete_Notice_Contract_JSON
 
    {
@@ -3740,6 +3762,15 @@ deleteOption|	string|	latest, all|	Yes|	Option to delete either the latest or al
 

 

 
+* Field headers in the table must match with field headers shown in JSON example  
+
+Name | Data Type | Allowed Values | Required | Description
+-----|-----------|----------------|----------|------------
+reason|	string|	|	Yes|	Reason for deletion
+requestType	|string	|delete_request |Yes	|Type of request
+description	|string|		|Yes|	Description for deletion of a notice
+deleteOption|	string|	latest, all|	Yes|	Option to delete either the latest or all versions of a notice
+
 
Back to top

 
 ### Error Messages
diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 31423d26d..0b012de66 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -1090,8 +1090,8 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 filename |	string |	Yes  |	File Name |	255 characters
 filedata |	base64binary |	Yes	| File Data |	250 MB
 desc	| string |	No	 | Description |	65535 characters
-explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true".|  
-export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation.	| 
+explicit_access | boolean |	No |	Explicit Access. Defaults to ‘false’. For Controlled Unclassified files, specify "true"|  
+export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP validation	| 
 
 ### Unarchive Notice 
 (unarchiveNotice)
 
@@ -4134,14 +4134,12 @@ Element Name	|	Business Rules |	Error Messages with respect to business rules (I
 date|		Date field should meet the expected format	|DATE field in unexpected format. Expects YYYYMMDD
 officeid|		1. If an invalid officeid is given, then service throws an error

 2. If contracting officer does not have access to an office but is trying to make a submission to that office, then the service throws an error

 3. Office ID must be associated with user account	|1. Invalid officeid provided

 2. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 solnbr| 1. This field is required where applicable. If no value is provided, then service throws an error

 2. If invalid combination of ntype and solnbr is provided, then system throws an error

  	|1. Multiple notices found. Please input more details

  2. Notice not found

 
-ntype	|	1. If field is not provided OR a wrong ntype is provided, then service throws an error  |  1. Notice Type value provided is not valid
+ntype	|	1. If an invalid ntype is provided, then service throws an error   | 1. Invalid NTYPE value provided
 uploadtype|	NA|	NA
 respdate|	1.	No validation is performed on this field. However, if this value is available, this field should meet the character limit/restrictions	|1.	DATE field in unexpected format. Expects YYYYMMDD
 links|	1.This field is not required but if url & description fields within the links and files are empty, then the service throws an error.

 2. If a link with same name already exists on the notice, then the system throws an error.

 3. If the Url is empty for a link, then the system throws an error.

 4.	If the description is missing for a link, then the system throws an error.| 1.	Links and/or files are not complete

 2.	Resource with the same name already exists

 3.	Link Resource must have a link

 4. Link Resource must have a description
 files	|	1.	This field is not required but if url & description fields within the links and files are empty, then the service throws an error

 2.	If the filename is not provided for a file, then the system throws an error

 3.	If the filedata is empty for a file, then the system throws an error

 4.	If the filename provided has either no type specified or is an unsupported type, then the system throws an error

 5.	If the file size exceeds 250MB, then the system throws an error 

 6. If a file with same name already exists on the notice, then the system throwns an error |1.	Links and/or files are not complete 

2.	Attachment must have a name

 3.	Attachment must have content 

4.	The file type that you are trying to upload is not supported

 5.	The file size should be greater than zero bytes and less than 250 MB 

6.	Resource with the same name already exists
 
-
-
 #### deleteNoticeOrDocumentPackage
 
 Individual business rules per field are listed across each of the fields in below table.  
@@ -4312,25 +4310,6 @@ nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service
 vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error

3. If the Explicit Access request found for the vendor and solnum is already rejected, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 

 3.	Request with Request ID: #id already rejected
 reason|  1.	This is a required field. If no value is provided, then the system throws an error| 1.	A reason must be provided with an explicit access rejection
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
 #### submitFairOpps
 
 This service is now deprecated. Instead, please use submitJA to perform the operation.

From 11a6768d14a89724d23ff16c8825fed23d87961c Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 07:52:22 -0400
Subject: [PATCH 108/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 570fecb7e..e53deb049 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -2766,7 +2766,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-Request JSON  | Body | JSON | Yes | [Refer Vendor Data JSON](#vendor-data-json)
+Request JSON  | Body | JSON | Yes | [Refer Vendor Data Contract JSON](#vendor-data-contract-json)
 
 Responses
 
@@ -3711,7 +3711,7 @@ Name | Data Type | Allowed Values | Required | Description
 ivlCreate | string | forcedon, forcedoff | Yes | Indicates whether vendors can indicate interest in the organization’s Opportunities
 ivlView | string | forcedon, forcedoff | Yes | Indicates whether vendors can view other vendors interested in the organization’s Opportunities
 
-### Vendor Data JSON
+### Vendor Data Contract JSON
 
 

 


From fd3a8f94754028fef970b139822d6023247d9b0b Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 07:59:36 -0400
Subject: [PATCH 109/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md      | 2 ++
 _apidocs/opportunities-soap-api.md | 4 ++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index e53deb049..9684872a2 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3729,6 +3729,7 @@ ivlView | string | forcedon, forcedoff | Yes | Indicates whether vendors can vie

+ * Field headers in the table must match with field headers shown in JSON example @@ -3761,6 +3762,7 @@ cageCode | string | | Yes | Cage Code

+ * Field headers in the table must match with field headers shown in JSON example diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index 0b012de66..f5bd33b72 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -4093,8 +4093,8 @@ classcod |1. This field is required where applicable

2.If a wrong cl naics |NA | NAICS code is required offadd| Not Used| NA officeid |1. This field is required

2. If an invalid officeid is given, then service throws an error

3. If user does not have access to an office but is trying to make a submission to that office, then the service throws an error

|1. Contracting Office is required

2. Invalid officeid provided

3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check -subject | 1. This field is required where appicable |1. $.data.title: is missing but it is required -solnbr| 1. This field is required where applicable

2. If submitting a notice with a duplicabe solnbr, then system throws an error

3. If solnbr is in invalid format, then service throws an error

4. If solnbr & ntype combination is not matched, then service throws an error

| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype

5. Notice ID must be unique based on selected notice type +subject | 1. This field is required where appicable |1. title: is missing but it is required +solnbr| 1. This field is required where applicable

2. If submitting a notice with a duplicate solnbr, then system throws an error

3. If solnbr is in invalid format, then service throws an error

4. If solnbr & ntype combination is not matched, then service throws an error

| 1. Notice Id is required

2. Notice Id for the selected opportunity type already exists

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces

4. Opportunity not found with given solicitation number and ntype

5. Notice ID must be unique based on selected notice type ntype |1. When user tries to convert a notice and the solicitation number/ntype do not match the notice, then the service throws an error

2. This field accepts only valid values listed. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error |1. Opportunity not found with given solicitation number and ntype

2. Invalid NTYPE value provided awdnbr| 1. This field is required where applicable| 1. Award Details Section - Contract Award Number is a required field donbr |1. This field is required where applicable

2. If value provided does not meet the character limit/restrictions, then service throws an error| 1. Award Details Section - Task/Delivery Order Number is required field

2. Award Details Section - Task/Delivery Order Number - Please enter a valid number From edccbb11c73837cf154684d50513abc90f039d11 Mon Sep 17 00:00:00 2001 From: "anusha.paladugu" Date: Thu, 31 Oct 2019 09:02:03 -0400 Subject: [PATCH 110/149] update opportunities-api.md --- _apidocs/opportunities-api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 9684872a2..95e607807 100644 --- a/_apidocs/opportunities-api.md +++ b/_apidocs/opportunities-api.md @@ -3748,7 +3748,7 @@ cageCode | string | | Yes | Cage Code
-Delete_Notice_Contract_JSONDelete_Notice_Contract_JSON 

    {

From bcb06453ea65ef64e1f84e66b66827b450f79273 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 09:12:41 -0400
Subject: [PATCH 111/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 95e607807..8c215a679 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -1345,7 +1345,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization	| Header | string |	Yes |	Valid and authorized user ID
 api_key |	query |	string |	Yes |	Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice JSON](#delete-notice-json)
+Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice JSON](#delete-notice-contract-json)
 
 Responses
 
@@ -3744,7 +3744,7 @@ cageCode | string | | Yes | Cage Code
 
 
Back to top

 
-### Delete Notice JSON
+### Delete Notice Contract JSON
 
 

 


From bf522e21cc308b813a5a6c0ac94395a94ee3f70d Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 09:49:36 -0400
Subject: [PATCH 112/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index f5bd33b72..df4644e6f 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -489,7 +489,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No  |	Posting Date (Deprecated) |	YYYYMMDD
 zip |	string |	No |Zip Code (Deprecated) |	5 digits
-classcod |	string	 | Yes - for SOL, COMBINE, SSALE, ITB, JA, PRESOL   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
+classcod |	string	 | Yes - for SOL, COMBINE, SSALE, PRESOL   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
 naics | 	string |	Yes - for COMBINE, SOL  | 	NAICS Code |	Valid NAICS Code  
NAICS Reference
 officeid |	string	| Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 offadd |	string	| No	| Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
@@ -1271,7 +1271,7 @@ ntype	|string	|No|	Notice Type	| [Refer Notice Types](#notice-types)
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
 Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.|  32 characters
 vendor	|VendorData|	No|	Complex type not used in this method|
-reason	|string|	No|	Rejection reason not used in this method| 65535 characters
+reason	|string|	No|	Not in Use| 65535 characters
 
 Response:
 
@@ -1296,9 +1296,9 @@ Element Name	|Type	|Required|	Description | Character Limit / Restrictions
 solnbr	|string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 ntype|	string|	No|	Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method|
-Id	|string	|No	|Not used in this method| 32 characters
+Id	|string	|No	|Not in Use | 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
-reason	|string|	No|	Rejection reason not used in this method| 65535 characters
+reason	|string|	No|	Not in Use| 65535 characters
 
 Response:
 
@@ -1363,7 +1363,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method|
-Id	|string	|No	|Not used in this method| 32 characters
+Id	|string	|No	|Not in Use| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
 reason|	string|	Yes	|Rejection Reason | 65535 characters
 
@@ -1400,9 +1400,9 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.|
-Id	|string	|No	|Not used in this method| 32 characters
+Id	|string	|No	|Not in Use| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
-reason	|string|	No|	Rejection reason not used in this method| 65535 characters
+reason	|string|	No|	Not in Use| 65535 characters
 
 Response:
 
@@ -4091,7 +4091,7 @@ notice_type	|	1. This field is required where applicable |	1. Opportunity type i
 zip|	NA |NA
 classcod	|1. This field is required where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. Product Service Code is a required field 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
 naics		|NA |  NAICS code is required
-offadd| Not Used|	NA
+offadd| Not in Use|	NA
 officeid	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If user does not have access to an office but is trying to make a submission to that office, then the service throws an error

	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|	1. This field is required where appicable 	|1. title: is missing but it is required
 solnbr|	1. This field is required where applicable

  2. If submitting a notice with a duplicate solnbr, then system throws an error 

3. If solnbr is in invalid format, then service throws an error

4. If solnbr & ntype combination is not matched, then service throws an error 

 |	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype 

5. Notice ID must be unique based on selected notice type

From 08290bb2d9ab02856fce70cdc83e5b9c2a92f0b8 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 10:47:19 -0400
Subject: [PATCH 113/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 7628373a3..d6acf0615 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3779,6 +3779,12 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Additional Reporting |	Additional Reporting/Initiative is required. |	Additional Reporting/Initiative is required when opportunity is not a special notice | Publish
 400|Title |	Title max character length is 256. |	Title max character length is 256.	| Publish
 400|ARCHIVE |	This opportunity is not the latest published. |	Draft Opportunity cannot be archived.	| Archive
+400|UNARCHIVE |	Opportunity is active. |	Active opportunity	| UnArchive
+400|UNARCHIVE |	Opportunity is cancelled. |	Cancelled opportunity	| UnArchive
+400|UNARCHIVE |	The new opportunity type field is missing. |	prevent activating if opportunity type is `m`, `l` or `j` and new type opportunity isn't provided	| UnArchive
+400|UNARCHIVE |	The new opportunity type field is not supported. |	prevent activating if opportunity type is not one of `m`, `l` or `j` and new type opportunity is provided	| UnArchive
+400|UNARCHIVE |	The Opportunity's type provided is not supported. |	prevent activating if opportunity type is `m` and new type opportunity provided is not supported	| UnArchive
+400|UNARCHIVE |	The new opportunity type provided is not supported. |	prevent activating if opportunity type is  `l` or `j` and new type opportunity provided is not `u`	| UnArchive
 400|Archive Date |	$.archive.date: does not match the date pattern ^\\d{4}-(?:0[0-9]{1}\1[0-2]{1})-(0?[1-9]\[12][0-9]\3[01])$ |	Archive Date must be in specified format |	Create, Publish, Uncancel, Unarchive
 400|Archive Date |	This opportunity cannot be published. Inactive date is a required field. |	Archive Date is required if Archive Type = autocustom |	Create, Publish, Uncancel, Unarchive
 400|Archive Date Response Date   |	One of Response date or Archive date is required |	Either Response date or archive date is required for presolicitation, sources sought, special notice, sale surplus  |	Publish

From 0efd6f7a50af0d4a519230007860d63ecffeb1f8 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 11:09:47 -0400
Subject: [PATCH 114/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index d6acf0615..1e367f788 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3781,14 +3781,16 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|ARCHIVE |	This opportunity is not the latest published. |	Draft Opportunity cannot be archived.	| Archive
 400|UNARCHIVE |	Opportunity is active. |	Active opportunity	| UnArchive
 400|UNARCHIVE |	Opportunity is cancelled. |	Cancelled opportunity	| UnArchive
-400|UNARCHIVE |	The new opportunity type field is missing. |	prevent activating if opportunity type is `m`, `l` or `j` and new type opportunity isn't provided	| UnArchive
-400|UNARCHIVE |	The new opportunity type field is not supported. |	prevent activating if opportunity type is not one of `m`, `l` or `j` and new type opportunity is provided	| UnArchive
-400|UNARCHIVE |	The Opportunity's type provided is not supported. |	prevent activating if opportunity type is `m` and new type opportunity provided is not supported	| UnArchive
-400|UNARCHIVE |	The new opportunity type provided is not supported. |	prevent activating if opportunity type is  `l` or `j` and new type opportunity provided is not `u`	| UnArchive
+400|Opportunity Type |	The new opportunity type field is missing. |	prevent activating if opportunity type is `m`, `l` or `j` and new type opportunity isn't provided	| UnArchive
+400|Opportunity Type |	The new opportunity type field is not supported. |	prevent activating if opportunity type is not one of `m`, `l` or `j` and new type opportunity is provided	| UnArchive
+400|Opportunity Type |	The Opportunity's type provided is not supported. |	prevent activating if opportunity type is `m` and new type opportunity provided is not supported	| UnArchive
+400|Opportunity Type |	The new opportunity type provided is not supported. |	prevent activating if opportunity type is  `l` or `j` and new type opportunity provided is not `u`	| UnArchive
 400|Archive Date |	$.archive.date: does not match the date pattern ^\\d{4}-(?:0[0-9]{1}\1[0-2]{1})-(0?[1-9]\[12][0-9]\3[01])$ |	Archive Date must be in specified format |	Create, Publish, Uncancel, Unarchive
 400|Archive Date |	This opportunity cannot be published. Inactive date is a required field. |	Archive Date is required if Archive Type = autocustom |	Create, Publish, Uncancel, Unarchive
 400|Archive Date Response Date   |	One of Response date or Archive date is required |	Either Response date or archive date is required for presolicitation, sources sought, special notice, sale surplus  |	Publish
 400|Archive Date |	Inactive date provided is an invalid format. |	Date is not in specified format  |	Create, Publish, Uncancel, Unarchive
+400|Archive Type |	New archive type is invalid. |	archive type is not one of the following "auto15", "autocustom", "auto30"	| UnArchive
+400|Archive Type |	Archive type is invalid for this notice type. |	archive type is one of the following "auto15", "auto30" and is not allowed for this notice type	| UnArchive
 400|Archive Type |	This opportunity cannot be published. Inactive Policy is a required field. |	Archive Type is required |	Publish
 400|Archive Type |	$.archive.type: does not have a value in the enumeration[auto15, auto30, autocustom] |	Archive type must be specified value | Create, Publish, Uncancel, Unarchive
 400|Archive Type |	This opportunity cannot be published. Auto 15 archive type is not allowed for this opportunity type. | Archive Type = auto15 not allowed |	Publish
@@ -3888,7 +3890,9 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Response Date |	Response Date set would result in inactive date being in the past. |	Response Date provided is within 15 days |	Publish
 400|Response Date |	Auto 15 archive type is not allowed for this opportunity type. |	Auto 15 archive type is not allowed for award notice |	Publish
 400|Response Date |	Response Date cannot exceed 5 years from current date. |	Response Date cannot exceed 5 years from current date. |	Publish 
-
+400|Response Date |	New response date is required. |	Unarchive requires new response date	| UnArchive
+400|Response Date |	New response date provided is in an invalid format. |	Invalid date format	| UnArchive
+400|Response Date |	New response date provided is in the past. |	Response date is before offset date	| UnArchive
 400|Title |	Title is required |	Title is required |	Publish
 400|UNARCHIVE |	This opportunity is not the latest published |	Only archived notices can be unarchived | UNARCHIVE
 400|resourceName | Attachment must have a name | File Name is a required field |	Create Attachment

From a51b4243e7c28c1c52878356e497daca87ae3361 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 12:07:03 -0400
Subject: [PATCH 115/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 288 ++++++++++++++++------------------
 1 file changed, 137 insertions(+), 151 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 8c215a679..9f4ffdc98 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -577,6 +577,8 @@ Examples
 **Consumes** | application/json
 **Produces** | NA
 
+**Please [Refer Create and Update Opportunity Contract JSON](#create-and-update-opportunity-contract-json) to ensure that all required fields in "Required (Publish)" is met to publish opportunity**
+
 Request Parameters
 
 Parameter Name | Parameter Type | Data Type  | Required | Description
@@ -1345,7 +1347,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization	| Header | string |	Yes |	Valid and authorized user ID
 api_key |	query |	string |	Yes |	Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice JSON](#delete-notice-contract-json)
+Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice JSON](#delete-notice-json)
 
 Responses
 
@@ -3052,25 +3054,21 @@ Examples
 
 * Field headers in the table must match with field headers shown in JSON example  
 
-Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (to Publish) | Description
+Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (Publish) | Description
 -----|-----------|-------|-------------------|------------|------------ |----------
 type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Yes | Notice Type
-solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number
+solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes (No for type = s  (Special Notice)) | Solicitation Number
 title | string | 256 characters | |Yes | Yes | Title of the Opportunity
-organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
-organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
-classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
+organizationId | string | 32 characters | | Yes | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
+classificationCode | string |  | | No | Yes (No for type = r, g, a  (SourcesSought, Sale of Surplus, Awards)) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA | NA |
-naics.code | Array of String | | NAICS Reference| No | Yes | Valid NAICS Code
+naics.code | Array of String | | NAICS Reference| No | Yes for type = k, o (Combined Synopsis, Solicitation) | Valid NAICS Code
 naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
-flags | JSON Array| NA |NA | NA | NA |
-flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
-flags.IsSelected | boolean | |default is 'True' | No | No |
 pointOfContact | JSON Array | NA |NA | NA | NA |
-pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
+pointOfContact.type | string | | primary
 secondary | No | Yes (No for type = a, s (Award, Special Notice)) | Contact Type Note: 'p' and 's' must be in lower case
 pointOfContact.title | string | |  | No | No | Contact title
-pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
-pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
+pointOfContact.fullname | string | 255 characters| | No | Yes (No for type = a (Award))| Contact Full Name
+pointOfContact.email | string |255 characters | | No  | Yes (No for type = a (Award))  | Contact email
 pointOfContact.phone | string |255 characters | | No | No | Contact Phone
 pointOfContact.fax | string | 255 characters | | No  | No | Contact Fax
 pointOfContact.additionalInfo | JSON |NA |NA | NA  | NA |  Any additional information on Point of Contact
@@ -3089,51 +3087,47 @@ placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
 placeOfPerformance.
country.name | string | | | No | No | Pop Country name
 placeOfPerformance.zip | string | | | No | No | Pop Country zip
 archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type.
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
+archive.type | string | | auto15
 auto30
 autocustom | No | Yes | Archive Type
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | | No | Yes for archive.type = autocustom | Archive Date
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA | NA |
-permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
-permissions.ivl.create | boolean | | | No | No | IVL create permission
-permissions.ivl.read | boolean | | | No | No | IVL read permission
+permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a desire to submit a proposal
+permissions.ivl.create | boolean | | | No | Yes (No for type = a (Award)) | IVL create permission
+permissions.ivl.read | boolean | | | No | Yes (No for type = a (Award)) | IVL read permission
 permissions.ivl.update | boolean | |  | No | No | IVL update permission
 permissions.ivl.delete | boolean | | | No | No | IVL delete permission
 solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code.
 The designator for type of set aside determined for the contract action
+solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code
 The designator for type of set aside determined for the contract action
 solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
-solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
+solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes for type = k, o (Combine Synopsis, Solicitation) 
2)	Yes if archive.type=auto15 except type = a (Award)	| Deadline Date
 solicitation.deadlines.
responseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
-award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for  'Award Notice' and 'Justification' opportunity types
-award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date
-award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number
-award.deliverOrderNumber | string | 255 characters| | No | No | Award Delivery Order Number
-award.amount | number |64 digits |  | No | No | Award Amount
+award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for Award, Justification and Intent to Bundle opportunity types
+award.date | date | |YYYY-MM-DD |No | Yes only for type = a (Award) | Award Date
+award.number | string | 255 characters | |No | Yes only for type= i, j, a (Intent to Bundle, Justification, Award) | Award Number
+award.deliverOrderNumber | string | 255 characters| | No | Yes only for type = j (Justification) | Award Delivery Order Number
+award.amount | number |64 digits |  | No | Yes only for type = a (Award) | Award Amount
 award.lineitemNumber | string |255 characters | | No | No | Contract Line item Number
-award.awardee | JSON | NA| NA | NA | NA |Awardee details
-award.awardee.name | string | 255 characters | | No | No | Awardee Name
-award.awardee.duns | string | 9 digits | | No | No | Awardee Duns
-award.awardee.location | JSON |NA | NA | NA | NA | Awardee Location details
+award.awardee | JSON | NA| NA | NA | NA |Awardee details; Only for type = a (Award)
+award.awardee.name | string | 255 characters | | No | No; Either awardee.name or awardee.duns is required | Awardee Name
+award.awardee.duns | string | 9 digits | | No | No; Either awardee.name or awardee.duns is required | Awardee Duns
+award.awardee.location | JSON |NA | NA | NA | NA | Awardee Location details; **Required if awardee.name is provided**
 award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 
 award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 2
 award.awardee.location.
city | JSON |NA |NA |NA | NA | Awardee City details
-award.awardee.location.
city.code | string | | | No | No | Awardee City code
+award.awardee.location.
city.code | string | | | No | Yes | Awardee City code
 award.awardee.location.
city.name | string | | | No | No | Awardee City name
 award.awardee.location.
state | JSON | NA | NA | NA | NA | Awardee State details
-award.awardee.location.
state.code | string | | | No | No | Awardee State code
+award.awardee.location.
state.code | string | | | No | Yes | Awardee State code
 award.awardee.location.
state.name | string | | | No | No | Awardee State name
 award.awardee.location.
country | JSON | NA| NA | NA | NA |Awardee Country details
-award.awardee.location.
country.code | string | | | No | No | Awardee Country code
+award.awardee.location.
country.code | string | | | No | Yes | Awardee Country code
 award.awardee.location.
country.name | string | | | No | No | Awardee Country Name
 award.awardee.location.
zip | string | | | No | No | Awardee Country Zip code
-justificationAuthority | JSON |NA |NA | NA | NA |
+justificationAuthority | JSON |NA |NA | NA | NA | Only for type = j (Justification)
 justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
-justificationAuthority.
authority | string|  |  | No | No | Justification Authority
-link | JSON | NA |NA | NA | NA |
-link.href | string | | | No | No | Url for the notice on SAM.gov
-link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
-link.additionalInfo.
content | string | | | No | No | Additional information details
-additionalReporting | string | |none, 
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
+justificationAuthority.
authority | string|  |  | No | Yes | Justification Authority
+additionalReporting | string | |none, 
auto_recovery | No | Yes; No for type = s (Special Notice) | Initiative that applies to the notice
 description | JSON | NA | NA | NA | NA |
-description.body | string | 65535 characters| | No | Yes | Description of the notice
+description.body | string | 65535 characters| | No | Yes; No for type = a (Award) | Description of the notice
 related | JSON | NA | NA | NA | NA | Related Notice information
 related.opportunityId | string | 32 characters| | No | No | Opportunity Id of the related notice
 
@@ -3316,99 +3310,91 @@ reason | string |  | No | Publish reason
 
 * Field headers in the table must match with field headers shown in JSON example  
 
-Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (to Publish) | Description
+Name | Data Type |Field Length | Allowed Values| Required | Description
 -----|-----------|-------|-------------------|------------|------------ |----------
 type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Yes | Notice Type
-solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes | Solicitation Number
-title | string | 256 characters | |Yes | Yes | Title of the Opportunity
-organizationId | string | 32 characters | |No for Create (Yes for Update) | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
-organizationLocationId | string | | | No|No| This field has been deprecated. Organization Location details will be pulled from the Federal Hierarchy 
-classificationCode | string |  | | No | Yes (not required for type= r) | Product Service Code (PSC)
-naics | JSON Array | NA |NA | NA | NA |
-naics.code | Array of String | | NAICS Reference| No | Yes | Valid NAICS Code
-naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
-flags | JSON Array| NA |NA | NA | NA |
-flags.code | string | |Recovery act | No | No | This is a recovery or Reinvestment Act Action
-flags.IsSelected | boolean | |default is 'True' | No | No |
-pointOfContact | JSON Array | NA |NA | NA | NA |
-pointOfContact.type | string | | primary,
 secondary | No | Yes | Contact Type Note: 'p' and 's' must be in lower case
-pointOfContact.title | string | |  | No | No | Contact title
-pointOfContact.fullname | string | 255 characters| | No | Yes | Contact Full Name
-pointOfContact.email | string |255 characters | | No  | Yes (no if type = a)  | Contact email
-pointOfContact.phone | string |255 characters | | No | No | Contact Phone
-pointOfContact.fax | string | 255 characters | | No  | No | Contact Fax
-pointOfContact.additionalInfo | JSON |NA |NA | NA  | NA |  Any additional information on Point of Contact
-pointOfContact.additionalInfo.
content | String | | | No  | No | Details of the additional information on Point of Contact 
-placeOfPerformance | JSON | NA | NA | NA | NA |
-placeOfPerformance.
streetAddess | string | | | No | No | Pop Address
-placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2
-placeOfPerformance.city | JSON | NA | NA | NA | NA | Pop City
-placeOfPerformance.city.
code | string | | | No | No | Pop City code
-placeOfPerformance.city.
name | string | | | No | No | Pop City name
-placeOfPerformance.state | JSON |NA | NA | NA | NA | Pop City state
-placeOfPerformance.state.
code | string | | | No | No | Pop city state code
-placeOfPerformance.state.
name | string | | | No | No | Pop city state name
-placeOfPerformance.country | JSON | NA | NA | NA | NA | Pop Country
-placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
-placeOfPerformance.
country.name | string | | | No | No | Pop Country name
-placeOfPerformance.zip | string | | | No | No | Pop Country zip
-archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15,
 auto30,
 autocustom | No | Yes | Archive Type. 
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | | No | Yes (if archive.type=
autocustom) | Archive Date.
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
-permissions | JSON | NA | NA | NA | NA |
-permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Inerested Vendor's List' where users outside the notice can indicate a desire to submit a proposal. This list in way binds either party
-permissions.ivl.create | boolean | | | No | No | IVL create permission
-permissions.ivl.read | boolean | | | No | No | IVL read permission
-permissions.ivl.update | boolean | |  | No | No | IVL update permission
-permissions.ivl.delete | boolean | |  | No | No | IVL delete permission
-solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code. 
The designator for type of set aside determined for the contract action
-solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
-solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
-solicitation.deadlines.
responseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
-award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for  'Award Notice' and 'Justification' opportunity types
-award.date | date | |YYYY-MM-DD |No | Yes only for type= a | Award Date
-award.number | string | 255 characters | |No | Yes only for type= i, j, a | Award Number
-award.deliverOrderNumber | string | 255 characters| | No | No | Award Delivery Order Number
-award.amount | number |64 digits |  | No | No | Award Amount
-award.lineitemNumber | string |255 characters | | No | No | Contract Line item Number
-award.awardee | JSON | NA| NA | NA | NA |Awardee details
-award.awardee.name | string | 255 characters | | No | No | Awardee Name
-award.awardee.duns | string | 9 digits | | No | No | Awardee Duns
-award.awardee.location | JSON |NA | NA | NA | NA | Awardee Location details
-award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 
-award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 2
-award.awardee.location.
city | JSON |NA |NA |NA | NA | Awardee City details
-award.awardee.location.
city.code | string | | | No | No | Awardee City code
-award.awardee.location.
city.name | string | | | No | No | Awardee City name
-award.awardee.location.
state | JSON | NA | NA | NA | NA | Awardee State details
-award.awardee.location.
state.code | string | | | No | No | Awardee State code
-award.awardee.location.
state.name | string | | | No | No | Awardee State name
-award.awardee.location.
country | JSON | NA| NA | NA | NA |Awardee Country details
-award.awardee.location.
country.code | string | | | No | No | Awardee Country code
-award.awardee.location.
country.name | string | | | No | No | Awardee Country Name
-award.awardee.location.
zip | string | | | No | No | Awardee Country Zip code
-justificationAuthority | JSON |NA |NA | NA | NA |
-justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
-justificationAuthority.
authority | string|  |  | No | No | Justification Authority
-link | JSON | NA |NA | NA | NA |
-link.href | string | | | No | No | Url for the notice on SAM.gov
-link.additionalInfo | JSON | NA |NA | NA | NA | Any additional information on the opportunity
-link.additionalInfo.
content | string | | | No | No | Additional information details
-additionalReporting | string | |none,
auto_recovery | No | Yes | Additional reporting requirements that apply to the contract action
-description | JSON | NA | NA | NA | NA |
-description.body | string | 65535 characters| | No | Yes | Description of the notice
+solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {}| Yes (No for type = s  (Special Notice)) | Solicitation Number
+title | string | 256 characters | | Yes | Title of the Opportunity
+organizationId | string | 32 characters | | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
+classificationCode | string |  | | Yes (No for type = r, g, a  (SourcesSought, Sale of Surplus, Awards)) | Product Service Code (PSC)
+naics | JSON Array | NA |NA | NA |
+naics.code | Array of String | | NAICS Reference| No | Yes for type = k, o (Combined Synopsis, Solicitation) | Valid NAICS Code
+naics.type | string | |primary|Yes | NAICS Type Note: 'p' must be in lower case
+pointOfContact | JSON Array | NA |NA | NA |
+pointOfContact.type | string | | primary
 secondary | Yes (No for type = a, s (Award, Special Notice)) | Contact Type Note: 'p' and 's' must be in lower case
+pointOfContact.title | string | |  | No | Contact title
+pointOfContact.fullname | string | 255 characters| | Yes (No for type = a (Award))| Contact Full Name
+pointOfContact.email | string |255 characters | | Yes (No for type = a (Award))  | Contact email
+pointOfContact.phone | string |255 characters | | No | Contact Phone
+pointOfContact.fax | string | 255 characters | | No | Contact Fax
+pointOfContact.additionalInfo | JSON |NA |NA | NA |  Any additional information on Point of Contact
+pointOfContact.additionalInfo.
content | String | | | No | Details of the additional information on Point of Contact 
+placeOfPerformance | JSON | NA | NA | NA |
+placeOfPerformance.
streetAddess | string | | |No | Pop Address
+placeOfPerformance.
streetAddess2 | string | | | No | Pop Address2
+placeOfPerformance.city | JSON | NA | NA |NA | Pop City
+placeOfPerformance.city.
code | string | | |No | Pop City code
+placeOfPerformance.city.
name | string | | |No | Pop City name
+placeOfPerformance.state | JSON |NA | NA |NA | Pop City state
+placeOfPerformance.state.
code | string | | | No | Pop city state code
+placeOfPerformance.state.
name | string | | | No | Pop city state name
+placeOfPerformance.country | JSON | NA | NA | NA | Pop Country
+placeOfPerformance.
country.code | string | | |No | Pop Country Code
+placeOfPerformance.
country.name | string | | |No | Pop Country name
+placeOfPerformance.zip | string | | |No | Pop Country zip
+archive | JSON |NA | NA | NA | Contract opportunity archive policy information
+archive.type | string | | auto15
 auto30
 autocustom | Yes | Archive Type
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
+archive.date | date | | |Yes for archive.type = autocustom | Archive Date
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
+permissions | JSON | NA | NA | NA 
+permissions.ivl | JSON | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a desire to submit a proposal
+permissions.ivl.create | boolean | | | Yes (No for type = a (Award)) | IVL create permission
+permissions.ivl.read | boolean | | |Yes (No for type = a (Award)) | IVL read permission
+permissions.ivl.update | boolean | |  | No | IVL update permission
+permissions.ivl.delete | boolean | | |No | IVL delete permission
+solicitation | JSON |NA | NA | NA 
+solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | Set-Aside code
 The designator for type of set aside determined for the contract action
+solicitation.deadlines | JSON | NA | NA | NA |Response deadline date for Contract opportunity
+solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for type = k, o (Combine Synopsis, Solicitation) 
2)	Yes if archive.type=auto15 except type = a (Award)	| Deadline Date
+solicitation.deadlines.
responseTz |string | | |No | Time Zone for 
Solicitation Deadline Date
+award | JSON | NA | NA | NA| This section is mainly used for providing award information that is required for Award, Justification and Intent to Bundle opportunity types
+award.date | date | |YYYY-MM-DD | Yes only for type = a (Award) | Award Date
+award.number | string | 255 characters | |Yes only for type= i, j, a (Intent to Bundle, Justification, Award) | Award Number
+award.deliverOrderNumber | string | 255 characters| | Yes only for type = j (Justification) | Award Delivery Order Number
+award.amount | number |64 digits |  | Yes only for type = a (Award) | Award Amount
+award.lineitemNumber | string |255 characters | | No | Contract Line item Number
+award.awardee | JSON | NA| NA | NA |Awardee details; Only for type = a (Award)
+award.awardee.name | string | 255 characters | | No; Either awardee.name or awardee.duns is required | Awardee Name
+award.awardee.duns | string | 9 digits | | No; Either awardee.name or awardee.duns is required | Awardee Duns
+award.awardee.location | JSON |NA | NA | NA | Awardee Location details; **Required if awardee.name is provided**
+award.awardee.location.
streetAddress | string | | | No | Awardee Street Address 
+award.awardee.location.
streetAddress2 | string | | | No | Awardee Street Address 2
+award.awardee.location.
city | JSON |NA |NA |NA | Awardee City details
+award.awardee.location.
city.code | string | | | Yes | Awardee City code
+award.awardee.location.
city.name | string | | | No | Awardee City name
+award.awardee.location.
state | JSON | NA | NA | NA | Awardee State details
+award.awardee.location.
state.code | string | | | Yes | Awardee State code
+award.awardee.location.
state.name | string | | | No | Awardee State name
+award.awardee.location.
country | JSON | NA| NA | NA |Awardee Country details
+award.awardee.location.
country.code | string | | | Yes | Awardee Country code
+award.awardee.location.
country.name | string | | |  No | Awardee Country Name
+award.awardee.location.
zip | string | | | No | Awardee Country Zip code
+justificationAuthority | JSON |NA |NA | NA | Only for type = j (Justification)
+justificationAuthority.
modificationNumber | string | 32 characters| | No | Justification Authority Modification Number
+justificationAuthority.
authority | string|  |  | Yes | Justification Authority
+additionalReporting | string | |none, 
auto_recovery | Yes; No for type = s (Special Notice) | Initiative that applies to the notice
+description | JSON | NA | NA | NA |
+description.body | string | 65535 characters| | Yes; No for type = a (Award) | Description of the notice
 related | JSON | NA | NA | NA | NA | Related Notice information
-related.opportunityId | string | 32 characters| | No | No | Opportunity Id of the related notice
-resources | JSON |NA | NA | NA | NA |
-resources.attType | string | |link, file | No |No| Type of attachment, either link or file
-resources.content | byte |250MB |  | No|No | File content in base64 format
-resources.link | string | 255 characters | |No|No | Resource link URL
-resources.packageAccessLevel | string | | public,
private
(default public) | No | No| Type of access to file
-resources.resourceName | string | 255 characters |  | No|No | Name of file
-resources.description | string |255 characters | | No|No | Description of the link
-resources.explicitAccess | string |1 character | 0, 1 (defaults to '0' public access, if not provided) | No |No |Explicit Access. For Controlled Unclassified files, specify '1'
-resources.exportControlled | string |1 character | 0 | No |No |Export Controlled. * Captured for future JCP validation
+related.opportunityId | string | 32 characters| | No | Opportunity Id of the related notice
+resources | JSON |NA | NA | NA |
+resources.attType | string | |link, file | No| Type of attachment, either link or file
+resources.content | byte |250MB |  | No | File content in base64 format
+resources.link | string | 255 characters | |No | Resource link URL
+resources.packageAccessLevel | string | | public,
private
(default public) |  No| Type of access to file
+resources.resourceName | string | 255 characters |  | No | Name of file
+resources.description | string |255 characters | | No | Description of the link
+resources.explicitAccess | string |1 character | 0, 1 (defaults to '0' public access, if not provided) |No |Explicit Access. For Controlled Unclassified files, specify '1'
+resources.exportControlled | string |1 character | 0 | No |Export Controlled. * Captured for future JCP validation
 
 
 
Back to top

@@ -3434,7 +3420,7 @@ resources.exportControlled | string |1 character | 0 | No |No |Export Controlled
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 requestType | string | update_publish_request | Yes | Type of request
-reason | string |  | Yes | Reason for revision
+reason | string |  | No | Reason for revision
 
 
Back to top

 
@@ -3461,7 +3447,7 @@ reason | string |  | Yes | Reason for revision
 
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
-reason | string |  | Yes | Reason for cancelation
+reason | string |  | No | Reason for cancelation
 requestType | string | cancel_request | Yes | Type of request
 description | string |  | Yes | Description for cancelation
 
@@ -3498,11 +3484,11 @@ Name | Data Type | Allowed Values | Required | Description
 reason | string |  | Yes | Reason for uncanceling
 requestType | string | uncancel_request | Yes | Type of request
 description | string |  | Yes | Description for uncanceling
-newContractAwardDate | date | YYYY-MM-DD | Yes (if unarchiving an award notice) | New Contract Award Date
+newContractAwardDate | date | YYYY-MM-DD | Yes for type = a (Award)| New Contract Award Date
 newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustome) | New Archive Date
 newArchiveType | string | auto15, auto30, autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | Yes (if newArchiveType = auto15) | New Response Date
-newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) | New Response Time Zone
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1). Yes for types = k, o (Combined Synopsis/Solicitation) 2). Yes if Newarchive.type=auto15 except type = a (Award) | New Response Date
+newResponseTz | string |  | No | New Response Time Zone
 
 
Back to top

 
@@ -3527,7 +3513,7 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided)
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 requestType | string | archive_request | Yes | Type of request
-reason | string |  | Yes | Archive reason
+reason | string |  | No | Archive reason
 
 
Back to top

 
@@ -3558,13 +3544,13 @@ reason | string |  | Yes | Archive reason
 
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
-reason | string |  | Yes | Reason for uncanceling
+reason | string |  | Yes | Reason for unarchiving
 requestType | string | unarchive_request | Yes | Type of request
-newContractAwardDate | date | YYYY-MM-DD | Yes (if unarchiving an award notice) | New Contract Award Date
-newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustom) | New Archive Date
+newContractAwardDate | date | YYYY-MM-DD | Yes for type = a (Award)| New Contract Award Date
+newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustome) | New Archive Date
 newArchiveType | string | auto15, auto30, autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | Yes (if newArchiveType = auto15) | New Response Date
-newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) | New Response Time Zone
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1). Yes for types = k, o (Combined Synopsis/Solicitation) 2). Yes if Newarchive.type=auto15 except type = a (Award) | New Response Date
+newResponseTz | string |  | No | New Response Time Zone
 
 
Back to top

 
@@ -3607,14 +3593,14 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided)
 Name | Data Type | Field Length |Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 attType | string | 32 characters |link, file | Yes | Type of attachment, either link or file
-content | byte | 250MB| | Yes (if attType=file) | File content in base64 format
+content | byte | 250MB| | Yes if attType=file | File content in base64 format
 packageAccessLevel | string | 32 characters|public,private(default public) | No | Type of access to file. Only used with attType 'file'.
-resourceName | string | 255 characters| | Yes (if attType=file) | Name of file
+resourceName | string | 255 characters| | Yes if attType=file | Name of file
 fileType | string | 64 characters | | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
-link | string | 255 characters| | Yes (if attType=link) | Resource link  URL
-description | string |255 characters | | Yes (if attType=link) | Description of the link
+link | string | 255 characters| | Yes if attType=link | Resource link  URL
+description | string |255 characters | | Yes if attType=link | Description of the link
 explicitAccess | string |1 character | 0, 1 (defaults to '0' public access, if not provided) | No  |Explicit Access. For Controlled Unclassified files, specify '1'
-exportControlled | string |1 character | 0 | No  |Export Controlled. * Captured for future JCP validation
+exportControlled | string |1 character | 0 | No  | *Captured for future JCP validation*
 Export Controlled
 
 #### Valid File Types 
 
@@ -3708,8 +3694,8 @@ resourceIdBelow | string  |  | No | This should be Resource ID of the file/link
 
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
-ivlCreate | string | forcedon, forcedoff | Yes | Indicates whether vendors can indicate interest in the organization’s Opportunities
-ivlView | string | forcedon, forcedoff | Yes | Indicates whether vendors can view other vendors interested in the organization’s Opportunities
+ivlCreate | string | forcedon, forcedoff | No | Indicates whether vendors can indicate interest in the organization’s Opportunities
+ivlView | string | forcedon, forcedoff | No | Indicates whether vendors can view other vendors interested in the organization’s Opportunities
 
 ### Vendor Data Contract JSON
 
@@ -3744,11 +3730,11 @@ cageCode | string | | Yes | Cage Code
 
 
Back to top

 
-### Delete Notice Contract JSON
+### Delete Notice JSON
 
 

 

-Delete_Notice_Contract_JSON
+Delete_Notice_Contract_JSON
 
    {
@@ -3768,7 +3754,7 @@ cageCode | string | | Yes | Cage Code
 
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
-reason|	string|	|	Yes|	Reason for deletion
+reason|	string|	|	No|	Reason for deletion
 requestType	|string	|delete_request |Yes	|Type of request
 description	|string|		|Yes|	Description for deletion of a notice
 deleteOption|	string|	latest, all|	Yes|	Option to delete either the latest or all versions of a notice

From 3849ad48776df873c4a9f26cb6b106cc74bb880b Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 12:09:30 -0400
Subject: [PATCH 116/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 9f4ffdc98..5dae2810d 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3090,7 +3090,7 @@ archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy informat
 archive.type | string | | auto15
 auto30
 autocustom | No | Yes | Archive Type
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
 archive.date | date | | | No | Yes for archive.type = autocustom | Archive Date
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA | NA |
-permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a desire to submit a proposal
+permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a interest in the notice
 permissions.ivl.create | boolean | | | No | Yes (No for type = a (Award)) | IVL create permission
 permissions.ivl.read | boolean | | | No | Yes (No for type = a (Award)) | IVL read permission
 permissions.ivl.update | boolean | |  | No | No | IVL update permission
@@ -3346,7 +3346,7 @@ archive | JSON |NA | NA | NA | Contract opportunity archive policy information
 archive.type | string | | auto15
 auto30
 autocustom | Yes | Archive Type
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
 archive.date | date | | |Yes for archive.type = autocustom | Archive Date
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
 permissions | JSON | NA | NA | NA 
-permissions.ivl | JSON | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a desire to submit a proposal
+permissions.ivl | JSON | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a interest in the notice
 permissions.ivl.create | boolean | | | Yes (No for type = a (Award)) | IVL create permission
 permissions.ivl.read | boolean | | |Yes (No for type = a (Award)) | IVL read permission
 permissions.ivl.update | boolean | |  | No | IVL update permission

From cdc0811f1925b9f1815dc98e34ef883811a8f8b5 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 12:19:12 -0400
Subject: [PATCH 117/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 222 +++++++++++-----------------------
 1 file changed, 71 insertions(+), 151 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 8c215a679..0ce285c7a 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -270,7 +270,6 @@ Examples
         }
     ]
 }
-
 

 

 

@@ -335,16 +334,6 @@ Examples
     "archive": {
       "type": "autocustom",
       "date": "2023-09-09"
-    },
-    "flags": [{
-        "code": "",
-        "isSelected": true
-    }],
-    "link": {
-        "additionalInfo": {
-            "content": ""
-        },
-        "href": ""
     },
      "additionalReporting": [
         "none"
@@ -435,18 +424,12 @@ Examples
         "solicitationNumber": "test-12345678901",
         "title": "Test submit solicitation",
         "organizationId": "100186612",
-        "organizationLocationId": "",
         "classificationCode": "1260",
         "naics": [
         {
             "type": "primary",
             "code": ["111150"]
         }],
-        "flags": [
-        {
-            "code": "",
-            "isSelected": true
-        }],
         "pointOfContact": [
         {
             "type": "primary",
@@ -542,14 +525,6 @@ Examples
                 "modificationNumber": "",
                 "authority": "dictionary"
             },
-            "link":
-            {
-                "additionalInfo":
-                {
-                    "content": ""
-                },
-                "href": ""
-            },
             "additionalReporting": ["none"]
         },
         "description": [
@@ -648,7 +623,6 @@ Examples
         "solicitationNumber": "test-12345457",
         "title": "Test Create and Publish SOL notice",
         "organizationId": "100186612",
-        "organizationLocationId": "",
         "classificationCode": "1260",
         "naics": [
             {
@@ -658,12 +632,6 @@ Examples
                 ]
             }
         ],
-        "flags": [
-            {
-                "code": "",
-                "isSelected": true
-            }
-        ],
         "pointOfContact": [
             {
                 "type": "primary",
@@ -745,12 +713,6 @@ Examples
             "modificationNumber": "",
             "authority": "dictionary"
         },
-        "link": {
-            "additionalInfo": {
-                "content": ""
-            },
-            "href": ""
-        },
         "additionalReporting": [
             "none"
         ]
@@ -932,12 +894,12 @@ Examples
             "name": ""
           }
         }
+      }
       },
       "justificationAuthority": {
         "modificationNumber": "",
         "authority": "dictionary"
       },
-    },
     "permissions": {
       "IVL": {
         "create": true,
@@ -956,18 +918,6 @@ Examples
       "type": "autocustom",
       "date": "2019-09-09"
     },
-    "flags": [
-      {
-        "code": "",
-        "isSelected": true
-      }
-    ],
-    "link": {
-      "additionalInfo": {
-        "content": ""
-      },
-      "href": ""
-    },
     "additionalReporting": [
       "none"
     ]
@@ -1049,18 +999,6 @@ Examples
       "type": "autocustom",
       "date": "2019-09-09"
     },
-    "flags": [
-      {
-        "code": "",
-        "isSelected": true
-      }
-    ],
-    "link": {
-      "additionalInfo": {
-        "content": ""
-      },
-      "href": ""
-    },
     "additionalReporting": [
       "none"
     ]
@@ -2019,7 +1957,7 @@ Examples
 
 
 

-Uncancel Request:
+Uncancel Request for a Non Award Notice
 

 
 {
@@ -2037,6 +1975,26 @@ Examples
 

 

 
+

+UnCancel Request for a Award notice
+

+
+{
+  "reason": "test uncancel for award notice",
+  "requestType": "uncancel_request",
+  "data": {
+    "description": "test",
+    "newResponseDate": null,
+    "newResponseTz": null,
+    "newArchiveType": "autocustom",
+    "newArchiveDate": "2020-03-01",
+    "newContractAwardDate": "2020-02-02"
+  }
+}
+

+

+

+
 
Back to top

 
 ### Archive Published Opportunity
@@ -2911,140 +2869,115 @@ Examples
 

 
 {
-    "data":
-    {
+    "data": {
         "type": "",
         "solicitationNumber": "",
         "title": "",
         "organizationId": "",
-        "organizationLocationId": "",
         "classificationCode": "",
         "naics": [
-        {
-            "type": "primary",
-            "code": [""]
-        }],
-        "flags": [
-        {
-            "code": "",
-            "isSelected": true
-        }],
+            {
+                "type": "primary",
+                "code": [
+                    ""
+                ]
+            }
+        ],
         "pointOfContact": [
-        {
-            "type": "primary",
-            "title": "",
-            "fullName": "",
-            "email": "",
-            "phone": "",
-            "fax": "",
-            "additionalInfo":
             {
-                "content": ""
+                "type": "primary",
+                "title": "",
+                "fullName": "",
+                "email": "",
+                "phone": "",
+                "fax": "",
+                "additionalInfo": {
+                    "content": ""
+                }
             }
-        }],
-        "placeOfPerformance":
-        {
+        ],
+        "placeOfPerformance": {
             "streetAddress": "",
             "streetAddress2": "",
-            "city":
-            {
+            "city": {
                 "code": "",
                 "name": ""
             },
-            "country":
-            {
+            "country": {
                 "code": "",
                 "name": ""
             },
-            "state":
-            {
+            "state": {
                 "code": "",
                 "name": ""
             },
             "zip": ""
         },
-        "archive":
-        {
+        "archive": {
             "type": "autocustom",
             "date": "2019-09-09"
         },
-        "permissions":
-        {
-            "IVL":
-            {
+        "permissions": {
+            "IVL": {
                 "create": false,
                 "delete": false,
                 "read": false,
                 "update": false
             }
         },
-        "solicitation":
-        {
+        "solicitation": {
             "setAside": "SBA",
-            "deadlines":
-            {
+            "deadlines": {
                 "response": "2019-08-08"
             }
         },
-        "award":
-        {
+        "award": {
             "date": "",
             "number": "",
             "deliveryOrderNumber": "",
             "amount": "",
             "lineItemNumber": "",
-            "awardee":
-            {
+            "awardee": {
                 "manual": false,
                 "name": "",
                 "duns": "",
-                "location":
-                {
+                "location": {
                     "streetAddress": "",
                     "streetAddress2": "",
-                    "city":
-                    {
+                    "city": {
                         "code": "",
                         "name": ""
                     },
-                    "state":
-                    {
+                    "state": {
                         "code": "",
                         "name": ""
                     },
                     "zip": "",
-                    "country":
-                    {
+                    "country": {
                         "code": "",
                         "name": ""
                     }
                 }
             }
-            },
-            "justificationAuthority":
-            {
-                "modificationNumber": "",
-                "authority": "dictionary"
-            },
-            "link":
-            {
-                "additionalInfo":
-                {
-                    "content": ""
-                },
-                "href": ""
-            },
-            "additionalReporting": ["none"]
         },
-        "description": [
+        "justificationAuthority": {
+            "modificationNumber": "",
+            "authority": "dictionary"
+        },
+        "additionalReporting": [
+            "none"
+        ]
+    },
+    "description": [
         {
             "body": ""
-        }],
-        "related":
-        {
-            "opportunityId": ""
         }
+    ],
+    "related": {
+        "opportunityId": ""
     }
+}
+
 

 

 

@@ -3178,7 +3111,6 @@ reason | string |  | No | Publish reason
         "solicitationNumber": "",
         "title": "",
         "organizationId": "",
-        "organizationLocationId": "",
         "classificationCode": "",
         "naics": [
             {
@@ -3188,12 +3120,6 @@ reason | string |  | No | Publish reason
                 ]
             }
         ],
-        "flags": [
-            {
-                "code": "",
-                "isSelected": true
-            }
-        ],
         "pointOfContact": [
             {
                 "type": "primary",
@@ -3275,12 +3201,6 @@ reason | string |  | No | Publish reason
             "modificationNumber": "",
             "authority": "dictionary"
         },
-        "link": {
-            "additionalInfo": {
-                "content": ""
-            },
-            "href": ""
-        },
         "additionalReporting": [
             "none"
         ]
@@ -3476,14 +3396,14 @@ description | string |  | Yes | Description for cancelation
 
 {
   "reason": "",
-  "requestType": " uncancel_request ",
+  "requestType": "uncancel_request",
   "data": {
     "description": "",
     "newContractAwardDate": "",
     "newArchiveDate": "",
     "newArchiveType": "",
     "newResponseDate": "",
-    "newResponseTz": "America/New_York",
+    "newResponseTz": "America/New_York"
   }
 }
 


From 625094a614035e7c25a69888e13d0cf70a07128c Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 12:55:03 -0400
Subject: [PATCH 118/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 28ae62d19..4a2ed82a0 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -1285,7 +1285,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization	| Header | string |	Yes |	Valid and authorized user ID
 api_key |	query |	string |	Yes |	Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice JSON](#delete-notice-json)
+Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice Contract JSON](#delete-notice-contract-json)
 
 Responses
 
@@ -3650,7 +3650,7 @@ cageCode | string | | Yes | Cage Code
 
 
Back to top

 
-### Delete Notice JSON
+### Delete Notice Contract JSON
 
 

 


From b69ddb71aededa10a9ccf0ea72f3271eb9b3930e Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:03:18 -0400
Subject: [PATCH 119/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index df4644e6f..3f2e01c89 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -1003,7 +1003,7 @@ awddate	|date|	Yes - for AWARD|	Award Date	|YYYYMMDD
 stauth	|string	|Yes - for JA 	|J&A StatutoryAuthority

 Note: Both foja & stauth values will be given under stauth in legacy| [Refer Stauth Valid Values](#stauth-valid-values)
 respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL, SSALE	|Response Date	|YYYYMMDD
 archdate  |	date| No; Either respdate or archdate required for SRCSGT, PRESOL, SSALE, SNOTE|	Archive Date|	YYYYMMDD
-awardee|	string|	Yes – for AWARD |	Awardee	|65535 characters
+awardee|	string|	Yes – for AWARD |	Awardee	|255 characters
 awardee_duns|	string	|Yes - for AWARD	|Awardee DUNS	|9 digits with optional plus 4
 contact|	string|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL|	Contact Info|	255 characters
 desc	|string|	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE|	Main Description|	65535 characters

From 5d67dea08711366c045966518f6178c2b4123b38 Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 13:12:19 -0400
Subject: [PATCH 120/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 4a2ed82a0..522ab022d 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3404,10 +3404,10 @@ Name | Data Type | Allowed Values | Required | Description
 reason | string |  | Yes | Reason for uncanceling
 requestType | string | uncancel_request | Yes | Type of request
 description | string |  | Yes | Description for uncanceling
-newContractAwardDate | date | YYYY-MM-DD | Yes for type = a (Award)| New Contract Award Date
-newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustome) | New Archive Date
-newArchiveType | string | auto15, auto30, autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1). Yes for types = k, o (Combined Synopsis/Solicitation) 2). Yes if Newarchive.type=auto15 except type = a (Award) | New Response Date
+newContractAwardDate | date | YYYY-MM-DD | Yes; for type = a (Award)| New Contract Award Date
+newArchiveDate | date | YYYY-MM-DD | Yes; (if newArchiveType=autocustom) | New Archive Date
+newArchiveType | string | auto15,
 auto30,
 autocustom | Yes  | New Archive Type
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes; for types = k, o (Combined Synopsis/Solicitation) 2) Yes; if newArchive.type=auto15 except for type = a (Award) | New Response Date
 newResponseTz | string |  | No | New Response Time Zone
 
 
Back to top

@@ -3466,10 +3466,10 @@ Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 reason | string |  | Yes | Reason for unarchiving
 requestType | string | unarchive_request | Yes | Type of request
-newContractAwardDate | date | YYYY-MM-DD | Yes for type = a (Award)| New Contract Award Date
-newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustome) | New Archive Date
-newArchiveType | string | auto15, auto30, autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1). Yes for types = k, o (Combined Synopsis/Solicitation) 2). Yes if Newarchive.type=auto15 except type = a (Award) | New Response Date
+newContractAwardDate | date | YYYY-MM-DD | Yes; for type = a (Award)| New Contract Award Date
+newArchiveDate | date | YYYY-MM-DD | Yes; (if newArchiveType=autocustom) | New Archive Date
+newArchiveType | string | auto15,
 auto30,
 autocustom | Yes  | New Archive Type
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes; for types = k, o (Combined Synopsis/Solicitation) 2) Yes; if newArchive.type=auto15 except for type = a (Award) | New Response Date
 newResponseTz | string |  | No | New Response Time Zone
 
 
Back to top

@@ -3513,13 +3513,13 @@ newResponseTz | string |  | No | New Response Time Zone
 Name | Data Type | Field Length |Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 attType | string | 32 characters |link, file | Yes | Type of attachment, either link or file
-content | byte | 250MB| | Yes if attType=file | File content in base64 format
-packageAccessLevel | string | 32 characters|public,private(default public) | No | Type of access to file. Only used with attType 'file'.
-resourceName | string | 255 characters| | Yes if attType=file | Name of file
+content | byte | 250MB| | Yes; if attType=file | File content in base64 format
+packageAccessLevel | string | 32 characters|public, 
private 
(default public) | No | Type of access to file. Only used with attType 'file'.
+resourceName | string | 255 characters| | Yes; if attType=file | Name of file
 fileType | string | 64 characters | | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
-link | string | 255 characters| | Yes if attType=link | Resource link  URL
-description | string |255 characters | | Yes if attType=link | Description of the link
-explicitAccess | string |1 character | 0, 1 (defaults to '0' public access, if not provided) | No  |Explicit Access. For Controlled Unclassified files, specify '1'
+link | string | 255 characters| | Yes; if attType=link | Resource link  URL
+description | string |255 characters | | Yes; if attType=link | Description of the link
+explicitAccess | string |1 character | 0, 1 
(defaults to '0' public access, if not provided) | No  |Explicit Access. For Controlled Unclassified files, specify '1'
 exportControlled | string |1 character | 0 | No  | *Captured for future JCP validation*
 Export Controlled
 
 #### Valid File Types 
@@ -3586,7 +3586,7 @@ Flash Video (.flv, .f4v)|	video/x-flv
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 attType | string | link, file | No | Required only for file access level changes
-packageAccessLevel | string | public,private(default public) | No | Type of access to file. Only used with attType 'file'
+packageAccessLevel | string | public,
private 
(default public) | No | Type of access to file. Only used with attType 'file'
 resourceName | string |  | No | Name of file or link
 explicitAccess | string  | 0, 1 | No | Defaults to '0' (public access) if not provided. '1' is used for Controlled Unclassified files. Required only for file access level changes
 sortOrderChanged | boolean  | true, false | No | Should be provided if file order is changed.

From 0123a2befe396af268d5b4ac7d536156e2ba56ab Mon Sep 17 00:00:00 2001
From: "anusha.paladugu" 
Date: Thu, 31 Oct 2019 13:16:36 -0400
Subject: [PATCH 121/149] update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 522ab022d..5ba53ddaa 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3654,7 +3654,7 @@ cageCode | string | | Yes | Cage Code
 
 

 

-Delete_Notice_Contract_JSONDelete_Notice_Contract_JSON
 

 
    {

From 299ce359afffe8a1356e21d7ff9ffc06dcb42c5c Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:39:15 -0400
Subject: [PATCH 122/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 221 +++++++++++------------------
 1 file changed, 83 insertions(+), 138 deletions(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 3f2e01c89..173e7213e 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -185,7 +185,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date (Deprecated) |	YYYYMMDD
 zip |	string |	No |	Zip Code (Deprecated) |	5 digits
-classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g)) 
+classcod |	string |	No |	Classification Code |	Valid classification code (FAR, Section 5.207(g)) 
 naics |	string |	No |	NAICS Code |	Valid NAICS Code 
NAICS Reference
 offadd |	string |	No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
 officeid |	string |	Yes |	Office ID of the office where an opportunity is being submitted |	20 characters
@@ -261,7 +261,7 @@ DeleteNoticeOrDocumentPackage Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr |	string |	Yes; Either Solicitation # or Award # is required only for Award|	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string |	No; Yes if there are multiple notices with same Solicitation # | Notice Type	| [Refer Notice Types](#notice-types) 
+ntype |	string |	No; Yes if there are multiple notices with same Solicitation # | [Refer Notice Types](#notice-types)	| 
 awdnbr |  string | Yes; Either Solicitation # or Award # is required ony for Award| Award # |	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 deletetype |	string |	No |	Notice or Attachment delete operation type |	Valid Values: “notice” for notice, “attachment” for attachments/links. Defaults to “notice” if not provided
 deletemethod |	string | No | Delete latest or all versions |	Valid Values: “latest” for latest version, “all” for all versions. Defaults to “all” if not provided
@@ -288,7 +288,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date (Deprecated)| YYYYMMDD
 solnbr | string |	Yes |	Solicitation # | 128 characters from the set: a-z 0-9 -_ ( ) { }
-ntype |	string | No |	Notice Type	| [Refer Notice Types](#notice-types) 
+ntype |	string | No |	[Refer Notice Types](#notice-types)	| 
 archdate | date |	No | Deprecated. Notice will archive immediately | YYYYMMDD
 officeid | string |	No |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 
@@ -314,7 +314,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date (Deprecated) |	YYYYMMDD
 offadd | string |	No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
-officeid | String | No |	OfficeID (Not in Use)|	20 characters
+officeid | String | No |	Office ID (Not in Use)|	20 characters
 subject |	string | No |	Subject |	256 characters
 solnbr |string | Yes | Solicitation # | 128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 ntype | string | No | [Refer Notice Types](#notice-types) 	| 
@@ -347,7 +347,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date (Deprecated) |	YYYYMMDD
 zip |	string | No |	Zip Code (Deprecated) | 5 digits
-classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
+classcod | string |	Yes |	Classification Code | Valid classification code (FAR, Section 5.207(g))
 naics |	string | No |	NAICS Code | Valid NAICS Code  
NAICS Reference
 officeid | string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
 offadd | string |	No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
@@ -357,8 +357,8 @@ respdate | date |	No - either respdate or archdate is required |	Response Date |
 archdate | date |	No - either respdate or archdate is required |	Archive Date | YYYYMMDD
 contact |	string | Yes |	Contact Info | 255 characters
 desc |string |Yes |	Description | 65535 characters
-link | GovURL – complex type | No |	Government Link has URL & description |	255 characters
-email |	GovEmail – complex type |	Yes | Government Email | 255 characters
+link | GovURL – complex type | No |	Government Link has URL & description |	
+email |	GovEmail – complex type |	Yes | Government Email |  
 links | DocumentLink[] | No |	Array of links |
 files |	DocumentFile[] | No |	Array of files |
 setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
@@ -418,7 +418,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date (Deprecated) |	YYYYMMDD
 zip |	string | No |	Zip Code (Deprecated) | 5 digits
-classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
+classcod | string |	Yes |	Classification Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
 officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
 offadd | string | No |Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	| 65535 characters
@@ -428,8 +428,8 @@ respdate | date |	Yes | Response Date | YYYYMMDD
 archdate | date |	No | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 255 characters
 desc | string |	Yes |	Description |	65535 characters
-link | GovURL – complex type | No |	Government Link	| 255 characters
-email |	GovEmail – complex type |	Yes | Government Email | 255 characters
+link | GovURL – complex type | No |	Government Link	| 
+email |	GovEmail – complex type |	Yes | Government Email | 
 links |	DocumentLink[] | No |	Array Of links |
 files |	DocumentFile[] | No |	Array of files |
 setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
@@ -471,7 +471,7 @@ export_controlled	| boolean	| No	| Export Controlled. * Captured for future JCP
 
 ### Modification/Amendment 
 (submitMod)
 
-This method is used to submit a Modification/Amendment to any base notice.
+This method is used to submit a Modification/Amendment to the following notice types: PRESOL, COMBINE, SRCSGT, SSALE, SNOTE, SOL.
 
 Input Parameter |	Type |	Description
 ------- | ------ | -------
@@ -489,7 +489,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No  |	Posting Date (Deprecated) |	YYYYMMDD
 zip |	string |	No |Zip Code (Deprecated) |	5 digits
-classcod |	string	 | Yes - for SOL, COMBINE, SSALE, PRESOL   |	Class-Code	| Valid classification code (FAR, Section 5.207(g))
+classcod |	string	 | Yes - for SOL, COMBINE, SSALE, PRESOL   |	Classification Code	| Valid classification code (FAR, Section 5.207(g))
 naics | 	string |	Yes - for COMBINE, SOL  | 	NAICS Code |	Valid NAICS Code  
NAICS Reference
 officeid |	string	| Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 offadd |	string	| No	| Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
@@ -497,11 +497,11 @@ subject	| string	| Yes |	Subject |	256 characters
 solnbr | string |	Yes | 	Solicitation # |	128 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 ntype |	string |	Yes |	 Notice Type |	Valid values: PRESOL, COMBINE, SRCSGT, SSALE, SNOTE, SOL
 respdate|	date|	Yes - for COMBINE, SOL 

 Either respdate or archdate required for SRCSGT, PRESOL, SNOTE, SSALE	|Response Date	|YYYYMMDD
-archdate  |	date|	No- Either respdate or archdate required for SRCSGT, PRESOL, SNOTE, SSALE|	Archive Date|	YYYYMMDD
+archdate  |	date|	No - Either respdate or archdate required for SRCSGT, PRESOL, SNOTE, SSALE|	Archive Date|	YYYYMMDD
 contact |	string |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, SOL |	Contact Info |	255 characters
 desc |	string |	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, SOL, SNOTE	| Description |	65535 characters
-link	| GovURL – complex type |	No |	Government Link |	255 characters
-email |	GovEmail – complex type |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, SOL |	Government Email |	255 characters
+link	| GovURL – complex type |	No |	Government Link |	
+email |	GovEmail – complex type |	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, SOL |	Government Email |	
 links |	DocumentLink[] |	No |	Array Of links |
 files |	DocumentFile[] |	No |	Array of files |
 setaside |	string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
@@ -561,7 +561,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | Date	| No |	Posting Date (Deprecated) |	YYYYMMDD
 zip |	String |	No	| Zip Code (Deprecated) |	5 digits
-classcod	| String |	Yes |	Class-Code |	Valid classification code
+classcod	| String |	Yes |	Classification Code |	Valid classification code
 naics	| String |	No	| NAICS Code	| Valid NAICS Code  
NAICS Reference
 offadd |	String	| No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	|65535 characters
 officeid |	String |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
@@ -635,7 +635,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date |	No |	Posting Date (Deprecated)|	YYYYMMDD
 zip	 | string |	No |	Zip Code (Deprecated) |	5 digits
-classcod |	string |	No |	Class-Code |	Valid classification code (FAR, Section 5.207(g))
+classcod |	string |	No |	Classification Code |	Valid classification code (FAR, Section 5.207(g))
 naics	| string |	No |	NAICS Code |	Valid NAICS Code
NAICS Reference
 officeid |	string |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	| 20 characters
 offadd	| string	 | No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy |	65535 characters
@@ -645,8 +645,8 @@ respdate |	date |	No - either respdate or archdate is required |	Response Date |
 archdate |	date |	No - either respdate or archdate is required |	Archive Date	| YYYYMMDD
 contact	| string	| Yes |	Contact Info	| 255 characters
 desc | string |	Yes |	Description |	65535 characters
-link |	GovURL – complex type |	No |	Government Link	| 255 characters
-email	| GovEmail – complex type |	Yes |	Government Email	| 255 characters
+link |	GovURL – complex type |	No |	Government Link	| 
+email	| GovEmail – complex type |	Yes |	Government Email	| 
 links |	DocumentLink[] |	No |	Array Of links	|
 files |	DocumentFile[] |	No |	Array of files |
 setaside	| string |	No |	[Refer Set-Aside Values](#set-aside-values) |	
@@ -710,7 +710,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date	| Date |	No	| Posting Date (Deprecated) |	YYYYMMDD
 zip |	String |	No	 | Zip Code (Deprecated)|	5 digits
-classcod |	String	| No	| Class-Code | 	Valid classification code (FAR, Section 5.207(g))
+classcod |	String	| No	| Classification Code | 	Valid classification code (FAR, Section 5.207(g))
 naics |	String |	No	| NAICS Code |	Valid NAICS Code  
NAICS Reference
 officeid	| String |	Yes |	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	 | 20 characters
 offadd |	String |	No |	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	| 65535 characters
@@ -719,8 +719,8 @@ solnbr	| String |	No |	Solicitation # |	128 characters from the set: a-z A-Z 0-9
 archdate |	Date |	Yes |	Archive Date |	YYYYMMDD
 contact |	String |	No	| Contact Info |	255 characters
 desc |	String |	Yes |	Description |	65535 characters
-link	| GovURL – complex type	| No |	Government Link |	255 characters
-email |	GovEmail – complex type |	Yes if contact is provided |	Government Email	| 255 characters
+link	| GovURL – complex type	| No |	Government Link |	
+email |	GovEmail – complex type |	Yes if contact provided |	Government Email	| 
 links |	DocumentLink[] 	| No |	Array Of links |
 files	| DocumentFile[]	 | No	| Array of files	 |
 recovery_act |	boolean |	No |	Recovery Act	| True or False (Default = False)
@@ -776,7 +776,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date |	date|	No|	Posting Date (Deprecated|	YYYYMMDD
 zip|	string|	No|	Zip Code (Deprecated) |	5 digits
-classcod|	string|	Yes	|Class-Code|	Valid classification code (FAR, Section 5.207(g))
+classcod|	string|	Yes	|Classification Code|	Valid classification code (FAR, Section 5.207(g))
 naics|	string|	No|	NAICS Code|	Valid NAICS Code  
NAICS Reference
 officeid	|string	|Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account |	20 characters
 offadd|	string|	No	|Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	|65535 characters
@@ -785,8 +785,8 @@ solnbr|	string	|Yes	|Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_
 archdate|	date|	Yes|	Archive Date|	YYYYMMDD
 contact|	string|	Yes|	Contact Info|	255 characters
 desc|	string	|Yes|	Description	|65535 characters
-link	|GovURL – complex type|	No|	Government Link	|255 characters
-email	|GovEmail – complex type	|Yes|	Government Email|	255 characters
+link	|GovURL – complex type|	No|	Government Link	|
+email	|GovEmail – complex type	|Yes|	Government Email|	
 links|	DocumentLink[]|	No	|Array Of links	|
 files	|DocumentFile[]|	No	|Array of files	|
 recovery_act|	boolean	|No	|Recovery Act	|True or False (Default = False)
@@ -842,7 +842,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date | date |	No | Posting Date (Deprecated)|	YYYYMMDD
 zip |	string | No |	Zip Code (Deprecated) | 5 digits
-classcod | string |	Yes |	Class-Code | Valid classification code (FAR, Section 5.207(g))
+classcod | string |	Yes |	Classification Code | Valid classification code (FAR, Section 5.207(g))
 naics | string | Yes | NAICS Code	| Valid NAICS Code 
NAICS Reference
 officeid | string | Yes | Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account | 20 characters
 offadd | string | No | Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	| 65535 characters
@@ -852,8 +852,8 @@ respdate | date |	Yes  | Response Date | YYYYMMDD
 archdate | date |	No  | Archive Date | YYYYMMDD
 contact | string |Yes | Contact Info | 255 characters
 desc | string |	Yes |	Description |	65535 characters
-link | GovURL – complex type | No |	Government Link	| 255 characters
-email |	GovEmail – complex type |	Yes | Government Email | 255 characters
+link | GovURL – complex type | No |	Government Link	| 
+email |	GovEmail – complex type |	Yes | Government Email | 
 links |	DocumentLink[] | No |	Array Of links |
 files |	DocumentFile[] | No |	Array of files |
 setaside | string |	No | [Refer Set-Aside Values](#set-aside-values) | 
@@ -913,7 +913,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date	|Date	|No	|Posting Date (Deprecated)	|YYYYMMDD
 zip	|String|	No|	Zip Code (Deprecated)|	5 digits
-classcod|	String|	Yes|	Class-Code|	Valid classification code (FAR, Section 5.207(g))
+classcod|	String|	Yes|	Classification Code|	Valid classification code (FAR, Section 5.207(g))
 naics|	String|	No|	NAICS Code|	Valid NAICS Code 
NAICS Reference
 officeid|	String|	Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account|	20 characters
 offadd|	String	|No|	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy|	65535 characters
@@ -988,7 +988,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 date|	date|	No	|Posting Date (Deprecated)|	YYYYMMDD
 notice_type	|string	|Yes|	 [Refer Notice Types](#notice-types)	|
 zip	|string	|No	|Zip Code (Deprecated)|	5 digits
-classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA, PRESOL  |	Class-Code	|Valid classification code (FAR, Section 5.207(g))
+classcod|	string|	Yes - for SOL, COMBINE, SSALE, ITB, JA, PRESOL  |	Classification Code	|Valid classification code (FAR, Section 5.207(g))
 naics	|string	|Yes - for COMBINE, SOL	|NAICS Code|	Valid NAICS Code  
NAICS Reference
 officeid|	String|	Yes|	Office ID of the office where an opportunity is being submitted. Office ID must be associated with user account	|20 characters
 offadd	|string|	No|	Office Address (Deprecated). The Contracting office address details are retrieved from the Federal Hierarchy	|65535 characters
@@ -1008,7 +1008,7 @@ awardee_duns|	string	|Yes - for AWARD	|Awardee DUNS	|9 digits with optional plus
 contact|	string|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL|	Contact Info|	255 characters
 desc	|string|	Yes - for PRESOL, COMBINE, SRCSGT, SSALE, ITB, SOL, SNOTE|	Main Description|	65535 characters
 link|	GovernmentURL|	No|	Government Link	|255 characters
-email|	GovernmentEmail|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL, SNOTE (SNOTE only required if contact is provided)|	Government Email	|255 characters
+email|	GovernmentEmail|	Yes – for PRESOL, COMBINE, SRCSGT, SSALE, JA, ITB, SOL, SNOTE (Required only for SNOTE if contact is provided)|	Government Email	|255 characters
 links	|DocumentLink []|	No	|Array Of links	|
 files	|DocumentFile[]|	No|	Array of files	|
 setaside|	string|	No|	[Refer Set-Aside Values](#set-aside-values) |	
@@ -1069,7 +1069,7 @@ Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 date|	date|	No	|Posting Date	(Deprecated) |YYYYMMDD
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 - _ ( ) { }
-ntype	|string	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
+ntype	|string	|No|	[Refer Notice Types](#notice-types)	|  
 uploadtype|	string|	No |	Upload Type (Deprecated)| 255 characters
 respdate	|date	|No |Response Date|	YYYYMMDD
 links|	DocumentLin k[]|	Yes; Either Links or Files needs to be provided|	Array Of links	|
@@ -1112,50 +1112,11 @@ UnarchiveNotice Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr	|string	|Yes|	Solicitation #|	128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
+ntype	|string	|No	| [Refer Notice Types](#notice-types)	| 
 awdnbr	|string|	No|	Award #|	255 characters from the set: a-z A-Z 0-9 - _ ( ) {}
 archdate	|date|	Yes|	New Archive Date|	YYYYMMDD
 officeid|	String|	No|	Office ID (Not in Use)
 
-### Secure Document Package 
 (attachSecureDocumentPackagesToNotice)
-
-Service is now deprecated. 
-
-### Non-FBO Solicitation 
 (createNonFBOSolicitation)
-
-Service is now deprecated. 
-
-### Secure Document Packages 
 (attachSecureDocumentPackagesToNonFBOSolicitation)
-
-Service is now deprecated. 
-
-### Remove Secure Document Package 
 (removeSecureDocumentPackagesFromNonFBOSolicitation)
-
-Service is now deprecated. 
-
-### Non-FBO Solicitation Release 
 (releaseNonFBOSolicitation)
-
-Service is now deprecated. 
-
-### Un-Release-Non-FBO-Solicitation 
 (unreleaseNonFBOSolicitation)
-
-Service is now deprecated. 
-
-### Secure Technical Document Package 
 (createSecureDocumentPackage)
-
-Service is now deprecated. 
-
-### Add Files to Secure Document Package 
 (addFilesToSecureDocumentPackage)
-
-Service is now deprecated. 
-
-### Delete Files from Secure Document Package 
 (deleteFilesFromSecureDocumentPackage)
-
-Service is now deprecated. 
-
-### Delete Secure Document Package 
 (deleteSecureDocumentPackage)
-
-Service is now deprecated. 
 
 ## Methods Available 
 to All Office Location Users
 
@@ -1178,7 +1139,7 @@ IVLListRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
+ntype	|string	|No	| [Refer Notice Types](#notice-types)	|
 
 IVLListResponse Complex Type Definition:
 
@@ -1223,7 +1184,7 @@ AuthorizedPartyListRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes	|Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype|	string|	No|	Notice Type	| [Refer Notice Types](#notice-types) 
+ntype|	string|	No|	[Refer Notice Types](#notice-types)	| 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #. Not supported for this method |
 status| string	|No	|Valid Options: approved, pending, rejected, “empty value”. If empty, all status will be returned 
 
 Note, use “pending” to pull the pending explicit access requests. |
 
@@ -1267,11 +1228,11 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No|	Notice Type	| [Refer Notice Types](#notice-types) 
+ntype	|string	|No|	[Refer Notice Types](#notice-types)	| 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
-Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.|  32 characters
+id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.|  32 characters
 vendor	|VendorData|	No|	Complex type not used in this method|
-reason	|string|	No|	Not in Use| 65535 characters
+reason	|string|	No|	Rejection reason not used in this method| 65535 characters
 
 Response:
 
@@ -1294,11 +1255,11 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name	|Type	|Required|	Description | Character Limit / Restrictions
 -----|-----|-----|---- | -------
 solnbr	|string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype|	string|	No|	Notice Type	| [Refer Notice Types](#notice-types) 
+ntype|	string|	No|	[Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No|	Non-fbo Solicitation #.  Not supported for this method|
-Id	|string	|No	|Not in Use | 32 characters
+Id	|string	|No	|Not used in this method| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
-reason	|string|	No|	Not in Use| 65535 characters
+reason	|string|	No|	Rejection reason not used in this method| 65535 characters
 
 Response:
 
@@ -1333,9 +1294,9 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string	|Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
+ntype	|string	|No| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string|	No|	Non-fbo Solicitation #.  Not supported for this method|
-Id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.| 32 characters
+id|	string|	Yes|	Matches internal record ID. This is retrieved from getAuthorizedPartyList method above.| 32 characters
 vendor	|VendorData|	No|	Complex type not used in this method|
 reason|	string|	Yes	|Rejection Reason | 65535 characters
 
@@ -1361,9 +1322,9 @@ ExplicitAccessRequestComplex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No| Notice Type	| [Refer Notice Types](#notice-types) 
+ntype	|string	|No| [Refer Notice Types](#notice-types) 
 nonfbo_solbr	|string	|No	|Non-fbo Solicitation #.  Not supported for this method|
-Id	|string	|No	|Not in Use| 32 characters
+Id	|string	|No	|Not used in this method| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
 reason|	string|	Yes	|Rejection Reason | 65535 characters
 
@@ -1398,11 +1359,11 @@ ExplicitAccessRequest Complex Type Definition:
 Element Name | Type | Required | Description | Character Limit / Restrictions
 ------ | ------- | ------- | ------- | -------
 solnbr|	string|	Yes|	Solicitation # | 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
-ntype	|string	|No	| Notice Type	| [Refer Notice Types](#notice-types) 
+ntype	|string	|No	| [Refer Notice Types](#notice-types) 
 nonfbo_solbr|	string|	No	|Non-fbo Solicitation #.   Not supported for this method.|
-Id	|string	|No	|Not in Use| 32 characters
+Id	|string	|No	|Not used in this method| 32 characters
 vendor	|VendorData|	Yes|	Complex type defined below|
-reason	|string|	No|	Not in Use| 65535 characters
+reason	|string|	No|	Rejection reason not used in this method| 65535 characters
 
 Response:
 
@@ -1437,7 +1398,7 @@ NoticeListRequest Complex Type Definition:
 
 Element Name|	Type|	Required|	Description | Character Limit / Restrictions
 -----|-----|-----|-----|-----
-notice_type	|string|	No (at least 1 field is required)|Notice Type| [Refer Notice Types](#notice-types)
+notice_type	|string|	No (at least 1 field is required)|[Refer Notice Types](#notice-types)
 solnbr	|string	|No (at least 1 field is required)	|Solicitation #| 128 characters from the set: a-z A-Z 0-9 -_ ( ) { }
 awdnbr	|string	|No	(at least 1 field is required)|Award # | 255 characters from the set: a-z A-Z 0-9 - _ ( ) { }
 posted_from	|date|	No (at least 1 field is required)|	Posted From Date |YYYYMMDD
@@ -1546,7 +1507,7 @@ recovery_act	|boolean	|Recovery Act
 correction|	boolean	|Correction of previous notice for the following types: Award #, Delivery Order #) – Awards, J&A’s, Intent to Bundle Requirements (DoD-Funded), Fair Opportunity / Limited Source Justification.
 changes	|NoticeData[]	|This element will only be present on the base/original posting and will contain an array of changes (for any mods/awards/etc.). Each change uses the same complex type.
 
-DocumentPackageData Complex Type Definition: Not in Use
+DocumentPackageData Complex Type Definition: **Not in Use**
 
 Element Name | Type |  Description
 ------ | ------- | -------
@@ -4091,8 +4052,8 @@ notice_type	|	1. This field is required where applicable |	1. Opportunity type i
 zip|	NA |NA
 classcod	|1. This field is required where applicable

     2.If a wrong classification code is given, then the service throws an error | 1. Product Service Code is a required field 

 2. This opportunity cannot be published. Classification Code provided did not match expected codes.
 naics		|NA |  NAICS code is required
-offadd| Not in Use|	NA
-officeid	|1. This field is required

 2. If an invalid officeid is given, then service throws an error

 3. If user does not have access to an office but is trying to make a submission to that office, then the service throws an error

	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
+offadd| Deprecated|	NA
+officeid	|1. This field is required where applicable

 2. If an invalid officeid is given, then service throws an error

 3. If user does not have access to an office but is trying to make a submission to that office, then the service throws an error

	|1. Contracting Office is required

 2. Invalid officeid provided

 3. UnAuthorized Credentials. This may be the JWT issue or Role management issue. Please check
 subject	|	1. This field is required where appicable 	|1. title: is missing but it is required
 solnbr|	1. This field is required where applicable

  2. If submitting a notice with a duplicate solnbr, then system throws an error 

3. If solnbr is in invalid format, then service throws an error

4. If solnbr & ntype combination is not matched, then service throws an error 

 |	1. Notice Id is required 

2. Notice Id for the selected opportunity type already exists 

3. Notice Id can only contain 128 characters from the following set: a-z A-Z 0-9 - _ ( ) { } with no spaces 

4.	Opportunity not found with given solicitation number and ntype 

5. Notice ID must be unique based on selected notice type
 ntype	 |1. When user tries to convert a notice and the solicitation number/ntype do not match the notice, then the service throws an error

  2. This field accepts only valid values listed. If invalid values are provided, then system throws an error. Also, if all the required field is given and this field is not given then service throws an error    |1. Opportunity not found with given solicitation number and ntype

 2. Invalid NTYPE value provided
@@ -4155,7 +4116,7 @@ deletemethod|	1. If an invalid deletemethod is provided, then service throws an
 #### archiveNotice
 
 Individual business rules per field are listed across each of the fields in below table.  
-* Note: : If a user tries to archive a notice that is already archived, then the service throws an error -  Opportunity already archived
+* Note:  If a user tries to archive a notice that is already archived, then the service throws an error -  Opportunity already archived
 
 Element Name	| 	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
@@ -4168,7 +4129,7 @@ archdate|	1.	No validation is performed on this field. However, if this value is
 #### unarchiveNotice
 
 Individual business rules per field are listed across each of the fields in below table.  
-* Note: : If a user tries to unarchive a notice that is already unarchived, then the service throws an error - Opportunity is not archived
+* Note: If a user tries to unarchive a notice that is already unarchived, then the service throws an error - Opportunity is not archived
 * Note: If a user tries to unarchive an active notice, then the service throws an error - Opportunity is active
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
@@ -4204,7 +4165,7 @@ Individual business rules per field are listed across each of the fields in belo
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
 notice_id	|	notice_id is required|	notice_id from getList is required
-Get_changes|		NA|	NA
+get_changes|		NA|	NA
 get_changes_from_date|		Date field should meet the expected format|	DATE field in unexpected format. Expects YYYYMMDD
 get_file_data	|NA	|NA
 
@@ -4253,7 +4214,7 @@ status|	1.	If the status value entered doesn’t match the valid values , then t
 
 Individual business rules per field are listed across each of the fields in below table.
 
-ID can be obtained through getAuthorizedPartyList   
+* Note: ID can be obtained through getAuthorizedPartyList   
 
 Element Name	|	Business Rules |	Error Messages with respect to business rules (If any)
 ------ | ------- | ------- | ------- | --------
@@ -4310,52 +4271,36 @@ nonfbo_solbr |	1.	If both solnbr and nonfbo_solbr are provided, then the service
 vendor|		1.	If all the elements in the Vendor Data complex definition are not provided, then the system throws an error

 2.	If no match is found in the system for the vendor data provided, then the system throws an error

3. If the Explicit Access request found for the vendor and solnum is already rejected, then the system throws an error|	1.	This method requires all fields from complex type VendorData to find a match in the system; if vendor data not fully provided this error will be thrown

 2.	No contact match on vendor data provided 

 3.	Request with Request ID: #id already rejected
 reason|  1.	This is a required field. If no value is provided, then the system throws an error| 1.	A reason must be provided with an explicit access rejection
 
-#### submitFairOpps
-
-This service is now deprecated. Instead, please use submitJA to perform the operation.
-
-#### submitForeignGovernment
-
-This service is now deprecated.
-
-#### setBidModuleOptions
-Service is now deprecated. 
-
-#### getBidModuleResponses
-Service is now deprecated. 
-
-#### createSecureDocumentPackage
-Service is now deprecated. 
-
-#### addFilesToSecureDocumentPackage
-Service is now deprecated. 
-
-#### deleteFilesFromSecureDocumentPackage
-Service is now deprecated. 
-
-#### deleteSecureDocumentPackage
-Service is now deprecated. 
-
-#### releaseSecureDocumentPackage
-Service is now deprecated. 
-
-#### attachSecureDocumentPackagesToNotice
-Service is now deprecated. 
-
-#### createNonFBOSolicitation
-Service is now deprecated. 
 
-#### attachSecureDocumentPackagesToNonFBOSolicitation
-Service is now deprecated. 
 
-#### removeSecureDocumentPackagesFromNonFBOSolicitation
-Service is now deprecated. 
+### Deprecated Methods
+* submitFairOpps *(Instead use submitJA to perform the operation)*
+* submitForeignGovernment
+* setBidModuleOptions
+* getBidModuleResponses
+* createSecureDocumentPackage
+* addFilesToSecureDocumentPackage
+* deleteFilesFromSecureDocumentPackage
+* deleteSecureDocumentPackage
+* releaseSecureDocumentPackage
+* attachSecureDocumentPackagesToNotice
+* createNonFBOSolicitation
+* attachSecureDocumentPackagesToNonFBOSolicitation
+* removeSecureDocumentPackagesFromNonFBOSolicitation
+* releaseNonFBOSolicitation
+* unreleaseNonFBOSolicitation
+* attachSecureDocumentPackagesToNotice
+* createNonFBOSolicitation
+* attachSecureDocumentPackagesToNonFBOSolicitation
+* removeSecureDocumentPackagesFromNonFBOSolicitation
+* releaseNonFBOSolicitation
+* unreleaseNonFBOSolicitation
+* createSecureDocumentPackage
+* addFilesToSecureDocumentPackage
+* deleteFilesFromSecureDocumentPackage
+* deleteSecureDocumentPackage
 
-#### releaseNonFBOSolicitation
-Service is now deprecated. 
 
-#### unreleaseNonFBOSolicitation
-Service is now deprecated. 
 
 
 
@@ -4381,7 +4326,7 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8| Added Notice Type and Related Notice sections for reference. Updated the character limits. Removed redundant Required and Character Limit columns from Business Rules section. Consolidated Business Rules section for all Submit methods. Updated submitMod and submitNotice methods to align with implemenation. 
+10/28/2019 | v0.8| See attached document 
 
 
 
Back to top


From ac3e95f84ee34951230ee5d755e2289b19d7a2a7 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:42:13 -0400
Subject: [PATCH 123/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 5ba53ddaa..91284d857 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3231,7 +3231,7 @@ reason | string |  | No | Publish reason
 * Field headers in the table must match with field headers shown in JSON example  
 
 Name | Data Type |Field Length | Allowed Values| Required | Description
------|-----------|-------|-------------------|------------|------------ |----------
+-----|-----------|-------|-------------------|------------|------------ 
 type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Yes | Notice Type
 solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {}| Yes (No for type = s  (Special Notice)) | Solicitation Number
 title | string | 256 characters | | Yes | Title of the Opportunity

From b0082f59a921d4423c688a5fba5a1f30070d5b57 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:43:13 -0400
Subject: [PATCH 124/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 91284d857..a5bff2fe5 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3232,13 +3232,13 @@ reason | string |  | No | Publish reason
 
 Name | Data Type |Field Length | Allowed Values| Required | Description
 -----|-----------|-------|-------------------|------------|------------ 
-type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Yes | Notice Type
+type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Notice Type
 solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {}| Yes (No for type = s  (Special Notice)) | Solicitation Number
 title | string | 256 characters | | Yes | Title of the Opportunity
 organizationId | string | 32 characters | | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
 classificationCode | string |  | | Yes (No for type = r, g, a  (SourcesSought, Sale of Surplus, Awards)) | Product Service Code (PSC)
 naics | JSON Array | NA |NA | NA |
-naics.code | Array of String | | NAICS Reference| No | Yes for type = k, o (Combined Synopsis, Solicitation) | Valid NAICS Code
+naics.code | Array of String | | NAICS Reference| Yes for type = k, o (Combined Synopsis, Solicitation) | Valid NAICS Code
 naics.type | string | |primary|Yes | NAICS Type Note: 'p' must be in lower case
 pointOfContact | JSON Array | NA |NA | NA |
 pointOfContact.type | string | | primary
 secondary | Yes (No for type = a, s (Award, Special Notice)) | Contact Type Note: 'p' and 's' must be in lower case
@@ -3304,7 +3304,7 @@ justificationAuthority.
authority | string|  |  | Yes | Justification Author
 additionalReporting | string | |none, 
auto_recovery | Yes; No for type = s (Special Notice) | Initiative that applies to the notice
 description | JSON | NA | NA | NA |
 description.body | string | 65535 characters| | Yes; No for type = a (Award) | Description of the notice
-related | JSON | NA | NA | NA | NA | Related Notice information
+related | JSON | NA | NA | NA | Related Notice information
 related.opportunityId | string | 32 characters| | No | Opportunity Id of the related notice
 resources | JSON |NA | NA | NA |
 resources.attType | string | |link, file | No| Type of attachment, either link or file

From 8c0e52a34efcda3f83751884888d6460659a6d38 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:52:22 -0400
Subject: [PATCH 125/149] Create Opportunity Management SOAP Web Services
 Change Log v0.8.docx

---
 ...ement SOAP Web Services Change Log v0.8.docx | Bin 0 -> 15758 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 _apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.docx

diff --git a/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.docx b/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.docx
new file mode 100644
index 0000000000000000000000000000000000000000..dcd45359ae9b0011fa07653b0d70926a22772095
GIT binary patch
literal 15758
zcmeHugL|ag(r+}G*tRCNor!JRwr$(CGqG*kwllFkNpAKzXWy-J??3Q;Z$I7r^s4o%
zx4OHuR@IUb2L?d`00jU8006)TppUgyHUb0yDEtBdfCvBvq|R?`NM5udrpXIn7^9TH
zJzswNd*>c2T_F)28qE=
z^?aHo)b~sOH~*Oq+0`Djd?_0J={2;KuVCt;5{PTdW=rpHoXg8Vn#a1rW3zMd({A<|
zLXO)BnpYS}iqK&l;ET^%ed@36E&z#v?S*tMi#EGZ>4y(SZ=-~wWTXD!s>oqe7@)CF
zAt@8xhzH~X4+q7NrUYbD^ZG<}`B}D#OOGjD3^}QE3yWqV>h51lxdc0duv;h5y&#Nu
zYLXeKVxoIDYc=~7PU4&CBhAR}DKRW)X})E|>Xk!aT(!@fxaD^h4}=C%g6D#V(!6>Y
zX&|V*AB7#F^DtlHtJZ7pSYu{r^4@+1sejr>U1vD?hIUTyRAUx$hqxc0;(nY5>!;{Xsrf_JMggcC56P)>_<5-
zAfemx{-g6Li$Yv)%;if@U5sA4Pn3y@?L`?(!(Ax$bU^YTI~AG8(haXtcCBEi$lN#Q
zIjG?(`jtwQZKr#}YCWtgo|Q(^7YJ?3h9#4qLSG(5keF}rNd|DL#Zu1@LARE;l@(nkc_T@Y!bSRn1`;g;&W?)AXH1ihgQ=3UBbYx
z0}o!a<1*2(j=zNg6!^tq
zV7O%_VdiaSc!B=wZPk_puw>|-oRMZiX*T&c0m{hZc?`{jESxS6PAdGRzN9EtzIY`b)hB@u$rbwfs?V7vbaJfP|)e0u+wZbcztyrwHIQ%TM
z&68BG{g|9}=ci*yM~uBw+t33^C2eub3-4H@qB>LyW(j8SG*SxyYDtUrn9gD
z@qEP$K|N;EY!3XAC-@?iGr-S}0qg?87!1Tk2L!<>77!o7Fbs&#&+p%YQhg;EA#_1C
zrMl;Mb$C5WDs^VcuQbJ>S!B!*t>tjb~|xii|zny?P_~=
z3%IzLxwrf%YGU1bHh#T;n6zGLcqi3;f^;fv@Vt`6QNQ>yey|LeM+tY+ecNZyM;t_V
zRlWDj7heMgJL1>!H4mMF?pXDOm=YoAfdkaIkB8*g)eng5fD=F7Fgq)YQM&dyuLI;Z
z{`}S9J(PQS{GOHY{W6*GE^}45cg;8`6&9BnOV1PiKy@22G$GVC4MBe(#^WL8slZRz
z*Nv!X#Py1^CzJD*Q4QrTiB+hmRIDW$sdz-HX{92Q$?S`BD-~7tWXeI$K4>jMC1T4g
z_n`wB#DsjtiEVxls?#sB6uzj0^2;%`!WpipV-8jYB2WKtnlTb=YoowKq@+1bs^Dv)ZU^aTs`WR3wSmRK=}(P(M(acd3Dz(f=Y`RN&N!W%
zLC^DI&_H#X?L4a$IcsD748v@;s0=sE(w9iY^CRKY2&z`qU{r~PF>4&uzXDolv^T-M
zK7L4--$mwb8s64kB>NgL`r3HYMY;*piyBbh^Z;#$zOL()ZkS;oocYk_)1}9f*+$8D
zJdy?Khr8+T;vM3RHd%kWnfxj06>>g<;#5zUiQv7(5Y1Y;agtm&Db;`NH2FQmpXRbO
z%@ruB3E@LYLrmE!>sD}?k#FXT@^VPF`Z=<9Hy!|kJ+DaA0Rk&RxjF;hh2OtQWG2^c
z2{FS0&*HuvNMgxpIYG=RIN=-RfFo9ixeYefXyj>=W|>dS*4NnTCjmY0g6mCuT(6J~
z9G*ktAfuDjLcX)CWHe15?9y4Fd}x9lGdu}hV#vU+gy0bcedET>O86`yvB3qL`8Gzg
zVv&Ba*F-tv{qxH+33Pgt&o57oEsLkcAn)G+K9YXucny6Mbw|gjq?*z-K|lg_fsz$3
z<~)F4ZsN5IQH{aY?E`Qw4}WPU(s>!fprhe7Xve;6KPcAmINjnBehc2*em?|rys)OJ
zx^xpZxtd1T;Oc$M@$CD!dHMF#+Vy;gXfD;TN#JZEBof)V#LEY7g#o~7wJ
z=c9egP^tYpyO@reK=D
z3WtKGviK{5ajK=xxcW8$JB7&TjCboGn7fV8+Bc?iP@ydA0EiaJn>SY;P@zq`o$pcveiFiwc~V3^Gyet!SW=bc08nqO8u9XuCu~_wZAgHTOPisff*hTm29k@VJJ+IWu%yKY
zVTRZGv}5`{H!UpzwI+d7J)#!z_(3ll&g;Z
z`@I9e$ghl@Z?(Q=9nQq2NTwa%TTF;bzNlu6UW`bXBhMeV&q2f!ob~a)`?*j8Cn`Dm
z;BxSFHS|r)0#`0>LwrBrf)gjn8Q{i=6%XDDL?yh2gxF!!v1wJHPoVv(`SoB>bgw{WKqr(e&!tm9%kW%fJ(d~^McLWVCM>)R
z@W)lmrFZ_FYtJkE$y?dnDNi29Au4-CnQI7|Lex2Hb_kSw4TD#|b=Ev)$8LIczFZOd
zoODuR&waNlS=YFz6lal&DW{=_Lq3Jrb_I;Q1eAeA^BeDv=gUQpu#7(J*I@P&
zL~FgV!*x4ADWzYDxXwIc^m*@a0VRC9wCYw#ho&w?y^4h|31Qi@=uhSb@8-0#kQ;LK
zd1!{Ut6kHZt)pz626&4wC!Y3Wnm`>`2W;R^NwhYUhO{1x`f)6_ck6l%q
zRb-N=UxDKwi4)9wBuOBV8Y2QM2bx&40b#YFkNBh@BegW5pINjoe)w#zDFj6HgXoAn
zV~R5~rc%mG(7vfsMTiituU!Fx-3#5Gsl1euiryR8*y2<2J8BZ$7Yz*ibfD~rEAOXU
z%0&8wA6&}p`4Lw>{$l@@G>P@D(ell11(Gn134y0hF|xgh?45dl>0s*Mly;7JnB|%n
z6C}SF1-WXNeVZMz5)s$5&Cgu(E44oH=D8kl>Jo6kErd7V5oN8$-mbGH8pr$uH~L_R
zi@@m6Lubon;kMS
zfcWg4DhUsUEeFA-h)msbTTSV`+u4E2&i0eI&r5AeGIK8=A*lj2DaNFHI_VnJcK@a)?c4W?0WKcOOGsa2Sq^39*mn!4{vVrJvU7jF0#S
z1Bm>(@~`)#p$rYateDGb;7^#(VnWz22jr*1jZ
ztjLY|67yz*e{_eOc~M1{>CDDz18tB_wjDS~Mhrhx%K;o86kY#*9Ik$~Xa;WV363ZO
z)qQ`orayR_pCV6Z>3eHwYb&Gu&hA?ZyKo9*Z(Ni*m$EH(M#ORok?v53CoN@zhOkIN
z1iT^mMKdJjdN@b6w-aDyGJI4G@J%RdG`khi!I?)3r4VgIKO1u&__!ombZh`M?3jL3
z6tA_!Sc6!hY!tkx1_>`+Ne5kO47?Lef|#>$p~v?fZGu1yG}+E71$}-#{h_(i7X(On
znF}oZRa@OmIu7pc$HG$?A|eTg^{{vQF%HyGb9{101A9CEx26Pjh=^h)s-eEVhMc2k
zt^BsdDnJFRJgFjCPX^`Bu|C11-nD)AA8
zXw-Ksw=kK_#a)8PkMbxIr43}u2Y%x0@dKC~5r`rPQyaPX3Hd<6eGATDZ6k`nyD}ox
z1qz~Q7_F8I{y5n?PI@3^kCv5U$HoY)z#kZbCzLX(-P8I~VFhz@G7z2|oz>-W_c}Hd
ztnliB6{dOZk0rJX}cFm4PQ${7P4lnK-QjFS$m7H8o@Ja{2*Tbc&r$H
z!ZiBaF(S||N(+#ltsu*X3sx>6%ahlqVS(P2@AE|n@_iA>(;9ipqi6$+(d&ZrwXy5k
zSFyS__&sy@MdRoZHE_(Sm>#;*9iXOz7Y|&mA(BMN24?&h1cNuj-07h3Va7_6M4>m!
z6nYT&VHxQXYNE8a0VUi|fZqZyI{B-2E}F8>*J6Us0P~Cv*PV!H8K(C9q~IFKE^n4a
zYBZ(FXJ*oag-kB>BxdL^^v~8i_4?{kb#Ei?7Qkvp4K3;>6b%MTPe@e0R}_R{hUJeU3${-MG6+FMpL!|<0IMy&}9h;aH$n`GdHpDmM>*;$3s#yySgHbG?
zKDcPw^m$*}4Sqk|{5rh-nB?34KH13jeO?6*G6fh!F^FozFJ$LkLI9hDin(c2a-2WC
zCAVGnuAj)&{7b#;>l1F(gD=G10<1LE^4t&Sv+j5WcEJ&Yx=ylQOC=`2J^hEVan;cw8QeE=dC41!K3H$IJPo_NpkeIVc`;k+Fd~&AT_R^GitlN#oUN|$DJB7
z?Gz3xgxhD)!L%hDY9?u
zh8~(-Q4!ruN(Bn8_2w1Mqt;Gqi&u3Y?Bm^wtUt;L!CAr0>K_y?1QGIa2=sdYHWOE
zB4j*mMtm9pnQ#Gp2^duf2@)N`9x2S_A*vg1j`1YQLnn+FxmG*riw@W90>`j9M5DxfVL+lQw&8D&*m8Pj1!^%BKjTYoGdZRLFS$AC+1YjQ
z!K;p8(yH-JQACGC@g{}lFZ`Kj%salRiM}W25L&;zgiOrD7liKUP)hkx+JCdR}DNx>_
zmjk1AEvy&mEek_x{!jtGMrq3&PD7>YYoJFN0+PS-U9ywLFm0&$D1+|qP_%QQ3IWbf
zy8P*G4fZ%J_)K(-@>u_!(8aef08($BUF4*0=ZZs6y0NO;2{%vn%WkK!RC1Q^ha~S6
zpKpP6Xo0_#D0R%wlLA+sfywQc6*rTByH@MKE83!44#&nSQPT_3AYd1S==oe;9Y1A2=f;z!{>0SK&Ee5xa(AfnY
zCzLwc8_?K7p3o$JHWjIM6E3u4@_?0f6OyAM;49=CfEPV#k)<>mn5ei
zmYVvJR1`HemmqI$_Bw*1}&QW6{RHIOLK+T7;psoKMlo
zqnrc0w8v)fd!nm<*@_}@>R`&z-+?V1ekqD}w=!$IWYCH6ch5L{`8DB%90S1b)lQ5vD3X{8y
z5nRyHT%pNpYF?R5it@;1I44QaiP0|x#Y-9=HhAenTr!C>#|k5O57Ce-60Dm>AWlC|e8B!p&d~ijrK^No#=(d|vnsWmmtQ<<
z##%|jw8z_xE$Y^5Q})}Z
zUi>put$GgAxPFGIUp4>$p9{Kw*M;mITrCX$6{y-X*X-6<5rQt8%(i?B%Qhf|B)WjWpUSAH*<;m@!qtRB~|xJ@P=~Q
zhlnGxuWp8ZO1XH?7KPe%yw=%l0I|b1cQ)nV#qfnTO7%sh{DBX-N`?B6FYK3LJ5MTB
zG`YlTa2^UI{Eaj@rC!!PvsZ@Qk5KZFB)!Ci`eN>Sl0>00g+R`+JE@`C{Q(Ig^YJ@4
zA3gXYa{2IInVYGl!YGA(#fY!klq^1kSUTR&A$@b{!2*RA)b~G6vp_JIUrK^`SU8jzo!t+#rory|Ta;*Ig7lj2met
zzN!=UQChcq;uFweqzlz`-3@9>WJNwao;p)Yk~D6{Q@WOH?Tu_ktJX0X=LQ+QEsGXrgz&mSRZT+;#6sM)k0UPkXmq9#M)IQ(_Cc-F6BmwMNasVQdNG8R5XqL&Z<_#cuWse;N=_}Zy=OX`S5jL&93
z1_pyq#2k9BEOfH~{%civ?d7S}KEw
z`wOTV;(MN~qoO3pc>Y!%QQWM+dkA-Xj}?l
zaB2uLHuzHt$uQN$tJQA3pkz=KhIabul$}6ceuh%~QWF6}#hDP$@;vxR_0(*IJ*AnD
z!HVBL2x4+uJrX24g;`g!7rjkwXo?w18Nyx+NpKQL&;SJCT9w)t^93{1?T}l%+sAjTm99I-M&%J@(um~LuV>@uv9yy+_
zjKTNgY2@gm;CQ=*+Akh8uY-$(oy$Ns*>4+9K2AYEV0KI*7A#J`Crj~!d@$6RN;}RdeF45Jmn)exUaaiiX4xP
z;jUu%{8_kdzG23pd1owuYW?b)pQ1c2j>J2{*%^w})1=i-iPM8zEhXZlc*!Pb=|+X?
z{3}QMQ<;lcse`OYD`2^=0ig=;NRZ43ffW5HS0iUHb|dG>+cydHF+$dF#;zY?f&#=r
zfwE+}x(f6vXo;XGLgd|791a-OJ59%oI(?T5WV!<4KA;igQzEb*0?Mu!w56PNe|mB}
zAzcmd(fA$1&_NR^PBO(fd`%-dx)v*>^u*`W5`FImlZr{IZ&RQe2L>l6v)(2Co@PHE
zXH%oOTO#m2a%7;%Kso9Kp8;738_}L~1zi>OOkKAP(*pB$@5ME#v05D`l%SFW
z0=I~j`zNjigB!(@jq{b!w;E*Ec?N_=*LDuOI3^5!^CY)sEGxj5-Fak=DpX{A?#?|*mS>|
z`1IK|Wh;T?p3YnCUaS?m_##Vd&qt7y$8&<#rSWIu+|kO$+^JX#Pf)-}@7iA*Esn7Q+NHjN$Tb~#!5^~y8}cbCX}+Hg%^%V`92h%>&N`;QA$c#(xej@Kh$|}=
zce3CfSmnXI+jHp`sQnRs4ZbuVJR;ptHa))tpwCoiOHxQm0F^d2>hU66RB
z-T7*_DsVySR;228VGNF7vD9HhtQ40D`~-Wd_8IN~@>bWVuapmCn1IaJV`rpw*!
zfPpwmGDL3wAZ#~pvW!Ku$h5*w%
zUdGF42G=wNZzwI+H;L%XYXSFMut$6u{Yjj2=b(4h+bU}kxIxPEBX^=&?iF)EvRe!q
zTuTl(qH7-RfQm`rSrnQ?sC+)gCvnx=&Iz%-02Iyp2mYwKS;$R12F~YZC_j*rnMk)7
z*Okv%|C2bh?4}%lLiW6kZEzw6!hfh&aTq$k3WG?kKY`L_GT-tGgFybp5(D8+{7&Ll
zvjkV-FbZu5v6{flL3Uw=BfqcjuY=u{Bw@^CEy($At5We+m`&I&$jLLZmr;}e=b-)#0n
z((GeoMe6hD9oV19ETfAzTAoaNIp^H2T27Z##ekUY9N}DW$
z%OHac!)
z8|=IlZUnWgGNsP=Z>t)o#xA|>2aBEZY=8#WGRd@+c(4x9E^jb*$|#m66Bw;b(5>7#
z2Bu@39xcbHPd8JTS){W%E)wp~jqKSwHvvgF2{0isK
zw!Vwc93K9&3GlOVOUBOH#-2vs+RpGl9qj+x`StUa7*)v`2Bo4jj-uQ(*B9B82fW9YY1_LcEOGHYf$Gw1Uxg8Kp3O^VKi5&x0&ux)l
zxmOe0guN>vuz$2$(RAr-VN2?vx0dqjK}qb(oBm6ui>qZ8hM1!JfUm)iZE&%1eDPzp
zyI2knFTkP3brSAF6g0DRE`|n8bL4TS))|NU)oU(=!p7d`asq2Zv&Jn6akv2!atpi8M)w-v|5{FON~
zsajnmo&Z~cgq--TLmXQ0yGXpEtoq|GlN#p!lm0#%H_gO=x^#et~6q`Mhn-0`jZE&l_SnV)i#iow;h>mHRrp=orHM3U_khH
zIXlnusXN3M)we*H1{cw=?zqTa)VZ{SiE+${5Ef@1v<5p$WOxq~cjZb;U7XOAtA*)z
z=4?mM#zMwjx;($V+>V~n&Nk1F3nT2C2&!rjen{G8h$U0Tdc=ykX2Zgj#dLPKSnGo~~Vx~~UvB0-FtqltYn9+R^$
zImIIJUvdSk0oI_+(CF$JM*1M~>LiDo0}S~VWZj4Lcax|Q;SHheH3b}qiemh?$?=aX
zBN|O|B+O!dRS?(-nYTHfJQv^V5X@jiVQ&vl5s2cae
z?X-1Ql&lagow5M`>;w@}E@nE)M^bI&CoIn8x;mmtLO%ypQH*~SmoNTyn~;M<93!~X
z7X}%Mf<*6^q}ttTsAc|&q6DKxN+nx>%V31f$<@z~sf3CajL_E^C!}Ik{8~6@M?~kw
zObi-Gf#B~R^>ext2ZX_y`D7((raHpx2K^{yl7+0&GH!w|?kRjmHlMN>ijv@X#r%nW^CY?Sql
ze1f-`Y&ax0&kCM_*F%x=T5B6a-PoM6OrN+}DM$zz-X(D`1fgW^Nw46pgTMqPGJu&D
z2s>4&7U&g+l=CWNzDJ*r)c|4d8_;a&PeGO9lKpR@n^8nd&OFVPYZM~n7^YSAtoQQ@f{IZxW@PFcPxceE+KYgTB*U8Vh?D_2ZQM
zz1JH`3KHhx*bt39zn@i|M|(BWP+zj$CJC653qtw9fZ)KZO#Tqjzk0WFV+P1#78!?+
z_v_b@WNgOb@ph`g_$G&TzH-eM%^JmPB*A^-8OhKadoi2=hAC07JG`u&_=5E#I{X)u
zcoreQae{2!13%aluVH?aZLBCCT}zTnPblqxi#EIwcHuPogyVT5`=I5w1x{rI#ESDQ
zHi|daJUxBHyN3wY0Wq`Gl&B4fhP>WU7+9T|T?_MRYhySoC{~;fu|NfrK}wG{gsC)N
zTfr^$NRVA-THc6BBq|^_1iAR`!K9D@fFK))*G4C8SSL+rk0p3x5z}3X(WvSK#C|gM
zrBW@~im~rf(357Kp-7J5H5J8v9+H3NdaamW
z*uS814_M2*Z1)<^4NV>=gFJ||^HOSpT^2H;4}5{`AFqI3fb{4Sj3)+5r2y)fHMRKTN>9TChG*iOs0*(M^a
zXe$bw(kn~PER2vlX}c`$W$_s<(AHSNuEymgBNSak$a>mZBW&n`_dqs
zkI&YQf2JpnF`b5+pXtfgr_+b~b9$m{WAne+$){!i=gN@p`3!qd9k9zhXss-@bp{(i
zf&(#nKXuiC`z@!^BuIJ7-
zo@4Gkm_NvPcfNFo1&lI{x_vcw^6R(SUt`h3^z;bKTl7}+5-P+<=NuDgs
ziVQOdS0lb|LIbb(s{VSP=?YSMVEGFWP;#K>v^$>1aU~D_Mw0`}uizCkv&KhSmCWT-
zc8=`p;FCdTUN$pYTzIA@VK=abu8Fbh)jn}M`bQG~U`-iz>7%{-0Z<7!Jz+{l##viZ
zLi~%L5Hp9sKed~J4>fL`2`=aNuCxprG7|6Z#T^b!5C?;aygxPn-!=gVMDc8XvoHS?0=vE0Q6b@B>sQgyo~slPxS%-fcks@erl*Q`){BA
E56bYZ!T
Date: Thu, 31 Oct 2019 13:52:24 -0400
Subject: [PATCH 126/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 173e7213e..9206113c8 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4326,7 +4326,8 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8| See attached document 
+10/28/2019 | v0.8| See attached document  
attached document
+
 
 
 
Back to top


From 3b09c18d14f282258050c64348e99bcf72bdcae3 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:55:25 -0400
Subject: [PATCH 127/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 9206113c8..e65a1b497 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4326,7 +4326,7 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8| See attached document  
attached document
+10/28/2019 | v0.8|  See attached document
 
 
 

From 5cb0c6babc3c6c8a9fe2f1f00cb335cfd8513a6d Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:57:03 -0400
Subject: [PATCH 128/149] Create ~$portunity Management SOAP Web Services
 Change Log v0.8.docx

---
 ...agement SOAP Web Services Change Log v0.8.docx | Bin 0 -> 162 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 _apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx

diff --git a/_apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx b/_apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx
new file mode 100644
index 0000000000000000000000000000000000000000..d1809db3304fb3475797714ba491f48f22b7e047
GIT binary patch
literal 162
zcmd<~PRvUW&(BkE&d6sV8gMgsGbA$PF{CquGvotl1qNq^3?PevAtY6niGe}j
Date: Thu, 31 Oct 2019 13:57:05 -0400
Subject: [PATCH 129/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index e65a1b497..b893fa5f9 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4326,7 +4326,7 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8|  See attached document
+10/28/2019 | v0.8|  See attached document
 
 
 

From 5687d170365b970a3046e9f4d70a039a98f19a84 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 13:57:08 -0400
Subject: [PATCH 130/149] Create Opportunity Management SOAP Web Services
 Change Log v0.8.pdf

---
 ...ement SOAP Web Services Change Log v0.8.pdf | Bin 0 -> 135979 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 _apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.pdf

diff --git a/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.pdf b/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..ed8a5661da97ad32ba3c950ac6bf911c9e8f54f6
GIT binary patch
literal 135979
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
cU5WD*~N*-|I@p{U*z$
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
IvA==;2bFLdxBvhE

literal 0
HcmV?d00001


From 89e4fbabf2ab01bac213e314eb253dfc0660a86e Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:01:26 -0400
Subject: [PATCH 131/149] Create Opportunity Management SOAP Web Services
 Change Log v0_8.pdf

---
 ...ement SOAP Web Services Change Log v0_8.pdf | Bin 0 -> 135979 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 _apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0_8.pdf

diff --git a/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0_8.pdf b/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0_8.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..ed8a5661da97ad32ba3c950ac6bf911c9e8f54f6
GIT binary patch
literal 135979
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
cU5WD*~N*-|I@p{U*z$
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
IvA==;2bFLdxBvhE

literal 0
HcmV?d00001


From 0b499dbd2f446577aab58148abd7c16c827b8583 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:01:28 -0400
Subject: [PATCH 132/149] Delete Opportunity Management SOAP Web Services
 Change Log v0.8.pdf

---
 ...ement SOAP Web Services Change Log v0.8.pdf | Bin 135979 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 _apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.pdf

diff --git a/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.pdf b/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.pdf
deleted file mode 100644
index ed8a5661da97ad32ba3c950ac6bf911c9e8f54f6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 135979
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
cU5WD*~N*-|I@p{U*z$
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
IvA==;2bFLdxBvhE


From 9f61b4ac2d07b671b0db8429ea29478f167235f6 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:01:30 -0400
Subject: [PATCH 133/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index b893fa5f9..39988b253 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4326,7 +4326,7 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8|  See attached document
+10/28/2019 | v0.8|  See attached document
 
 
 

From 46f05399c44bec399bd1829745b5190f7848f8eb Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:06:02 -0400
Subject: [PATCH 134/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 39988b253..1dfaa3b21 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4326,7 +4326,7 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8|  See attached document
+10/28/2019 | v0.8|  See attached document
 
 
 

From 6d8e2a34912fe8e6660954e16c09c912b7530769 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:07:14 -0400
Subject: [PATCH 135/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 1dfaa3b21..0f515eaeb 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4273,7 +4273,7 @@ reason|  1.	This is a required field. If no value is provided, then the system t
 
 
 
-### Deprecated Methods
+## Deprecated Methods
 * submitFairOpps *(Instead use submitJA to perform the operation)*
 * submitForeignGovernment
 * setBidModuleOptions

From 8744dc39634bddcdfe66226f50959c82c74268ab Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:15:45 -0400
Subject: [PATCH 136/149] Update Opportunity Management SOAP Web Services
 Change Log v0.8.docx

---
 ...ent SOAP Web Services Change Log v0.8.docx | Bin 15758 -> 16079 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.docx b/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0.8.docx
index dcd45359ae9b0011fa07653b0d70926a22772095..50058fab9d6f08410761203489eda3c8db98937b 100644
GIT binary patch
delta 10837
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
SU(1Lyv4o!l(v9aY+5Z7y>HsYO


From eb7de355ee9603b0c017e789fe107882962ddeeb Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:15:47 -0400
Subject: [PATCH 137/149] Update Opportunity Management SOAP Web Services
 Change Log v0_8.pdf

---
 ...ment SOAP Web Services Change Log v0_8.pdf | Bin 135979 -> 135379 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0_8.pdf b/_apidocs/opportunities-soap-api/v1/Opportunity Management SOAP Web Services Change Log v0_8.pdf
index ed8a5661da97ad32ba3c950ac6bf911c9e8f54f6..84a776dd72379fa557211b75954c84e289960bba 100644
GIT binary patch
delta 71894
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
4l0jAD6wi2uJjLliz*9B(|N`oP4o%29t)fpVQ*i
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�zf?31RmaC^%
zTRH&zb?wNX+tK?TGpZ0ilT-+}WJyEnYs(DQscV^^V8yBV^h=kJtxvfWV01IQDqoXCLrmkp2U%3-(8Tsy*)uM5r6r#pw
zjyion0{ptMNk?e5FX>faXScZ8Q*{?3R%Cw}Bt(?Nfvu3Zu(5VS(df(c*
zzg56UXOHv3YuI;t0)jP-ey_ZlnnhA!;XXD>fZ=7eh2_AC=%&Q)A2U*W-T7JBxUkUE
zlBeuaa%s2(5l~E=F`i#^nxv^wLg#BU^?&`GvJiTZ(K=&0=Ktc5dnwd#ThD>x1C`1V
z6T3`q%tVRf@nppNJiESo=`Mkd!ZbK=J$VX5A{Sua13L}t`FMK;C++r&Q082
z8<*wuk!0tO2m}lB{+!q@s@ysL?rgM$$k3T;NW<%SOt}vzG{Gdh8rdw05as+;O8q;C
zl?W;B`R{q^{D=7j?$kX4=K;hP>zHLbrCe**=~Kt|IDCO&`#U1qPz{X|Bl+a&B!zaM
zT!v>k$UWxDTGRFC%DLhr74*j_C14~8Ad@s?^U0)7NjjWL!^%qrp9By%TsxhPghytU
zX76xoWq(w6+vUAG3!4X*lk>b2y
zHEnQ1P(M4)J$A&L>Ym`G5&Lftv2jNZ82cGH5@rE8}7)w)$71Y8ynFr
zl_MvcgUhpI8oWGq#lng6cX4e&wK)^+2^weqJI}F|v#vq62uS@?jcBGZZ>;O0bfqa8
z
^aD~hqJ^UQSBdF}1v@%mkaXxaj>Xg#Kp`7pu&Mj#s|O66VtlaO8sEaEM4TRxdry8YARCj`56uZ1f3j*wj25wx8R}
z7{9lG!|wc0@MxsJz7B1boma=)DN^v&G9G1Tj<(F+JGpg1Ex#K3i`+?Jb1|2=1e@x&
z#yeLhUs@azVNa-E{Owl=oRE$qy=xQfx|4AHY}xbIr-KFxMa?o9+4#$>7CZMpSvp=pZ@2UBM?y>dsy)S
z7&$&InZ)ns*+f#%IdChK^C!g--pn{b8gP$s*7eejIS7~=Ou>SF=09fx*s%HA>_8uW
zMMtB=H|wh_VWyKS1hSHGp}>mT0Iy
z|16m3Ly-yzB^YL6G~M#CR&=rSCSou8OK3V-t7e*OiPjZ@U#xzSed@vzT#bd4PT2Ld
zC?JK0d>=DALZ(iVP0&XlkFuX6<<(N>MELatc5WQX*){Gr4e-KJ^_9?&>_``Y>Rh8n
zWwNYcbn#o`t%ZqXA{_bDE0NqQ+%X6L@SFk
z)<5dwnqjAQ1j4AA@PwO(H^xLXuR97r`ztje&v
z&^MAYJsvk852%^pN6d}eI2BZJq1@hmg|#K^ST#mb2R@mpeDh(%&&wgvyb7#tYL57+
znd`(TzlA$7v;MYLu@*Qj++$}TwTr1W`(|Uj-jtVJoq#B8WAJJ_A@BXQD@tqZZY!Ry
z$4E1pE?`|2wOm*a?=FTrTLoXJ|Km{r4&G*7_nw)rDC8I1W_j)SS8DmZ61mvOR*&l&
zVULayeuvI(cEZedww7O%K
z@c??RKXnt@jQ^b17M#bjnhJ2dBT*+_ZO+PPZ$&KJYqd
zz8H&rTa?U%J6j88Kfy>MeBJv?xH)|S(f~$lDbPZy+0b1%L0u!sCxT(zKp!i`wyet*
zoM>u2v4PnvlT$exwo~3Y^ty}^OjZ;H3Vgp}>Ba18&PMiKQMEa|S?p9cR-@zNgb1KB}9rOG!9)ivku#EGMeD
zEiuUh*ma7OCgk@4`TkH!Fw6(bhvTVPKzR+edaoa~f_$V(Md!%u{C^SP+}bBC1H&A8
zAx09=0XqO+sJ5U&SSn{G)Q9MqY_lpnB!hwr21@`^C)|MA3J)OSvZin6z!!BXV1d0mIcMfyC*?xw!hCKih&J6n{Q0?u&
z|J`oWM?uwFUxin_v-KU@bT)@kkAJ=-#E4xg=V*Zmz!t%is$hKuJCd*s&oAokV7Nv_8VPckMUAP{3Ys!2T3rs)3OICM62vx1k^
zqo)boj?AO90tV9G#f(Av>KperU5CyB_I`>Rvhi(>M~=
zUkK8J?rUY=ok{f}-UA87LlhdF%~|
zNo;AG_DMQ`1C%iDH5x1_2OJRm-X}Sy#fR>r3OrlLQP@DT_?IJt|CR-yV>^nf$%HmZ
zi^+sF0Nt@2=Y=veFWbVNYb)ltJ;NpG;gue-3c-c#LLP=I9pFGg!pCqRk5ZeI^%D@J{8c=MmsGOK7C6vAstyfE7dlmCK9v7(KIL
z86QAuR@+abT`_6$Z^8J*AHf>nF6{m|Ptp?ii+|X(-{ikf3;3LkB>bRj!xl#|V?w--
z7C;g&vP7H8N@6&_kRS0fVynguxpf5c9A_Tpz&Rb{h&d4y5%D@XiFGsKOZBnNFPvF-
z*ILu|zWyoheMTUA4`XH-V+L1V#UZImxj%J`Jx)_l=cI<>!1T(4N3>evTqhl?>qqYK
z*oC}Sy2Iy(i1&9D@hvsl8ifG2h{ynEkl+(~B}+phnS&ZPSrsP>nvA>t(8b}c+U-k7?|Kd@bropzGx!V`
ziR|3m%Y`)i2K1L7!xxE)_ZkDU(P?zg@rRQFVGgf7n#w|guJ-;3l
zy>LIrZLV5cX|D%?F0Rf<)q%4L9L)NRoeHb-%lQW0F9h
zK7~K+)0bje3jZvi8mv?Co
zo-k6bsRfK_K9^f0C`1_E>tv+2Fiz_PS@#_DIwO0O8D7}awn9p;p+PqR`N>=8hn*im
z`6b8(M``t-pvbl*j3et^Twsz-W`!cet1eBLId;E59}b$xyzsUBBoE@I6rzikd@wq0
zKMMsI2Q!Pj`GeSY&d(#}#se;;7p?Z1(XiLC^#V1E6bh59;GhxF{Int@VhDn$FlNU=
zGat>=PO!VKJ=m)h*m1o-+Zaw(R*|~wS$AcjEg)5R&pc6r+M6_d0SpB29CB6-qt36x
zrh**FNXYuUf%R<*LBHCNXLo4u`9VN|Wm@^fBwf;J1uH#ly869;Xmm}g18B+*>gPKOJi0vlUE2~7oXYb-705DnkQ={E%
zcO_EGU8{hBFsVzRYgYfrlZN~VjtOKGf$5JJMUG&d5+%Q%lH$3A*!Foz-|j+wXZ(=+
z-CpBtY#&`w2sFMsscB@K_bW>IBS=50xtM^Z5jwcF4KcYhbP@vS;$MQjv{BEib#4`A
zG80QAR7qs%{);m-gZ|xcH!U=qRD)IP^Cy^cBrbuBPS3U`2c+_2@|v5(teGIeg|zpp
zU$;MTD@?@ZdYyx2McA4AQ4XW-e)cAut?T>5%_Ya<_3S*Ja-
z)}qeVH)^YE(E0D&RtAhwZug{jAxber6!E;-N56i@H`*x7Vb!4$#DWfKqOn8bzYoz&
z#-y}6cFK|D%Q?3v2jeA`3~wGw$T}8wJ;|=xJL?{QI;0-v^`E^xVSRQTatWi6vfUuo
zqYy34Q-OC%&*4_rT59K2F!*ICJ!-q9eeeE^Z#G`L%LfcI5y$;7!N;pK5Lz99KY1Fk
zoIV54t=^RZa;!mCr?e>26xjWR&N{Zj^%VIdot-JRC7Db-y&fg?!dw*j-erWVw}3IE
zepZuqUw
zb33207g~jy<0zGl#&k4eWt|5h5J7Z(sbu*#>Nsk2WL%)7?7Mghcal{c_+9)WW-=W4
zvaz_BaPq;{f2EVXjoWdDz|rk8fn5IC$_?R=Q>%&9o%Qj20&
z3t0CBJNtovT=X@>KWZi@A71Eu^!B64RXtC)7`1880(y!K{%bgMef?sON6GAp9umaY
zGTzZ&C7&_|*ha;Qi`rQgK=LVZPG4p$JrZ-6G>n6OL-{qcIz48%VA?okU0c6-PhHC2
z&YHK6Peu=3{x$O{Wmz4HX})taJrVzm+D2|99$x70B#
ztY{vNvJ_yUB?z%7b^RCmU2l`t|04I2VhTskyc$VYA$E?M{a;m4$d!G{l`A;Y4cx)6
zSxy!o)eD%G#N#E9ls#N+TAI`
zWJr_Bo`((gC#Mvf{iMNkE?%g42MYWCzT%)%z;`=?h!mp*_OETN%{B7@9#2;W$+
z51IVJMFIJ>ZB4Dr_?04?Y~D=HA!_Un0z>2zCU|XsGk(b5>Jkb8a;$X9p8@CyQpRB5
zHFEWJMT8gka!4$JTQU3>G~f*0GM=>c9*56BKpT#8uPze$e_rq
ztdmYh!x@pyKqtDYJy|E}{!a*f`25v>#Yp780)#8Mle!y{r_rBA5b|FE(oCBS%f-XX
z&7Q1GNAkarD_tN87n`iTho=`g2NxfI8ss}95s;IMgZuyejVs4sGmfYgt($Guca}(R
zu_w4tTovf{qe&tGbvAm>sBMf}-^-VTA8oel{h42C)rAT*M;{=>MW|jp8jm9r%QQ@=
zN}F^um*71NFU3KW7h7Z&$jPd`f8#m!^qnjtn9L=Vr@+69on!BJM%WgxFH5Tdan#SDCzFM{YeJs}bX3!YIU
z4~V>Og4VoCua|V6W)u!D#eoxX-;71sgalN0b
zJM7(ecc$UcTq7CFa8zb)eRDvxY1)Radw9GM@Zj2lriSVShIk9QA9=bw=fw}U;
zV;C$I(_p{Km^+zT+2l7$C*gJC{l-Ky7`?P=NkE&y6`F
z(A;V`P|kog-*7Un&!jXC=qJMun2
z6eEmSZyAN%jBpOFyP_9Mbs=DbofHrq*A{*QLxpjVEmEZb;g#JCvn2V0KnukvA4y|)
zv^Kaf9UzB6W0MP6rjYxq=Y^Q-wB%LlvKkkJ7n+TitexqE$fvLNUn))3Za
z5^W*dJ@@p@S_JCVAu6&3d?2<2mRFZ|7|$00OuD>$v^l%zdt|qy0lxtjBI0zlp5u&=A1jz1YF?bm0zW|52x8m@IEd`WUz32EQ1!&s
z#7~0rImOqBujDc{vAKCUbh%Xacj5BV>+R{~et+P;E#R@U{*$W{-!=9~bUWzvL6<_>81^oOFS@CMoNX$ezI8Zz8;qZfTk
zXvdfLnXU5*WBw>Ix3@7v=Cu$f@nIq)r8}G2*So}`z-z3(qb5QRff4T%FGz}68W(xd
z+cMmo_&bFl*qjf+4&^%*bph+Zq&E5}$_q!ovE=n$JzP>Nm7FWMs65K{`Dbs3?y41;gYmc65Q3xd1
z3LzbQb&^}+na6ru@Vn9A7QRm+c3G@z#3x*8G~(0y(^Rv&dp<2WO*k!unzjpJlFUB?
zz`^9R^TVu{(>vBd?L=1A;@Ln=9jXN)=|?mQA&(KVniubK-Y*uy^>7L$M72o_SRad(
zZ2a7HE3I%i_u4cwzWABo&EMIWP_?T-g}Q8>&Y-_^eJ)P9hlh&(UN&sVlg-Mlz2xRw
zU;b5Fo;3`m_&_0QxFIX;Cv&9iu1555L+4sKbL35!BRP`dwz7(L>cDaD5M?aTns2X?
zIWlVBA?2TUz5}y83Yo_4ey6&wwLsX+YVBdZT7-nTyHlSpw6T;Vm+FFkmV8=4X5W%^
zk^V?P{R6p1q#}$ilxsAls1atxSi}{a1FLwAp>?{85sY;s1}ZihW{p?`A)w8_Bi+$)
zp5nXDbEn|~T3$`m{p@_~su8f&7Mf;alzyfp53&j26SCh`Il2G%E^{L_vDyJ5bMs{rfwR?J|A`~OWXtR4
zCKU>=FEoH;=2}jyPhbte=9Y>_p2Km8rKK>5x<|4&#tWrqG~unGFoDSdla83+jUal>
z{$h;M9hx%19X7#r-CPR`lqseyE9jidFE9RKpPfU?BLp7(Rg7!edpFMiS^BGBuQk!$
z$owZOz=dj|t6vK^!^Ov0ZCR>6W!TSKx;!*Ilm0W2(#7gjH~pu$0#QZ{1Vg3x_}FM1|<#uvyzSydJ$HAa7>wPPM@SVbAJp0%i*2B^})GD;!}Bb`|<
z6YMnaZ+dA7-gVW=&h2)XU9d}dM+V3CbNK>xcNuW|aKI{?)6%!nxR3FlMU><8`&?2i
z@c=T{k9}@atQ{9L-srjmDvwF#$Q}=BCioJMK!(U49*cDFZXRaTWrQ03X)kqJeg^La
z&avy4B{Z!pR}TJXKecKTmqmk8C+%BbUJ8MboG0<{~n*S}{=-)v}=7Ae-*bBHRM_
zgLlhDjoJOj4zs!=_Wob_vwhgm(HCl8|H}SUVSALTJ8G3>G{0kz$+~>LxI4L8Xgo=_
ze?8A*|GluweUW?DLzcH?L~2rSMi$xQ>$`9UT)6C6_?YrCy38ou{CvB2`{dsIwcZ%E
zalMHxyOMW_u6i3Ny!qKaGWB-9zWcOH7CB&wAMQR8>AT=%L801d`nNVdvhwI^d-rqc
z4*l8f(LYVN2?*Ky;uLWnR!IJi%>7SYQ`<9!`^|r@qe`
z!Ik9fG!?#9Yhz=0m&B&Rb<-Y_4!O;G0AeZiyZlQIQ)gkZ=Z*UDv^OQ79c4ErF%28i4
zT7V_bo?v(gz31cflcqA&;J=L@G!9NEZl2_NPV!`S4h$$h_J5EQk}tWAlj~oz2a}Tv
zN`T`(DkuT|e}W5=Wye9z!NbML#hIMgLICt#
z^%&AyNy6lnfm`69(Q6Cgm@>m$Pj^5G!z+UTK~t~ZtN4ddH<0%gCpr03{Bm7O
zQf?rUU#HFr5B~JMoC`*!HtzxU&;dW>MuHx?Jr5__J&&eiWX;$SDI4~Nq`~1|VXfii
zbmM8JxDdP(bySagb)itLf+94z%=MVAIbk6SZc){uD(ZbtaG?
z@j2x5&jfKNeh*jFaVlX7S&gBvZC?la1BJBWFs8nd=jlvUbceeQ;+!!WR)M*vW2Hk7
zA+QwvxiG=?+K8X|uUFzTvf3rDZ(jp=TZD@w2ip{5YTcx#yu)E0Pf-BT6o?+CYOL1m
z;ZCM_Xtp>b(`6}f(eTr8dbK0FiI{Eth^5LvEnuLJ%qH=v3RLbouqT5$vF6ki(o}q9
z{kB)q9KC7u};GM2P=Sk;|>RM~5E@EgJ}
ziHX7MmNCI^X#xgY3^eJ5@ei_HF(cow1y01cHDR6kaMhN+oINf)J_4=ZqvQUVa=w$U
zxx^LP(;d7%>jg}CIkd;DOyR6ie8wcVqJAY>zVN;kyyO2Vx^(u1%UdLMV4uFPVtA4F~p0%ryRW|W*Cj1p}Df$+8+d@Inc1c55%eATOT{iD)
z{i2yYvMA~O60$#RPKle>q%7cl;x;wqwa;LB#apAEs9Kc#^u>mHCf;&PYUKEt#x{fgelQ1
z75%=}S|qbrGe1~$I5KRX@R`m;>URbj@m=_1KFa$SLNCdh{Y##mP6PWJyz0;D5AxwC
zzLL4;Ju+ukh0%r}#Ykb@yeemTRO8JLf4X~`ql1}q{C(*5gKzdTzLS+@nkQpx=~oxW
z%aeoulE_rEpq|(D8&0_QuJhKtl#^vmUC%SnjGC#0$OBQu
z8RAE-)`wzy(}h<4d+cd5B3%5Ofqj!-c89&L2HVAz7TeDX1!lVd_&@#}$*0Pin6DWj
zl0_tIQDlAJ7*x-x%AAU-={i4ntnJUrBU?hw*D%I~mI8pUMTCbupkF<{Y~S&k@?m3@
zJ9VVrER1PL>`aGkt4s{|&ObMgDW;TkKlok?d?^dQNk3x0%m)9(5dUnykON__y>C2T
zq1_pd8{mn|+!cNevs*y6{
zj)lC0O@#t_LcpsbPhMf9sd`>#G&BbBDlZe28*Qs(ycqqQ_nqs1bmx~+g5rg4?sYN)
zu)`l;e|--7c;Nr@@gSoA>BdS#71U4AFGsT`!mSXH$Jw;bAtx$$!_~}vfh%Y%tOO4J
z`&nA;Bl0JTtUQl5L)LC+(U3?H(E#&dS)sx;lD7;T*;e8NGuLFAyc-eXgx8op(J;@%h02Bkcb=x&NjsHC~G!6-lxMnZ2bQa;Y}Vy$6Mmh@*id6C^~$hMXqCRt{W2x;UHy{f&_`*xh1+5{PI7n~2uBng?JN>uCC28Vk4D`84uN`)8j_ntqM>^Navh9k6%t3^ui
zPpItG)`QvjT0RA5zipp?(|#4*Y&GA8EBtmQmejKx1q7zPA*NF9f1Xz4`y0Ty2oBw>
zTXg|V=-6uFmueS9UNklu$PL9h!77TGo9P=5AB))mEuVf%5
zd=12$xU=bE!c0ZfwwH`11v^SvJ((Z!*dl|}>J&CnUkgo`v0^RS^_W;O@P8=pS-8ix
znVw_DN0$w8?a3tD%q!F0)Q>qKafD~~EA0YH5j2b4K%y2+qnI=}lutnS&zq-h!iWaE
zClX7-_YQZ(eUo+NLhl!SxV-yIXbumQQEtZB1FIs5i{a2XvP2)<(2u;B83xh0?TLFI
zk5$l8De2^`eXhTTI=<0JnH8|uTj}x#>RB2OvvGspTtDo?-Ap>4uZpqr)VV&Ftr9R#
zNB#04MLEMr(0(uMW?x|#FP^|yOD`dhZ#+lnwh40}5_O7z(@)JOZ%bcul6Fx@KHH;KQRf_
zW>l3B>-<#WWl>`PDL{hC-&O!A2MxHb2&*DjSx)~T>B{PsDijEhBC<7Gs#IhqK_NoI
zLL5HkiA*f2enNkb%aXTlq^BPo$dZWpJpHy7wWYs^g^5Uj_~&fbXoJ!}1}9?H9|z5G
zj((Do?QDSysnQ`ZS>abWY|H(<$AH|kEUT$}H{0UqpLDucC451HhDUB!hi2gXxq_}%
zY-6cI$8wo&fqJ9K%0|~5{@Lw=7v7V9%?md{tI^qn2OiFgkqR|aM&LbEzwLCLAjy;%
zhTxTOT~ARN;|}6j-G{iwxS_D1Qn_yCEZ;rG-?UuTR}b^bESsVoN5%(_Rf$IDAP?Kl
z@oxqtRjWk~SRxIjUzUiSO-_JHY4JbnIIn*Nx-`_Rh>A3N_&gYm
zX*W+ze}^J%<*c1ChS;q^+Hf>i+;$q&)!w5$95bhXcxlLq{)RX$j21jVk=NJ7U{drY
zKZA{8TMoPwqSJle54FlBXYOeY>8p0=k?QZe5Zn@P2q)+y1UDsU
z;CLGNs9=bCXqz+OsQ9;if+O&cimP*bpn^(e?a@e^QHQ%s5$@$hn;kCml`uEe&*kibFi0r)TN$eLd_jb=7Y39iY$J-p2q{Yb3k
zBeyZRlX4wc7BbJeQESckCHi>Yak*&AxJp)?C6#}#>xY?m^IQi&t(Im4sq{NG=D*5b
zV4-h~#?xM_Gh6yB<~U#zos9TqgRqNfeXT!(>qhFH+Kz?`=ZAQ$onPI}|7@7+;ZIHP
zW!fC!Tp?u5J&$cQw`kw4xoc4>jNc|G6m{X1@%J~1>Kcx0O%J~&EF)J`(F
zoqvp>&{l0#8FO?#rHfwl81sL&MIR{qj=X1&vP_k
z+$|FIu(x3*%G+XdJldHd;{Mk!1x2#cJv@IrvzR9STuOXNuYAH2-6j4aIwgQ5f(E*k
z;di_XOq>=znE`(oJx0m{>212@vHVs%7MyFmEU1Qm+$1Sq8!T8W$T=DsX7Ih!tcTos
zRh68GhcDv;FZ;8y1T2~NWEHjgMb?(JjA>paNNb&lGS!WYYr5JA!ADz28iRztU
z5)jdZ7rAl|O^_1(Xwwrw*RaF!H@T43_AUuM8pWvsS_d^o)zz2b1#~ks{uU2oQTuY+
zavvkF7{=CxjFJ3lNAQRDm|Qz(~l5y3eNQ55>qViiBoRa)2j
zc%M_*o=MrKX7D$Ikh2w%O!G{Vx>2|jcJeM2~T5^_|75PZ=IV#wfG~9h8b#~1s
z@^11T=o9fvs{3{9S*~SMuUu;@uxo&CYDtLc+^=@XjgK!s&2t>T
z=*AADAY5ED0kuHZsKT0A>JaJ6ODlwhr_GDcGePCxt!=gfrF+ZbiKaXK9?uD@Ryjnb0|U*4Wa^
zir26J+p!(b#gduBZRN#gBJI@Xt9YLJNx%Fc?+A}j1g|A>Zip|srp?2mLYMZKFLmTi
zd8HG*ImQp`3StmHyRa18Emp!W{T+u4AZDifzimov9`0`GiMS$J=MTyn6vO^W7NChT
z?{SHeuCE;J{gsal#ya?xew*pqysK-w3*%iOBbH5Usmji$A?{p$F@F1dIf_XG=yNiQt41E#T31&
zK}s4t#(Hs(Kg}VNdj!^9N_yoWkeKE)rChsE7UV!0LQ~4bp$tNz
z83$i8x_4k{g0Jb-O9ydiXqnW14pP(5GIB_OZWLlP3#CEz3OGz0vYepLx0nab;WQ~gLOrJ(}Ly7a8ruq
zN`KRVRm*Vm6RVc~rU5Ge?DqwP5B8G)9fAE+K(=5%Sx^}e?56;t13xulsnXxHVFjf4
zDS_m`e$t>wu%A2#9=uX5U5VA1;wKJz1+P>LqS3r5G|}&B?upV|YVVQKv@q2xgF3-&
ziXb6yn-pjr+@=gN1h>h6vcPR$K-CHx<%6gSMzw?93PzQKJPJnDgW3v46@$16Mm2-h
z3PwK%Df3d=q(RZ(HhB<>f|HI#G8R7LT-6|~LU!$-EDbMxy$ND+!ze3CnBXIV_c`Y2
z3RNm&GU*s>Ruz|2hzXaUzl=0sr+_!#r)GTC|rdUx-sHBPmc3lFac56TCq1Uc-DA
zDz;mizAKAu+MhgERfNeIC~17R9}rhI5{$Ob5o1AWN>y}B*Ws$R5M0O;L~5GP%S1Qm
zYs#)jJWF-22(f1nN_*106OYco<6t>RfK_@>x_dW9lCWi;0$OHHa7R{5Zk}k*Y`M8uCx$q^OaF=2d3uM~^_{hdn
z2DroQ*%!!FfV>Iz5Vj{Xi}4j~bQ3nG0~h{W)*S8W{u~chr+te#nzo$QZqqJGDy22q
zf;nS-7w1a$N)<}R=}t-vA1R3W(@J9>DWH56r7!17Rtjde!kWaI%**;27Api(R^~tU
zI^;_cO5JLZEs?B|ZhUiLIA4X*zAGsS3h}Ta(sIf-0XaxGBnQn|-zUAIPRN(vvlPWR
z-lI?CO3B{Ftn;tl$27%159WQ9wmH8Ic$<2jFqJ|py|!N}mICYUu9QsKzfIp0M83r;
z=6TqYrG1RwBQA^>{l#2}Jbw#5VN<%|`ZYpv<#9q%+WMZO0{`pJ6*ulZ?E=wxV9p6o
zscweJE-)c2ZNik
z&+H3QO6Z&yHV%JAjg9<+Pl8Hwl!V^Cw3GLU*%OwBkBxYdE&NjY%kFHuHtf|ZhWOgt
z7Tvfp<^{jJIqgNXP_5L;zB%cIy`WP{B(RE_{Rik@de(MnQ0kaoW7F}2$Y`vDDV^1}
zBj$|t4>QoBBkYXTrX$K8dBLVsnfNP3T4n~TnP8qh)dC#Q0@v=Bm^<&WaH;1z$UEON
zefp8kUtIY^+G%)?8MtRQD_GjR5s2DqIMpBcwQfkcjna-GD!!dP`mD?wh^)Dk`
zJHBhC-Gz54m3jJ>-G&Qim&Dj3Em)Om0KXG)kL8iqvd`s_m;HqS_P6KXe1vV~yAx~l
zbN|i@_6(svoClQ7oipFkRYBvvVDkdMBfTNohTOg*D(4FWjWF$SlCv1n?2E@D>zaZM#zK+xd+M4U{N1Obb{gBH^oaKKUSF4fN|$X@nF8+%VbQ;
zHoTf-E?Zf(2}1{aR=?8yJsL=rHZwRgIN$0$QaU&U1Z;JuGp5IgvxlZr{%sc1$mn2S
zP1i^le68jZ9}7BDQlsnf#-j%@Br=3B&cFRJL)@$27p2v$s$BT8!<<%>=OQ=hjO9&Tu
zm*{in9^61=H?Fk}m@Ptq?I5aq)Y)a|WeL-0qh<2trBQF(KwT(Zh&1Rl$TTRRWT#@n
z)m{|hV>Bi0TC4PAJjtU^
z2AJ)?TUx9xPMg<%clZ1z!N;l}ZX9p)UuT@j$i>YCuj}}cF7m47v}}p=HwGFOjVz|m
zwpFQrcB?x%;=slhx)#lr&#fKXEf%GIP4y>iVR@LH|Du?c`T|VNjCf5A>e4DIp)726
zo{1}IX`-wPn9_)DwgcHF+TOItpgEV@+QXdO*HYW>mj
zxA`-9J-NXujCNAW)J!wyq$8?MdrL+bbqoHpt~-
z2(opW2B_Y&Z~$}X1Y~k0H-x?GecZj~svDrOJM!tQu)ltDc3B^3ado0?cy%ke1Bj>oHSRn6AR+`%=EJoTGGesUq@2+w@st5$`u(i{tEemJ
z&PHL1>83>G=H;QYvIn$;P1e}$v}9o+
zt)yfaa|n!+II=9fn9B^bkN&+m_a1>Wq<4;|+})&qPu&Vj`W3iYL<`0pl3t_YQFS>O
zl%FEW$TB^MJKtImnmZIDAo<)W0ukn;vuy5c>n1R
zu+xEd%J5))ebD)=&3gJJbUniN@g-N?dF`uKQ4SC}8#)`68`2i?EV#Ls(2S=Ji62`J
zu?iv;I<}WHA5ssB84eE;IRsW*gq@5ZIvsuz_7K8boJ9><3%W6cF&`@(b`r)0Vj;v{
z999j@FJvL4A{d??x)dTgM8gb=9Wxyw27VZlrdKZ?0Dz8x`w=Xe4>1aV8>}8oGzu#V
zRR)Bl3f}EyH=|F0MuCKb4h;_Jg~%71ML$Nig8mk~C62cPgHRWz#()fiHW#PIfJ%p4
zDCg}u4TeJqE|=}4i-U*^$qSL{mDt(tRR#9;1e1l31z&{#p|&Bnq5c;?1;6*E^@;`e
zK$}A3LFYjNp+#XIA%U=>kfLy+P@*uR5Fb!o=w0w#$X(D~s9msKh+U9fXkBn!NL^4}
zDCe*yP$n=Y5V`QV(7CX=khyTVP`NN4D8m2f=Nyt0niQ54k`#^4ZjV31|rn+)6#R4M&)S0Q-dvpmzviX8ca>4>O
z@OMw|3%=ebl%uKH1#;E5kY={JN7&!py=(Y-um4s4UjSu5n!o?v`|uy!%75<;{K1VH
z8rmJqq$SUqNkpMH5FNR+!@q2qL}yR~HQ{RmZKg}1!t
zf1@)GBQu}sX#p)XN()gp2d{M~$$!a&?Zwc?q88C&U@0x5Mp}-q#n26blB`=|lpARU
zf4){4|7vYDt)aDn*A<3m4Qf^y<(0rXItx$cY&yqKirI56ok#2O)Hc%jbiuEdE;y>1
z=|b9s=e&h3`bE9DL+N6CT|$4te7KA*rz_|x%!_O3y5qc88vbkO2D%Y*M%G;p&y9wX
zwGY$NbU)oo_t68!SXN`yctq5=)EQ&Ae;8x126uRFyB_oStvEVb>u~S#-kJkA>We{**`f8NX~lt^3Kerj9M_LDw_>O>h1klXQ;cG4z%VqbVH
zQrIcN^jAutoozqr)4@Fszh|C%Qq~tnx4GP(;#}>DW-aB(ce>dZFo_qMi
z!+Wz2e|R8nX!Ze-{lO<6eq#N0Z|uK
zdv|z!u3HP;T#qElxvrGGuD#i=y)LA2_3c+KV$)*{Bt&bWp$Q?*u6?vY-7^Od7|?&D
zHfUg`vum_w_y!IhGEyJVe?Lvr6O?D9Cd)#9?dJ-8;^7c&oilgp0CQSOOoAoEtaV9_
z>pddFI%QhMh(4*IdT5Al4h!uuB(G~pePP%4LSs`ClTzct!s1es5>sPC55I4YKKPwE
z`cS^9{?KK5$nfd8-Sn#>!ZcGzNNZYh=U&6pi>JoKTTPMi*4U)5f6%zts2&B=4{u29
zB6D;}OypdL$7491Z3j*3%n8($GU+dJ+;>yAwl8)@S;aVKYd~bSwtcfR5+YKG2nctI
zR2f$JYB64;j8}ILks+(IBE|S_&diMOqave{yQVrLEF#GiMN!r$?LOyY&X=9KGs+ni
zmpVDlWA;#PZf@Mrf1%mgGiJng8X5~3JHUFNf9!yMeT8dA;N9QlvboccGAiTy`t~{7
z=SfzHj;3)T3m#rZQc{TV#JcP0dbIBBnwdFxh~UT6Db%T_n;OG}HN$Sthz~a{I{eug
zdPKalOKL`p2orvjrE~W*N3WD<(`xaNc;d7qTeL|JjS3gTe~&yDZV5M;qisnhe`Iu+
zu7|}$Za%ykvw1s_Nnl>5k&ANZUvg~SDfVQm7;m@6$QKJGe`=8_-M{bGFSMKSXZ@uETSa6`Xc^@m$Te2XP?0_36JyBxzu{sbSAc6M
zYq@|TQu=lOz8)#8GRMw(YiX#=;;%;NRM3VUHt+Q*tWC`k&07
zJh=0OjM4K;_Z}SX&Ce7Kr_Gr>vR9(LyXl4D*h#AIa%5WU~BM(^YNXn4-*S*l&!zW=9tq?h1^eD=>=S{c;q+U&&E)1xC^J
zs5St*e{8bIrgX{_S^oGbriVl?8bp0XpO)~c*nHkNAR)4OxU6qIi4ki_Pi__2JL=Qp
zGh0R0&ieQ%gG{ZW*N*x@;eF*_I@O~k2JT6hgq*Gk(IM@2j*!H_P9pc1#Dp|Wj+UId
zrYOxEmf)VXx_I3S7mc5C#j9uKoKaC^3p4Acf3V1~=>8LzOq{y8X2_uGi>HlmC>u>t`zUhgMUbg7?l(>X0@!{RGyBBVFe9h`d&Ki}Oof#6F
zCjWN?IhQZOT#h3HicqA7uS
zf0+`Pmnne}O?gO*rErXBls~%E)+#bv%sdy>2)?1_-3(hxG=?#1XMJ?3Sw{Nn&4KyG
zQ%&nI)k51%tc#}J_RZ}_zA~m&#+_eWUwZ$*MR#wwuVu~MONVOL+=5Eywi5z^BwQhohHx}(fwoYNHk7t>
z+tRPc(k8JJLt5b54W;zhWp~rB+ZOnd9>CI?Lcb46NUZGpzB7_#6I$4fen08;Xx?|`
zx&P1eyrX<;L{p%#Z@hkF*UX*$7v%Os{|Yn(P);5IlviVqL%NT;V!EEhbgE)He^oJ^
zs+dkyY?hF727?k%0)RNzEY9Ujhobm1QT&A{9*r_i*nBe$$H2!?reu5Ld#?p#Cy@t}
zbQ^@)6GaQ~d7yE263jL^5gSay3|!z?o>?%vEt|)61tLCRc;TSDWJn&Mj3#dWe#jVN
z2WR4F8oU)4{1^xP8f5_ERRqqNe~eVG#ckm~Ee}Lv^*h`vycs!yC?L&q3
zp+f(y8U;84w5m`yOxV*gJP^ypw#LYqsB=lwxg_e|N7TKKsB=k#&lMya@CIN8#_3Qf
zlWaeQ8v%+k;_+jdwN~I;e~u*^QP^S^$-2!8>8djnY*|DfA*mLrE9woY!ua>!df?&rf4I#Rj=Ms-22yJPqDf+}
zLP<<#>+!IlvscjBE9gon=t?N)>=mG3JdOwtCC5X_@lbL+lpGH|8xLcs1IyV!;LR!U
zO_K3JEC;^F9I!bBf4+d9C%|`(su2(zt8?Nr0{()43yZN1F!i}C4x;KAC=y+%7fgQK
zeY|Q!(B|hc0a(4T1mhq>&lW8m>2$ezYvI8LjunU08qOM2T>&dMe;kaQP{lcGNOcCS
z95IBH9*kT-SU|T0j%c6%FU2wS+u~^ceS#^Db#CJu0Jm+}e>TYNlUc`V#}6DNrZXJV
z8II`;$8?5cI>WIif$uk7eC8zJn^77;%mGYUaQMg3K|t{$LW?Bf8;XP&Y(a;!{Pq`a
z8Qdj%@lE`X;4Uk%TQrP|eT>`lg4>hvA+I?+VmO7TFa?CF+M~1{>48%!-LCt1ctkPG
z;;G|#g;r5mf2WIKeZh8^Vm5%%h6P&w=;_)$;%TZ4@hnY{AbNAoaIHU77mzd}6$9Qg
zbZBF}L6ikSc3SKp6%Z|=Tsz!Beic#-?F`dn)&QW^rOD(8%%)Lm)2X%T)Y^1vZ926!
z_$&@)5JzmYctQ_Kc=DGE)QKYu{Hhdg7KfRV#zD6_e*i*}V;hg`vLH1~R#3Vr6XvO{w`A=zU`<`~fR9ELnCXKbK>YDwCU;2!d1ms_M6J)vgh5%v(eY
z_f`{6f!q*)Ct!{QHgR!|dYujew-Lj>qGf?r$RjIMO)CV>RtTJ}s>a52&Je)rutOk&
z^y$p^={oPzL4i*P1wNhmzEdD2F=9>te*wg`VQ9Pb=wbjpUb5k%q7#L9aV;H2rc946
z2GC{I3WT4_@(t?s{`+5k;0wRHyQ}|!mmm22na_65#4i8Ro;_dM5|3{D;6bq2~h17)3oGTavL
zsg*!Fabiyn&*dC#fbN;#utRryC<}olfDcpvGJs*nYIAVvOdd=O!kH)XfBIBtmZhw}
z=xz5@d7Dz-;TpJZ
zRV>`ODHCX@skB~i<_hy&Yn<8iegD!m(dh?{4@5x&a5?o2W7+WhZ%X_IIGrX<%SU&w
z=-9cs*=kO-uBtEmA>t)Je>u3z!7_!xV9Ofd0edgbkrTjHSK^ggD%mXKTkSQJqVqa*7onOyvMth@>JZ!L7o%ZWw;tk_6wt6gL!|`$?i6#-QVF
z1U8;I?$kf6+UE%o!b+j`6duEx0Jx9lcsbC7H|2N%AC%#aDI**;f5}ab=iNv@xCqd<3z?l~9iv_39R15d9=4Al?qbKud)i_-CWFDnjW;*0X>g_1UU|)xYt#5umw#>|WeXGV2>i&-2m%TD;xjYQ&KL_!SG~HwNdXZ1He&Cye+lU{8MGBjNMcIk`Nu0a}dNbynDQR@ik`*mYLebynD)BqWIA
zVg3U*Y32-Ie+grBL>h4~=p;&a^oW#5l!5#icp@z5EGSvFJRU7zOY2h9OzrPJG<(BU
zKRno_W$g-Az4nHc12+sO5Z8hLG{1b~6Nft6_n+8DhKroK@VAYJFRQ8EaQhhPD9>g>
zzyn_aI2OSUYaEL}=UW-UUGOvN!Ydtk)Pz?%@oE)!f6nU80S%yQR*OgAAZLMxoT^ie
zR`^F$+M;DQmP}T*;F|eB>ap>0e0+R7F`jUrES;vJ^PnR|P?3W8rm?XMAg1hgh9yo?
zW@pT652~`jl7-7S+)^3x1T6*%zYfQDksNTP{)ma>e6TW&Q#8masAH&h&6$knpQf_#
zIILYmf7;ss0)GY2-iqCY&|kC_Pt9I@FSi0ZnhK!M92`_8@d^nYslY=j9K=Jo8i0eE
zdc39%uZiF_VZ3RiY9w68ljSKdz-(C{ZSW74^!1lJCoVm=2=Er@hftX;j+Sy_F;D0_
zD9ID|`4b*9Rd}0tpESGTfnc>qBn#hVa5)eDmH30l`=lJrk^-X{D;
zqnU+Lwga3d0lNQ4MS+*7)F_`(9WfzlnkDd@!4VCB<9yUOOSFJ=CtBgHioFMGe>YQ>
zE9fiq+7B$v;m)Lb<}3)LmW)e!NgKd?M*=g1*n9bfIeNVZ*5DSYLM+HGZe&rYkwyNN
zC8cOESYhSJu|jTyGAa>|H*6+2d>19CF`qN6T6m891n~oWXR94*H6s}2{%jDSGw|5R
zXL&PA;v@~C^Pz$f{zmWD!P_^ee}LZ0+JP{8G<}L7F&^_1_T#WwHA}PsdU;pu_x1H`
z#jDa}`W<#>c~9xgSui*&olR*S*!tM-Q3I*s)x0#xrr*hfvp-Vnh`eO$i2Q~p-MxOI
zqwrs?k%$$q+;VWVT8T7<6GNHMUu`wrt>2l+bX3|}+)Zn{o_cv%SK5oGe;Y=-Qz6M4
zB)=K-hPoy?VqMKOX0B?*2K?c0bEUoTw7aIYFp%i1RSVy=C)%OTUw!c{@(!vFTZUZ)
zxo}LyVzWeh&M4T=C%suO;SJ5=768_E5bp)*>*|U6>REi*QFa$B7LCuLHvp~Az?RSn
zul;=9E29a~|vNAE1Ao?5G2
zFstYC=1JOpE>G`VoN9(I-K!xlti0=|pFNMnDBtz3cXa)*a{Z_B_uaeW@MYD6|DInQ
z?$9LGedp5$NAB6#eBsUdsV_p=!22_U`>Vz_6niz`#;k^b5>POM>+i7Z@}6lj_8zmK
zmw57*TCW9Zr4n`he?5=dEAQn^lMJvzrc5b6Mpwm5u{<;X8l-`+usjQ#3C|X`;yYO$
z_K3mw2>xw=ZmBN7ZC0a)mE0DKQ{)Q2U?rC#J0-U8Emm?O$}YZ7yagx=V`~s)vt^
zLSPE_atZ`iRt|{goG6mNiv$YOoa9t2E^zPbIE`42{8`W&g!i7m_$K)#mBMn^9)v4=
zK2e2FYGak+EU`RiTo!)ENrP9N5k9Kcyu%9Y;b`41T|!Vcn#BMQ3ELJq-Wh%;k0vz3
z8PoaZ9d&Tdf3bYsuA;0Uy85tYMR);X!+H_JYQUmsTI8EFYoNsX!K(*H@7mVTH1V0?
z+HJAF6lI8Su?HkMxMtmG{MP61S-JY&=WkhY?fNFGk-SH7OPsgD+j`}Lmu-J&=Q6tu
z_W|)ik+NQYVZ!QVEiQ#0yyqu3-}>L~U2XIG6~8W9e*pBO05fbvvJDIHadt<9hd-Kx
zIjW{2&_NhJ5JFJNETu{Kc-52;(fr5*53^n3#UN^z`Hhz|e?ZCFId34k)AG=*pZvV{bozdp3gKTy0E
z1H1!pe=nswApf1wMhyH_bs1b~6a7gdiaie85<^5~^c(3H-@?BJu3w2YEL`7f4o|7j
zH`BYcI=6No;VD?S2OgN-RV;D;ld}EST+6rgy6WOya5ErdHL#r39dY?89Y(+|mn)!f
zcvT7Q*uckvrMp`K%>thUv}fJ$7<8A7I{
zv8E=}V1$3kSZLW~jh!dG(Mj(Wk}il+e=R#@$+W>XKCn+2RnBta($kCmfu-GnBGCT_
z-2uCeo??}N!x^x!MB#2KTxs)I3}oR5!CC@Nr{BUx)x5tts2cD%g{K5(Fz(smj4W8q
zz6*B>0#H_lJaFMNrK8V<0?6%5WA+a8$a^N3h@ihIew
z({$l#f75^_i%rziKo%8Pe+Ju%FoYo>N8zvFVD38j%Z+ltAS58O?K_si4@v+sIj!Lb
z4LfMn>uGSFJ%Pky-yy(LkLTgJYWB1S8vup0RkuH;eE*f^5P?3zdi4^aJp3@y89><
zx#E_qHb!bYY)l0)u;GELfmFY+X44n*t(|-B*QNRhkZKwrsY%T@8VTEUy_Ap};12^u
zTM#G|Jqh{MmKI0mU1)QfS1M*;XHzf-%lsP(50*rW{AwPY8OXew*U!Cl5kGc`B7P|w
za{!iuA_n)B*q(U0XkSd7XFJV7kQe->SNjuEOe)R{T8ZjrQ#9fVrB)2kUZ`|HtJdUJkb=oQ21oN%%YN
zD=)rDTmbqpfZeI_rIWDCL>rmq{#55CA*#H9gx}YX+PAiJpz)8+)r7HXZ1z8d*_qM&BD)L%eMy9m`d#)x8@x
zZ|tqcWBu2!f3CK;JrXb3B&*kI@P@ticuO?imaM2scW>*+?dp$9cBjb8s-%GY&gFI4
zD$?FWdu^;T)wLP=c@NO9cA#GYtQq+Xi~{O(+%8fQh_T1rlg2Cb!uIL6pM~{o$_>Am
z&ZBP@>eZ`hf3K#C)lF4lD3UW$7_4*YSfB5<@?pmIndhk|aPZ2`QKeBDAD-`OQ*g)(qLv}&H
z*%!gRe}}LER5QRFKz05)6LJKM4jV{?az@_aowCz9B8Js3R2$L?L#Qfrvh@9u((ok;
zqNwn74P|sh{h=yVpbB4RC@~W7hpjA$rwD)u4Azj>8#Ga@PusF=7RYDqZWG$leBtZl
zCZkC&3*%VR#rGK&+YzAI#(otcz>Q2
zf5asmGG6#Dxt2Gr9IP9fR26>-|2e8A0&rb;)aAlA!-^tfc3BGJ9rVf9B;~9z)ozM!pFpR7K
zzA>)l=uco0vF${_3SL+g{&b-+fSjar(ila42&O41Odgy@M>Vg6
z5|@}C=rNn{MVl(Md<;M>e{dV%R_Cu%{S+se@ZT4Lk_0g;krxz!AvsYf1PRP6
zc3a#M=l2CgyTh#zzYM~ClPoJ*O>xm?b1L)oA&9ItU7RDcIt%h0r?>RFTi-{O6V6cyfHS4|bW_@o^vtH(Je=c^znr8_v
zXO$h#VhvIQ(eg|Kjy2#74YeIrvp6vQ7eaU_M0ww+?QeTg7^1LbaW6F5z&gHn^LTM1
z%jv}C@r=GNItBd3=5cq<#5?c?$Fq63UI;B{&toCnPJuORy>H}e`-Qd_^Ke}?S++wO
z?Pnd=@(>1^$+Bf-fG@pFe+PN`5efwbR*TqnSVkhVlE>}xn_KQ1?!9ifrv3VV*>%8P
zzbezVZDqZ{2?mOFcaH98*!Jml(QkgXYqHaS*_w{sZK@zJj38{x_Ehxj=osA7U(wUB
zW|P?nLo$K&##P!Bm{JospmVld!5&`%m1C(L{_J0!+dcc7&<_wt4*tjf6(E#SqC!+oC
z9%(QGhDYfk6iR_09GTMItOd@GyH9HKqHto)kk_Wta4t~mAuZSfZaXq%5jST0VCdDn
zcQF%UWxE~0$X}%=f9@SmtnBHDaTd4D>aj2&-v!CLg{vIs>#N*;_gLlQwuaGMpgq?e
z>pHNaeM6HIf9-}-clOB9=J++7R;}dd<;A3K{!j7cVQJMJKfIy)_Q^I&RcESjWbIh%
z#4QkAYy>)}2FgQ*X;2AHFUA&5Q`bLg$KS^KoUK`AHrov-D!1r)f#
z$-L5EPyRU%7ny;J7~m?$@`fP|hN6zar5_++G|8<0|tz`X=lK>!}5HC+70Id&OpdGl30CgM>h$)hDyB=fV0L(FKHj
z=?bJ1F%?_`=`p-WBAeEBy#Vhqu4VID#3?UaApWuo2cl6OBuB)e6-fYq>
zi2U$J$KdV1WBfXt^
ze?=-&i3+sxX4hPPbFUcp#|f-OY5{tIR$p8DdLFF55?Q+Eb^~*uGt>
zNvIfoO{?KEUgvUrx-GpLy!Kh68=*6`@5_#?9wF)`bCbl#aFrT(84&YohPV}Td2lII-vgSFTC5+?N0h`0Fq|$^
zSWB^&sR5-Ies#Q8!X6)4cZeptwf6Gc*RK7gGL(D-l57+C2rGN6@G0%yBbQIyGgg_}
ze&3eWcjQ>BA0i*aV=F$9yH^l=acBB`
zH$XVs59GRTp8|+yMLpo|IN<^H}xtXrSHxmSWNOlHd$OcLWNR*C)(BC}z)WAOl`5g>ae?NDKx|brJq3{v&mSWJgsAH0@;9P2qRAHl?lh}!
z9R=r&m%7{^YC+)dSR;}JOCE_i=a2b%_6+AHS0)9PXGjA0
zuEx>5x!vEswz+lhf1?vuKDf2!F>?RDwoUCJf*@kSftyBaZ7v&Yc3Mn|DDX~IX}@{)
z=Ifuht-I^GFK#8bdFTRkoz^BeCjB|~>uIOA{Utmz`Ljf=a@lWD(fBJ0=L#E+2lbqaWoXdkV
z>!Ndc{ah5vQrQpm$je<+sUfxCm$VK!ahL*bg|+$O?uv$h`FV~v&=&D|SQt}5V7gUH
zNN)}IUELq;pXj{=eY3aVt^rSn!6a^{Hf8nNfZ<}^a2$CH#7rI
zO<^}_yH}^Hf2wSeBt(rFNY~Xn+Sk;|PiUdw
ziKT+68aq7hTAq$O%p}gr0T=u(-ru(}w*9WL%J17@Qq|Vc9b0jrt9`@rOC?p*vm^P_8R
ze_Imj782dnQcFS-7-1s;25bTaNCxc0@RE3omzl)D1{1#|Gm~@jlDzXWV}mh}IC+zI
z4)GgL1|KKmIB~YI&&*4l`1DEq@@DKTmfycr^&+(Z+k=o=-KzSl>TdtN|GocreKE)Q
z5c%>d$)Eze7aq6?%aLM@9Nk)%Oa)%Te^W@F$CBAI)3;}>WUiIct#EXmLIRAA$>#b9kAf}NIp2T0>?TnB!kTn@~Ip#4p&Stx$qEdgV|NaVZH^4iViIc~aECsd(Xivg>phe3}@wC}3Hz-sh4-0)Ak^?{0i1@IWdBGr%F@3y23@
zU45_!vp5cno90^K=-SA8x#^w6Hud!hASnwuM*
z+y-axJ!kfGBP%|v9^M1KmJ)ES((S$b*wSh4v$ao__HJ9M-OU}SE>tHuf2$*34Ocq>
zYc4s)4W)985sf!Y1FUDd*BWlmY3`Gst?_X1yO(Nw>+lXZKCssC3QW1iGj(e%T%^fX
zuQtusUk3V5v(bKPrHx50KRUkst#0#Xhbft6n#263=xOo`41gX9cWtLA%Z0*eO
z4J;r5d#qG^SbGe;gFn(2e}PPyh^@Ga^xP)mIqEQ>B)q^5Y@P8zX|nWoCTF#Y`8X-Z#Iuu+dYYE>$&QMV_`Dva0QLiraEc5ND<
zWDdLJpIi|*Ld4|?+Z76X_)pnu(G$;}a)nZ*w;6mcnOp|!v(ttt%DjardXhMg^mOy)
z)JGv5FC-U|JaDUyTvR5(SKbRv?a3V}H1CaW$bXd6G0f<(+MeB{sRmAQ-9$#@chN#>3Gn^EDohH=3{U^$}ZULU5wv>J9Vc
z8tjp@nG@IYjCo68ZRVL3@eFCz%E9aDkXKZpxE)QECBV{D5U`Y?lp2}Q9&v6O1T1yj
zFiY1{7tNYUv^~dH9v5`zcH#-7L)!!$$^zqjdmwQ8o*d+{e~sHX+-d&E9>`{HXKkvS
z8?JF&e-+qh$vOKpw!Jxly@swX%;BrR)B?SF9`e$d)+Cw?!#!|AOF1L*jyT%
zq)_SgdZSY>e^V$;sY-<&dS5!Z^0=Urj}qTSI(hHCi=WvE_3vN+@ahQQ)eLx(OV2_^
z`5s*ySsck7KXPz$*Qw8NkJL_-cFrEG9oI3(xqa37>I9(mrT*zO*U^Y~1X~CdRAAjz
z(KChIYjRJ~m?s{o@o?1R2a$cmQ^Igu2?Eq0BmLGPEtR{vfKn
zR%PGSK-IG)Lw3YRjm%&Nd_<}TMS+cBQJ`f&6m(X~uLB?X2uAF9P;(BDbH)o80qN!X|ggO#w$k9MEhI#6g|G;&8)0@+u2}{qmkDtD{A~oZJFaY(Nw(
zO05=%;t{o~eTwY^ty;9$0w74M{qwexiY1KxGO!t&iT%iCc)h`r63#K3?Lj!LnDbqK
znTe9ARwxJYf`*-AM8~e~L%&?N0G5eT!BpeH(c%III^I?flv`rt4;m8FU;Yr9i(+5<
zhtNy3DF9pBe*wCA7e=iqD(2=oGhVL>(e2q?nat23v@UVi&Q3^3cd0mZ2O#8a<(=Fu
zwQ8v|I8-Zfz11d)Hk7YUR=g+yh-(mkyky@UrP~03;V9KxYCIgLG*si8MzXbP+4~{*
z2iGg+Uqt1hvGQ0xr1AiU#hQXz`+uT#v{^*ND;2+$d>!Q&9!LIgaU3o~sP_efMEAaZ
z>e74{0WB@7S5HBY$Fg&>$aQf818l11DvuND8p}yh!Z3&3;X(n=mVl2}ARCQ;;s(rf
zJJA3RzCMC0Rpa3pth&adQEUPO@i2+j>c%##X-?XR%(-rgnLMy2NmD*F9xi#*GMbjk
z8Mztebh>;x@(DStI`J9hzl4w@M%}M^IX3LF$iP7oh29g-u;sl)H=SN5jf2VGob`D{
zM8tYU$Q&yd#LTffpw}v-;fbSvQ}|EJvHQS8heppvYdjub_8^LEWcA9oTq9(E6?ZjC-e-i`
zj>qqh_0nG{^j^TM(%z!yT0Skz)kViVKq*^Nd*ta*87A?98YmwMsm$y~e*p3Uw}QeE
zV7&oj)c+F6hZ)F+RB}r*L$9r?vu%ZC+v385+u~ZS@G&?6eY|IV8G;xEJs`e)nEnT1
zn3y7Vk}R^&7GtUm>jcVway9tj)0@a@xvOyby?0<@wIEaofY;Y9!ao&c)8N;lMrS0e
z(@u%5lkSqqU_M)qvasJNYQQh4E}7FQ>q<#r=C;@kQ@8W*67xPiIBmWoTvUPAu&z@^
z_mBTXJ@sOGCK-EK(3888Dx*cC
z)0@>Wk7u%*92@pk_r>!e-Q;~w-Foz!_mvId!T2Es-ms%sc^j3L6gJ(vcgPqY&BD3#
zN#Irf4YN$-Fvj79LO0pbfOZy28k#Vl1q^5~-&#F?7+x0v?IMg_RBWPxe^X*)T~7x}
z?_5fahf4K?4$z=F_9`w+&SThIdkW=o6ny<~?2H<(ldf64piloz%ZmERF+3-lWMU<9
z`LmUqubob5EGDvkPmst@SmC(Zmy`>38}sy7&Lp{_Ns()+(bY38R!M;+yu46?Sa!1U8j_
z#v|MBDtp8k-JIB%appISMMW3z-G2al>_`j_c2HyRCwzyEhQVymY0X-L6BrFEG8(sr
zdqal7+a8*vxz8#M?;2qp_4i$epZ(N@tdID`{BytY_hau|{YC<@Ft_f-i%YGem3bIsbw-dQE)PpqO$1^c+#SGm-
z%uJvSn2V@(3Tp(^hYR4GSQ@DWIDs)EKTqJ>^9jr^rUe9%ZQV=Qq9`+-;@+|^Wm8B<
zTBeXmgI0gWqZR!zlSpaZ-V<9Aa;3&#)IfNB#+>3R^#53^Km>{CHUl&$gm*@No>Rj|
zy$GH(((-tMghJdQ^rzMbxq-*H&aGejj)fWGB$y$(iD!^+rY`i7@hq7w8p+A*<@a7f
z?8*w|gjvW>HF`zmgxTk)C=npk0$10^ZwHfxgH5Ff$YeZuumKeltGG(_B`>thbp=cp
z89l0#%e^MrJ_x|pe6&qC{Dwh)Gw>17cm^#`o
z5bsLk-GqYSFkQ^hM1L`
zhu5~^z{9R-+3_6t4sclXr1bp6cnDQ_kBkqOQvH=w)!rm6%}~mD0S^~Mh5|kv^g2*q
zY3I2K=y+VB`tBJ24k7Gam8AaKk}*hK+WJ2{rlA4L@+a7~6y
zj;8a+>K+S(!(iQdS@qF>O8@q;PJL=-q8!?GXT{s_U4r>lzRTKA8uRI0Tc;hFkyv)D
z!vvg~s_6d#uIGr$i0eAcb@)SY1y^%+oh~47)0#)6*NYw@YQoUee}R1GlHe2~FHe~o
z@34m|BD-Kz)j;Iew{XaL4m*Y_zUdsCqPQ+UTFJk@Ygi}r*~#mFxP~pn1Vr2gJwvz;
z?H7QG5Ow4QL`PR4PR5L6+yHS$BWf}tCnGYl13^}{!3Te>Ej~C5Zaf(!scZrs_q76#
zf0I%|JmO0_VsZ(v(|(yG&+Ep6mq|*fnuUAQ1hQu8aN-N%KMZ?9Uf^}(5cY(sSH<24
z>cO3o=fs_o{$8aZYf3@Zl%gF}3iMH;
zFvNm4NuuqN2)7yUmu$OBvZ9|}cbDX~H%WpsueV9Ejo7V!ze)13#n{+LG1Me~W{cA(
zi&rOSQm~%)?<`$tlVmA6cK7J;_C5#s>pQ=7Us)gM4z3J~R$KCGF|_+w$8g+Iz5l7>
zo9@{=WCF3>%72}kAKH5o#m}cv{0ymk30rnRUau+v)ij}0iyKUlIZnVm8689y7R08`
zWWNzQlZhRF%f!xP%A(Q|uBbL7yb^sH(#J905BFr~C!zb&eouw~Q$Vc0xFth8&yhy8
zw~ldrKiZOk&TZL}(SUxq@fceHHQj5L)k~yvdrs|)l{S?-U@tv$yO4V2f=F5NYCIp*
ziF-3zqv(Ifn=^39YdwmlzKZr^H!Ys9FcR)LPhy+tgeU*|bN@o72_4cb{Hs5AW+8i|S~(QmN2FJg%AdYSfE>
zCKXbT{l?5he_>*J;u8~3O)yQc?EfLau_Hknf!lXYtKixZOgs6rq8DScBUE-MwgNOe
z++qPOqw|~Of1vgtO6WqWiz)%6HUh>gsGm|(>h#b1ly4d~8+I9%3^ayd|0%>tA7|gd
z2B8kVEULR-JH$+oW2VRGJ
zTRsT(I`v}L;=NOy+ctHwN(sbPPZVzI?-#Rf2S+j6Y~W+hPDuxo6I5R2=N&4dyJ~pPyUS9N9+JJA0d{=*Di$OrV|gqU~NEW
z*Bu(!H)7K1Oe6awllKslCpd5Ic&UHKfzrgAvzupk%`VN->Dlz`wyqZ<2gbL(QJQ=}
zSF>{u!>C7rXRYS#e|os!nn%gDm#-M{N~;lr!`UV51iX3$ZOsQmf7f_$thH#>)Oaf=%QmNg5)S>NnD+D+PEfSvJn^O8Be@M*^Db@7`TUX>U-Mn}r9NRh0G@ETVJ{
zS;Pz2A~KX{5v3zQfAbIEb>#Ej;b~+D59AJL4=gMk(9+H+ScSDQ3)eZ%hn;h9-m&hT
zPZ5jk>L@bNUnd7!^lUorF+x=B?OMrBbLl|^C4ohVvNi0aWIF8POx
zIKK4?o}5?k}t|L6GO3n2)GIR77WJb5e>NZFxpFm54V!F+m;W~#;Y?7J1
zFxjT4uNdC7b!zDLhi|0<^*q}Do8CDZp5ICxZ)7!5$0GU!pkk8L2&m!jy;HQp1$Hm$
z*Aw=V9{h`kWCdzigjaK8*&V$a>pkM$`(3dQHkdPze-Q&2)sr!X48*_(8vFdY
z1wR?`lRosRj|}<9sE)kTPx>J|fx=+n{5}vb`(Ym>1#q(c5LW`egZ%Qt@zvl&f2`tH
zIV!4Zqvs3wMP^+n5LcBvtu7Z5&dGC+R{eUl<$Smed`MvKHHvl5^
z!&0PpKiLOg!)Y?&CnG*G;w2*x7TtD{7>pgCFZgD(E;!_JV#|e?HNH*}
ze_d#ElBCf^jNl@XWN(t9fT&9FWdO&12!V1EJK>dp|GBt;SLvj6)`>Wl81%CZ7n^=%
z?w2qtZ_^rU%;W8_tLbl3)Kj#^5%+kb;N8j}fNcZ*sVe{+&sQnxe^Ux0&^fPBPW^}?
zU!fExzr*H+oR*n&4L(z!Rw&**+Tgm*e=Jj|0Mlg}z;uNIFdY`h!OqAw@f{^s0ttu%
z&71%dkRiT|B_Io^V1NiT(6XhWO&d&;HlPa^A-bZCvM0Q1VJuVcE(R3`>rMi8m})w_1v*p&zNXs(mwp`q
z8h=*amXoHa&mA-?C0AdPC=FhxJ8YyBD}P98O=^aQ7@PZ6J`dr28MR4EULwD$HEATY
zR4H3IM@~y&r&^U+x3UQB+RADAB+6KQwyi=wp5L>**w;VQ70fVt}`$QP^P}Gm4a;^N`S1e8_
z@#LphKA|_kZqAfMWl+oDXDi3augF0>P=cVME`LDFvUWXnz#oQy%~CCE@M&#UhyL9s
zWO^q-5o6SMsUqVfQp5o9m&j+6S$_sDlQ&%;V5RkCa(mIO3!m}%oR(9*G})Ohrm1vV
z={yr#?t5H$j6N!?|D%@a2831LTzVJwh0pNdx%ixK1O3PVy;B&fV`hUq}>HAZF<7LmO|&JA5NM
z3)$J2OouoseJECrg+O$v_T(a=N}BpN%)yaNHZ%Q^q0-UmM1LegrWv_}26G~_GM7&K
zx<`YdQjb5;1M{$D@XUvSzK4l4aT3)er9o8m;033_;EY@*w-v2~({x&^Risb(Adr_W
z{+MrBamIE`?8>z)w4@N%t{@G(TGMGBoFhpCHJ6Z18l2~gKgRo(ZHhCz?O44{7u4_O
z-d1(gFV@l`1b+?8FY2(vv~tQA-uzeZDhiqT>h0N+1w=P_k((*c~!a
z62f7RZs=fDIAl)8vs;wH2XZ8Q>E
z_A)tNG;~A)@+UeE2hOr*JC3-HYLB4xiyGcI@>cE&-hXgl?vy{lcOLEtoaH-M@Qsf|
z3lYsJ_4?W<+io9KZ(}b3`Ate9rKJfgjP{PJwHno3QmxZ$0nDCK0sAy%&5q}+S&M?9
zn19w9m6S&9>~QznTyEP+0kB>I`A_~Yo7-jU?VIg!$Q5#pnV^Xd@@;A#(AgoPO58&H
z5@&Q~$bT^+Mi|LiFr{rG=PqRv;4AFhaG9JtFC!+QF>?}I$eW6>u;g_9NNnbG(X!b>
zS-4ZWw2bZrZjD;)E1v3I_H84#ohtfB9|X*mt2p1CL?N+ITgEa1g7exd3$?re`TFwD
zAhIWh`g|QBh8MGW$!Q*3z%p~1CoFn!3ALI##ebu#yoRpQTRg?X>j07Rks7+`LN*jg
z2ncfEQVIR@3yFLki|5)k^u23J=)t#aZ3(?pD!iliX%rJit$+BY9&f)d?zRz6GV1aL9jrYtysgWXv0PNCzCFU9!4bT%LA-$s3p`Z$=81iO4LW`rDc5h@_gI>Kd$S+(a9%Yj4Iqs&pU
zFgxGeP6iy2(4OP#$B5O~`Idw{q|UXfv45$L182f)0uxSOe~^nac=nNsvrzix&ViX6
zOZ{72TKl>`$4mi!5LI08H(1Q&5!uLui1EpvoR6ysIE`3A9w9j6ayp_^B5^Dpg8p_{4Iv@qg)+H;p>{
z#KiBx6E{`3Z@Zw>A3{$hR=6L+PtaD1e!u#@8u!t-wxFr>Z@|1;A`T->?G1v-_I!HC
z00qTGl)%huR%*|UEc?#omxp@exuy6~YZG;aI>*fGdGH?+*g69Ac4Rs4JIA-4u&R>r
z8d|*iJ(MV1M#t9o_WlMu7=Mzc?jGN0OsaF3EKZ#)*Av)SS95zXXw5BVD_d>Ou1v-@
zFqJj0uj;GcQ#LjDx3MeTmvKexs?dhnenApX0BR+L9$6tn!>(xwm-gxCa>(ji5($JW
z3!zm*q|rvTPxDPjG}RGagBp#ehZgMwWT*)|YHxqA921FP5Blx7U4LDJv)LAFR)LRn
zdd(xDhXIys6Y#md1fIqOye^?PtC@Tl_A3Kkrb20dLbn|J9F7*6db8^6PXMQx34Trt
z53XOX*GqjVK79u_y;KQAtH-Ct4_CsU)`d5uJ2u43@O5e{{r2e6Y${qkR31GtlZ;Os
zs>I4Y9#?lc*-`3tFMqP+6~9vn$!|eXj+wB)5J%aW@k$uylKyx-
z(1CSawdO#F#ZgY<(B@bN9^L#zt4r(ZyjUCS6c#r)k{vOtD1eNX)dw71yN4RF4ws6R
zVxcY=>y($L6AF{tyz(vsyI4tqA60|u30Rcv%uF9du}-4<+kdGvjCDX%0G|JD;rUV2
zf8MR?!%;zoe5hzLsrsUBi8i>@@w9EZ`}5jk%yAqT6i}gIJuqO!<7^#I^R{Je_vd+Z
zERGEdt%Zf+X7E)-Z>&YOIyk_F2B_eCPjP#{!#}cX*q%zJT~Zxu@Y`{C;Mb}^+zZ14
zo%qb890Ybkgnxh{KTLwJx5fuZ^T_X`^?(xE=MiuaIv5tH9m*@w<$%uOS+X2$)T_O9
z1tYd=qRK0LJt^(7S4tP^+vt_Y$M1m%*pOt}Vnvf
zl`ZC8`C6;KmAx^mTq2ihVXvQ!)OX1mc!~nX^8E&pCx5p*>r48QYWrn!Ytc=pJ5Ifp
z{au#I_C99MGvQ_BsqYwGGEfHgG3Hov$FYUhmSe?mw&N6!n@5LxALG%v2IVPKAO@_Z
zfngsLBpibrqsC(k?d!pMd%EjyB`r}ephzuL*xutCOncQ*nvqGA?pSX)HQX^=Da3vG
znVhF9>VHr%;4h4n4Q0GJ5PFOkI_SF+8&fuwPN%k7G$u8pH|hdWm)~lQ6?>vX309%j
zD8XM0YDS~i#2ucXjSZvD*+D?BrgcB>LW03Q{EU1`
zs$~B^abE%-M|I{|udeQ{s_we_sJ>6NT55H-?px}XEZMRwTas=0kR@OErm;X&?GTD%j4FLkiwrqDGBxWEm0h}E&2_Y;bVVIDaWSq$?hXb)&`(9Ob>#z-G
zCx81}gjHRyt4gol@%{hb_r3Rhz97GL=^~b8xrMZ@``!)D*t-Met|(2?6ix_s1(F_e
zWHpE)?dKNCNRcG`b&IMS{jsW=Cs|1y(?7!ZQdY>(v<%Irur{5&2u;MWi6|R)j0c`9
zs`$n91X}tl{Q@rV@kb}k`WER62
z)({8=&8~6tPHbF*NZ?Gl6r{Bm^OhCA*8oxv0R+ic!KzP0qce^AxZmpLjRg4=!GBmo
z9#7cD5KmK-N$^v%Gaz+YQ-)4<0gKrp&
zGy&hE0)K^g4!*}6>_&B;OdwcgPo=C0_%azbXq8&5MnhYhHH|EhqQP1}o@%oa?%23{
zXW`AXw64VzW@_59LJl*O&rI#Z*?;#<&+j_>rAsgW{?k4Zd*P5Y5ahQAqa1X(gEkYs
z9pD=YlNFs=8RDBHVGvzbhetHvyK($_U=W-(o6|xQ`*8ePU=+1xVtLE7X4=Sc`L9kj
znnhrXjmB}{8`=Oc()m$VKSQ%O2HDaOY{L|`Q)3q)Fo7vp1fsPmslXr1!GCf&@P!FG
zn_`(9I0bdXK$tBX53`haTr83(wHbdjZIBdoc9qdjzkZr?0@!r`FEwbsiP{FaG^#h7
zL#Olx13o|jA>dMcvJt=W7QzIXy(=Klk3U2MKHzeCMI*6mCt>8>HkY5r>96B|FmVPF
zhtv7xm!X(bmt_MkZ#2U~+J8Vj^8*suxC~~~U(jp-=kQIi1%ibfU>G=g+-PJRIdJER
zpgmx+TXW#<49D0#<2DmNZn~DZUMG$-)A?yqo|$%)Qgl7&$$uLfh$+v@w2WfE3$KA<_%!^#fIvkLgB&h;7$6R#@vn;B_feMY{9Qa8nvCJ>JFG=zxN8KF;eY>;
zng-O!Tg?W$O<{OmV3+tU0Stc$%4|g(5+hEjyQo==!(xTJ-a95}6M^C{|LTmUT1}XU
zj2chb^{X>e7Jp5#1%ri6%K0PY8GTD-{wR7j82}5Y12dm}gZk_Zv!1=-GS6O6(bQNT
zZ)%L^Pf#Td@v??S`0VE~959m~f;Xwvkm{CUCF%-Hs>HoeKw;P3LScVNPf{fr^&A-%
z-ulUO0!KuPTS{kAbnpz+Vr@2$WDtST7WTNqHlxMljQRa#ipivu`Ta4c30zm$l|Vej
zNgPE(aru{~VBF2J?szbmaI&m3fm-(LoQJd{{d;=E1Y<3>3)U8sM2h7w+Txk?{4z?o=w3p5aEIpT4LWP{0Mk9a*%hsorKdb|<4
z3Dlu%Bn140PjUi7Q7q4$4|q!zmQ_l<-k6hNoH012%k#eiJF(wjZp^D<73=U|!p~65
zjN@zueumQ8bw+oA84Q~2ZIFvq*$FwFcqe6+owDd)0C|8_A})Vt#K9i)*CrFrpP=c3
zoV-BZ=MErEJb+ky{@37(#9^p&rL=ZB8nHf&_d`~X;d@Rn{&*$DW2rN+8frVC*qA3!
zAry^D%7w}=p>2tmuHY9@Zw6whH)8?Ro3z;>-a(lqr=(W+^PD5%RA7aPK%fHkXhk5D
zK*z*|h3YH3Vq|{|q$=RV;w!*+czW`j{tl&BwU+nQn#1>;Vtip|AH~C&bS8a9T@Ho1
z8I@&tbvnV~%hY~GA751O+2j#C}uLaeJ!0HHrRRGcT3whW~$%90d8_5e)SMIL;mFQw0iB
z7cQd@in_$lq4$Hn!PoE|(roqGoI#1C@lnz&`)tmDL{k50=8dGmESu>)X5IwHiB-*g
z<)5s@kCQ+D49`DJu<-dxKqLw9Cn&Bx@NbC(^(acnN+V9)ucl^&vll(T8%*FyybXg$
ztL0EKuxEcs3^`8FxSt@|vssk&u;>ZVT0?d5CM7YyT7v(9ZyL=|bNi^&=Z{8xwCI|g
z#Jce=_}nwNfw&ej*h3hA66-99<9p#>ifS2b4ea-T2b=n1M@cpZJV!70_eflp&!=Tc
zl8I+cJk*Zsqv3G0By1AhlarGl;w$0Pe~;6|E-Zfw|Jq0Sdr53k!OU2NDjzWe^KT^D
z#IF6V42v-WgF6T&L-wn^U0Cun?QhyiOc2kviIOA|&k17wwQ#@}4uw>U_JRDv;63VY
zEUbk)cPOiSHAX({P4@1$WoA+QJY?U{jD84
z-u&fHHL~&^(vzR
zy~;?W6xMXqOLet)kvrKX@H@6n1RnmyYvAD@n*;{dmL|{S`(b@=o8-X@%l*&S-d3}ZABE@I6ezT(^^)!RY+rBReA4VwB&W<06`cvYlI$#pO1{emc@Td|
z{>?-A?;JUrf9!uSB10k0w)DG4j*pB^Jo(sCsL>J>gCdIE1Z(${TDxkkHT~e0V>TXp
z8kaB$qu>eeV$|xv$_ZNiV1bhQl*aQB;3-E%X9dneDeUr@0ogmhr;j9fuLJUSBVOK_
zRKVLK$B%p$Rt7d7tmC)9vZF`9iidwp7KS27Sl!2-oPaa#z$6JrK)fVxv$>-%V`7AE2(A&Kca%dBQx%8P2GJnQ~{;bHo|WRL|fH1uNdH61xrmJS{jR
zN#SV+V+}f#pw$HO|7}KDWt6zRxRvpL7Cz;xW|j#8LXtI;XURIUMn#eyZ4`f4@wvzX
z34b$~6WEXOBT#R&AEnmJFhi+&y+XIihmXZiB`cfjMl
z$Tl(gF;0^)INw@TN$p^Bxa)s7CUQ`!bsqPuf^;pNzHkQFX;5z3I~Y$Aepcp&ZIkG`?h1dv{7uwx1Ovifj?MN4!>=J4FsCpInaNUF*S;If=-SI
zO*znflpa-=2_bK(*p!;V<0s%9N%a;sTeyctHyz8uyVPYv$nyzrn_4@hhX{jjH7i9f
zt*=Lh%t9ojl=h9ytzEzM
z`nf+eY5771^Lb)7Y@cE5pw>P$`237{U??`w85$J_Ask2Rjwq;N?%xR0jp}MLvUG?q->g|8#>`*8odZ2h~)hF0r+X$GSVO>IzjX
z+1+;&$D2sX$g|^}Tj!U$>IUjs*7sI3P|G55(r9ZLx+Xn*$8aLhzN$IBeMxHX;N4qV
z?S4ONw)yO`lc#@!(LktuSxxjMLy3YZBWHLG4lsw+
z@9_vkhY1laBX2tYg)mWaKCkUv#fWWW0M5XyHo_XfFHXd&W7V8HhtE5Pae*AbjyE?`
z^*PXTtYUxIJ~gQH1ufIeyhoeS)hDv>@(OhQM7Cm>vQHmGg;gvim)-?hT%{)JBnw$M
zgSxw%*w%f^D<_xzPdjVT5#hsf2uShdlbJH_n9m#WtH=-!Jf$2
zH@DWDxcZ^7M&71aOM`+_Fex5Kplj>=^k}<}ph$mL2`&TzM%g1rV)?@)QNQjEB=`4D
zo+aL(0$4RR7u&2#&$6~0-ZjCwTwF~K?>>cb$;rk>Dgs~kn7pzx2W$ldm}->5Dj!oL
zoKWy$lH6%^AjD_BAy$iy3U+aKPs_~y}cRFqTwyT84?
zw6A|7B^m+EnV4wPqMFsWFN+hd&P6LKx81X<^hu?0xU-~hUfLDRtjTn&ZTEo(hrV{>
z{8(@Hu5Ybg^5}oRdvmMFB8gr|n*^gpuq@p7oe|!r@J$=VP
zM6J{VTj|Bw=-92IW4DTq4hMS=+%
z?CIg1>6HgoRyezM4WGqpq5Pi>p6PW1b0Z6f1F@h{^vJHDJrZ`t7GygcHg3~_6JVPm
zZr%giU_}8ptMJ~8dC`*SqD*wrqG*P&KCpVloh*=8u2auNXJg
zyXV(yxVa=yF_~2#FjM4R4ma!nFJbeZ_Fa!&-LYduGjF5`i`i7SWUQ-mLsuxiWcR{7
zu)Pd4YccImL9=$Su6bQwHG@{C6O_TyymaTB;X77A&>U`=Gd7U8ZN;I@4K|;Tw?GX&
z;`T@Vq4uGg`ju0V8Op3|DC>Wz_lF>4@@~86kT^>u;+}#`L+#+zNEQSp8RDOH%v?Q%
znGPK@!3PjCnc%8YcM{Ef5+Nak%$iF=rg|NUnBq8*)vknyS@W3@llW(=bdOOEs(EHF
zyaE+H8pQ^HYQHs*@CPgX{5^s_{~*Y>f*;L7OrOK*b17z`&%mjBB#eLO?<^wbMu?dA
ztB85iOvFT7tmg#eVzN^IG-$ypux1E`kV#bx&!S?2Mq8&L=LEb-h0J5wP&0&yQ(5)C
ziy7E-=6Wgm6{0T-pZCw*cQo6YU0Np~C!movFy-^M_RJX{OqLGbysT|SRE5tr#8<6S
z-W#4@Iri6bcvE%G&+4wf9ICo_BClgHxoW7yl&lHa4cL6ap4(=
zp0!vH_JSUha`JS>!Q%_p_Ja6zX|O2`=A=Pw8bs0{ox|s3tenTg-Bbs*)qw?dpt%mj
z>j0Eib54$9AOIU3Z3yDEuy3c}W3WmNaJk8kGYmZ8nkOqOsi=Pj#a$OcaeVY=@%ZTI
z+v?696_wRb)oAMk1n0`;$t=8GjuybV>k7b`z7lYLrZ)TS9fLQIw3P@_vj2u}Z!hV~
zR9GN=1qRl{M(Y>Wposj0t7GA^s;!4sMxSuhLwN4(hVYzTozARo_kxFpzP@`VJo6H3
z=4Fct(4wVp-y?rIK;OBxc}-^o0rdVSwk9eEH^P3{4Ey2D+4$U`;&X$F&z58SCJ4Zm
zqtw=m@!10Lc@x5C3v7+8SB}qbHbGi{%|qF`=J7|z(ea7cy!Fjp8|Q>d=dEu+M_k$e
zlS6$Sx4ry@{XaR_m$~hg`*wY8ZLE3Q{Uh*L*0Sw>6s&)1@?-EOSqin+=A!m09}lY9
zYsYcVMrsSvUSB}#sgck)#v$dk11hiR8>GCxa2egTuvQMd$v`sg@Y{_4BG@>nfH207
zSlQv06u)RtR97OJ{A>3!xY_Fv9U@15)nL+`im-ko5M|?JHP(ua6;O8Fl;--mg63L#
zvc^s)Hz9wuweBdrSyNk^F0Z!MW=vV_4y3f!LA>3pE3HkJR$3cAS!uPyN*c|^3wKy-
zW}0Fo^G~~0)L0#fImw!(>9`4PPlDQ%Sifjp-LhL2m$^E2t$G-|DT#AMmt>-$#JBmJ
z4)d#BW5a#HP)mj44!KZ1Z?jc23qG%{V!?){+6{j@?_B=PQnc#_j<*sObw6J~-NuVh
zHkx$hvv++_bq8-bsUw;87nxE~>~eMbe`O_cqk!tk7lwBWytv?a~i2i7&L
zo?peoNz1WpdFN`=I-kGXd(Vak{Vo-w$4X{BM-7r|@
ztLuMDw65)pfbyQ}7bgUV3kBG)2Aoicx>B97^6sRQwm7Yl(?Yo_yUPL%Wr{20qAX6C
zw+Uw6=dp(8tZ%O#nv-A%s=RY0oYm3E^TYu%0^y}n*G?;gd=5-blu{Iy%7I5RyuH+2
zd5%m31%U}}WVWcwj#5$+LfaWon-L(+R-S*$PPohXjw}Rw-)qOYevSn
z`gfB_nezKHk#q8<%!j(j*ORi$Qdu3z`ggPX<#Oa)R^CKqJ}jbue$N#vtdEMSF&Mq>k#k&SZHk(Ad
z<*EaNp-{^r#8C%eEA_)xLKf%tf)BVJ;$Z-{WlWs=oVcmv&$FN~!-?*5S#c9p^5;vS
zAbD97>@Od=Z(H~FrEO8MY}J2#S8w^-;j+hF^@H{4ft2K~8*E4qCPiG@^U|Sy2==@0
zU3T-25B2xn{nA}KAG|8ro;|!A9usZZ!*KL}5h6_mM8YK2U(i&gQ$7(YsjMvJK;~q4
zW10AYjxETZ`@A~Akx5t1gwYilCJV2j#Se;TGR?GG)KhCNtEW~_CYFD`@D#vu#ON22}$MhY?!N%2Ya4-N3!4#~+I47^j4oPq)W@N*`>`yHYk>TnMcB!QOA8_w^9
z6MJ$J+X&yP7WM^A{G$m)##j%rBMGsCCSEn6zG|NQn8;pig98P9;#;beOP(X+S0?3>
zP|C&s3sO$gD6%rY-z0wr9g1HzB
zQ(F`Ic;d
z2kHgM4ax_fCf}0HntThjzmrvOp_C7oQ?7y@@7a+=SU$$ybU*KETL~nif&T@DCU|qwaDmz$;
z!o7ymt9E>T{+zo$f9+6>k>gp$EOWApr&%-Gw0>WYvpjz_v}+(azt&UgTz~uGNJ;C$
zqJN4CVpc4M^=cB$hNqxJ^W&*w7~{$T<`|E%yfa6sWx8B@{%y@x%cE~0$6tc1m<;6j
z%P!0DZ5O+!(tDq|<>nLDH@5Bl{;jvb|C(?#sxuq|Kaz)yJp!V
z=f3gfb4P#HEPM3agWRE)_O~p&^O+s`vEZYk9FXPLXd^#}iy4zcWI5Kem>NRMht84=@x`ybl;+o=2-GCf#0v1;`jSbv0`JB
zM)8v>#b1Ibe(Wf{bUMYKZBaX=-GqpKQYZRLRHA<$gG7Jn45EK2^O}4G4k~0{Yb-dZ
zK3=i4LG(c6Y+l=wV&FSdIBgP}mu+uf{l(Fweco-?oWWDb#MUc$WRpSg*{wc@!wi^_
zdv07Gk1uQvg-U})(QC6fM2k=oan+67)ZKpbp(l2{W|H(cro?X8O4ICYwHGn|;c0d@
zR<(b#y@#0l5<5KAhvk*p*;via_MS@pmmoVETO7E5ZT7#rX~$zbI>whbiAIVrTiDux
z?Q;vxsoe!T+gQ;#wXV0uth0Z)ZuwZpsynBgQ()WRU7K61zJSGS_1VL2|7_nBZwO^p
zG$7wps4R$-LERPW&+M82m&ff5CItiVH8KQz`PI2Xi_gdjJaTt_04w;K
zAj%~Hr}jc5;sX&ch%05+sw=z*)w#GjAXsL4j+KT_Ksi%&&R8Z9Uv=@Wlh_y`(3V+!Lg
zrGEU?-DJe;hZ)UHCLm}hNdTER{g;EtO{ROvRD6F)?GtlZJ&5~2nHR;Z%H#^>>I|@>
z*j)N*DGV
zJaVl{7gSB>EO8Iw3t*lm$%kP>dr(6UgDN9z$|@vws?^r5Lakku!|O5(A{2`h87$18
z*lSUENfZV8Dsl{?P>6G`-swhny7lP*2}t6E8fpqt^DIH>V$pwxy+xl%7S!D`>^w^g
zO0m$P0u1DUE
zSBof1COl5f{8|6~b!i&$PslB5)xtwx_&q0>DYRz={FIV?6~17VPq;_4<-eiPwDDjx
z|EEIuMj+6FPmz&FfRNCZ3kq_z^Dl()f4k7Ec}C9?_d}l6j-A(JYH0%~tyj~#5UNZ)
zsfpAEU2cCippcd7m>)ck%H3&DA+KJ6l^sHQLYG`9HZzS)0z{Z2BoR4h
zy{LtsGz4&hO
zby$BQ>LqLOUT_sX4of7xWCbi4QA=c0qB7eu{0+QM^=uX+0~}W)0~|w<0iNS`ho7Tv
zz9=%lb6I{j6@D%YzbcTyl8edU3{waGM(N^PmJRJ0h{gudvA^_QSE{R`y1QIdZImB)SbeUmEbyjeqlB4_pl&%
zVnQ`^vV}Qf~TC)vnxL~p#-wfNdUb7^954Pz0ClbL#5UYR5
z;hh=AUeCg>iQ4C~@B)qHsr992`6@5FJjjl3<}CSg
zR%9u{XlA}r-4C)2RPawGz)v&gx$`4)8zXb)
zMj8o=GY8(wxG+m^dB*PQDL?X$zTfz8pO311wqv*b@AUztijR2HCH#}_USIi4UD0C$%@vtNV+Nri84-5Tt!Pyw0*SAyJ%soyVhfCT+x^O
zO#vu>dGVeN0#10VGH?c#OjhD2@UB_*dGJ`l4)Hl;pI4I4>Ueb{v*(lS^NNssHaqRo
zS7Uvg5JyQMo+m03S0Y_y0B1Bt&`HXC@!!iVaA
zV}VM)#VFaqLWk98aag>82^{!ahL9y;6>NhC;LJ%v6<)PE9W8ChfhQ*zMPX7oa3te^
zDtoO^i~p$>)IL#OPK8d3yIX%atu;n>%(BCm*FKSj7mA_NS#dYj`oqh#M?p-GpKgc8
zABgm3dzNm`xH(^K|M&t&syx6Mk<2rHIwO_d#{L=w1cqDYu4#20v;=CSiG@Bn(oj-b
z7vhr*Yv#oouDWBOa^t$8juOhqadw+%GgC&Rp`>GZmDL-`tZWO_g=NLsJzVdwL+ua8
zmQTKe?*?s{8FOQ`D&t`=i^0Y`K}wG+7|MbUQZ?#cmJCZWPh?3&ksi+~XgisI@WMqq
z%IxBdGkiDfGMVMgW^mSQnf@6Vye^m5>GkG6Mju>mWQkpyKLW18e_q%Rgmx?KRd*}x
zL%Ws0W5;cN_BJg2{M2@(W2it$KdsG9KsJTsunajC0sA>G@UN4SR|hDIjHPi%xG-iKs6uymk7&dTiTpf%Tj_>#j9tN@hhA60{`xGc;qde4-dBp$)grT)
z|Gv^*ePNAPBxlSTvlW(64Gm2crLr1yW{rgO*7yux?Y{BUiB`ajLP6~DH*Y%q)&ff8
z4n~n`J9+9RkYxQkuTwF9>SMWhqFrw!+zPFYv^~O{^c0eXkI<(K;54YPtpe?BN7e)%S2B4!j>`{|_n@{Yj
zuH13`$iQ{GBei>u57h5ybUEv{)_3ozF}a(z0!KsdyhYwfeHh|@iFzTPc%)r{1B$nu
zC+Slwq6t{MLOAhu0-t!-H+!iDobwcHn0%F($+kFFl50i3$`p!F)^Lqb$>u3g=~+1KCb>+kn9ics!EVFO@0h5HW{GMKd8MzSWDXAM~X1>aZ`+Wy^9@=R%}?dbMlTVT()cLfG8NZ
z`BKKT5-(1V@&yZ~9Y&^(!!|u$p_1)Y$p6k@UDM8Z%b2JNRg-XAsVpEoJjrScWLFFB*^xr%1%faK|hfQ}21V
zcoYl6Ql$Q*SrA2H}xSASB+A`NToDyQqgZUt|dc_sW8l~K8cU`
zrS}#5LX-PEEu<%->daf#KOZiIcJXZ{=!9VsdWng#M8e}#1dg@6m=rb3@P<9@6t?vg
zo_~k3)*RL6cmRNEV}%#Vr|T}{5zTJ@a`T5r#Z>y-%oyDdPl0EAM^TWWz!b_hM#>qU
zOUIW2+~ZTsDolD3Fa9`Nqh5n~&<@T%@3)t4QIez6ABbG^GD!baBw7305o7D)}>L;eMY^Vz_qjYUr+4BGb+Oy;kBy_G^5hF`wJJa+Y
zEKN^g9bhU>tZ`2`eW+PRs;3-Nj&6Vd4bc>E5*$qE3ykXYyq
zRY;(Iss$RGqk3f!$Sr2ZW-d3KB$~E<8=dZA%x~a`Iu*n=*m<|2%n6z2C3P&WP^eI;
z<*pgis0PM}FW}D;3Ui0ml*2-*Ns#m(9r5)`HZ?cZ*telCP1323b*kXizfBR^5w2yw
z5id=&rTi0ZW)9n2lucnBQ#K~=4mXK8opLdzTlzQm
zGPjYja5mlMJ0#`+yxwQBeYEWjj*mkv#XsD@p1CnKAF35$u9R*TaW
z64B*=(m!e~Ja+p*?QixU=iU$AHO<;9HFQAznifmGoN<4DdrOPg+xj#n;>ysmxJxjc
zF@o{R-H!BK@Av*U*qDZ;!6L?`wwlk`TL)B-Bl!)cG}EAji!zm=(HKDZ;)3|eoS)So
zVEoblr*EzA{`+7JU?#MzsGTCWF1s{II#S{~6{RriwSIf^aG*w~lu)`zEm%|RJO^|b
z`FAmB7+q0HrpQIV!w7Wu;RgK$Z~qI&5F?_KK%`37_ulWy_sBq${0WJ$qwcaf0{dF=
z({x@#G+jhr8@ohzV7UbgVNfh9NK^y6IvirojMgj0KjtqrbxOgg&&zdbVcB&BfG~M>
z=d9UVZBsRQz8TFn_(@`hTwM34{{*<&0_W?=Q|RvD3J5q)xK#!V8B8-A@2Jwt-es1z
z99hMCL*YUt0g@EloBAeA*p4hLt5iJT-6VDK@F#p3Y!c#se-jT;tuFczc@*NQm&Y7&Sm=#v7J(@#o>yF34mt?fp
zJ4v5D_q7GRE@b>vJI^!$WPw^8hkZ9(=v{9?{u0fl-@QVjT)16*v#btCFvw5bNz2fD
zHjLgrF1cYTJF_hMav(TK^737CLmU5ltkk7b
z&_jG%@z~)8qco5#uVuVpYjs>|Gf0!l;T<xdx+TWueJyfv$b4rN6YHos_`PZ0b}6>LGArT32oUq&H5l+S~Of?|_eorn0HArJ5mKbUyX
zAkL0X?^_NxD{yJbqp0kxN;>Kv9#fU4<*scOGQKc1R`fx{Y~x7NAy%T+@2g&+HloyK
zhn*U5U1CL0JFQujTFV-HY@LU2lOQgT`H5QRYU*dpow_pxUZ$MT@h63OP=2NYEj#)k
z_k@;DpH;n8%mF;h?KNLsM=UtCDB=Xe6evv2DP~WN0`TGxR{iZRFjN{}_ze4NVz_0$
znUb}%`MsR*XKr5=iUkLWlWVs)rx`KgszTRJjJr?RoAx(FVrb5anjO1GdZzr&tFup!
zkbG`@sQzMUpMzH(DIqnih-N&Z>Ul(zIxsGgrBE^HxM|Z$I8u7f;e$HdnXS7%#Lz}(
zK%VmtIWGg9bV?e*p~7Xke8s6zRx|z6J_kq<&yK>is@_cq1UyMU?-jF#!!KQD6#M%HnzG4iqgv#e<%e9#Ik53F*vP3#Lsbts@wT#<(@>{M%I9qw
z21whi`Lpk@dU2nXZ^d#dOYj9gmEmR|PFOcy<$5|hq>s3=qF~oc#o0iM66HHCHT~Z$
zyyV2MDBn6l&Llh)e#ODd+n@ZX3;c6?RVP7QdHOVUygzZh$w!ncOM4@N)-$`@)f%u^
zm`JSbe7AN?YrY=*oK+W@8zcC8BjGnL>jyBk!?A4q*^?*%@T1{a)M?1l1LN_5|seE-1P@Xp>VkA@2edxp9bgL^28
zUmVq!lev1HVdww)=5oN4dwYkYr&4y(lgjQ;PUNI9QED|8|9HufpYEuo`iI4i!yJPp#0~$FVLwNW(mMy|RvAG^
z=-(KJ;&M@AqFI7I3!501V(Sz|`eTs6sXrBHls5Y%X7%zu&*8q-@F#XUwce={UbVyS
z&h?YeuWB#eolp4^wBa$z3=A1c^*7*Wp8oFnRe5AJ>Qx<{GxNH_IeUdMbq61FMVO|t
zk>-a;!fEK{EMCS7@#u+-mrj393ip_3-`US3Qs<3aClOIn1Mz%_uOR`l)oKyG=6A#H
z$f0VA^wCX5#$7K&+Y^=v*xON^T_%UvAh%L1f?Dl}VrYh?(5E^K6{-S276)+RWWe$u
zOgYs+HaX-$G%ufJRcJ#A+e_d;=y`%kpKq4nll?%WK9E>cnl3q!jo^3+C~14A&?8Uh
z&sArF*{Dj-OMvRmQ$y2d`~7YWpT*7}2;FG{(G8=#(nC;2MAF@CCM2>!2@!ZIiM4$r
z(8#2_R%vI77Q!1k&J?JG$PNgaIGpgfb04>`JtRRu1h$AHW=Rd4s>f_ZL~UkyM$C;v
z<1{PP=rDS5M66b^S64jxKpSQbVE5DvQ)*V(Ml6%KPTA^Hw_^Fh?LmmW%YX0w25wV+
zoOaBjtDYwwd|XPP>Ia&op2MpWYNRm>^>`o%nAoM7Xw6lfwIx?>a|HyiSSH9Vh-8M+
zD+fE%BlW6}Y_3p!q1Z|IuBmgoXtQk?9OcjvYq4}m5gn4{tJ~1>67r7s2qY}svV)R$9;oW)+LkLq)`GATJ`$wR6rD%dxQj{7^ZB7R;8+;n|
z!uKpOe`IQ0Ud4y&T&$fFbFv)L>UX_8*`yyJ9zVA-k5AA}JAuqE#o3f9=HslhnMJSM
zZrz_0g%CH|rd7S>{Lon-m?hqjE;d%Kar8z)g4I8rYbS+4a
zrJ9r;uP2$P>8f|GqqZGSG&(l#G@SYQPIVZG>IDnx&xv&-lI|K`zoe!L+^3dxs^#xU
zvx|b_C5$6RB=<#7vnXHFOpefy)ahQ7nQwS+_-HxF0nb_fMRV^?_+gjarpplQ7#p{%
zub3k`@(z0_o`BY`0k7X%Z%b#Rs6U+Q2<+@hs(J8hBJ=VZYj|QNe*^DoM-`3NZ+L+s
zt3ut?ZRQ?z4OR$2s^+9gnEl!hQftnh_Sx|Co$u99Mnj6sclraCQZ
zv{`XN%#-ROshjrrF%LnX@WB3XA$tzY)#s?(70?4qtW6vwzGKwTg7A=8BKEx&
zm$g0dHx~0JO|3ucPQ1Bt@zIEL+
zSfsjznGR_Q+0uFl-5;o4jTg2B3oAWS6v~+190xucj$$3kZ!1a@pK#TR=QYF1r;fX7_)ZHzkaqP6N!PT
zLBmGaosb5U9OgG=Gy?S|sZ%gGuypRGzuxcu=W>rCV`qa`AI%*9r?v_)b_;F3c0}aK
zx0d*~5N%cptG(Ro)Y1-yB8Agi?QT(*jW8w&1t8^|nmG1d&WsxVF0d?F6^Ch1n|7JC
z$30dJS+SnlQg2bw@XvTSqw350rJM*MBM8n8i~4t;)Mc{S`trUE>Jpg>n&#Jh`3H~q
zh!mE2o8Qc4*cXvDg9h_CN6I8McpKJpr9Oy`dHW|6AY=wPf+BDeWrMdnT;SOFS*
zUO=I@iM;nKeb
ze=j2AzQWqPO`E`yXoCWzm-?^~d8FrR%a7
z{ejU=;xH;EO=cFBX&U5y*Xu+P8ECB^mYBEX_!&;;6rkdA#5YERabU2?1HA
z=OeV$aZ(V6skqS{9F|6Ze?i^{Iqs*_%A^XDsNSS3r)-fdwpZRK-n+^MvuF8?bec#S
zZGTR0W&Roa*RCDt-qHQ{_8ZELFuw-g_P|o_*>N;$+Xr2$4zZr%dK@NbfGMel86_oE
zQYsw18YL2)W^3p3{KTfOpV$WyLloFA`?)@IVhmlTF7giDs#DTK*Sdo+N2*yf?UuJ}
z+nQGexyn#BX`Wgb3}@85W*e&hVF}qTABbgcxX52WP?>%|r8!`Y>Cu;hL
zWew=C4lqe8GfSJc4%N<9u;*aki!5m=W$s1w`2nK~GX-HUmQMi_ecD=b>K<>|xrwrW
z6$y3pf0v#UQBldChkU+jnYRV4ml;eHMulkIa|#t}O#Q*fSaShnN(8|2k*Twdk+H3%
zj;84zj+%iJrE}Koz>+Or@F{-D1z4e9D
z{l$rQA0qU$M$lo9R5l$yrY9K58RjtA73-+P-D+jvDXbr=azpH5YyKi&?!a+cxcRId
zPfT3*3pId>qgspHM+fkRZd94z_-mbH?68u?yW=>ETbIxfavWTQ;G^>VCxbvn$)G@h
zv&^Dlo0E%ab7zWKMw9N5GWNdX7Z}O5>3~brt1*na#dJ<7+C*Pf^oAeXsX&j}$(%_H
z|8K#BUlzeWA4Z$cBLg|g7SrB&GsGl0#EyG)T8bwMFN>YS*G>nc%>@PE{aTfh@Wt3IHMJ{prg019jLY~Z82u_IRrbHJ+faWw%9$yVmd=%qO5vi5>^MhhPmNDv
zcncCcG6f+37F*HKw&g5^&_$l$@@$5Y>L{7qeXx=`y#vIfy|wDrz~Zoui{=vYGCHMK
zCikCC!*)q-SOF?l!^j|JRtH74XpaHDK(6%E;oXt>G
zZJ)ASj>PH4xfkiRgHdTcXOhV~%I+0bAwla|7T-Y2kj;8P?(ZMoV+jyXjs$scg4^~k
z!M%3^hT);kea}gr>$UEo_zc~)q89ovXNI@XCnKYs3H+oRDX1m$=<<7`54Xv>oL9o%
zy}L}Hv{FN`?uJ{#p?JV{wy<7Z_4|zNBhr=?2lJqHT?>hz%AQeY{WSBJTB)|-ks7X=
zhLR2xdJ78iaYcoq;zQd=pHU>%V0>c4rcWgYD!6Iuz##8_K*zSP|U-d6M#*AO7
zG(h&-tJ}TbHY~5Ee%1a=r7!2;cXG|@c7S07n9BoHjYcyWRzoWPf|3<)8lPSr5b*9t
zhwGUKYOWB2t~%!)ZK*M2U_;ss^>_Oj%YSz{z>Y9~cn6&|2-LPyg&vFbd1$>GjL1~M
z{lLe5qI&WYGn5uqCd0I<5zik(H5oro5i^|((LL?}+Ae-kM0%aW-50!F2#)Lj=|l?y
z92Vr#hY~p9;X|rVfQK-Wz_`7op+QmMGtZSlZhoUoHK>L_34dN~>JMUa3QOBCd@PL^
z1SRPHwUL#pm3?K2^cO3Xsj-Y;`*P!{5ZmmiqDJUDKBN4IFX(bLn-Q>l$+7n!{4GP0
zzHX5z7n$Po6S1vi*rGGB^PC0j#j=JrB5;u5|ey&HCb%U|^>f5rT&b~Xsnr}bOo
zgBe+$-GB5p{-xN^18JVq)X?1FNr77wG!M?#jhT6#Ktqp-}STePmU`6~=N9eKP@
zWm1SdzsL6W*8P^$m9(1&FdUXJ{A;RLa#BdBc&?!F>$(XVb>Rhl(oVH~=$+3Z*|1m*
zr1@Ei@R{)L^X&7AA~jij{d`}0|MjjOoQ7Bly%`D|oR3UL>=P6J2uA+?Kl0)NZp1gtaz1uF>{Q9|lV}c9ya{iRCx&QU!6A(`MU!DJ}$%;J5YYNHp
z{{++sWg^_{>3)3d!JF+O_v3aZAVgF88;y$a*PcVqKaZWxb+chtcq@cW;Qt@F6#-TL
zThr%2a4V{onsHk_ID>}1A>~L8Ecc6CxX<8PH1L_j8V6VOLO;N?;2?>qbC>kmLe*%j
zz!bfIILlF*E;5{T0>vmipM||9YPrK0bF~5-&oY#1{gEB0+mN$_C?qgP+rGuelFRAN
zW=#uU(-_a9m$2^-`De8DN#}o!GFZN{RrOvHGy|cnMz|2TV6z`#NqZ4JV%@}28#H-t9g=j^b_BA
zx<@uxCp|n~grj1SiI~yA9dW+gNPSOll3PWa3;eJ@e3j&G(t$MW0O=CSqgyduh(lR6
zBBR~$pPUnVt2?>}S8t+KM%UkThIu304@>qC9tjbD>UJp>c%E1W2Z0vX6g9nv>~sY
zlNLGQx%fg1n>GX<3{l_&ZYZlG^T;8cMAz_j+;W(ee)H10z`WQFU3}57tUQy0cq4zI
zTbZl7(!J-r`5ws_vj^UpW_Xu3@<3wQA2y;dhuwLs^Ax)~NY@8=r=vomiVv^MwkD~Y
zmQtd$Sy&q|;<6UH8*(0JEo-iPDtAsRuAccf!jM|782VER^s!!0^T9dTp75DAL~JpK
zcayJojLlv-z(|XP&Bk`^1h)8ot&kTb+bhD5{Okza81M_*NTRd?}>
z?TQFD{4!a~=YXA0(F4gN_ehC`(W#`}6nDaJC&Ai}{}kMwchW(6prCLxQ2G8j5=?S3hn!*YK5X8T7>)X6n%kPRNQ7hw}UN6p&i_G-lYu{?XBTSu#HmRfpX&qzjd{l8_T3Ru;p=Tog;AIPp!g-Dc->(TDdMgy*srt0m(fsIRp&U@_*WzfgZT1;PUG!yC0;4dsNv-7$6
zv>2AUDsZ)&Z3vi&7JdXAQJW_4buO!ZB$=as$R?;K0%~6Cm>!(qX-COe@3;!7W0+7z
z`i!d;ZwhK(Neat2_E+oHE{JFo%|#a8Biyn2hJ}oc-1B2j%-BLim$Uf?h(d9W0KWms
z2bSmT)_2Toh~XpdhNeS9u8!c@OX(l-zbK(t(*{K_-^cuUtWLD;92xoah>tIf_s?V+
z$(FS;|8Q-rP+b?~NjrQQ0IFf&{?-?r58Fh=81rp|@3~`bB8d?r>Ud%;I7XE@S6xNs
zQrI?Uh?;~`w?n>_e6{UFe&cIM0@Po2Atrm95-zEA1LG5U#NU{gaC3BWu#W{za&B7@MO=Xge!
z=^pnNi>`tPU|j(?fa@zOi_7%k)~v;Lh+nwBOprIYjN}X4x^vhKx@{*mkhC9SciQwL
z)b2dufrwcc50cBBT9t7V<<3SBfSHCn;Dt&qtATtdCbdXAGQkZ@0z0kx6yXz$6dq$U
z+)AMT5!<~v`hcV^7@qVm%2R)itdTWPka$Y^alSuU`SHez@*B!L_!~_362AmCV9T1o
zer`qZ^TsFf*?At6u`@9Oo*nsFCv=q-PgR0VG|wO%;_SnEJ>-k=?O8KcTUy=;R}z|C
zU%8IgE;#-9fmxyhfAj^HBkKN4*62&(Y+AU+`mL14HO{$t*zZ4U)P#HaMGAA37gemk
zH*Br#Ix^(OEYdJ;B}#=7C#Wjhto*WNB35J`qhVP8Xb!9XuI}v%uw)Vm^59xTl}=ip
zaXOlNGl(oCE-nx&mN4qBd1z-N7dQ5}dvoPx=UKm%P2X+Zjj9Rq2^Ltsozbq?<~LvX
z<|-fm=H$;a7d(Q+yt}gvJ&_IPX=S6!D=bh=nA8owUbbbJSfHgfr|01$w%|pLZwm7CxjG7F+BCN=N)rASCDC^BOvFfV2rY$?97Var-bZRO~l
zqfNxntS%`sh)k=<*c`@K{95+4{RxjR>p}&6$lky=_jSl`E{B
zHw!o7ir9CFo0zd*>fQv|vlBL_rAPQYg_fMro5A>o5L`57bzAb!rhy1PbI9p2Mrk2&
zM^P3TOsdxExdkyaNzF$OWEvuD4|7at
zZNYM}Eo8v}zB5y~(9!BL78#DBcH%_kDdw`4P9s4?31N!JnjswrWd&)Ht)fAv}9-7jkIVkoFM{hQ*k$
zGkTVk7Q~I#6B3fKi}Q5=@6G4lnFTJAkWoCit)+{>Tf75t#L}R
za_!1XKkN{BzgJjM(Te*FSVJ}=jXS!QaQ&)#;ebI0*UZDQDvOR+REB{)rQzbIMp2+FR=|2kin5DWkdIbW
z3_Go~NmjquMOO>ir>ZztDRo2T`4sZL4V&6Rx8wOvd^Xh2^Fm?-%O>h!aYSMM#FU3v
zFhMOdwg|KD(k?=eE;KICfQpObzg`j{+L{>$P~3WD|6XfL?}A$(_aa6UU2EsgMr%q8
zGbW>HN-qaZ#VFmwH4prVL?f3_wp$ct~hGCE{!3)2kZxXH0RzS$h$->V7
zaIoz1&{I#Koc$_3<*KiI47s3o7B>guefWwVSmbN8wsAYk&0;pknQE$phdibs1V=dh
zLx+ZahDYLG8Y`TZHUkPZo)ArH*a-ApjAlg!y#S&#N)if!9cCgPACfU!y~`+ti+GF$
zT@s#FqW+Dc5a@x#U|IU7+8za#gbo3
z&WrlJK`9W&dfAm}CqyXDP*sC(6dpNzi+W8`Uk08w&~t53PdBu(FcEDEVlNUp`Mfzv?nh
z#l+#0slQg<6!IpaEyA@3H*!8bN@bPR$tx!q-(FxJ7J0~C$nUmJXsH`x+b*t1J*w$O+5%C@i#JLINvf7{TO|
zOw@$6>y!|5z&o+ZYZ`9Ow~LDg_m8w)ih_%PplXQNKJWesVL0J606O4BY$K?vvB>2d
ziZG(n#TLwYm5{*e3sg63)F1!&I}cPHs04Tv1f;vrYvGbDuzj!_)AR9JV4sl;D{~jD
ztMZlr5nnnwskeyqVkQVlmsIK30~}H=+AqNoTCD@j^Ro+R+^B#MtLxE^zODvSHIlE_
z1AloCRDFQo=*GtlVz$)TTC4iJ3zKn%p?`M|W+~Tr*}zaoDcQ)l@LG7-W{+_!!E@Z#he)+qv%_r$nE
z5a??F8r^~T1m8h*L3|H#L6n>N9n}f*_cPETIIkbo1vSt&;NJvD(mfL2FY}^((o4_G
z5X1$jE|`J7dH)8WJ{S9y!J4OoHiAoYm8*$<2Eo>U#04VgjdlWzud{ze1$~8la*)J{
z1%5Sd@Ujg(k|goE}9|W_8Xz^9{Nx*g0xr+4>yJDS@kvlHuDAHEiN&
zm1RtIWa82Ia?Nb^M+s}D{&0L*T#loQ1SO&V1o;wFHapMDq^TLXmbpblN3xCS8X?iE|Lp>^ee@gjmYaJ#y}IuC~CNxPJxo!y3#vA?b-{m>kQeMMHgee
zyQ(MYaF<9^$;^+7c;E0L&%OZ$Q!P!0Kz#dc!wGE4A%wp
zTTgHX(vWnOv;D~CnuyJre6+%0V`@#tU%+B7nX|A)aLt3?D4Kpn(g8Q`4=Aa9bcA7IXd5S=twva@PJ
zPAI#7AUjKjnBlsVVVs+XoLK%lz}ny)7*Gdc7cqo$#(%cG3A_HCx$+#|L^A%Yr}+fC
za7do8s|U0*WrzWqD)Peb*;NPM(6)8
zOqlVyhRf)3QFmiQ4DekAVRyg6I41=gQ2vyNQ|IkLY^e+=BiqJSE)QD5@`rGZgLZxh
z-r)c}jVovgt->L4BP-374=zyCJ>uL32DR*3(BQFU18q*+N=bz0~MntjpFY>v^G
z!*v$QxqGM{t*hQ;cD_q3DUaW^723Hh*nsK3$O9BZcDzA4@VgCQodH8v*e4N6!T)@R
z`0wi-Y(V2`fU?U2);T&T$*&<(EkZARkHylf8rg0ivp*k}^Y#^;V+*%5uo=Om1oG{^E#cQe5{%|S4KC*E-W
zd(TaRcN|W!O-8tG1vwgDfB0Po8pIyHHNc*8f6*jnr{CZts<*{o>ZjWrRWa-Vn14M@0$MG&q27}R9
zSV-%PKeb44s#vnI8d{~osjZ~qo9dAPpDxy<)CgA`9&|;LVzCBxx~+l&!nPWAbh6m}
zQ;rayT$Z81_TIse4t#iieRwV)Hib`z0gp!oT6e1-qJx@dKxS;jyr&~i;>@I;2W^ix
zLx@m=JlLSj704E}PiiKDQ+=YwGQ{Q88miiJHDUxoo5L|RDvQ<%<4aiPpql7PsCW#~
zOL3Xt
zr~{dw93#d^c->VDml;rh-bdiy5{)3LK7b$JDEtXvyPJz(AZq_%rv;fOVnyqRqTq&O
zuN^^G7brT~LRQnlFLR(RyZFDX^mD0!Z+y%n)7={&DB?wHmLk2`NN)bg^%8*5-+F(d6
z^}|r3;(1q=L0(CZqyu}B#rWX05LVR4>)S)4yE!5%gO+=@*{r5p$?yaJM&+y-=
zEQch4-B__NYh*wsS+f%4B+UuU2}9~Vd5p9i6a9Xhot5$4;dq>!^VBWVKN`aCf#&|R
zrgAK}RN>jto30X?Oyy%EG)9ZeG^w{Vj;@f`L(r?k=~C&sv12fNDp~fF>&6k3*mSYd
zdZYDqO7(S-HYwiiAtsD#z>VrHSRp4^EN
zpD?5pJ!4UjOtDM-_?1Q5`ToN*IVYfH1FvDM(P|p`cxDjg$exeX4H>F4AEg@t&2A^KL5eD2!a~
z9nb%Ms<2`_*`e84RyrWW_b^U0NN`Vt6lNO3I)1j>nB5B$CS$fHv=
zgmUS6(B#LcxLk#J6{M2AJkBOguOnMiWw_yMnCQlhH>wb?We#PSn;R%Hru!LNTH1ae
zzU2bbKW_N&-E906hmJBMm?IJ}=u`1*N4U($Qm7fR8Oc{N8C=IwWZdRF#97fPW7d=f
zv3?w&?BJTyli<*TF_%F>Pc7(Rj=D`nOtY)UB&SB}Q;F@F^U+d6{Sb`{jvkRAux9i`
z^sYsdD~`v6D1|D2#i34iIEu=G|I30+Mvnp*1Tmx8w+E-+?XkjW2#u1#Fx!)bw?Okz
zXy4*xY;|k_jIbIasTeQ%!pRg=>v=VU@@Thet1)n!pFcv$q}#M;;XbLQ(bNOgIs15G
za*^?=)-|E(ppG?ascgB$6}UpWD!msYWA5x?zw|B1;Mw4;`mc!;+2O*~!l5M?O3E?t*9)l>u(>L<
z=qn_s)?rYW;i}>8e~fhBF^u*e^p%rGX~KJ{K;DVeVd&@B&ZpsKXvLRnATlUbl$&x?
zVH*n8uw_6?$LbR|>Mg?WdnsT*-0J|)!~JaxaF6!E9!OspQ$``eWc@@D7@lXkK9t4QKiMmk|qivLJe~2
zbxrJ7L5tNdj1Z({k*pci!%5%7VPcRZk!1p=yDbwYH7UN#WN5J8jv%|1QrQE3p`#t*
z`<4d7PxT+d;I=4Z=}OU-<|@Ru7AhwtJc7&`3Zv{(gjxQmE7#Rc*JAXffs^gpzD*v{
z`WdnXuPR6O+~3}qxsbE1V+LO6xH!O5V;gG3a)&
zj%;EH<$u=6e|4RCqN9juhaoMuWKQnzgogh<53KM$0^dQCI_jsdV3m)QP@pNdE1s8blr;|~>x)?g>pD)!o=NmT_FVFHDilrE%$KYisl9XlrR{anFpo4u>k}M5q(=W5Il3qRWArwp7-F
zcD&>Em+h{RSeHUSa~c6&W!&4VpCmB9B<(tvDCoF56|L-%RLXDYR>_$;uH
zD%U2XndNLvhqhKeE0wOayKCQdAvo$RJfb~H$KhqT&v#ILM1!vSZ4PdFI|FeB8k-;e
z75#OYd-)#%bHN0vJg=3qp1HNOwC5w5<|_H}GB!4ce5(>s1Hu>nf3=2TR1Wf%N11xm
zXiQZ#0=$!A;Yd`#_wb@?ZP3x4>MjaT?sshA@N`aBq(t%)_OQEW^hiBzXiVXt=n$|z
zS2UCHd{y%Sn4ER;SmbR)5c>#MC11;T
zyU%3*Rkl^O7F3#t$ZyKee*=`so3YqS)vfJkLIEyLCV~Vr9s^kCb!Jfv3xtyMp$G;An5Zi*SZg!M*^{3x6QJPQS&tk!3`N3OH6&8vCGR
zhB;D{;LXxh{N{z)xK);&pq;Q?bkgj8XnxrhrVi{$7!jr>UzRyYNx^U_!$Z&DO6#i}
za!|m^KT`emo$h^P72~sYdkjYESFp=N!tH7}=X77Rb{;^1_Iv(r+RrLD+%sldh>+zV
zV!;@giG_au8j18HLbdq-LS7Vnu5>#>rY{xEo6DihXWY?)Hv^wLyj<+Q(@OrhQTT43
zqUT^t|0nkZ=hn#Fz8CdlZL@K0|~FH+OZ^fO4t@_7$E!j)9Qa=ofo#BA&v9ydoRs3%;9QtB$@
z`Ml@Iv7voBcn7;#6KZRt^+#6Q{@s=et$^by$xS0QOmC+V$L;eUt9_VO+-l9dG=f2v
z>%l+28-(2fQX}urRX2;z+s3_L@AE%^+n;!tJ!v+Q#!=|hAJmLhLF1vX8v_zu!~sQa9@&rBk0vYW^SViNbMM^vY{bTS@@ikHG+}Hk
zYA)bbX)BQ-jYI`m6e@sLv5*efU+^>7Z~-Dba?lB58Fg>px76!grlT<$iBSL1#87G+
z?!PuU+|Tg^uB*H?FKhK?+Ksi!(V+LO;M6o7K~umfiI6_82#I=AU6#$ZdM=DnXf93(Fj$9_LmvEHqYZjT|2OoR)${U(0nRN#?1U~5XV$?Z7#yAz0=2(oZroU
zBiCy6FV0)r$=o2_XQzF7?_;udgzLC~woKH7u~`CrH;;?4GyROwQIM8q#vRc)ux!&w~l{0~fC;Us+jmd*sD7hs3{
zGv-d$~e`gj5x>B;}dR&knqMJTQV~jE~zgHQY^v)o=5Hx_r7;I2scGG3|F1g;CCK3qHoV
zS`}0Z%0~S5A>jK_J(w0&<^X(|1V{OxG%C0%8zm;nFDRwl{y(i1jIn7h7urm
z@O;NpywCI9A9w$lXJ%#XcfEV<{m%X~lQDW=?le9uy(#xiB*V_GO3J9uClFJ+Mlc>F
z?pF8}my|DE$+vw8S-e_*og)0`{Ez>s{L_KJQlU_a
za>-81?OR1)33+cF=rde(XGpfIxv*o
z0YW}K+8J|{kkro+o3T%R<{mJh{psA3X~xHp+B<6{^8@tKw;r*B8kCnh3#rGcdC4QY
z14P5iD2B{qY%WFp&(wo}iM_OJmn5Q;WR4T~AFENt^yK{z3aJIJ@^e)iLyyi%)1r
zbgxLSAZKF0cFP%=V|CXpK=}D}f4+RU^#AG}7SKg#wR8biAyUAQzYrSj4&imUdd
zC$fLyDG?Kq5ZRF_oa3F9A)J=D6HLDPCL_Qx!|EuJ%jIaG^o{CB9q8*98cf~gZ5y*o
z;h%F?y2X0KEWWj;yA7^RblH;3OC*M6T{~aWa$y!n>LW-STJ<_^MURGM$CBQElnCRi
z79cz)1*;9xjslk^RHY=s(+{FUo!=^!bQV6#53H~$+gxoGMWr>z(I-=NYotn@Plv?a
zD{rL)XNVB)SIstVj@7h3)s18ApCHn*Y77{Yc9rfk9)rXnv(fwK`X!ntX6{^rV|;$U
z%`?4*mZx%ux(-mE}v;dG5m+nWfuk|
z>p#q^MmN7Wd3ifYex`b-oF+_p-)Q
zMB|zw-M^{g1=-v~y1H-uerNIuO|WhNwLI|hPS+-o{{iDc&Sp=UFY#-^+xWa?_%hp9
zd3pq69~ZLiYCh!twDa`H-k@O0O29>I`^gS^(^MyDAFM695lZXh03tX2gB%ijZfoSDJZ_t+afjNPS(BKiA)w
z(6N#0iQD}0Hf(AxP9-MWYV%#DPP(Le$j-0(k;s~r$H(Tq4C-!5637(#ChZMQ{c+1?
z8U7_AVp*@gwcbUX)#yL6gg3_m11-l8q*h=FWl$|=l~2pbyDX5kEMLuBn_p)mk?2N#
z_+8$<7IBQ)38NVH$mb;bol!p0{L)t2#yO2!_0tPX*Y%Z`gVq?Uy`Pn_0^29B))5!I#oqVRkbk`ue?Q
zwdd<*drdUN$k8n6&<<6BhT4I_VTv5DCSfAP`?yDrGKy$9efw*aNaO*puPfcmLCxN`
z!#CqQrm{fji|F;)>)B%fqfGs}!S;a5YM~qOP2^hKq=*Xc(K8bo
zuKmLrEp>!kqH~+;uDCb8-2bCPx#VEb5nTb&eV?9zppA+lTb(?+GI6S~UC6m1gktVy
zbx6W=$x>y8_8ZrV<)JdpuM_dZ6`=#_rZHuY?N#IU1OTH49&_o0#od=&Xj`f}?GUf_
zRE1jiG4}I_yE$G5aKz9D9#P{q!uw~c@pbdT-Ob^#y~{@_3aanczWo02;A1+I(eHVA
zW0kRrd_pwN%QI(ot1y{9S*Cb=@4#ArLKH7;H%2j0x%!=*iCF3DKgV&rRoAG&;HL=C(CRM`*cj@X;_
ze23W6QRm&jGwbNffvUm}2grc|$0&~BE_at>OSiYk
znJGE=xd2_p?YBfmHX=O5!^ZL#dtPS}XX&(!@y2f=*O_D+k=;x&fh4>L)&6eb{au6k2c+N_Zh<
zQg~v4BkOS;+4HMo^Jdp6(-f8$)=~*={1riQ2bk&A@9Iw4D&(@8cNQSxL{B98eQpt9
zx$EL@DyQdc&P{huiHy8CpoPDCF{{V3#iAoH-s5~h&D*-yuZyMV;t3b~gDCSFS*fD_pzQpD5%IBu`T<
z0al=;=ZfZR%jWdVNRL#lO7XqW#dl#BbE1}6?rBM=<5|V5Z+T4hpr%3-+Baa^NZHEL
za6KV4O}mTnX$Yaq+Tb5M&Zo#8yQ^?S%h#iVRr{&!x4uX|t&1@t*H=R-CA~Fq)k>*_
z4YEux>Ut#6&#&B!b2s0j1xLF2WvBjg!28!_*KfvmJ@EOeXKB|L!?q(qmTzy|6<#UV
zeG?Zj0;qHuB(vRgrJX~CE3Y7`Y?wDye$A;_=~>$&*NlL)tS@f7`3o<7
zHaae6jc58@K6Pt(#=u@_88ssI!oHqF{V;ITiwJU%CoPLETSSabbg0`PR%DEk
z7l-{$3lqxlnSR=v%dM1ZLsb*fTOg#coiSBQtUmXKqn|ZKc9A;#Ho8`0q(R2t)w-h%
zXAZp}VY1tWx?P#y|l{N@uyf|K=A|zidy2jIs3b>AHH4HUX4Qc;4
zo#UpI6Qa#nEN;mf`B;>xX1f{pesm;re-53dzCn?<8+TyS{Y%DY>Pp;(7Y1%F>!FCF28Er4vf-G3BxD@{Fj_o4)vaRCs#UA9?Ux43
zo*aH&XU_|M{=UwR9{jus`2F1AKn{!#TzLpP#)-C-#;Bo4I*(wx;o$Tvj3?n0Y8U90
z4fAA!aBw6W)+~XQMo4=(UE=4pl~%)Q*h_zp_Z?6}Xn+klFfkY|;e_}B5?e0p%P}|-
zL7JI`y@zw5G}SShXax9r0fzct#%vW1m^-PGjv#Ql8=ZmVR-9nwE
z)sSjn(mL#*J_-ft>l;AwC>a?kk
z=&N}@MH@pRscOcPZ>Ps8L*~B3Tl=GLOfzi?KA0M%$tB9Qzh*WgYL}qDBQ;5|G?|U3
z%&xBCROv4Cl*Mqm-$Vy4Ip=PUT-w^UQl)mH)%KyV=ux{Bm8h^C`fLxk33D*9GHr5E
zB!Fj!KtqG7;RJVwxxT(6x=~f;*%_mE7GnAKkBY%LUWX>J`%!?US%C_U5>|dSPBR7L
zZdMg3ro<*V7eyWAcPNF2IiBfE$D%A7j?Z!Fa!38beO;P6dOJ6pmZ6@8;Wf5LGQ3VQ
zoI7P;pI#M^O-X41mIm6{uQZLWJ=e@fHvoH$uKOEBek(l*J=ERzOF`+LG8s0^)F`X|
zH;$B2HU(*}cLAm6t|{N+3n|_Gq6s5^B~1RBzWh}u`N&iG*A?=khA-XR7Gv!sG949O
zD#Fmq5O`vGf=}IBRN#;fn)b^18fTwitoJXeqtX=(JR0zpZ>2cYw0wo0qIjgAx3F0w
zuqT6sUUk#pkVR~pbTr~fF%z#H8u5rV>mQ4tiKJ!YU>=Qj`}GeP95_zhE@A185|b(ZwHYG1PYh54DV;d
zLbs(J7<^CyBaKmqe3jnveybs&q5cR@YK6mNVBo%O@SWfZcIXhu4p#zSu*0|WBh@t2
ze(=D0cDNJ_1-7!oWkEOxTuDOXr?48>A43L>IUqU$wB&&3cOg31!SOvLPVI-yVDA?B#?wHk|P7ibyqRSbw+ad(sFT>R);g44xE#3xQWSp|o?i`cFXp`H?6D3i)S$
z(kv%j5C-K<%lrq-1@(5c>jG%#M?{%u^T%2`u}lLM4}+a
xz@6Knnfi}R*#C=+>Iq-xK
Date: Thu, 31 Oct 2019 14:15:50 -0400
Subject: [PATCH 138/149] Update ~$portunity Management SOAP Web Services
 Change Log v0.8.docx

---
 ...ement SOAP Web Services Change Log v0.8.docx | Bin 162 -> 162 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/_apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx b/_apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx
index d1809db3304fb3475797714ba491f48f22b7e047..dc7746e55ed1c069c4afe77ebd321448b2a24ff2 100644
GIT binary patch
delta 49
tcmZ3)xQKB=08?!K#2_7&34(F?vP=vNj0_O4VB-6JFAx(b1_q1`3;-ce2{Hfx

delta 49
tcmZ3)xQKB=08>cn#2_7&3oAoYWtkWl7#Sd7!Nm9dULYn=3=9|>7yvnl3FH6(


From 88a2f1991d3817170450f035c3beedd38b080d14 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 14:16:09 -0400
Subject: [PATCH 139/149] Delete ~$portunity Management SOAP Web Services
 Change Log v0.8.docx

---
 ...agement SOAP Web Services Change Log v0.8.docx | Bin 162 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 _apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx

diff --git a/_apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx b/_apidocs/opportunities-soap-api/v1/~$portunity Management SOAP Web Services Change Log v0.8.docx
deleted file mode 100644
index dc7746e55ed1c069c4afe77ebd321448b2a24ff2..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 162
zcmd<~PRvUW&(BkE&d6sV8gMgsGbA$PF{CquGvotl1qNq^3?PevAvRx@iGe}j
Date: Thu, 31 Oct 2019 14:39:31 -0400
Subject: [PATCH 140/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 1e367f788..196c65a24 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3789,6 +3789,9 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Archive Date |	This opportunity cannot be published. Inactive date is a required field. |	Archive Date is required if Archive Type = autocustom |	Create, Publish, Uncancel, Unarchive
 400|Archive Date Response Date   |	One of Response date or Archive date is required |	Either Response date or archive date is required for presolicitation, sources sought, special notice, sale surplus  |	Publish
 400|Archive Date |	Inactive date provided is an invalid format. |	Date is not in specified format  |	Create, Publish, Uncancel, Unarchive
+400|Archive Date |	New archive date is required. |	New archive date is required.  |	Unarchive
+400|Archive Date |	New archive date provided is in an invalid format. |	New archive date provided is in an invalid format. |	Unarchive
+400|Archive Date |	New archive date provided is in the past. |	New archive date provided is in the past. |	Unarchive
 400|Archive Type |	New archive type is invalid. |	archive type is not one of the following "auto15", "autocustom", "auto30"	| UnArchive
 400|Archive Type |	Archive type is invalid for this notice type. |	archive type is one of the following "auto15", "auto30" and is not allowed for this notice type	| UnArchive
 400|Archive Type |	This opportunity cannot be published. Inactive Policy is a required field. |	Archive Type is required |	Publish
@@ -3893,6 +3896,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Response Date |	New response date is required. |	Unarchive requires new response date	| UnArchive
 400|Response Date |	New response date provided is in an invalid format. |	Invalid date format	| UnArchive
 400|Response Date |	New response date provided is in the past. |	Response date is before offset date	| UnArchive
+400|Response Date |	New response date provided would place inactive date in the past. |	New response date providedis within 15 days	| UnArchive
 400|Title |	Title is required |	Title is required |	Publish
 400|UNARCHIVE |	This opportunity is not the latest published |	Only archived notices can be unarchived | UNARCHIVE
 400|resourceName | Attachment must have a name | File Name is a required field |	Create Attachment

From 5499a11ae8964b5234c1a24b2ebd11dea5ded150 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 14:47:22 -0400
Subject: [PATCH 141/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 196c65a24..32d15cb18 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3791,7 +3791,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Archive Date |	Inactive date provided is an invalid format. |	Date is not in specified format  |	Create, Publish, Uncancel, Unarchive
 400|Archive Date |	New archive date is required. |	New archive date is required.  |	Unarchive
 400|Archive Date |	New archive date provided is in an invalid format. |	New archive date provided is in an invalid format. |	Unarchive
-400|Archive Date |	New archive date provided is in the past. |	New archive date provided is in the past. |	Unarchive
+400|Archive Date |	New archive date provided is in the past. |	New archive date provided is before today's date. |	Unarchive
 400|Archive Type |	New archive type is invalid. |	archive type is not one of the following "auto15", "autocustom", "auto30"	| UnArchive
 400|Archive Type |	Archive type is invalid for this notice type. |	archive type is one of the following "auto15", "auto30" and is not allowed for this notice type	| UnArchive
 400|Archive Type |	This opportunity cannot be published. Inactive Policy is a required field. |	Archive Type is required |	Publish

From 266baa2a1bd2c72dae81e24d0513650f26c9a8b0 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 14:52:35 -0400
Subject: [PATCH 142/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 32d15cb18..06afd4910 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3818,7 +3818,9 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Total Contract Value |	Base and All Options Value max length is 64 digits. |	Base and All Options Value max length is 64 digits. |	Publish
 400|Total Contract Value |	Base and All Options Value - Invalid input: Please enter a valid number. |	Base and All Options Value - Invalid input: Please enter a valid number. |	Publish
 400|Modification Number |	Modification Number max character limit is 32 characters. |	Modification Number max character limit is 32 characters. |	Publish
-400|Award Date |	Contract Award Date is required field. |	Contract Award Date is required field. |	Create Opportunity, Publish, Uncancel, Unarchive
+400|Award Date |	Contract Award Date is required field. |	Contract Award Date is required field. |	Create Opportunity, Publish, Uncancel
+400|Award Date |	New contract award date provided is in the past. |	New contract award date provided is in the past. | Unarchive
+400|Award Date |	New contract award date is not provided |	New contract award date is not provided | Unarchive
 400|Award Date |	Contract Award Date provided is in an invalid format. |	Date is not in specified format |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Contract Award Date provided should have 4 digit year. | Contract Award Date provided should have 4 digit year. |	Create Opportunity, Publish, Uncancel, Unarchive
 400|Award Date |	Award date provided is in the past. |	Award Date must be current or future date. |	Create Opportunity, Publish, Uncancel, Unarchive

From 35bf9eff1d2a2a446c3b0ba4574892156e03959c Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 15:02:58 -0400
Subject: [PATCH 143/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index a5bff2fe5..f8d22cffb 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3058,7 +3058,7 @@ award.awardee.location.
zip | string | | | No | No | Awardee Country Zip cod
 justificationAuthority | JSON |NA |NA | NA | NA | Only for type = j (Justification)
 justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
 justificationAuthority.
authority | string|  |  | No | Yes | Justification Authority
-additionalReporting | string | |none, 
auto_recovery | No | Yes; No for type = s (Special Notice) | Initiative that applies to the notice
+additionalReporting | string | |None, 
auto_recovery | No | Yes; No for type = s (Special Notice) | Initiative that applies to the notice
 description | JSON | NA | NA | NA | NA |
 description.body | string | 65535 characters| | No | Yes; No for type = a (Award) | Description of the notice
 related | JSON | NA | NA | NA | NA | Related Notice information
@@ -3404,10 +3404,10 @@ Name | Data Type | Allowed Values | Required | Description
 reason | string |  | Yes | Reason for uncanceling
 requestType | string | uncancel_request | Yes | Type of request
 description | string |  | Yes | Description for uncanceling
-newContractAwardDate | date | YYYY-MM-DD | Yes; for type = a (Award)| New Contract Award Date
+newContractAwardDate | date | YYYY-MM-DD | Yes only for type = a (Award)| New Contract Award Date
 newArchiveDate | date | YYYY-MM-DD | Yes; (if newArchiveType=autocustom) | New Archive Date
 newArchiveType | string | auto15,
 auto30,
 autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes; for types = k, o (Combined Synopsis/Solicitation) 2) Yes; if newArchive.type=auto15 except for type = a (Award) | New Response Date
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for types = k, o (Combined Synopsis/Solicitation) 2) Yes; if newArchive.type=auto15 except for type = a (Award) | New Response Date
 newResponseTz | string |  | No | New Response Time Zone
 
 
Back to top

@@ -3513,11 +3513,11 @@ newResponseTz | string |  | No | New Response Time Zone
 Name | Data Type | Field Length |Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 attType | string | 32 characters |link, file | Yes | Type of attachment, either link or file
-content | byte | 250MB| | Yes; if attType=file | File content in base64 format
+content | byte | 250MB| | Yes if attType=file | File content in base64 format
 packageAccessLevel | string | 32 characters|public, 
private 
(default public) | No | Type of access to file. Only used with attType 'file'.
-resourceName | string | 255 characters| | Yes; if attType=file | Name of file
+resourceName | string | 255 characters| | Yes if attType=file | Name of file
 fileType | string | 64 characters | | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
-link | string | 255 characters| | Yes; if attType=link | Resource link  URL
+link | string | 255 characters| | Yes if attType=link | Resource link  URL
 description | string |255 characters | | Yes; if attType=link | Description of the link
 explicitAccess | string |1 character | 0, 1 
(defaults to '0' public access, if not provided) | No  |Explicit Access. For Controlled Unclassified files, specify '1'
 exportControlled | string |1 character | 0 | No  | *Captured for future JCP validation*
 Export Controlled

From 9a2ccf7bacff660128bc2591d125ea34ff3a1614 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 15:04:13 -0400
Subject: [PATCH 144/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index f8d22cffb..949b53536 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3405,9 +3405,9 @@ reason | string |  | Yes | Reason for uncanceling
 requestType | string | uncancel_request | Yes | Type of request
 description | string |  | Yes | Description for uncanceling
 newContractAwardDate | date | YYYY-MM-DD | Yes only for type = a (Award)| New Contract Award Date
-newArchiveDate | date | YYYY-MM-DD | Yes; (if newArchiveType=autocustom) | New Archive Date
+newArchiveDate | date | YYYY-MM-DD | Yes if newArchiveType=autocustom | New Archive Date
 newArchiveType | string | auto15,
 auto30,
 autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for types = k, o (Combined Synopsis/Solicitation) 2) Yes; if newArchive.type=auto15 except for type = a (Award) | New Response Date
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for types = k, o (Combined Synopsis/Solicitation) 2) Yes if newArchive.type=auto15 except for type = a (Award) | New Response Date
 newResponseTz | string |  | No | New Response Time Zone
 
 
Back to top

@@ -3466,10 +3466,10 @@ Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 reason | string |  | Yes | Reason for unarchiving
 requestType | string | unarchive_request | Yes | Type of request
-newContractAwardDate | date | YYYY-MM-DD | Yes; for type = a (Award)| New Contract Award Date
-newArchiveDate | date | YYYY-MM-DD | Yes; (if newArchiveType=autocustom) | New Archive Date
+newContractAwardDate | date | YYYY-MM-DD | Yes for type = a (Award)| New Contract Award Date
+newArchiveDate | date | YYYY-MM-DD | Yes if newArchiveType=autocustom | New Archive Date
 newArchiveType | string | auto15,
 auto30,
 autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes; for types = k, o (Combined Synopsis/Solicitation) 2) Yes; if newArchive.type=auto15 except for type = a (Award) | New Response Date
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for types = k, o (Combined Synopsis/Solicitation) 2) Yes if newArchive.type=auto15 except for type = a (Award) | New Response Date
 newResponseTz | string |  | No | New Response Time Zone
 
 
Back to top

@@ -3518,7 +3518,7 @@ packageAccessLevel | string | 32 characters|public, 
private 
(default p
 resourceName | string | 255 characters| | Yes if attType=file | Name of file
 fileType | string | 64 characters | | No  | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types)
 link | string | 255 characters| | Yes if attType=link | Resource link  URL
-description | string |255 characters | | Yes; if attType=link | Description of the link
+description | string |255 characters | | Yes if attType=link | Description of the link
 explicitAccess | string |1 character | 0, 1 
(defaults to '0' public access, if not provided) | No  |Explicit Access. For Controlled Unclassified files, specify '1'
 exportControlled | string |1 character | 0 | No  | *Captured for future JCP validation*
 Export Controlled
 

From 56f0ccf0098e7bea89aeedcd73e05ff5626f6049 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 15:11:43 -0400
Subject: [PATCH 145/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index 06afd4910..bea3454ce 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3779,6 +3779,13 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Additional Reporting |	Additional Reporting/Initiative is required. |	Additional Reporting/Initiative is required when opportunity is not a special notice | Publish
 400|Title |	Title max character length is 256. |	Title max character length is 256.	| Publish
 400|ARCHIVE |	This opportunity is not the latest published. |	Draft Opportunity cannot be archived.	| Archive
+400|ARCHIVE |	Opportunity already inactive. |	Opportunity is already archived.	| Archive
+400|Update |	Opportunity cannot be updated. |	Opportunity is either in draft, archived or cancelled status.	| Update
+400|Cancel |	This opportunity cannot be cancelled. This opportunity should be published. |	This opportunity cannot be cancelled. This opportunity should be published.	| Cancel
+400|Cancel |	This opportunity cannot be cancelled. This opportunity is a revision. |	This opportunity cannot be cancelled. This opportunity is a revision.	| Cancel
+400|Cancel |	This opportunity cannot be cancelled. This opportunity is already inactive. |	This opportunity cannot be cancelled. This opportunity is already inactive.	| Cancel
+400|Cancel |	This opportunity cannot be cancelled. This opportunity is already cancelled. |	This opportunity cannot be cancelled. This opportunity is already cancelled.	| Cancel
+400|Description |	This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field. |	This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field.	| Cancel
 400|UNARCHIVE |	Opportunity is active. |	Active opportunity	| UnArchive
 400|UNARCHIVE |	Opportunity is cancelled. |	Cancelled opportunity	| UnArchive
 400|Opportunity Type |	The new opportunity type field is missing. |	prevent activating if opportunity type is `m`, `l` or `j` and new type opportunity isn't provided	| UnArchive

From 3066969cd9973da6b962f03111e8875954cc3172 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 15:22:56 -0400
Subject: [PATCH 146/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index bea3454ce..e96db92dc 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3786,6 +3786,10 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Cancel |	This opportunity cannot be cancelled. This opportunity is already inactive. |	This opportunity cannot be cancelled. This opportunity is already inactive.	| Cancel
 400|Cancel |	This opportunity cannot be cancelled. This opportunity is already cancelled. |	This opportunity cannot be cancelled. This opportunity is already cancelled.	| Cancel
 400|Description |	This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field. |	This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field.	| Cancel
+400|Uncancel |	This opportunity is not published. |	This opportunity is not published.	| Uncancel
+400|Uncancel |	This opportunity is a revision. |	This opportunity is a revision.	| Uncancel
+400|Uncancel |	This opportunity is not cancelled. |	This opportunity is not cancelled.	| Uncancel
+400|Description |	Description is required |	Description is required	| Uncancel
 400|UNARCHIVE |	Opportunity is active. |	Active opportunity	| UnArchive
 400|UNARCHIVE |	Opportunity is cancelled. |	Cancelled opportunity	| UnArchive
 400|Opportunity Type |	The new opportunity type field is missing. |	prevent activating if opportunity type is `m`, `l` or `j` and new type opportunity isn't provided	| UnArchive

From 8966e4fad4a502c08112ab1fe4d7c0fcacecce58 Mon Sep 17 00:00:00 2001
From: Ashwin-Deshmukh-REISystems 
Date: Thu, 31 Oct 2019 15:42:45 -0400
Subject: [PATCH 147/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index e96db92dc..fa6cdee1e 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -3786,7 +3786,7 @@ Error Code|Field | Error Message | Reason/Description | Operation
 400|Cancel |	This opportunity cannot be cancelled. This opportunity is already inactive. |	This opportunity cannot be cancelled. This opportunity is already inactive.	| Cancel
 400|Cancel |	This opportunity cannot be cancelled. This opportunity is already cancelled. |	This opportunity cannot be cancelled. This opportunity is already cancelled.	| Cancel
 400|Description |	This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field. |	This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field.	| Cancel
-400|Uncancel |	This opportunity is not published. |	This opportunity is not published.	| Uncancel
+400|Uncancel, Delete |	This opportunity is not published. |	This opportunity is not published.	| Uncancel, Delete
 400|Uncancel |	This opportunity is a revision. |	This opportunity is a revision.	| Uncancel
 400|Uncancel |	This opportunity is not cancelled. |	This opportunity is not cancelled.	| Uncancel
 400|Description |	Description is required |	Description is required	| Uncancel

From 8a84d074e0a0a7161dd25478ede4871ea657b221 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 15:54:44 -0400
Subject: [PATCH 148/149] Update opportunities-soap-api.md

---
 _apidocs/opportunities-soap-api.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md
index 0f515eaeb..e22f5d887 100644
--- a/_apidocs/opportunities-soap-api.md
+++ b/_apidocs/opportunities-soap-api.md
@@ -4326,7 +4326,7 @@ Date | Version | Description
 8/19/2019 | v0.5 | SUBMITPRESOL/SOURCESSOUGHT, SUBMITCOMBINED, SUBMITAWARD, SUBMITSALEOFSURPLUS, SUBMITJA, SUBMITITB, SUBMITSPECIANOTICE, SUBMITMOD, ARCHIVENOTICE, UNARCHIVENOTICE, CANCELNOTICE, SUBMITDOCUMENTSANDLINKS, GETLIST, GETNOTICEDATA, GETFILEDATA, DELETENOTICE parameters updated 
 User Account Section Updated
 9/25/2019 | v0.6 | Updated required fields for DocumentLink, DocumentFile, ArchiveNotice, UnArchiveNotice, CancelNotice and DeleteNoticeOrDocumentPackage ComplexType definitions
 10/10/2019 | v0.7 | Updated the Set-Aside values with the latest codes
-10/28/2019 | v0.8|  See attached document
+10/28/2019 | v0.8| Documentation updates only. No change to Implementation 
 - Production WSDL link added 
 - Redundant Character Limit and Required columns removed from Specific Business Rules and Error Messages section 
 - Notice Types and Related Notices sections added for reference 
- Consolidated and summarized list of deprecated methods 
- Far13 added to Stauth Valid Values section 
- Updated character limits
- Updated required column for submitAward, archiveNotice, submitPresol, submitCombined, submitMod, submitJA, submitSourcesSought, submitSpecialNotice, submitSaleofSurplus, submitITB, submitNotice, submitdocumentsandlinkstonotice 
- Remove foja from getnoticedata response
 
 
 

From fbb0c4e086ae0f8999e079b118c0410b67708ea9 Mon Sep 17 00:00:00 2001
From: whrkddnjs135 <>
Date: Thu, 31 Oct 2019 16:51:57 -0400
Subject: [PATCH 149/149] Update opportunities-api.md

---
 _apidocs/opportunities-api.md | 1817 ++++++++++++---------------------
 1 file changed, 630 insertions(+), 1187 deletions(-)

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md
index b5838687a..182887dcd 100644
--- a/_apidocs/opportunities-api.md
+++ b/_apidocs/opportunities-api.md
@@ -14,7 +14,7 @@ The Opportunity Management API will allow authorized users to submit and request
 ## Getting Started
 
 Opportunity Management API can be accessed from Beta or Alpha via the following endpoints:
-* Beta: https://api.sam.gov/prod/opportunity (Coming Soon)
+* Beta: https://api.sam.gov/prod/opportunity  (Coming Soon)
 * Alpha: https://api-alpha.sam.gov/prodlike/opportunity
 
 **REST API Workflow Chart**
@@ -37,10 +37,10 @@ To view the current workflow of REST APIs, refer below file:
 In order to utilize the Contract Opportunity Management API, the following is required:
 * Valid beta.SAM.GOV federal government system account with Read and Write permissions under Contract Opportunity domain.
 
-### Type of Connection Validation 
+### *Type of Connection Validation (Future Implementation)*
 All REST API requests will be validated against the Type of Connection within the system account profile. All requests without "REST API" type of connection in the system account profile will be rejected with an error.
 
-### IP Address Validation 
+### *IP Address Validation (Future Implementation)*
 All REST API requests will be validated against the IP Addresses registered within the system account profile. All requests that are not from registered IP address(es) in the system account profile will be rejected with an error.
 
 #### User Account Authorization
@@ -68,9 +68,8 @@ Cancel Published Opportunity | Yes | Yes | No
 Uncancel Canceled Opportunity | Yes | Yes | No
 Archive Opportunity | Yes | Yes | Yes
 Unarchive Archived Opportunity | Yes | Yes | No
-Create Resource in Draft Opportunity| Yes | Yes | Yes
-Update Resource in Draft Opportunity| Yes | Yes | Yes
-Delete Resource in Draft Opportunity| Yes | Yes | Yes
+Create Attachment in Draft Opportunity| Yes | Yes | Yes
+Update Attachment in Draft Opportunity| Yes | Yes | Yes
 Download Attachment as Original File Type | Yes | Yes | Yes
 Download All Attachments as Zip for an Opportunity | Yes | Yes | Yes
 Download Metadata for an Attachment by Resource ID|	Yes|	Yes|	Yes
@@ -78,6 +77,7 @@ Download Metadata for All Attachments by Oppoprtunity ID	|Yes	|Yes	|Yes
 Get Attachment | Yes | Yes | Yes
 Get IVL | Yes | Yes | Yes
 IVL settings | Yes | Yes | Yes
+Delete Vendor | Yes | Yes | Yes
 Get Authorized Party | Yes | Yes | No
 Add Authorized Party  | Yes | Yes | No
 Check Unique Solicitation Number | Yes | Yes | Yes
@@ -94,7 +94,7 @@ In order to download secure attachment, user should have at least one of the bel
 * Edit Draft Attachment
 * Delete Draft Attachment
 
-### Lookup/Meta-Data
+### Lookup/Meta Data
 
 #### Notice Types
 
@@ -117,8 +117,6 @@ The API includes specific methods to submit each of the base notice types (i.e.
 #### Set-Aside Values
 Several methods pertaining to submitting Contract Opportunities involve the Set-Aside Type field. Use the Set-Aside codes to submit notices.
 
-Only one Set-Aside value is accepted in the field at this time
-
 Refer below table for valid Set-Aside values:
 
 Code | SetAside Values
@@ -144,7 +142,7 @@ VSS | Veteran-Owned Small Business Sole source (specific to Department of Vetera
 
 
Back to top

 
-#### Stauth Valid Values
+#### Stauth valid values
 Below table captures stauth values to use while making requests as needed.
 
 Code | Description
@@ -204,71 +202,121 @@ Examples
 

 
 {
-    "data": {
-        "type": "i",
-        "award": {
-            "date": "2222-02-22",
-            "number": "ContractAwardNumber123-_(){}",
-            "deliveryOrderNumber": "TaskOrderNumber1234-_()"
-        },
-        "naics": [
-            {
-                "code": [
-                    "111160"
-                ],
-                "type": "primary"
-            }
-        ],
-        "title": "Create Intent To Bundle Requirements notice",
-        "archive": {
-            "date": null,
-            "type": "auto30"
-        },
-        "permissions": {
-            "IVL": {
-                "read": false,
-                "create": false,
-                "delete": false,
-                "update": false
-            }
-        },
-        "solicitation": {
-            "deadlines": {
-                "response": null,
-                "responseTz": null
-            }
-        },
-        "organizationId": "100186612",
-        "pointOfContact": [
-            {
-                "fax": "1234567890",
-                "type": "primary",
-                "email": "test.email2@gmail.com",
-                "phone": "1234567890",
-                "title": null,
-                "fullName": "Test User"
-            },
-            {
-                "fax": "4512367890",
-                "type": "secondary",
-                "email": "test.email@gmail.com",
-                "phone": "1234567890",
-                "title": null,
-                "fullName": "Test User 2"
-            }
-        ],
-        "classificationCode": "1005",
-        "solicitationNumber": "Test-ITB-123",
-        "additionalReporting": [
-            "recovery_act"
+  "data": {
+    "solicitationNumber": "ITB_Test1",
+    "title": "TST_T1",
+    "type": "i",
+    "classificationCode": "13",
+    "organizationId": "100120624",
+    "naics": [
+      {
+        "type": "primary",
+        "code": [
+          "111150"
         ]
+      }
+    ],
+    "pointOfContact": [
+      {
+        "additionalInfo": {
+          "content": ""
+        },
+        "email": "",
+        "fax": "",
+        "fullName": "GSA",
+        "phone": "",
+        "title": "",
+        "type": "primary"
+      }
+    ],
+    "placeOfPerformance": {
+      "city": {
+        "code": "",
+        "name": ""
+      },
+      "country": {
+        "code": "",
+        "name": ""
+      },
+      "state": {
+        "code": "",
+        "name": ""
+      },
+      "streetAddress": "",
+      "streetAddress2": "",
+      "zip": ""
     },
-    "related": {},
-    "description": [
-        {
-            "body": "Test Description"
+    "award": {
+      "date": "2019-08-08T11:20:20-05:00",
+      "number": "12345",
+      "deliveryOrderNumber": "",
+      "amount": "number",
+      "lineItemNumber": "",
+      "awardee": {
+        "name": "",
+        "duns": "",
+        "location": {
+          "streetAddress": "",
+          "streetAddress2": "",
+          "city": {
+            "code": "",
+            "name": ""
+          },
+          "state": {
+            "code": "",
+            "name": ""
+          },
+          "zip": "",
+          "country": {
+            "code": "",
+            "name": ""
+          }
         }
+      },
+      "justificationAuthority": {
+        "modificationNumber": "",
+        "authority": "dictionary"
+      },
+    },
+    "permissions": {
+      "IVL": {
+        "create": false,
+        "delete": false,
+        "read": false,
+        "update": false
+      }
+    },
+    "solicitation": {
+      "setAside": "SBA",
+      "deadlines": {
+        "response": "2019-08-08T11:20:20-05:00"
+      }
+    },
+    "archive": {
+      "type": "autocustom",
+      "date": "2019-09-09"
+    },
+    "flags": [
+      {
+        "code": "",
+        "isSelected": true
+      }
+    ],
+    "link": {
+      "additionalInfo": {
+        "content": ""
+      },
+      "href": ""
+    },
+    "additionalReporting": [
+      "none"
     ]
+  },
+  "description": [
+    {
+      "body": "Description"
+    }
+  ]
 }
 

 

@@ -284,7 +332,7 @@ Examples
     "title": "PRESOLTEST_T1",
     "type": "p",
     "classificationCode": "13",
-    "organizationId": "100186612",
+    "organizationId": "100120624",
     "naics": [{
       "type": "primary",
       "code": ["111150"]
@@ -293,9 +341,9 @@ Examples
         "additionalInfo": {
             "content": ""
         },
-        "email": "testemail@gsa.gov",
+        "email": "",
         "fax": "",
-        "fullName": "test user",
+        "fullName": "gsa",
         "phone": "",
         "title": "",
         "type": "primary"
@@ -328,12 +376,22 @@ Examples
      "solicitation": {
       "setAside": "SBA",
       "deadlines": {
-        "response": "2023-08-08"
+        "response": "2019-08-08"
       }
     },
     "archive": {
       "type": "autocustom",
-      "date": "2023-09-09"
+      "date": "2019-09-09"
+    },
+    "flags": [{
+        "code": "",
+        "isSelected": true
+    }],
+    "link": {
+        "additionalInfo": {
+            "content": ""
+        },
+        "href": ""
     },
      "additionalReporting": [
         "none"
@@ -352,190 +410,62 @@ Examples
 

 
 {
-   "data": {
-     "solicitationNumber": "Test1combine1",
-     "title": "TST_T1",
-     "type": "k",
-     "classificationCode": "13",
-     "organizationId": "100186612",
-     "archive": {
-       "type": "autocustom",
-       "date": "2022-09-09"
-     },
-     "naics": [
-       {
-         "type": "primary",
-         "code": [
-           "111150"
-         ]
-       }
-     ],
-     "pointOfContact": [
-       {
-         "additionalInfo": {
-           "content": ""
-         },
-         "email": "testemail@gsa.gov",
-         "fax": "",
-         "fullName": "test user",
-         "phone": "",
-         "title": "",
-         "type": "primary"
-       }
-     ],
-     "permissions": {
-       "IVL": {
-         "create": false,
-         "delete": false,
-         "read": false,
-         "update": false
-       }
-     },
-     "solicitation": {
-       "setAside": "",
-       "deadlines": {
-         "responseTz": "YYYY-MM-DDTHH:MM:SS-05:00",
-         "response": "2022-11-11T11:12:00-05:00"
-       }
-     },
-     "additionalReporting": [
-       "none"
-     ]
-   },
-   "description": [
-     {
-       "body": "Description_TEST "
-     }
-   ]
- }
-

-

-

-
-

-SOLICITATION Request related to a PRESOL Notice
-

-
-
-{
-    "data":
-    {
-        "type": "o",
-        "solicitationNumber": "test-12345678901",
-        "title": "Test submit solicitation",
-        "organizationId": "100186612",
-        "classificationCode": "1260",
-        "naics": [
-        {
-            "type": "primary",
-            "code": ["111150"]
-        }],
-        "pointOfContact": [
-        {
-            "type": "primary",
-            "title": "",
-            "fullName": "test contact",
-            "email": "test@test.com",
-            "phone": "",
-            "fax": "",
-            "additionalInfo":
-            {
-                "content": "Primary contact info"
-            }
-        }],
-        "placeOfPerformance":
-        {
-            "streetAddress": "1234 XYZ street",
-            "streetAddress2": "",
-            "city": {
-                "code": "75376",
-                "name": "Sterling"
-            },
-            "state": {
-                "code": "VA",
-                "name": "Virginia"
-            },
-            "country": {
-                "code": "USA",
-                "name":"USA"
-            }
-,
-            "zip": ""
-        },
-        "archive":
-        {
-            "type": "autocustom",
-            "date": "2022-09-09"
-        },
-        "permissions":
-        {
-            "IVL":
-            {
-                "create": false,
-                "delete": false,
-                "read": false,
-                "update": false
-            }
-        },
-        "solicitation":
-        {
-            "setAside": "SBA",
-            "deadlines":
-            {
-                "response": "2022-08-08"
-            }
-        },
-        "award":
-        {
-            "date": "",
-            "number": "",
-            "deliveryOrderNumber": "",
-            "amount": "",
-            "lineItemNumber": "",
-            "awardee":
-            {
-                "manual": false,
-                "name": "",
-                "duns": "",
-                "location":
-                {
-                    "streetAddress": "",
-                    "streetAddress2": "",
-                    "city":
-                    {
-                        "code": "",
-                        "name": ""
-                    },
-                    "state":
-                    {
-                        "code": "",
-                        "name": ""
-                    },
-                    "zip": "",
-                    "country":
-                    {
-                        "code": "",
-                        "name": ""
-                    }
-                }
-            }
-            },
-            "justificationAuthority":
-            {
-                "modificationNumber": "",
-                "authority": "dictionary"
-            },
-            "additionalReporting": ["none"]
+  "data": {
+    "solicitationNumber": "Test1combine1",
+    "title": "TST_T1",
+    "type": "k",
+    "classificationCode": "13",
+    "organizationId": "100000136",
+    "archive": {
+      "type": "autocustom",
+      "date": "2019-09-09"
+    },
+    "naics": [
+      {
+        "type": "primary",
+        "code": [
+          "111150"
+        ]
+      }
+    ],
+    "pointOfContact": [
+      {
+        "additionalInfo": {
+          "content": ""
         },
-        "description": [
-        {
-            "body": "test description"
-        }],
-        "related":
-        {
-            "opportunityId": "bc14e9f810a44e468c31fd120dd41b4f"
-        }
+        "email": "",
+        "fax": "",
+        "fullName": "gsa",
+        "phone": "",
+        "title": "",
+        "type": "primary"
+      }
+    ],
+    "permissions": {
+      "IVL": {
+        "create": false,
+        "delete": false,
+        "read": false,
+        "update": false
+      }
+    },
+    "solicitation": {
+      "setAside": "",
+      "deadlines": {
+        "responseTz": "YYYY-MM-DDTHH:MM:SS-05:00",
+        "response": "2019-11-11T11:12:00-05:00"
+      }
+    },
+    "additionalReporting": [
+      "none"
+    ]
+  },
+  "description": [
+    {
+      "body": "Description_TEST "
     }
+  ]
+}
 

 

 

@@ -552,8 +482,6 @@ Examples
 **Consumes** | application/json
 **Produces** | NA
 
-**Please [Refer Create and Update Opportunity Contract JSON](#create-and-update-opportunity-contract-json) to ensure that all required fields in "Required (Publish)" is met to publish opportunity**
-
 Request Parameters
 
 Parameter Name | Parameter Type | Data Type  | Required | Description
@@ -561,7 +489,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-Request JSON | Body | JSON | Yes | [Refer Publish Draft Opportunity Contract JSON](#publish-opportunity-contract-json)
+Request JSON | Body | JSON | Yes | [Refer Publish Draft Opportunity Contract JSON](#publish-json)
 
 
Back to top

 
@@ -592,7 +520,7 @@ Examples
 
 ------- | -------
 **Request Type** | POST
-**URL** | /v1/api/createAndPublish
+**URL** | /opps/v1/opportunities/createAndPublish
 **Summary** | Creates and publishes contract opportunity; JSON same as Create and Update API
 **Consumes** | application/json
 **Produces** | JSON
@@ -603,7 +531,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 ---------------|----------------|------------|----------|------------
 Authorization | header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
-Request JSON | Body | JSON | Yes | [Refer Create and Publish Opportunity Contract JSON](#create-and-publish-opportunity-contract-json)
+Request JSON | Body | JSON | Yes | [Refer Create and Update Opportunity Contract JSON](#create-and-update-opportunity-contract-json)
 
 
Back to top

 
@@ -613,141 +541,6 @@ HTTP Status Code | Response Type | Reason  | Description
 -----------------|---------------|---------|------------
 201 | string | Draft Opportunity successfully created | returns Opportunity ID in response header
 
-Examples
-
-

-Create and Publish Request for a 'SOLICITATION' Opportunity with attachments/links related to a 'PRESOL' notice:
-

-
-{
-    "data": {
-        "type": "o",
-        "solicitationNumber": "test-12345457",
-        "title": "Test Create and Publish SOL notice",
-        "organizationId": "100186612",
-        "classificationCode": "1260",
-        "naics": [
-            {
-                "type": "primary",
-                "code": [
-                    "111150"
-                ]
-            }
-        ],
-        "pointOfContact": [
-            {
-                "type": "primary",
-                "title": "",
-                "fullName": "test contact",
-                "email": "test@test.com",
-                "phone": "",
-                "fax": "",
-                "additionalInfo": {
-                    "content": "Primary contact info"
-                }
-            }
-        ],
-        "placeOfPerformance": {
-            "streetAddress": "1234 XYZ street",
-            "streetAddress2": "",
-            "city": {
-                "code": "75376",
-                "name": "Sterling"
-            },
-            "state": {
-                "code": "VA",
-                "name": "Virginia"
-            },
-            "country": {
-                "code": "USA",
-                "name": "USA"
-            },
-            "zip": ""
-        },
-        "archive": {
-            "type": "autocustom",
-            "date": "2022-09-09"
-        },
-        "permissions": {
-            "IVL": {
-                "create": false,
-                "delete": false,
-                "read": false,
-                "update": false
-            }
-        },
-        "solicitation": {
-            "setAside": "SBA",
-            "deadlines": {
-                "response": "2022-08-08"
-            }
-        },
-        "award": {
-            "date": "",
-            "number": "",
-            "deliveryOrderNumber": "",
-            "amount": "",
-            "lineItemNumber": "",
-            "awardee": {
-                "manual": false,
-                "name": "",
-                "duns": "",
-                "location": {
-                    "streetAddress": "",
-                    "streetAddress2": "",
-                    "city": {
-                        "code": "",
-                        "name": ""
-                    },
-                    "state": {
-                        "code": "",
-                        "name": ""
-                    },
-                    "zip": "",
-                    "country": {
-                        "code": "",
-                        "name": ""
-                    }
-                }
-            }
-        },
-        "justificationAuthority": {
-            "modificationNumber": "",
-            "authority": "dictionary"
-        },
-        "additionalReporting": [
-            "none"
-        ]
-    },
-    "description": [
-        {
-            "body": "test description"
-        }
-    ],
-    "related": {
-        "opportunityId": "f8ccfca94d794e07855ebe0d6f55c7d5"
-    },
-    "resources": [
-        {
-            "attType": "link",
-            "link": "https://faaco.faa.gov/index.cfm/attachment/download/84723",
-            "description": "test attachment pdf link"
-        },
-        {
-            "attType": "file",
-            "content": "SGVsbG8=",
-            "resourceName": "Hello.txt",
-            "fileType": "text/plain",
-            "packageAccessLevel": "private",
-            "explicitAccess": "1"
-        }
-    ]
-}
-

-

-

-
-
Back to top

 
 ### Revise Published Opportunity
 
@@ -755,7 +548,7 @@ Examples
 ------- | -------
 **Request Type** | POST
 **URL** | /v1/api/revise/{opportunityId}
-**Summary** | Create a draft version for a Published Opportunity.
+**Summary** | Create a draft version of an Opportunity for a Published Opportunity.
 **Consumes** | application/json
 **Produces** | JSON
 
@@ -896,12 +689,12 @@ Examples
             "name": ""
           }
         }
-      }
       },
       "justificationAuthority": {
         "modificationNumber": "",
         "authority": "dictionary"
       },
+    },
     "permissions": {
       "IVL": {
         "create": true,
@@ -920,6 +713,18 @@ Examples
       "type": "autocustom",
       "date": "2019-09-09"
     },
+    "flags": [
+      {
+        "code": "",
+        "isSelected": true
+      }
+    ],
+    "link": {
+      "additionalInfo": {
+        "content": ""
+      },
+      "href": ""
+    },
     "additionalReporting": [
       "none"
     ]
@@ -1001,6 +806,18 @@ Examples
       "type": "autocustom",
       "date": "2019-09-09"
     },
+    "flags": [
+      {
+        "code": "",
+        "isSelected": true
+      }
+    ],
+    "link": {
+      "additionalInfo": {
+        "content": ""
+      },
+      "href": ""
+    },
     "additionalReporting": [
       "none"
     ]
@@ -1239,6 +1056,8 @@ Examples
 
 ### Delete Draft Opportunity
 
+
+
 ------- | -------
 **Request Type** | DELETE
 **URL** | /v1/api/delete/{opportunityId}
@@ -1273,7 +1092,7 @@ _NA_
 
 ------- | -------
 **Request Type** | POST
-**URL** | /v1/api/{opportunityId}/requests
+**URL** |	/opps/v1/opportunities/{opportunityId}/requests
 **Summary** | Deletes all the versions or latest version of a notice
 **Consumes** | application/json
 **Produces** | JSON
@@ -1284,8 +1103,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 ---------------|----------------|------------|----------|------------
 Authorization	| Header | string |	Yes |	Valid and authorized user ID
 api_key |	query |	string |	Yes |	Valid System Account API Key
-opportunityId | query | string | Yes | Opportunity ID
-Request JSON|	Body|	JSON|	Yes|	[Refer Delete Notice Contract JSON](#delete-notice-contract-json)
+Request JSON|	Body|	JSON|	Yes|	Refer Delete Notice JSON
 
 Responses
 
@@ -1296,16 +1114,19 @@ HTTP Status Code | Response Type | Reason  | Description
 Examples
 
 

-Delete latest version of a notice:
+Delete Notice:
 

 
 {
-  "reason": "test",
-  "requestType": "delete_request",
-  "data": {
-    "description": "test",
-    "deleteOption": "latest"
-  }
+   "requestType":"delete_request",
+    "reason":"test",
+     "data":{
+              "description":"test",
+               "title":null,
+                "newArchiveDate":null,
+                "newArchiveType":null,
+                 "deleteOption":"latest"  ( “all”  - to delete all versions)
+              }
 }
 

 

@@ -1331,6 +1152,7 @@ api_key | query | string | Yes | Valid System Account API Key
 archivedFrom | query | date-time | No | Archive From UTC Date and Time 
Example: 2018-11-01 00:00:00
 archivedTo | query | date-time | No | Archive To UTC Date and Time 
Example: 2018-11-01 00:00:00
 awardNumber | query | string | No | Award Number
+cancelled (will be deprecated) | query | boolean | No | True or false
 doNumber | query | string | No | Delivery Order Number
 includeCount | query | boolean | No | True or false
 keyword | query | string | No | Enter any keyword from the description
@@ -1348,7 +1170,7 @@ responseTo | query | date-time | No | ResponseTo UTC Date and Time 
Example
 size | query | integer | No | Size limit is 10 by default
 solNumber | query | string | No | Solicitation Number
 sortBy | query | string | No | Sort (-createdOn, -modifiedOn)
-status| query | Array[string] | No | Active - All Published Active Notice 
 Draft - All Draft Notice 
 Published - All Published Notice 
 Inactive - All archived/Inactive Notice (before archive) 
 Cancelled - All Cancelled Notice 
(comma separated)
+status (To be updated) | query | Array[string] | No | 1.status= active (published, unarchive and uncancelled records)
 2.status=inactive (published, archive and uncancelled records)
3.status=draft (draft records)
 4.status=published (published and unarchive)
5.status=active_cancelled(published, unarchive and cancelled records)
6.status=inactive_cancelled(published, archive and cancelled records)
7. status=archived(published and archived) 
(comma separated)
 
 
Back to top

 
@@ -1560,6 +1382,7 @@ Examples
           "opportunityId": "8de3d88fc7642d9adcdb8d4ff9070399"
         },
         "related": {
+
         },
         "status": {
           "code": "draft",
@@ -1602,8 +1425,10 @@ Examples
           ]
         },
         "parent": {
+
         },
         "related": {
+
         },
         "status": {
           "code": "draft",
@@ -1703,8 +1528,10 @@ Examples
           ]
         },
         "parent": {
+
         },
         "related": {
+
         },
         "status": {
           "code": "published",
@@ -1957,20 +1784,15 @@ HTTP Status Code | Response Type | Reason  | Description
 
 Examples
 
-
 

-Uncancel Request for a Non Award Notice
+Uncancel Request (active Opportunity):
 

 
 {
-  "reason": "test",
+  "reason": "",
   "requestType": "uncancel_request",
   "data": {
-    "description": "test",
-    "newArchiveDate": null,
-    "newArchiveType": "auto15",
-    "newResponseDate": "2018-11-11T10:58:00-05:00",
-    "newResponseTz": "America/New_York"
+    "description": "test"
   }
 }
 

@@ -1978,19 +1800,18 @@ Examples
 

 
 

-UnCancel Request for a Award notice
+Uncancel Request (inactive Opportunity):
 

 
 {
-  "reason": "test uncancel for award notice",
+  "reason": "test",
   "requestType": "uncancel_request",
   "data": {
     "description": "test",
-    "newResponseDate": null,
-    "newResponseTz": null,
-    "newArchiveType": "autocustom",
-    "newArchiveDate": "2020-03-01",
-    "newContractAwardDate": "2020-02-02"
+    "newArchiveDate": null,
+    "newArchiveType": "auto15",
+    "newResponseDate": "2018-11-11T10:58:00-05:00",
+    "newResponseTz": "America/New_York"
   }
 }
 

@@ -2070,36 +1891,17 @@ HTTP Status Code | Response Type | Reason  | Description
 Examples
 
 

-Unarchive Request for a Non-Award notice
+Unarchive:
 

 
 {
   "reason": "test",
   "requestType": "unarchive_request",
   "data": {
-    "newResponseDate": "2019-12-12T00:12:00-05:00",
-    "newResponseTz": "America/New_York",
+    "newArchiveDate": null,
     "newArchiveType": "auto15",
-    "newArchiveDate": null
-  }
-}
-

-

-

-
-

-Unarchive Request for a Award notice
-

-
-{
-  "reason": "test unarchive for award notice",
-  "requestType": "unarchive_request",
-  "data": {
-    "newResponseDate": null,
-    "newResponseTz": null,
-    "newArchiveType": "autocustom",
-    "newArchiveDate": "2020-03-01",
-    "newContractAwardDate": "2020-02-02"
+    "newResponseDate": "2019-11-11T10:58:00-05:00",
+    "newResponseTz": "America/New_York"
   }
 }
 

@@ -2108,12 +1910,12 @@ Examples
 
 
Back to top

 
-### Create Resource in Draft Opportunity
+### Create Attachment in Draft Opportunity
 
 ------- | -------
 **Request Type** | POST
 **URL** |/v1/api/{opportunityId}/attachments
-**Summary** | Add attachment/link to a draft Opportunity
+**Summary** | Create attachment/link to a draft Opportunity
 **Consumes** | application/json
 **Produces** | JSON
 
@@ -2141,12 +1943,11 @@ Examples
 

 
 {
-    "attType": "file",
-    "content": "SGVsbG8=",
-    "resourceName": "Hello.txt",
-    "fileType": "text/plain",
-    "packageAccessLevel": "private",
-    "explicitAccess": "1"
+ "attType": "file",
+ "content": "SGVsbG8=",
+ "resourceName": "Hello.txt",
+ "fileType": "text/plain",
+ "packageAccessLevel": "public"
 }
 

 

@@ -2156,10 +1957,10 @@ Examples
 Create Attachment Request - link
 

 
-{
-    "attType": "link",
-    "link": "https://faaco.faa.gov/index.cfm/attachment/download/84723",
-    "description": "test attachment pdf link"
+{"attType":"link",
+ "link":"https://faaco.faa.gov/index.cfm/attachment/download/84723",
+ "description":"test attachment pdf link",
+"packageAccessLevel":null
 }
 

 

@@ -2167,116 +1968,14 @@ Examples
 
 
Back to top

 
-### Update Resource in Draft Opportunity
+### Update Attachment in Draft Opportunity
 
 ------- | -------
 **Request Type** | PATCH
 **URL** |/v1/api/{opportunityId}/attachments/{resourceId}
-**Summary** | Update draft attachment/link metadata on a draft Opportunity
-**Consumes** | application/json
-**Produces** | JSON
-
-Request Parameters
-
-Parameter Name | Parameter Type | Data Type  | Required | Description
----------------|----------------|------------|----------|------------
-Authorization | Header |  string | Yes | Valid and authorized user ID
-api_key | query | string | Yes | Valid System Account API Key
-opportunityId | query | string | Yes | Opportunity ID
-resourceId | query | string | Yes | Resource ID
-Request JSON | Body | JSON | Yes | [Refer Update Attachment Link Contract JSON](#update-attachment-contract-json)
-
-
Back to top

-
-Responses
-
-HTTP Status Code | Response Type | Reason  | Description
------------------|---------------|---------|------------
-200 | string | Attachment successfully updated | Resource ID returned
-
-Examples
-
-

-Update Attachment Request - Change File Access : Controlled Unclassified (Only applicable to files that are not published) 
-

-
-{
-  "attType": "file",
-  "packageAccessLevel": "private",
-  "explicitAccess": "1"
-}
-

-

-

-
-

-Update Attachment Request - Change File Access : Public (Only applicable to files that are not published) 
-

-
-{
-  "attType": "file",
-  "packageAccessLevel": "public",
-  "explicitAccess": "0"
-}
-

-

-

-
-

-Update Attachment Request - Change File Name (Only applicable to files that are not published)
-

-
-{
-  "resourceName": "newFileName.pdf"
-}
-

-

-

-
-

-Update Attachment Request - Change Resource Order (Applicable to both files and links)
-

-
-{
-  "sortOrderChanged": true,
-  "resourceIdBelow": "292dc517a19b4e43846f39d20e6f7ecf"
-}
-

-

-

-
-

-Update Attachment Request - Change Resource Order (Move resource to the bottom of the list. Applicable to both files and links)
-

-
-{
-  "sortOrderChanged": true
-}
-

-

-

-
-

-Update Attachment Request - Change Link Display text
-

-
-{
-  "resourceName": "New Display Text"
-}
-

-

-

-
-
Back to top

-
-### Delete Resource in Draft Opportunity
-
-------- | -------
-**Request Type** | DELETE
-**URL** |/v1/api/{opportunityId}/attachments/{resourceId}
-**Summary** | Delete an attachment/link from a draft opportunity.
-**Consumes** | Request Parameters
-**Produces** | NA
+**Summary** | Update an attachment metadata on a draft Opportunity
+**Consumes** | application/json
+**Produces** | JSON
 
 Request Parameters
 
@@ -2285,8 +1984,8 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-resourceId | query | string | Yes | Resource ID
-deleteAll | query | boolean | Yes | Should be true if deleting resource from all versions of a notice; else false. The deleted published resources will not show up for any further revisions that will be created. 
+resourceId | query | string | Yes | Attachment ID
+Request JSON | Body | JSON | Yes | [Refer Update Attachment Contract JSON](#update-attachment-contract-json)
 
 
Back to top

 
@@ -2294,11 +1993,39 @@ Responses
 
 HTTP Status Code | Response Type | Reason  | Description
 -----------------|---------------|---------|------------
-204 | string | Attachment successfully deleted | NA
+200 | string | Attachment successfully updated | Resource ID returned
 
 Examples
 
-_NA_
+

+Update Attachment Request - file
+

+
+{
+  "attType": "file",
+  "packageAccessLevel": "private",
+   "explicitAccess": "1",
+ "content": "SGVsbG8=",
+ "fileType": "text/plain"
+}
+

+

+

+
+

+Update Attachment Request - link
+

+
+{
+  "attType": "file",
+  "packageAccessLevel": "private",
+   "explicitAccess": "1",
+ "content": "SGVsbG8=",
+ "fileType": "text/plain"
+}
+

+

+

 
 
Back to top

 
@@ -2476,7 +2203,7 @@ ivl": [
 
 ------- | -------
 **Request Type** | GET
-**URL** |	/v1/api/resource
+**URL** |	/opps/v1/api/resource
 **Summary** | Download all attachments from resource ID
 **Consumes** | application/json
 **Produces** | JSON
@@ -2488,7 +2215,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization|	Header|	string|	Yes|Valid and authorized user ID
 Api_key	query	| string|	Yes|	Valid System Account API Key
 ResourceID	|query|	string|	Yes	| Resource ID
-excludeDeleted | query | string | No|
+
 
 Responses
 
@@ -2532,7 +2259,7 @@ Examples
 
 ------- | -------
 **Request Type** | GET
-**URL** |	/v1/api/resources
+**URL** |	/opps/v1/api/resources
 **Summary** | Download all attachments from opportunity ID
 **Consumes** | application/json
 **Produces** | JSON
@@ -2544,7 +2271,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization|	Header|	string|	Yes|Valid and authorized user ID
 Api_key	query	| string|	Yes|	Valid System Account API Key
 OpportunityID	|query|	string|	Yes	| Opportunity ID
-excludeDeleted | query | string | No|
+
 
 Responses
 
@@ -2631,12 +2358,42 @@ Examples
 
 
Back to top

 
+### Delete Vendor
+
+
+------- | -------
+**Request Type** | DELETE
+**URL** | /v2/opportunities/{opportunityId}/ivl/{entityid}
+**Summary** | Delete Vendor from IVL for Opportunity ID
+**Consumes** | Request Parameters
+**Produces** | JSON
+
+Request Parameters
+
+Parameter Name | Parameter Type | Data Type  | Required | Description
+---------------|----------------|------------|----------|------------
+Authorization | Header |  string | Yes | Valid and authorized user ID
+api_key | query | string | Yes | Valid System Account API Key
+opportunityId | query | string | Yes | Opportunity ID
+entityid | query | string | Yes | DUNS number for the business entity
+
+Responses
+
+HTTP Status Code | Response Type | Reason  | Description
+-----------------|---------------|---------|------------
+204 | string | Vendor successfully deleted | NA
+
+Examples
+
+N/A
+
+
Back to top

 
 ### Get Authorized Party ###
 
 ------- | -------
 **Request Type** | GET
-**URL** | /v1/api/opportunities/access/{opportunityId}/accessRequest
+**URL** | /v1/opportunities/access/{opportunityId}/accessRequest
 **Summary** | Summary	Get Authorized Party list for the explicit access requests submitted to an Opportunity
 **Consumes** | application/json
 **Produces** | JSON
@@ -2648,6 +2405,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization|	Header	|string	|Yes	|Valid and authorized user ID
 api_key|	query|	string|	Yes|	Valid API Key
 opportunityId	|query	|string|	Yes|	Opportunity ID
+status|	query|	string|	No|	Request access status can be: Pending, Approved, Rejected, or blank to get all request details for a notice
 
 
 Responses
@@ -2663,6 +2421,7 @@ Examples
 

 
 {
+
     "_embedded": {
         "authorizedPartyList": [
             {
@@ -2714,7 +2473,7 @@ Examples
 
 ------- | -------
 **Request Type** | POST
-**URL** | /v1/api/opportunities/access/{opportunityId}/accessRequest
+**URL** | /v1/opportunities/access/{opportunityId}/accessRequest
 **Summary** | Add a Vendor as an Authorized Party for a notice to grant access to all the secured attachments across all the versions . This API will create and approve the request for the vendor.
 **Consumes** | application/json
 **Produces** | JSON
@@ -2726,7 +2485,7 @@ Parameter Name | Parameter Type | Data Type  | Required | Description
 Authorization | Header |  string | Yes | Valid and authorized user ID
 api_key | query | string | Yes | Valid System Account API Key
 opportunityId | query | string | Yes | Opportunity ID
-Request JSON  | Body | JSON | Yes | [Refer Vendor Data Contract JSON](#vendor-data-contract-json)
+Request JSON  | Body | JSON | Yes | [Refer Vendor Data JSON](#vendor-data-json)
 
 Responses
 
@@ -2737,16 +2496,16 @@ HTTP Status Code | Response Type | Reason  | Description
 Examples
 
 

-Request – Add Authorized Party
+Response – Add Authorized Party
 

 
 {
 "lname":"test",
 "fname":"test123",
-"email":"testuser.de@gmail.com",
-"contractorName":"test contractor",
-"duns":"608999570",
-"cageCode":"4CHY"
+"email":"reitestuser.de@gmail.com",
+"contractorName":"",
+"duns":"608999520",
+"cageCode":""
 }
 

 

@@ -2871,115 +2630,140 @@ Examples
 

 
 {
-    "data": {
-        "type": "",
-        "solicitationNumber": "",
-        "title": "",
-        "organizationId": "",
-        "classificationCode": "",
-        "naics": [
-            {
-                "type": "primary",
-                "code": [
-                    ""
-                ]
-            }
-        ],
-        "pointOfContact": [
-            {
-                "type": "primary",
-                "title": "",
-                "fullName": "",
+   "data": {
+        "solicitationNumber": "Test1",
+        "title": "TST_T1",
+        "type": "p",
+        "classificationCode": "13",
+        "organizationId": "100000136",
+        "organizationLocationId": "",
+        "naics": [{
+            "type": "primary",
+            "code": ["111150"]
+        }],
+        "pointOfContact": [{
+                "additionalInfo": {
+                        "content": ""
+                },
                 "email": "",
-                "phone": "",
                 "fax": "",
-                "additionalInfo": {
-                    "content": ""
-                }
-            }
-        ],
+                "fullName": "Veera",
+                "phone": "",
+                "title": "",
+                "type": "primary"
+        }],
         "placeOfPerformance": {
-            "streetAddress": "",
-            "streetAddress2": "",
-            "city": {
-                "code": "",
-                "name": ""
-            },
-            "country": {
-                "code": "",
-                "name": ""
-            },
-            "state": {
-                "code": "",
-                "name": ""
-            },
-            "zip": ""
-        },
-        "archive": {
-            "type": "autocustom",
-            "date": "2019-09-09"
-        },
-        "permissions": {
-            "IVL": {
-                "create": false,
-                "delete": false,
-                "read": false,
-                "update": false
-            }
-        },
-        "solicitation": {
-            "setAside": "SBA",
-            "deadlines": {
-                "response": "2019-08-08"
-            }
-        },
-        "award": {
-            "date": "",
-            "number": "",
-            "deliveryOrderNumber": "",
-            "amount": "",
-            "lineItemNumber": "",
-            "awardee": {
-                "manual": false,
-                "name": "",
-                "duns": "",
-                "location": {
-                    "streetAddress": "",
-                    "streetAddress2": "",
-                    "city": {
+                "city": {
                         "code": "",
                         "name": ""
-                    },
-                    "state": {
+                },
+                "country": {
                         "code": "",
                         "name": ""
-                    },
-                    "zip": "",
-                    "country": {
+                },
+                "state": {
                         "code": "",
                         "name": ""
-                    }
+                },
+                "streetAddress": "",
+                "streetAddress2": "",
+                "zip": ""
+        },
+        "award": {
+                "date": "",
+                "number": "",
+                "deliveryOrderNumber": "",
+                "amount": "number",
+                "lineItemNumber": "",
+                "awardee": {
+                        "manual": false,
+                        "name": "",
+                        "duns": "",
+                        "location": {
+                                "streetAddress": "",
+                                "streetAddress2": "",
+                                "city": {
+                                        "code": "",
+                                        "name": ""
+                                },
+                                "state": {
+                                        "code": "",
+                                        "name": ""
+                                },
+                                "zip": "",
+                                "country": {
+                                        "code": "",
+                                        "name": ""
+                                }
+                        }
+                },
+                "justificationAuthority": {
+                        "modificationNumber": "",
+                        "authority": "dictionary"
+                },
+                "fairOpportunity": {
+                        "authority": ""
+                }
+        },
+        "permissions": {
+                "IVL": {
+                        "create": false,
+                        "delete": false,
+                        "read": false,
+                        "update": false
                 }
+        }, 
+          "solicitation": {
+            "setAside": "SBA",
+            "deadlines": {
+                "response": "2019-08-08"
             }
         },
-        "justificationAuthority": {
-            "modificationNumber": "",
-            "authority": "dictionary"
+       "archive": {
+            "type": "autocustom",
+            "date": "2019-09-09"
         },
-        "additionalReporting": [
-            "none"
+        "flags": [{
+                "code": "",
+                "isSelected": true
+        }],
+        "link": {
+                "additionalInfo": {
+                        "content": ""
+                },
+                "href": ""
+        },
+         "additionalReporting": [
+                "none"
         ]
+        },
+ "description": [{
+        "body": ""
+    }],
+     "resources": [{
+        "attType": "link",
+
+        "link": "http://beta.sam.gov",
+
+        "description": "test beta sam link",
+
+        "packageAccessLevel": null
     },
-    "description": [
-        {
-            "body": ""
-        }
-    ],
-    "related": {
-        "opportunityId": ""
-    }
-}
+    {
+       "attType": "link",
+
+        "link": "https://faaco.faa.gov/index.cfm/attachment/download/84723",
+
+        "description": "test attachment pdf link",
+
+        "packageAccessLevel": null
+
+    }],
 
+    "postedDate": "20190423",
+
+    "archived": false
+}
 

 

 

@@ -2987,82 +2771,96 @@ Examples
 
 * Field headers in the table must match with field headers shown in JSON example  
 
-Name | Data Type |Field Length | Allowed Values | Required (Create/Update) | Required (Publish) | Description
------|-----------|-------|-------------------|------------|------------ |----------
-type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Yes | Notice Type
-solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {} |No | Yes (No for type = s  (Special Notice)) | Solicitation Number
-title | string | 256 characters | |Yes | Yes | Title of the Opportunity
-organizationId | string | 32 characters | | Yes | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
-classificationCode | string |  | | No | Yes (No for type = r, g, a  (SourcesSought, Sale of Surplus, Awards)) | Product Service Code (PSC)
-naics | JSON Array | NA |NA | NA | NA |
-naics.code | Array of String | | NAICS Reference| No | Yes for type = k, o (Combined Synopsis, Solicitation) | Valid NAICS Code
-naics.type | string | |primary| No | Yes | NAICS Type Note: 'p' must be in lower case
-pointOfContact | JSON Array | NA |NA | NA | NA |
-pointOfContact.type | string | | primary
 secondary | No | Yes (No for type = a, s (Award, Special Notice)) | Contact Type Note: 'p' and 's' must be in lower case
-pointOfContact.title | string | |  | No | No | Contact title
-pointOfContact.fullname | string | 255 characters| | No | Yes (No for type = a (Award))| Contact Full Name
-pointOfContact.email | string |255 characters | | No  | Yes (No for type = a (Award))  | Contact email
-pointOfContact.phone | string |255 characters | | No | No | Contact Phone
-pointOfContact.fax | string | 255 characters | | No  | No | Contact Fax
-pointOfContact.additionalInfo | JSON |NA |NA | NA  | NA |  Any additional information on Point of Contact
-pointOfContact.additionalInfo.
content | String | | | No  | No | Details of the additional information on Point of Contact 
-placeOfPerformance | JSON | NA | NA | NA | NA |
-placeOfPerformance.
streetAddess | string | | | No | No | Pop Address
-placeOfPerformance.
streetAddess2 | string | | | No | No | Pop Address2
-placeOfPerformance.city | JSON | NA | NA | NA | NA | Pop City
-placeOfPerformance.city.
code | string | | | No | No | Pop City code
-placeOfPerformance.city.
name | string | | | No | No | Pop City name
-placeOfPerformance.state | JSON |NA | NA | NA | NA | Pop City state
-placeOfPerformance.state.
code | string | | | No | No | Pop city state code
-placeOfPerformance.state.
name | string | | | No | No | Pop city state name
-placeOfPerformance.country | JSON | NA | NA | NA | NA | Pop Country
-placeOfPerformance.
country.code | string | | | No | No | Pop Country Code
-placeOfPerformance.
country.name | string | | | No | No | Pop Country name
-placeOfPerformance.zip | string | | | No | No | Pop Country zip
-archive | JSON |NA | NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15
 auto30
 autocustom | No | Yes | Archive Type
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | | No | Yes for archive.type = autocustom | Archive Date
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
-permissions | JSON | NA | NA | NA | NA |
-permissions.ivl | JSON | NA | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a interest in the notice
-permissions.ivl.create | boolean | | | No | Yes (No for type = a (Award)) | IVL create permission
-permissions.ivl.read | boolean | | | No | Yes (No for type = a (Award)) | IVL read permission
-permissions.ivl.update | boolean | |  | No | No | IVL update permission
-permissions.ivl.delete | boolean | | | No | No | IVL delete permission
-solicitation | JSON |NA | NA | NA | NA |
-solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | No | Set-Aside code
 The designator for type of set aside determined for the contract action
-solicitation.deadlines | JSON | NA | NA | NA | NA |Response deadline date for Contract opportunity
-solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes for type = k, o (Combine Synopsis, Solicitation) 
2)	Yes if archive.type=auto15 except type = a (Award)	| Deadline Date
-solicitation.deadlines.
responseTz |string | | | No | No | Time Zone for 
Solicitation Deadline Date
-award | JSON | NA | NA | NA | NA | This section is mainly used for providing award information that is required for Award, Justification and Intent to Bundle opportunity types
-award.date | date | |YYYY-MM-DD |No | Yes only for type = a (Award) | Award Date
-award.number | string | 255 characters | |No | Yes only for type= i, j, a (Intent to Bundle, Justification, Award) | Award Number
-award.deliverOrderNumber | string | 255 characters| | No | Yes only for type = j (Justification) | Award Delivery Order Number
-award.amount | number |64 digits |  | No | Yes only for type = a (Award) | Award Amount
-award.lineitemNumber | string |255 characters | | No | No | Contract Line item Number
-award.awardee | JSON | NA| NA | NA | NA |Awardee details; Only for type = a (Award)
-award.awardee.name | string | 255 characters | | No | No; Either awardee.name or awardee.duns is required | Awardee Name
-award.awardee.duns | string | 9 digits | | No | No; Either awardee.name or awardee.duns is required | Awardee Duns
-award.awardee.location | JSON |NA | NA | NA | NA | Awardee Location details; **Required if awardee.name is provided**
-award.awardee.location.
streetAddress | string | | | No | No | Awardee Street Address 
-award.awardee.location.
streetAddress2 | string | | | No | No | Awardee Street Address 2
-award.awardee.location.
city | JSON |NA |NA |NA | NA | Awardee City details
-award.awardee.location.
city.code | string | | | No | Yes | Awardee City code
-award.awardee.location.
city.name | string | | | No | No | Awardee City name
-award.awardee.location.
state | JSON | NA | NA | NA | NA | Awardee State details
-award.awardee.location.
state.code | string | | | No | Yes | Awardee State code
-award.awardee.location.
state.name | string | | | No | No | Awardee State name
-award.awardee.location.
country | JSON | NA| NA | NA | NA |Awardee Country details
-award.awardee.location.
country.code | string | | | No | Yes | Awardee Country code
-award.awardee.location.
country.name | string | | | No | No | Awardee Country Name
-award.awardee.location.
zip | string | | | No | No | Awardee Country Zip code
-justificationAuthority | JSON |NA |NA | NA | NA | Only for type = j (Justification)
-justificationAuthority.
modificationNumber | string | 32 characters| | No | No | Justification Authority Modification Number
-justificationAuthority.
authority | string|  |  | No | Yes | Justification Authority
-additionalReporting | string | |None, 
auto_recovery | No | Yes; No for type = s (Special Notice) | Initiative that applies to the notice
-description | JSON | NA | NA | NA | NA |
-description.body | string | 65535 characters| | No | Yes; No for type = a (Award) | Description of the notice
-related | JSON | NA | NA | NA | NA | Related Notice information
-related.opportunityId | string | 32 characters| | No | No | Opportunity Id of the related notice
+Name | Data Type | Allowed Values | Required (Create/Update) | Required (to Publish) | Description
+-----|-----------|----------------|--------------------------|-----------------------|------------
+type | string | See Notice Types table | Yes | Yes | Notice Type
+solicitationNumber | string |  | No | Yes | Solicitation Number
+title | string |  | Yes | Yes | Title of the Opportunity
+organizationId | string |  | No for Create (Yes for Update) | Yes | FH Org Id/AAC code of the office where an Opportunity is being submitted
+organizationLocationId | string | | No|No| Organization Location ID
+classificationCode | string |  | No | Yes (not required for type= r) | Product Service Code (PSC)
+naics | JSON | NA | NA | NA |
+naics.code | string |  | No | Yes | NAICS Code
+naics.type | string | primary  | No | Yes | NAICS Type Note: 'p' must be in lower case
+flags | JSON | NA | NA | NA |
+flags.code | string | Recovery act | No | No | This is a recovery or Reinvestment Act Action
+flags.IsSelected | boolean | default = True | No | No |
+pointOfContact | JSON | NA | NA | NA |
+pointOfContact.type | string | p | No | Yes | Contact Type Note: 'p' must be in lower case
+pointOfContact.title | string |  | No | No | Contact title
+pointOfContact.fullname | string |  | No | Yes | Contact Full Name
+pointOfContact.email | string |  | No  | Yes (no if type = a)  | Contact email
+pointOfContact.phone | string |  | No | No | Contact Phone
+pointOfContact.fax | string |  | No  | No | Contact Fax
+placeOfPerformance | JSON | NA | NA | NA |
+placeOfPerformance.
streetAddess | string |  | No | No | Pop Address
+placeOfPerformance.
streetAddess2 | string |  | No | No | Pop Address2
+placeOfPerformance.city | JSON | NA | NA | NA | Pop City
+placeOfPerformance.city.
code | string |  | No | No | Pop City code
+placeOfPerformance.city.
name | string |  | No | No | Pop City name
+placeOfPerformance.state | JSON | NA | NA | NA | Pop City state
+placeOfPerformance.state.
code | string |  | No | No | Pop city state code
+placeOfPerformance.state.
name | string |  | No | No | Pop city state name
+placeOfPerformance.country | JSON | NA | NA | NA | Pop Country
+placeOfPerformance.
country.code | string |  | No | No | Pop Country Code
+placeOfPerformance.
country.name | string |  | No | No | Pop Country name
+placeOfPerformance.zip | string |  | No | No | Pop Country zip
+archive | JSON | NA | NA | NA |
+archive.type | string | auto15, auto30, autocustom | No | Yes | Archive Type
+archive.date | date |  | No | Yes (if archive.type=
autocustom) | Archive Date
+permissions | JSON | NA | NA | NA |
+permissions.ivl | JSON | NA | NA | NA |
+permissions.ivl.create | boolean |  | No | No | permissions.ivl.create
+permissions.ivl.read | boolean |  | No | No | permissions.ivl.read
+permissions.ivl.update | boolean | Not In Use | Not In Use | Not In Use | Not In Use
+permissions.ivl.delete | boolean | Not In Use | Not In Use | Not In Use | Not In Use
+solicitation | JSON | NA | NA | NA |
+solicitation.setAside | string | See Set-Aside values table | No | No | setAside
+solicitation.deadlines | JSON | NA | NA | NA |
+solicitation.
deadlines.response | date | YYYY-MM-DDTHH:MM:SS-05:00 | No | 1) Yes (for type=k,o) 
2)	Yes (when archive.type=
auto1)	| Deadline Date
+solicitation.deadlines.
responseresponseTz | string | | No | No | Time Zone for 
Solicitation Deadline Date
+award | JSON | NA | NA | NA |
+award.date | date | YYYY-MM-DD |No | Yes only for type= a | Award Date
+award.number | string |  | No | Yes only for type= i, j, a | Award Number
+award.deliverOrderNumber | string |  | No | No | Award Deliver Order Number
+award.amount | number |  | No | No | Award Amount
+award.lineitemNumber | string |  | No | No | Award Line item Number
+award.awardee | JSON | NA | NA | NA |
+award.awardee.manual | string | boolean  | Yes | Yes  | Awardee
+award.awardee.name | string |  | No | No | Awardee Name
+award.awardee.duns | string |  | No | No | Awardee Duns
+award.awardee.location | JSON | NA | NA | NA |
+award.awardee.location.
streetAddress | string |  | No | No | Awardee Street Address 1
+award.awardee.location.
streetAddress2 | string |  | No | No | Awardee Street Address 1
+award.awardee.location.
city | string |  | No | No | Awardee City
+award.awardee.location.
city.code | string |  | No | No | Awardee City code
+award.awardee.location.
city.name | string |  | No | No | Awardee City name
+award.awardee.location.
state | JSON | NA | NA | NA |
+award.awardee.location.
state.code | string |  | No | No | Awardee State code
+award.awardee.location.
state.name | string |  | No | No | Awardee State name
+award.awardee.location.
country | JSON | NA | NA | NA |
+award.awardee.location.
country.code | string |  | No | No | Awardee Country code
+award.awardee.location.
country.name | string |  | No | No | Awardee Country Name
+award.awardee.location.
zip | string |  | No | No | Awardee Country Zip
+justificationAuthority | JSON | NA | NA | NA |
+justificationAuthority.
modificationNumber | string |  | No | No | Justification Authority Modification Number
+justificationAuthority.
authority | string |  | No | No | Justification Authority
+link | JSON | NA | NA | NA |
+link.additionalInfo | JSON | NA | NA | NA |
+link.additionalInfo.cotent | string |  | No | No | Additional info
+link.href | string |  | No | No | Website Address
+additionalReporting | string | none/
auto_recovery | No | Yes |
+description | JSON | NA | NA | NA |
+description.body | string |  | No | Yes | Description of notice
+attType | string | link, file | No |No| Type of attachment, either link or file
+content | byte |  | No|No | File content in byte format
+link | string |  | |No|No | Resource link or URL
+packageAccessLevel | string | public,private(default public) | No | No| Type of access to file or link
+resourceName | string |  | No|No | Name of file
+fairOpportunity | string | |No|No| Fair Opportunity|
+fairOpportunity.authority|string | |No|No| Fair Opportunity Authority
+postedDate| date| |No|No| Posted Date
+archived| string| | |No|No| Archived Status
 
 
Back to top

 
@@ -3089,234 +2887,6 @@ Name | Data Type | Allowed Values | Required | Description
 requestType | string | publish_request | Yes | Type of request
 reason | string |  | No | Publish reason
 
-
Back to top

-
-### Create and Publish Opportunity Contract JSON
-
-
-

-

-Create_Publish_Opportunity_Contract_Json
-

-
-{
-    "data": {
-        "type": "",
-        "solicitationNumber": "",
-        "title": "",
-        "organizationId": "",
-        "classificationCode": "",
-        "naics": [
-            {
-                "type": "primary",
-                "code": [
-                    ""
-                ]
-            }
-        ],
-        "pointOfContact": [
-            {
-                "type": "primary",
-                "title": "",
-                "fullName": "",
-                "email": "",
-                "phone": "",
-                "fax": "",
-                "additionalInfo": {
-                    "content": ""
-                }
-            }
-        ],
-        "placeOfPerformance": {
-            "streetAddress": "",
-            "streetAddress2": "",
-            "city": {
-                "code": "",
-                "name": ""
-            },
-            "country": {
-                "code": "",
-                "name": ""
-            },
-            "state": {
-                "code": "",
-                "name": ""
-            },
-            "zip": ""
-        },
-        "archive": {
-            "type": "autocustom",
-            "date": "2019-09-09"
-        },
-        "permissions": {
-            "IVL": {
-                "create": false,
-                "delete": false,
-                "read": false,
-                "update": false
-            }
-        },
-        "solicitation": {
-            "setAside": "SBA",
-            "deadlines": {
-                "response": "2019-08-08"
-            }
-        },
-        "award": {
-            "date": "",
-            "number": "",
-            "deliveryOrderNumber": "",
-            "amount": "",
-            "lineItemNumber": "",
-            "awardee": {
-                "manual": false,
-                "name": "",
-                "duns": "",
-                "location": {
-                    "streetAddress": "",
-                    "streetAddress2": "",
-                    "city": {
-                        "code": "",
-                        "name": ""
-                    },
-                    "state": {
-                        "code": "",
-                        "name": ""
-                    },
-                    "zip": "",
-                    "country": {
-                        "code": "",
-                        "name": ""
-                    }
-                }
-            }
-        },
-        "justificationAuthority": {
-            "modificationNumber": "",
-            "authority": "dictionary"
-        },
-        "additionalReporting": [
-            "none"
-        ]
-    },
-    "description": [
-        {
-            "body": ""
-        }
-    ],
-    "related": {
-        "opportunityId": ""
-    },
-    "resources": [
-        {
-            "attType": "link",
-            "link": "",
-            "description": ""
-        },
-        {
-            "attType": "file",
-            "content": "",
-            "resourceName": "",
-            "packageAccessLevel": "",
-            "explicitAccess": "",
-            "exportControlled": null
-        }
-    ]
-}
-

-

-

-

-
-* Field headers in the table must match with field headers shown in JSON example  
-
-Name | Data Type |Field Length | Allowed Values| Required | Description
------|-----------|-------|-------------------|------------|------------ 
-type | string | 1 character| [Refer Notice Types](#notice-types) | Yes | Notice Type
-solicitationNumber | string | 128 characters |a-z A-Z 0-9 - _ ( ) {}| Yes (No for type = s  (Special Notice)) | Solicitation Number
-title | string | 256 characters | | Yes | Title of the Opportunity
-organizationId | string | 32 characters | | Yes | FH Organization Id/AAC code of the office where an Opportunity is being submitted
-classificationCode | string |  | | Yes (No for type = r, g, a  (SourcesSought, Sale of Surplus, Awards)) | Product Service Code (PSC)
-naics | JSON Array | NA |NA | NA |
-naics.code | Array of String | | NAICS Reference| Yes for type = k, o (Combined Synopsis, Solicitation) | Valid NAICS Code
-naics.type | string | |primary|Yes | NAICS Type Note: 'p' must be in lower case
-pointOfContact | JSON Array | NA |NA | NA |
-pointOfContact.type | string | | primary
 secondary | Yes (No for type = a, s (Award, Special Notice)) | Contact Type Note: 'p' and 's' must be in lower case
-pointOfContact.title | string | |  | No | Contact title
-pointOfContact.fullname | string | 255 characters| | Yes (No for type = a (Award))| Contact Full Name
-pointOfContact.email | string |255 characters | | Yes (No for type = a (Award))  | Contact email
-pointOfContact.phone | string |255 characters | | No | Contact Phone
-pointOfContact.fax | string | 255 characters | | No | Contact Fax
-pointOfContact.additionalInfo | JSON |NA |NA | NA |  Any additional information on Point of Contact
-pointOfContact.additionalInfo.
content | String | | | No | Details of the additional information on Point of Contact 
-placeOfPerformance | JSON | NA | NA | NA |
-placeOfPerformance.
streetAddess | string | | |No | Pop Address
-placeOfPerformance.
streetAddess2 | string | | | No | Pop Address2
-placeOfPerformance.city | JSON | NA | NA |NA | Pop City
-placeOfPerformance.city.
code | string | | |No | Pop City code
-placeOfPerformance.city.
name | string | | |No | Pop City name
-placeOfPerformance.state | JSON |NA | NA |NA | Pop City state
-placeOfPerformance.state.
code | string | | | No | Pop city state code
-placeOfPerformance.state.
name | string | | | No | Pop city state name
-placeOfPerformance.country | JSON | NA | NA | NA | Pop Country
-placeOfPerformance.
country.code | string | | |No | Pop Country Code
-placeOfPerformance.
country.name | string | | |No | Pop Country name
-placeOfPerformance.zip | string | | |No | Pop Country zip
-archive | JSON |NA | NA | NA | Contract opportunity archive policy information
-archive.type | string | | auto15
 auto30
 autocustom | Yes | Archive Type
The policy will determine the date either by validation of other dates associated to the notice or by a manually entered date that will be used for marking the notice inactive
-archive.date | date | | |Yes for archive.type = autocustom | Archive Date
 This date will indicate when a notice will be moved to the inactive status. This date must be in the future
-permissions | JSON | NA | NA | NA 
-permissions.ivl | JSON | NA | NA | NA |Government determined use and visibility of the 'Interested Vendor's List' where users outside the notice can indicate a interest in the notice
-permissions.ivl.create | boolean | | | Yes (No for type = a (Award)) | IVL create permission
-permissions.ivl.read | boolean | | |Yes (No for type = a (Award)) | IVL read permission
-permissions.ivl.update | boolean | |  | No | IVL update permission
-permissions.ivl.delete | boolean | | |No | IVL delete permission
-solicitation | JSON |NA | NA | NA 
-solicitation.setAside | string | |[Refer Set-Aside Values](#set-aside-values) | No | Set-Aside code
 The designator for type of set aside determined for the contract action
-solicitation.deadlines | JSON | NA | NA | NA |Response deadline date for Contract opportunity
-solicitation.
deadlines.response | date | |YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for type = k, o (Combine Synopsis, Solicitation) 
2)	Yes if archive.type=auto15 except type = a (Award)	| Deadline Date
-solicitation.deadlines.
responseTz |string | | |No | Time Zone for 
Solicitation Deadline Date
-award | JSON | NA | NA | NA| This section is mainly used for providing award information that is required for Award, Justification and Intent to Bundle opportunity types
-award.date | date | |YYYY-MM-DD | Yes only for type = a (Award) | Award Date
-award.number | string | 255 characters | |Yes only for type= i, j, a (Intent to Bundle, Justification, Award) | Award Number
-award.deliverOrderNumber | string | 255 characters| | Yes only for type = j (Justification) | Award Delivery Order Number
-award.amount | number |64 digits |  | Yes only for type = a (Award) | Award Amount
-award.lineitemNumber | string |255 characters | | No | Contract Line item Number
-award.awardee | JSON | NA| NA | NA |Awardee details; Only for type = a (Award)
-award.awardee.name | string | 255 characters | | No; Either awardee.name or awardee.duns is required | Awardee Name
-award.awardee.duns | string | 9 digits | | No; Either awardee.name or awardee.duns is required | Awardee Duns
-award.awardee.location | JSON |NA | NA | NA | Awardee Location details; **Required if awardee.name is provided**
-award.awardee.location.
streetAddress | string | | | No | Awardee Street Address 
-award.awardee.location.
streetAddress2 | string | | | No | Awardee Street Address 2
-award.awardee.location.
city | JSON |NA |NA |NA | Awardee City details
-award.awardee.location.
city.code | string | | | Yes | Awardee City code
-award.awardee.location.
city.name | string | | | No | Awardee City name
-award.awardee.location.
state | JSON | NA | NA | NA | Awardee State details
-award.awardee.location.
state.code | string | | | Yes | Awardee State code
-award.awardee.location.
state.name | string | | | No | Awardee State name
-award.awardee.location.
country | JSON | NA| NA | NA |Awardee Country details
-award.awardee.location.
country.code | string | | | Yes | Awardee Country code
-award.awardee.location.
country.name | string | | |  No | Awardee Country Name
-award.awardee.location.
zip | string | | | No | Awardee Country Zip code
-justificationAuthority | JSON |NA |NA | NA | Only for type = j (Justification)
-justificationAuthority.
modificationNumber | string | 32 characters| | No | Justification Authority Modification Number
-justificationAuthority.
authority | string|  |  | Yes | Justification Authority
-additionalReporting | string | |none, 
auto_recovery | Yes; No for type = s (Special Notice) | Initiative that applies to the notice
-description | JSON | NA | NA | NA |
-description.body | string | 65535 characters| | Yes; No for type = a (Award) | Description of the notice
-related | JSON | NA | NA | NA | Related Notice information
-related.opportunityId | string | 32 characters| | No | Opportunity Id of the related notice
-resources | JSON |NA | NA | NA |
-resources.attType | string | |link, file | No| Type of attachment, either link or file
-resources.content | byte |250MB |  | No | File content in base64 format
-resources.link | string | 255 characters | |No | Resource link URL
-resources.packageAccessLevel | string | | public,
private
(default public) |  No| Type of access to file
-resources.resourceName | string | 255 characters |  | No | Name of file
-resources.description | string |255 characters | | No | Description of the link
-resources.explicitAccess | string |1 character | 0, 1 (defaults to '0' public access, if not provided) |No |Explicit Access. For Controlled Unclassified files, specify '1'
-resources.exportControlled | string |1 character | 0 | No |Export Controlled. * Captured for future JCP validation
-
-
 
Back to top

 
 ### Revise Opportunity Contract JSON
@@ -3340,7 +2910,7 @@ resources.exportControlled | string |1 character | 0 | No |Export Controlled. *
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 requestType | string | update_publish_request | Yes | Type of request
-reason | string |  | No | Reason for revision
+reason | string |  | Yes | Reason for revision
 
 
Back to top

 
@@ -3367,7 +2937,7 @@ reason | string |  | No | Reason for revision
 
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
-reason | string |  | No | Reason for cancelation
+Reason | string |  | Yes | Reason for cancelation
 requestType | string | cancel_request | Yes | Type of request
 description | string |  | Yes | Description for cancelation
 
@@ -3382,14 +2952,15 @@ description | string |  | Yes | Description for cancelation
 
 {
   "reason": "",
-  "requestType": "uncancel_request",
+  "requestType": " uncancel_request ",
   "data": {
     "description": "",
     "newContractAwardDate": "",
     "newArchiveDate": "",
     "newArchiveType": "",
     "newResponseDate": "",
-    "newResponseTz": "America/New_York"
+    "newResponseTz": "America/New_York",
+    "newContractAwardDate": ""
   }
 }
 

@@ -3404,11 +2975,12 @@ Name | Data Type | Allowed Values | Required | Description
 reason | string |  | Yes | Reason for uncanceling
 requestType | string | uncancel_request | Yes | Type of request
 description | string |  | Yes | Description for uncanceling
-newContractAwardDate | date | YYYY-MM-DD | Yes only for type = a (Award)| New Contract Award Date
-newArchiveDate | date | YYYY-MM-DD | Yes if newArchiveType=autocustom | New Archive Date
-newArchiveType | string | auto15,
 auto30,
 autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for types = k, o (Combined Synopsis/Solicitation) 2) Yes if newArchive.type=auto15 except for type = a (Award) | New Response Date
-newResponseTz | string |  | No | New Response Time Zone
+newContractAwardDate | date | YYYY-MM-DD | Yes (if unarchiving an award notice) | New Contract Award Date
+newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustome) | New Archive Date
+newArchiveType | string | auto15, auto30, autocustom | Yes  | New Archive Type
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | Yes (if newArchiveType = auto15) | New Response Date
+newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) | New Response Time Zone
+newContractAwardDate | date | YYYY-MM-DD | Yes (if type=a) | New Contract Award Date
 
 
Back to top

 
@@ -3433,7 +3005,7 @@ newResponseTz | string |  | No | New Response Time Zone
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
 requestType | string | archive_request | Yes | Type of request
-reason | string |  | No | Archive reason
+reason | string |  | Yes | Archive reason
 
 
Back to top

 
@@ -3464,13 +3036,13 @@ reason | string |  | No | Archive reason
 
 Name | Data Type | Allowed Values | Required | Description
 -----|-----------|----------------|----------|------------
-reason | string |  | Yes | Reason for unarchiving
+reason | string |  | Yes | Reason for uncanceling
 requestType | string | unarchive_request | Yes | Type of request
-newContractAwardDate | date | YYYY-MM-DD | Yes for type = a (Award)| New Contract Award Date
-newArchiveDate | date | YYYY-MM-DD | Yes if newArchiveType=autocustom | New Archive Date
-newArchiveType | string | auto15,
 auto30,
 autocustom | Yes  | New Archive Type
-newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | 1) Yes for types = k, o (Combined Synopsis/Solicitation) 2) Yes if newArchive.type=auto15 except for type = a (Award) | New Response Date
-newResponseTz | string |  | No | New Response Time Zone
+newContractAwardDate | date | YYYY-MM-DD | Yes (if unarchiving an award notice) | New Contract Award Date
+newArchiveDate | date | YYYY-MM-DD | Yes (if newArchiveType=autocustom) | New Archive Date
+newArchiveType | string | auto15, auto30, autocustom | Yes  | New Archive Type
+newResponseDate | date | YYYY-MM-DDTHH:MM:SS-05:00 | Yes (if newArchiveType = auto15) | New Response Date
+newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) | New Response Time Zone
 
 
Back to top

 
@@ -3485,10 +3057,8 @@ newResponseTz | string |  | No | New Response Time Zone
  "attType": "file",
  "content": "",
  "resourceName": "",
- "fileType": "",
- "packageAccessLevel": "",
- "explicitAccess":"",
- "exportControlled": null
+ "fileType": "text/plain",
+ "packageAccessLevel": "public"
 }
 

 

@@ -3501,7 +3071,8 @@ newResponseTz | string |  | No | New Response Time Zone
 {
   "attType": "link",
   "link": "",
-  "description": ""
+  "description": "",
+  "packageAccessLevel": ""
 }

@@ -3510,17 +3081,14 @@ newResponseTz | string | | No | New Response Time Zone * Field headers in the table must match with field headers shown in JSON example -Name | Data Type | Field Length |Allowed Values | Required | Description +Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ -attType | string | 32 characters |link, file | Yes | Type of attachment, either link or file -content | byte | 250MB| | Yes if attType=file | File content in base64 format -packageAccessLevel | string | 32 characters|public,
private
(default public) | No | Type of access to file. Only used with attType 'file'. -resourceName | string | 255 characters| | Yes if attType=file | Name of file -fileType | string | 64 characters | | No | Mime Type of the file. Only used for attType 'file'. [Refer Valid File Types](#valid-file-types) -link | string | 255 characters| | Yes if attType=link | Resource link URL -description | string |255 characters | | Yes if attType=link | Description of the link -explicitAccess | string |1 character | 0, 1
(defaults to '0' public access, if not provided) | No |Explicit Access. For Controlled Unclassified files, specify '1' -exportControlled | string |1 character | 0 | No | *Captured for future JCP validation*
Export Controlled +attType | string | link, file | Yes | Type of attachment, either link or file +content | byte | | Yes (if attType=file) | File content in byte format +link | string | | Yes (if attType=link) | Resource link or URL +packageAccessLevel | string | public,private(default public) | No | Type of access to file or link +resourceName | string | | Yes (if attType=file) | Name of file + #### Valid File Types @@ -3552,29 +3120,17 @@ Flash Video (.flv, .f4v)| video/x-flv ### Update Attachment Contract JSON -
+
-Update_Attachment_Contract_Json +Update_Attachment_Contract_Json 

 {
  "attType": "file",
- "packageAccessLevel": "",
- "explicitAccess": "",
- "resourceName": "",
- "sortOrderChanged":true ,
- "resourceIdBelow": ""
-}
-
-

-
- -
-Update_Link_Contract_Json -

-

-{
- "resourceName": ""
+ "packageAccessLevel": "private",
+  "explicitAccess": "1",
+"content": "SGVsbG8=",
+"fileType": "text/plain"
 }

@@ -3585,12 +3141,11 @@ Flash Video (.flv, .f4v)| video/x-flv Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ -attType | string | link, file | No | Required only for file access level changes -packageAccessLevel | string | public,
private
(default public) | No | Type of access to file. Only used with attType 'file' -resourceName | string | | No | Name of file or link -explicitAccess | string | 0, 1 | No | Defaults to '0' (public access) if not provided. '1' is used for Controlled Unclassified files. Required only for file access level changes -sortOrderChanged | boolean | true, false | No | Should be provided if file order is changed. -resourceIdBelow | string | | No | This should be Resource ID of the file/link that will display below the file/link that is moved +attType | string | link, file | Yes | Type of attachment, either link or file +link | string | | Yes (if attType=link) | Resource link or URL +packageAccessLevel | string | public,private(default public) | No | Type of access to file or link +resourceName | string | | Yes (if attType=file) | Name of file +explicitAccess | string | 0, 1 | No | Defaults to '0' (public access) if not provided. '1' is used for Controlled Unclassified files.

Back to top

@@ -3614,70 +3169,52 @@ resourceIdBelow | string | | No | This should be Resource ID of the file/link Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ -ivlCreate | string | forcedon, forcedoff | No | Indicates whether vendors can indicate interest in the organization’s Opportunities -ivlView | string | forcedon, forcedoff | No | Indicates whether vendors can view other vendors interested in the organization’s Opportunities - -### Vendor Data Contract JSON - -
-
-Vendor_Data_Contract_JSON -

-

-{
-"lname":"",
-"fname":"",
-"email":"",
-"contractorName":"",
-"duns":"",
-"cageCode":""
-}
-
-

-
-
+ivlCreate | string | forcedon, forcedoff | Yes | Indicates whether vendors can indicate interest in the organization’s Opportunities +ivlView | string | forcedon, forcedoff | Yes | Indicates whether vendors can view other vendors interested in the organization’s Opportunities -* Field headers in the table must match with field headers shown in JSON example +### Vendor Data JSON Name | Data Type | Allowed Values | Required | Description -----|-----------|----------------|----------|------------ fname | string | | Yes | First name of the user lname | string | | Yes | Last name of the user email | string | | Yes | Email Id of the user -contractorName | string | | Yes | Contractor Name +contractorName | string | | No | Contractor Name duns | string | | Yes | DUNS# -cageCode | string | | Yes | Cage Code +cageCode | string | | No | Cage Code -

Back to top

+### Delete Notice JSON -### Delete Notice Contract JSON +* Field headers in the table must match with field headers shown in JSON example + +Name | Data Type | Allowed Values | Required | Description +-----|-----------|----------------|----------|------------ +reason| string| | Yes| Reason for deletion +requestType |string |delete_request |Yes |Type of request +description |string| |Yes| Description for deletion of a notice +title |string | |No| +newArchiveDate| date| YYYY-MM-DD| No| New Archive Date +newArchiveType| string| | No| New Archive Type +deleteOption| string| latest, all| Yes| Option to delete either the latest or all versions of a notice -
-Delete_Notice_Contract_JSON +Response 

    {
-     "reason": "",
-     "requestType": "delete_request",
+   "requestType”: delete_request",
+    "reason":"test",
      "data": {
-       "description": "",
-       "deleteOption": "all"   -- "latest" to delete the latest published version of a notice 
-     }
-   }
+                           "description”: “test",
+                            "title”: null,
+                            "newArchiveDate":null,
+                             "newArchiveType":null,
+                             "deleteOption”: latest"  ( “all”  - to delete all versions)
+              }
+}

-
- -* Field headers in the table must match with field headers shown in JSON example - -Name | Data Type | Allowed Values | Required | Description ------|-----------|----------------|----------|------------ -reason| string| | No| Reason for deletion -requestType |string |delete_request |Yes |Type of request -description |string| |Yes| Description for deletion of a notice -deleteOption| string| latest, all| Yes| Option to delete either the latest or all versions of a notice

Back to top

@@ -3715,140 +3252,50 @@ Error codes may change depending on the error given; document will be updated ac Error Code|Field | Error Message | Reason/Description | Operation -----|------|---------------|--------------------|---------- 400|Additional Reporting | This opportunity cannot be published. Additional reporting is required. | Additional Reporting is required with valid values of “none” or “recovery_act” | Publish -400|Additional Reporting | Additional Reporting/Initiative is required. | Additional Reporting/Initiative is required when opportunity is not a special notice | Publish -400|Title | Title max character length is 256. | Title max character length is 256. | Publish 400|ARCHIVE | This opportunity is not the latest published. | Draft Opportunity cannot be archived. | Archive -400|ARCHIVE | Opportunity already inactive. | Opportunity is already archived. | Archive -400|Update | Opportunity cannot be updated. | Opportunity is either in draft, archived or cancelled status. | Update -400|Cancel | This opportunity cannot be cancelled. This opportunity should be published. | This opportunity cannot be cancelled. This opportunity should be published. | Cancel -400|Cancel | This opportunity cannot be cancelled. This opportunity is a revision. | This opportunity cannot be cancelled. This opportunity is a revision. | Cancel -400|Cancel | This opportunity cannot be cancelled. This opportunity is already inactive. | This opportunity cannot be cancelled. This opportunity is already inactive. | Cancel -400|Cancel | This opportunity cannot be cancelled. This opportunity is already cancelled. | This opportunity cannot be cancelled. This opportunity is already cancelled. | Cancel -400|Description | This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field. | This opportunity cannot be cancelled. The cancel request is missing `Cancellation description` field. | Cancel -400|Uncancel, Delete | This opportunity is not published. | This opportunity is not published. | Uncancel, Delete -400|Uncancel | This opportunity is a revision. | This opportunity is a revision. | Uncancel -400|Uncancel | This opportunity is not cancelled. | This opportunity is not cancelled. | Uncancel -400|Description | Description is required | Description is required | Uncancel -400|UNARCHIVE | Opportunity is active. | Active opportunity | UnArchive -400|UNARCHIVE | Opportunity is cancelled. | Cancelled opportunity | UnArchive -400|Opportunity Type | The new opportunity type field is missing. | prevent activating if opportunity type is `m`, `l` or `j` and new type opportunity isn't provided | UnArchive -400|Opportunity Type | The new opportunity type field is not supported. | prevent activating if opportunity type is not one of `m`, `l` or `j` and new type opportunity is provided | UnArchive -400|Opportunity Type | The Opportunity's type provided is not supported. | prevent activating if opportunity type is `m` and new type opportunity provided is not supported | UnArchive -400|Opportunity Type | The new opportunity type provided is not supported. | prevent activating if opportunity type is `l` or `j` and new type opportunity provided is not `u` | UnArchive 400|Archive Date | $.archive.date: does not match the date pattern ^\\d{4}-(?:0[0-9]{1}\1[0-2]{1})-(0?[1-9]\[12][0-9]\3[01])$ | Archive Date must be in specified format | Create, Publish, Uncancel, Unarchive 400|Archive Date | This opportunity cannot be published. Inactive date is a required field. | Archive Date is required if Archive Type = autocustom | Create, Publish, Uncancel, Unarchive -400|Archive Date Response Date | One of Response date or Archive date is required | Either Response date or archive date is required for presolicitation, sources sought, special notice, sale surplus | Publish -400|Archive Date | Inactive date provided is an invalid format. | Date is not in specified format | Create, Publish, Uncancel, Unarchive -400|Archive Date | New archive date is required. | New archive date is required. | Unarchive -400|Archive Date | New archive date provided is in an invalid format. | New archive date provided is in an invalid format. | Unarchive -400|Archive Date | New archive date provided is in the past. | New archive date provided is before today's date. | Unarchive -400|Archive Type | New archive type is invalid. | archive type is not one of the following "auto15", "autocustom", "auto30" | UnArchive -400|Archive Type | Archive type is invalid for this notice type. | archive type is one of the following "auto15", "auto30" and is not allowed for this notice type | UnArchive 400|Archive Type | This opportunity cannot be published. Inactive Policy is a required field. | Archive Type is required | Publish 400|Archive Type | $.archive.type: does not have a value in the enumeration[auto15, auto30, autocustom] | Archive type must be specified value | Create, Publish, Uncancel, Unarchive 400|Archive Type | This opportunity cannot be published. Auto 15 archive type is not allowed for this opportunity type. | Archive Type = auto15 not allowed | Publish -400|Archive Type | Auto 30 archive type is not allowed for this opportunity type. | Archive Type = auto30 not allowed for Intent bundle and Justification | Publish -400|Attachment | has unknown issue/missing, please remove this attachment and republish. | has unknown issue/missing, please remove this attachment and republish. | Publish -400|Attachment | is PENDING, please try to publish at a later time. | is PENDING, please try to publish at a later time. | Publish -400|Attachment | is ENCRYPTED, please remove this attachment and republish. | is ENCRYPTED, please remove this attachment and republish. | Publish -400|Attachment | is INFECTED, please remove this attachment and republish. | is INFECTED, please remove this attachment and republish. | Publish -400|Attachment | FILE SIZE GT 250MB or larger, please remove this attachment and republish. | FILE SIZE GT 250MB or larger, please remove this attachment and republish. | Publish -400|Attachment | is a UNSUPPORTED FILE TYPE, please remove this attachment and republish. | is a UNSUPPORTED FILE TYPE, please remove this attachment and republish. | Publish -400|Attachment | Exception occured while trying to validate attachments, Please retry at a later time. | Exception occured while trying to validate attachments, Please retry at a later time. | Publish -400|Attachment | Unknown type was found for Resource named: | Unknown type was found for Resource named: | Publish 400|attType | Attachment must have AttType of file or link | Attachment type must be a file or a line | Create Attachment 401|Authorization | Insufficient privileges to edit opportunity | See User Account Authorization section | Update, Publish, Revise 401|Authorization | Insufficient privileges to create opportunity | Insufficient privileges to create an award notice. See User Account Authorization section for more details. | Create Opportunity 401|Authorization | Insufficient privileges to create request | Insufficient privileges to publish an award notice. See User Account Authorization section for more details. | Create 400|Award | Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type | Award Section is not valid for Base Notice Types (s, o, p, r, g, k, i) | Publish -400|Award | Award Details Section is missing data. | Award Details Section is missing data. | Publish 400|Award Amount | Award Detail Section-Please enter valid integer for Amount Field | Award Amount required | Publish 400|Award Amount | Award Details Section - Contract Award Dollar Amount is not a valid field for this opportunity type | Contract Award Amount only valid for Type "a" Award | Publish -400|Total Contract Value | Base and All Options Value is a required field. | Base and All Options Value is a required field. | Publish -400|Total Contract Value | Base and All Options Value max length is 64 digits. | Base and All Options Value max length is 64 digits. | Publish -400|Total Contract Value | Base and All Options Value - Invalid input: Please enter a valid number. | Base and All Options Value - Invalid input: Please enter a valid number. | Publish -400|Modification Number | Modification Number max character limit is 32 characters. | Modification Number max character limit is 32 characters. | Publish -400|Award Date | Contract Award Date is required field. | Contract Award Date is required field. | Create Opportunity, Publish, Uncancel -400|Award Date | New contract award date provided is in the past. | New contract award date provided is in the past. | Unarchive -400|Award Date | New contract award date is not provided | New contract award date is not provided | Unarchive -400|Award Date | Contract Award Date provided is in an invalid format. | Date is not in specified format | Create Opportunity, Publish, Uncancel, Unarchive -400|Award Date | Contract Award Date provided should have 4 digit year. | Contract Award Date provided should have 4 digit year. | Create Opportunity, Publish, Uncancel, Unarchive -400|Award Date | Award date provided is in the past. | Award Date must be current or future date. | Create Opportunity, Publish, Uncancel, Unarchive -400|Award Date | Contract Award Date set would result in inactive date being in the past. | Contract Award Date set would result in inactive date being in the past. | Create Opportunity, Publish, Uncancel, Unarchive -400|Award Number | Contract Award Number is a required field | Contract Award Number is missing | Publish, Uncancel, Unarchive -400|Award Number | Contract Award Number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces.| Contract Award Number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | Publish, Uncancel, Unarchive -400|Contract Line Item number | The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | All -400|DUNS | Unique Entity Identifier (duns) is invalid. | Invalid DUNS provided | Publish -400|Awardee Name | Contractor Awarded Name is a required field. | Contractor Awarded Name is a required field. | Publish -400|Awardee Name | Contractor Awarded Name max character length is 255. | Contractor Awarded Name max character length is 255. | Publish -400|Awardee | Required fields from Awardee section is missing. |Required fields from Awardee section is missing. | Publish -400|Awardee Country | Award Details Section - Country is required. |Country is required. | Publish -400|Awardee Country | Award Details Section - Country provided is invalid. |Country provided is invalid. | Publish -400|Awardee State | Award Details Section - State is required. |State is required. | Publish -400|Awardee State | Award Details Section - State provided is invalid. |State provided is invalid. | Publish -400|Awardee City | Award Details Section - City is required. |City is required. | Publish -400|Awardee City | Award Details Section - City provided is invalid. |City provided is invalid. | Publish -400|Classification Code | Classification Code provided did not match expected codes | Invalid PSC provided | Publish +400|Award Date | Award Details Section - Contract Award Date provided is in an invalid format. | Date is not in specified format | Create Opportunity, Publish, Uncancel, Unarchive +400|Award Date | Award Details section -Award date provided is in the past. | Award Date must be current or future date. | Create Opportunity, Publish, Uncancel, Unarchive +400|Award Number | Award Details Section - Contract Award Number is a required field | Contract Award Number is missing | Publish, Uncancel, Unarchive +400|Classification Code | This opportunity cannot be published. Classification Code provided did not match expected codes | Invalid PSC provided | Publish 400|CANCEL | This opportunity cannot be cancelled. This opportunity is a revision. | Cannot cancel a revised Opportunity. | Cancel 400|Content | File Resource must have content. | File Resource must be filled out | Create Attachment 400|Contract Award Dollar Amount | Award Details Section – Please enter valid integer for Amount Field | Valid integer amount must be entered for award dollar amount | Publish -400|Task/Delivery Order Number | Task/Delivery Order Number is required field. | Task/Delivery Order Number is required field. | Publish -400|Task/Delivery Order Number | Task/Delivery Order Number max length is 255 characters and allows only alphanumeric and - _ ( ) characters with no spaces. | Task/Delivery Order Number max length is 255 characters and allows only alphanumeric and - _ ( ) characters with no spaces. | Publish 401|CREATE | Insufficient privileges to create opportunity | Account does not have appropriate privileges to create opportunity | CREATE 401|CREATE ATTACHMENT | Insufficient privileges to upload attachment | Attachments cannot be added to published notices | Create Attachment 400|Deadlines Response | This opportunity cannot be published. | Response Deadline Date is required | Publish -400|Description | Description is a required field | Description is a required field except for award notice | Publish +400|Description | Description is required | Description is required | Publish 400|IVL | This opportunity cannot be published. Interested Vendors List Add is a required field. |Interested Vendors List Add is a required | Publish -400|IVL | Interested Vendors List Read is a required field. |Interested Vendors List Read is a required field. | Publish -400|IVL | Interested Vendors List should be enabled for this organization. |Interested Vendors List should be enabled for this organization when FORCE ON | Publish -400|IVL | Interested Vendors List should not be enabled for this organization. |Interested Vendors List should not be enabled for this organization when FORCE OFF | Publish 400|Justification Authority | This opportunity cannot be published. Justification Authority is not valid field for this opportunity type | Justification Authority Section is not valid for Base Notice Types (s, o, p, r, g, k, i) | Publish 400|Justification Authority | This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type. | Justification Authority Section is not valid for Base Notice Types (s, o, p, r, g, k, i) | Publish 400|Justification Authority | This opportunity cannot be published. Justification Authority is not valid field for this opportunity type | Justification Authority only valid for Type "u" Justification and Authorization | Publish 400|Justification Authority | This opportunity cannot be published. Justification Authority Modification Number is not valid field for this opportunity type | Justification Authority Modification Number is only valid for Type "u" Justification and Authorization | Publish -400|NAICS Code | NAICS provided did not match expected codes | NAICS Code is invalid | Create Opportunity, Publish -400|Set Aside | Set Aside is not valid field for this opportunity type. | Set Aside is invalid | Create Opportunity, Publish -400|Set Aside | Contracting Office is a required for Set Aside. | Contracting Office is a required for Set Aside. | Create Opportunity, Publish -400|Set Aside | Set Aside provided did not match expected codes | Set Aside provided did not match expected codes | Create Opportunity, Publish +400|NAICS Code | This opportunity cannot be published. NAICS provided did not match expected codes | NAICS Code is invalid | Create Opportunity, Publish 400|NAICS Type | $.data.naics[0].type: does not have a value in the enumeration [primary] | NAICS Type is required | Create Opportunity -400|Notice Type | This opportunity cannot be published. The inactive type `manual` is no longer supported. | See Notice Types table for valid notice types | Publish -400|Notice Type | The opportunity type `j` is no longer supported | See Notice Types table for valid notice types | Publish -400|Notice Type | The opportunity type `m` is no longer supported | See Notice Types table for valid notice types | Publish -400|Notice Type | The opportunity type `l` is no longer supported | See Notice Types table for valid notice types | Publish +400|Notice Type | This opportunity cannot be published. The opportunity type `j` is no longer supported | See Notice Types table for valid notice types | Publish 400|Opportunity ID | Opportunity ID for the selected opportunity type already exists | Cannot publish an existing published record | Publish 400|Opportunity ID | Opportunity cannot be updated | An Opportunity cannot be revised if that Opporutnity was revised previously and is currently in draft state | Revise -404|Notice ID | Notice ID is required | Notice ID is required | All -400|Notice ID | Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | Notice ID max length is 128 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces. | All -400|Notice ID | Notice ID must be unique based on selected notice type. | Notice ID must be unique when selected notice type is not an award notice. | All -400|Notice ID | Submitted solicitation number doesn't match the previous published opportunity | Submitted solicitation number doesn't match the previous published opportunity for award notice type | All -400|Related Notice ID | This Related Notice's ID is invalid | The Related Notice's ID is not found | All -400|Related Notice ID | The Related Notice's Type is invalid for this Opportunity | The Related Notice's Type cannot be related | All -400|Related Notice ID | Related Notice's ID needs to match previous Opportunity's Related Notice ID | Related Notice's ID needs to match previous Opportunity's Related Notice ID | All +404|Opportunity ID | Opportunity ID is required | Opportunity ID is required | All 400|Opportunity Type | Opportunity type is required | Opportunity type is required | Create Opportunity 400|Opportunity Type | errorCode":400,"message":"Opportunity type given is not a valid type." | Opportunity type is empty | Create Opportunity -400|Organization Id | Contracting Office is a required field. | FH Org Id/AAC code is required | Publish -400|Organization Id | The Federal Organization ID that you provided is inactive and/or invalid. | Inactive/Invalid Organization Id | Create Opportunity -400|Organization Id | The Federal Organization ID that you provided is not an office level, and it must be for this opportunity type. | Organization ID is not valid for opportunity type. Note: Organization ID must be Office level unless creating a Special Notice. | Create Opportunity -400|Organization Id | The Federal Organization ID that you provided is unmapped in Federal Hierarchy. | Organization ID length should be greater than 10 | Publish +400|Organization Id | Contracting office is required | FH Org Id/AAC code is required | Publish +400|Organization Id | The Organization ID that you provided is an inactive and/or invalid. | Inactive/Invalid Organization Id | Create Opportunity +400|Organization Id | The Organization ID that you provided is not an office level, and it must be for this opportunity type. | Organization ID is not valid for opportunity type. Note: Organization ID must be Office level unless creating a Special Notice. | Create Opportunity 400|Point of Contact Type | $.data.pointOfContact[0].type: does not have a value in the enumeration [primary, secondary, owner] | Point of Contact Type is required | Create Opportunity 400|Point of Contact Email | Primary Contact – Email is required | If Contact email is missing. This is a required field | Publish -400|Primary Contact | Primary Contact is required | Primary Contact is required | Publish 400|Primary Contact Full Name | Primary Contact - Name is required | Point of Contact Full Name is required | Publish -400|Primary Contact Full Name | Primary Contact - Name limit is 255 characters. | Point of Contact Name limit is 255 characters | Publish -400|Primary Contact Email | Primary Contact - Please enter a valid Internet email address. Format: username@host.domain. | Primary Contact invalid Email format | Publish -400|Primary Contact Email | Primary Contact - email character limit is 255 characters. | Primary Contact email limit is 255 | Publish -400|Primary Contact Phone | Primary Contact - phone character limit is 255 characters. | Primary Contact phone limit is 255 | Publish -400|Primary Contact Phone | Primary Contact - fax character limit is 255 characters. | Primary Contact fax limit is 255 | Publish -400|Response Date | Response Date is a required field | Response Date is only valid for Notice Type “o” | Publish -400|Response Date | Response Date provided is an invalid format. | Response Date provided is an invalid format. | Publish -400|Response Date | Response Date cannot be in the past. | Response Date cannot be in the past. | Publish -400|Response Date | Response Date set would result in inactive date being in the past. | Response Date provided is within 15 days | Publish -400|Response Date | Auto 15 archive type is not allowed for this opportunity type. | Auto 15 archive type is not allowed for award notice | Publish -400|Response Date | Response Date cannot exceed 5 years from current date. | Response Date cannot exceed 5 years from current date. | Publish -400|Response Date | New response date is required. | Unarchive requires new response date | UnArchive -400|Response Date | New response date provided is in an invalid format. | Invalid date format | UnArchive -400|Response Date | New response date provided is in the past. | Response date is before offset date | UnArchive -400|Response Date | New response date provided would place inactive date in the past. | New response date providedis within 15 days | UnArchive +400|Response Date | This opportunity cannot be published. Response Date is a required field | Response Date is only valid for Notice Type “o” | Publish 400|Title | Title is required | Title is required | Publish 400|UNARCHIVE | This opportunity is not the latest published | Only archived notices can be unarchived | UNARCHIVE 400|resourceName | Attachment must have a name | File Name is a required field | Create Attachment @@ -3886,11 +3333,7 @@ Date | Version | Description 8/19/2019 | v0.72 | API Names Updated
Valid File Types Updated 8/29/2019| v0.73| Error Codes Added 8/29/2019| v0.74| Updated the missing description for explicitAccess field in Update Attachment Contract JSON -10/9/2019 | v0.75| Get List of Opportunities API Parameter Changes (cancelled field removed/status field updated) -10/22/2019 | v0.76| Create and Publish JSON field for Archive.Date and Response Date updated
Production Link Updated
API URLs updated 10/10/2019 | v0.8 | Updated the Set-Aside values with the latest codes -10/25/2019 | v0.9 | Updated the field lengths - -

Back to top

+

Back to top

\ No newline at end of file