UPS

Integração UPS — envios, tracking, consumíveis (supplies), operação de armazém e custos logísticos no HUB.

Prioridade: alta — âmbito produto + APIs

Credenciais: Não armazenes passwords de portais UPS (ID login, Quantum View, Dashboard parceiro, Supplies) nem contas em código, repositório ou tickets. Para automação usa apenas OAuth2 / chaves de API no servidor (UPS_CLIENT_ID, UPS_CLIENT_SECRET, etc.). Se passwords foram partilhadas por canais inseguros, altera-as de imediato nos respetivos sites UPS.

UPS ID — login Quantum View (outbound) Dashboard parceiro (dashboardlink) Pedido supplies (OSA) Catálogo APIs (developer) Consumíveis HUB (packaging) Envio e entregas Encomendas Shopify (HUB)

Âmbito de integração (levantamento operacional)

Responsáveis pelo processo (reunião online ou sessão presencial no armazém): Inês — Field armazém (dia a dia, picking, fulfillment, etiquetas); Rebecca — diretora comercial (fluxo comercial e clientes/fornecedores); support@madeinmarket.eu — pré/pós-venda, exceções de envio, claims, reembolsos e alfândegas (contacto interno: David Geiter).

Estas pessoas devem cobrir: processo diário de armazém, picking, packing, criação de etiquetas, despacho, retornos, claims, exceções de entrega, importações e comunicação a clientes.

Contactos comerciais UPS (referência)

1. Shipping

  • Criação de envios UPS, impressão de etiquetas
  • Associação a encomendas no HUB e à Shopify

2. Tracking

  • Tracking automático, estado de entrega, exceções, alertas de falhas

3. Operação armazém

  • Picking, packing, despacho, retornos, claims, importações

4. Supplies UPS

  • Pedido de consumíveis (automatização alinhada com /consumiveis): caixas, Express Pak, Express Box, rolos térmicos

5. Dashboard logística

  • Envios diários, custos, SLA de entregas, taxa de falhas

Dados a integrar

  • Tracking number, estado, custos, serviço, peso, dimensões, cliente

Exportação (requisitos)

  • CSV: envios, tracking, custos · XLSX: análise logística · PDF: relatório de envios

Benefícios

  • Centralização UPS, automação de envios, tracking, controlo de custos, gestão de exceções, ligação ao armazém

As ferramentas abaixo expõem Locator e Paperless via API. Shipping completo, custos agregados e dashboard operacional seguem nas fases seguintes após o levantamento com a equipa.

Catálogo APIs ↗ Locator API ↗ Paperless API ↗

0
Envios ativos
0
Em trânsito
0
Entregues hoje
—
Tempo médio entrega

Tracking rápido

Locator — pontos UPS / Access Point

Procura locais próximos (drop-off, retalho, Access Point). Requer OAuth2 no servidor: UPS_CLIENT_ID, UPS_CLIENT_SECRET. Testes: UPS_SANDBOX=1.

Paperless — upload de documento

Envia ficheiros para o histórico de formulários (customs). Limite típico 1 MB por ficheiro. Requer UPS_SHIPPER_NUMBER (ou UPS_ACCOUNT_NUMBER) no servidor, ou preenche abaixo.

Paperless — associar documento ao envio (image)

Operação PushToImageRepository: liga um DocumentID do upload ao tracking / envio. Formato de data UPS: AAAA-MM-DD-HH.mm.ss.

Paperless — eliminar documento

Remove um documento do Forms History pelo DocumentID devolvido no upload.

Envios recentes

TrackingDestinoEstadoData envio
Nenhum envio UPS registado.