Skip to content

Generic REST integration

Any system that can make an HTTPS request can fiscalize through Tax-Bridge.

Steps

  1. Create an API key and a shop in the console.
  2. Map your source document to the canonical invoice.
  3. 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.