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
payersarrayLista de pagadores/sacados.Sim
payers.namestringNome/Razão Social do pagador/sacado.Sim
payers.documentstringDocumento do pagador/sacado (CPF ou CNPJ).Sim
payers.phonestringNúmero de contato do pagador/sacado.Sim
payers.emailstringEmail de contato do pagador/sacado.Sim
payers.address.zipCodestringCEP do pagador/sacado.Sim
payers.address.streetstringRua do pagador/sacado.Sim
payers.address.numberstringNúmero do endereço do pagador/sacado.Sim
payers.address.complementstringComplemento do pagador/sacado.Não
payers.address.neighborhoodstringBairro do pagador/sacado.Sim
payers.address.citystringCidade do pagador/sacado.Sim
payers.address.statestringEstado do pagador/sacado.Sim
payers.address.countrystringPaís do pagador/sacado.Sim
paymentsarrayLista de pagamentos.Sim
payments.typestringTipo do pagamento. Opções: pix ou billet.Sim
payments.externalIdstringIdentificador externo do recebível ligado ao pagamento.Sim
payments.scheduleDatestringData do pagamento (Formato yyyy-MM-dd).Sim
payments.amountstring, nullValor do pagamento, obrigatório se o tipo do pagamento for pix.Não
payments.billetDigitableLinestring, nullLinha digitável do boleto, obrigatório se o tipo do pagamento for billet.Não
receivablesarrayLista de recebíveis.Sim
receivables.payerDocumentstringCNPJ do pagador referente a este recebível.Sim
receivables.externalIdstringIdentificador 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
receivables.numNFEstringNúmero da nota fiscal referente a este recebível.Sim
receivables.serieNFEstringNúmero de série da nota fiscal referente a este recebível.Sim
receivables.chaveNFEstringChave da nota fiscal referente a este recebível.Sim
billsarrayLista para criação dos boletos da operação.Sim
bills.payerDocumentstringCNPJ do pagador referente a este boleto.Sim
bills.internalIdstringId costumizado pelo usuário.Sim
bills.numNFEstringNúmero da nota fiscal.Sim
bills.serieNFEstringNúmero de série da nota fiscal.Sim
bills.chaveNFEstringChave da nota fiscal.Sim
bills.emissionDatestringData de emissão da nota fiscal (Formato yyyy-MM-dd).Sim
bills.numInstallmentnumberNúmero da parcela.Sim
bills.totalValueNFEnumberValor total da nota fiscal.Sim
bills.duplicateValuestringValor da parcela.Sim
bills.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-04-07",
    "assignor": {
        "name": "Vitor Merguizo",
        "type": "F",
        "cpf": "43825797830",
        "idNumber": "123456789",
        "issuingAgency": "ssp-sp",
        "tradeName": null,
        "cnpj": null,
        "nationality": "Brasileiro",
        "maritalStatus": "solteiro",
        "occupation": "Empresário",
        "phone": "11911111111",
        "email": "vitor@zemobank.com",
        "bank": {
            "code": "001",
            "type": "SA",
            "account": "01045662",
            "agency": "0756"
        },
        "address": {
            "street": "Rua Bela Cintra",
            "number": "999",
            "complement": "n/a",
            "neighborhood": "Consolação",
            "city": "São Paulo",
            "state": "SP",
            "country": "Brasil",
            "zipcode": "01415000"
        }
    },
    "taxes": {
        "defaultTax": 9.17,
        "floatingDays": 0
    },
    "payers": [
        {
            "name": "ZB Soluções Digitais",
            "document": "12345678000190",
            "phone": "11922222222",
            "email": "zbsolucoes@mail.com",
            "address": {
                "street": "Rua Giovani Alciati Ribas",
                "number": "187",
                "complement": "n/a",
                "neighborhood": "Vila Nastri",
                "city": "Itapetininga",
                "state": "SP",
                "country": "Brasil",
                "zipcode": "18206310"
            }
        },
        {
            "name": "ZB Serviçoes empresariais",
            "document": "45987321000155",
            "phone": "11933333333",
            "email": "zbservicos@mail.com",
            "address": {
                "street": "Rua Conselheiro José Clemente Pereira",
                "number": "622",
                "complement": "n/a",
                "neighborhood": "Jardim Campos Elíseos",
                "city": "Campinas",
                "state": "SP",
                "country": "Brasil",
                "zipcode": "13060032"
            }
        }
    ],
    "payments": [
        {
            "type": "pix",
            "externalId": "00001",
            "scheduleDate": "2026-06-15",
            "amount": 500
        },
        {
            "type": "billet",
            "externalId": "00002",
            "scheduleDate": "2026-07-15",
            "billetDigitableLine": "23793381286000451234567000123456891230000015000"
        }
    ],
    "receivables": [
        {
            "payerDocument": "12345678000190",
            "externalId": "00001",
            "identifier": "200501",
            "liquidValue": 500,
            "originalValue": 600,
            "totalAssetBacking": 600,
            "expectedDate": "2026-08-15",
            "numNFE": "1",
            "serieNFE": "1",
            "chaveNFE": "35191111111111111111111111111111111111111111"
        },
        {
            "payerDocument": "45987321000155",
            "externalId": "00002",
            "identifier": "200502",
            "liquidValue": 300,
            "originalValue": 400,
            "totalAssetBacking": 400,
            "expectedDate": "2026-10-15",
            "numNFE": "2",
            "serieNFE": "2",
            "chaveNFE": "35192222222222222222222222222222222222222222"
        }
    ],
    "bills": [
        {
            "payerDocument": "87689638000160",
            "internalId": "200501",
            "numNFE": "1",
            "serieNFE": "1",
            "chaveNFE": "35191111111111111111111111111111111111111111",
            "emissionDate": "2026-05-02",
            "numInstallment": 1,
            "totalValueNFE": 500,
            "duplicateValue": 400,
            "duplicateDueDate": "2026-07-02"
        },
        {
            "payerDocument": "28572297000189",
            "internalId": "200502",
            "numNFE": "2",
            "serieNFE": "2",
            "chaveNFE": "35192222222222222222222222222222222222222222",
            "emissionDate": "2026-05-02",
            "numInstallment": 2,
            "totalValueNFE": 500,
            "duplicateValue": 400,
            "duplicateDueDate": "2026-08-02"
        }
    ]
}

Exemplos de resposta

{
    "id": "019e4572-8c73-726e-80ce-dcab39fffca9",
    "proposalId": null,
    "status": "CREATED",
    "totalValue": 1000,
    "fixedTac": 0,
    "liquidValue": 800,
    "totalTac": 0,
    "variableTac": 0,
    "discountedValue": 200,
    "averageDaysInAdvance": 0,
    "sentPaymentDate": null,
    "operationNumber": null,
    "scheduleDate": null,
    "payments": "[{\"type\":\"pix\",\"amount\":500,\"externalId\":\"00001\",\"scheduleDate\":\"2026-06-15\"},{\"type\":\"billet\",\"billetDigitableLine\":\"23793381286000451234567000123456891230000015000\",\"externalId\":\"00002\",\"scheduleDate\":\"2026-07-15\"}]",
    "billetDigitableLine": null,
    "contractDetails": {
        "type": "FULL_CONTRACT",
        "signatureDate": null,
        "signerToken": null
    },
    "titles": [
        {
            "id": "019e4572-8c96-72a8-8a32-ba23505deb80",
            "operationId": "019e4572-8c73-726e-80ce-dcab39fffca9",
            "proposalId": null,
            "receivableId": null,
            "status": "WAITING_PAYMENT",
            "returningMoneyDate": null,
            "externalId": "00001",
            "description": "200501",
            "dueDate": "2026-08-15T15:00:00.000Z",
            "paymentDay": "2026-08-15T00:00:00.000Z",
            "originalValue": 600,
            "totalAssetBacking": 600,
            "defaultTax": 9.17,
            "variableTac": 0,
            "floatingDays": 2,
            "qtdDaysAdvanced": 0,
            "discountedValue": 100,
            "liquidTotalValue": 500,
            "percentageTotalEffectiveCost": 0,
            "cnabCounter": null,
            "createdAt": null,
            "returningMoney": 0,
            "issueDate": "2026-04-07T00:00:00.000Z",
            "UID": null,
            "chaveNFE": "35191111111111111111111111111111111111111111",
            "numNFE": "1",
            "serieNFE": "1"
        },
        {
            "id": "019e4572-8c98-7368-86c2-e25444601457",
            "operationId": "019e4572-8c73-726e-80ce-dcab39fffca9",
            "proposalId": null,
            "receivableId": null,
            "status": "WAITING_PAYMENT",
            "returningMoneyDate": null,
            "externalId": "00002",
            "description": "200502",
            "dueDate": "2026-10-15T15:00:00.000Z",
            "paymentDay": "2026-10-15T00:00:00.000Z",
            "originalValue": 400,
            "totalAssetBacking": 400,
            "defaultTax": 9.17,
            "variableTac": 0,
            "floatingDays": 2,
            "qtdDaysAdvanced": 0,
            "discountedValue": 100,
            "liquidTotalValue": 300,
            "percentageTotalEffectiveCost": 0,
            "cnabCounter": null,
            "createdAt": null,
            "returningMoney": 0,
            "issueDate": "2026-04-07T00:00:00.000Z",
            "UID": null,
            "chaveNFE": "35192222222222222222222222222222222222222222",
            "numNFE": "2",
            "serieNFE": "2"
        }
    ]
}
Nota

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