---
title: "Criar Payload"
method: POST
path: "/documento/"
tags: ["Config"]
---

# Criar Payload

`POST /documento/`

Cria um novo payload JSON representando um QR/Link dinâmico

## Request body

- Documento
  - `calendario` union
    - Expiracao
      - `expiracao` string, date-time — Timestamp que indica o momento a partir do qual o QR Dinâmico não será mais considerado válido. Respeita o formato definido na RFC 3339.
      - `recebivelAposVencimento` boolean — Trata-se de um campo booleano, ou uma flag. A semântica dessa flag é definir se essa cobrança pode ser paga após o vencimento ou após a expiração. Quando seu valor for true, significa que a cobrança pode ser paga após o vencimento. Quando esse campo não estiver presente, assume-se o valor false, ou seja, a cobrança não pode ser paga após o vencimento.
    - DataDeVencimento
      - `dataDeVenciemnto` string, date — Trata-se de uma data, no formato `yyyy-mm-dd`, segundo ISO 8601. É a data de vencimento da cobrança. A cobrança pode ser honrada até esse dia, inclusive, em qualquer horário do dia.
      - `recebivelAposVencimento` boolean — Trata-se de um campo booleano, ou uma flag. A semântica dessa flag é definir se essa cobrança pode ser paga após o vencimento ou após a expiração. Quando seu valor for true, significa que a cobrança pode ser paga após o vencimento. Quando esse campo não estiver presente, assume-se o valor false, ou seja, a cobrança não pode ser paga após o vencimento.
  - `pagador` union
    - PessoaFisica
      - `cpf` string, required — CPF do devedor ou “sacado”.
      - `nome` string, required — Nome do devedor ou “sacado”.
    - PessoaJuridica
      - `cnpj` string, required — CNPJ do devedor ou “sacado”.
      - `nome` string, required — Nome do devedor ou “sacado”.
  - `valor` object, required
    - `original` string, required — Valor original do documento.
    - `juros` string — Juros aplicados à cobrança.
    - `multa` string — Multa aplicada à cobrança.
    - `desconto` string — Descontos ou abatimentos aplicados à cobrança.
    - `permiteAlteracao` boolean — Trata-se de uma flag do tipo boolean que determina se o valor final do documento pode ser alterado pelo pagador.
  - `chave` string, required — Chave DICT do recebedor.
  - `solicitacaoPagador` string — Um texto a ser apresentado ao pagador para que o pagador possa digitar uma informação correlata, em formato livre, a ser enviada ao recebedor.
  - `infoAdicionais` object[]
    - `nome` string, required
    - `valor` string, required

## Response `201`

Documento gerado

- object
  - `idDocumento` string — Id do documento.
  - `revisao` integer — Revisão do documento.
  - `txid` string
  - `valorFinal` string — Valor final do documento.

## Changes

- **2020-06-29** `5967a4b6f934` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bacen/apis/api-pix/changes/documento/post.md)

---

[API](https://skmtc.dev/bacen/apis/api-pix.md) · [All operations](https://skmtc.dev/bacen/apis/api-pix/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bacen/api-pix/revisions/5967a4b6f934/schema)