API’s

Este módulo gere a importação, análise e encaminhamento de encomendas provenientes de múltiplos marketplaces como Worten, Fnac, KuantoKusta, entre outros. A sua principal função é fazer a ponte entre os marketplaces e o software de faturação/gestão interno.

Secção de Encomendas Recebidas

O ícone à direita permite ver os erros de importação de encomendas ou falhas na criação de documentos de faturação.

Caso não existam encomendas pendentes, o sistema exibe: “Nenhum item para apresentar”

Ícones no canto superior direito indicam a origem das integrações:

Worten, Fnac, KuantoKusta, Minha Loja, etc.

Envio de Ficheiros CSV de Encomendas

Esta secção permite a importação manual de encomendas através de ficheiros CSV:

CampoDescrição
Escolher ficheiroSeleciona um ficheiro CSV de encomendas.
Enviar CSV da WortenProcessa o ficheiro selecionado, fazendo parsing e validação imediata.
⚠️ Mensagem de alertaInforma que o processamento ocorre no momento da submissão e que erros surgem automaticamente no ecrã se existirem.

Editor de Parsing (Mapeamento de CSV)

Esta poderosa ferramenta permite personalizar a forma como os ficheiros CSV são interpretados:

CaracterísticasDescrição
Variáveis por MarketplaceControla a visibilidade/ativação de parsing por origem ($SHOW_WORTEN, $SHOW_FNAC, etc).
Função LerLinha()Extrai dados por índice com base no cabeçalho CSV fornecido.
Campos mapeáveisData de entrada, produto, cliente, estado da encomenda, cidade, morada, etc.
Campos especiaisSuporte a IVA, Motivo, Referência, Nº Encomenda, Total, e outros dados de faturação.

Este sistema oferece flexibilidade total, adaptando-se a qualquer estrutura CSV imposta por marketplaces ou ferramentas externas.

Utilização prática

  • Automatiza o fluxo de importação de encomendas com validação imediata.
  • Reduz o risco de erro ao permitir mapeamento dinâmico das colunas do CSV.
  • Permite diagnóstico rápido de falhas através do visualizador de erros.
  • Prepara os dados para envio para o software de faturação, garantindo consistência entre plataformas.