# Crear consumo por código (https://docs.loybox.com.ar/api-reference/consumos/crear-por-codigo)



<Endpoint method="POST" path="/v1/consumptions/client-code" auth="api-key" />

Registra un nuevo consumo usando el código del cliente. Es la llamada que suma
los puntos de una compra.

El cliente tiene que existir: si el código no corresponde a ningún cliente, la
llamada devuelve `404` y no se registra nada. Si preferís que el consumo se
registre igual, usá
[crear consumo por email](https://docs.loybox.com.ar/api-reference/consumos/crear-por-email).

## Cuerpo [#cuerpo]

<Fields>
  <Field name="client_code" type="integer" required="true">
    El código del cliente que hizo la compra.
  </Field>

  <Field name="amount" type="integer" required="true">
    Monto de la compra, en unidades enteras de la moneda del comercio.
  </Field>

  <Field name="counter_id" type="integer">
    Id de la caja donde se hizo la compra.
  </Field>

  <Field name="id_suc" type="integer">
    Id de la sucursal donde se hizo la compra.
  </Field>
</Fields>

## Ejemplo [#ejemplo]

```bash
curl -X POST https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/consumptions/client-code \
  -H "Authorization: Bearer $LOYBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_code": 12345,
    "amount": 1750,
    "counter_id": 2,
    "id_suc": 1
  }'
```

```json
// 201 Created
{
  "message": "Consumption created successfully"
}
```

La respuesta no dice cuántos puntos sumó. Para verlo, consultá al cliente con
[`GET /v1/clients/{client_code}`](https://docs.loybox.com.ar/api-reference/clientes/obtener).

## Errores [#errores]

| Código | Cuándo                                                                                                                           |
| ------ | -------------------------------------------------------------------------------------------------------------------------------- |
| `400`  | No se pudo crear el consumo.                                                                                                     |
| `403`  | El cliente existe pero no es elegible para tener consumos.                                                                       |
| `404`  | El cliente no existe.                                                                                                            |
| `422`  | Falta un campo del cuerpo o tiene el tipo equivocado. Ver [Errores de validación](https://docs.loybox.com.ar/api-reference/errores#errores-de-validación). |