---
title: "Criar Fatura 18x"
method: POST
path: "/invoices"
---

# Criar Fatura 18x

`POST /invoices`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/invoices`
- Auth: API key in query parameter `api_token`

Cria uma fatura para um cliente. [Para mais informações sobre fatura](https://dev.iugu.com/docs/diferen%C3%A7a-entre-cobran%C3%A7a-direta-e-fatura)

## Request body

- object
  - `email` string, required: E-mail do cliente
  - `cc_emails` string: Endereços de E-mail para cópia separados por vírgula.
  - `due_date` string, date, required: Data do vencimento. (Formato: 'AAAA-MM-DD').
  - `ensure_workday_due_date` boolean: Se `true`, garante que a data de vencimento seja apenas em dias de semana, e não em sábados ou domingos.
  - `expires_in` string: Expira uma fatura e impossibilita o seu pagamento depois *'x'* dias após o *vencimento*. Valor enviado precisa estar entre *0* e *30*. Se for enviado "0", a fatura ficará disponível para ser paga até às **23:59:59** do dia de vencimento.
  - `bank_slip_extra_due` string: Prazo máximo para pagamento do boleto após o vencimento. O prazo máximo para pagamento deve ser entre *"1"* e *"30"* dias após a data de vencimento.
  - `items` unknown[], required: Itens da fatura. "price_cents" valor mínimo 100. <b> Limite de 30 items </b>
    - unknown
  - `return_url` string: Cliente é redirecionado para essa URL após efetuar o pagamento da Fatura pela página de Fatura da Iugu
  - `expired_url` string: Cliente é redirecionado para essa URL se a Fatura que estiver acessando estiver expirada
  - `notification_url` string: URL chamada para todas as notificações de Fatura, assim como os webhooks (Gatilhos) são chamados
  - `ignore_canceled_email` boolean: Desliga o e-mail de cancelamento de fatura
  - `fines` boolean: Booleano para Habilitar ou Desabilitar multa por atraso de pagamento
  - `late_payment_fine` integer: Determine a multa % a ser cobrada para pagamentos efetuados após a data de vencimento
  - `late_payment_fine_cents` integer: Determine a multa por valor fixo a ser cobrada para pagamentos efetuados após a data de vencimento
  - `per_day_interest` boolean: Booleano que determina se cobra ou não juros por dia de atraso. 1% ao mês pro rata. Necessário passar a multa como true
  - `per_day_interest_value` integer: Informar o valor percentual de juros que deseja cobrar. Não se aplica quando os valores diários de mora calculados são menores que 1 centavo.
  - `per_day_interest_cents` integer: Juros a ser cobrado por dia em centavos. Sobrepõem o per_day_interest_value. O juros somado em 30 dias deve ser inferior a 50% do valor da fatura.
  - `discount_cents` integer: Valor dos Descontos em centavos
  - `customer_id` string: ID do Cliente
  - `ignore_due_email` boolean: Booleano que ignora o envio do e-mail de cobrança
  - `subscription_id` string: Amarra esta Fatura com a Assinatura especificada. Esta fatura não causa alterações na assinatura vinculada.
  - `payable_with` string[]: Método de pagamento que será disponibilizado para esta Fatura ("all", "credit_card", "bank_slip" ou "pix"). Obs: Caso esta Fatura esteja atrelada à uma Assinatura, a prioridade é herdar o valor atribuído na Assinatura; caso esta esteja atribuído o valor 'all', o sistema considerará o 'payable_with' da Fatura; se não, o sistema considerará o 'payable_with' da Assinatura.
  - `credits` integer: Caso tenha o 'subscription_id', pode-se enviar o número de créditos a adicionar nessa Assinatura baseada em créditos, quando a Fatura for paga.
  - `custom_variables` unknown[]: Variáveis Personalizadas
    - unknown
  - `early_payment_discount` boolean: Ativa ou desativa os descontos por pagamento antecipado. Quando `true`, sobrepõe as configurações de desconto da conta.
  - `early_payment_discounts` unknown[]: Quantidade de dias de antecedência para o pagamento receber o desconto (Se enviado, substituirá a configuração atual da conta)
    - unknown
  - `*atenção*` object: Informações do cliente abaixo "payer" são obrigatórias para a emissão de boletos ou necessárias para seu sistema de antifraude. Para emissão de <b>Pix</b> apenas o "payer.name" é obrigatório.
  - `payer` object: Informações do Cliente para o Anti Fraude ou Boleto. Dados são obrigatórios para emissão de boletos e Pix.
    - `cpf_cnpj` string: CPF ou CNPJ do cliente (apenas números)
    - `name` string: Nome (utilizado como sacado no boleto)
    - `phone_prefix` string: Prefixo (DDD) do telefone em dois dígitos
    - `phone` string: Telefone do cliente
    - `email` string: Email do cliente
    - `address` object: Endereço do cliente, conforme os parâmetros seguintes:
  - `order_id` string: Número único que identifica o pedido de compra. Opcional, ajuda a evitar o pagamento da mesma fatura.
  - `*Commissions*` object: <b style="color: red;">Depreciado e será removido. Utilizar Splits no lugar</b>
  - `commissions` object
    - `cents` integer: Valor em centavos
    - `percent` number, float: Valor em porcentagem.
    - `credit_card_cents` integer: Valor em centavos a ser cobrado apenas em transações no cartão de crédito. Precisa do parâmetro `cents` acima configurado.
    - `credit_card_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações no cartão de crédito. Precisa do parâmetro `percent` acima configurado.
    - `bank_slip_cents` integer: Valor em centavos a ser cobrado apenas em transações no boleto. Precisa do parâmetro `cents` acima configurado.
    - `bank_slip_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações no boleto. Precisa do parâmetro `percent` acima configurado.
    - `pix_cents` integer: Valor em centavos a ser cobrado apenas em transações via Pix. Precisa do parâmetro `cents` acima configurado.
    - `pix_percent` number, float: Valor em porcentagem a ser cobrado apenas em transações via Pix. Precisa do parâmetro `percent` acima configurado.
    - `permit_aggregated` boolean: Permite agregar comissionamento percentual e fixo
  - `external_reference` string: Informação de referência externa, possibilitando a realização de pesquisa. Limite de 60 caracteres.
  - `max_installments_value` integer: Limita quantidade máxima de parcelas (1 a 18x). Caso não seja enviado, pegará o padrão configurado na conta.
  - `splits` unknown[]: Lista de splits a serém aplicado nas faturas pagas. [Para mais informações sobre com funciona o split por fatura](https://dev.iugu.com/docs/split-por-fatura-no-cart%C3%A3o-de-cr%C3%A9dito-por-api)
    - unknown
  - `RAW_BODY` string
  - `password` string: Senha para o cliente final abrir a fatura.
  - `soft_descriptor_light` string: Altera a descrição da cobrança no cartão de crédito do cliente final (Até 12 caracteres). Caso não seja enviado, será utilizada a descrição configurada na conta.

## Response `200`

200

## Other responses

- `400`: 400
- `422`: 422

---

[API](https://skmtc.dev/iugu/apis/tokens-e-cobran-a-direta.md) - [All operations](https://skmtc.dev/iugu/apis/tokens-e-cobran-a-direta/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/tokens-e-cobran-a-direta/revisions/6fe07cda088b?raw)