Generic REST integration¶
Any system that can make an HTTPS request can fiscalize through Tax-Bridge.
Steps¶
- Create an API key and a shop in the console.
- Map your source document to the canonical invoice.
POST /v1/fiscalize, then poll or receive a webhook.
Example¶
import requests
resp = requests.post(
"https://api.tax-bridge.cloud/v1/fiscalize",
headers={"Authorization": "Bearer tbk_live_…"},
json={
"shop_id": "shp_123",
"external_ref": "SO-1042",
"invoice_type": "NORMAL",
"transaction_type": "SALE",
"items": [{"name": "Kava 500g", "quantity": 1,
"unit_price_incl": 1725.00, "total_incl": 1725.00,
"tax_labels": ["D"]}],
"payments": [{"type": "CASH", "amount": 1725.00}],
},
timeout=30,
)
print(resp.json()["request_id"])
Tooling¶
- OpenAPI spec:
/openapi.json - Postman collection and client SDKs (Python · Node · PHP) are generated from the spec — see the API Reference.