Crear un cliente

Da de alta un cliente en la agenda de tu cuenta.

Endpoint

POST /api/clientes

Requiere una API key con scope read_write.

Request

curl -X POST https://arca.api.com.ar/api/clientes \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "docTipo": 80,
    "docNro": "30999888777",
    "nombre": "Empresa Ejemplo S.A.",
    "condicionIvaReceptorId": 1,
    "email": "facturacion@empresa.com",
    "domicilio": "Av. Siempre Viva 742, CABA"
  }'

Parámetros

Campo	Tipo	Descripción
`docTipo`	`number`	Obligatorio. Tipo de documento de ARCA: `80` CUIT, `96` DNI, `99` consumidor final
`docNro`	`string`	Obligatorio. Número de documento, sin guiones ni puntos
`nombre`	`string`	Obligatorio. Nombre o razón social
`condicionIvaReceptorId`	`number` (opcional)	Condición frente al IVA: `1`, `4`, `5`, `6` o `7`
`email`	`string` (opcional)	Destinatario por defecto del comprobante
`domicilio`	`string` (opcional)	Domicilio

Los campos opcionales aceptan null y equivalen a omitirlos.

Guardar el cliente sin condicionIvaReceptorId está permitido, pero después no vas a poder emitir por referencia con él sin mandar la condición en el body: la emisión la exige y nunca la inferimos. Si la conocés, cargala ahora.

Respuesta exitosa

Status: 201 · El cliente creado, con el id que vas a usar en clienteId:

{
  "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"
}

Documento duplicado

Status: 409

{ "error": "Ya tenés un cliente con ese documento" }

El par docTipo + docNro es único por cuenta. Buscá el cliente existente con GET /api/clientes y actualizalo en lugar de crear uno nuevo.

Un cliente dado de baja no ocupa el documento: si lo eliminaste, podés volver a crearlo con los mismos datos (te va a dar un id nuevo).

Errores

Status	Descripción
`400`	Falta un campo obligatorio o un valor es inválido
`401`	API key ausente, inválida o revocada
`403`	La API key es de solo lectura
`409`	Ya tenés un cliente con ese documento

No consume cuota.