Crear un producto

Da de alta un producto o servicio en tu catálogo.

Endpoint

POST /api/productos

Requiere una API key con scope read_write.

Request

curl -X POST https://arca.api.com.ar/api/productos \
  -H "Authorization: Bearer ak_TuSecretoAqui" \
  -H "Content-Type: application/json" \
  -d '{
    "descripcion": "Servicio de consultoría",
    "precioUnitario": 10000,
    "tipo": "servicio",
    "alicuotaIva": 21
  }'

Parámetros

Campo	Tipo	Descripción
`descripcion`	`string`	Obligatorio. Descripción, tal como va a aparecer en el ítem del comprobante
`precioUnitario`	`number`	Obligatorio. Precio unitario neto (sin IVA). No puede ser negativo
`tipo`	`"producto"` \| `"servicio"`	Obligatorio. Ver `tipo`
`alicuotaIva`	`number` (opcional)	Alícuota de IVA en porcentaje: `0`, `2.5`, `5`, `10.5`, `21`, `27`

alicuotaIva acepta null y equivale a omitirlo.

Guardar el producto sin alicuotaIva está permitido, pero después no vas a poder emitir por referencia con él sin mandar la alícuota en el ítem: la emisión la exige y nunca la defaulteamos. Si emitís facturas A o B, cargala ahora.

Respuesta exitosa

Status: 201 · El producto creado, con el id que vas a usar en productoId:

{
  "id": "c3e5a7b9-1d2f-4068-8a9b-0c1d2e3f4a5b",
  "descripcion": "Servicio de consultoría",
  "precioUnitario": 10000,
  "tipo": "servicio",
  "alicuotaIva": 21,
  "createdAt": "2026-03-14T18:22:07.412Z",
  "updatedAt": "2026-03-14T18:22:07.412Z"
}

No hay control de duplicados

A diferencia de clientes, el catálogo no tiene una restricción de unicidad: podés crear dos productos con la misma descripción y van a convivir con id distintos. Es a propósito —una descripción no identifica un ítem—, pero significa que el control de duplicados corre por tu cuenta.

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

No consume cuota.