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
  • WorldEase (Project #29145) — consolidação US: Master → Child → Closeout no CIE

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, Paperless e o teste sandbox WorldEase via API. Dashboard operacional de custos/SLA continua em fases seguintes.

Catálogo APIs ↗ Locator API ↗ Paperless API ↗ WorldEase API ↗ Tutorial armazém

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.

WorldEase — sandbox (Project #29145)

Fluxo UPS: Master (GCCN virtual, MasterHasDocBox=0) → Child (etiqueta GIF + GCCN) → Closeout (Summary Label). Corre sempre contra CIE (wwwcie.ups.com). SoldTo é o Importer of Record, não o consumidor. No Master, ShipTo leva os dados do IOR; no Child, ShipTo é o destinatário final. Etiqueta: GIF (PDF não é aceite no Shipment Request). Portos US: Philadelphia (PHL) ou Louisville (SDF) — falta a tabela oficial (código de clearance + morada).

Envios recentes

TrackingDestinoEstadoData envio
Nenhum envio UPS registado.