Marketplace Order Hook

If you're building middleware or ERP connectors that react to VTEX marketplace order changes, this covers the two delivery models: Hook for push notifications and Feed v3 for pull-based consumption. The guidance is pragmatic about when to use each (Hook for real-time systems that can handle load spikes, Feed when you control the pace), and it's clear about the tradeoffs. The hard constraints on webhook auth validation and idempotent processing are well-justified with actual code showing deduplication keys and Origin verification. One thing to know: the hook payload is minimal, just order ID and state, so you'll always need a followup GET to fetch full order data. The filter type decision tree (FromWorkflow vs FromOrders) saves you from trial and error with the API.

Install to Claude Code

npx -y skills add vtex/skills --skill marketplace-order-hook --agent claude-code