Changelog
Tudo que mudou no v1, do mais recente para o mais antigo.
O que conta como mudança incompatível
Só mudança incompatível força uma versão nova. Esta é a linha:
| Mudança | Incompatível? |
|---|---|
| Campo novo numa resposta | Não — ignore o que você não usa |
| Campo opcional novo aceito numa requisição | Não |
| Endpoint novo | Não |
| Um campo some ou muda de tipo | Sim |
| Um campo muda de significado | Sim, e é o pior tipo — nada dá erro |
| Uma rota é renomeada | Sim |
Mudança incompatível vira v2, e o v1 continua no ar. Você nunca deveria ter que migrar no mesmo momento em que o seu servidor é atualizado.
18/09/2026 — rotas e campos em inglês
Mudança incompatível, e a única que acontecerá sem virar v2. Até hoje o único consumidor desta API era o nosso próprio Connector, no mesmo repositório, então a renomeação não custou nada a ninguém. Depois que você escrever código contra ela, uma mudança dessas vira v2.
| Era | Agora é |
|---|---|
/api/v1/integracao/conexao | /api/v1/integration/connection |
/api/v1/integracao/pecas/arquivo | /api/v1/integration/pieces/import |
/api/v1/integracao/situacao | /api/v1/integration/production-status |
campo multipart arquivo | file |
codigoBarra, desfecho, motivo | barcode, outcome, reason |
CRIADA, IGNORADA, RECUSADA | CREATED, IGNORED, REJECTED |
AGUARDANDO, ATRASADA, CONCLUIDA | WAITING, LATE, DONE |
POST /api/v1/integracao/pecas foi removido. O endpoint de peça unitária não tinha consumidor. Se você precisar mandar peça a peça em vez de por arquivo, peça — ele volta como endpoint documentado, não por acidente.
Os nomes das colunas do CSV também são inglês, e os em português continuam funcionando.
| Era | Agora é |
|---|---|
CodigoBarra | Barcode |
Descricao | Description |
Largura · Altura | Width · Height |
Espessura | Thickness |
ServicosAplicaveis | Services |
Tipologia | GlassType |
NomeCliente | CustomerName |
DataFinalizacao | DueDate |
Qtde | Quantity |
Inativa | Cancelled |
PedidoCliente · PedidoInterno | CustomerOrder · InternalOrder |
Urgente | Urgent |
Observacao | Notes |
Rota | Route |
PrioridadePadrao | Priority |
Recortes | Cutouts |
PecaPaiId | ParentBarcode |
Rc2 | Shape |
SVG | Drawing |
ImagemPedido | OrderImage |
Nada quebra. Todo nome da esquerda continua aceito, então arquivo que você já gera segue funcionando — os dois conjuntos podem até dividir o mesmo cabeçalho. Use os em inglês no que for novo: são esses que esta documentação vai continuar descrevendo.
O layout .xlsx é lido por posição, então ali não mudou nada.
18/09/2026
Número com vírgula é lido corretamente. Uma medida escrita 6,5 estava sendo lida como 65, porque a vírgula era tratada como separador de milhar. Afeta espessura, largura, altura e quantidade, nos três formatos de arquivo.
Número ilegível agora recusa a peça com motivo, em vez de virar 0 numa medida ou 1 numa quantidade. Ver como os números são lidos.
Se o seu sistema manda 1.234 querendo dizer mil duzentos e trinta e quatro, esse valor passa a ser recusado como ambíguo — mande 1234.
Espessura fracionária funciona em planilha. Arquivos Excel liam a espessura como número inteiro, então vidro de 6,5 mm não podia ser importado de jeito nenhum, nem escrito com ponto.
17/09/2026
Peça cancelada é recusada em vez de criada ativa. Inativa=True era lido do arquivo e depois descartado: a peça era criada ativa, ganhava roteiro de produção e entrava no plano de corte, enquanto a resposta dizia CREATED.
Agora devolve REJECTED e não grava nada — nem a peça, nem a tipologia ou o cliente que ela criaria. Ver peças canceladas.
O prazo que o seu sistema manda é preservado. Peça criada pelo endpoint unitário tinha a dataFinalizacao sobrescrita com o momento da requisição. Um pedido para o fim do ano nascia vencido no mesmo dia.
Os dois separadores de serviço são aceitos. O endpoint unitário exigia ponto e vírgula, enquanto a própria mensagem de recusa mostrava vírgula. Agora os dois funcionam.
16/09/2026
A superfície de integração foi publicada, com as garantias descritas aqui: uma chave de API por instalação, três desfechos por peça, e transação própria por peça na importação de arquivo.
Antes disso, um reenvio devolvia sucesso em silêncio, sem como distinguir "criada" de "já existia".