> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intermezzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Take Over Absence Calculation

> Take over the calculation of the absence's pay: from now on the partner pays it
and the engine writes nothing more for it, corrections to periods it already paid
included. One way: an absence calculated by the partner never returns to the engine.



## OpenAPI

````yaml /api-reference/preview.json post /organizations/{organization_id}/employees/{employee_id}/absences/{absence_id}/lifecycle/take-over-calculation
openapi: 3.2.0
info:
  description: Intermezzo's global payroll apis, organized by country
  summary: Global Payroll Platform
  title: Intermezzo Global Payroll
  version: '2026-11-18'
  x-logo:
    url: /static/icon.svg
servers:
  - description: Preview
    url: https://preview.intermezzo.ai
security: []
paths:
  /organizations/{organization_id}/employees/{employee_id}/absences/{absence_id}/lifecycle/take-over-calculation:
    post:
      tags:
        - Core
        - Employees
        - Absences
      summary: Take Over Absence Calculation
      description: >-
        Take over the calculation of the absence's pay: from now on the partner
        pays it

        and the engine writes nothing more for it, corrections to periods it
        already paid

        included. One way: an absence calculated by the partner never returns to
        the engine.
      operationId: >-
        take_over_absence_calculation_organizations__organization_id__employees__employee_id__absences__absence_id__lifecycle_take_over_calculation_post
      parameters:
        - in: path
          name: organization_id
          required: true
          schema:
            title: Organization Id
            type: string
        - in: path
          name: employee_id
          required: true
          schema:
            title: Employee Id
            type: string
        - in: path
          name: absence_id
          required: true
          schema:
            title: Absence Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GBAbsenceResponse'
          description: Successful Response
        '403':
          content:
            application/json:
              examples:
                EMPLOYEE_ACCESS_DENIED:
                  summary: >-
                    Raised when an employee does not belong to the specified
                    organization.
                  value:
                    errors:
                      - code: EMPLOYEE_ACCESS_DENIED
                        message: >-
                          Raised when an employee does not belong to the
                          specified organization.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - EMPLOYEE_ACCESS_DENIED
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            - `EMPLOYEE_ACCESS_DENIED`: Raised when an employee does not belong
            to the specified organization.
        '404':
          content:
            application/json:
              examples:
                ABSENCE_NOT_FOUND:
                  summary: No edition exists for this absence_id under this employee.
                  value:
                    errors:
                      - code: ABSENCE_NOT_FOUND
                        message: >-
                          No edition exists for this absence_id under this
                          employee.
                EMPLOYEE_NOT_FOUND:
                  summary: Raised when an employee is not found.
                  value:
                    errors:
                      - code: EMPLOYEE_NOT_FOUND
                        message: Raised when an employee is not found.
                HUB_NOT_FOUND:
                  summary: >-
                    Raised when a hub does not exist under the parent named in
                    the path.
                  value:
                    errors:
                      - code: HUB_NOT_FOUND
                        message: >-
                          Raised when a hub does not exist under the parent
                          named in the path.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - HUB_NOT_FOUND
                            - EMPLOYEE_NOT_FOUND
                            - ABSENCE_NOT_FOUND
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            - `HUB_NOT_FOUND`: Raised when a hub does not exist under the parent
            named in the path.

            - `EMPLOYEE_NOT_FOUND`: Raised when an employee is not found.

            - `ABSENCE_NOT_FOUND`: No edition exists for this absence_id under
            this employee.
        '409':
          content:
            application/json:
              examples:
                ABSENCE_ALREADY_CALLER:
                  summary: >-
                    The partner already calculates this absence's pay, so it
                    cannot be taken over again.
                  value:
                    errors:
                      - code: ABSENCE_ALREADY_CALLER
                        message: >-
                          The partner already calculates this absence's pay, so
                          it cannot be taken over again.
                ABSENCE_CANCELLED:
                  summary: >-
                    The absence's current edition is cancelled; a cancelled
                    absence cannot be amended, cancelled again, or receive
                    sub-resource facts.
                  value:
                    errors:
                      - code: ABSENCE_CANCELLED
                        message: >-
                          The absence's current edition is cancelled; a
                          cancelled absence cannot be amended, cancelled again,
                          or receive sub-resource facts.
                GB_ABSENCE_PAID_KIT_DAY_OUTSIDE_LEAVE:
                  summary: >-
                    An amendment moves the booked leave span so that a
                    keeping-in-touch day an approved payrun paid falls outside
                    it.
                  value:
                    errors:
                      - code: GB_ABSENCE_PAID_KIT_DAY_OUTSIDE_LEAVE
                        message: >-
                          An amendment moves the booked leave span so that a
                          keeping-in-touch day an approved payrun paid falls
                          outside it.
                GB_ABSENCE_PAID_KIT_DAY_REMOVED:
                  summary: >-
                    An amendment drops a keeping-in-touch day that an approved
                    payrun paid.
                  value:
                    errors:
                      - code: GB_ABSENCE_PAID_KIT_DAY_REMOVED
                        message: >-
                          An amendment drops a keeping-in-touch day that an
                          approved payrun paid.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - ABSENCE_CANCELLED
                            - ABSENCE_ALREADY_CALLER
                            - GB_ABSENCE_PAID_KIT_DAY_REMOVED
                            - GB_ABSENCE_PAID_KIT_DAY_OUTSIDE_LEAVE
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            - `ABSENCE_CANCELLED`: The absence's current edition is cancelled; a
            cancelled absence cannot be amended, cancelled again, or receive
            sub-resource facts.

            - `ABSENCE_ALREADY_CALLER`: The partner already calculates this
            absence's pay, so it cannot be taken over again.

            - `GB_ABSENCE_PAID_KIT_DAY_REMOVED`: An amendment drops a
            keeping-in-touch day that an approved payrun paid.

            - `GB_ABSENCE_PAID_KIT_DAY_OUTSIDE_LEAVE`: An amendment moves the
            booked leave span so that a keeping-in-touch day an approved payrun
            paid falls outside it.
        '422':
          content:
            application/json:
              examples:
                COUNTRY_NOT_SUPPORTED:
                  summary: >-
                    No country implementation is registered for this country
                    code.
                  value:
                    errors:
                      - code: COUNTRY_NOT_SUPPORTED
                        message: >-
                          No country implementation is registered for this
                          country code.
                GB_ABSENCE_CONTENT_MALFORMED:
                  summary: >-
                    Raised when the stored content of an absence can no longer
                    be read, after a schema change or an edit made outside the
                    API.
                  value:
                    errors:
                      - code: GB_ABSENCE_CONTENT_MALFORMED
                        message: >-
                          Raised when the stored content of an absence can no
                          longer be read, after a schema change or an edit made
                          outside the API.
                GB_ABSENCE_EMPLOYEE_COUNTRY_MISMATCH:
                  summary: >-
                    Raised when a GB absence is written for an employee who is
                    not a GB employee.
                  value:
                    errors:
                      - code: GB_ABSENCE_EMPLOYEE_COUNTRY_MISMATCH
                        message: >-
                          Raised when a GB absence is written for an employee
                          who is not a GB employee.
                GB_ABSENCE_KIT_DAY_OUTSIDE_LEAVE:
                  summary: >-
                    A write records a keeping-in-touch day outside the booked
                    leave span.
                  value:
                    errors:
                      - code: GB_ABSENCE_KIT_DAY_OUTSIDE_LEAVE
                        message: >-
                          A write records a keeping-in-touch day outside the
                          booked leave span.
                GB_SMP_CURSOR_MALFORMED:
                  summary: >-
                    A paid-through cursor stored on a CONSUMED absence line is
                    not an ISO date.
                  value:
                    errors:
                      - code: GB_SMP_CURSOR_MALFORMED
                        message: >-
                          A paid-through cursor stored on a CONSUMED absence
                          line is not an ISO date.
              schema:
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      description: >-
                        Represents an error that occurred during processing.


                        Designed for client-side i18n:

                        - code: Use this to look up translation (e.g.,
                        "HUB_NOT_FOUND")

                        - message: English fallback if translation not available

                        - field: Field name for form validation highlighting

                        - params: Dynamic values for translation interpolation
                      properties:
                        code:
                          description: Unique error code for i18n lookup
                          enum:
                            - COUNTRY_NOT_SUPPORTED
                            - GB_ABSENCE_EMPLOYEE_COUNTRY_MISMATCH
                            - GB_ABSENCE_CONTENT_MALFORMED
                            - GB_ABSENCE_KIT_DAY_OUTSIDE_LEAVE
                            - GB_SMP_CURSOR_MALFORMED
                            - FIELD_REQUIRED
                            - FIELD_INVALID_TYPE_STRING
                            - FIELD_INVALID_TYPE_INT
                            - FIELD_INVALID_TYPE_FLOAT
                            - FIELD_INVALID_TYPE_BOOL
                            - FIELD_INVALID_TYPE_DICT
                            - FIELD_INVALID_TYPE_LIST
                            - FIELD_STRING_TOO_SHORT
                            - FIELD_STRING_TOO_LONG
                            - FIELD_STRING_PATTERN_MISMATCH
                            - FIELD_VALUE_TOO_SMALL
                            - FIELD_VALUE_TOO_LARGE
                            - FIELD_INVALID_DATE
                            - FIELD_INVALID_DATETIME
                            - FIELD_INVALID_TIME
                            - FIELD_INVALID_DATE_FORMAT
                            - FIELD_INVALID_DATETIME_FORMAT
                            - FIELD_INVALID_ENUM_VALUE
                            - FIELD_INVALID_EMAIL
                            - FIELD_INVALID_URL
                            - FIELD_LIST_TOO_SHORT
                            - FIELD_LIST_TOO_LONG
                            - FIELD_UNKNOWN
                            - FIELD_VALIDATION_ERROR
                          title: Code
                          type: string
                        field:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Field that caused the error
                          title: Field
                        message:
                          description: English fallback error message
                          title: Message
                          type: string
                        params:
                          anyOf:
                            - additionalProperties: true
                              type: object
                            - type: 'null'
                          description: Parameters for translation interpolation
                          title: Params
                      required:
                        - code
                        - message
                      title: ErrorDetail
                      type: object
                    type: array
                required:
                  - errors
                title: ErrorResponse
                type: object
          description: >-
            The request failed validation. Type and format errors use the
            generic FIELD_* codes.

            - `COUNTRY_NOT_SUPPORTED`: No country implementation is registered
            for this country code.

            - `GB_ABSENCE_EMPLOYEE_COUNTRY_MISMATCH`: Raised when a GB absence
            is written for an employee who is not a GB employee.

            - `GB_ABSENCE_CONTENT_MALFORMED`: Raised when the stored content of
            an absence can no longer be read, after a schema change or an edit
            made outside the API.

            - `GB_ABSENCE_KIT_DAY_OUTSIDE_LEAVE`: A write records a
            keeping-in-touch day outside the booked leave span.

            - `GB_SMP_CURSOR_MALFORMED`: A paid-through cursor stored on a
            CONSUMED absence line is not an ISO date.
      security:
        - BearerToken: []
components:
  schemas:
    GBAbsenceResponse:
      additionalProperties: false
      description: One edition, as stored. `created_at` is the edition's transaction time.
      properties:
        absence_id:
          title: Absence Id
          type: string
        content:
          $ref: '#/components/schemas/GBMaternityAbsence-Output'
        country_code:
          const: GB
          default: GB
          title: Country Code
          type: string
        created_at:
          format: date-time
          title: Created At
          type: string
        employee_id:
          title: Employee Id
          type: string
        end_date:
          description: Last day of leave (inclusive); return to work is the next day
          format: date
          title: End Date
          type: string
        external_ref:
          anyOf:
            - type: string
            - type: 'null'
          description: AMS correlation reference
          title: External Ref
        is_cancelled:
          default: false
          title: Is Cancelled
          type: boolean
        start_date:
          description: First day of leave (inclusive)
          format: date
          title: Start Date
          type: string
        valuation:
          $ref: '#/components/schemas/AbsenceValuation'
          description: >-
            Who calculates the absence's pay. ENGINE: this service pays the
            statutory, keeping-in-touch and occupational top-up lines. CALLER:
            the partner pays it, and the engine writes nothing more for it.
            Every absence starts ENGINE and becomes CALLER for good after the
            take-over action, or once an approved positive-pay payslip covers a
            day of it; the next write to the absence then stores CALLER. A read
            reports the effective value; the history reports what each edition
            stored.
      required:
        - start_date
        - end_date
        - content
        - absence_id
        - employee_id
        - created_at
        - valuation
      title: GBAbsenceResponse
      type: object
    GBMaternityAbsence-Output:
      additionalProperties: false
      description: >-
        GB maternity content payload. `ewc` anchors the qualifying-week and MPP

        derivations, so it must be the SUNDAY the expected week of childbirth

        starts on (HMRC weeks run Sunday to Saturday); rejecting anything else
        is

        correct-by-policy rather than silently normalising a caller bug.
      properties:
        absence_type:
          const: MATERNITY
          default: MATERNITY
          title: Absence Type
          type: string
        actual_birth_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            Actual date of birth; supplied after the fact via the birth
            sub-resource
          title: Actual Birth Date
        content_schema_version:
          const: 1
          default: 1
          description: Version of the stored content shape; see the class comment
          title: Content Schema Version
          type: integer
        evidence_received:
          default: false
          description: MAT B1 or recognised medical evidence has been received
          title: Evidence Received
          type: boolean
        evidence_received_at:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: Date the MAT B1 / medical evidence was received
          title: Evidence Received At
        ewc:
          description: Sunday starting the expected week of childbirth
          format: date
          title: Ewc
          type: string
        kit_days:
          items:
            $ref: '#/components/schemas/KITDay-Output'
          title: Kit Days
          type: array
        planned_start_date:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            Planned leave start for planned-vs-actual reporting; does not affect
            the calculation
          title: Planned Start Date
        stillbirth:
          default: false
          description: Stillbirth from week 24 retains SMP entitlement
          title: Stillbirth
          type: boolean
      required:
        - ewc
      title: GBMaternityAbsence
      type: object
    AbsenceValuation:
      description: |-
        Who calculates an absence's pay.

        Country-agnostic lifecycle state, like cancellation. ENGINE: the payroll
        engine values the absence. CALLER: the partner does, after a one-way
        take-over; an absence never goes back to ENGINE.
      enum:
        - ENGINE
        - CALLER
      title: AbsenceValuation
      type: string
    KITDay-Output:
      additionalProperties: false
      description: |-
        One keeping-in-touch day. Valuation consequences (forfeiture past
        10, paying the worked day) are phase 2; the store records facts.
      properties:
        day:
          format: date
          title: Day
          type: string
        hours:
          anyOf:
            - type: string
            - type: 'null'
          description: Optional part-day hours
          title: Hours
      required:
        - day
      title: KITDay
      type: object
  securitySchemes:
    BearerToken:
      bearerFormat: JWT
      description: Get token from Auth0 and paste it here
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.