Descripción general

Administrá por API la agenda de receptores guardados de tu cuenta, para reusarlos al emitir comprobantes.

Los clientes son la agenda de receptores guardados de tu cuenta: los datos de quienes recibís habitualmente tus comprobantes. Guardarlos una vez te permite emitir referenciándolos con clienteId en lugar de repetir el documento y la condición frente al IVA en cada request.

Es la misma agenda que ves en el dashboard y que administran las tools de clientes del servidor MCP: una sola fuente de verdad para las tres superficies.

Este recurso no habla con ARCA

Es metadata de tu cuenta, no un servicio del organismo. En consecuencia, y a diferencia del resto de la API REST:

No consume cuota del plan y no cuenta como consumo en el dashboard. Podés listar y actualizar tu agenda todo lo que quieras.
No lleva representada ni environment. Un cliente no pertenece a un CUIT emisor ni a un entorno: es de la cuenta, y el mismo cliente sirve para emitir desde cualquier representada en homologación o en producción.
No necesita certificados ni delegaciones. Nada de lo que hagas acá depende de tu situación en ARCA.

Operaciones disponibles

Operación	Endpoint	Scope
Listar clientes	`GET /api/clientes`	Cualquiera
Obtener un cliente	`GET /api/clientes/{id}`	Cualquiera
Crear un cliente	`POST /api/clientes`	`read_write`
Actualizar un cliente	`PATCH /api/clientes/{id}`	`read_write`
Eliminar un cliente	`DELETE /api/clientes/{id}`	`read_write`

Las tres operaciones de escritura requieren una API key con scope read_write; con una key de solo lectura responden 403. Ver Scopes de API key.

El objeto cliente

{
  "id": "8f1c2b3a-4d5e-6f70-8192-a3b4c5d6e7f8",
  "docTipo": 80,
  "docNro": "30999888777",
  "nombre": "Empresa Ejemplo S.A.",
  "condicionIvaReceptorId": 1,
  "email": "facturacion@empresa.com",
  "domicilio": "Av. Siempre Viva 742, CABA",
  "createdAt": "2026-03-14T18:22:07.412Z",
  "updatedAt": "2026-03-14T18:22:07.412Z"
}

Campo	Tipo	Descripción
`id`	`string` (uuid)	Identificador del cliente en tu cuenta. Es el que va en `clienteId` al emitir.
`docTipo`	`number`	Tipo de documento, en códigos de ARCA
`docNro`	`string`	Número de documento, sin guiones ni puntos
`nombre`	`string`	Nombre o razón social
`condicionIvaReceptorId`	`number \| null`	Condición frente al IVA del receptor
`email`	`string \| null`	Destinatario por defecto para el envío del comprobante
`domicilio`	`string \| null`	Domicilio
`createdAt` / `updatedAt`	`string` (ISO 8601)	Marcas de tiempo, en UTC

Tipos de documento (`docTipo`)

Son los códigos de la tabla de tipos de documento de ARCA, los mismos que usás en docTipo al emitir. Los tres habituales:

Código	Documento	Cuándo se usa
`80`	CUIT	Responsables inscriptos, monotributistas, exentos — toda persona jurídica
`96`	DNI	Consumidores finales identificados
`99`	Consumidor final	Venta sin identificar al receptor. `docNro` va en `"0"`

La API acepta cualquier código entero positivo: si necesitás otro (CUIL, pasaporte, LE), consultalo con la tabla tipos-documento y usalo tal cual. La validación de si ese tipo corresponde al comprobante la hace ARCA al emitir, no nosotros.

Condición frente al IVA (`condicionIvaReceptorId`)

Es el CondicionIVAReceptorId de ARCA, obligatorio en todo comprobante desde la RG 5616. Valores admitidos:

Id	Condición
`1`	Responsable Inscripto
`4`	Exento
`5`	Consumidor Final
`6`	Monotributo
`7`	No Categorizado

Cualquier otro valor se rechaza con 400.

El campo es opcional al guardar —podés dar de alta un cliente sin saber su condición—, pero obligatorio al emitir. Si emitís con clienteId de un cliente que no la tiene cargada, el request se rechaza con 400: nunca inferimos una condición frente al IVA, porque un comprobante mal categorizado sale con CAE y ya no se corrige.

Autenticación

Todos los endpoints requieren una API key válida en el header Authorization: Bearer <key>. Ver API keys.

Errores

Status	Descripción
`400`	El request no pasó la validación
`401`	API key ausente, inválida o revocada
`403`	La API key es de solo lectura (sólo en escrituras)
`404`	El cliente no existe, es de otra cuenta o fue dado de baja
`409`	Ya tenés un cliente con ese documento

No hay 402: estas operaciones no consumen cuota.