stackin-python-sdk 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

stackin/__init__.py

@@ -1,6 +1,6 @@
 """Invoice __init__ module."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 __description__ = (
     "Python SDK for issuing, consulting and cancelling electronic invoices."
 )

stackin/core/client.py

@@ -204,6 +204,26 @@ class Invoice:
             idempotency_key=idempotency_key,
         )
 
+    def pdf(
+        self,
+        access_key: str,
+        *,
+        document_type: DocumentType,
+    ) -> bytes:
+        """The authorizer's rendering of an authorized document.
+
+        Returns raw bytes — the only method that does not return a
+        parsed object. The XML is the legally valid document; this is a
+        convenience, and the authorizer's endpoint for it is unstable,
+        so an APIError with status 502 means the authorizer is
+        unavailable, not that the invoice is wrong. NFS-e only.
+        """
+        params = {"document_type": document_type.value}
+        response = self._send(
+            "GET", f"/invoices/{access_key}/pdf", params=params
+        )
+        return response.content
+
     def _headers(self, idempotency_key: str | None = None) -> dict:
         headers = {}
         if self.api_key:
@@ -221,6 +241,28 @@ class Invoice:
         params: dict | None = None,
         idempotency_key: str | None = None,
     ) -> dict:
+        response = self._send(
+            method,
+            path,
+            json=json,
+            params=params,
+            idempotency_key=idempotency_key,
+        )
+        try:
+            body = response.json() if response.content else {}
+        except ValueError:
+            body = {}
+        return body.get("result", body)
+
+    def _send(
+        self,
+        method: str,
+        path: str,
+        *,
+        json: dict | None = None,
+        params: dict | None = None,
+        idempotency_key: str | None = None,
+    ) -> requests.Response:
         url = f"{self.base_url}/api/v1{path}"
 
         try:
@@ -235,15 +277,14 @@ class Invoice:
         except requests.RequestException as error:
             raise ConnectionFailedError(str(error)) from error
 
-        try:
-            body = response.json() if response.content else {}
-        except ValueError:
-            body = {}
-
         if not response.ok:
+            try:
+                body = response.json() if response.content else {}
+            except ValueError:
+                body = {}
             raise APIError(
                 status_code=response.status_code,
                 detail=body.get("detail", response.text),
             )
 
-        return body.get("result", body)
+        return response

{stackin_python_sdk-0.2.0.dist-info → stackin_python_sdk-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackin-python-sdk
-Version: 0.2.0
+Version: 0.3.0
 Summary: Python SDK for issuing, consulting and cancelling electronic invoices.
 License-Expression: MIT
 License-File: LICENSE
@@ -47,7 +47,7 @@ Description-Content-Type: text/markdown
 
 Python SDK for fiscal document issuance — a handful of business fields, nothing about certificates, XML, XSD, signing or SOAP. The API resolves all of that from the issuer's own configuration, identified by `api_key`.
 
-**One class, `Invoice`** — `issue()`/`consult()`/`cancel()`/`reissue()`, nothing else to instantiate. Each line item is a `Product` (`stackin.br`) — `description`/`amount` are universal, everything else (`ncm`/`cfop`/`cest`/tax groups...) is Brazil-specific and only required for NFE; NFSE ignores it.
+**One class, `Invoice`** — `issue()`/`consult()`/`cancel()`/`reissue()`/`correct()`/`invalidate()`/`pdf()`, nothing else to instantiate. Each line item is a `Product` (`stackin.br`) — `description`/`amount` are universal, everything else (`ncm`/`cfop`/`cest`/tax groups...) is Brazil-specific and only required for NFE; NFSE ignores it.
 
 ## Install
 
@@ -80,6 +80,11 @@ client.cancel(
 )
 client.reissue(invoice["id"])  # retries a rejected/failed submission
 
+# The authorizer's PDF, as raw bytes. NFS-e only; the XML stays the
+# legally valid document, and a 502 here means the authorizer is down.
+with open("nota.pdf", "wb") as file:
+    file.write(client.pdf(access_key, document_type=DocumentType.NFSE))
+
 # NFE requires ncm/cfop on every item, plus the buyer's full recipient_address:
 client.issue(
     document_type=DocumentType.NFE,

{stackin_python_sdk-0.2.0.dist-info → stackin_python_sdk-0.3.0.dist-info}/RECORD

@@ -1,13 +1,13 @@
-stackin/__init__.py,sha256=9OWVJ1TnlnoVoD2AmoiQGwIA-DQLew4Ml75mfcC5xOI,495
+stackin/__init__.py,sha256=rsEjE3iiFCRB4EySvHJiK8B-OTrtB35teC6LHX9uo-Y,495
 stackin/br/__init__.py,sha256=Nw5VyeoFFJPqweZI60uADtBrxilXqkpzpkYtR5WZ630,656
 stackin/br/product.py,sha256=nuHQkWMz0eRmWYWPoduwmAfibBQvrcajEMxerwHGa9E,4004
 stackin/br/tax.py,sha256=PdUkg5JdNKy7AHlt5ZpM9svvilZA93FPMr2QNi0SRlw,7716
 stackin/core/__init__.py,sha256=dxtOP1DopMSNFYGh3Hf12RVcs58R9xwLn-gqfKFo-HE,19
 stackin/core/address.py,sha256=-w5R3nzfU5T3VoxIeygu5Dq4DRb_lJHAGc0lmSMwEMU,616
-stackin/core/client.py,sha256=wlhGiq5Xhv9rjSBkPRwYFfQnvu6LJKUtJoUTaV1m7X4,7198
+stackin/core/client.py,sha256=u8Q14sF844Pd0oMWy8AA0F4ry78p_s17mYprE2E8NNY,8486
 stackin/core/exceptions.py,sha256=enl8GS_WlDV6PyH1M_KTxzLG9Qdr-9MJrMXB_AlCtYg,521
 stackin/core/types.py,sha256=SYpLS2EnqKcudm7wFwCTOVAQe1IYT5T0TGSD0E6z8bo,416
-stackin_python_sdk-0.2.0.dist-info/METADATA,sha256=wXc35wC2pxiPCBsj5qk9Jf3f3Zsj1eQp3X2O9DBVgH0,9344
-stackin_python_sdk-0.2.0.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
-stackin_python_sdk-0.2.0.dist-info/licenses/LICENSE,sha256=D-XHDcKFFhzEo9C5Dp4QPvt00pb_u__hi4Bc08zpxyU,1072
-stackin_python_sdk-0.2.0.dist-info/RECORD,,
+stackin_python_sdk-0.3.0.dist-info/METADATA,sha256=pvDErFOVR0AphHcoXLuIU-cYwsHSgWvgEZLwwbctohI,9628
+stackin_python_sdk-0.3.0.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+stackin_python_sdk-0.3.0.dist-info/licenses/LICENSE,sha256=D-XHDcKFFhzEo9C5Dp4QPvt00pb_u__hi4Bc08zpxyU,1072
+stackin_python_sdk-0.3.0.dist-info/RECORD,,