Entrar

Actualizar clientes en lote

PUT https://{organization}.myguper.com/api/register/customer/batch

Actualiza varios clientes en una sola llamada — una lista de ítems, cada uno con su id y los campos a cambiar. Úsalo en vez de repetir el update individual: poner el mismo campo en cientos de clientes (ej.: entityType=legal) o importar valores por cliente, todo en una sola petición.

Cada ítem reutiliza el mismo camino del update individual (misma sanitización y validación; solo id es obligatorio por ítem, lo omitido queda sin cambios). Un ítem malo no tumba el lote: la respuesta trae un outcome por ítem — updated, not_found o rejected (con el motivo) — y un summary con los conteos.

Pasa dryRun: true para validar sin escribir: cada ítem elegible vuelve como would_update y nada cambia. Hasta 100 ítems por llamada.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Cuerpo de la petición

Content-Type: application/json

{
  "items": [
    { "id": 683752, "entityType": "legal" },
    { "id": 683999, "entityType": "legal" },
    { "id": 684010, "name": "Tintin", "email": "tintim@guper.co" }
  ],
  "dryRun": false
}

Respuestas

{
  "dryRun": false,
  "total": 3,
  "summary": { "updated": 2, "notFound": 1, "rejected": 0 },
  "results": [
    { "id": 683752, "outcome": "updated" },
    { "id": 683999, "outcome": "updated" },
    { "id": 684010, "outcome": "not_found" }
  ]
}
Copied to clipboard