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

# Obtener un paquete

> Utiliza este endpoint para obtener un paquete específico y sus tarifas asociadas.



## OpenAPI

````yaml es/openapi/v3-current/fees-engine.yaml get /v1/packages/{id}
openapi: 3.1.0
info:
  title: Fees Engine
  description: ''
  version: 3.3.0
servers:
  - url: https://fees.sandbox.lerian.net
security: []
tags:
  - name: Fees Engine
paths:
  /v1/packages/{id}:
    get:
      tags:
        - API de paquetes
      summary: Obtener un paquete
      description: >-
        Utiliza este endpoint para obtener un paquete específico y sus tarifas
        asociadas.
      parameters:
        - $ref: '#/components/parameters/PackageId'
        - $ref: '#/components/parameters/Authorization'
        - $ref: '#/components/parameters/ContentType'
        - $ref: '#/components/parameters/XOrganizationId'
      responses:
        '200':
          description: >-
            Indica que el recurso se creó correctamente y que la operación se
            completó según lo esperado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePackagesResponse'
              example:
                id: ff99e917-a112-4571-99cf-301a9231d826
                feeGroupLabel: División de tarifas
                description: Paquete creado para pruebas.
                transactionRoute: 019c96a0-10a0-72d2-9fb0-2b7de8093182
                segmentId: 019c96a0-0b4e-7079-8be0-ab6bdccf975f
                ledgerId: 019c96a0-0ac0-7de9-9f53-9cf842a2ee5a
                minimumAmount: '3000.00'
                maximumAmount: '6000.00'
                waivedAccounts:
                  - customer-brl-1
                  - customer-brl-2
                fees:
                  maintenance:
                    feeLabel: Tasa administrativa
                    calculationModel:
                      applicationRule: flatFee
                      calculations:
                        - type: flat
                          value: '16'
                    referenceAmount: originalAmount
                    priority: 1
                    isDeductibleFrom: false
                    creditAccount: business-brl-4
                    routeFrom: 019c96a0-1071-7a0d-9916-a831221de252
                    routeTo: 019c96a0-108c-7a74-8e31-3789daffe1ed
                  adm:
                    feeLabel: Test fee
                    calculationModel:
                      applicationRule: percentage
                      calculations:
                        - type: percentage
                          value: '6'
                    referenceAmount: afterFeesAmount
                    priority: 2
                    isDeductibleFrom: true
                    creditAccount: business-brl-3
                    routeFrom: 019c96a0-1071-7a0d-9916-a831221de252
                    routeTo: 019c96a0-108c-7a74-8e31-3789daffe1ed
                enable: true
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Error0002:
                  $ref: '#/components/examples/Error0002'
                Error0003:
                  $ref: '#/components/examples/Error0003'
                Error0012:
                  $ref: '#/components/examples/Error0012'
                Error0016:
                  $ref: '#/components/examples/Error0016'
                Error0019:
                  $ref: '#/components/examples/Error0019'
          headers: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Error0004:
                  $ref: '#/components/examples/Error0004'
          headers: {}
      security: []
components:
  parameters:
    PackageId:
      name: id
      in: path
      description: Identificador único del paquete que deseas actualizar.
      required: true
      schema:
        type: string
        example: 019c96a0-10ce-75fc-a273-dc799079a99c
    Authorization:
      name: Authorization
      in: header
      description: >-
        El token de autorización en formato 'Bearer <token>'.


        **Importante:** Este encabezado es obligatorio si su entorno tiene
        habilitado Access Manager. Para obtener más información, consulte la
        documentación de [Access Manager](/es/access-manager).
      required: false
      schema:
        type: string
    ContentType:
      name: Content-Type
      in: header
      description: Tipo de medio del recurso. Debe ser `application/json`.
      required: true
      schema:
        type: string
        example: application/json
    XOrganizationId:
      name: X-Organization-Id
      in: header
      description: Identificador único de la organización asociada a la solicitud.
      required: true
      schema:
        type: string
        example: 019c96a0-0a98-7287-9a31-786e0809c769
  schemas:
    CreatePackagesResponse:
      type: object
      properties:
        id:
          type: string
          description: Identificador único del paquete en formato UUIDv7.
        feeGroupLabel:
          type: string
          description: >-
            Nombre del grupo de tarifas, usado para identificar el paquete
            configurado.
        description:
          type: string
          nullable: true
          description: Breve resumen del paquete que explica qué cubre.
        transactionRoute:
          type: string
          nullable: true
          description: >-
            La ruta contable principal que define la naturaleza de la
            transacción. Ayuda a agrupar operaciones relacionadas en el
            _Ledger_.
        segmentId:
          type: string
          nullable: true
          description: >-
            Identificador único del segmento al que está vinculado este paquete
            de tarifas en el _Ledger_ de Midaz.
        ledgerId:
          type: string
          description: >-
            Identificador único del _Ledger_ al que está vinculado este paquete
            de tarifas en el _Ledger_ de Midaz.
        minimumAmount:
          type: string
          description: >-
            Monto mínimo de la transacción por debajo del cual las tarifas del
            paquete no aplican.
        maximumAmount:
          type: string
          description: >-
            Monto máximo de la transacción por encima del cual las tarifas del
            paquete no aplican.
        waivedAccounts:
          type: array
          nullable: true
          items:
            type: string
          description: Lista de cuentas exentas de las tarifas definidas en el paquete.
        fees:
          description: >-
            Objeto que contiene reglas de tarifas con nombres personalizados.
            Cada clave la define el cliente (por ejemplo, `admFee`, `iof`) y su
            valor debe seguir el esquema del objeto `Fee`.
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Fee'
        enable:
          type: boolean
          description: Si `true`, indica que el paquete está activo.
        createdAt:
          type: string
          format: date-time
          description: Fecha en la que se creó el paquete.
        updatedAt:
          type: string
          format: date-time
          nullable: true
          description: Fecha en la que se actualizó por última vez el paquete.
        deletedAt:
          type: string
          format: date-time
          nullable: true
          description: Fecha en la que se eliminó el paquete.
      required:
        - id
        - feeGroupLabel
        - ledgerId
        - minimumAmount
        - maximumAmount
        - enable
        - fees
    Error:
      type: object
      properties:
        code:
          type: string
          description: Identificador único y estable del error.
        title:
          type: string
          description: Resumen breve del problema.
        message:
          type: string
          description: Orientación detallada para resolver el error.
      required:
        - code
        - title
        - message
      description: Mensaje de error devuelto en la respuesta.
    Fee:
      type: object
      description: >-
        Representa una regla de tarifa definida con una clave personalizada en
        el objeto `fees`. El nombre de la clave (por ejemplo, `admFee`, `iof`)
        lo define el cliente y debe seguir el formato `camelCase`.
      required:
        - feeLabel
        - calculationModel
        - referenceAmount
        - priority
        - isDeductibleFrom
        - creditAccount
      properties:
        feeLabel:
          type: string
          description: Nombre visible de la tarifa, como 'Administrative Fee' o 'IOF'.
        calculationModel:
          type: object
          description: Objeto que define el modelo de cálculo de la tarifa.
          required:
            - applicationRule
            - calculation
          properties:
            applicationRule:
              type: string
              description: >-
                Define cómo se calcula la tarifa. Opciones: `maxBetweenTypes`,
                `percentual` o `flatFee`.
              enum:
                - maxBetweenTypes
                - percentual
                - flatFee
            calculation:
              type: array
              description: >-
                Lista de valores que se aplicarán según el campo 
                `applicationRule`.
              items:
                type: object
                required:
                  - type
                  - value
                properties:
                  type:
                    type: string
                    enum:
                      - percentage
                      - flat
                    description: Tipo de cálculo utilizado, como `flat` o `percentage`.
                  value:
                    type: string
                    description: Monto de la tarifa.
        referenceAmount:
          type: string
          description: >-
            Define qué monto se utilizará como base para el cálculo de la
            tarifa.
          enum:
            - originalAmount
            - afterFeesAmount
        priority:
          type: integer
          description: Define el orden en que se aplican las tarifas.
        isDeductibleFrom:
          type: boolean
          description: Si `true`, indica que la tarifa se deduce del monto base.
        creditAccount:
          type: string
          description: >-
            Alias de la cuenta que recibirá los créditos generados por la
            tarifa.
        routeFrom:
          type: string
          description: Especifica la ruta contable para la operación de débito.
        routeTo:
          type: string
          description: Especifica la ruta contable para la operación de crédito.
  examples:
    Error0002:
      summary: Missing fields in request
      value:
        code: FEE-0002
        title: Missing fields in request
        message: >-
          Your request is missing one or more required fields. Please refer to
          the documentation to ensure all necessary fields are included in your
          request.
    Error0003:
      summary: Bad request
      value:
        code: FEE-0003
        title: Bad request
        message: >-
          The server could not understand the request due to malformed syntax.
          Please check the listed fields and try again.
    Error0012:
      summary: Entity not found
      value:
        code: FEE-0012
        title: Entity not found
        message: >-
          No entity was found for the given ID. Please make sure to use the
          correct ID for the entity you are trying to manage.
    Error0016:
      summary: Invalid path parameter
      value:
        code: FEE-0016
        title: Invalid path parameter
        message: >-
          Path parameters is in an incorrect format. Please check the following
          parameter and ensure they meet the required format before trying
          again.
    Error0019:
      summary: Invalid header parameter
      value:
        code: FEE-0019
        title: Invalid header parameter
        message: >-
          One or more headers parameters are in an incorrect format. Please
          check the following parameters and ensure they meet the required
          format before trying again.
    Error0004:
      summary: Internal Server Error
      value:
        code: FEE-0004
        title: Internal Server Error
        message: >-
          The server encountered an unexpected error. Please try again later or
          contact support.

````