Shipping integration
Labels, tracking, and carrier APIs for seamless delivery
Overview
Current state
Sellers handle shipping independently, no tracking in-app.
Target state
- In-app shipping label generation
- Real-time tracking updates
- Multiple carrier support
- Shipping cost calculator
Tech stack
- Carriers: Correios, Jadlog, Loggi (Brazil)
- Aggregator: Melhor Envio or Frenet API
- Tracking: Webhooks + polling
- Labels: PDF generation
Features
For sellers
- Generate shipping labels in-app
- Compare carrier rates
- Schedule pickups
- Print labels at home or drop-off
For buyers
- Real-time tracking updates
- Delivery estimates
- Push notifications on status changes
- Proof of delivery
For platform
- Shipping cost at checkout
- Delivery time estimates
- Lost package claims
- Analytics on delivery times
Architecture
Rate calculation
Label generation
Tracking updates
Implementation
Rate calculator
Integrate Melhor Envio API, add shipping calculator on item page, and CEP validation.
Label generation
Build seller shipping flow with label generation, download, and pickup scheduling.
Tracking
Create tracking page for orders, webhook integration, and push notifications.
Advanced features
Add insurance options, return labels, and lost package claims.
Checklist
Infrastructure
- Melhor Envio account and API keys
- Webhook endpoint for tracking
- Tracking events table
Seller flow
- Shipping label generation UI
- Carrier selection
- Label download/print
- Pickup scheduling
Buyer flow
- Shipping cost at checkout
- Tracking page
- Status notifications
- Delivery confirmation
Admin
- Shipping analytics
- Dispute handling
- Lost package claims