HomeGuíasAPI ReferenceChangelog
Log In
API Reference
  1. Recursos principales
  2. Invoices

Editar Invoice

put
https://api.trytoku.com/invoices/

Actualiza los datos de una Invoice existente.

Solo modifica los campos presentes en el cuerpo; los omitidos se mantienen sin cambios. Devuelve la Invoice ya actualizada y responde 404 si no existe bajo la organización y Account autenticadas.

Límite de tasa: 20 solicitudes por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Identificador público de la Invoice a editar (in_...).

Body Params

Campos del cuerpo para actualizar una Invoice.

number
≥ 0

Monto de la Invoice, expresado en la moneda indicada en currency_code. La cantidad de decimales admitida la define la moneda: CLP no acepta decimales, MXN y BRL aceptan 2, y CLF acepta 4.

string
enum

Moneda de la Invoice. Si se omite, se usa la moneda de la Account de cobro, o la que ya tenía la Invoice cuando se está actualizando una existente.

Allowed:
string

Identificador público del Customer (cus_...) dueño de la Invoice.

boolean

Excluye la Invoice del cobro automático. Permite cargarla sin que se mande a cobrar aunque el Customer tenga un método de pago automático activo.

string
length ≤ 256
^\S+$

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

InvoiceExpirationAction | string

Acción que se ejecuta sobre la Invoice cuando expira. Se envía un string vacío para dejarla sin acción de expiración.

string

Fecha y hora de expiración de la Invoice; a partir de ese momento no se realizan más intentos de cobro. Se acepta YYYY-MM-DD HH:MM:SS (hora local de la organización) o una fecha ISO 8601 con zona horaria explícita.

integer

Identificador del recibo asociado a la Invoice.

string
length ≤ 256

Identificador único de la deuda externo a Toku. Permite distinguir dos Invoices del mismo producto que vencen el mismo día.

boolean

Marca la Invoice como pagada al crearla o editarla.

boolean

Indica si la Invoice está anulada.

string
^((https://)|(http://))[a-zA-Z0-9.\-_~+#,%&=*;:@!/()?`_{}[\]|~]+$

URL donde se debe pagar la Invoice. Se deja vacía para usar el portal de pagos de Toku; se completa solo si se desea utilizar un procesador de pagos externo.

Cantidad máxima de intentos de cobro antes de que la Invoice expire. Se envía un string vacío para quitar el límite.

metadata
object

Valores adicionales definidos por la organización. Se tratan como texto y no pueden superar los 256 caracteres cada uno. Deben declararse en la webapp de Toku antes de poder usarse.

number

Monto ya pagado de la Invoice. Se usa para registrar pagos parciales.

string
length ≤ 256
^(?! ).*(?<! )$

Identificador del producto de la organización asociado a la Invoice.

string
enum

Tipo de recibo a emitir para la Invoice: bill (boleta), invoice (factura) o no_receipt (sin recibo).

Allowed:
boolean

Si es true, reactivar una Invoice anulada o eliminada (enviando is_void: false) conserva su estado de pago actual en vez de devolverla a no pagada y cobrable.

string
length ≤ 32

Origen desde el que se creó la Invoice. Se informa cuando la carga proviene de una integración o de un proceso interno; en una creación por API se deja vacío.

string

Identificador público de la Subscription (sub_...) a la que pertenece la Invoice.

Headers
string

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

date

Versión del API para esta petición, como cualquier fecha YYYY-MM-DD. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

Responses

Updated 5 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 days ago

Did this page help you?