Atualizar Endereço do Armazém

Descrição: Atualiza os dados de endereço de um armazém a partir do id do armazém.

Endpoint

PUT/api/v1/integration/warehouses/{warehouse_id}/address

Regras

Atributos	Descrição	Tipo	Obrigatório	Validações
warehouse_id	Identificador do Armazém	UUID	Sim	-
street	Rua	String	Sim	Até 250 caracteres
number	Número	String	Sim	Apenas números. Até 10 caracteres
complement	Complemento	String	Não	Até 100 caracteres
neighborhood	Bairro	String	Sim	Até 100 caracteres
zip_code	CEP	String	Sim	CEP com "-"
city	Cidade	String	Sim	Até 100 caracteres
state	Estado	String	Sim	Até 2 caracteres
country	Pais	String	Sim	Até 50 caracteres

Exemplo de Requisição

cURL

curl -X PUT \
  -H "Authorization: {SUA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "street": "Av. das Indústrias",
    "number": "1000",
    "complement": "Galpão 3",
    "neighborhood": "Distrito Industrial",
    "zip_code": "78705-060",
    "city": "Sorriso",
    "state": "MT",
    "country": "Brasil"
  }' \
  "https://api.merx.tech/api/v1/integration/warehouses/{warehouse_id}/address"

Java

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

String body = "{\"street\": \"Av. das Indústrias\", \"number\": \"1000\", \"complement\": \"Galpão 3\", \"neighborhood\": \"Distrito Industrial\", \"zip_code\": \"78705-060\", \"city\": \"Sorriso\", \"state\": \"MT\", \"country\": \"Brasil\"}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.merx.tech/api/v1/integration/warehouses/{warehouse_id}/address"))
    .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/warehouses/{warehouse_id}/address',
  {
    method: 'PUT',
    headers: {
      'Authorization': '{SUA_API_KEY}',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      street: 'Av. das Indústrias',
      number: '1000',
      complement: 'Galpão 3',
      neighborhood: 'Distrito Industrial',
      zip_code: '78705-060',
      city: 'Sorriso',
      state: 'MT',
      country: 'Brasil',
    }),
  }
);
console.log(response.status);

Python

import requests

url = "https://api.merx.tech/api/v1/integration/warehouses/{warehouse_id}/address"

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

payload = {
    "street": "Av. das Indústrias",
    "number": "1000",
    "complement": "Galpão 3",
    "neighborhood": "Distrito Industrial",
    "zip_code": "78705-060",
    "city": "Sorriso",
    "state": "MT",
    "country": "Brasil"
}

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

Parâmetros

Parâmetros de Caminho:

Nome	Descrição	Tipo	Obrigatório
warehouse_id	Identificador do Armazém	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
street	Rua	String	Sim
number	Número	String	Sim
complement	Complemento	String	Não
neighborhood	Bairro	String	Sim
zip_code	CEP	String	Sim
city	Cidade	String	Sim
state	Estado	String	Sim
country	Pais	String	Sim

Respostas

• 204 - No Content

• 400 - Bad Request

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

• 401 - Unauthorized

• 404 - NotFound