Editar Customer

put

https://api.trytoku.com/customers/{encrypted_customer_id}

Actualiza los datos de un Customer existente.

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

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

encrypted_customer_id

string

required

Identificador público del Customer a editar (cus_...).

Body Params

Campos del cuerpo para actualizar un Customer.

admin_area

string

admin_code

string

agent_phone_number

string

length ≤ 16

city

string

default_agent

string

length ≤ 128

default_receipt_type

string

enum

Documento tributario que se emite al cobrar: bill es una boleta, invoice una factura y no_receipt deja el cobro sin documento asociado.

Allowed:

detail

string

external_id

string

length ≤ 128

Identificador externo del Customer definido por la organización. Se usa como clave de idempotencia al crear o actualizar.

fiscal_regime

string

length ≤ 4

government_id

string

length ≤ 64

Identificador tributario o personal del Customer según su país (por ejemplo, el RUT en Chile).

mail

string

length ≤ 128

Correo electrónico del Customer.

metadata

object

name

string

length ≤ 128

Nombre del Customer.

neighborhood

string

pac_mandate_id

string

length ≤ 64

phone_number

string

length ≤ 16

Número de teléfono del Customer.

postal_code

string

rfc

string

length ≤ 16

secondary_emails

array of strings

Secondary Emails

send_mail

boolean

silenced_until

date-time

street_name

string

street_number

string

tax_zip_code

string

length ≤ 8

Headers

x-account-key

string

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

x-api-version

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

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful Response

401Falta de credenciales.

403Falta de permisos. No tienes por qué estar ahi 👀.

404El recurso no fue encontrado.

422El cuerpo de la petición no pasó la validación.

429Superaste el número máximos de request permitidos, espera un poquito.