Schema

Customer

Customer. tax_id format is validated per the NEGOCIO'S country (AR CUIT/DNI, MX RFC, CO NIT; other countries pass through). On create, fiscal_category is REQUIRED for AR/MX/CO (the countries with a fiscal- classification model) and REJECTED for the others. tax_id is normalized on write (digits-only for AR/CO, uppercase RFC for MX).

Ejemplo

json

{
  "id": "8801",
  "email": "compras@empresa.com",
  "name": "Ana",
  "phone": "+5491155556666",
  "tax_id": "20123456789",
  "fiscal_category": "responsable-inscripto",
  "price_list_id": "42",
  "discount": 10,
  "blocked": false,
  "fiscal_address": { "street_address": "Av. Corrientes 1234", "city": "CABA", "country": "Argentina" },
  "shipping_addresses": []
}

Campo

Campo	Tipo	Flags	Notas
`id`	`string`	sólo lectura
`email`	`string`	requerido	Unique within the negocio.
`name`	`string`
`last_name`	`string`
`company`	`string`
`trade_name`	`string`
`phone`	`string`	requerido
`alt_phone`	`string`
`tax_id`	`string`	requerido	AR CUIT (11 digits + mod-11) / DNI (7-8). MX RFC (12-13 chars + date). CO NIT mod-11. Other countries: accepted as-is.
`fiscal_category`	`string`		AR: "responsable-inscripto" / "consumidor-final" / "exento" / "monotributo". MX: "mx/sat-601"…"mx/sat-626". CO: "co/responsable-iva" / "co/no-responsable-iva". Required on AR/MX/CO; not supported for other countries.
`price_list_id`	`string`		Optional. Assigns the customer to a price list.
`discount`	`number`		Percentage discount (0–100).
`web`	`string`
`notes_public`	`string`
`notes_private`	`string`
`blocked`	`boolean`
`created_at`	`string`	sólo lectura	ISO-8601 UTC.
`fiscal_address`	Address		Partial updates merge at the address level — unsent components are preserved.
`shipping_addresses`	Address[]		Replaced wholesale on update (the array is the entire shipping set).