---
title: "Criar operação"
method: POST
path: "/operations"
tags: ["Operation"]
---

# Criar operação

`POST /operations`

Esta rota serve para criar operações de antecipação com os recebíveis selecionados.

## Request body

- object
  - `AgreementId` string — Identificador do convênio
  - `ExternalId` string — Identificador do parceiro para envios de hooks
  - `TaxIdCounterparty` string — Cnpj/Cpf do tomador do emprestimo
  - `Term` number — Quatidade de parcelas
  - `TotalAmount` number, double — Valor total do Empréstimo + Juros + Comissao + Impostos. Soma de todas as PMTs
  - `Interest` object
    - `Index` 'PRE' | 'CDIE' | 'NIPCA' — Indexador utilizado
    - `PreIndexRate` number, double — Taxa Pré Fixada do emprestimo
    - `PosIndexPercentage` number, double — Porcentagem do indexador Pós fixado a ser considerado (1 = 100%, 1.2 = 120%)
    - `BaseDayCount` number — Base de dias para o calculo da taxa. Ex. 30, 365, 252, 30360
  - `LatePaymentCharges` object — Juros cobrados por atraso
    - `PosIndexCode` 'PRE' | 'CDIE' | 'NIPCA' — Indexador pos utilizado
    - `PreIndexRate` number, double — Taxa Pré Fixada do emprestimo cobrados por atraso
    - `PosIndexPercentage` number, double — Porcentagem do indexador Pós fixado a ser considerado (1 = 100%, 1.2 = 120%) em cobrança por atraso
  - `PurchaseInformation` object
    - `amount` number, double, nullable
    - `interest` object
      - `index` 'PRE' | 'CDIE' | 'NIPCA' | 'PTAX' | 'IGPM' | 'NIGPM' | 'SELIC' | 'TR'
      - `preIndexRate` number, double, nullable
      - `posIndexPercentage` number, double, nullable
      - `baseDayCount` integer, nullable
  - `Amount` number, double — Valor do emprestimo
  - `Rate` number, double — Substituido por "Interest"."PreIndexRate"
  - `AssignmentRate` number, double — Taxa da cessão
  - `Tax` number, double — Valor de imposto aplicada. IOF
  - `Arrears` number, double — Mora
  - `Penalty` number, double — Multa
  - `LatePaymentRate` number, double — Substituido por "LatePaymentCharges"."PreIndexRate" Taxa de juros por atraso
  - `Charges` number, double — Valor dos Encargos. Soma dos FEEs/Ágio/Deságio
  - `Cet` number, double — Custo Efetivo Total
  - `BaseDayCount` number — Substituido por "Interest"."BaseDayCount"
  - `AcquisitionAmount` number, double — Valor de aquisição da operação. Amount + FEEs + Ágio/Deságio
  - `ClientNetAmount` number, double — Valor liquido desembolsado para a contraparte do emprestimo
  - `BaseDate` string, date — Start Accrual da operação
  - `SettlementDate` string, date — Data de vencimento da operação. End Accrual da operação
  - `FundingDate` string, date — Data de Liquidacao para a contraparte
  - `FirtsInstallmentDate` string, date — Data de end accrual da primeira parcela
  - `OperationType` string — Tipo do operação. Ex: NEW, PORTABILITY, REFINANCING.
  - `Settlement` object
    - `Type` 'DebitoEmConta' | 'Boleto' — Tipo da liquidação
    - `Account` object
      - `BankCode` string — Código do banco
      - `Agency` string — Número da agência
      - `DigitAgency` string — Dígito da agência
      - `Number` string — Número da conta
      - `DigitAccount` string — Dígito da conta
  - `Disbursement` object
    - `Type` 'Corrente' | 'Poupanca' | 'Salario' — Tipo da conta
    - `Account` object
      - `BankCode` string — Código do banco
      - `Agency` string — Número da agência
      - `DigitAgency` string — Dígito da agência
      - `Number` string — Número da conta
      - `DigitAccount` string — Dígito da conta
    - `AdditionalDisbursements` object[]
      - `Type` 'Corrente' | 'Poupanca' | 'Salario' | 'SSIS' — Tipo da conta
      - `TaxId` string — Documento Nacional do proprietário da conta
      - `Account` object
        - `BankCode` string — Código do banco
        - `Agency` string — Número da agência
        - `DigitAgency` string — Dígito da agência
        - `Number` string — Número da conta
        - `DigitAccount` string — Dígito da conta
  - `Contract` object
    - `ExternalId` string — Identificador do parceiro para envios de hooks
    - `Number` string — Identificador único do contrato
    - `FormalizationDate` string, date — Data da formalização do contrato
    - `Guarantees` object[]
      - `Name` string — Nome do avalista
      - `TaxId` string — Cnpj/Cpf do avalista
      - `Amount` number, double — Valor Garantido por este Avalista
    - `EmissionType` 'NONE' | 'CARTULAR' | 'ESCRITURAL' | 'ELETRONICA' — Tipo de emissao do contrato
  - `Installments` object[]
    - `Code` number — Numero da parcela
    - `Amortization` number, double — Principal da parcela. Amortização
    - `Amount` number, double — Valor da parcela. PMT
    - `Interest` number, double — Juros da parcela
    - `Tax` number, double — Valor do IOF na parcela
    - `IsPaid` boolean — Indicador se houve pagamento completo anteriormente da parcela
    - `PaidValue` number, double — Valor anteriormente pago da parcela
    - `StartAccrual` string, date — Data de inicio de accrual da parcela
    - `EndAccrual` string, date — Data de termino de accrual da parcela
    - `PaymentDate` string, date — Data de pagamento da parcela
    - `MaturityDate` string, date — Data de vencimento da parcela
  - `OtherFees` object[] — Taxas adicionais de cessão. Obrigatório se custos por cessão forem aplicáveis.
    - `Type` 'REGISTRATOR' | 'BROKER' | 'RCO' | 'CIP' | 'TAC' — Tipo do Fee
    - `Value` number, double — Valor Nominal
  - `Fees` object[] — Taxas adicionais de bancarização. Se aplicável (Obrigatorio se houver Fee)
    - `Type` 'REGISTRATOR' | 'BROKER' | 'RCO' | 'CIP' | 'TAC' — Tipo do Fee
    - `Value` number, double — Valor Nominal
  - `GenericIdentifiers` object[] — Informações adicionais
    - `Type` 'IPOC' | 'CessionNumber' | 'EndorsementNumber' | 'ConciliationIdentifier' | 'CCIIdentifier' | 'SNGRegistry' | 'ConsigCode' | 'SignatureDate' | 'FederativeUnit' | 'RATING' | 'STORE_ID' | 'SEGMENT' | 'ConsignedEntity' | 'ConsignedEntityPayer' — Tipo da informação do campo generico
    - `Value` string — Valor do campo generico
  - `RelatedOperations` object[]
    - `PositionAmount` number — Valor da posição
    - `PositionDate` string, date — Data da posição
    - `ContractNumber` string — Código do contrato
  - `WarrantyIdentification` string — Identificador da garantia

## Response `201`

Sucesso

- object
  - `operationId` integer — Id da Operação
  - `receivableErrors` object[] — Recebíveis com erro
    - `receivable` ReceivableOperationSchema
      - `identification` string, required — Identificação do recebível (ex: Nº da NF)
      - `maturityDate` string, date, required — Data de vencimento
      - `disbursementAmount` number, double — Valor de desembolso
      - `repository` 'CERC' | 'CIP' | 'ADIQ' | 'CIELO' — Registradora
      - `registerNumber` string — Número de registro na registradora
      - `pixEmv` string — Pix copia e cola
      - `bankSlipBarCode` string — Número de código de barras do boleto
    - `errorMessages` ValidationErrorsOperationEnumSchema[] — Mensagens de erro

## Other responses

- `400` — Erro de validação
- `401` — Não autorizado
- `default` — Erro

---

[API](https://skmtc.net/btgpactual/apis/folha-de-pagamentos.md) · [All operations](https://skmtc.net/btgpactual/apis/folha-de-pagamentos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/btgpactual/folha-de-pagamentos/revisions/2a24d3da114c/schema)