01. Entradas
Entradas é a porta oficial de criação de itens no nanosap.
Hoje a origem pode ser manual ou Instagram via Geleca. O nanosap não tenta interpretar o Instagram sozinho: ele recebe do Geleca o material necessário para criar ou atualizar itens.
Origem dos dados
A conta de origem representa a vitrine observada. Cada post pode conter texto, imagem e sinais úteis sobre a peça.
O texto do post vira base para nome, descrição e valor estimado inicial. A imagem do post vira referência visual para revisão.
Na entrada manual, a pessoa cadastra a peça como se estivesse criando uma publicação de negócio: imagem, nome, descrição e valores juntos.
Criação de itens
Cada post válido se transforma em um item. Um item também pode ser criado manualmente, com nome, descrição, preço estimado, valor pago, medidas, peso, lote e fotos anexadas.
O item criado ainda não é definitivo. Ele entra como recebido e pode receber ajuste de nome, valor estimado, descrição, status e vínculo com lote.
Quando a peça ainda precisa ser publicada, ela pode carregar a tag publicacao_pendente. Essa tag não substitui o status principal; ela apenas sinaliza uma pendência operacional.
Valor pago
valor_pago é uma referência manual registrada na entrada.
Ele não substitui o rateio e não altera custo_real. Serve para ajudar a operação a lembrar quanto foi pago ou informado no momento da entrada.
Deduplicação por external_id
O campo external_id identifica o post de origem.
Se o mesmo post aparecer de novo em outra sincronização, o nanosap atualiza o item já existente em vez de criar uma duplicata.
Essa regra protege a operação de acumular itens repetidos quando a vitrine é sincronizada mais de uma vez.
Thumbnail
O campo thumb_url guarda a referência da imagem do post, quando ela existe.
Ele serve para que a pessoa revise visualmente a peça. O nanosap usa a imagem como referência, sem tratar a imagem como dado financeiro.
Itens manuais usam a primeira imagem anexada como referência visual. As imagens ficam associadas ao item e não alteram cálculo de custo, margem ou venda.
Medidas e peso
Produto físico precisa carregar dados básicos de operação: largura, altura, comprimento e peso.
Esses campos ajudam logística, revisão e publicação. Eles não alteram o rateio.
Leitura de caption
Ao importar posts ou migrar dados antigos, o nanosap tenta ler o caption para sugerir campos estruturados.
Hoje ele procura:
- preço em
R$ - largura
- altura
- comprimento
- peso
Essa leitura é uma sugestão operacional. A revisão humana continua necessária, principalmente quando um caption descreve mais de uma peça.