stackin-python-sdk 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

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/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/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/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/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/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/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"

{stackin_python_sdk-0.1.1.dist-info → stackin_python_sdk-0.1.2.dist-info}/METADATA

@@ -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.2.dist-info/RECORD

@@ -0,0 +1,13 @@
+stackin/__init__.py,sha256=zY-ivw5Pckpw-tXwUmn4hwJzU4TZ6MJrW8RLEpPDG_c,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=abXZ71nz-skXM2afUOFNwY1j0_zlJRssihOQT4hwrXg,4591
+stackin/core/exceptions.py,sha256=enl8GS_WlDV6PyH1M_KTxzLG9Qdr-9MJrMXB_AlCtYg,521
+stackin/core/types.py,sha256=SYpLS2EnqKcudm7wFwCTOVAQe1IYT5T0TGSD0E6z8bo,416
+stackin_python_sdk-0.1.2.dist-info/METADATA,sha256=PRoF8vxBg3HZFqW3exHsmqeYT6JNLUuTnElpnyUJhwQ,5200
+stackin_python_sdk-0.1.2.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+stackin_python_sdk-0.1.2.dist-info/licenses/LICENSE,sha256=D-XHDcKFFhzEo9C5Dp4QPvt00pb_u__hi4Bc08zpxyU,1072
+stackin_python_sdk-0.1.2.dist-info/RECORD,,

stackin_python_sdk-0.1.1.dist-info/RECORD

@@ -1,13 +0,0 @@
-stackin/__init__.py,sha256=aRGcx1scidLojq96GQ5z9GwM9fsB1rI0XqTGwyRKJd0,495
-stackin/br/__init__.py,sha256=6XSFt3fa9zxY2ToZ_BY3b1zjsFaeJpkNBuPwNtp2SQE,624
-stackin/br/product.py,sha256=OgImk2y31zrGJ4q6vVcULQjH92w6Z1yOUos7mGLR7IU,3091
-stackin/br/tax.py,sha256=MX1cUy06lwOsPj1czGhBh0qkDb0zmwpwuh6xfcA0lQY,7190
-stackin/core/__init__.py,sha256=dxtOP1DopMSNFYGh3Hf12RVcs58R9xwLn-gqfKFo-HE,19
-stackin/core/address.py,sha256=-w5R3nzfU5T3VoxIeygu5Dq4DRb_lJHAGc0lmSMwEMU,616
-stackin/core/client.py,sha256=PRQILpsFjmU-2U1YwR-i8BhAFxCMRyc_tLucFXDEbgI,4525
-stackin/core/exceptions.py,sha256=DaSktECbcddGEkHyTBRN_w1S8dRzv8bRY1pHQoly6X0,525
-stackin/core/types.py,sha256=10Ygq-CS8CHDzA4pJPqujUTvv2cx1-LUdf_V-_oh_-8,589
-stackin_python_sdk-0.1.1.dist-info/METADATA,sha256=AfNLYLHka9HId5K0hTvefdaNzI8Wsez9yy_1iDzLFtU,5205
-stackin_python_sdk-0.1.1.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
-stackin_python_sdk-0.1.1.dist-info/licenses/LICENSE,sha256=D-XHDcKFFhzEo9C5Dp4QPvt00pb_u__hi4Bc08zpxyU,1072
-stackin_python_sdk-0.1.1.dist-info/RECORD,,