Pular para o conteúdo principal

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çaIncompatível?
Campo novo numa respostaNão — ignore o que você não usa
Campo opcional novo aceito numa requisiçãoNão
Endpoint novoNão
Um campo some ou muda de tipoSim
Um campo muda de significadoSim, e é o pior tipo — nada dá erro
Uma rota é renomeadaSim

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 em Services. As duas na mesma linha são recusadas. No .xlsx, achada pelo cabeçalho (só o nome Phases), como o Weight. 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) e EdgingAllowanceSides (um por lado, topo-direita-baixo-esquerda, separados por hífen). No .xlsx, achadas pelo cabeçalho, como o Weight. 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 DueDateAntesAgora
Z ou deslocamento: 2026-11-10T08:00:00Z, 2026-11-10T08:00:00+02:00CREATED, convertido para o relógio do servidor e gravado como a hora da fábricaREJECTED, 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êncioREJECTED, como o Z
Texto que não se lê: 20261110, 2026-02-30, 08:00CREATED com a data padrão, em silêncioCREATED 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êAntesAgora
LATEo início programado tinha passadoa 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
UNSCHEDULEDnão existia: essas etapas saíam WAITINGnova: não começou, ainda sem programação, com o prazo da peça no futuro
WAITINGtudo o que não começou e não estava atrasadosó a etapa programada e no prazo
scheduledFora hora local da fábrica com o Z: um instante 3 h antes do realo 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.

EraAgora é
/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 arquivofile
codigoBarra, desfecho, motivobarcode, outcome, reason
CRIADA, IGNORADA, RECUSADACREATED, IGNORED, REJECTED
AGUARDANDO, ATRASADA, CONCLUIDAWAITING, 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.

EraAgora é
CodigoBarraBarcode
DescricaoDescription
Largura · AlturaWidth · Height
EspessuraThickness
ServicosAplicaveisServices
TipologiaGlassType
NomeClienteCustomerName
DataFinalizacaoDueDate
QtdeQuantity
InativaCancelled
PedidoCliente · PedidoInternoCustomerOrder · InternalOrder
UrgenteUrgent
ObservacaoNotes
RotaRoute
PrioridadePadraoPriority
RecortesCutouts
PecaPaiIdParentBarcode
Rc2Shape
SVGDrawing
ImagemPedidoOrderImage

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".