Pular para o conteúdo principal

Criar operações manuais

POST/api/operations/manual

Esse endpoint permite que um originador autenticado crie uma operação manual, sendo enviado o valor líquido da operação, informando as taxas ou não.

Dados da requisição​

Atenção!

Para o cedente pessoa jurídica (type: J), os dados pessoais deverão ser preenchidos com as informações do sócio solicitante, e os dados referentes ao endereço deverão ser preenchidos com as informações da Empresa.

CampoTipoDescriçãoObrigatório
issueDatestring, nullData de envio do valor da operação (Formato yyyy-MM-dd).Não
assignorobjectDados do cedente ou sócio solicitante.Sim
assignor.namestringNome completo do cedente ou sócio solicitante.Sim
assignor.typestringTipo de pessoa: F (Física) ou J (Jurídica).Sim
assignor.cpfstringCPF do cedente ou sócio solicitante.Sim
assignor.idNumberstringRG - Identidade do cedente ou sócio solicitante.Sim
assignor.issuingAgencystringÓrgão Expedidor do RG do cedente ou sócio solicitante.Sim
assignor.tradeNamestring, nullRazão social da empresa. Necessário de o type for J.Condicional
assignor.cnpjstring, nullCNPJ da empresa. Necessário de o type for J.Condicional
assignor.nationalitystringNacionalidade do cedente ou sócio solicitante.Sim
assignor.maritalStatusstringEstado civil do cedente ou sócio solicitante. Opções disponíveis: solteiro, casado, divorciado, viúvo e separado.Sim
assignor.occupationstringOcupação/Profissão do cedente ou sócio solicitante.Sim
assignor.phonestringNúmero de celular do cedente ou sócio solicitante.Sim
assignor.emailstringE-mail do cedente ou sócio solicitante.Sim
assignor.bank.codestringCódigo do banco.Sim
assignor.bank.typestringTipo de conta bancária. Opções disponíveis: CC, CP e SA.Sim
assignor.bank.accountstringNúmero da conta bancária.Sim
assignor.bank.agencystringNúmero da agência.Sim
assignor.bank.keyPixstringChave Pix para recebimento.Não
assignor.address.zipCodestringCEP.Sim
assignor.address.streetstringRua.Sim
assignor.address.numberstringNúmero do endereço.Sim
assignor.address.complementstringComplemento.Não
assignor.address.neighborhoodstringBairro.Sim
assignor.address.citystringCidade.Sim
assignor.address.statestringEstado.Sim
assignor.address.countrystringPaís.Sim
taxesobjectObjeto de definição de taxas.Não
taxes.defaultTaxnumber, nullTaxa acordada da Operação (em porcentagem).Não
taxes.fixedTacnumber, nullTaxa fixa acordada da Operação (valor em reais).Não
taxes.variableTacnumber, nullTaxa que varia com o tempo (valor em porcentagem).Não
taxes.floatingDaysnumber, nullDias extras que devem ser considerados para o cálculo da taxas.Não
payerobjectDados do pagador/sacado.Sim
payer.namestringNome/Razão Social do pagador/sacado.Sim
payer.documentstringDocumento do pagador/sacado (CPF ou CNPJ).Sim
payer.phonestringNúmero de contato do pagador/sacado.Sim
payer.emailstringEmail de contato do pagador/sacado.Sim
payer.address.zipCodestringCEP do pagador/sacado.Sim
payer.address.streetstringRua do pagador/sacado.Sim
payer.address.numberstringNúmero do endereço do pagador/sacado.Sim
payer.address.complementstringComplemento do pagador/sacado.Não
payer.address.neighborhoodstringBairro do pagador/sacado.Sim
payer.address.citystringCidade do pagador/sacado.Sim
payer.address.statestringEstado do pagador/sacado.Sim
payer.address.countrystringPaís do pagador/sacado.Sim
receivablesarrayLista de recebíveis.Sim
receivables.externalIdnumberIdentificador externo do recebível.Sim
receivables.identifierstringIdentificador interno do recebível.Sim
receivables.liquidValuenumberValor liquido do recebível.Sim
receivables.originalValuenumberValor original do recebível.Sim
receivables.totalAssetBackingnumberValor total da NF/recebível, caso o (receivables.liquidValue) seja uma parcela de um pagamento maior.Sim
receivables.expectedDatestringData prevista de pagamento (Formato yyyy-MM-dd).Sim
billsarrayLista para criação dos boletos da operação.Sim
bills.internalIdstringId costumizado pelo usuário.Sim
bills.numNFEstringNúmero da nota fiscal.Sim
bill.serieNFEstringNúmero de série da nota fiscal.Sim
bill.chaveNFEstringChave da nota fiscal.Sim
bill.emissionDatestringData de emissão da nota fiscal (Formato yyyy-MM-dd).Sim
bill.numInstallmentnumberNúmero da parcela.Sim
bill.totalValueNFEnumberValor total da nota fiscal.Sim
bill.duplicateValuestringValor da parcela.Sim
bill.duplicateDueDatestringData de vencimento da parcela (Formato yyyy-MM-dd).Sim
Observação

Caso opte por não informar a taxa específica na operação, e usar a taxa pré-cadastrada, deve-se deixar o campo como 'null' ou não informar a taxa no objeto. Se for colocado uma taxa = zero ('0') será usada a taxa padrão do originador. As taxas não podem ser menor do que as taxas do originador (taxa padrão mínima).

Observação

É possível informar como taxa personalizada apenas uma das opções, não é obrigatório passar no objeto todas as taxas disponíveis.

info

O variableTac é sempre a taxa nominal - Ex: se a taxa cobrada for 3% do recebedor no variável, tem que ser informado a variableTac = 3. Se for 0,3%, deve ser informado o variableTac = 0.3.

nota

Os campos referentes as taxas, podem ser utilizados na API de simulação de proposta / operação.

Exemplo de body (JSON)​

{
  "issueDate": "2026-02-02",
  "assignor": {
    "name": "John Wick",
    "type": "F",
    "cpf": "12345678901",
    "idNumber": "123456789",
    "issuingAgency": "SSP/SP",
    "tradeName": null,
    "cnpj": null,
    "nationality": "Brasileiro",
    "maritalStatus": "solteiro",
    "occupation": "Desenvolvedor",
    "phone": "92999998888",
    "email": "wick@zemobank.com",
    "bank": {
      "code": "001",
      "account": "123456-7",
      "type": "CC",
      "agency": "0001",
      "keyPix": "email@pix.com"
    },
    "address": {
      "zipcode": "09961050",
      "street": "Rua Jovelim",
      "number": "999",
      "complement": "AP 47",
      "neighborhood": "Jardim Bela Vista",
      "city": "São Paulo",
      "state": "SP",
      "country": "Brasil"
    }
  },
  "taxes": {
    "defaultTax": null,
    "fixedTac": null,
    "variableTac": null,
    "floatingDays": null
  },
  "payer": {
    "name": "Cliente XPTO",
    "document": "12345678000199",
    "phone": "11999999999",
    "email": "xpto@mail.com",
    "address": {
      "zipcode": "04714020",
      "street": "Rua José de Carvalho",
      "number": "613",
      "complement": null,
      "neighborhood": "Chácara Santo Antônio",
      "city": "São Paulo",
      "state": "SP",
      "country": "Brasil"
    }
  },
  "receivables": [
    {
      "externalId": 1,
      "identifier": "REC001",
      "liquidValue": 5100,
      "originalValue": 6000,
      "totalAssetBacking": 6000,
      "expectedDate": "2025-12-31"
    }
  ],
  "bills": [
    {
      "internalId": "1",
      "numNFE": "12",
      "serieNFE": "x2312",
      "chaveNFE": "10231030key",
      "emissionDate": "2026-01-15",
      "numInstallment": 1,
      "totalValueNFE": 200,
      "duplicateValue": 200,
      "duplicateDueDate": "2026-02-20"
    }
  ]
}

Exemplos de resposta

{
  "id": "019b2800-df27-779b-97f4-9688d2fec17e",
  "proposalId": null,
  "status": "CREATED",
  "totalValue": 600,
  "fixedTac": 0,
  "liquidValue": 500,
  "totalTac": 0,
  "variableTac": 0,
  "discountedValue": 100,
  "averageDaysInAdvance": 0,
  "sentPaymentDate": null,
  "operationNumber": null,
  "contractDetails": {
    "type": "APPENDIX",
    "signatureDate": null,
    "signerToken": null
  },
  "titles": [
    {
      "id": "019b2800-df6b-71a8-b949-71a011090937",
      "operationId": "019b2800-df27-779b-97f4-9688d2fec17e",
      "proposalId": null,
      "receivableId": null,
      "status": "WAITING_PAYMENT",
      "returningMoneyDate": null,
      "externalId": "1",
      "description": "REC001",
      "dueDate": "2025-12-31T15:00:00.000Z",
      "paymentDay": "2025-12-31T00:00:00.000Z",
      "originalValue": 600,
      "totalAssetBacking": 600,
      "defaultTax": 0,
      "variableTac": 0,
      "floatingDays": 2,
      "qtdDaysAdvanced": 0,
      "discountedValue": 100,
      "liquidTotalValue": 500,
      "percentageTotalEffectiveCost": 0,
      "cnabCounter": null,
      "createdAt": null,
      "returningMoney": 0,
      "issueDate": "2026-02-02T00:00:00.000Z"
    }
  ]
}
Nota

Os dados de resposta de sucesso são iguais independentes do type do cedente.