Batch update salary configs

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://restapi.wyzio.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Wyzio MCP server": {
    "url": "https://restapi.wyzio.com/mcp"
  }
}
Close
POST /api-v1/payslip/batch

Updates multiple salary configurations. Returns 200 on success, or 400 if any entry fails validation.

Headers

  • WEAL-TOKEN Required

    API token (can be retrieved from account settings)

  • TARGET-ORGANIZATION-ID

    ID of organization, for which the operation must be performed

application/json

Body Required

  • id integer

    Entity ID. If negative value, a new entity will be created

  • parentPayslipId integer

    Parent salary config ID

  • startDate string Required

    Start date (format dd/MM/yyyy)

  • endDate string Required

    End date (format dd/MM/yyyy)

  • calendarYear integer(int32) Required

    Calendar year

  • countryId integer Required

    Country ID

  • countryCode string

    ISO 3166-1 alpha-2 country code

  • isRegionAvailable boolean

    Whether a region is applicable for this config

  • type string Required

    Salary config type

    Values are COUNTRY, REGION, or CLA.

  • region object

    Region this config applies to

    Hide region attributes Show region attributes object
    • id integer(int64)
    • name string
    • code string
    • taxMode string

      Values are ANNUALLY or MONTHLY.

  • cla string

    CLA identifier

  • status string

    Payslip status

    Values are DRAFT or FINAL.

  • payslipLines array[object]

    Request model for a salary configuration line

    Hide payslipLines attributes Show payslipLines attributes object

    Request model for a salary configuration line

    • id integer

      Entity ID. If negative value, a new entity will be created

    • number integer Required

      Line number

    • localizations object Required

      Multilingual name (TranslationEntity with language fields)

      Hide localizations attributes Show localizations attributes object
      • id integer

        Entity ID. If negative value, a new entity will be created

      • en string
      • fr string
      • de string
      • it string
    • payslipLineType string Required

      Line type

      Values are EMPLOYEE_LINE, COMPANY_LINE, BOTH, CALCULATION, or SYSTEM.

    • payslipLineSign string Required

      Line sign

      Values are INCOME or CHARGES.

    • isShownOnSalarySlip boolean

      Whether the line is shown on the salary slip

    • isAutomaticallyAdded boolean

      Whether the line is automatically added from the template

    • isLinkedToAccount boolean

      Whether the line is linked to a chart of accounts

    • specialAttributionType string

      Special attribution type

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

    • payslipEntityId integer

      Payslip entity ID this line belongs to

    • systemLine object

      System line reference

      Hide systemLine attributes Show systemLine attributes object
      • id integer Required

        System line ID

      • payslipLineType string

        Payslip line type of the system line

        Values are EMPLOYEE_LINE, COMPANY_LINE, BOTH, CALCULATION, or SYSTEM.

      • systemAdjustmentLineNumber integer

        System adjustment line number

    • parentPayslipLines array[integer]

      IDs of parent payslip lines this line depends on

    • touched boolean

      Whether this line was touched/modified by user

    • shouldIncludeVat boolean

      Whether VAT should be included

    • isHourlyWageLine boolean

      Whether this is an hourly wage line

  • holidays array[object]

    Public holidays within the calendar year

    Hide holidays attributes Show holidays attributes object
    • id integer(int64)
    • date string(date-time) Required

      Date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z')

      Minimum length is 1.

    • name string Required

      Minimum length is 1.

  • payslipCertificateInsuranceInfoEntity object

    Certificate insurance information

    Hide payslipCertificateInsuranceInfoEntity attributes Show payslipCertificateInsuranceInfoEntity attributes object
    • id integer

      Entity ID. If negative value, a new entity will be created

    • salaryRent array[integer]

      Payslip line IDs

    • ancillaryWageBenefitsPensionHousing array[integer]

      Payslip line IDs

    • ancillaryWageBenefitsPrivateCarUse array[integer]

      Payslip line IDs

    • ancillaryWageBenefitsOther array[integer]

      Payslip line IDs

    • nonRecurringBenefits array[integer]

      Payslip line IDs

    • capitalBenefits array[integer]

      Payslip line IDs

    • participationFeeAccordingToAnnex array[integer]

      Payslip line IDs

    • allowancesOfTheMembersOfTheAdministration array[integer]

      Payslip line IDs

    • otherServices array[integer]

      Payslip line IDs

    • socialContributions array[integer]

      Payslip line IDs

    • occupationalBenefitsOrdinary array[integer]

      Payslip line IDs

    • occupationalBenefitsRePurchaseContributions array[integer]

      Payslip line IDs

    • directTaxAtSource array[integer]

      Payslip line IDs

    • costAllowancesTravelFoodLodging array[integer]

      Payslip line IDs

    • costAllowancesActualCosts array[integer]

      Payslip line IDs

    • costAllowancesFixedExpensesRepresentation array[integer]

      Payslip line IDs

    • costAllowancesFixedExpensesCar array[integer]

      Payslip line IDs

    • costAllowancesFixedExpensesOther array[integer]

      Payslip line IDs

    • developmentContributions array[integer]

      Payslip line IDs

    • avsSalary array[integer]

      Payslip line IDs

    • aciSalary array[integer]

      Payslip line IDs

    • aciiSalary array[integer]

      Payslip line IDs

    • laaSalary array[integer]

      Payslip line IDs

    • laacSalary array[integer]

      Payslip line IDs

    • laacExceesSalary array[integer]

      Payslip line IDs

    • apgSalary array[integer]

      Payslip line IDs

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
      • freshData

        Refreshed domain data

      • freshRow

        Refreshed table row data

      • possibleWorkflows array[object]
        Hide possibleWorkflows attributes Show possibleWorkflows attributes object
        • id integer(int64)
        • 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/payslip/batch 
curl \
 --request POST 'https://wyzio.app/api-v1/payslip/batch' \
 --header "Content-Type: application/json" \
 --data '[
  {
    "id": 12345678,
    "parentPayslipId": 12345678,
    "startDate": "01/01/2026",
    "endDate": "31/12/2026",
    "calendarYear": 2026,
    "countryId": 12345678,
    "countryCode": "CH",
    "isRegionAvailable": true,
    "type": "COMPANY",
    "region": {
      "id": 42,
      "name": "string",
      "code": "string",
      "taxMode": "ANNUALLY"
    },
    "cla": "CLA-001",
    "status": "ACTIVE",
    "payslipLines": [
      {
        "id": 12345678,
        "number": 100,
        "localizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "payslipLineType": "COMPANY_LINE",
        "payslipLineSign": "POSITIVE",
        "isShownOnSalarySlip": true,
        "isAutomaticallyAdded": false,
        "isLinkedToAccount": false,
        "specialAttributionType": "NONE",
        "payslipEntityId": 12345678,
        "systemLine": {
          "id": 12345678,
          "payslipLineType": "COMPANY_LINE",
          "systemAdjustmentLineNumber": 100
        },
        "parentPayslipLines": [
          42
        ],
        "touched": false,
        "shouldIncludeVat": false,
        "isHourlyWageLine": false
      }
    ],
    "holidays": [
      {
        "id": 42,
        "date": "2026-01-01T00:00:00.000Z",
        "name": "string"
      }
    ],
    "payslipCertificateInsuranceInfoEntity": {
      "id": 12345678,
      "salaryRent": [
        12345678
      ],
      "ancillaryWageBenefitsPensionHousing": [
        12345678
      ],
      "ancillaryWageBenefitsPrivateCarUse": [
        12345678
      ],
      "ancillaryWageBenefitsOther": [
        12345678
      ],
      "nonRecurringBenefits": [
        12345678
      ],
      "capitalBenefits": [
        12345678
      ],
      "participationFeeAccordingToAnnex": [
        12345678
      ],
      "allowancesOfTheMembersOfTheAdministration": [
        12345678
      ],
      "otherServices": [
        12345678
      ],
      "socialContributions": [
        12345678
      ],
      "occupationalBenefitsOrdinary": [
        12345678
      ],
      "occupationalBenefitsRePurchaseContributions": [
        12345678
      ],
      "directTaxAtSource": [
        12345678
      ],
      "costAllowancesTravelFoodLodging": [
        12345678
      ],
      "costAllowancesActualCosts": [
        12345678
      ],
      "costAllowancesFixedExpensesRepresentation": [
        12345678
      ],
      "costAllowancesFixedExpensesCar": [
        12345678
      ],
      "costAllowancesFixedExpensesOther": [
        12345678
      ],
      "developmentContributions": [
        12345678
      ],
      "avsSalary": [
        12345678
      ],
      "aciSalary": [
        12345678
      ],
      "aciiSalary": [
        12345678
      ],
      "laaSalary": [
        12345678
      ],
      "laacSalary": [
        12345678
      ],
      "laacExceesSalary": [
        12345678
      ],
      "apgSalary": [
        12345678
      ]
    }
  }
]'
Request examples 
# Headers

# Payload
[
  {
    "id": 12345678,
    "parentPayslipId": 12345678,
    "startDate": "01/01/2026",
    "endDate": "31/12/2026",
    "calendarYear": 2026,
    "countryId": 12345678,
    "countryCode": "CH",
    "isRegionAvailable": true,
    "type": "COMPANY",
    "region": {
      "id": 42,
      "name": "string",
      "code": "string",
      "taxMode": "ANNUALLY"
    },
    "cla": "CLA-001",
    "status": "ACTIVE",
    "payslipLines": [
      {
        "id": 12345678,
        "number": 100,
        "localizations": {
          "id": 12345678,
          "en": "English translation",
          "fr": "Traduction française",
          "de": "Deutsche Übersetzung",
          "it": "Traduzione in italiano"
        },
        "payslipLineType": "COMPANY_LINE",
        "payslipLineSign": "POSITIVE",
        "isShownOnSalarySlip": true,
        "isAutomaticallyAdded": false,
        "isLinkedToAccount": false,
        "specialAttributionType": "NONE",
        "payslipEntityId": 12345678,
        "systemLine": {
          "id": 12345678,
          "payslipLineType": "COMPANY_LINE",
          "systemAdjustmentLineNumber": 100
        },
        "parentPayslipLines": [
          42
        ],
        "touched": false,
        "shouldIncludeVat": false,
        "isHourlyWageLine": false
      }
    ],
    "holidays": [
      {
        "id": 42,
        "date": "2026-01-01T00:00:00.000Z",
        "name": "string"
      }
    ],
    "payslipCertificateInsuranceInfoEntity": {
      "id": 12345678,
      "salaryRent": [
        12345678
      ],
      "ancillaryWageBenefitsPensionHousing": [
        12345678
      ],
      "ancillaryWageBenefitsPrivateCarUse": [
        12345678
      ],
      "ancillaryWageBenefitsOther": [
        12345678
      ],
      "nonRecurringBenefits": [
        12345678
      ],
      "capitalBenefits": [
        12345678
      ],
      "participationFeeAccordingToAnnex": [
        12345678
      ],
      "allowancesOfTheMembersOfTheAdministration": [
        12345678
      ],
      "otherServices": [
        12345678
      ],
      "socialContributions": [
        12345678
      ],
      "occupationalBenefitsOrdinary": [
        12345678
      ],
      "occupationalBenefitsRePurchaseContributions": [
        12345678
      ],
      "directTaxAtSource": [
        12345678
      ],
      "costAllowancesTravelFoodLodging": [
        12345678
      ],
      "costAllowancesActualCosts": [
        12345678
      ],
      "costAllowancesFixedExpensesRepresentation": [
        12345678
      ],
      "costAllowancesFixedExpensesCar": [
        12345678
      ],
      "costAllowancesFixedExpensesOther": [
        12345678
      ],
      "developmentContributions": [
        12345678
      ],
      "avsSalary": [
        12345678
      ],
      "aciSalary": [
        12345678
      ],
      "aciiSalary": [
        12345678
      ],
      "laaSalary": [
        12345678
      ],
      "laacSalary": [
        12345678
      ],
      "laacExceesSalary": [
        12345678
      ],
      "apgSalary": [
        12345678
      ]
    }
  }
]
Response examples (200) 
{
  "items": [
    {
      "errorCode": {
        "errorCode": "NO_ERROR",
        "errorDetailValues": [
          {
            "errorCode": "string",
            "fieldName": "string",
            "data": "string",
            "isSevere": true
          }
        ]
      },
      "possibleWorkflows": [
        {
          "id": 42,
          "name": "string"
        }
      ],
      "error": true,
      "severeError": true
    }
  ]
}