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.
09/11/2026 — as fases do ERP
Aditiva. O arquivo que não manda a coluna nova não vê mudança.
- Uma coluna opcional,
Phases: os códigos de fase do seu ERP (CODIGO[*contagem][@marca], separados por vírgula), traduzidos em serviços pelo de-para de fases da fábrica, no lugar da lista pronta emServices. As duas na mesma linha são recusadas. No.xlsx, achada pelo cabeçalho (só o nomePhases), como oWeight. A regra está no formato do arquivo. - Os separadores
*e@são provisórios, a confirmar com os códigos do seu ERP. - O código que a fábrica não cadastrou recusa a linha, com os códigos no
reason; reenvie a linha depois que a fábrica o cadastrar.
09/11/2026 — a aresta de lapidação, e o cabeçalho sem diferenciar maiúsculas
Aditiva. O arquivo que não manda as colunas novas não vê mudança no que manda; a peça usa a aresta da tipologia.
- Duas colunas opcionais:
EdgingAllowance(o mesmo valor nos quatro lados) eEdgingAllowanceSides(um por lado, topo-direita-baixo-esquerda, separados por hífen). No.xlsx, achadas pelo cabeçalho, como oWeight. A regra está no formato do arquivo. - O cabeçalho do CSV casa sem diferenciar maiúsculas nem os espaços em volta do nome. A coluna que antes era ignorada pela caixa agora é lida.
05/11/2026 — fuso no DueDate é recusado
Mudança incompatível para o arquivo que manda fuso, sem v2, por decisão do dono da fábrica. O arquivo que manda a hora local da fábrica, como os exemplos e o Mover.Glass Connector, não vê mudança.
Você manda no DueDate | Antes | Agora |
|---|---|---|
Z ou deslocamento: 2026-11-10T08:00:00Z, 2026-11-10T08:00:00+02:00 | CREATED, convertido para o relógio do servidor e gravado como a hora da fábrica | REJECTED, com o reason citando o texto |
O fuso escrito por nome: … GMT, … UTC, … CET, …+01:00[Europe/Rome] | CREATED com a data padrão, em silêncio | REJECTED, como o Z |
Texto que não se lê: 20261110, 2026-02-30, 08:00 | CREATED com a data padrão, em silêncio | CREATED com a data padrão e um warning no item, citando o texto |
O warning é um campo novo no item, que você pode ignorar. Mande AAAA-MM-DD ou AAAA-MM-DDTHH:MM[:SS], na hora da fábrica. A regra está em formato do arquivo.
20/10/2026 — a situação da etapa segue a régua da fábrica
Mudança incompatível, sem v2, por decisão do dono da fábrica. Três situações mudam de significado, uma é nova e o scheduledFor anda 3 h. Os valores antigos estavam errados (veja abaixo), e um v2 manteria os errados vivos. Nada na resposta HTTP avisa: leia isto antes da implantação.
| O quê | Antes | Agora |
|---|---|---|
LATE | o início programado tinha passado | a etapa programada vai terminar depois da data em que precisa estar pronta (ou o agora já passou dela); a etapa sem programação, depois que o prazo da peça venceu. O lote dividido é LATE se qualquer parte que não começou está atrasada, mesmo com outra parte na máquina, já passada ou no terceiro |
UNSCHEDULED | não existia: essas etapas saíam WAITING | nova: não começou, ainda sem programação, com o prazo da peça no futuro |
WAITING | tudo o que não começou e não estava atrasado | só a etapa programada e no prazo |
scheduledFor | a hora local da fábrica com o Z: um instante 3 h antes do real | o instante real, em UTC |
As 3 horas. A hora local da fábrica era comparada com o UTC: o LATE saía 3 h cedo, e o scheduledFor mostrava um instante 3 h antes do real. Se você somava 3 h ao scheduledFor para compensar, pare no dia da implantação.
Se você gerou um enum a partir da lista antiga de situações, acrescente UNSCHEDULED, ou trate situação desconhecida como informativa. A régua inteira está em situação da produção.
18/09/2026 — rotas e campos em inglês
Mudança incompatível, feita sem virar v2. Até aquele dia 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 — as únicas exceções desde então são a situação da etapa e o fuso no DueDate (as entradas acima), por decisão do dono da fábrica.
| 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".