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.