Recetas
Tres situaciones típicas, con ejemplos para copiar. Reemplazá los nombres que terminan en tu_sistema por tu propia lógica.
Sincronización incremental de despachos
Traé solo lo que cambió desde la última corrida. Es la misma receta para /facturas (cambiando el campo de dedupe a id y teniendo en cuenta que las páginas pueden venir vacías).
# Primera corrida: sin updated_since. Siguientes: el updatedAt máximo guardado. SINCE="2026-10-01T00:00:00Z" CURSOR="" while : ; do URL="https://mgt.marimpex.com.ar/api/v1/despachos?limit=100&updated_since=$SINCE" [ -n "$CURSOR" ] && URL="$URL&cursor=$CURSOR" RES=$(curl -s -H "Authorization: Bearer $MGT_API_KEY" "$URL") echo "$RES" | jq -c '.data[]' # procesar cada despacho CURSOR=$(echo "$RES" | jq -r '.nextCursor // empty') [ -z "$CURSOR" ] && break done # Al terminar, guardá el updatedAt más alto que viste y usalo como SINCE la próxima vez.
Guardá el máximo recién al terminar de paginar.
updated_since es inclusivo: el último elemento llega repetido, por eso hay que deduplicar (upsert).Reintentos ante 429 y 500
Si superás 60 llamadas por minuto, la API responde 429 con Retry-After. Esperá esos segundos. Para 500, reintentá con espera creciente.
# --retry reintenta 429 (respetando Retry-After) y errores 5xx transitorios. curl -s --retry 5 \ -H "Authorization: Bearer $MGT_API_KEY" \ "https://mgt.marimpex.com.ar/api/v1/despachos?limit=100"
Rotar la clave sin cortes
Cuando rotás una clave en Mi Organización → API, la anterior sigue funcionando 7 días. Usá ese margen para probar la nueva con /ping y recién entonces reemplazarla.
# 1. Rotás la clave en Mi Organización → API del portal (la anterior sigue andando 7 días).
# 2. Probá la nueva ANTES de reemplazar la vieja:
curl -s -H "Authorization: Bearer $MGT_API_KEY_NUEVA" https://mgt.marimpex.com.ar/api/v1/ping
# 3. Si responde {"ok":true,...}, cambiá el secreto en tu sistema y reiniciá el proceso.