diff --git a/_apidocs/get-opportunities-public-api.md b/_apidocs/get-opportunities-public-api.md index 6ac8b2f77..1272184a6 100644 --- a/_apidocs/get-opportunities-public-api.md +++ b/_apidocs/get-opportunities-public-api.md @@ -5,15 +5,14 @@ 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 requires pagination, and the response will be provided to users synchronously. **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 +[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 +[Archived Opportunities](https://beta.sam.gov/data-services?domain=Contract%20Opportunities%2FArchived%20Data) -**API Version: v1.0** ## Getting Started @@ -54,7 +53,7 @@ ncode| NAICS Code. This code is maximum of 6 digits| No| String ccode| Classification Code| No| String rdlfrom |Response Deadline date. Format must be MM/dd/yyyy
Note: If response date From & To is provided, then the date range is 1 year| No| String rdlto |Response Deadline date. Format must be MM/dd/yyyy
Note: If response date From & To is provided, then the date range is 1 year| No| String -limit |Total number of records to be retrieved per page. This field must be a number.
NOTE: If limit is not provided, request will be treated as an asynchronous request and users will receive an email with a download option to retrieve response| No |Int +limit |Total number of records to be retrieved per page. This field must be a number
Max Value = 1000| Yes |Int offset |Indicates the page index. Default offset starts with 0 | No| Int ## Get Opportunities Response Parameters @@ -386,14 +385,6 @@ Note: Response for one record is provided as an example

-## Synchronous vs Asynchronous call -Since Opportunities data volume is huge, API works as follows: - -* If limit is provided (limit range is 0-1000), then the API will give response immediately (synchronous call) -
-* If limit is not provided, then the API will work asynchronously and sends an email to the user with the response as a downloadable link. This downloadable link will have an expiry time. The downloadable CSV file format is:
-"Title", "Sol#", "Department/Ind.Agency", "Sub-Tier", "Office", "PostedDate", "Type", "BaseType", "ArchiveType", "ArchiveDate", "SetASideCode", "SetASide", "ResponseDeadLine", "NaicsCode", "ClassificationCode", "PopStreetAddress", "PopCity", "PopState", "PopZip", "PopCountry", "Active", "AwardNumber", "AwardDate", "Award$", "Awardee", "PrimaryContactTitle", "PrimaryContactFullname", "PrimaryContactEmail", "PrimaryContactPhone", "PrimaryContactFax", "SecondaryContactTitle", "SecondaryContactFullname","SecondaryContactEmail", "SecondaryContactPhone", "SecondaryContactFax","Description","OrganizationType","StreetAddress","StreetAddress2","State","City","ZipCode","CountryCode","AdditionalInfoLik", "Link" - ## HTTP Response Codes 200 - Success @@ -435,5 +426,6 @@ Date | Version | Description 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 +11/1/19| v1.5| - Street Address 1 & 2 removed from Response
- Status and Description removed from request
- Limit changed to "Required"
- Asynchronous opportunities file download feature disabled
- Response returns only the latest active version of a notice

Back to top

diff --git a/_apidocs/opportunities-api.md b/_apidocs/opportunities-api.md index 182887dcd..4b46528b8 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 (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 @@ -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 @@ -77,7 +78,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 @@ -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,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. 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 @@ -142,7 +144,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 @@ -202,121 +204,71 @@ 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 +284,7 @@ Examples "title": "PRESOLTEST_T1", "type": "p", "classificationCode": "13", - "organizationId": "100120624", + "organizationId": "100186612", "naics": [{ "type": "primary", "code": ["111150"] @@ -341,9 +293,9 @@ Examples "additionalInfo": { "content": "" }, - "email": "", + "email": "testemail@gsa.gov", "fax": "", - "fullName": "gsa", + "fullName": "test user", "phone": "", "title": "", "type": "primary" @@ -376,22 +328,12 @@ Examples "solicitation": { "setAside": "SBA", "deadlines": { - "response": "2019-08-08" + "response": "2023-08-08" } }, "archive": { "type": "autocustom", - "date": "2019-09-09" - }, - "flags": [{ - "code": "", - "isSelected": true - }], - "link": { - "additionalInfo": { - "content": "" - }, - "href": "" + "date": "2023-09-09" }, "additionalReporting": [ "none" @@ -410,62 +352,190 @@ 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": [
+   "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":
     {
-      "body": "Description_TEST "
+        "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"]
+        },
+        "description": [
+        {
+            "body": "test description"
+        }],
+        "related":
+        {
+            "opportunityId": "bc14e9f810a44e468c31fd120dd41b4f"
+        }
     }
-  ]
-}
 

@@ -482,6 +552,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 @@ -489,7 +561,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

@@ -520,7 +592,7 @@ Examples ------- | ------- **Request Type** | POST -**URL** | /opps/v1/opportunities/createAndPublish +**URL** | /v1/api/createAndPublish **Summary** | Creates and publishes contract opportunity; JSON same as Create and Update API **Consumes** | application/json **Produces** | JSON @@ -531,7 +603,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

@@ -541,6 +613,141 @@ 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 @@ -548,7 +755,7 @@ HTTP Status Code | Response Type | Reason | Description ------- | ------- **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 @@ -689,12 +896,12 @@ Examples "name": "" } } + } }, "justificationAuthority": { "modificationNumber": "", "authority": "dictionary" }, - }, "permissions": { "IVL": { "create": true, @@ -713,18 +920,6 @@ Examples "type": "autocustom", "date": "2019-09-09" }, - "flags": [ - { - "code": "", - "isSelected": true - } - ], - "link": { - "additionalInfo": { - "content": "" - }, - "href": "" - }, "additionalReporting": [ "none" ] @@ -806,18 +1001,6 @@ Examples "type": "autocustom", "date": "2019-09-09" }, - "flags": [ - { - "code": "", - "isSelected": true - } - ], - "link": { - "additionalInfo": { - "content": "" - }, - "href": "" - }, "additionalReporting": [ "none" ] @@ -1056,8 +1239,6 @@ Examples ### Delete Draft Opportunity - - ------- | ------- **Request Type** | DELETE **URL** | /v1/api/delete/{opportunityId} @@ -1092,7 +1273,7 @@ _NA_ ------- | ------- **Request Type** | POST -**URL** | /opps/v1/opportunities/{opportunityId}/requests +**URL** | /v1/api/{opportunityId}/requests **Summary** | Deletes all the versions or latest version of a notice **Consumes** | application/json **Produces** | JSON @@ -1103,7 +1284,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 -Request JSON| Body| JSON| Yes| Refer Delete Notice JSON +opportunityId | query | string | Yes | Opportunity ID +Request JSON| Body| JSON| Yes| [Refer Delete Notice Contract JSON](#delete-notice-contract-json) Responses @@ -1114,19 +1296,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"
+  }
 }
 

@@ -1152,7 +1331,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 @@ -1170,7 +1348,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

@@ -1382,7 +1560,6 @@ Examples "opportunityId": "8de3d88fc7642d9adcdb8d4ff9070399" }, "related": { - }, "status": { "code": "draft", @@ -1425,10 +1602,8 @@ Examples ] }, "parent": { - }, "related": { - }, "status": { "code": "draft", @@ -1528,10 +1703,8 @@ Examples ] }, "parent": { - }, "related": { - }, "status": { "code": "published", @@ -1784,15 +1957,20 @@ HTTP Status Code | Response Type | Reason | Description Examples +
-Uncancel Request (active Opportunity): +Uncancel Request for a Non Award Notice

 {
-  "reason": "",
+  "reason": "test",
   "requestType": "uncancel_request",
   "data": {
-    "description": "test"
+    "description": "test",
+    "newArchiveDate": null,
+    "newArchiveType": "auto15",
+    "newResponseDate": "2018-11-11T10:58:00-05:00",
+    "newResponseTz": "America/New_York"
   }
 }
 
@@ -1800,18 +1978,19 @@ Examples
-Uncancel Request (inactive Opportunity): +UnCancel Request for a Award notice

 {
-  "reason": "test",
+  "reason": "test uncancel for award notice",
   "requestType": "uncancel_request",
   "data": {
     "description": "test",
-    "newArchiveDate": null,
-    "newArchiveType": "auto15",
-    "newResponseDate": "2018-11-11T10:58:00-05:00",
-    "newResponseTz": "America/New_York"
+    "newResponseDate": null,
+    "newResponseTz": null,
+    "newArchiveType": "autocustom",
+    "newArchiveDate": "2020-03-01",
+    "newContractAwardDate": "2020-02-02"
   }
 }
 
@@ -1891,17 +2070,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"
   }
 }
 
@@ -1910,12 +2108,12 @@ Examples

Back to top

-### Create Attachment in Draft Opportunity +### Create Resource in Draft Opportunity ------- | ------- **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 @@ -1943,11 +2141,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"
 }
 

@@ -1957,10 +2156,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"
 }
 

@@ -1968,12 +2167,12 @@ Examples

Back to top

-### Update Attachment in Draft Opportunity +### Update Resource in Draft Opportunity ------- | ------- **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 @@ -1984,8 +2183,110 @@ 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 -Request JSON | Body | JSON | Yes | [Refer Update Attachment Contract JSON](#update-attachment-contract-json) +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 + +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 | 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

@@ -1993,39 +2294,11 @@ Responses HTTP Status Code | Response Type | Reason | Description -----------------|---------------|---------|------------ -200 | string | Attachment successfully updated | Resource ID returned +204 | string | Attachment successfully deleted | NA Examples -
-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"
-}
-
-

-
+_NA_

Back to top

@@ -2203,7 +2476,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 @@ -2215,7 +2488,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 @@ -2259,7 +2532,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 @@ -2271,7 +2544,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 @@ -2358,42 +2631,12 @@ 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/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 @@ -2405,7 +2648,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 @@ -2421,7 +2663,6 @@ Examples

 {
-
     "_embedded": {
         "authorizedPartyList": [
             {
@@ -2473,7 +2714,7 @@ Examples
 
 ------- | -------
 **Request Type** | POST
-**URL** | /v1/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
@@ -2485,7 +2726,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
 
@@ -2496,16 +2737,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"
 }
 

@@ -2630,140 +2871,115 @@ Examples

 {
-   "data": {
-        "solicitationNumber": "Test1",
-        "title": "TST_T1",
-        "type": "p",
-        "classificationCode": "13",
-        "organizationId": "100000136",
-        "organizationLocationId": "",
-        "naics": [{
-            "type": "primary",
-            "code": ["111150"]
-        }],
-        "pointOfContact": [{
-                "additionalInfo": {
-                        "content": ""
-                },
+    "data": {
+        "type": "",
+        "solicitationNumber": "",
+        "title": "",
+        "organizationId": "",
+        "classificationCode": "",
+        "naics": [
+            {
+                "type": "primary",
+                "code": [
+                    ""
+                ]
+            }
+        ],
+        "pointOfContact": [
+            {
+                "type": "primary",
+                "title": "",
+                "fullName": "",
                 "email": "",
-                "fax": "",
-                "fullName": "Veera",
                 "phone": "",
-                "title": "",
-                "type": "primary"
-        }],
+                "fax": "",
+                "additionalInfo": {
+                    "content": ""
+                }
+            }
+        ],
         "placeOfPerformance": {
-                "city": {
-                        "code": "",
-                        "name": ""
-                },
-                "country": {
-                        "code": "",
-                        "name": ""
-                },
-                "state": {
-                        "code": "",
-                        "name": ""
-                },
-                "streetAddress": "",
-                "streetAddress2": "",
-                "zip": ""
+            "streetAddress": "",
+            "streetAddress2": "",
+            "city": {
+                "code": "",
+                "name": ""
+            },
+            "country": {
+                "code": "",
+                "name": ""
+            },
+            "state": {
+                "code": "",
+                "name": ""
+            },
+            "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": ""
-                }
+        "archive": {
+            "type": "autocustom",
+            "date": "2019-09-09"
         },
         "permissions": {
-                "IVL": {
-                        "create": false,
-                        "delete": false,
-                        "read": false,
-                        "update": false
-                }
-        }, 
-          "solicitation": {
+            "IVL": {
+                "create": false,
+                "delete": false,
+                "read": false,
+                "update": false
+            }
+        },
+        "solicitation": {
             "setAside": "SBA",
             "deadlines": {
                 "response": "2019-08-08"
             }
         },
-       "archive": {
-            "type": "autocustom",
-            "date": "2019-09-09"
+        "award": {
+            "date": "",
+            "number": "",
+            "deliveryOrderNumber": "",
+            "amount": "",
+            "lineItemNumber": "",
+            "awardee": {
+                "manual": false,
+                "name": "",
+                "duns": "",
+                "location": {
+                    "streetAddress": "",
+                    "streetAddress2": "",
+                    "city": {
+                        "code": "",
+                        "name": ""
+                    },
+                    "state": {
+                        "code": "",
+                        "name": ""
+                    },
+                    "zip": "",
+                    "country": {
+                        "code": "",
+                        "name": ""
+                    }
+                }
+            }
         },
-        "flags": [{
-                "code": "",
-                "isSelected": true
-        }],
-        "link": {
-                "additionalInfo": {
-                        "content": ""
-                },
-                "href": ""
+        "justificationAuthority": {
+            "modificationNumber": "",
+            "authority": "dictionary"
         },
-         "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": ""
+    }
 }
+
 

@@ -2771,96 +2987,82 @@ 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 -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 +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

Back to top

@@ -2887,6 +3089,234 @@ 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 @@ -2910,7 +3340,7 @@ reason | string | | No | Publish reason 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

@@ -2937,7 +3367,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 @@ -2952,15 +3382,14 @@ description | string | | Yes | Description for cancelation
 {
   "reason": "",
-  "requestType": " uncancel_request ",
+  "requestType": "uncancel_request",
   "data": {
     "description": "",
     "newContractAwardDate": "",
     "newArchiveDate": "",
     "newArchiveType": "",
     "newResponseDate": "",
-    "newResponseTz": "America/New_York",
-    "newContractAwardDate": ""
+    "newResponseTz": "America/New_York"
   }
 }
 
@@ -2975,12 +3404,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 -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 +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

Back to top

@@ -3005,7 +3433,7 @@ newContractAwardDate | date | YYYY-MM-DD | Yes (if type=a) | New Contract Award 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

@@ -3036,13 +3464,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 -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 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

@@ -3057,8 +3485,10 @@ newResponseTz | string | America/New_York | Yes (if newResponseDate is provided) "attType": "file", "content": "", "resourceName": "", - "fileType": "text/plain", - "packageAccessLevel": "public" + "fileType": "", + "packageAccessLevel": "", + "explicitAccess":"", + "exportControlled": null }

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

@@ -3081,14 +3510,17 @@ 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 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 - +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 #### Valid File Types @@ -3120,17 +3552,29 @@ Flash Video (.flv, .f4v)| video/x-flv ### Update Attachment Contract JSON -
+
-Update_Attachment_Contract_Json +Update_Attachment_Contract_Json

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

+
+ +
+Update_Link_Contract_Json +

+

+{
+ "resourceName": ""
 }
 

@@ -3141,11 +3585,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 | 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

Back to top

@@ -3169,52 +3614,70 @@ explicitAccess | string | 0, 1 | No | Defaults to '0' (public access) if not pr 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 + +
+
+Vendor_Data_Contract_JSON +

+

+{
+"lname":"",
+"fname":"",
+"email":"",
+"contractorName":"",
+"duns":"",
+"cageCode":""
+}
+
+

+
+
-### Vendor Data JSON +* 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 +cageCode | string | | Yes | Cage Code -### Delete Notice JSON - -* 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 -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 +Delete_Notice_Contract_JSON

    {
-   "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 
+     }
+   }
 

+
+ +* 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

@@ -3251,64 +3714,139 @@ 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|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 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|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|Title | Title is required | Title is required | Create Opportunity, Publish +400|Title | Title max character length is 256 | Title max character length is 256 | Create Opportunity, Publish +400|Opportunity Type | Opportunity type is required | Opportunity type is required | Create Opportunity, Publish +400|Opportunity Type | The Opportunity's type provided is not supported |Invalid Opportunity type provided. [Refer Notice Types](#notice-types) | Create Opportunity, Publish +400|Opportunity Type | The opportunity type `j` is no longer supported | Invalid Opportunity type provided. [Refer Notice Types](#notice-types) | Create Opportunity, Publish +400|Opportunity Type | The opportunity type `m` is no longer supported | Invalid Opportunity type provided. [Refer Notice Types](#notice-types) | Create Opportunity, Publish +400|Opportunity Type | The opportunity type `l` is no longer supported | Invalid Opportunity type provided. [Refer Notice Types](#notice-types) | Create Opportunity, Publish +400|Organization Id | Contracting Office is a required field | FH Org Id/AAC code is required | Create Opportunity, Publish +400|Organization Id | The Federal Organization ID that you provided is inactive and/or invalid | Inactive/Invalid Organization Id | Create Opportunity, Publish +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, Publish +400|Organization Id | The Federal Organization ID that you provided is unmapped in Federal Hierarchy | If the Organization Id provided is a legacy one and is unmapped in Federal Hierarchy, then the system throws and error | Publish +404|Solicitation Number | Notice ID is required | Notice ID is required | Publish +400|Solicitation Number | 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 | Publish +400|Solicitation Number | Notice ID must be unique based on selected notice type | Notice ID must be unique when selected notice type is not an award notice | Publish +400|Solicitation Number | Submitted solicitation number doesn't match the previous published opportunity | Solicitation number provided with update opportunity doesn't match the previous published opportunity for an award notice type | Publish +400|Related Opportunity ID | This Related Notice's ID is invalid | The Related Notice's ID is not found | Publish +400|Related Opportunity ID | The Related Notice's Type is invalid for this Opportunity | The Related Notice's Type cannot be related | Publish +400|Related Opportunity ID | Related Notice's ID needs to match previous Opportunity's Related Notice ID | Related Notice's ID provided while revising a notice needs to match the Parent Opportunity's Related Notice ID | Publish +400|Response Date | Response Date is a required field | Response Date is not provided for Combined Synopsis and Solicitation types | Publish +400|Response Date | Response Date provided is an invalid format | Response Date provided is not in valid format | Publish +400|Response Date | Response Date cannot be in the past | Response Date provided is in the past | Publish +400|Response Date | Response Date cannot exceed 5 years from current date | Response Date exceeds 5 years from the current date | Publish +400|Archive Date | Inactive date is a required field | Archive Date is required if Archive Type = autocustom |Publish +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 | Publish +400|Archive Date | Archive date provided is in the past |Archive date provided is before today's date. | Publish +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 | Publish, UnArchive, Uncancel +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|Additional Reporting | Additional Reporting/Initiative is required | Additional Reporting/Initiative is required when opportunity is not a special notice | Publish +400|Justification Authority - Authority| Justification Authority is not valid field for this opportunity type | Justification Authority only valid for Type "u" Justification and Authorization | Publish +400|Justification Authority - Authority| Authority is a required field | Justification Authority is a required field for Type "u" Justification and Authorization | Publish +400|Justification Authority - Authority| Invalid Authority Fields, please refer to Contract Opportunities SOAP Web Service Tech Document valid authority fields | If Invalid authority details are provided for Type "u" Justification and Authorization | Publish +400|Justification Authority - Modification Number | 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|Justification Authority - Modification Number | Modification Number max character limit is 32 characters | Modification number size exceeds 32 characters| Publish +400|NAICS Code | NAICS Code is a required field | NAICS Code is required for Combined Synopsis and Solicitation | Publish +400|NAICS Code | NAICS provided did not match expected codes | NAICS Code is invalid | Publish +400|Set Aside | Set Aside is not valid field for this opportunity type | Set Aside is invalid | Publish +400|Set Aside | Contracting Office is a required for Set Aside | Contracting Office is a required for Set Aside | Publish +400|Set Aside | Set Aside provided did not match expected codes | Set Aside provided did not match expected codes | Publish +400|Classification Code | Product Service Code is a required field | Product service code is required for all types except SourcesSought, Sale of Surplus and Award | Publish +400|Description | Description is a required field | Description is a required field except for award notice | Publish 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 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 -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 -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|IVL | This opportunity cannot be published. Interested Vendors List Add is a required field. |Interested Vendors List Add is a required | 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 | 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 -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|Award | Award Details Section is missing data. | Award Details Section is missing data | Publish +400|Award Amount | Base and All Options Value is a required field | Base and All Options Value is a required field | Publish +400|Award Amount | Base and All Options Value max length is 64 digits | Base and All Options Value max length is 64 digits | Publish +400|Award Amount | 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|Award Date | Contract Award Date is required field | Contract Award Date is required field for Award Notice | Publish, Uncancel, Unarchive +400|Award Date | Contract Award Date provided is in an invalid format | Date is not in specified format | Publish, Uncancel, Unarchive +400|Award Date | Contract Award Date set would result in inactive date being in the past | Contract Award Date cannot be 15 days prior to the current date if the Archiving policy is "15 days from Award date" for an Award Notice | Publish, Uncancel, Unarchive +400|Award Date | Contract Award Date provided should have 4 digit year | Invalid Year provided in the Award Date | Publish, Uncancel, Unarchive +400|Award Number | Contract Award Number is a required field | Contract Award Number is required for Intent to Bundle, Justification, Award | Publish +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 +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 if the DUNS is not provided for an Award Notice | 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 |Awardee Name or DUNS# not provided for Award notice| Publish +400|Awardee Country | Award Details Section - Country is required |Country Code is required if the Awardee name is provided instead of DUNS# | Publish +400|Awardee Country | Award Details Section - Country provided is invalid |Country Code provided is invalid | Publish +400|Awardee State | Award Details Section - State is required |State Code is required if the Awardee name is provided instead of DUNS# | Publish +400|Awardee State | Award Details Section - State provided is invalid |State Code provided is invalid | Publish +400|Awardee City | Award Details Section - City is required |City Code is required if the Awardee name is provided instead of DUNS# | Publish +400|Awardee City | Award Details Section - City provided is invalid |City Code provided is invalid | Publish +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. | 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 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|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 -400|Request Id | Duplicate request. Vendor is already added as an authorized party on the notice. | Request already exists for the vendor on the notice. | AddAuthorizedParty -400|Duns# | No contact match on vendor data provided. | Not a Valid email or Duns#. | AddAuthorizedParty +400|Primary Contact | Primary Contact is required | Primary Contact is required for all types except Award| Publish +400|Primary Contact Full Name | Primary Contact - Full Name is required | Point of Contact Email is required for all types except Award | 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 - Email is required | Point of Contact Email is required for all types except Award | 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|Resources - attType | Attachment must have AttType of file or link | Attachment type must be a file or a line | Create Attachment +400|Resources - resourceName | Attachment must have a name | Attachment Name is a required field | Create Attachment, Create And Publish +400|Resources - content |Attachment must have content | File content is missing | Create Attachment, Create And Publish +400|Resources - description | Link Resource must have a description | Link provided is missing description | Create Attachment, Create And Publish +400|Resources - description | Link with the display text {} already exists | Link with the same description/name already exists on the notice | Create Attachment, Create And Publish +400|Resources - link | Link Resource must have a link | Link URL is missing | Create Attachment, Create And Publish +400|Resources - link | Please enter a valid url. [protocol]://hostname.domain. Protocol can be ftp, http, or https. Spaces are not allowed | Link URL is not valid | Create Attachment, Create And Publish +400|Resources - link | Link {} already exists| Link URL is already added to the notice | Create Attachment, Create And Publish +400|Resources - resourceName | The file type that you are trying to upload is not supported | File extension provided is unsupported | Create Attachment, Create And Publish +400|Resources - resourceName | Attachment with the name {} already exists | File with the same name is already added to the notice | Create Attachment, Create And Publish +400|Resources - content | The file size should be greater than zero bytes and less than 250 MB | File Size doesn't meet the specified limits | Create Attachment, Create And 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|Cancel - 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|Uncancel -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|UnArchive, Uncancel - Archive Date | New archive date is required | New archive date is required | Unarchive, Uncancel +400|UnArchive, Uncancel - Archive Date | New archive date provided is in an invalid format | New archive date provided is in an invalid format | Unarchive, Uncancel +400|UnArchive, Uncancel - Archive Date| New archive date provided is in the past | New archive date provided is before today's date | Unarchive, Uncancel +400|UnArchive, Uncancel - Archive Date | New archive type is invalid | archive type is not one of the following "auto15", "autocustom", "auto30" | Unarchive, Uncancel +400|UnArchive, Uncancel - Award Date | New contract award date provided is in the past | New contract award date provided is in the past. | Unarchive, Uncancel +400|UnArchive, Uncancel - Award Date | New contract award date is not provided | New contract award date is not provided | Unarchive, Uncancel +400|UnArchive, Uncancel - Response Date | New response date is required | Unarchive requires new response date | UnArchive +400|UnArchive, Uncancel - Response Date | New response date provided is in an invalid format | Invalid date format | UnArchive +400|UnArchive, Uncancel - Response Date | New response date provided is in the past | Response Date cannot be in the past | UnArchive +400|UnArchive, Uncancel - Response Date | New response date provided would place inactive date in the past | New response date providedis within 15 days | UnArchive +400|Delete | This opportunity cannot be deleted. This opportunity is a revision | This opportunity cannot be deleted. This opportunity is a revision. | Delete +400|Delete | Opportunity has been already deleted | Opportunity has been already deleted | Delete +400|Delete | This opportunity cannot be deleted. The delete request is missing `Delete option` field | This opportunity cannot be deleted. The delete request is missing `Delete option` field. | Delete +400|Delete | This opportunity cannot be deleted. The `Delete option` provided is not supported | This opportunity cannot be deleted. The `Delete option` provided is not supported. | Delete +400|Delete | This opportunity cannot be deleted. The `Delete option` provided is not supported for deleting original published notice. | This opportunity cannot be deleted. The `Delete option` provided is not supported for deleting original published notice. | Delete +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|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|Revise | Opportunity cannot be updated | An Opportunity cannot be revised if that Opporutnity was revised previously and is currently in draft state | Revise +400|Vendor Data | Duplicate request. Vendor is already added as an authorized party on the notice | Request already exists for the vendor on the notice. | AddAuthorizedParty +400|Duns# | No contact match on vendor data provided | Not a Valid email or Duns# | AddAuthorizedParty +404|Opportunity Id, VendorData |No request found for the notice and the vendor data provided| Unable to find a request for the opportunity and vendor details provided.| Approve or Reject Explicit Access Request By Vendor Data. 401|Authorization| Error code: 401 ; User does not have sufficient privileges to perform this action| Invalid API key is used other than write sensitive permission |Add Authorized Party 400|Authorization |Error code: 400 ; Duplicate request. Vendor is already added as an authorized party on the notice | If a party is already added and is being added again by a contract writing individual| Add Authorized Party 401|Authorization| Error code: 401 ; Your request did not get processed! Please verify your permission/roles| If nonfed email id is used in authorization |Get Authorized Party -400|Entity| Error code: 400 ; No contact match on vendor data provided| Wrong entity info is entered |Add Authorized Party -400|Duns#| No contact match on vendor data provided. |Not a Valid email or Duns#.| AddAuthorizedParty, Approve or Reject Explicit Access Request By Vendor Data. -404|Opportunity Id, VendorData |No request found for the notice and the vendor data provided.| Unable to find a request for the opportunity and vendor details provided.| Approve or Reject Explicit Access Request By Vendor Data. -400|JSON| No Request JSON Given| Can't parse JSON. Raw result: error processing request| Delete Latest or All Notices - ## FAQ @@ -3333,7 +3871,14 @@ 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 +10/31/2019| v0.91| Delete Vendor removed
Delete Resource in Draft API added
API Specifications Updated: Delete Notice, Getlist, Download Metadata for Attachment by Resource ID, and Download Metadata for Attachment by Opportunity ID
JSON Updated: Create and Update, Create and Publish, Revise Opportunity, Cancel Notice, Uncancel Notice, Archive, Unarchive, Create Attachment, Update Attachment, IVL Settings, and Delete Notice
Error Message Section Updated -

Back to top

\ No newline at end of file + + + +

Back to top

diff --git a/_apidocs/opportunities-soap-api.md b/_apidocs/opportunities-soap-api.md index e22f5d887..02c986e1f 100644 --- a/_apidocs/opportunities-soap-api.md +++ b/_apidocs/opportunities-soap-api.md @@ -197,8 +197,8 @@ 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 | 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 +awardee | string | No - Either awardee or awardee_duns is required | Awardee | 255 characters +awardee_duns | string | 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 | @@ -260,9 +260,9 @@ 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 -_ ( ) { } +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 # | [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 - _ ( ) {} +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 @@ -2044,6 +2044,70 @@ Please note that variances may exist between SOAP requests generated by differen
+ +
+ Response Sample - Presol Success + +
+ + +
+ Response Sample - Award Success + +
+ +
Response Sample - Failure @@ -3296,15 +3376,15 @@ Note: This service gets a list of all notices test_document3.pdf SnVzdCBhIHNtYWxsIHRlc3Q test doc 1 -true - + true + - test_document2.pdf + test_document2.pdf SnVzdCBhIHNtYWxsIHRlc3Q22 test doc 2 -false - + false + @@ -4047,38 +4127,31 @@ 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 +date |1. This field should meet the character limit/restrictions | 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. 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| 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 -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

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. 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 +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 must be unique based on selected notice type.

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. If an invalid ntype is provided, then service throws an error

3. If the solicitation is related to ntype that is not allowed, then the system throws an error |1. Opportunity not found with given solicitation number and ntype

2. Invalid NTYPE value provided

3.The Related Notice's Type is invalid for this Opportunity +awdnbr| 1. This field is required where applicable

2. If value provided does not meet the character limit/restrictions, then service throws an error| 1. Contract Award Number is a required field

2.Contract Award Number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces +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. Task/Delivery Order Number is required field

2. Task/Delivery Order Number max length is 255 characters and allows only alphanumeric and - _ ( ) characters with no spaces +awdamt| 1. This field is required where applicable

2. If an invalid integer values= is given, then service throws an error

3. If value provided does not meet the character limit/restrictions, then service throws an error |1. Base and All Options Value is a required field

2. Base and All Options Value - Invalid input: Please enter a valid number

3. Base and All Options Value max length is 64 digits +linenbr| 1.If value provided does not meet the character limit/restrictions, then service throws an error |1. The Contract Line Item number max length is 255 characters and allows only alphanumeric and - _ ( ) { } characters with no spaces +awddate | 1. This field is required where applicable

2. This field should meet the character limit/restrictions

3. If the Contract Award Date is 15 days prior to the current date and the archive date is not provided then the service throws an error| 1. Contract Award Date is required field

2. DATE field in unexpected format. Expects YYYYMMDD

3. 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. Authority 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 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 an error

3. If the date provided exceeds 5 years from the current date, then the system throws an error

4. Either respdate or archdate required for SRCSGT, PRESOL, SSALE.If none is provided, then the service throws the error | 1. DATE field in unexpected format. Expects YYYYMMDD

2. Response date provided is in the past

3. Response Date cannot exceed 5 years from current date

4. One of Response date or Archive date is required +archdate| 1. This field should meet the character limit/restrictions

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

3. Either respdate or archdate required for SRCSGT, PRESOL, SSALE.If none is provided, then the service throws the error | 1. DATE field in unexpected format Expects YYYYMMDD

2. Archive date provided is in the past

3. One of Response date or Archive date is required 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 +link| 1. If a link is with same name and url is added to the notice during modification/amendment, then the service throws an error | 1. Link with the display text {} already exists 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 +setaside| 1. If an invalid set aside code is given, then the service throws an error |1. Set Aside provided did not match expected codes popaddress| This is a free Text. No validation is performed on this field | NA -popzip |No |5 digits -popcountry| No| 1. Award Details Section - Country is a required field -city |NA| NA -state | NA| NA +popzip | |5 digits +popcountry|1. This field is required where applicable | 1. Award Details Section - Country is required +city |1. This field is required where applicable| 1. Award Details Section - City is required +state | 1. This field is required where applicable| 1. Award Details Section - State is required 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 @@ -4227,7 +4300,7 @@ id| 1. If the request Id is not provided, then the system throws an error