Criar uma nova Fazenda

Descrição: Criar uma nova Fazenda.

Endpoint

POST/api/v1/integration/farms/-/producers/{producer_id}

Regras

Atributos	Descrição	Tipo	Obrigatório	Validações
producer_id	Identificador da Companhia Produtora	UUID	Sim	-
car	Cadastro Ambiental Rural	String	Sim	Verifica se é válido
state_subscription	Inscrição estadual	String	Não	Formato: inscrição-Estado. Ex: 123456-MS
name	Nome	String	Sim	Permite até 255 caracteres
own	Tipo de propriedade	Boolean	Sim	true para própria, false para alugada
registration	Número de matricula	String	Não	Até 256 caracteres
area	Área da fazenda	String	Não	-

Exemplo de Requisição

cURL

curl -X POST \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "car": "MT-5107925-A1B2C3D4E5F6G7H8I9J0K1L2M3N4",
    "name": "Fazenda Boa Vista",
    "own": true,
    "state_subscription": "123456-MT",
    "registration": "REG-001",
    "area": "1500.00"
  }' \
  "https://api.merx.tech/api/v1/integration/farms/-/producers/{PRODUCER_ID}"

Java

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

String body = "{\"car\": \"MT-5107925-A1B2C3D4E5F6G7H8I9J0K1L2M3N4\", \"name\": \"Fazenda Boa Vista\", \"own\": true, \"state_subscription\": \"123456-MT\", \"registration\": \"REG-001\", \"area\": \"1500.00\"}";

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

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

JavaScript

const response = await fetch(
  'https://api.merx.tech/api/v1/integration/farms/-/producers/{PRODUCER_ID}',
  {
    method: 'POST',
    headers: {
      'Authorization': '{SUA_API_KEY}',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      car: 'MT-5107925-A1B2C3D4E5F6G7H8I9J0K1L2M3N4',
      name: 'Fazenda Boa Vista',
      own: true,
      state_subscription: '123456-MT',
      registration: 'REG-001',
      area: '1500.00',
    }),
  }
);
const data = await response.json();
console.log(data);

Python

import requests

url = "https://api.merx.tech/api/v1/integration/farms/-/producers/{PRODUCER_ID}"

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

payload = {
    "car": "MT-5107925-A1B2C3D4E5F6G7H8I9J0K1L2M3N4",
    "name": "Fazenda Boa Vista",
    "own": True,
    "state_subscription": "123456-MT",
    "registration": "REG-001",
    "area": "1500.00"
}

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

Parâmetros

Parâmetros de Caminho:

Nome	Descrição	Tipo	Obrigatório
producer_id	Identificador da Companhia Produtora	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

Parâmetros do Corpo

Nome	Descrição	Tipo	Obrigatório
car	Cadastro Ambiental Rural	String	Sim
name	Nome da fazenda	String	Sim
own	Tipo de propriedade (própria/alugada)	Boolean	Sim
state_subscription	Inscrição estadual	String	Não
registration	Número de matrícula	String	Não
area	Área da fazenda	String	Não

Respostas

• 200 - Ok

{
    "id": "string"
}

• 400 - Bad Request

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

• 401 - Unauthorized