tango-python 1.8.0__tar.gz → 1.9.0__tar.gz

{tango_python-1.8.0 → tango_python-1.9.0}/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.9.0] - 2026-09-28
+
+### Added
+- **GSA eBuy requests** (Tango API 5.1.0). Four methods over the `/api/ebuy/` resource: `list_ebuy_requests()`, `get_ebuy_request()`, `get_ebuy_attachment_url()` and `get_ebuy_access()`, plus `EbuyRequest` / `EbuyAttachment` schemas, an `EbuyAccess` result type, and the `EBUY_REQUESTS_MINIMAL` / `EBUY_REQUESTS_COMPREHENSIVE` defaults. These are the RFQs, RFPs and RFIs posted to GSA eBuy. All fourteen of the API's filters are explicit named parameters, including `search` (which also matches attachment text), `reference_number`, `sin`, `agency` and `contract_number`.
+
+  Access is scoped to your account: you see only requests posted under the GSA schedule contracts linked to it, and the endpoints require the Pro tier or above. With no linked contract, `list_ebuy_requests()` returns an empty page rather than an error, so `get_ebuy_access()` reports whether access is enabled, why not (`tier_required` or `no_contract_grant`), and which contracts are linked. `status` is frozen at the last state a request was seen in, because a request that closes stops appearing rather than getting a final row; read `last_seen` for staleness. `get_ebuy_attachment_url()` returns the short-lived signed URL the API redirects to without downloading the document, and raises the new `TangoAttachmentLinkError` (a `TangoValidationError`) with the link on `.url` when the entry is an external link rather than a stored document. The `agency` filter requires Tango API 5.3.0.
+- **`alerts.ebuy_request.match` is an alertable event type.** `create_webhook_alert(query_type="ebuy_request", ...)` works.
+
 ## [1.8.0] - 2026-09-28
 
 ### Added

{tango_python-1.8.0 → tango_python-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tango-python
-Version: 1.8.0
+Version: 1.9.0
 Summary: Python SDK for the Tango API
 Project-URL: Homepage, https://github.com/makegov/tango-python
 Project-URL: Documentation, https://docs.makegov.com/tango-python
@@ -308,6 +308,15 @@ protests = client.list_protests(source_system="gao", outcome="Sustained", limit=
 protest = client.get_protest("CASE_UUID")
 ```
 
+### GSA eBuy
+
+```python
+access = client.get_ebuy_access()  # scoped to the schedule contracts linked to your account
+requests = client.list_ebuy_requests(status="Open", sin="54151S", limit=25)
+request = client.get_ebuy_request("RFQ1835158")
+url = client.get_ebuy_attachment_url("RFQ1835158", doc_seq_num=1)  # short-lived signed URL
+```
+
 ### GSA eLibrary Contracts
 
 ```python

{tango_python-1.8.0 → tango_python-1.9.0}/README.md

@@ -254,6 +254,15 @@ protests = client.list_protests(source_system="gao", outcome="Sustained", limit=
 protest = client.get_protest("CASE_UUID")
 ```
 
+### GSA eBuy
+
+```python
+access = client.get_ebuy_access()  # scoped to the schedule contracts linked to your account
+requests = client.list_ebuy_requests(status="Open", sin="54151S", limit=25)
+request = client.get_ebuy_request("RFQ1835158")
+url = client.get_ebuy_attachment_url("RFQ1835158", doc_seq_num=1)  # short-lived signed URL
+```
+
 ### GSA eLibrary Contracts
 
 ```python

{tango_python-1.8.0 → tango_python-1.9.0}/docs/API_REFERENCE.md

@@ -24,6 +24,7 @@ Complete reference for all Tango Python SDK methods and functionality.
 - [Protests](#protests)
 - [Contract Appeals](#contract-appeals)
 - [Federal Register](#federal-register)
+- [GSA eBuy](#gsa-ebuy)
 - [Budget](#budget)
 - [Business Types](#business-types)
 - [NAICS](#naics)
@@ -1602,6 +1603,118 @@ forecast = client.get_sled_forecast("FORECAST_UUID")
 
 ---
 
+## GSA eBuy
+
+GSA eBuy requests for quotes, proposals and information (RFQs, RFPs, RFIs), keyed by `rfq_id`.
+
+**Access is scoped to your account.** You see only requests posted under the GSA schedule contracts linked to your account, and the endpoints require the Pro tier or above (below it they return 403). With no linked contract, `list_ebuy_requests()` returns an empty page rather than an error, and `get_ebuy_request()` raises `TangoNotFoundError` for a request outside your scope, the same as for an id that does not exist. Use `get_ebuy_access()` to tell "no access" from "no matches".
+
+### list_ebuy_requests()
+
+List requests with filtering and shaping.
+
+```python
+requests = client.list_ebuy_requests(
+    page=1,
+    limit=25,
+    shape=ShapeConfig.EBUY_REQUESTS_MINIMAL,
+    # Filter parameters (all optional)
+    search=None,
+    rfq_id=None,
+    reference_number=None,
+    request_type=None,
+    status=None,
+    sin=None,
+    schedule=None,
+    buyer_agency=None,
+    agency=None,
+    contract_number=None,
+    issue_date_after=None,
+    issue_date_before=None,
+    close_date_after=None,
+    close_date_before=None,
+    ordering=None,
+)
+```
+
+**Filter Parameters:**
+- `search` - Full-text search over the title, description, reference number, request id and attachment text. Results rank by relevance unless `ordering` is given
+- `rfq_id` - Exact request id, e.g. `"RFQ1835158"`
+- `reference_number` - The buyer's own solicitation number; dashes are ignored
+- `request_type` - `"RFQ"`, `"RFP"` or `"RFI"`
+- `status` - `"Open"` or `"Cancelled"`, as last seen (see the note below)
+- `sin` - Special Item Number, e.g. `"54151S"`
+- `schedule` - GSA schedule
+- `buyer_agency` - The buyer agency as eBuy names it (free text)
+- `agency` - A Tango agency name, abbreviation, code or organization key, e.g. `"GSA"`. Matches the whole organization subtree, so a department includes its sub-agencies. Requires Tango API 5.3.0
+- `contract_number` - Narrow to requests posted under one of your own linked contracts. A contract not linked to your account returns an empty page, not an error
+- `issue_date_after` / `issue_date_before` - Issue date range (`YYYY-MM-DD`, inclusive)
+- `close_date_after` / `close_date_before` - Close date range (`YYYY-MM-DD`, inclusive)
+- `ordering` - `issue_date` (the default, as `-issue_date`), `close_date`, `last_seen` or `modified`; prefix `-` for descending
+
+String filters accept several values joined with `|` (OR).
+
+**Returns:** [PaginatedResponse](#paginatedresponse) with request dictionaries
+
+**Example:**
+```python
+requests = client.list_ebuy_requests(status="Open", sin="54151S", ordering="close_date")
+
+for req in requests.results:
+    print(f"{req['rfq_id']} closes {req['close_date']}: {req['title']}")
+    print(f"  last seen {req['last_seen']}")
+```
+
+**Notes:**
+- **`status` is frozen at the last state the request was seen in.** Only currently-active requests are carried, so a request that closes stops appearing rather than getting a final row. `Open` means "open the last time it was seen", not "open now"; read `last_seen` for staleness.
+- The contract number a request was posted under is never returned in any payload.
+- `buyer_agency_code` and some other buyer and contact fields are sparse on older requests.
+
+### get_ebuy_request()
+
+Get a single request by `rfq_id`.
+
+```python
+request = client.get_ebuy_request(
+    "RFQ1835158",
+    shape=ShapeConfig.EBUY_REQUESTS_COMPREHENSIVE,
+)
+
+for attachment in request["attachments"]:
+    print(attachment["doc_seq_num"], attachment["doc_name"], attachment["is_link"])
+```
+
+The default shape returns every field plus two expands: `organization` (the buyer office, with the same seven keys as other resources' `organization` expand) and `attachments`. Each attachment carries `doc_seq_num`, `doc_name`, `doc_type`, `doc_path`, `is_link` and `doc_session_date`. `is_link=True` means `doc_path` is an outbound URL with no stored document behind it. `amendments`, `line_items` and `addresses` are lists of objects, served as eBuy publishes them.
+
+### get_ebuy_attachment_url()
+
+Get a short-lived download URL for one stored attachment.
+
+```python
+url = client.get_ebuy_attachment_url("RFQ1835158", doc_seq_num=1)
+```
+
+**Returns:** The signed URL the API redirects to, as a string. The SDK reads the redirect without following it, so no document is downloaded. The URL expires after about five minutes: fetch it promptly, and call this again rather than storing it.
+
+**Raises:**
+- `TangoAttachmentLinkError` (a `TangoValidationError`) - The entry is an external link (`is_link`), not a stored document. The link is on `error.url`
+- `TangoNotFoundError` - The request is unknown or outside your scope, the attachment does not exist, or its document has not been captured yet
+
+### get_ebuy_access()
+
+Check whether your account can read eBuy requests.
+
+```python
+access = client.get_ebuy_access()
+if not access.enabled:
+    print(access.reason)  # "tier_required" or "no_contract_grant"
+print(access.contracts)   # your own linked contracts, sorted
+```
+
+**Returns:** `EbuyAccess` with `enabled` (bool), `reason` (`"tier_required"`, `"no_contract_grant"` or `None`; `tier_required` wins when both apply) and `contracts` (list of str).
+
+---
+
 ## Budget
 
 Federal account × fiscal year budget rollups, covering the full budget lifecycle (requested → enacted → apportioned → obligated → outlayed), pre-computed ratios and trends, the contract / assistance / unlinked breakdown, and request-vs-actual spend.
@@ -2401,6 +2514,8 @@ entity = client.get_entity("UEI_KEY", shape=ShapeConfig.ENTITIES_COMPREHENSIVE)
 | `CONTRACT_APPEALS_COMPREHENSIVE` | `get_contract_appeal` | The list fields plus docket_raw, docket_source, decision_date_repaired, decision_type_raw, listing_year, first_listed_at, listed, text_status, text_char_count (omits `decision_text`, which needs an Enterprise plan) |
 | `FEDERAL_REGISTER_MINIMAL` | `list_federal_register_documents` | uuid, document_number, publication_date, type, subtype, title, abstract, action, agencies, cfr_references, citation, significant, comments_close_on, effective_on, html_url, pdf_url |
 | `FEDERAL_REGISTER_COMPREHENSIVE` | `get_federal_register_document` | The list fields plus dates, signing_date, start_page, end_page, volume, docket_ids, dockets, regulation_id_numbers, topics, correction_of, corrections, executive_order_number, presidential_document_number, proclamation_number, comment_url, regulations_dot_gov_url, raw_text_url, body_html_url (omits `full_text`) |
+| `EBUY_REQUESTS_MINIMAL` | `list_ebuy_requests` | rfq_id, request_type, title, schedule, sin, status, buyer_name, buyer_agency, buyer_agency_code, reference_number, issue_date, close_date, attachment_count, link_count, last_seen |
+| `EBUY_REQUESTS_COMPREHENSIVE` | `get_ebuy_request` | Every field, plus the `organization` and `attachments` expands |
 | `BUDGET_ACCOUNTS_MINIMAL` | `list_budget_accounts`, `get_budget_account` | id, federal_account_symbol, fiscal_year, agency_code/name, bureau_name, account_title, bea_category, on_off_budget, subfunction_code, lifecycle (requested/enacted/apportioned/obligated/outlayed/unobligated), contract & assistance rollups, key ratios, next-year growth |
 | `VEHICLE_ORDERS_MINIMAL` | `list_vehicle_orders` | key, piid, award_date, recipient(display_name,uei), total_contract_value, obligated |
 | `ITDASHBOARD_INVESTMENTS_MINIMAL` | `list_itdashboard_investments` | Minimal IT Dashboard investment fields |

{tango_python-1.8.0 → tango_python-1.9.0}/docs/WEBHOOKS.md

@@ -90,6 +90,7 @@ tango webhooks list-event-types
 # alerts.sled_opportunity.match  State/local/education solicitation matched a saved alert
 # alerts.contract_appeal.match  CBCA/ASBCA appeal decision matched a saved alert
 # alerts.federal_register.match  Federal Register document matched a saved alert
+# alerts.ebuy_request.match  GSA eBuy request matched a saved alert
 ```
 
 This list is served by the API, so it is always current — the SDK does not hardcode

{tango_python-1.8.0 → tango_python-1.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tango-python"
-version = "1.8.0"
+version = "1.9.0"
 description = "Python SDK for the Tango API"
 readme = "README.md"
 requires-python = ">=3.12"

{tango_python-1.8.0 → tango_python-1.9.0}/scripts/check_filter_shape_conformance.py

@@ -79,6 +79,7 @@ RESOURCE_TO_METHOD: dict[str, str | None] = {
     "protests": "list_protests",
     "contract_appeals": "list_contract_appeals",
     "federal_register": "list_federal_register_documents",
+    "ebuy/requests": "list_ebuy_requests",
     "offices": "list_offices",
     "psc": "list_psc",
     "mas_sins": "list_mas_sins",

{tango_python-1.8.0 → tango_python-1.9.0}/scripts/check_shape_coverage.py

@@ -70,6 +70,7 @@ RESOURCE_TO_MODEL: dict[str, str] = {
     "protests": "Protest",
     "contract_appeals": "ContractAppeal",
     "federal_register": "FederalRegisterDocument",
+    "ebuy/requests": "EbuyRequest",
     "offices": "Office",
     "assistance_listings": "AssistanceListing",
     "business_types": "BusinessType",

{tango_python-1.8.0 → tango_python-1.9.0}/tango/__init__.py

@@ -3,6 +3,7 @@
 from .client import TangoClient
 from .exceptions import (
     TangoAPIError,
+    TangoAttachmentLinkError,
     TangoAuthError,
     TangoNotFoundError,
     TangoRateLimitError,
@@ -14,6 +15,9 @@ from .models import (
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
+    EbuyAccess,
+    EbuyAttachment,
+    EbuyRequest,
     Exclusion,
     FederalRegisterDocument,
     GsaElibraryContract,
@@ -55,13 +59,14 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.8.0"
+__version__ = "1.9.0"
 __all__ = [
     "TangoClient",
     "TangoAPIError",
     "TangoAuthError",
     "TangoNotFoundError",
     "TangoValidationError",
+    "TangoAttachmentLinkError",
     "TangoRateLimitError",
     "RateLimitInfo",
     "ResolveCandidate",
@@ -69,6 +74,9 @@ __all__ = [
     "BudgetAccount",
     "ContractAppeal",
     "FederalRegisterDocument",
+    "EbuyAccess",
+    "EbuyAttachment",
+    "EbuyRequest",
     "DibbsAward",
     "DibbsRfp",
     "DibbsRfq",

{tango_python-1.8.0 → tango_python-1.9.0}/tango/client.py

@@ -5,12 +5,13 @@ import warnings
 from datetime import date, datetime
 from decimal import Decimal
 from typing import Any, Literal, cast
-from urllib.parse import urljoin
+from urllib.parse import quote, urljoin
 
 import httpx
 
 from tango.exceptions import (
     TangoAPIError,
+    TangoAttachmentLinkError,
     TangoAuthError,
     TangoNotFoundError,
     TangoRateLimitError,
@@ -28,6 +29,8 @@ from tango.models import (
     DibbsAward,
     DibbsRfp,
     DibbsRfq,
+    EbuyAccess,
+    EbuyRequest,
     Entity,
     Exclusion,
     FederalRegisterDocument,
@@ -175,55 +178,57 @@ class TangoClient:
             self._last_response_headers = response.headers
             self._last_rate_limit_info = self._parse_rate_limit_headers(response.headers)
 
-            if response.status_code == 401:
-                raise TangoAuthError(
-                    "Invalid API key or authentication required", response.status_code
-                )
-            elif response.status_code == 404:
-                raise TangoNotFoundError("Resource not found", response.status_code)
-            elif response.status_code == 400:
-                error_data = response.json() if response.content else {}
-                error_msg = "Invalid request parameters"
-                if error_data:
-                    # Try to extract a more specific error message
-                    if isinstance(error_data, dict):
-                        detail = (
-                            error_data.get("detail")
-                            or error_data.get("message")
-                            or error_data.get("error")
-                        )
-                        if detail:
-                            error_msg = f"Invalid request parameters: {detail}"
-                        issues = error_data.get("issues")
-                        if isinstance(issues, list):
-                            rejected = [
-                                f"{issue['path']} ({issue['reason']})"
-                                if issue.get("reason")
-                                else str(issue["path"])
-                                for issue in issues
-                                if isinstance(issue, dict) and issue.get("path")
-                            ]
-                            if rejected:
-                                error_msg = f"{error_msg}: {', '.join(rejected)}"
-                raise TangoValidationError(
-                    error_msg,
-                    response.status_code,
-                    error_data,
-                )
-            elif response.status_code == 429:
-                error_data = response.json() if response.content else {}
-                detail = error_data.get("detail", "Rate limit exceeded")
-                raise TangoRateLimitError(detail, response.status_code, error_data)
-            elif not response.is_success:
-                raise TangoAPIError(
-                    f"API request failed with status {response.status_code}", response.status_code
-                )
+            self._raise_for_status(response)
 
             return response.json() if response.content else {}
 
         except httpx.HTTPError as e:
             raise TangoAPIError(f"Request failed: {str(e)}") from e
 
+    def _raise_for_status(self, response: httpx.Response) -> None:
+        """Raise the SDK exception matching a non-success response; return quietly on success."""
+        if response.status_code == 401:
+            raise TangoAuthError("Invalid API key or authentication required", response.status_code)
+        elif response.status_code == 404:
+            raise TangoNotFoundError("Resource not found", response.status_code)
+        elif response.status_code == 400:
+            error_data = response.json() if response.content else {}
+            error_msg = "Invalid request parameters"
+            if error_data:
+                # Try to extract a more specific error message
+                if isinstance(error_data, dict):
+                    detail = (
+                        error_data.get("detail")
+                        or error_data.get("message")
+                        or error_data.get("error")
+                    )
+                    if detail:
+                        error_msg = f"Invalid request parameters: {detail}"
+                    issues = error_data.get("issues")
+                    if isinstance(issues, list):
+                        rejected = [
+                            f"{issue['path']} ({issue['reason']})"
+                            if issue.get("reason")
+                            else str(issue["path"])
+                            for issue in issues
+                            if isinstance(issue, dict) and issue.get("path")
+                        ]
+                        if rejected:
+                            error_msg = f"{error_msg}: {', '.join(rejected)}"
+            raise TangoValidationError(
+                error_msg,
+                response.status_code,
+                error_data,
+            )
+        elif response.status_code == 429:
+            error_data = response.json() if response.content else {}
+            detail = error_data.get("detail", "Rate limit exceeded")
+            raise TangoRateLimitError(detail, response.status_code, error_data)
+        elif not response.is_success:
+            raise TangoAPIError(
+                f"API request failed with status {response.status_code}", response.status_code
+            )
+
     def _get(self, endpoint: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
         """Make a GET request"""
         return self._request("GET", endpoint, params=params)
@@ -2963,6 +2968,215 @@ class TangoClient:
             data, shape, FederalRegisterDocument, flat, flat_lists
         )
 
+    # ============================================================================
+    # GSA eBuy requests
+    # ============================================================================
+
+    def list_ebuy_requests(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+        search: str | None = None,
+        rfq_id: str | None = None,
+        reference_number: str | None = None,
+        request_type: str | None = None,
+        status: str | None = None,
+        sin: str | None = None,
+        schedule: str | None = None,
+        buyer_agency: str | None = None,
+        agency: str | None = None,
+        contract_number: str | None = None,
+        issue_date_after: str | None = None,
+        issue_date_before: str | None = None,
+        close_date_after: str | None = None,
+        close_date_before: str | None = None,
+        ordering: str | None = None,
+    ) -> PaginatedResponse:
+        """
+        List GSA eBuy requests (RFQs, RFPs and RFIs).
+
+        Requires the Pro tier or above; below it the API returns 403.
+        Results are scoped to your account: you see only requests posted under the GSA schedule contracts linked to it.
+        With no linked contract the page is empty rather than an error, so use ``get_ebuy_access()`` to tell "no access" from "no matches".
+
+        ``status`` is frozen at the last state the request was seen in.
+        Only currently-active requests are carried, so a request that closes stops appearing rather than getting a final row, and ``Open`` means "open the last time it was seen".
+        Read ``last_seen`` for staleness.
+
+        Args:
+            page: Page number
+            limit: Results per page (max 100)
+            shape: Response shape string (defaults to minimal shape)
+            flat: If True, flatten nested objects in shaped response
+            flat_lists: If True, flatten arrays using indexed keys
+            search: Full-text search over the title, description, reference number, request id and attachment text. Results rank by relevance unless ``ordering`` is given
+            rfq_id: Exact request id, e.g. ``RFQ1835158``. OR several with ``|``
+            reference_number: The buyer's own solicitation number; dashes are ignored
+            request_type: ``RFQ``, ``RFP`` or ``RFI``. OR several with ``|``
+            status: ``Open`` or ``Cancelled``, as last seen. OR several with ``|``
+            sin: Special Item Number, e.g. ``54151S``. OR several with ``|``
+            schedule: GSA schedule. OR several with ``|``
+            buyer_agency: The buyer agency as eBuy names it (free text). OR several with ``|``
+            agency: A Tango agency name, abbreviation, code or organization key, e.g. ``GSA``. Matches the whole organization subtree, so a department includes its sub-agencies. OR several with ``|``. Requires Tango API 5.3.0
+            contract_number: Narrow to requests posted under one of your own linked contracts. A contract not linked to your account returns an empty page, not an error
+            issue_date_after: Issued on or after (YYYY-MM-DD)
+            issue_date_before: Issued on or before (YYYY-MM-DD)
+            close_date_after: Closes on or after (YYYY-MM-DD)
+            close_date_before: Closes on or before (YYYY-MM-DD)
+            ordering: Sort field — ``issue_date`` (the default, as ``-issue_date``), ``close_date``, ``last_seen`` or ``modified``. Prefix ``-`` for descending
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+
+        if shape is None:
+            shape = ShapeConfig.EBUY_REQUESTS_MINIMAL
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        for key, val in (
+            ("search", search),
+            ("rfq_id", rfq_id),
+            ("reference_number", reference_number),
+            ("request_type", request_type),
+            ("status", status),
+            ("sin", sin),
+            ("schedule", schedule),
+            ("buyer_agency", buyer_agency),
+            ("agency", agency),
+            ("contract_number", contract_number),
+            ("issue_date_after", issue_date_after),
+            ("issue_date_before", issue_date_before),
+            ("close_date_after", close_date_after),
+            ("close_date_before", close_date_before),
+            ("ordering", ordering),
+        ):
+            if val is not None:
+                params[key] = val
+
+        data = self._get("/api/ebuy/requests/", params)
+
+        results = [
+            self._parse_response_with_shape(item, shape, EbuyRequest, flat, flat_lists)
+            for item in data["results"]
+        ]
+
+        return PaginatedResponse(
+            count=data["count"],
+            next=data.get("next"),
+            previous=data.get("previous"),
+            results=results,
+            meta=data.get("meta"),
+        )
+
+    def get_ebuy_request(
+        self,
+        rfq_id: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> Any:
+        """
+        Get a single GSA eBuy request by its request id.
+
+        A request outside your account's scope raises ``TangoNotFoundError``, the same as an id that does not exist.
+
+        Args:
+            rfq_id: Request id, e.g. ``RFQ1835158``
+            shape: Response shape string (defaults to the comprehensive shape: every field plus the ``organization`` and ``attachments`` expands)
+            flat: If True, flatten nested objects in shaped response
+            flat_lists: If True, flatten arrays using indexed keys
+        """
+        params: dict[str, Any] = {}
+        if shape is None:
+            shape = ShapeConfig.EBUY_REQUESTS_COMPREHENSIVE
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+
+        data = self._get(f"/api/ebuy/requests/{quote(rfq_id, safe='')}/", params)
+        return self._parse_response_with_shape(data, shape, EbuyRequest, flat, flat_lists)
+
+    def get_ebuy_attachment_url(self, rfq_id: str, doc_seq_num: int) -> str:
+        """
+        Get a short-lived download URL for one attachment on a GSA eBuy request.
+
+        The API answers with a redirect to a signed URL that expires after about five minutes; this returns that URL without downloading the document.
+        Fetch it promptly, and call this again rather than storing it.
+
+        Args:
+            rfq_id: Request id, e.g. ``RFQ1835158``
+            doc_seq_num: The attachment's ``doc_seq_num`` from ``get_ebuy_request()``
+
+        Raises:
+            TangoAttachmentLinkError: The entry is an external link (``is_link``), not a stored document. The link is on ``.url`` and in the message. Subclasses ``TangoValidationError``.
+            TangoNotFoundError: The request is unknown or outside your scope, the attachment does not exist, or its document has not been captured yet.
+        """
+        endpoint = (
+            f"/api/ebuy/requests/{quote(rfq_id, safe='')}/attachments/{int(doc_seq_num)}/download/"
+        )
+        url = urljoin(f"{self.base_url}/", endpoint.lstrip("/"))
+
+        try:
+            response = self.client.request(method="GET", url=url, follow_redirects=False)
+        except httpx.HTTPError as e:
+            raise TangoAPIError(f"Request failed: {str(e)}") from e
+        self._last_response_headers = response.headers
+        self._last_rate_limit_info = self._parse_rate_limit_headers(response.headers)
+
+        location = response.headers.get("Location")
+        if response.is_redirect and location:
+            return str(location)
+
+        if response.status_code in (400, 404):
+            try:
+                error_data = response.json() if response.content else {}
+            except ValueError:
+                error_data = {}
+            if not isinstance(error_data, dict):
+                error_data = {}
+            if response.status_code == 400 and error_data.get("url"):
+                raise TangoAttachmentLinkError(
+                    f"Attachment {doc_seq_num} on {rfq_id} is an external link, not a stored document: {error_data['url']}",
+                    response.status_code,
+                    error_data,
+                )
+            if response.status_code == 404:
+                raise TangoNotFoundError(
+                    error_data.get("detail") or "Resource not found",
+                    response.status_code,
+                    error_data,
+                )
+
+        self._raise_for_status(response)
+        raise TangoAPIError(
+            f"Expected a redirect to the attachment, got status {response.status_code}",
+            response.status_code,
+        )
+
+    def get_ebuy_access(self) -> EbuyAccess:
+        """
+        Check whether your account can read GSA eBuy requests.
+
+        ``list_ebuy_requests()`` returns an empty page, not an error, when no contract is linked; this tells the two apart.
+        ``reason`` is ``"tier_required"`` below the Pro tier (it wins when both apply), ``"no_contract_grant"`` when no contract is linked, and ``None`` when ``enabled`` is true.
+        ``contracts`` lists your own linked contracts, sorted.
+        """
+        data = self._get("/api/ebuy/access/")
+        return EbuyAccess(
+            enabled=bool(data.get("enabled")),
+            reason=data.get("reason"),
+            contracts=list(data.get("contracts") or []),
+        )
+
     # ============================================================================
     # DLA DIBBS (RFQs, RFPs, awards)
     # ============================================================================
@@ -5022,7 +5236,7 @@ class TangoClient:
             query_type: One of ``opportunity``, ``contract``, ``idv``, ``ota``,
                 ``otidv``, ``entity``, ``grant``, ``forecast``, ``exclusion``,
                 ``dibbs_rfq``, ``dibbs_rfp``, ``sled_opportunity``,
-                ``contract_appeal`` or ``federal_register``. :meth:`list_webhook_event_types` is the
+                ``contract_appeal``, ``federal_register`` or ``ebuy_request``. :meth:`list_webhook_event_types` is the
                 current authority — this list can only go stale.
             filters: Dict of query parameters that the alert matches against
                 (e.g. ``{"naics": "541330", "set_aside": "SBA"}``).

{tango_python-1.8.0 → tango_python-1.9.0}/tango/exceptions.py

@@ -53,6 +53,16 @@ class TangoValidationError(TangoAPIError):
         return val if isinstance(val, dict) else None
 
 
+class TangoAttachmentLinkError(TangoValidationError):
+    """The requested attachment is an external link, not a stored document, so there is nothing to download."""
+
+    @property
+    def url(self) -> str | None:
+        """The external link the entry points at."""
+        val = self.response_data.get("url")
+        return val if isinstance(val, str) else None
+
+
 class TangoRateLimitError(TangoAPIError):
     """Rate limit exceeded error"""