---
title: "Realização de ajuste financeiro"
method: POST
path: "/cards/invoices/adjustments"
tags: ["Ajustes financeiros"]
---

# Realização de ajuste financeiro

`POST /cards/invoices/adjustments`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/invoices/adjustments`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Realize um ajuste forçado de débito ou crédito em uma fatura em aberto. </p> 
  <span class="bkly-ref-small-stable-tag">stable</span> <span class="bkly-ref-scope-tag">scope: invoice.adjustment </span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Confira a documentação [Realização de ajuste financeiro](/docs/realizacao-ajuste-financeiro) para mais informações."
}
[/block]

## Headers

- `api-version` string, required
- `Authorization` string, required: <i>Token</i> de autorização do tipo Bearer.
- `x-bkly-correlation-id` string, required
- `x-bkly-version` string, required
- `Idempotency-Key` string
- `x-user-id` string: Documento associado à conta do usuário.

## Request body

- AdjustmentRequestDto
  - `client` ClientRequestDto: Objeto que deverá conter informações sobre o titular do cartão de crédito.
    - `contractNumber` string, nullable, required: Número do contrato de crédito vigente.
  - `transaction` TransactionRequestDto: Objeto que deverá conter informações sobre a operação que será forçosamente lançada na fatura em aberto.
    - `amount` AmountRequestDto: Objeto que deverá conter informações sobre o valor monetário do ajuste.
      - `value` number, double, nullable, required: Valor monetário da operação.
      - `currency` string, nullable, required: Código da moeda com base na ISO 4217.
    - `transactionType` 'REFINANCE_CHARGES' | 'INTEREST_ON_ARREST' | 'TRAFFIC_TICKET' | 'PURCHASE_BY_SIGHT' | 'INSTALLMENT_WITHOUT_INTEREST' | 'DEBIT_ADJUSTMENT' | 'INSTALLMENTS_WITHOUT_INTEREST' | 'INSTALLED_WITH_INTEREST' | 'PAYMENT' | 'CREDIT_ADJUSTMENT' | 'PARTIAL_CANCELLATION_OF_PURCHASE' | 'WITHDRAW' | 'INTERNATIONAL_PURCHASE' | 'INTERNATIONAL_IOF' | 'IOF' | 'IOF_WITHDRAWAL' | 'WITHDRAWAL_CHARGES' | 'ANNUITY' | 'WITHDRAWAL_RATE' | 'RATE_CARD_ISSUANCE' | 'REFINANCE_INSTALLMENT' | 'CANC_CREDIT_INSTALLMENTS' | 'PREPAID_CHARGE' | 'MEMBERSHIP_PAYMENT' | 'PURCHASE_CANCELLATION' | 'CANC_INSTALLMENT_WITHOUT_INTEREST' | 'ANNUAL_REVERSAL' | 'CREDIT_BY_INSTALLMENT' | 'REFINANCE_CONTRACT' | 'CANC_PARC_DE_REF' | 'EXCHANGE_DIF_DEBIT' | 'DIF_EXCHANGE_CREDIT' | 'REVERSAL_REFINING_CHARGES' | 'REVERSAL_INTEREST' | 'FINE_REVERSAL' | 'REVERSAL_IOF' | 'CANCELLATION_AGREEMENT_REFINANC' | 'CREDIT_BY_AGREEMENT' | 'INSTALLMENT_OF_AGREEMENT' | 'AGREEMENT_CONTRACT' | 'CANCELLATION_OF_INSTALLMENT_AGREEMENT' | 'CANC_CREDIT_AGREEMENT' | 'CANCELLATION_CONTRACT_AGREEMENT' | 'CREDIT_BY_INSTALLMENT_CP' | 'CP_REFINANCING_INSTALLMENT' | 'CP_REFINANCE_CONTRACT' | 'CANC_PARC_DE_REF_CP' | 'CANC_CREDIT_INSTALLMENT_CP' | 'CANCELLATION_CONTRACT_REF_CP' | 'DEBIT_PAYMENT' | 'CREDIT_VOUCHER' | 'CANC_INSTALLMENTS_WITHOUT_INTEREST' | 'CANC_IN_INSTALLMENTS_WITH_INTEREST' | 'CANC_INSTALLMENT_WITH_INTEREST' | 'CANC_INTERNATIONAL_PURCHASE' | 'CANC_IOF_INTERNATIONAL' | 'REVERSAL_INTERNATIONAL_WITHDRAWAL' | 'REVERSAL_DEBIT_PAYMENT' | 'REVERSED_WITHDRAWAL' | 'REVERSAL_RATE_WITHOUT_WITHDRAWAL' | 'INTERNATIONAL_WITHDRAWAL' | 'FLAG_PAYMENT' | 'TED_CASH_OUT' | 'TEF_CASH_OUT' | 'TED_CASH_IN' | 'DEBIT_REVERSAL' | 'REVERSAL_PAYMENT' | 'REVERSED_WITHDRAWAL_CHARGES' | 'PRE_PAID_RECHARGE_RATE' | 'PREPAID_RECHARGE_PERCENTAGE' | 'MDR' | 'REVERSAL_RATE_WITHDRAWAL' | 'REVERSAL_IOF_WITHDRAWAL' | 'CHARGEBACK_PURCHASE' | 'REVERSAL_CHARGEBACK_PURCHASE' | 'ANNUAL_REVERSAL' | 'REVERSAL_REFINING_CHARGES' | 'REVERSAL_IOF' | 'REVERSAL_INTEREST' | 'REVERSAL_PAYMENT' | 'CREDIT_VOUCHER_INTER' | 'CANC_REVERSAL_INTEREST' | 'PAYMENT_INCLUSION' | 'CANC_ESTORNO_IOF' | 'CRELIQ' | 'INSTALLMENTS_WITH_INTEREST' | 'REFUND_CHARGES' | 'REFUND_FINE' | 'DEPOSIT_BY_BANK_SLIP' | 'PREPAID_RATE' | 'OVERLIMIT_FEE' | 'CASHBACK' | 'CANC_CASHBACK' | 'EARLY_PAYMENT_REFUND' | 'SEGUROS_CRED ' | 'SEGUROS_PERDAS' | 'SEGUROS_DEB', required: Tipo da transação.
    - `descriptor` string, nullable, required: Descrição do ajuste financeiro realizado. O valor informado será retornado no campo <code>transactionDescription</code> do evento TRANSACTION_CREATED, que é disparado após a realização do ajuste.
    - `metadata` object, nullable: Dados adicionais que podem ser informados para a rastreabilidade da operação.

## Response `201`

Solicitação aceita com sucesso.

- AdjustmentResponseDto
  - `forceOperationId` string: Identificador único do ajuste financeiro.

## Other responses

- `400`: Há algum problema com a sua requisição.
- `401`: Acesso não autorizado.
- `404`: Recurso não encontrado.
- `409`: A solicitação conflitou com o estado atual do recurso existente no servidor.

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-faturas.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-faturas/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-faturas/revisions/59ad0e112fb8?raw)