Batch update payroll payments

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/payroll/batch/payments

Updates multiple payroll payments. 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

  • payrollEntityId integer

    Payroll entity ID this payment belongs to

  • requestedDate string Required

    Requested payment date (format dd/MM/yyyy)

  • plannedDate string

    Planned payment date (format dd/MM/yyyy)

  • sentDate string

    Date the payment was sent (format dd/MM/yyyy)

  • valueDate string

    Value date of the payment (format dd/MM/yyyy)

  • requestedAmount string

    Requested amount as string

  • paidAmount string

    Paid amount as string

  • bankCharges string

    Bank charges as string

  • payableByAccountId integer Required

    Chart of accounts ID used as the payable-by account

  • payableToBankId integer

    Bank ID to pay to

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/payroll/batch/payments 
curl \
 --request POST 'https://wyzio.app/api-v1/payroll/batch/payments' \
 --header "Content-Type: application/json" \
 --data '[{"id":12345678,"payrollEntityId":12345678,"requestedDate":"01/06/2026","plannedDate":"05/06/2026","sentDate":"05/06/2026","valueDate":"05/06/2026","requestedAmount":3500.0,"paidAmount":3500.0,"bankCharges":5.0,"payableByAccountId":12345678,"payableToBankId":12345678}]'
Request examples 
# Headers

# Payload
[
  {
    "id": 12345678,
    "payrollEntityId": 12345678,
    "requestedDate": "01/06/2026",
    "plannedDate": "05/06/2026",
    "sentDate": "05/06/2026",
    "valueDate": "05/06/2026",
    "requestedAmount": 3500.0,
    "paidAmount": 3500.0,
    "bankCharges": 5.0,
    "payableByAccountId": 12345678,
    "payableToBankId": 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
    }
  ]
}