---
title: "Crear cobranza de cliente"
method: POST
path: "/api/v1/customer-payments"
tags: ["API"]
---

# Crear cobranza de cliente

`POST /api/v1/customer-payments`

Registra una cobranza de cliente con uno o más métodos de pago, aplicaciones a ventas o cuenta corriente, retenciones y datos de cheque cuando corresponde.

## Headers

- `Idempotency-Key` string, required

## Request body

- ApiCustomerPaymentCreateRequest
  - `customer_id` string, uuid, required
  - `point_of_sale_id` string, uuid, required
  - `payment_date` string, required
  - `currency` 'PES' | 'DOL', required
  - `exchange_rate` number
  - `total_amount` integer, required
  - `settlement_currency` 'PES' | 'DOL'
  - `settlement_total_amount` integer
  - `session_id` string, uuid
  - `notes` string
  - `splits` ApiSharedObject9e584e0f8a[], required
    - `payment_method_id` string, uuid, required
    - `amount` integer, required
    - `reference` string
    - `card_brand` string
    - `card_batch_number` string
    - `card_coupon_number` string
    - `card_installment_plan_code` string
    - `notes` string
    - `fee_amount` integer
    - `fee_percentage_applied` string
    - `fee_fixed_applied` integer
    - `net_amount` integer
    - `check_id` string, uuid
    - `check_data` ApiSharedObjectac8b0c51cd
      - `origin` 'own' | 'third_party', required
      - `check_format` 'paper' | 'electronic'
      - `number` string, required
      - `bank_name` string
      - `issuing_bank_account_id` string, uuid
      - `amount` integer, required
      - `issue_date` string, required
      - `due_date` string
      - `issuer_name` string
    - `register_id` string, uuid
    - `safe_id` string, uuid
  - `applications` object[]
    - `sale_id` string, uuid, required
    - `applied_amount` integer, required
  - `journal_line_applications` ApiSharedObjectdaa374f786[]
    - `journal_line_id` string, uuid, required
    - `applied_amount` integer, required
  - `credit_journal_line_applications` ApiSharedObjectdaa374f786[]
    - `journal_line_id` string, uuid, required
    - `applied_amount` integer, required
  - `credit_note_applications` object[]
    - `credit_sale_id` string, uuid, required
    - `applied_amount` integer, required
  - `advance_applications` ApiSharedObject6447103182[]
    - `advance_payment_id` string, uuid, required
    - `applied_amount` integer, required
  - `withholdings` ApiSharedObject4faf4c3ad5[]
    - `id` string, uuid
    - `type` 'ganancias' | 'iibb' | 'iva' | 'suss' | 'seg_hig', required
    - `province_id` string, nullable
    - `regimen` string, nullable
    - `amount` integer, required
    - `rate` number, nullable
    - `calculation_base` integer, nullable
    - `certificate_number` string, required

## Response `200`

Cobranza creada exitosamente

- ApiCustomerPaymentCreateResponse
  - `request_id` string, required
  - `data` object, required
    - `customer_payment` ApiSharedObjectba6d1f3759, required
      - `id` string, uuid, required
      - `type` 'customer', required
      - `status` 'active' | 'voided', required
      - `contact_id` string, uuid, nullable, required
      - `contact_name` string, nullable, required
      - `payment_number` integer, nullable, required
      - `formatted_payment_number` string, nullable, required
      - `payment_date` string, required
      - `currency` 'PES' | 'DOL', required
      - `settlement_currency` 'PES' | 'DOL'
      - `settlement_total_amount` integer, nullable
      - `exchange_rate` union
        - string
        - number
      - `total_amount` integer, required
      - `balance` integer, required
      - `notes` string, nullable
      - `created_at` string, date-time, required
      - `created_by_name` string, nullable, required
      - `splits` ApiSharedObject63c2faf817[]
        - `id` string, uuid
        - `payment_method_id` string, uuid, required
        - `payment_method_name` string
        - `amount` integer, required
        - `reference` string, nullable
        - `card_brand` string, nullable
        - `card_batch_number` string, nullable
        - `card_coupon_number` string, nullable
        - `card_installment_plan_code` string, nullable
        - `notes` string, nullable
        - `fee_amount` integer, nullable
        - `fee_percentage_applied` string, nullable
        - `fee_fixed_applied` integer, nullable
        - `net_amount` integer, nullable
        - `check_id` string, uuid, nullable
        - `register_id` string, uuid, nullable
        - `safe_id` string, uuid, nullable
      - `applications` ApiSharedObject2cdf35e652[]
        - `id` string, uuid
        - `sale_id` string, uuid
        - `invoice_sale_id` string, uuid, nullable
        - `credit_sale_id` string, uuid, nullable
        - `advance_payment_id` string, uuid
        - `journal_line_id` string, uuid
        - `applied_amount` integer, required
        - `formatted_invoice_number` string, nullable
        - `credit_formatted_invoice_number` string, nullable
        - `advance_formatted_payment_number` string, nullable
      - `credit_applications` ApiSharedObject2cdf35e652[]
        - `id` string, uuid
        - `sale_id` string, uuid
        - `invoice_sale_id` string, uuid, nullable
        - `credit_sale_id` string, uuid, nullable
        - `advance_payment_id` string, uuid
        - `journal_line_id` string, uuid
        - `applied_amount` integer, required
        - `formatted_invoice_number` string, nullable
        - `credit_formatted_invoice_number` string, nullable
        - `advance_formatted_payment_number` string, nullable
      - `journal_line_applications` ApiSharedObject2cdf35e652[]
        - `id` string, uuid
        - `sale_id` string, uuid
        - `invoice_sale_id` string, uuid, nullable
        - `credit_sale_id` string, uuid, nullable
        - `advance_payment_id` string, uuid
        - `journal_line_id` string, uuid
        - `applied_amount` integer, required
        - `formatted_invoice_number` string, nullable
        - `credit_formatted_invoice_number` string, nullable
        - `advance_formatted_payment_number` string, nullable
      - `advance_applications` ApiSharedObject2cdf35e652[]
        - `id` string, uuid
        - `sale_id` string, uuid
        - `invoice_sale_id` string, uuid, nullable
        - `credit_sale_id` string, uuid, nullable
        - `advance_payment_id` string, uuid
        - `journal_line_id` string, uuid
        - `applied_amount` integer, required
        - `formatted_invoice_number` string, nullable
        - `credit_formatted_invoice_number` string, nullable
        - `advance_formatted_payment_number` string, nullable
      - `withholdings` ApiSharedObject4faf4c3ad5[]
        - `id` string, uuid
        - `type` 'ganancias' | 'iibb' | 'iva' | 'suss' | 'seg_hig', required
        - `province_id` string, nullable
        - `regimen` string, nullable
        - `amount` integer, required
        - `rate` number, nullable
        - `calculation_base` integer, nullable
        - `certificate_number` string, required
    - `idempotent_replay` boolean, required
  - `warnings` unknown[], required
    - unknown

## Other responses

- `400` — Solicitud inválida
- `401` — API key faltante o inválida
- `403` — Scopes insuficientes
- `409` — Conflicto de idempotencia
- `429` — Límite de solicitudes excedido para la organización
- `500` — Error interno del servidor

---

[API](https://skmtc.net/lapyme/apis/la-pyme-api.md) · [All operations](https://skmtc.net/lapyme/apis/la-pyme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lapyme/la-pyme-api/versions/414f57f28498/schema)