stackin-python-sdk 0.4.0__tar.gz → 0.6.0__tar.gz

{stackin_python_sdk-0.4.0 → stackin_python_sdk-0.6.0}/PKG-INFO

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

{stackin_python_sdk-0.4.0 → stackin_python_sdk-0.6.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stackin-python-sdk"
-version = "0.4.0"
+version = "0.6.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.4.0"
+version = "0.6.0"
 description = "Python SDK for issuing, consulting and cancelling electronic invoices."
 authors = ["Fernando Celmer <email@fernandocelmer.com>"]
 readme = "README.md"

{stackin_python_sdk-0.4.0 → stackin_python_sdk-0.6.0}/stackin/__init__.py

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

{stackin_python_sdk-0.4.0 → stackin_python_sdk-0.6.0}/stackin/core/client.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import os
+from typing import Any
 
 import requests
 
@@ -244,6 +245,45 @@ class Invoice:
 
         return self._request("GET", "/received-invoices", params=params)
 
+    def history(
+        self,
+        *,
+        document_type: DocumentType | None = None,
+        status: str | None = None,
+        limit: int | None = None,
+        offset: int | None = None,
+        sort_by: str | None = None,
+        order_by: str | None = None,
+    ) -> dict:
+        """This company's own issuance history, newest first.
+
+        The counterpart of received(): that one lists what was issued
+        against the company, this one what the company issued.
+        """
+        params: dict[str, object] = {}
+        if document_type is not None:
+            params["document_type"] = document_type.value
+        if status is not None:
+            params["status"] = status
+        if limit is not None:
+            params["limit"] = limit
+        if offset is not None:
+            params["offset"] = offset
+        if sort_by is not None:
+            params["sort_by"] = sort_by
+        if order_by is not None:
+            params["order_by"] = order_by
+
+        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,
@@ -295,7 +335,7 @@ class Invoice:
         json: dict | None = None,
         params: dict | None = None,
         idempotency_key: str | None = None,
-    ) -> dict:
+    ) -> Any:
         response = self._send(
             method,
             path,
@@ -307,7 +347,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,