Formato do arquivo
Uma planilha com uma linha por peça. .csv, .xlsx, ou um .zip contendo uma das duas.
O pacote ZIP
exemplo.zip
├── pieces.csv ← exatamente UMA planilha, na raiz
├── images/ ← opcional: a imagem original do pedido
│ └── imagem.png
└── shapes/ ← opcional: SVG ou RC2 do contorno da peça
└── forma.svg
Exatamente uma planilha na raiz. Duas, ou nenhuma, recusa o pacote inteiro antes de ler qualquer linha.
As colunas Drawing e Shape aceitam o conteúdo inline ou o nome de um arquivo dentro de shapes/. O mesmo vale para OrderImage e images/.
Colunas
O separador é ponto e vírgula (;).
| Coluna | Obrigatória | Observações |
|---|---|---|
Barcode | Sim | Sua chave de negócio. Ver Visão geral |
Description | Sim | O que é a peça, em palavras de gente |
Width · Height | Sim | Em milímetros |
Thickness | Sim | Em milímetros. Aceita decimal |
Services | Sim | As operações, entre colchetes: [SERVICE_A],[SERVICE_B]. Sem ao menos uma não há roteiro de produção — salvo se a linha manda Phases (abaixo) |
GlassType | Sim | Tipo de vidro. Criada automaticamente se for nova |
CustomerName | Sim | Criado automaticamente se for novo |
DueDate | Não | O prazo, na hora da fábrica e sem fuso: AAAA-MM-DD ou AAAA-MM-DDTHH:MM[:SS] — ver abaixo. Ausente significa o dia da fábrica mais 30 dias |
Quantity | Não | Ausente significa peça avulsa |
Item | Não | A linha do pedido, para lote serial |
Cancelled | Não | True recusa a peça — ver abaixo |
CustomerOrder · InternalOrder | Não | Suas referências de pedido |
Urgent | Não | Eleva a prioridade na programação |
Notes | Não | Texto livre, que segue até o chão de fábrica |
Route | Não | Rota de entrega |
Priority | Não | Prioridade na programação, como número |
Cutouts | Não | Quantidade de recortes |
ParentBarcode | Não | Código de barras da peça pai, para peças compostas |
Shape | Não | Forma da peça em rc2. Conteúdo inline, ou o nome de um arquivo em shapes/ |
Drawing | Não | Desenho técnico (SVG). Conteúdo inline, ou o nome de um arquivo em shapes/ |
OrderImage | Não | Nome de uma imagem em images/ |
Weight | Não | O peso de uma unidade, em kg. Ausente ou vazio: o Mover.Glass calcula pela medida e pela espessura |
EdgingAllowance | Não | A aresta de lapidação, em mm, igual nos quatro lados (1,5). Veja abaixo |
EdgingAllowanceSides | Não | A aresta de lapidação por lado, em mm: quatro valores separados por hífen, topo-direita-baixo-esquerda (1,5-3-1,5-0). Veja abaixo |
Phases | Não | Os códigos de fase do ERP, no lugar de Services: CODIGO[*contagem][@marca], separados por vírgula (FL,FOR*2,TEMPCM@E). Veja abaixo |
O contrato publica os nomes em inglês acima. Os nomes antigos em português — CodigoBarra, Largura, Espessura, ServicosAplicaveis, Inativa e os demais — continuam sendo aceitos, então arquivo que você já gera segue funcionando. Os dois conjuntos podem até aparecer no mesmo cabeçalho.
Integração nova deve usar os nomes em inglês: são esses que esta página vai continuar documentando.
Desde 9 de novembro de 2026 o cabeçalho casa sem diferenciar maiúsculas nem os espaços em volta do nome (edgingallowance vale). A coluna que o leitor não conhece continua ignorada, sem aviso.
O layout .xlsx é lido por posição, não por cabeçalho. Nome de coluna em planilha é ignorado — o que vale é a ordem. Se você está começando agora, use CSV: o cabeçalho deixa o arquivo legível por uma pessoa e tolerante a coluna nova no meio do caminho.
Há três exceções, achadas pelo cabeçalho em qualquer coluna (sem diferenciar maiúsculas): o peso, Weight, a aresta de lapidação, EdgingAllowance e EdgingAllowanceSides, e as fases do ERP, Phases. Sem o cabeçalho, não são lidas. No .xlsx, só o nome Phases vale (não o apelido Fases). Se o cabeçalho Phases estiver na posição de Services (a coluna 20), ela é lida só como Phases; numa outra coluna que a planilha lê por posição (1, 4 a 9, 11, 21 a 24), o arquivo inteiro é recusado, com a coluna na mensagem.
Dentro do arquivo, separe os serviços com vírgula: [SERVICE_A],[SERVICE_B].
O arquivo em si é delimitado por ponto e vírgula, então um ; dentro de um campo vira coluna nova e desloca o resto da linha em silêncio.
Como os números são lidos
Vale para Width, Height, Thickness, Quantity, Weight e a aresta de lapidação (EdgingAllowance e cada lado de EdgingAllowanceSides), nos três formatos.
O separador decimal pode ser ponto ou vírgula — o sistema descobre qual é, em vez de exigir um formato. O que ele não faz é chutar quando chutar é impossível:
| Você manda | Vira | Por quê |
|---|---|---|
6.5 · 6,5 | 6,5 | Um separador sozinho fora da casa de milhar é o decimal |
1.234,5 · 1,234.5 | 1234,5 | Com os dois presentes, o último é o decimal. As duas convenções concordam |
1.234.567 | 1234567 | O mesmo separador repetido só pode ser agrupamento |
1.234 | REJECTED | Genuinamente ambíguo: mil duzentos e trinta e quatro, ou um vírgula duzentos e trinta e quatro? |
abc · 12mm · vazio | REJECTED | Não é número |
Três garantias que decorrem disso:
- Nada vira valor plausível. Número ilegível recusa a peça; não vira
0numa medida nem1numa quantidade. - O motivo diz qual campo, e lista todos os ruins da linha de uma vez, para a planilha ser corrigida numa passada só.
- O resultado não depende do nosso servidor. A mesma entrada é lida do mesmo jeito, independente da configuração de idioma da máquina.
1.234 querendo dizer milMande 1234. Não há como o outro lado distinguir isso de um decimal, e adivinhar é exatamente o que nos recusamos a fazer.
Quantity ausente significa peça avulsa. Quantity fracionária é recusada em vez de truncada — 2,5 peças é erro de quem gerou o arquivo, e arredondar para 2 esconderia isso.
Como o prazo é lido
O DueDate é a hora local da fábrica, sem fuso. O mesmo arquivo quer dizer a mesma coisa em qualquer servidor.
| Você manda | Resultado |
|---|---|
2026-11-10 | O dia, sem hora: a peça vence no fim desse dia, e pode sair numa carga que parte a qualquer hora desse dia |
2026-11-10T08:00 · 2026-11-10T08:00:00 · 2026-11-10 08:00 | Essa hora na fábrica |
2026-11-10T08:00:00Z · 2026-11-10T08:00:00+02:00 | REJECTED, e o reason cita o que você mandou |
O fuso escrito por nome: 2026-11-10T08:00:00 GMT · … UTC · … CET · 2026-11-10T08:00+01:00[Europe/Rome] · 2026-11-10 08:00:00 +0100 CET · 10/11/2026 08.00 cet · 2026-11-10 UTC | REJECTED, como o Z |
Uma palavra depois da hora ou da data que não é fuso: 2026-11-10 08:00 HS · … HRS · … ORE · … TURNO · 10/11/2026 N/A | CREATED com a data padrão e o warning, como a linha abaixo |
Texto que não se lê e não tem fuso: 20261110 · 2026-02-30 · 08:00 (a hora sem a data) | CREATED com a data padrão, o dia da fábrica mais 30 dias, e um warning no item que cita o que você mandou |
| vazio | O dia da fábrica mais 30 dias, sem hora, e sem warning |
Que nomes contam como fuso. Só estas siglas, em maiúsculas ou minúsculas: UTC, GMT, Z, CET, CEST, EET, EEST, WET, WEST, BST, MSK, EST, EDT, CST, CDT, MST, MDT, PST, PDT, BRT, BRST, ART, IST, JST, AEST, AEDT. Contam depois da hora (08:00 ou 08.00, e depois do AM ou PM) ou depois da data sem hora, também entre parênteses ou colchetes. O nome IANA conta pela área (Europe/Rome, America/…, Etc/… e as outras, também entre colchetes), e o deslocamento depois da hora também. Qualquer outra palavra é texto ilegível, e a peça entra com a data padrão e o warning. Vale também para o id de fuso do Windows (W. Europe Standard Time).
DueDate recusa a peçaConverter destruiria o sentido da data sem hora: em Roma, 2026-11-10T00:00:00Z é 01:00, não é mais meia-noite, e o prazo andaria quase um dia inteiro para trás. Até 5 de novembro de 2026, o fuso era convertido em silêncio para o relógio do servidor, e o fuso escrito por nome virava a data padrão, também em silêncio. Mande a hora local da fábrica, sem Z, deslocamento ou nome de fuso. Vale também para a data que não é ISO.
Data ilegível não recusa a peça. Recusar tiraria da produção um pedido válido por causa do prazo, então a peça entra com a mesma data padrão de um arquivo sem a coluna, e o warning diz o que chegou. Leia: o prazo com que a fábrica trabalha não é o que o seu ERP quis dizer. Até 5 de novembro de 2026, isso acontecia sem aviso nenhum.
A data que não é ISO (10/11/2026) é lida no idioma da requisição, que no Mover.Glass Connector é o português (o dia primeiro). O header Accept-Language muda a leitura: com en, 10/11/2026 é 11 de outubro, e 13/11/2026 não se lê (o mês 13), e por isso recebe a data padrão e o warning. Mande ISO: é o único formato que se lê do mesmo jeito em qualquer lugar.
A aresta de lapidação
A lapidação come um pouco de vidro de cada lado, então a peça é cortada maior e a lapidação a traz de volta à medida final. Width e Height continuam sendo a medida final — a da etiqueta, do m² e do peso. O Mover.Glass soma a aresta só ao pedir o plano de corte. As duas colunas são opcionais: o arquivo sem elas continua funcionando, e a peça usa a aresta da tipologia.
| Você manda | Resultado |
|---|---|
| As duas colunas ausentes ou vazias | A peça herda a aresta da tipologia nos quatro lados |
EdgingAllowance = 1,5 | 1,5 mm nos quatro lados; 0 não aplica |
EdgingAllowanceSides = 1,5-3-1,5-0 | Um valor por lado, topo-direita-baixo-esquerda |
| As duas, com os mesmos valores | Aceito |
| As duas, com valores diferentes | REJECTED, com as duas no reason: chutar qual vale é como o vidro sai fora de medida |
Um valor que não é número (abc, 1.234) | REJECTED, com o campo no reason — a mesma regra de Width |
Um valor negativo (-1) | REJECTED: para herdar a aresta da tipologia, deixe a coluna vazia |
Outro número de lados que quatro, ou um lado vazio (1,5-3, 1,5--3-0) | REJECTED |
A aresta herdada vale só na peça com lapidação no roteiro; o valor que você manda (ou 0) vale sempre. A peça com forma (Shape cujo contorno não é retângulo; o retângulo com furo conta como retângulo) grava a aresta, mas ainda não a usa no corte.
As fases do ERP
Em vez da lista de serviços pronta em Services, a linha pode mandar os códigos de fase do seu ERP em Phases, e o Mover.Glass os traduz em serviços pelo de-para de fases da fábrica (um dicionário de códigos e regras mantido na fábrica). A coluna é opcional: o arquivo sem ela continua funcionando.
O formato é CODIGO[*contagem][@marca], separados por vírgula: FL,FOR*2,FOR*4,TEMPCM@E. A contagem é um inteiro positivo (1 quando não vem); a marca (interna ou externa) fica como chegou, com a caixa. O código não diferencia maiúsculas. O * sozinho é reservado à fase implícita da fábrica, cujas regras valem para toda linha.
Os separadores * (contagem) e @ (marca) são provisórios: serão confirmados com os códigos de fase do seu ERP, e podem mudar se os próprios códigos usarem esses caracteres.
| Você manda | Resultado |
|---|---|
| A coluna ausente | Nada muda: a linha usa Services |
Phases preenchida e Services vazio | O de-para: a peça nasce com os serviços que ele deu, no roteiro de sempre, na ordem padrão da fábrica, e as fases ficam gravadas como chegaram. O de-para decide quais etapas a peça tem, não a ordem delas: o FixedRouting não vale para a linha que vem por Phases, e o item leva um warning quando ele veio ligado |
Phases vazia e Services preenchido | A lista pronta, como sempre |
Phases e Services preenchidos | REJECTED: é ambíguo; mande uma das duas |
Uma fase mal escrita (FL,,TEM, FOR*0, BIS@, um * na linha) | REJECTED, com Phases='…' e o motivo, junto dos números ilegíveis da linha |
| Um código que a fábrica não cadastrou | REJECTED, com os códigos no reason; eles vão para a fila de códigos a cadastrar da fábrica. Cadastrado o código, reenvie a linha |
| Um código desativado, uma regra cuja condição não se avalia, ou um código com regras e nenhuma que vale para a linha | REJECTED, com o código no reason |
| Fases que não dão nenhum serviço | REJECTED |
| Um serviço do de-para que a fábrica cadastrou duas vezes com a mesma descrição | REJECTED, com o serviço no reason |
| Fases que dão um serviço só | REJECTED pelo roteiro, como a lista pronta de um serviço só |
- Mantenha o campo
Phasesem toda linha. A linha comPhaseseServicesvazios, e a linha que termina antes do campoPhases(o gerador de CSV que corta os separadores finais), não estão nesta tabela: mande os separadores até a colunaPhases. - O material da regra (laminado ou não) é o da tipologia já cadastrada: a tipologia criada pela importação nasce monolítica, então cadastre antes as tipologias laminadas. O item leva um
warningquando a tipologia era nova. - A forma é, por enquanto, o
Shapeou oDrawingque vieram no arquivo; o retângulo que o Mover.Glass desenha pela medida não conta. Esta regra é provisória e pode mudar. O.xlsxnão tem as colunasShapeeDrawing: a peça mandada em.xlsxnunca vem com forma. - No
.xlsx,Phasesé achada pelo cabeçalho.
Peças canceladas
Cancelled=True devolve REJECTED, e nada é gravado — nem a peça, nem a tipologia ou o cliente que ela criaria.
É de propósito. Cadastrar algo que já está cancelado é ruído, e devolver CREATED para uma peça que o seu próprio sistema cancelou seria tecnicamente verdade e enganoso na prática.
Recusar não reserva nada: o código de barras continua livre. Se o cancelamento for desfeito e você reenviar a peça ativa, ela entra normalmente.
Pegar um exemplo
O Mover.Glass Connector que roda na sua instalação vem com um pacote de exemplo funcionando. O botão Send sample larga o pacote na pasta de entrada e o ciclo normal o processa — uma forma de provar o caminho de ponta a ponta sem esperar pelo seu ERP.