Crear Invoice

Body Params

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

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

float

Monto adeudado en moneda local

is_paid

boolean

Indica si el Invoice se encuentra pagado o no.

is_void

boolean

Defaults to false

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

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

Defaults to false

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

date-time

Fecha y hora exacta de expiración de la invoice. Ejemplo: 2025-03-10 00:00:00

max_collection_attempts

number

expiration_action

string

enum

Allowed:

Headers

x-account-key

string

Llave única que identifica la Cuenta de cobro

200200

201201

404404

409409

422422