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

# Mark one financial movement as exported

> Marks a financial movement as exported to the target accounting system, so it stops being returned by get_financial_movements when filtered on export_status=to_export.



## OpenAPI

````yaml patch /consumers/{consumer_id}/spend_management/financial-movements/{financial_movement_id}/mark-as-exported
openapi: 3.1.0
info:
  title: Chift API
  description: >-
    The Chift API is a universal API giving you access to financial data from
    the software of your clients. It helps software companies to offer native
    integrations to their clients without the effort needed to maintain those
    native integrations. By using the APIs (Accounting, POS, eCommerce) of
    Chift, you connect once and allow your clients to use their software
    packages.
  version: 1.0.0
servers:
  - url: https://api.chift.eu
    description: Chift
security:
  - bearerAuth: []
paths:
  /consumers/{consumer_id}/spend_management/financial-movements/{financial_movement_id}/mark-as-exported:
    patch:
      tags:
        - Spend Management
        - FinancialMovements
      summary: Mark one financial movement as exported
      description: >-
        Marks a financial movement as exported to the target accounting system,
        so it stops being returned by get_financial_movements when filtered on
        export_status=to_export.
      operationId: spend_management_mark_financial_movement_as_exported
      parameters:
        - name: consumer_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Consumer Id
        - name: financial_movement_id
          in: path
          required: true
          schema:
            type: string
            title: Financial Movement Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FinancialMovementItem'
        '400':
          content:
            application/json:
              example:
                message: Error while trying to perform your request
                status: error
              schema:
                $ref: '#/components/schemas/ChiftError'
          description: Bad Request
        '404':
          content:
            application/json:
              examples:
                ERROR_FINANCIAL_MOVEMENT_NOT_FOUND:
                  value:
                    message: The financial movement doesn't exist.
                    status: error
                    error_code: ERROR_FINANCIAL_MOVEMENT_NOT_FOUND
                ERROR_FINANCIAL_MOVEMENT_NOT_FOUND_2:
                  value:
                    message: >-
                      The financial movement '${financial_movement_id}' doesn't
                      exist.
                    status: error
                    error_code: ERROR_FINANCIAL_MOVEMENT_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ChiftError'
          description: Not Found
        '409':
          content:
            application/json:
              examples:
                ERROR_WRONG_EXPORT_STATUS:
                  value:
                    message: >-
                      Only ${entity} with status 'to_export' can be marked as
                      exported.
                    status: error
                    error_code: ERROR_WRONG_EXPORT_STATUS
              schema:
                $ref: '#/components/schemas/ChiftError'
          description: Conflict
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - mcp_auth:
            - spend_management
            - spend_management.financial_movements
            - '900'
            - 900.financial_movements
components:
  schemas:
    FinancialMovementItem:
      properties:
        id:
          type: string
          title: Id
          description: Id of the financial movement.
        date:
          type: string
          format: date
          title: Date
          description: Date the financial movement was cleared/settled.
        amount:
          type: number
          title: Amount
          description: >-
            Amount of the financial movement. Negative for a refund
            (supplier_refund type), matching the direction of money flow.
        currency:
          type: string
          title: Currency
        exchange_rate:
          anyOf:
            - type: number
            - type: 'null'
          title: Exchange Rate
          description: >-
            Exchange rate applied between the movement's own currency and the
            account's currency.
        export_status:
          $ref: '#/components/schemas/PayableExportStatus'
          description: >-
            Whether this financial movement still needs to be synced to the
            target accounting system: 'not_ready' (not yet validated),
            'to_export' (ready, not yet exported), 'exported', or 'unknown' when
            the connector cannot determine it.
          default: unknown
        external:
          type: boolean
          title: External
          description: >-
            Whether the movement was funded from an external bank account rather
            than the connector's own account.
          default: false
        type:
          $ref: '#/components/schemas/FinancialMovementType'
          description: Normalized classification of this financial movement.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Free text description of the movement.
        allocations:
          items:
            $ref: '#/components/schemas/FinancialMovementAllocationItem'
          type: array
          title: Allocations
          description: >-
            The payable(s) this financial movement is settling, each with its
            own share of the amount.
        fees:
          items:
            $ref: '#/components/schemas/FinancialMovementFeeItem'
          type: array
          title: Fees
          description: Bank fees incurred for this financial movement (fx, atm, or other).
      type: object
      required:
        - id
        - date
        - amount
        - currency
        - type
      title: FinancialMovementItem
    ChiftError:
      properties:
        message:
          type: string
          title: Message
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
          default: error
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
          default: ''
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Code
      type: object
      required:
        - message
      title: ChiftError
    HTTPValidationError:
      title: Validation Error
      required:
        - message
      type: object
      properties:
        message:
          title: Message
          type: string
          default: Validation error
        status:
          title: Status
          type: string
          default: error
        detail:
          title: Detail
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
    PayableExportStatus:
      type: string
      enum:
        - unknown
        - not_ready
        - to_export
        - exported
      title: PayableExportStatus
      description: >-
        Shared across every payable-like entity of this vertical (payables,
        financial movements, ...):

        whether it still needs to be synced to the target accounting system.
    FinancialMovementType:
      type: string
      enum:
        - supplier_payment
        - employee_reimbursement
        - supplier_refund
        - cash_advance
        - cash_return
        - chargeback
      title: FinancialMovementType
    FinancialMovementAllocationItem:
      properties:
        amount:
          type: number
          title: Amount
          description: Amount of this payable's share of the financial movement.
        currency:
          type: string
          title: Currency
        payable_id:
          type: string
          title: Payable Id
          description: Id of the payable this allocation applies to.
      type: object
      required:
        - amount
        - currency
        - payable_id
      title: FinancialMovementAllocationItem
    FinancialMovementFeeItem:
      properties:
        fee_type:
          $ref: '#/components/schemas/FinancialMovementFeeType'
        amount:
          type: number
          title: Amount
        currency:
          type: string
          title: Currency
        date:
          type: string
          format: date
          title: Date
          description: Date the fee was incurred (or corrected).
      type: object
      required:
        - fee_type
        - amount
        - currency
        - date
      title: FinancialMovementFeeItem
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    FinancialMovementFeeType:
      type: string
      enum:
        - fx
        - atm
        - other
      title: FinancialMovementFeeType
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        This access token needs to be included in each of your request to the
        Chift API.

````

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