---
title: "Emissão de boleto híbrido"
method: POST
path: "/pj/apibanking/forintegration/v1/boletos-hibridos"
tags: ["BoletosHibridos"]
---

# Emissão de boleto híbrido

`POST /pj/apibanking/forintegration/v1/boletos-hibridos`

## Request

- The document declares no server URL.
- Auth: none required

API para emissão de boletos híbridos, que permitem pagamento tanto via código de barras quanto QR Code Pix. Ideal para automatizar cobranças com múltiplas formas de pagamento em um único documento.

## Request body

- Bs2Core2PixDerivadoBolepixGerarBoletoHibrido
  - `dadosCobranca` Bs2Core2PixDerivadoBolepixDadosCobranca
    - `chave` string, nullable
    - `seuNumero` string, nullable
    - `dataVencimento` string, date-time
    - `dataLimitePosVencimento` string, date-time, nullable
    - `valor` number, double
    - `multa` Bs2Core2PixDerivadoBolepixMulta
      - `tipo` 'ValorFixo' | 'ValorPercentual'
      - `valor` number, double, nullable
    - `juros` Bs2Core2PixDerivadoBolepixJuros
      - `tipo` 'FixoPorDiaCorrido' | 'PercentualAoDiaCorrido' | 'PercentualAoMesCorrido'
      - `valor` number, double, nullable
    - `valorDescontoPercentual` number, double, nullable
    - `valorDescontoFixo` number, double, nullable
    - `dataLimiteDesconto` string, date-time, nullable
    - `solicitacaoPagador` string, nullable
    - `linha1` string, nullable
    - `linha2` string, nullable
    - `linha3` string, nullable
    - `linha4` string, nullable
  - `dadosPagador` Bs2Core2PixDerivadoBolepixDadosPagador
    - `documento` string, nullable
    - `tipoDocumento` 'Cpf' | 'Cnpj'
    - `nome` string, nullable
    - `telefone` integer, nullable
    - `email` string, nullable
    - `bairro` string, nullable
    - `logradouro` string, nullable
    - `numero` string, nullable
    - `complemento` string, nullable
    - `estado` string, nullable
    - `cidade` string, nullable
    - `cep` string, nullable
  - `dadosSacadorAvalista` Bs2Core2PixDerivadoBolepixDadosSacadorAvalista
    - `documento` string, nullable
    - `nomeOuRazaoSocial` string, nullable
    - `bairro` string, nullable
    - `logradouro` string, nullable
    - `numero` string, nullable
    - `complemento` string, nullable
    - `estado` string, nullable
    - `cidade` string, nullable
    - `cep` string, nullable
  - `dadosBeneficiarioFinal` Bs2Core2PixDerivadoBolepixDadosBeneficiarioFinal
    - `documento` string, nullable
    - `nomeOuRazaoSocial` string, nullable
    - `nomeFantasia` string, nullable

## Response `201`

Created

- Bs2Core2PixDerivadoBolepixBoletoHibridoCriado
  - `boletoHibridoId` string, uuid

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/bs2/apis/bs2-core2-pix-derivado-bolepix-hosts-http-shared-options.md) - [All operations](https://skmtc.dev/bs2/apis/bs2-core2-pix-derivado-bolepix-hosts-http-shared-options/llms.txt) - [OpenAPI document](https://skmtc.dev/bs2/apis/bs2-core2-pix-derivado-bolepix-hosts-http-shared-options/revisions/623092906956?raw)