---
title: "Crear Invoice"
method: POST
path: "/invoices"
---

# Crear Invoice

`POST /invoices`

## Headers

- `x-account-key` string

## Request body

- object
  - `customer` string, required — ID del Customer entregado en su creación.
  - `product_id` string, required — Identificador interno del producto que genera el Invoice. Puede ser un número de contrato o de propuesta. Se debe enviar siempre (product_id, due_date) o subscription.
  - `due_date` string, date, required — Fecha de vencimiento del Invoice, en formato YYYY-MM-DD.
  - `subscription` string — ID de la Subscription a la cual asociar la nueva invoice. (Enviar product_id o subscription)
  - `amount` number, float — Monto adeudado en moneda local
  - `is_paid` boolean — Indica si el Invoice se encuentra pagado o no.
  - `is_void` boolean — Indica si el Invoice se encuentra anulado o no. Los Invoices anulados se tratan como si hubiesen sido borrados.
  - `link_payment` string — URL en el que se debe pagar el Invoice. Dejar en blanco en caso de usar el portal de pagos de Toku. Incluir solo en el case de que poseas tu propio procesador de pagos.
  - `metadata` string, json — Valores adicionales específicos de cada deuda. Son tratados como valores de texto y que no pueden tener más de 256 caracteres cada uno. Debes agregarlos en la webapp de Toku antes de poder utilizarlos aquí.
  - `receipt_type` string — Tipo de recibo de la invoice, puede ser 'bill' o 'invoice', dependiendo de si hace referencia a factura o a boleta. Solo aplica para módulo de facturación Chile.
  - `id_receipt` string — ID del recibo. Solo aplica para módulo de facturación Chile.
  - `disable_automatic_payment` boolean — Permite cargar invoice y evitar que se manden a cobrar automáticamente en caso de que el customer tenga un método de pago automático activo.
  - `currency_code` string — Permite escoger la moneda a la que corresponde el monto de la **Invoice**. Acepta valores **CLP**, **CLF**, **MXN** o **BRL**
  - `invoice_external_id` string — Identificador único de la deuda, permite diferenciar dos deudas con due_date el mismo día. En caso de no enviar se concatenara "product_id-due_date"
  - `expiration_date` string, date-time — Fecha y hora exacta de expiración de la invoice. Ejemplo: 2025-03-10 00:00:00. Esta eliminación se produce en intervalos de 1 hora.
  - `max_collection_attempts` number
  - `expiration_action` 'VOID' | 'DELETE'

## Response `200`

200

- object
  - `customer` string
  - `product_id` string
  - `subscription` string
  - `is_paid` boolean
  - `due_date` string
  - `is_void` boolean
  - `amount` integer
  - `link_payment` string
  - `metadata` object
    - `car_brand` string
    - `car_model` string
  - `receipt_type` unknown
  - `id_receipt` unknown
  - `source` unknown
  - `disable_automatic_payment` boolean
  - `currency_code` string
  - `invoice_external_id` string
  - `status` string
  - `id` string

## Other responses

- `201` — 201
- `404` — 404
- `409` — 409
- `422` — 422

---

[API](https://skmtc.net/trytoku/apis/toku-api.md) · [All operations](https://skmtc.net/trytoku/apis/toku-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trytoku/toku-api/versions/30699b13e0d0/schema)