---
title: "Server Scripts"
space: "Frappe Framework"
url: "https://www.prilk.com/nl/docs/frappe-framework/server-scripts"
updated: "2026-05-14"
---

## Server Scripts

Een Server Script draait Python op de server bij een documentgebeurtenis. Zelfde doel als Client Scripts maar met volledige DB-toegang en vertrouwde uitvoering — voor security-kritische validatie, side-effects en achtergrondwerk.

### Aanmaken
**Customize → Server Script → New**:

| Script Type | Wanneer |
|---|---|
| **DocType Event** | Bij een documentlifecycle (validate, before_save, on_submit, on_cancel, on_trash) |
| **API Method** | Beschikbaar op `/api/method/<uw.pad>` voor externe callers |
| **Scheduler Event** | Op een cron-schema (uurlijks, dagelijks, custom) |
| **Permission Query** | Retourneert een SQL-fragment om lijstweergaven te filteren |

### DocType-event voorbeeld

```python
# Triggert op validate van Verkoopfactuur
if doc.grand_total > 100000 and not doc.approved_by_manager:
    frappe.throw(_("Facturen boven 100k vereisen managergoedkeuring"))

if doc.customer:
    customer = frappe.get_doc("Customer", doc.customer)
    outstanding = customer.outstanding or 0
    if customer.credit_limit and (doc.grand_total + outstanding) > customer.credit_limit:
        frappe.throw(_("Klant boven kredietlimiet"))
```

`doc` is het huidige document; `frappe` is de frameworkmodule; `_()` vertaalt strings.

### Scheduler-voorbeeld

```python
# Dagelijks: notificeer boekhouding bij vervallen facturen
overdue = frappe.get_all("Sales Invoice", filters={
    "due_date": ["<", frappe.utils.nowdate()],
    "outstanding_amount": [">", 0],
    "docstatus": 1
})
if overdue:
    frappe.sendmail(
        recipients=["accounts@example.com"],
        subject=f"{len(overdue)} vervallen facturen",
        message="<br>".join(i.name for i in overdue)
    )
```

### API-method voorbeeld

```python
# Aanroepen op /api/method/<uw.pad> — args uit request payload
return {"ok": True, "result": frappe.utils.flt(amount) * 1.21}
```

### Sandbox
Server Scripts draaien in een Python-sandbox: geen `import` van willekeurige modules, geen schrijven naar bestandssysteem, geen subprocess. Voor onbeperkt Python of externe dependencies: maak een Frappe-app — zie [Ontwikkelaars](/nl/docs/frappe-ecosystem/ontwikkelaars).