Fichar (empujar marca)

Registra una marca de fichaje de un empleado (entrada, salida o pausa), con su momento real (ts). Pensado para volcar fichajes de un reloj o sistema externo. El registro es INMUTABLE: solo se añade, nunca se edita ni borra (valor legal). Las marcas deben llegar en orden cronológico y en una secuencia coherente (una entrada abierta antes de una salida, etc.); si no, 409. ts no puede ser futuro ni tener más de 60 días. La geolocalización no se acepta ni se devuelve. Requiere que la clave pueda administrar empleados.

curl -s -X POST -H "Authorization: Bearer db_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"u-delm","type":"in","ts":"2026-07-10T09:00:00Z"}' \
  "https://api.dutybeat.com/api/v1/attendance" | jq

from dutybeat import DutyBeat

client = DutyBeat(api_key="db_live_tu_clave")

punch = client.attendance.create(
    user_id="u-delm",
    type="in",
    ts="2026-07-10T09:00:00Z",
)
print(punch.id, punch.type, punch.ts)

Connect-DutyBeat -ApiKey 'db_live_tu_clave'

$p = New-DbPunch -UserId u-delm -Type in -Timestamp '2026-07-10T09:00:00Z'
"$($p.type) $($p.ts)"

{
  "data": {
    "id": "punch-nueva",
    "user_id": "u-delm",
    "type": "in",
    "ts": "2026-07-10T09:00:00.000Z",
    "modality": "onsite"
  }
}

punch-nueva in 2026-07-10T09:00:00.000Z

in 2026-07-10T09:00:00.000Z