Actualizar ubicación del cliente

PUThttps://carchost.fieldcontrol.com.br/customers/{customerId}/locations/{locationId}

Actualiza una ubicación del cliente. La ubicación principal no se puede archivar ni cambiar de cliente.

Requiere los headers X-Api-Key, User-Agent y Content-Type: application/json. Límite: 1 solicitud por segundo (más información).

Solicitud

Parámetros de ruta

customerIdstringobligatorio

Identificador del cliente.

locationIdstringobligatorio

Identificador de la ubicación.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Cuerpo de la solicitud

JSON, enviado con el header Content-Type: application/json.

namestringobligatorio

Nombre de la ubicación.

notesstring

Observaciones de la ubicación.

Acepta: null.

archivedboolean

Archiva la ubicación. La ubicación principal no se puede archivar.

addressobjectobligatorio

Campos de address

postalCodestring

Código postal (CEP) de 8 dígitos, solo números.

Acepta: null.

streetstring

Acepta: null.

numberstring

Acepta: null.

neighborhoodstring

Acepta: null.

citystringobligatorio

statestringobligatorio

complementstring

Acepta: null.

coordsobjectobligatorio

Campos de coords

latitudenumberobligatorio

De -90 a 90.

longitudenumberobligatorio

De -180 a 180.

Respuestas

• 200

  Ubicación actualizada.

• 401

  Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

• 403

  Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

• 404

  Recurso no encontrado. El cuerpo de la respuesta está vacío.

• 422

  Ubicación inválida, o regla de ubicación principal violada (cannotArchivePrimaryLocation, cannotChangeCustomerOfPrimaryLocation).

  cannotArchivePrimaryLocation →
• 429

  Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

• 500

  Error inesperado en el servidor.