v1

latestOpenAPI 3.1.02026-07-24820248.4 KB

Crear Invoice

post/invoices

Headers

x-account-keystring

Llave única que identifica la Cuenta de cobro

Request body

customerstring required

ID del Customer entregado en su creación.

product_idstring 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_datestring date required

Fecha de vencimiento del Invoice, en formato YYYY-MM-DD.

subscriptionstring

ID de la Subscription a la cual asociar la nueva invoice. (Enviar product_id o subscription)

amountnumber float

Monto adeudado en moneda local

is_paidboolean

Indica si el Invoice se encuentra pagado o no.

is_voidboolean

Indica si el Invoice se encuentra anulado o no. Los Invoices anulados se tratan como si hubiesen sido borrados.

link_paymentstring

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.

metadatastring 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_typestring

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_receiptstring

ID del recibo. Solo aplica para módulo de facturación Chile.

disable_automatic_paymentboolean

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_codestring

Permite escoger la moneda a la que corresponde el monto de la Invoice. Acepta valores CLP, CLF, MXN o BRL

invoice_external_idstring

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_datestring 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_attemptsnumber

expiration_action'VOID' | 'DELETE'

Response

200

customerstring

product_idstring

subscriptionstring

is_paidboolean

due_datestring

is_voidboolean

amountinteger

link_paymentstring

{"stackTrail":"paths:/invoices:post:responses:200:content:application/json:schema:properties:receipt_type","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/invoices:post:responses:200:content:application/json:schema:properties:id_receipt","oasType":"schema","type":"unknown"}

{"stackTrail":"paths:/invoices:post:responses:200:content:application/json:schema:properties:source","oasType":"schema","type":"unknown"}

disable_automatic_paymentboolean

currency_codestring

invoice_external_idstring

statusstring

idstring

Example response

{
  "customer": "cus_IANswlLiEc63IbyxVQtnSjYswibj8kII",
  "product_id": "92792",
  "subscription": "sub_dqoskUMFGszKHWXpQ9nJyt-3mhxaKy6z",
  "due_date": "2021-03-04",
  "amount": 1000,
  "link_payment": "https://portal.pagos.com/tu-empresa",
  "metadata": {
    "car_brand": "Toyota",
    "car_model": "Yaris"
  },
  "currency_code": "CLP",
  "invoice_external_id": "ejemplo-invoice-external-id",
  "status": "UNPAID",
  "id": "in_K3a1P1_p_t5UHJHJXmpkQYmqXCHvXrNi"
}