stackin-python-sdk 0.5.0__tar.gz → 0.7.0__tar.gz

{stackin_python_sdk-0.5.0 → stackin_python_sdk-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackin-python-sdk
-Version: 0.5.0
+Version: 0.7.0
 Summary: Python SDK for issuing, consulting and cancelling electronic invoices.
 License-Expression: MIT
 License-File: LICENSE

{stackin_python_sdk-0.5.0 → stackin_python_sdk-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackin-python-sdk"
-version = "0.5.0"
+version = "0.7.0"
 authors = [
   { name = "Fernando Celmer", email = "email@fernandocelmer.com" },
 ]
@@ -45,7 +45,7 @@ Changelog = "https://github.com/stackin-io/stackin-python-sdk/releases"
 
 [tool.poetry]
 name = "stackin-python-sdk"
-version = "0.5.0"
+version = "0.7.0"
 description = "Python SDK for issuing, consulting and cancelling electronic invoices."
 authors = ["Fernando Celmer <email@fernandocelmer.com>"]
 readme = "README.md"

{stackin_python_sdk-0.5.0 → stackin_python_sdk-0.7.0}/stackin/__init__.py

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

{stackin_python_sdk-0.5.0 → stackin_python_sdk-0.7.0}/stackin/core/client.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import os
+from typing import Any
 
 import requests
 
@@ -140,15 +141,25 @@ class Invoice:
         *,
         document_type: DocumentType,
         reason: str,
+        idempotency_key: str | None = None,
     ) -> dict:
-        """Cancels a fiscal document by its access key."""
+        """Cancels a fiscal document by its access key.
+
+        Repeating the same idempotency_key with the same body replays
+        the first answer instead of cancelling twice. Cancelling is
+        irreversible and has a legal window, so a blind retry on a
+        dropped connection is the case this exists for.
+        """
         payload = {
             "document_type": document_type.value,
             "reason": reason,
         }
 
         return self._request(
-            "POST", f"/invoices/{access_key}/cancel", json=payload
+            "POST",
+            f"/invoices/{access_key}/cancel",
+            json=payload,
+            idempotency_key=idempotency_key,
         )
 
     def invalidate(
@@ -275,6 +286,14 @@ class Invoice:
 
         return self._request("GET", "/invoices", params=params)
 
+    def submissions(self, invoice_id: str) -> list:
+        """Every attempt made for one invoice, and what came back.
+
+        consult() gives the status; this gives the reason. Takes the
+        invoice_id because a rejected document has no access key.
+        """
+        return self._request("GET", f"/invoices/{invoice_id}/submissions")
+
     def manifest(
         self,
         access_key: str,
@@ -326,7 +345,7 @@ class Invoice:
         json: dict | None = None,
         params: dict | None = None,
         idempotency_key: str | None = None,
-    ) -> dict:
+    ) -> Any:
         response = self._send(
             method,
             path,
@@ -338,7 +357,9 @@ class Invoice:
             body = response.json() if response.content else {}
         except ValueError:
             body = {}
-        return body.get("result", body)
+        if isinstance(body, dict):
+            return body.get("result", body)
+        return body
 
     def _send(
         self,