stackin-python-sdk 0.1.1__tar.gz → 0.1.2__tar.gz

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackin-python-sdk
-Version: 0.1.1
+Version: 0.1.2
 Summary: Python SDK for issuing, consulting and cancelling electronic invoices.
 License-Expression: MIT
 License-File: LICENSE
@@ -104,5 +104,5 @@ Building the full fiscal document (issuer data, service code, tax groups, schema
 
 ## Examples
 
-Runnable end-to-end scripts in [`examples/`](examples/) — `simple_issue_nfe.py` and `simple_issue_nfse.py`, each with a catalog of realistic line items covering every optional field.
+Runnable end-to-end scripts in [`examples/nfe/`](examples/nfe/) and [`examples/nfse/`](examples/nfse/) — one file per field/variant, from the bare minimum to every field filled.
 

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/README.md

@@ -75,4 +75,4 @@ Building the full fiscal document (issuer data, service code, tax groups, schema
 
 ## Examples
 
-Runnable end-to-end scripts in [`examples/`](examples/) — `simple_issue_nfe.py` and `simple_issue_nfse.py`, each with a catalog of realistic line items covering every optional field.
+Runnable end-to-end scripts in [`examples/nfe/`](examples/nfe/) and [`examples/nfse/`](examples/nfse/) — one file per field/variant, from the bare minimum to every field filled.

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/pyproject.toml

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

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/stackin/__init__.py

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

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/stackin/br/__init__.py

@@ -10,6 +10,7 @@ from stackin.br.tax import (
     Icms60,
     IcmsSn101,
     IcmsSn102,
+    IcmsSn900,
     IcmsUfDest,
     Ipi,
     IpiNt,
@@ -29,6 +30,7 @@ __all__ = [
     "Icms60",
     "IcmsSn101",
     "IcmsSn102",
+    "IcmsSn900",
     "IcmsUfDest",
     "Ipi",
     "IpiTrib",

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/stackin/br/product.py

@@ -73,11 +73,36 @@ class Product(BaseModel):
     extra_groups: dict[str, Any] | None = Field(default=None)
     tax: Tax | dict[str, Any] | None = Field(default=None)
 
+    service_code: str | None = Field(
+        default=None, description="LC 116/2003 item.subitem, nfse only."
+    )
+    service_discount: float | None = Field(
+        default=None, description="Unconditional discount, nfse only."
+    )
+    tax_retained: bool = Field(
+        default=False, description="ISSQN retained by the tomador, nfse only."
+    )
+    observations: str | None = Field(
+        default=None, max_length=2000, description="nfse only."
+    )
+
     def to_dict(self) -> dict:
         """Returns the item as a plain dict, ready for the request body."""
+        _NFSE_FIELDS = {
+            "service_code",
+            "service_discount",
+            "tax_retained",
+            "observations",
+        }
         data = self.model_dump(
             exclude_none=True,
-            exclude={"description", "amount", "tax", *_BR_FIELDS},
+            exclude={
+                "description",
+                "amount",
+                "tax",
+                *_BR_FIELDS,
+                *_NFSE_FIELDS,
+            },
         )
         br = self.model_dump(exclude_none=True, include=_BR_FIELDS - {"tax"})
         if isinstance(self.tax, Tax):
@@ -90,4 +115,8 @@ class Product(BaseModel):
             "description": self.description,
             "amount": self.amount,
             "product": data,
+            "service_code": self.service_code,
+            "discount": self.service_discount,
+            "tax_retained": self.tax_retained,
+            "observations": self.observations,
         }

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/stackin/br/tax.py

@@ -77,6 +77,19 @@ class IcmsSn102(BaseModel):
     csosn: str = Field(alias="CSOSN")
 
 
+class IcmsSn900(BaseModel):
+    """Simples Nacional ICMS, other cases (used with interstate partilha)."""
+
+    model_config = _CONFIG
+
+    orig: str | None = None
+    csosn: str = Field(default="900", alias="CSOSN")
+    mod_bc: str | None = Field(default=None, alias="modBC")
+    v_bc: str | None = Field(default=None, alias="vBC")
+    p_icms: str | None = Field(default=None, alias="pICMS")
+    v_icms: str | None = Field(default=None, alias="vICMS")
+
+
 class IcmsUfDest(BaseModel):
     """Interstate ICMS share owed to the destination state."""
 
@@ -193,7 +206,15 @@ class CofinsOutr(BaseModel):
     v_cofins: str = Field(alias="vCOFINS")
 
 
-IcmsGroup = Icms00 | Icms40 | Icms60 | IcmsSn101 | IcmsSn102 | dict[str, Any]
+IcmsGroup = (
+    Icms00
+    | Icms40
+    | Icms60
+    | IcmsSn101
+    | IcmsSn102
+    | IcmsSn900
+    | dict[str, Any]
+)
 PisGroup = PisAliq | PisNt | PisOutr | dict[str, Any]
 CofinsGroup = CofinsAliq | CofinsNt | CofinsOutr | dict[str, Any]
 
@@ -203,6 +224,7 @@ _ICMS_TAGS = {
     Icms60: "ICMS60",
     IcmsSn101: "ICMSSN101",
     IcmsSn102: "ICMSSN102",
+    IcmsSn900: "ICMSSN900",
 }
 _PIS_TAGS = {PisAliq: "PISAliq", PisNt: "PISNT", PisOutr: "PISOutr"}
 _COFINS_TAGS = {

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/stackin/core/client.py

@@ -23,9 +23,7 @@ _ENVIRONMENT_URLS = {
 def _resolve_base_url(
     base_url: str | None, environment: Environment | str | None
 ) -> str:
-    """Resolution order, same shape as the AWS CLI: explicit param,
-    then env var, then the environment's default — `base_url` always
-    wins over `environment` at each step."""
+    """Resolution order: explicit param, then env var, then environment's default."""
     if base_url:
         return base_url
     if url := os.environ.get("STACKIN_BASE_URL"):
@@ -61,6 +59,8 @@ class Invoice:
         tax_id: str,
         items: list[Product],
         recipient_address: Address | None = None,
+        series: str | None = None,
+        number: str | None = None,
     ) -> dict:
         """Issues a fiscal document."""
         if not items:
@@ -81,8 +81,12 @@ class Invoice:
             "tax_id": tax_id,
             "items": [item.to_dict() for item in items],
         }
-        if recipient_address and recipient_address.state:
-            payload["recipient_state"] = recipient_address.state
+        if recipient_address:
+            payload["recipient_address"] = recipient_address.to_dict()
+        if series:
+            payload["series"] = series
+        if number:
+            payload["number"] = number
 
         return self._request("POST", "/invoices", json=payload)
 

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/stackin/core/exceptions.py

@@ -15,5 +15,4 @@ class APIError(InvoiceError):
 
 
 class ConnectionFailedError(InvoiceError):
-    """Raised when the invoice API can't be reached at all
-    (network/DNS/timeout)."""
+    """Raised when the invoice API can't be reached at all (network/DNS/timeout)."""

{stackin_python_sdk-0.1.1 → stackin_python_sdk-0.1.2}/stackin/core/types.py

@@ -13,10 +13,7 @@ class DocumentType(str, Enum):
 
 
 class Environment(str, Enum):
-    """Which host to talk to — pass to `Invoice(environment=...)`
-    instead of a raw `base_url`. `TEST` and `PRODUCTION` resolve to the
-    same host: homologation vs. production invoicing is a per-company
-    setting on the platform side, not a different SDK host."""
+    """Which host to talk to — pass to `Invoice(environment=...)` instead of a raw `base_url`."""
 
     LOCAL = "local"
     TEST = "test"