> ## 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.

# Crear un paquete de facturación



## OpenAPI

````yaml es/openapi/v3-current/ledger.yaml post /v1/organizations/{organization_id}/billing-packages
openapi: 3.1.0
info:
  title: API de Midaz Ledger
  description: >-
    Referencia completa de la API para los servicios de Midaz Ledger, incluyendo
    gestión de organizaciones, operaciones de ledger, activos, segmentos,
    portafolios, cuentas, tipos de cuenta, transacciones, operaciones, saldos,
    rutas de operación, rutas de transacción e índices de metadatos.
  version: 3.7.8
servers:
  - url: https://ledger.sandbox.lerian.net
security: []
tags:
  - name: Organizations API
  - name: Ledgers API
  - name: Assets API
  - name: Segments API
  - name: Portfolios API
  - name: Account Types API
  - name: Accounts API
  - name: Balances API
  - name: Transactions API
  - name: Operations API
  - name: Operation Routes API
  - name: Transaction Routes API
  - name: Metadata Indexes API
  - name: Holders API
  - name: Instruments API
  - name: Billing Packages API
  - name: Packages API
  - name: Billing Calculation API
  - name: Estimation API
  - name: Encryption API
  - name: Protection API
  - name: Asset Rates API
paths:
  /v1/organizations/{organization_id}/billing-packages:
    post:
      tags:
        - Billing Packages API
      summary: Crear un paquete de facturación
      parameters:
        - $ref: '#/components/parameters/OrganizationId'
        - $ref: '#/components/parameters/ContentType'
        - $ref: '#/components/parameters/XRequestId'
        - $ref: '#/components/parameters/Authorization'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeeBillingPackage'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeBillingPackage'
        default:
          description: Error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    OrganizationId:
      name: organization_id
      in: path
      description: El identificador único de la Organización asociada al Ledger.
      required: true
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
        format: uuid
    ContentType:
      name: Content-Type
      in: header
      description: >-
        El tipo de medio del recurso. El valor recomendado es
        `application/json`.
      required: false
      example: application/json
      schema:
        type: string
    XRequestId:
      name: X-Request-Id
      in: header
      description: Un identificador único utilizado para rastrear y seguir cada solicitud.
      required: false
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
        format: uuid
    Authorization:
      name: Authorization
      in: header
      required: false
      schema:
        type: string
      description: >
        Token JWT bearer para autenticación.

        Requerido cuando `PLUGIN_AUTH_ENABLED=true` (obligatorio en despliegues
        multiinquilino).

        Opcional en el modo OSS de inquilino único predeterminado.

        Formato: `Bearer <token>`
  schemas:
    FeeBillingPackage:
      additionalProperties: false
      properties:
        accountTarget:
          $ref: '#/components/schemas/FeeAccountTarget'
        assetCode:
          examples:
            - BRL
          type: string
        countMode:
          examples:
            - perRoute
          type: string
        createdAt:
          examples:
            - '2026-01-01T00:00:00Z'
          type: string
        creditAccountAlias:
          examples:
            - account_fees_credit
          type: string
        debitAccountAlias:
          examples:
            - account_fees_debit
          type: string
        deletedAt:
          examples:
            - '2026-06-01T00:00:00Z'
          type: string
        description:
          examples:
            - Charges per completed transaction route
          type: string
        discountTiers:
          items:
            $ref: '#/components/schemas/FeeDiscountTier'
          type:
            - array
            - 'null'
        enable:
          examples:
            - true
          type:
            - boolean
            - 'null'
        eventFilter:
          $ref: '#/components/schemas/FeeEventFilter'
        feeAmount:
          examples:
            - '50.00'
          type: string
        freeQuota:
          examples:
            - 100
          format: int64
          type: integer
        id:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
        label:
          examples:
            - Monthly Volume Billing
          type: string
        ledgerId:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
        maintenanceCreditAccount:
          examples:
            - account_maintenance_credit
          type: string
        organizationId:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
        pricingModel:
          examples:
            - tiered
          type: string
        tiers:
          items:
            $ref: '#/components/schemas/FeePricingTier'
          type:
            - array
            - 'null'
        type:
          examples:
            - volume
          type: string
        updatedAt:
          examples:
            - '2026-01-01T00:00:00Z'
          type: string
      required:
        - id
        - organizationId
        - ledgerId
        - label
        - type
        - enable
        - createdAt
        - updatedAt
      type: object
    Error:
      additionalProperties: false
      properties:
        code:
          description: >-
            Código de error de dominio estable y legible por máquina, acotado al
            servicio que lo emite (formato: <SERVICE>-NNNN).
          examples:
            - ERR-0001
          type: string
        detail:
          description: >-
            Una explicación legible por humanos específica de esta ocurrencia
            del problema.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Lista opcional de detalles de error individuales
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            Una referencia URI que identifica la ocurrencia específica del
            problema.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: Código de estado HTTP
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            Un resumen breve y legible por humanos del tipo de problema. Este
            valor no debería cambiar entre distintas ocurrencias del error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: >-
            Una referencia URI a documentación legible por humanos sobre el
            error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    FeeAccountTarget:
      additionalProperties: false
      properties:
        aliases:
          examples:
            - - account_alpha
              - account_beta
          items:
            type: string
          type:
            - array
            - 'null'
        portfolioId:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
        segmentId:
          examples:
            - 00000000-0000-0000-0000-000000000000
          type: string
      type: object
    FeeDiscountTier:
      additionalProperties: false
      properties:
        discountPercentage:
          examples:
            - '10.00'
          type: string
        minQuantity:
          examples:
            - 1000
          format: int64
          type: integer
      required:
        - minQuantity
        - discountPercentage
      type: object
    FeeEventFilter:
      additionalProperties: false
      properties:
        status:
          examples:
            - APPROVED
          type: string
        transactionRoute:
          examples:
            - payment_route
          type: string
      required:
        - transactionRoute
        - status
      type: object
    FeePricingTier:
      additionalProperties: false
      properties:
        maxQuantity:
          examples:
            - 999
          format: int64
          type: integer
        minQuantity:
          examples:
            - 0
          format: int64
          type: integer
        unitPrice:
          examples:
            - '1.50'
          type: string
      required:
        - minQuantity
        - unitPrice
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Dónde ocurrió el error, p. ej. 'body.items[3].tags' o
            'path.thing-id'
          type: string
        message:
          description: Texto del mensaje de error
          type: string
        value:
          description: El valor en la ubicación indicada
      type: object

````