Pular para o conteúdo principal

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 (;).

ColunaObrigatóriaObservações
BarcodeSimSua chave de negócio. Ver Visão geral
DescriptionSimO que é a peça, em palavras de gente
Width · HeightSimEm milímetros
ThicknessSimEm milímetros. Aceita decimal
ServicesSimAs 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)
GlassTypeSimTipo de vidro. Criada automaticamente se for nova
CustomerNameSimCriado automaticamente se for novo
DueDateNãoO 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
QuantityNãoAusente significa peça avulsa
ItemNãoA linha do pedido, para lote serial
CancelledNãoTrue recusa a peça — ver abaixo
CustomerOrder · InternalOrderNãoSuas referências de pedido
UrgentNãoEleva a prioridade na programação
NotesNãoTexto livre, que segue até o chão de fábrica
RouteNãoRota de entrega
PriorityNãoPrioridade na programação, como número
CutoutsNãoQuantidade de recortes
ParentBarcodeNãoCódigo de barras da peça pai, para peças compostas
ShapeNãoForma da peça em rc2. Conteúdo inline, ou o nome de um arquivo em shapes/
DrawingNãoDesenho técnico (SVG). Conteúdo inline, ou o nome de um arquivo em shapes/
OrderImageNãoNome de uma imagem em images/
WeightNãoO peso de uma unidade, em kg. Ausente ou vazio: o Mover.Glass calcula pela medida e pela espessura
EdgingAllowanceNãoA aresta de lapidação, em mm, igual nos quatro lados (1,5). Veja abaixo
EdgingAllowanceSidesNãoA 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
PhasesNãoOs códigos de fase do ERP, no lugar de Services: CODIGO[*contagem][@marca], separados por vírgula (FL,FOR*2,TEMPCM@E). Veja abaixo
Os nomes em português continuam funcionando

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.

Serviços usam vírgula, não ponto e vírgula

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ê mandaViraPor quê
6.5 · 6,56,5Um separador sozinho fora da casa de milhar é o decimal
1.234,5 · 1,234.51234,5Com os dois presentes, o último é o decimal. As duas convenções concordam
1.234.5671234567O mesmo separador repetido só pode ser agrupamento
1.234REJECTEDGenuinamente ambíguo: mil duzentos e trinta e quatro, ou um vírgula duzentos e trinta e quatro?
abc · 12mm · vazioREJECTEDNão é número

Três garantias que decorrem disso:

  1. Nada vira valor plausível. Número ilegível recusa a peça; não vira 0 numa medida nem 1 numa quantidade.
  2. O motivo diz qual campo, e lista todos os ruins da linha de uma vez, para a planilha ser corrigida numa passada só.
  3. O resultado não depende do nosso servidor. A mesma entrada é lida do mesmo jeito, independente da configuração de idioma da máquina.
Se o seu ERP escreve 1.234 querendo dizer mil

Mande 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ê mandaResultado
2026-11-10O 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:00Essa hora na fábrica
2026-11-10T08:00:00Z · 2026-11-10T08:00:00+02:00REJECTED, 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 UTCREJECTED, 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/ACREATED 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
vazioO 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).

Fuso no DueDate recusa a peça

Converter 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ê mandaResultado
As duas colunas ausentes ou vaziasA peça herda a aresta da tipologia nos quatro lados
EdgingAllowance = 1,51,5 mm nos quatro lados; 0 não aplica
EdgingAllowanceSides = 1,5-3-1,5-0Um valor por lado, topo-direita-baixo-esquerda
As duas, com os mesmos valoresAceito
As duas, com valores diferentesREJECTED, 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.

Ainda a confirmar

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ê mandaResultado
A coluna ausenteNada muda: a linha usa Services
Phases preenchida e Services vazioO 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 preenchidoA lista pronta, como sempre
Phases e Services preenchidosREJECTED: é 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 cadastrouREJECTED, 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 linhaREJECTED, com o código no reason
Fases que não dão nenhum serviçoREJECTED
Um serviço do de-para que a fábrica cadastrou duas vezes com a mesma descriçãoREJECTED, 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 Phases em toda linha. A linha com Phases e Services vazios, e a linha que termina antes do campo Phases (o gerador de CSV que corta os separadores finais), não estão nesta tabela: mande os separadores até a coluna Phases.
  • 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 warning quando a tipologia era nova.
  • A forma é, por enquanto, o Shape ou o Drawing que vieram no arquivo; o retângulo que o Mover.Glass desenha pela medida não conta. Esta regra é provisória e pode mudar. O .xlsx não tem as colunas Shape e Drawing: a peça mandada em .xlsx nunca 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.