Cost to employ

Cost to employ: every statutory contribution priced line by line, employee and employer sides separated, with the schemes we will not price named and reasoned

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://euroref.dev/v1/answers/employment-cost

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "country": "de",
    "gross": 5000,
    "period": "month"
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "childless_over_23": {
              "description": "Germany: adds the 0.6-point long-term-care surcharge, borne by the employee alone",
              "type": "boolean"
            },
            "children_under_25": {
              "description": "Germany: reduces the employee care rate by 0.25 points for the second through fifth child under 25",
              "type": "number"
            },
            "contract": {
              "description": "Selects the right unemployment rate (ES) and the fixed-term surcharge (IT)",
              "enum": [
                "indefinite",
                "fixed_term"
              ],
              "type": "string"
            },
            "country": {
              "description": "ISO country code carrying a costed contribution schedule",
              "enum": [
                "de",
                "es",
                "gb",
                "it",
                "pl"
              ],
              "type": "string"
            },
            "gross": {
              "description": "Gross pay in local currency",
              "type": "number"
            },
            "nationality": {
              "description": "Required in the Gulf: GPSSA pension reaches UAE and GCC nationals only \u2014 an expatriate has no pension deduction at all",
              "enum": [
                "national",
                "gcc",
                "expat"
              ],
              "type": "string"
            },
            "period": {
              "description": "Period the gross covers (default month)",
              "enum": [
                "month",
                "year"
              ],
              "type": "string"
            },
            "receipt": {
              "description": "Optional. true adds an Ed25519 answer receipt on a paid 200, incluedd in this price. Not a certified extract.",
              "type": "boolean"
            },
            "subdivision": {
              "description": "ISO 3166-2 code where a region runs its own schedule rather than the national one \u2014 CA-QC swaps CPP/EI for QPP/QPIP, JP prefectures set their own health rate, NO zones set the employer rate. Regions held on this service: DE DE-SN. Bare and lower-case forms are accepted ('SN' and 'de-sn' both mean DE-SN). A code we do not serve is REFUSED free, with the list \u2014 we never answer a regional question with national figures.",
              "type": "string"
            },
            "workplace_pension": {
              "description": "Auto-enrolment participation (GB) / PPK (PL). Both are opt-out, so default true",
              "type": "boolean"
            },
            "zusatzbeitrag_rate": {
              "description": "Germany: the employee's own sickness fund supplement. There is no national rate; without it the health figure is incomplete",
              "type": "number"
            }
          },
          "required": [
            "country",
            "gross"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "employee": {
              "description": "Employee-side lines and total \u2014 what leaves the payslip",
              "type": "object"
            },
            "employer": {
              "description": "Employer-side lines and total \u2014 cost of employment, not a deduction",
              "type": "object"
            },
            "employer_cost": {
              "description": "Gross plus employer contributions",
              "type": "number"
            },
            "receipt": {
              "description": "Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key.",
              "type": "object"
            },
            "refused": {
              "description": "Every scheme that could NOT be priced, each with the reason. These are unknown, not zero",
              "type": "array"
            },
            "status": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "employee",
            "employer",
            "employer_cost",
            "refused"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON