Atualizar os dados de uma Fazenda

Descrição: Atualiza os dados de uma fazenda a partir do id.

Endpoint

PUT/api/v1/integration/farms/{farm_id}

Regras

Atributos	Descrição	Tipo	Obrigatório	Validações
farm_id	Identificador da fazenda	UUID	Sim	-
state_subscription	Inscrição estadual	String	Não	Formato: inscrição-Estado. Ex: 123456-MS
name	Nome	String	Sim	Campo de preenchimento obrigatório, até 255 caracteres.
own	Tipo de propriedade	Boolean	Sim	true para própria, false para alugada
registration	Número de matricula	String	Não	Sem limite de tamanho definido pela API.
latitude	Latitude da sede	String	Não	Ignorado. O serviço substitui o valor enviado pelo que já está cadastrado na fazenda, antes de gravar. A validação de formato ainda roda antes do descarte: até 50 caracteres, padrão de latitude decimal de -90 a 90 com até 6 casas (ex: -15.601411), e valor fora disso devolve 400 mesmo sendo ignorado depois.
longitude	Longitude da sede	String	Não	Ignorado. O serviço substitui o valor enviado pelo que já está cadastrado na fazenda, antes de gravar. A validação de formato ainda roda antes do descarte: até 50 caracteres, padrão de longitude decimal de -180 a 180 com até 6 casas (ex: -56.097892).
area	Área da fazenda	String	Não	Ignorado. O serviço substitui o valor enviado pelo que já está cadastrado na fazenda, antes de gravar.
address_id	Identificador do endereço a vincular	UUID	Não	Ignorado. O serviço substitui o valor enviado pelo que já está cadastrado na fazenda, antes de gravar. Não é possível revincular endereço por este endpoint: a chamada devolve 204 e o vínculo permanece o mesmo.

Exemplo de Requisição

cURL

curl -X PUT \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Fazenda Boa Vista Atualizada",
    "own": true,
    "state_subscription": "654321-MT",
    "registration": "REG-002"
  }' \
  "https://api.merx.tech/api/v1/integration/farms/{FARM_ID}"

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = "{\"name\": \"Fazenda Boa Vista Atualizada\", \"own\": true, \"state_subscription\": \"654321-MT\", \"registration\": \"REG-002\"}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.merx.tech/api/v1/integration/farms/{FARM_ID}"))
    .header("Authorization", "{SUA_API_KEY}")
    .header("Content-Type", "application/json")
    .PUT(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpClient client = HttpClient.newHttpClient();
try {
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
} catch (Exception e) {
    e.printStackTrace();
}

JavaScript

const response = await fetch(
  'https://api.merx.tech/api/v1/integration/farms/{FARM_ID}',
  {
    method: 'PUT',
    headers: {
      'Authorization': '{SUA_API_KEY}',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: 'Fazenda Boa Vista Atualizada',
      own: true,
      state_subscription: '654321-MT',
      registration: 'REG-002',
    }),
  }
);
console.log(response.status);

Python

import requests

url = "https://api.merx.tech/api/v1/integration/farms/{FARM_ID}"

headers = {
    "Authorization": "{SUA_API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "name": "Fazenda Boa Vista Atualizada",
    "own": True,
    "state_subscription": "654321-MT",
    "registration": "REG-002"
}

response = requests.put(url, json=payload, headers=headers)
print(response.status_code)

SDK Java

import com.merx.sdk.api.MerxClient;
import com.merx.sdk.core.Environment;
import com.merx.sdk.model.baseline.farm.UpdateFarmRequest;
import java.util.UUID;

MerxClient merx = MerxClient.builder()
    .apiKey("{SUA_API_KEY}")
    .environment(Environment.SANDBOX)
    .build();

merx.farms().update(UUID.fromString("00000000-0000-0000-0000-000000000000"), UpdateFarmRequest.builder()
    .name("Fazenda Sede")
    .area("300.00")
    .build());

Parâmetros

Parâmetros de Caminho:

Nome	Descrição	Tipo	Obrigatório
farm_id	Identificador da fazenda	String	Sim

Parâmetros de Cabeçalho

Nome	Descrição	Tipo	Obrigatório
Authorization	Chave de API obtida via support-api@merx.tech	String	Sim
Content-Type	application/json	String	Sim

Respostas

• 204 - No Content

• 400 - Bad Request

{
  "messages": ["message.entidade.campo-inválido"]
}

• 401 - Unauthorized

• 404 - NotFound