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

# Criar Fatura

`POST /invoices`

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 — Define em quantos dias após o vencimento a fatura expira e deixa de poder ser paga. O valor deve estar entre "*0*" e "*120*" por padrão. Se informado "*0*", a fatura poderá ser paga até 23:59:59 do dia de vencimento.<br>
  - `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 *"120"* dias após a data de vencimento.
  - `items` object[], required — Itens da fatura. O parâmetro `price_cents` tem o **valor mínimo de 100**. Limite de **30 itens** em `test_mode`. Já `live_mode` **não há limites**.
    - `description` string — Descrição do item
    - `quantity` integer — Quantidade do item
    - `price_cents` integer — Preço do item em centavos. Valor mínimo 100.
  - `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.
  - `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 pagador. Aceito o campo alfanumérico apenas para CNPJ.
    - `name` string — Nome do pagador. **Obrigatório** se `cpf_cnpj` for informado. **Máximo 140 caracteres**.
    - `email` string — E-mail do pagador
    - `phone_prefix` string — DDD do número de telefone do pagador
    - `phone` string — Número de telefone do pagador
    - `address` object — Endereço do cliente, conforme os parâmetros seguintes:
      - `zip_code` string — CEP
      - `street` string — Rua
      - `number` string — Número
      - `district` string — Bairro
      - `city` string — Cidade
      - `state` string — Estado (Ex: SP)
      - `country` string — País
      - `complement` string — Complemento
  - `splits` object[] — 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)
    - `recipient_account_id` string — ID Da conta que irá receber o split
    - `cents` integer — Centavos a serem cobrados da fatura
    - `percent` number, float — Porcentagem a ser cobrada da fatura
    - `bank_slip_cents` integer — Valor em centavos a ser cobrado apenas em transações no boleto.
    - `bank_slip_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no boleto.
    - `credit_card_cents` integer — Valor em centavos a ser cobrado apenas em transações no cartão de crédito.
    - `credit_card_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no cartão de crédito.
    - `pix_cents` integer — Valor em centavos a ser cobrado apenas em transações no pix.
    - `pix_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no pix.
    - `permit_aggregated` boolean — Permite agregar comissionamento percentual + fixo.
    - `credit_card_1x_cents` string — Valor em centavos a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_cents` string — Valor em centavos a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_cents` string — Valor em centavos a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_cents` string — Valor em centavos a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_cents` string — Valor em centavos a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_cents` string — Valor em centavos a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_cents` string — Valor em centavos a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_cents` string — Valor em centavos a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_cents` string — Valor em centavos a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_cents` string — Valor em centavos a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_cents` string — Valor em centavos a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_cents` string — Valor em centavos a ser cobrado apenas em transações em 12x no cartão de crédito.
    - `credit_card_1x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_percent` string — Valor em porcentagem a ser cobrado apenas em transações em 12x no cartão de crédito.
  - `customer_id` string — ID do Cliente
  - `subscription_id` string — Amarra esta Fatura com a Assinatura especificada. Caso ocorra o pagamento desta fatura, a ciclagem da assinatura acontecerá normalmente.
  - `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
  - `ignore_due_email` boolean — Booleano que ignora o envio do e-mail de cobrança
  - `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` object[] — Variáveis Personalizadas
    - `name` string — Nome da Variável. **Limitado à 50 caracteres**.
    - `value` string — Valor da Variável. **Limitado à 200 caracteres**.
  - `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` object[] — Quantidade de dias de antecedência para o pagamento receber o desconto (Se enviado, substituirá a configuração atual da conta)
    - `days` integer — Número de dias antes do vencimento para aplicação do desconto.
    - `percent` number, float — Valor do desconto em porcentagem. Não pode ser usado com `value_cents`.
    - `value_cents` integer — Valor do desconto em centavos. Não pode ser usado com `percent`.
  - `order_id` string — Número único que identifica o pedido de compra. Opcional, ajuda a evitar o pagamento da mesma fatura.
  - `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. Caso não seja enviado, pegará o padrão configurado na conta.
  - `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.
  - `automatic_pix` object — **Dados do Payer são obrigatórios para emissão do Pix Automático.** <br>
    - `journey` integer, required — Tipo de jornada: `3` ou `4`. <br> - Jornada 3: QRCode com primeiro pagamento - Cria recorrência junto com a primeira cobrança imediata. <br> - Jornada 4: QRCode de pagamento com proposta de criar recorrência para cobranças imediatas ou futuras.
    - `frequency` string, required — Frequência da recorrência. <br>**Exemplo:** `weekly`, `monthly`, `quarterly`, `semiannual`, `annual`.</br>
    - `recurrence_beginning` string, date, required — Data de início da recorrência. Deve ser uma data futura (Formato: 'AAAA-MM-DD').
    - `contract_number` string, required — Identificador do contrato. **Máximo de 35 caracteres.**
    - `end_date` string, date — Data de término da recorrência (Formato: 'AAAA-MM-DD').
    - `receiver_recurrence_id` string — Solicita agendamento de um novo pagamento em uma recorrência já existente e autorizada pelo pagador.
    - `retry_policy` string — Política de retentativas. Nesse mesmo parâmetro, pode-se informar **"retry_allowed"**; por padrão, considera-se **"retry_not_allowed"**.
  - `pix_qr_code_expires_at` string, date-time — Data, hora, minuto e segundo que o QRCode irá expirar. Formato ISO 8601 — AAAA-MM-DDTHH:MM:SS-00:00
  - `pix_remittance_info` string — 140 caracteres. Informações do Remetente. A exibição da informação dependerá do app do Banco.
  - `pix_additional_info` object[] — Máximo 5 itens. A exibição da informação dependerá do app do Banco.
    - `name` string — Nome da Variável. **Limitado à 50 caracteres**.
    - `value` string — Valor da Variável. **Limitado à 200 caracteres**.
  - `password` string — Senha para o cliente final abrir a fatura.
  - `RAW_BODY` string

## Response `200`

200

- object
  - `id` string
  - `due_date` string
  - `currency` string
  - `discount_cents` integer
  - `email` string
  - `items_total_cents` integer
  - `notification_url` unknown
  - `return_url` string
  - `status` string
  - `tax_cents` unknown
  - `total_cents` integer
  - `total_paid_cents` integer
  - `taxes_paid_cents` unknown
  - `paid_at` unknown
  - `paid_cents` unknown
  - `cc_emails` unknown
  - `financial_return_date` unknown
  - `payable_with` string
  - `overpaid_cents` unknown
  - `ignore_due_email` unknown
  - `ignore_canceled_email` unknown
  - `advance_fee_cents` unknown
  - `commission_cents` unknown
  - `early_payment_discount` boolean
  - `order_id` unknown
  - `updated_at` string
  - `credit_card_brand` unknown
  - `credit_card_bin` unknown
  - `credit_card_last_4` unknown
  - `credit_card_captured_at` unknown
  - `credit_card_tid` unknown
  - `external_reference` unknown
  - `max_installments_value` unknown
  - `payer_name` string
  - `payer_email` unknown
  - `payer_cpf_cnpj` string
  - `payer_phone` string
  - `payer_phone_prefix` string
  - `payer_address_zip_code` string
  - `payer_address_street` string
  - `payer_address_district` string
  - `payer_address_city` string
  - `payer_address_state` string
  - `payer_address_number` string
  - `payer_address_complement` string
  - `payer_address_country` string
  - `late_payment_fine` integer
  - `late_payment_fine_cents` unknown
  - `split_id` string
  - `external_payment_id` unknown
  - `external_payment_description` unknown
  - `payment_booklet_id` unknown
  - `subscription_id` unknown
  - `variables` object[]
    - `variable` string
    - `value` string
  - `custom_variables` object[]
    - `name` string
    - `value` string
  - `logs` object[]
    - `id` string
    - `description` string
    - `notes` string
    - `created_at` string
  - `credit_card_transaction` unknown
  - `account_id` string
  - `bank_account_branch` string
  - `bank_account_number` string
  - `account_name` string
  - `secure_id` string
  - `secure_url` string
  - `customer_id` unknown
  - `customer_ref` unknown
  - `customer_name` unknown
  - `user_id` unknown
  - `total` string
  - `taxes_paid` string
  - `total_paid` string
  - `total_overpaid` string
  - `total_refunded` string
  - `fine_cents` integer
  - `commission` string
  - `fines_on_occurrence_day` string
  - `total_on_occurrence_day` string
  - `fines_on_occurrence_day_cents` integer
  - `total_on_occurrence_day_cents` integer
  - `refunded_cents` integer
  - `remaining_captured_cents` integer
  - `advance_fee` unknown
  - `estimated_advance_fee` unknown
  - `paid` string
  - `original_payment_id` unknown
  - `double_payment_id` unknown
  - `per_day_interest` boolean
  - `per_day_interest_value` unknown
  - `per_day_interest_cents` integer
  - `interest` unknown
  - `discount` string
  - `duplicated_invoice_id` unknown
  - `bank_slip_extra_due` integer
  - `created_at` string
  - `created_at_iso` string
  - `authorized_at` unknown
  - `authorized_at_iso` unknown
  - `expired_at` unknown
  - `expired_at_iso` unknown
  - `refunded_at` unknown
  - `refunded_at_iso` unknown
  - `canceled_at` unknown
  - `canceled_at_iso` unknown
  - `protested_at` unknown
  - `protested_at_iso` unknown
  - `chargeback_at` unknown
  - `chargeback_at_iso` unknown
  - `occurrence_date` unknown
  - `refundable` unknown
  - `installments` unknown
  - `transaction_number` integer
  - `payment_method` unknown
  - `financial_return_dates` unknown
  - `bank_slip` object
    - `digitable_line` string
    - `barcode_data` string
    - `barcode` string
    - `bank_slip_url` string
    - `bank_slip_pdf_url` string
    - `bank_slip_bank` integer
    - `bank_slip_status` string
    - `bank_slip_error_code` unknown
    - `bank_slip_error_message` unknown
    - `recipient_cpf_cnpj` string
  - `pix` object
    - `qrcode` string
    - `qrcode_text` string
    - `status` string
    - `payer_cpf_cnpj` unknown
    - `payer_name` unknown
    - `end_to_end_id` unknown
    - `end_to_end_refund_id` unknown
    - `account_number_last_digits` unknown
  - `items` object[]
    - `id` string
    - `description` string
    - `price_cents` integer
    - `quantity` integer
    - `created_at` string
    - `updated_at` string
    - `price` string
  - `early_payment_discounts` object[]
  - `split_rules` object[]
    - `id` string
    - `split_id` string
    - `recipient_account_id` string
    - `cents` integer
    - `percent` integer
    - `credit_card_cents` unknown
    - `credit_card_percent` unknown
    - `bank_slip_cents` unknown
    - `bank_slip_percent` unknown
    - `pix_cents` unknown
    - `pix_percent` unknown
    - `permit_aggregated` boolean
    - `created_at` string
    - `updated_at` string
    - `credit_card_1x_cents` unknown
    - `credit_card_2x_cents` unknown
    - `credit_card_3x_cents` unknown
    - `credit_card_4x_cents` unknown
    - `credit_card_5x_cents` unknown
    - `credit_card_6x_cents` unknown
    - `credit_card_7x_cents` unknown
    - `credit_card_8x_cents` unknown
    - `credit_card_9x_cents` unknown
    - `credit_card_10x_cents` unknown
    - `credit_card_11x_cents` unknown
    - `credit_card_12x_cents` unknown
    - `credit_card_1x_percent` unknown
    - `credit_card_2x_percent` unknown
    - `credit_card_3x_percent` unknown
    - `credit_card_4x_percent` unknown
    - `credit_card_5x_percent` unknown
    - `credit_card_6x_percent` unknown
    - `credit_card_7x_percent` unknown
    - `credit_card_8x_percent` unknown
    - `credit_card_9x_percent` unknown
    - `credit_card_10x_percent` unknown
    - `credit_card_11x_percent` unknown
    - `credit_card_12x_percent` unknown
    - `credit_card_13x_cents` unknown
    - `credit_card_14x_cents` unknown
    - `credit_card_15x_cents` unknown
    - `credit_card_16x_cents` unknown
    - `credit_card_17x_cents` unknown
    - `credit_card_18x_cents` unknown
    - `credit_card_13x_percent` unknown
    - `credit_card_14x_percent` unknown
    - `credit_card_15x_percent` unknown
    - `credit_card_16x_percent` unknown
    - `credit_card_17x_percent` unknown
    - `credit_card_18x_percent` unknown

## Other responses

- `400` — 400
- `422` — 422

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/revisions/4590fc729d1e/schema)