Atualiza uma filial pela API do TMS

PUT/integracao/v1/filiais/{id}

Exige API key de PRODUCAO; com a chave de TESTE = 403.

Para que serve: altera os dados de uma filial.

Quando chamar: quando o nome, o endereço, o pino ou o raio mudam no TMS, ou para desativar uma filial ("ativa": false).

Parâmetros

Cabeçalhos (header)

X-Veltra-Api-Keytextoobrigatório
Chave de API do TMS. Emitida na tela Chaves de API do portal; o valor completo aparece uma única vez.
Content-Typetextoobrigatório
Sempre application/json.

Caminho (path)

idtexto (uuid)obrigatório

Respostas

200application/json

Filial atualizada

Erroapplication/problem+json

Erro no formato RFC 9457 (application/problem+json)

JSON

{
  "type": "https://exemplo.com.br/webhook-veltra",
  "title": "texto",
  "status": 1,
  "detail": "texto",
  "instance": "https://exemplo.com.br/webhook-veltra",
  "codigo": "ASAAS_RECUSOU"
}

Campos da resposta (6)

Campos

typetextoobrigatório
titletextoobrigatório
statusinteiroobrigatório
detailtextoopcional
instancetextoopcional
codigotextoopcional
Código estável do problema para o cliente decidir o tratamento (ex.: ASAAS_RECUSOU, FATURA_NAO_ENCONTRADA, PAGINACAO_INVALIDA). Ausente quando o erro não tem código próprio.

Guia explicado

O que fazer: erros

Status	Quando	O que fazer
`400`	Campo inválido (como no `POST`)	Corrigir
`401`	Chave inválida	Conferir a chave
`403`	Chave de teste ou que não é de TMS	Usar a chave de produção
`404`	A filial não existe	Conferir o `id`
`409`	A `siglaExterna` nova já é de outra filial	Escolher outra sigla

Observações

O PUT pode ser repetido sem problema (mesmo corpo, mesmo resultado).
Se você não mandar latitude e longitude, o pino atual é mantido (ele nunca é apagado por omissão, e a API não localiza endereço novo no mapa). Se não mandar raioGeofenceM, o raio atual é mantido. Se não mandar ativa, o estado atual é mantido.
Atenção: o texto do endereco é substituído pelo que você mandar. Omitido, o endereço da filial fica em branco. Mande sempre o endereço junto, mesmo que não tenha mudado.
Trocar a sigla de uma filial muda como os próximos manifestos de transferência devem citá-la.

Texto completo, com mais exemplos, em API por rota.

Requisição

Produção

https://api.veltrasolution.com

Teste

https://api-teste.veltrasolution.com

curl -X PUT 'https://api.veltrasolution.com/integracao/v1/filiais/0192f3a4-5b6c-7d8e-9f01-000000000001' \
  -H 'X-Veltra-Api-Key: SUA_CHAVE_AQUI' \
  -H 'Content-Type: application/json'

const resposta = await fetch("https://api.veltrasolution.com/integracao/v1/filiais/0192f3a4-5b6c-7d8e-9f01-000000000001", {
  method: "PUT",
  headers: {
    "X-Veltra-Api-Key": "SUA_CHAVE_AQUI",
    "Content-Type": "application/json",
  },
});

console.log(resposta.status);
console.log(await resposta.text());

import requests

resposta = requests.request(
    "PUT",
    "https://api.veltrasolution.com/integracao/v1/filiais/0192f3a4-5b6c-7d8e-9f01-000000000001",
    headers={
        "X-Veltra-Api-Key": "SUA_CHAVE_AQUI",
        "Content-Type": "application/json",
    },
    timeout=30,
)

print(resposta.status_code)
print(resposta.text)

<?php
$ch = curl_init('https://api.veltrasolution.com/integracao/v1/filiais/0192f3a4-5b6c-7d8e-9f01-000000000001');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-Veltra-Api-Key: SUA_CHAVE_AQUI',
        'Content-Type: application/json',
    ],
]);

$resposta = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
echo $resposta;
curl_close($ch);

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

public class Exemplo {
    public static void main(String[] args) throws Exception {
        HttpRequest requisicao = HttpRequest.newBuilder(URI.create("https://api.veltrasolution.com/integracao/v1/filiais/0192f3a4-5b6c-7d8e-9f01-000000000001"))
        .header("X-Veltra-Api-Key", "SUA_CHAVE_AQUI")
        .header("Content-Type", "application/json")
        .method("PUT", HttpRequest.BodyPublishers.noBody())
        .build();

        HttpResponse<String> resposta = HttpClient.newHttpClient()
            .send(requisicao, HttpResponse.BodyHandlers.ofString());

        System.out.println(resposta.statusCode());
        System.out.println(resposta.body());
    }
}

using System.Net.Http;
using System.Text;

using var cliente = new HttpClient();
var requisicao = new HttpRequestMessage(new HttpMethod("PUT"), "https://api.veltrasolution.com/integracao/v1/filiais/0192f3a4-5b6c-7d8e-9f01-000000000001");
requisicao.Headers.Add("X-Veltra-Api-Key", "SUA_CHAVE_AQUI");

var resposta = await cliente.SendAsync(requisicao);
Console.WriteLine((int)resposta.StatusCode);
Console.WriteLine(await resposta.Content.ReadAsStringAsync());

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	requisicao, err := http.NewRequest("PUT", "https://api.veltrasolution.com/integracao/v1/filiais/0192f3a4-5b6c-7d8e-9f01-000000000001", nil)
	if err != nil {
		panic(err)
	}
	requisicao.Header.Set("X-Veltra-Api-Key", "SUA_CHAVE_AQUI")
	requisicao.Header.Set("Content-Type", "application/json")

	resposta, err := http.DefaultClient.Do(requisicao)
	if err != nil {
		panic(err)
	}
	defer resposta.Body.Close()

	texto, _ := io.ReadAll(resposta.Body)
	fmt.Println(resposta.StatusCode)
	fmt.Println(string(texto))
}

Troque SUA_CHAVE_AQUI pela sua chave. O servidor de teste tem o mesmo comportamento do de produção.