fill_docx.py

"""
Bytedoc — Fill a DOCX template

Replaces {placeholder} tags in a DOCX template with provided data.
Requires: pip install requests
"""

import os

import requests

API_KEY = os.environ["BYTEDOC_API_KEY"]
BASE_URL = "https://api.bytedoc.dev/v1"


def fill_docx(
    template_id: str,
    data: dict,
    filename: str | None = None,
) -> dict:
    """Fill a DOCX template and return the document metadata."""
    response = requests.post(
        f"{BASE_URL}/documents/fill-docx",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "template_id": template_id,
            "data": data,
            "options": {
                "filename": filename,
            },
        },
    )

    if not response.ok:
        error = response.json()
        raise RuntimeError(
            f"Bytedoc error ({response.status_code}): {error['error']['message']}"
        )

    return response.json()


# ---------------------------------------------------------------------------
# Usage — Fill a contract template
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    result = fill_docx(
        template_id="tpl_docx789",
        data={
            "client_name": "Jane Smith",
            "contract_date": "2026-03-01",
            "contract_value": "15,000",
            "payment_terms": "Net 30",
            "company_name": "Acme Corp",
        },
        filename="contract-jane-smith.docx",
    )

    print(f"Document ID : {result['id']}")
    print(f"Download URL: {result['download_url']}")
    print(f"Expires at  : {result['expires_at']}")