POST /api-v1/payroll/generate

Headers

  • WEAL-TOKEN string Required

    API token (can be retrieved from account settings)

  • TARGET-ORGANIZATION-ID integer

    ID of organization, for which the operation must be performed

application/json

Body Required

  • calendarYear integer(int32)
  • monthType string

    Values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, or DECEMBER.

  • monthStartDate string(date-time)
  • monthEndDate string(date-time)
  • date string
  • employees array[object]
    Hide employees attributes Show employees attributes object
    • id integer
    • staffId integer
    • currencyId integer
    • staffAccountId integer
    • staffPayslipId integer
    • organizationAccountId integer
    • genderType string

      Values are MALE, FEMALE, or OTHER.

    • salaryType string

      Values are MONTHLY or HOURLY.

    • birthday string
    • payableToBankId integer
    • hourlySalaryType boolean

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • id integer
    • organizationId integer
    • createdOn string Required
    • paymentDate string Required
    • calendarYear integer(int32)
    • monthType string

      Values are JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, or DECEMBER.

    • monthStartDate string(date-time)
    • monthEndDate string(date-time)
    • staffEntityId integer
    • contactEntityId integer
    • currencyId integer
    • employeeInfoId integer
    • address object
      Hide address attributes Show address attributes object
      • id integer
      • name string Required
      • line1 string
      • line2 string
      • city string
      • region object
        Hide region attributes Show region attributes object
        • id integer
        • name string
        • code string
        • taxMode string

          Values are ANNUALLY or MONTHLY.

      • countryCode2 string
      • postCode string
      • toTheAttentionOf string
      • position integer(int32)
      • houseNumber string
      • countryId integer Required
      • service string
      • readOnly boolean
    • grossSalary string
    • netSalary string
    • payable string
    • description string
    • status string

      Values are UNPAID, PAID, PARTIALLY_PAID, or WIRED.

    • warnings string
    • isDeleted boolean
    • payrollLines array[object]
      Hide payrollLines attributes Show payrollLines attributes object
      • id integer
      • payrollEntityId integer
      • payslipLineEntityId integer
      • number integer
      • localizations object
        Hide localizations attributes Show localizations attributes object
        • id integer
        • en string
        • fr string
        • de string
        • it string
      • payslipValueType string

        Values are VALUE or PERCENTAGE.

      • isAutomaticallyAdded boolean
      • payslipLineType string

        Values are EMPLOYEE_LINE, COMPANY_LINE, CALCULATION, or SYSTEM.

      • description string
      • baseAmount string
      • employeeRate string
      • employerRate string
      • employeeAmount string
      • employerAmount string
      • specialAttributionType string

        Values are BASE_SALARY, GROSS_SALARY, NET_SALARY, PAYABLE, CHARGES, EMPLOYEE_ALLOCATION, or SYSTEM_LINE_ADJUSTMENT.

      • isChanged boolean
      • isShownOnSalarySlip boolean
    • payrollPayments array[object]
      Hide payrollPayments attributes Show payrollPayments attributes object
      • id integer
      • payrollEntityId integer
      • requestedDate string Required
      • plannedDate string
      • sentDate string
      • valueDate string
      • requestedAmount string
      • paidAmount string
      • bankCharges string
      • payableByAccountId integer Required
      • payableToBankId integer
      • isFromLockedAccountingPeriod boolean
    • journalEntryId integer
    • staffPayslipId integer
    • removedPayrollLineNumbers array[integer]
    • isFromLockedAccountingPeriod boolean
    • organizationEmployeeGroupId integer
    • isDocSent boolean
  • 400

    400 Bad Request

  • 401

    401 Unauthorized

  • 403

    403 Access Denied

  • 404

    404 Not Found

  • 500

    500 Internal Server Error

POST /api-v1/payroll/generate
curl \
 --request POST 'https://wyzio.app/api-v1/payroll/generate' \
 --header "Content-Type: application/json" \
 --header "WEAL-TOKEN: string" \
 --header "TARGET-ORGANIZATION-ID: 42" \
 --data '{"calendarYear":42,"monthType":"JANUARY","monthStartDate":"2026-05-04T09:42:00Z","monthEndDate":"2026-05-04T09:42:00Z","date":"string","employees":[{"id":42,"staffId":42,"currencyId":42,"staffAccountId":42,"staffPayslipId":42,"organizationAccountId":42,"genderType":"MALE","salaryType":"MONTHLY","birthday":"string","payableToBankId":42,"hourlySalaryType":true}]}'
Request examples
# Headers
WEAL-TOKEN: string
TARGET-ORGANIZATION-ID: 42

# Payload
{
  "calendarYear": 42,
  "monthType": "JANUARY",
  "monthStartDate": "2026-05-04T09:42:00Z",
  "monthEndDate": "2026-05-04T09:42:00Z",
  "date": "string",
  "employees": [
    {
      "id": 42,
      "staffId": 42,
      "currencyId": 42,
      "staffAccountId": 42,
      "staffPayslipId": 42,
      "organizationAccountId": 42,
      "genderType": "MALE",
      "salaryType": "MONTHLY",
      "birthday": "string",
      "payableToBankId": 42,
      "hourlySalaryType": true
    }
  ]
}
Response examples (200)
[
  {
    "id": 42,
    "organizationId": 42,
    "createdOn": "string",
    "paymentDate": "string",
    "calendarYear": 42,
    "monthType": "JANUARY",
    "monthStartDate": "2026-05-04T09:42:00Z",
    "monthEndDate": "2026-05-04T09:42:00Z",
    "staffEntityId": 42,
    "contactEntityId": 42,
    "currencyId": 42,
    "employeeInfoId": 42,
    "address": {
      "id": 42,
      "name": "string",
      "line1": "string",
      "line2": "string",
      "city": "string",
      "region": {
        "id": 42,
        "name": "string",
        "code": "string",
        "taxMode": "ANNUALLY"
      },
      "countryCode2": "string",
      "postCode": "string",
      "toTheAttentionOf": "string",
      "position": 42,
      "houseNumber": "string",
      "countryId": 42,
      "service": "string",
      "readOnly": true
    },
    "grossSalary": "string",
    "netSalary": "string",
    "payable": "string",
    "description": "string",
    "status": "UNPAID",
    "warnings": "string",
    "isDeleted": true,
    "payrollLines": [
      {
        "id": 42,
        "payrollEntityId": 42,
        "payslipLineEntityId": 42,
        "number": 42,
        "localizations": {
          "id": 42,
          "en": "string",
          "fr": "string",
          "de": "string",
          "it": "string"
        },
        "payslipValueType": "VALUE",
        "isAutomaticallyAdded": true,
        "payslipLineType": "EMPLOYEE_LINE",
        "description": "string",
        "baseAmount": "string",
        "employeeRate": "string",
        "employerRate": "string",
        "employeeAmount": "string",
        "employerAmount": "string",
        "specialAttributionType": "BASE_SALARY",
        "isChanged": true,
        "isShownOnSalarySlip": true
      }
    ],
    "payrollPayments": [
      {
        "id": 42,
        "payrollEntityId": 42,
        "requestedDate": "string",
        "plannedDate": "string",
        "sentDate": "string",
        "valueDate": "string",
        "requestedAmount": "string",
        "paidAmount": "string",
        "bankCharges": "string",
        "payableByAccountId": 42,
        "payableToBankId": 42,
        "isFromLockedAccountingPeriod": true
      }
    ],
    "journalEntryId": 42,
    "staffPayslipId": 42,
    "removedPayrollLineNumbers": [
      42
    ],
    "isFromLockedAccountingPeriod": true,
    "organizationEmployeeGroupId": 42,
    "isDocSent": true
  }
]