v1

latestOpenAPI 3.1.0Proprietary2026-07-22134294785.0 KB
API

Crear cliente

Crea un cliente para ventas, cuentas corrientes, etiquetas y reportes.

post/api/v1/customers

Headers

Idempotency-Keystring required

Clave única para evitar duplicados al reintentar la misma creación de cliente.

X-Request-Idstring

ID opcional de la solicitud para trazabilidad. Si se omite, el servidor genera uno.

Request body

namestring required
company_namestring nullable
descriptionstring nullable
emailstring email nullable
phonestring nullable
tax_idstring nullable
tax_id_type'CUIL/CUIT' | 'DNI'
tax_category'registered_vat_taxpayer' | 'final_consumer' | 'monotributo_taxpayer' | 'vat_exempt' | 'vat_not_applicable'
countrystring nullable
provincestring nullable
citystring nullable
addressstring nullable
apartmentstring nullable
postal_codestring nullable
delivery_carrierstring nullable
delivery_addressstring nullable
assigned_salesperson_idstring uuid nullable
default_price_list_idstring uuid nullable
payment_term_id'days_7' | 'days_15' | 'days_30' | 'days_45' | 'days_60' | 'days_90' | 'days_30_60' | 'days_30_60_90'
payment_term_daysinteger nullable

Cantidad de días hasta el vencimiento. Usá 0 para Contado. Se prefiere sobre paymentTermId.

is_activeboolean

Response

Cliente creado exitosamente

request_idstring required