Payroll Results Payslip Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/workday-payroll/refs/heads/main/json-structure/payroll-results-payslip-structure.json",
  "name": "Payslip",
  "description": "Payslip schema from Workday Payroll Results API",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the payslip",
      "example": "ps_w100542_20260430"
    },
    "worker": {
      "$ref": "#/$defs/WorkerRef"
    },
    "payPeriod": {
      "$ref": "#/$defs/PayPeriod"
    },
    "paymentDate": {
      "type": "date",
      "description": "Date of payment",
      "example": "2026-04-30"
    },
    "grossPay": {
      "type": "double",
      "description": "Total gross pay",
      "example": 1.0
    },
    "netPay": {
      "type": "double",
      "description": "Total net pay",
      "example": 1.0
    },
    "totalEarnings": {
      "type": "double",
      "description": "Sum of all earnings",
      "example": 5240.0
    },
    "totalDeductions": {
      "type": "double",
      "description": "Sum of all deductions",
      "example": 38210.8
    },
    "totalTaxes": {
      "type": "double",
      "description": "Sum of all tax withholdings",
      "example": 29167.4
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code",
      "example": "USD"
    },
    "earnings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/PayslipEarningLine"
      },
      "description": "Itemized earnings"
    },
    "deductions": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/PayslipDeductionLine"
      },
      "description": "Itemized deductions"
    },
    "taxes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/PayslipTaxLine"
      },
      "description": "Itemized tax withholdings"
    },
    "yearToDateGross": {
      "type": "double",
      "description": "Year-to-date gross pay",
      "example": 42850.0
    },
    "yearToDateNet": {
      "type": "double",
      "description": "Year-to-date net pay",
      "example": 31420.65
    },
    "yearToDateTaxes": {
      "type": "double",
      "description": "Year-to-date tax withholdings",
      "example": 8742.5
    }
  },
  "definitions": {
    "PayPeriod": {
      "name": "PayPeriod",
      "type": "object",
      "properties": {
        "startDate": {
          "type": "date",
          "description": "Start date of the pay period",
          "example": "2026-04-30"
        },
        "endDate": {
          "type": "date",
          "description": "End date of the pay period",
          "example": "2026-04-30"
        }
      }
    },
    "WorkerRef": {
      "name": "WorkerRef",
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Worker identifier",
          "example": "w_100542"
        },
        "descriptor": {
          "type": "string",
          "description": "Worker display name",
          "example": "Weekly USD Pay Group"
        }
      }
    },
    "PayslipDeductionLine": {
      "name": "PayslipDeductionLine",
      "type": "object",
      "properties": {
        "deductionCode": {
          "type": "string",
          "description": "Deduction code descriptor",
          "example": "MEDICAL_PRETAX"
        },
        "employeeAmount": {
          "type": "double",
          "description": "Employee contribution amount",
          "example": 287.5
        },
        "employerAmount": {
          "type": "double",
          "description": "Employer contribution amount",
          "example": 287.5
        },
        "preTax": {
          "type": "boolean",
          "description": "Whether this deduction is pre-tax",
          "example": true
        },
        "yearToDateEmployee": {
          "type": "double",
          "description": "Year-to-date employee amount",
          "example": 8742.5
        },
        "yearToDateEmployer": {
          "type": "double",
          "description": "Year-to-date employer amount",
          "example": 8742.5
        }
      }
    },
    "PayslipEarningLine": {
      "name": "PayslipEarningLine",
      "type": "object",
      "properties": {
        "earningCode": {
          "type": "string",
          "description": "Earning code descriptor",
          "example": "REGULAR"
        },
        "currentAmount": {
          "type": "double",
          "description": "Current period amount",
          "example": 2840.0
        },
        "currentHours": {
          "type": "double",
          "description": "Current period hours",
          "example": 40.0
        },
        "rate": {
          "type": "double",
          "description": "Pay rate",
          "example": 32.5
        },
        "yearToDateAmount": {
          "type": "double",
          "description": "Year-to-date amount for this earning",
          "example": 8742.5
        }
      }
    },
    "PayslipTaxLine": {
      "name": "PayslipTaxLine",
      "type": "object",
      "properties": {
        "taxAuthority": {
          "type": "string",
          "description": "Tax authority name",
          "example": "Internal Revenue Service"
        },
        "taxType": {
          "type": "string",
          "description": "Type of tax",
          "example": "FederalIncome"
        },
        "currentAmount": {
          "type": "double",
          "description": "Current period tax amount",
          "example": 2840.0
        },
        "yearToDateAmount": {
          "type": "double",
          "description": "Year-to-date tax amount",
          "example": 8742.5
        }
      }
    }
  }
}