POST /api-v1/payroll/batch

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

  • 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

Responses

  • 200 application/json

    OK

    Hide response attribute Show response attribute object
    • items array[object]
      Hide items attributes Show items attributes object
      • errorCode object
        Hide errorCode attributes Show errorCode attributes object
        • errorCode string

          Values are NO_ERROR, NOT_IMPLEMENTED_YET, CONTACT_NOT_FOUND, FIELD_REQUIRED, VALIDATION_ERROR, DUPLICATION_ERROR, UNIQUE_CONSTRAINT_VIOLATION, WRONG_PASSWORD_FORMAT, WRONG_PASSWORD, ACTION_DENIED, NOT_FOUND, EXPECTED_ONE_FILE, UNIQUE_VIOLATION, CONTENT_EMPTY, INVALID_TYPE, CONVERSION_ERROR, FILE_PARSE_EXCEPTION, or IN_USE.

        • errorDetailValues array[object]
          Hide errorDetailValues attributes Show errorDetailValues attributes object
          • errorCode string
          • fieldName string
          • data string
          • isSevere boolean
      • freshRow object
      • freshData object
      • possibleWorkflows array[object]
        Hide possibleWorkflows attributes Show possibleWorkflows attributes object
        • id integer
        • name string
      • error boolean
      • severeError 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/batch 
curl \
 --request POST 'https://wyzio.app/api-v1/payroll/batch' \
 --header "Content-Type: application/json" \
 --header "WEAL-TOKEN: string" \
 --header "TARGET-ORGANIZATION-ID: 42" \
 --data '[{"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}]'
Request examples 
# Headers
WEAL-TOKEN: string
TARGET-ORGANIZATION-ID: 42

# Payload
[
  {
    "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
  }
]
Response examples (200) 
{
  "items": [
    {
      "errorCode": {
        "errorCode": "NO_ERROR",
        "errorDetailValues": [
          {
            "errorCode": "string",
            "fieldName": "string",
            "data": "string",
            "isSevere": true
          }
        ]
      },
      "freshRow": {},
      "freshData": {},
      "possibleWorkflows": [
        {
          "id": 42,
          "name": "string"
        }
      ],
      "error": true,
      "severeError": true
    }
  ]
}