# PSRESTful > PSRESTful is a REST/JSON API proxy service that lets promotional products distributors connect to their PromoStandards suppliers without implementing SOAP/XML themselves. It connects to 500+ suppliers with a free tier available. Operated by Gallardo Solutions Corp. Website: https://psrestful.com --- ## Home URL: https://psrestful.com/ PSRESTful provides a modern REST/JSON interface over the legacy PromoStandards SOAP/XML services used by the promotional products industry. Distributors can connect to 500+ suppliers through a single, unified API without building custom SOAP integrations for each supplier. ### Key Features - REST/JSON interface over legacy SOAP/XML PromoStandards services - Connect to 500+ integrated PromoStandards suppliers - CSV export for Shopify, Magento, and custom e-commerce platforms - Shopify sync via the PromoSync app - Real-time inventory tracking - Data validation and quality checks - Product search across 142k+ products from 100+ suppliers - Media processing tools: background removal, vectorization, mockup generation - Free tier available with paid plans for advanced features --- ## About Us URL: https://psrestful.com/about-us/ PSRESTful was founded by Edilio Gallardo, a software engineer with nearly 30 years of experience. He holds a Computer Science degree (1997) and has over 10 years of experience building REST/JSON services. From 2019 to 2022, he served as Lead Backend Engineer at a promotional products company where revenue grew from $5M to $53M, gaining 8+ years of deep experience in the promotional industry ecosystem. The company is operated by Gallardo Solutions Corp, founded in 2018. Core pillars: Innovation, Quality, Trust, and Custom Solutions. ### Mission Make PromoStandards accessible to every distributor through modern REST/JSON APIs, eliminating the complexity of SOAP/XML integration. --- ## Pricing URL: https://psrestful.com/pricing/ PSRESTful offers four pricing tiers: - **Free Plan**: Basic API access, data validation, public key access, glossary, discount codes reference - **Standard Plan**: Everything in Free plus Data Explorer (Basic), media downloader, Stock Check (real-time inventory by warehouse/size/color) - **Premium Plan**: Everything in Standard plus CSV Generator, Pricing Calculator, Data Explorer (Advanced with PPC), Extra APIs, Find Broken Links, PromoSync (Shopify) - **Enterprise Plan**: Everything in Premium plus Product Search, Best Sellers Report, Sales Surge Report, New Products Report, Sort Parts by Sales API, Order Status, Shipments Tracking, Invoices, Pantone Detector, Background Removal, Raster to SVG, Decorate mockup tool Contact sales for Enterprise pricing and custom requirements. --- ## Free Trial URL: https://psrestful.com/free-trial/ Every new account is automatically placed on a 14-day free trial with premium features fully enabled — no credit card required. During the trial (14 days): - **1,000 API calls per day** (vs. 10 calls/day on the standard Free tier) - **PromoSync for Shopify** fully enabled — sync live supplier stock levels and wholesale pricing to Shopify variants - **Premium APIs** enabled — Purchase Orders, Invoices, Order Status, Shipment Tracking - **CSV Catalog Exporter** enabled - **Premium Data Explorer** views enabled After day 14, the account transitions automatically to the standard Free tier (10 calls/day, basic features). Nothing is deleted, no automatic charges, and no lockout — credentials, apps, and dashboard settings are retained. Users can upgrade to Standard, Premium, Business, or Enterprise from the dashboard billing panel at any time, including during the trial. --- ## API Usage Calculator URL: https://psrestful.com/api-usage-calculator/ An interactive tool for promotional products distributors to estimate how many PromoStandards API calls their business needs and find the right PSRESTful plan. ### Calculator Sections **Inventory Monitoring** (recurring daily): - Inputs: Number of Products, Number of Suppliers, Update Frequency (hours) - Formula: (24 / update hours) × suppliers × products = calls per day - Example: 20 products × 10 suppliers, updated every 4 hours = 1,200 calls/day **Order Status Monitoring** (recurring daily): - Inputs: Number of Orders, Number of Suppliers, Update Frequency (hours) - Formula: (24 / update hours) × suppliers × orders = calls per day - For polling individual orders **Pricing Updates** (recurring weekly recommended): - Inputs: Number of Products, Number of Suppliers, Update Frequency (weeks) - Each product requires 7 API calls per update: 1 Product Data, 1 FOB Points, 2 Blank Pricing (net + list), 2 Decorated Pricing (net + list), 1 Customer Pricing - Formula: suppliers × products × 7 / (update weeks × 7 days) = calls per day **Order Status Updates via LAST_UPDATE_SEARCH** (recurring daily): - Inputs: Number of Suppliers, Update Frequency (hours) - Uses 1 API call per supplier regardless of number of orders — much more efficient than polling each order individually - Formula: (24 / update hours) × suppliers × 1 = calls per day **Product Import** (one-time per product): - Input: Number of Products - Each product requires approximately 9 API calls: 1 Product Data, 1 FOB Points (PPC), 2 Blank Pricing (PPC), 2 Decorated Pricing (PPC), 1 Customer Pricing (PPC), 1 Media Content, 1 Inventory - Formula: products × 9 = total one-time calls ### Plan Recommendations The calculator automatically recommends a plan tier based on total estimated daily usage: - **Free**: Up to 10 calls/day - **Standard**: Up to 300 calls/day - **Premium**: Up to 15,000 calls/day - **Business**: Up to 50,000 calls/day - **Enterprise**: Unlimited --- ## Changelog URL: https://psrestful.com/changelog/ A public changelog listing every update shipped to PSRESTful, grouped by month. Filterable by type: Features, Improvements, and Bug Fixes. ### Recent Highlights (March 2026) - **API Usage Calculator** — Interactive tool to estimate API calls for inventory, orders, pricing, and imports - **Send Purchase Orders** — Submit POs to suppliers via PromoStandards directly from the procurement UI - **View & Test Credentials** — Admins can view stored credentials and test them against live endpoints - **Business Plan** — New tier at $599.99/mo with 50,000 calls/day and reports - **Web Service Validator** — Test SOAP endpoints, inspect XML, convert to JSON/Protobuf - **Dark Mode** — Full dark mode across the entire site - **14-Day Trial** — New accounts get a trial with access to paid features ### Entry Types - **Feature**: New capabilities (icon: rocket, color: emerald) - **Improvement**: Enhancements to existing features (icon: sparkles, color: blue) - **Bug Fix**: Resolved issues (icon: bug, color: amber) --- ## FAQ URL: https://psrestful.com/faq/ Searchable frequently asked questions covering API access, pricing, supported suppliers, getting started with PSRESTful, and PromoStandards integration topics. Questions are organized in an accordion format with live search filtering. --- ## Integrated Suppliers URL: https://psrestful.com/integrated-suppliers/ A filterable list of 500+ PromoStandards suppliers integrated with PSRESTful. Each supplier entry shows: - Supplier name and code - Supported PromoStandards services - Whether credentials are available - Shopify-ready status - PPAI ranking Individual supplier detail pages are available at https://psrestful.com/integrated-suppliers/{supplier_code}/. --- ## Easy Integration URL: https://psrestful.com/promostandards-easy-integration-for-distributors/ ### Why REST/JSON Over SOAP/XML? - JSON is human-readable and simpler to work with than complex XML schemas - Easier to find developers experienced with REST APIs (Fiverr, Upwork, etc.) - JSON responses are typically more compact and faster to process - Aligns with Open API/Swagger documentation standards - PSRESTful acts as a seamless SOAP-to-REST/JSON proxy Case study: For an Alphabroder product, JSON response sizes are comparable or smaller than the equivalent XML, with far less parsing complexity. --- ## Unified Format URL: https://psrestful.com/promostandards-unified-format-for-distributors/ ### The Problem Different suppliers implement PromoStandards differently. Field usage varies, optional fields are inconsistent, and data structures differ between suppliers. Building a catalog requires handling each supplier's quirks individually. ### The Solution PSRESTful normalizes all supplier responses into a single consistent REST/JSON format: - Consistent data structure regardless of which supplier you query - Eliminates supplier-specific quirks and partial implementations - Clear, standardized documentation with no ambiguity about fields - Complete method coverage for all PromoStandards services - One integration layer works with all 500+ suppliers --- ## Rollout Strategy for Distributors URL: https://psrestful.com/promostandards-rollout-strategy-for-distributors/ A step-by-step PromoStandards implementation guide for distributors. ### Scenario 1: Starting Without a Website Recommended service order: Product Data + Media Content -> Pricing & Configuration -> Inventory -> Order Status -> Order Shipment Notification -> Purchase Order -> Invoice ### Scenario 2: Existing Website Recommended service order: Inventory -> Order Status -> Order Shipment Notification -> Product Data + Media Content -> Pricing & Configuration -> Purchase Order -> Invoice ### Ongoing Obligations - Regular price updates - Deactivate closeout products promptly - Frequent inventory refresh (every 4 hours recommended) - Monitor order status changes --- ## Cache Information URL: https://psrestful.com/cache-information/ PSRESTful uses on-demand caching following PromoStandards Best Practices Committee recommendations. This dramatically reduces catalog import time for large suppliers. ### Cache TTL by Service - getProductSellable: 1 day - getProduct (Product Data): 1 week - getInventoryLevels: 4 hours - getMediaContent (Media Content): 1 week - PPC methods (Pricing & Configuration): 1 week - Filter values: 1 day ### Cache Bypass Send a `Cache-Control: no-cache` header to bypass the cache and get fresh data from the supplier. ### Not Cached Transactional services (Order Status, Purchase Order, Order Shipment Notification, Invoices) are never cached. --- ## Access via Public Keys URL: https://psrestful.com/access-via-public-keys/ Use PSRESTful's public key authentication to make API calls directly from frontend JavaScript without a backend server. ### Setup 1. Generate a public key in your dashboard 2. Add allowed origins (your website domains) 3. Add `pub_api_key=YOUR_KEY` as a query parameter to API requests ### Use Cases - Display real-time inventory on product detail pages - Modify checkout logic based on live inventory data - Backoffice order status tracking - Order shipment notification lookups The public key is a 32-character token stored securely in the database. --- ## Data Validation URL: https://psrestful.com/promostandards-data-validation-explained/ A tool for PromoStandards suppliers and distributors to check data quality and compliance across Product Data and Media Content implementations. ### What It Checks - 92% of validations based on PromoStandards Best Practices documentation - Product data completeness and correctness - Media content URL validity - FOB points, locations, decorations, charges, categories, colors - Inventory level queryability - Response time performance metrics ### Features - Email notification upon validation completion - Shareable reports (no additional registration needed) - In-depth failure analysis per product - Validation history tracking Plan: Available on Free tier. --- ## Discount Codes URL: https://psrestful.com/promotional-industry-discount-codes-explained/ Explains the ABC/PQR discount code system used in the promotional products industry for volume-based pricing. ### ABC System - A = 50% discount (highest volume) - B = 45% - C = 40% - D = 35% - E = 30% - Continues through X = 0% (list price) ### PQR System - P = 50% (highest volume) - Q = 45% - R = 40% - Continues through Z = 0% (list price) ### Extended Codes - /L = 70%, /M = 65%, /N = 60%, /O = 55% Example: Buying 100-499 units at Code C = 40% discount off list price. --- ## Glossary URL: https://psrestful.com/promotional-industry-glossary/ A searchable reference of 60+ promotional products and PromoStandards terms, designed for developers implementing PromoStandards integrations. Terms are organized alphabetically with instant client-side filtering. ### Industry Organizations & Identifiers - **ASI / ASI Number**: Advertising Specialty Institute — unique IDs for suppliers and distributors, used in PromoStandards APIs - **PPAI / PPAI Number**: Promotional Products Association International — member identifiers - **SAGE**: Technology/media company providing product research databases and order management tools - **QCA**: Quality Certification Alliance — supplier compliance accreditation - **UNSPSC**: United Nations Standard Products and Services Code — product classification used in PromoStandards Product Data ### Pricing & Commerce Terms - **EQP**: End Quantity Pricing — lowest column price for all quantities - **LTM / LTM Charge**: Less Than Minimum — orders below supplier minimum, plus the associated surcharge - **Net Cost / Net Price**: Distributor's cost from supplier, before markup - **Run Charge**: Per-piece fee for decoration process - **Set-Up Charge**: One-time fee per order to prepare production equipment - **Price Type**: Net, List, or Customer pricing (returned by PPC service) - **Quantity Break / Price Break**: Tiered per-unit pricing based on order volume - **FOB / FOB Point**: Free on Board — shipping origin for freight calculations ### Decoration & Production Methods - **Imprint Method / Imprint Area**: Technique and designated area for applying logos/designs - **Screen Printing**: Ink through mesh stencil; cost depends on number of colors - **DTG**: Direct to Garment — inkjet printing on fabric, no minimums - **Embroidery**: Thread-stitched designs; pricing based on stitch count - **Sublimation**: Heat-transfer dye for vibrant full-color all-over prints - **Pad Printing**: Silicone pad transfer for irregular surfaces (pens, golf balls) - **Laser Engraving**: Laser-etched permanent imprint on metal, wood, glass - **Heat Transfer**: Design printed on transfer paper, applied with heat/pressure ### Product & Catalog Concepts - **Product ID**: Primary key for a supplier product across all PromoStandards services - **Part ID**: Granular identifier for a specific variant (color/size combination) - **SKU**: Stock Keeping Unit — typically maps to Product ID + Part ID - **CPN**: Customer Part Number — distributor-assigned product identifier - **Line Name**: Supplier's product collection grouping (e.g., 'EcoSmart', 'DryBlend') - **Apparel Size**: Standard sizing (XS–2XL+), represented as Part IDs in PromoStandards - **Product Category**: Classification taxonomy (Drinkware, Writing Instruments, Bags, Apparel, etc.) - **Hard Goods / Wearables**: Non-textile items vs. apparel and textile products ### PromoStandards Services - **PromoStandards**: Industry initiative defining SOAP/XML web service interfaces for supplier-distributor data exchange - **Product Data (PD)**: Catalog information — descriptions, categories, colors, sizes, imprint areas, packaging - **Product Pricing and Configuration (PPC)**: Pricing tiers, decoration charges, FOB points, configuration options - **Media Content (MC)**: Product images, videos, media assets with classifications and resolution details - **Inventory (INV)**: Real-time stock levels by product/part, warehouse locations, availability status - **Order Status (OS)**: Query current status of purchase orders, production milestones, estimated ship dates - **Order Shipment Notification (OSN)**: Shipment tracking — carrier, tracking numbers, delivery estimates - **Purchase Order (PO)**: Electronic order submission with line items, decoration details, drop-ship addresses - **Invoice**: Electronic invoicing with line items, charges, taxes, payment terms ### Technical Integration Terms - **SOAP**: Simple Object Access Protocol — XML-based messaging protocol used by PromoStandards endpoints - **WSDL**: Web Services Description Language — XML schema defining service operations and message formats - **Endpoint**: URL where a supplier hosts a specific PromoStandards service version - **Service Version**: Versioned interfaces (e.g., Product Data 2.0.0); suppliers may support multiple versions - **Media Classification**: Tags for media assets — Product Image, Lifestyle Image, Virtual Sample, Decoration Image - **Available to Sell**: Current purchasable inventory quantity (distinct from total warehouse stock) - **Third Party / Drop Ship Address**: End recipient shipping address for supplier-direct fulfillment Plan: Available on Free tier (all registered accounts). --- ## Credentials & Supplier Status Explained URL: https://psrestful.com/credentials-and-supplier-status-explained/ Explains the meaning of "Supported" and "Credentials Available" on PSRESTful's integrated suppliers page, and clarifies which PromoStandards services use shared (agent) credentials vs. your own distributor credentials. ### Key Concepts - **Supported**: The supplier's PromoStandards endpoints are configured and verified on PSRESTful. - **Credentials Available**: Gallardo Solutions has obtained agent credentials from the supplier, enabling catalog data access out of the box. ### Two Types of Credentials **Agent / Shared Credentials** (work out of the box): - Product Data — full product catalog - Media Content (MED) — product images & documents - Pricing & Configuration (PPC) — net & list prices only - Inventory (INV) — real-time stock levels **Your Own Credentials** (required for customer-specific data): - Customer Price (PPC) — your negotiated pricing - Purchase Order (PO) — placing orders - Order Status (ODRSTAT) — tracking your orders - Order Shipment Notification (OSN) — shipment updates - Invoice (INVC) — your invoices ### Why the Distinction? Public catalog data (products, images, list prices, inventory) is the same for all distributors, so shared credentials work. Customer-specific transactional data (your pricing, orders, invoices) requires your own credentials so the supplier knows who is making the request. ### How to Get Your Own Credentials Request them via promostandards.org/standards-endpoints by searching for the supplier and using the "Request Authentication Credentials" form. Follow up directly if no response within 3 business days. --- ## Configure Supplier Credentials URL: https://psrestful.com/configure-supplier-credentials-explained/ Step-by-step dashboard guide for entering your own PromoStandards supplier credentials. By default PSRESTful uses shared agent credentials for public catalog data (products, media, net/list prices, stock); your own credentials unlock customer-specific pricing, purchase orders, order status, and invoices. Important: Never email credentials. Plain-text email is insecure and delays setup. Enter them yourself in the encrypted dashboard. ### Setup Steps 1. Go to the Credentials Dashboard at https://psrestful.com/dashboard/configure-credentials/ 2. Click the "+ One Credential" button (top-right) to open the encrypted credentials modal. 3. Select the supplier, scroll to the Production Environment card, enter your supplier-issued Username/ID and Password, then click Submit. Staging is optional and only used for testing Purchase Orders in a sandbox. 4. Test the credentials: find the supplier in the table and click the Run Test (Play) icon under Actions. The tester verifies your keys against the supplier's live servers in real time. ### Service-Specific Credentials Some suppliers issue separate keys per service (e.g. one set for Inventory, another for Purchase Orders). Click "Show Services" under the credentials column to add per-endpoint username/password overrides without changing your default keys. ### Dashboard Tools - **Import CSV**: bulk upload with columns Code, StagingUsername, StagingPassword, ProductionUsername, ProductionPassword - **Download All**: export a CSV backup of registered credentials - **Delete All**: irreversibly remove all custom credentials and return to defaults ### FAQ Highlights - Endpoints can fail with default keys if the supplier requires service-specific keys; add overrides via "Show Services". - Verify credentials with Run Test, no API code required. - Staging (STG) is only needed for testing Purchase Orders; otherwise configure Production (PROD) only. Plan: Available to all plans. --- ## Stock Check URL: https://psrestful.com/stock-check-explained/ Real-time inventory lookup across all supplier warehouse locations. Search products by name or SKU, select a color variant, and view a warehouse-by-size inventory grid showing exact stock levels at each location. ### Key Features - Search products from any supplier with PromoStandards Inventory (INV) service - Warehouse-level inventory breakdown (v2.0.0 suppliers) or total quantities (v1.2.1 suppliers) - Size-by-color grid: see stock for every size (XS through 4XL+) at every warehouse - Color selector: swatches when hex values are available, dropdown otherwise - Bypass cache option to query suppliers directly for freshest data - Available to Customer Support users for real-time client support - Shareable URLs for specific product/color inventory views ### Use Cases - Customer support answering "Is it in stock?" during client calls - Sales reps confirming availability before quoting large orders - Operations checking which warehouse has stock closest to the shipping destination - Verifying size availability before committing to apparel orders Plan: Standard and above. --- ## Data Explorer URL: https://psrestful.com/data-explorer-explained/ Browse supplier data across PromoStandards services in real time. ### Supported Services - **Product Data**: Product details, parts, colors, sizes, categories - **Media Content (MED)**: Product images, videos, documents - **Pricing & Configuration (PPC)**: Prices, decorations, charges (Advanced version, Standard Plan+) - **Inventory (INV)**: Real-time inventory levels ### Versions - **Basic** (Product, MED, INV): Included in Standard Plan - **Advanced** (adds PPC): Requires Premium Plan or higher Works with your own supplier credentials or PSRESTful's read-only credentials. Plan: Standard (Basic) / Premium (Advanced). --- ## CSV Generator URL: https://psrestful.com/csv-generator-explained/ Export product catalogs for major e-commerce platforms. ### Supported Formats - Shopify Product CSV - Shopify Inventory CSV - Shopify MinMaxfy (minimum/maximum quantity enforcement) - Magento CSV - PS-JSON (raw structured data) - Custom format ($500 one-time fee, or free for select platforms with contributor help) ### Filters - Supplier, category, product IDs - Price type, currency - Configuration type: Decorated or Blank - Import tag and status (Draft/Active) Powered by Product Data v2.0.0 and Media Content v1.1.0. Real-world example store: SwagPath.com (Shopify). Plan: Premium. --- ## Media Downloader URL: https://psrestful.com/media-downloader-explained/ Bulk download all product images and media resources for a supplier. ### How It Works - Downloads all images, videos, audio files, and documents for a supplier's product catalog - Resources are downloaded in batches of 50 - Generates a single ZIP file for download ### Use Cases - Replace images in existing Shopify stores - Fix bad algorithmic imports with proper product images - Fill missing images in your catalog - Prepare images for background removal or vectorization Access from Data Explorer > MED > Download All. Plan: Standard and above. --- ## Find Broken Links URL: https://psrestful.com/promostandards-find-broken-links-media-content-for-suppliers/ Detect broken image and media URLs in a PromoStandards supplier's Media Content service. Scans every media URL (product images, videos, PDFs, documents) for a given supplier and generates a downloadable CSV report. ### How It Works 1. Select a supplier (only suppliers you have access to — via PSRESTful's shared agent credentials or your own) 2. Select report format: URLs Only, or Product Part + URL 3. Click Detect ### CSV Report Formats - **URLs Only**: Simple flat list of every broken URL — ideal for sending to suppliers - **Product Part URL**: Includes product ID and part ID alongside each broken URL — ideal for tracking affected listings ### Who Uses This - Distributors auditing supplier media quality before catalog sync - Suppliers proactively fixing broken media URLs - E-commerce teams running pre-import audits for Shopify, Magento, or custom storefronts - QA teams tracking media health over time Plan: Premium. --- ## Pricing Calculator URL: https://psrestful.com/pricing-calculator-explained/ Accurately calculate product costs including parts, decorations, and quantity tiers. ### Features - Support for multiple order lines in a single calculation - Handles parts (products), decorations (imprint methods), and quantity-based pricing tiers - For developers: test cost calculation algorithms against live supplier data ### Vision Generate Purchase Order payloads automatically from pricing calculations, promoting electronic Purchase Orders in the promotional industry. Plan: Premium. --- ## Extra APIs URL: https://psrestful.com/extra-apis-explained/ Additional REST APIs provided by PSRESTful beyond core PromoStandards services. ### Endpoints - **Product Endpoint**: Search, filter, and sort 142k+ products from popular suppliers with pagination - **Supplier Endpoint**: List all suppliers with name/code, filter by credentials available and Shopify-ready status - **Brand Endpoint**: List all brands, filter by supplier - **ETS API**: Master Carton shipping data API documentation: https://api.psrestful.com/docs#/Extra Plan: Premium. --- ## Product Search URL: https://psrestful.com/promotional-industry-product-search-explained/ Search and filter 142k+ products from 100+ suppliers. ### Search Options - Search by: Name, Product ID, SKU, or GTIN - Filters: Supplier, On Demand, Rush Available, Brand, Apparel Style - Price range, Lead Time, Minimum Quantity filters ### Features - Batch select for bulk CSV export - Inline product detail preview - Direct export to CSV Generator Plan: Enterprise. --- ## Best Sellers Report URL: https://psrestful.com/promotional-industry-best-sellers-report-explained/ Identify top-performing products by estimated sales across 30+ suppliers. ### Features - Filter by time period, category, supplier - Columns: estimated sales, categories, list prices, estimated revenue - Export directly to CSV Exporter for Shopify, Magento, or custom formats ### Benefits - Optimize inventory by stocking proven winners - Save time on product research - Data-driven product selection Plan: Enterprise. --- ## Sales Surge Report URL: https://psrestful.com/promotional-industry-sales-surge-report-explained/ Detect products experiencing sudden demand spikes by comparing sales estimates across time periods. ### How It Works - Compares current X days vs previous X days of estimated sales - Configurable surge threshold percentage (e.g., 500%+ constitutes a surge) - Filter by supplier - Results at product + part granularity ### Benefits - Early trend detection before competitors notice - Drive targeted marketing campaigns - Optimize inventory for surging items - Enhance supplier negotiations with data Example: Identified Ariel Premium Supply products surging 1,840% to 3,166% in sales. Plan: Enterprise. --- ## New Products Report URL: https://psrestful.com/promotional-industry-new-products-report-explained/ Discover newly launched supplier products and import them to your store quickly. ### Features - Filter by supplier and time period - Shows: Product ID, Name, Creation Date, Effective Date, Category, List Price - Copy product IDs directly into CSV Exporter for Shopify/Magento upload ### Integration Works with Best Sellers Report, Sales Surge Report, and Product Search to give a complete picture of market opportunities. Example: Identified 83 new Alphabroder products in 30 days, imported and live in store within minutes. Plan: Enterprise. --- ## Sort Parts by Sales API URL: https://psrestful.com/promotional-industry-sort-parts-by-sales-api-explained/ Reorder product parts/variants by estimated sales so best-selling colors and sizes appear first in your store. ### API Endpoint `GET https://psrestful.com/extra/v1/products/:extra_id/sorted-parts?days=60` ### Parameters - `extra_id`: Product identifier - `days`: Time period for sales data (default: 60) ### Use Cases - **Backend**: Use in a cron job to periodically refresh part ordering in your store - **Frontend**: Use with Public Key feature for real-time dynamic variant ordering - Increases conversions by highlighting popular variants Plan: Enterprise (also available in PromoSync app). --- ## Order Status URL: https://psrestful.com/order-status-ui-explained/ Check purchase order status across suppliers without manual communication. ### Query Types - PO_SEARCH: Search by Purchase Order number - SO_SEARCH: Search by Sales Order number - LAST_UPDATE_SEARCH: Find recently updated orders - ALL_OPEN_SEARCH: View all open orders ### Results - PO Number, Factory Order Number, Status Name - Expected Ship and Delivery Dates - Additional Explanation text - Link to shipment tracking for completed orders Plan: Enterprise. --- ## Shipments Tracking URL: https://psrestful.com/shipments-tracking-ui-explained/ Real-time visibility into order shipment details. ### Query Types - PO_SEARCH: Search by Purchase Order number - SO_SEARCH: Search by Sales Order number - SHIP_DATE_SEARCH: Search by shipment date (pre-filled options: today to last 7 days) ### Results - PO Number, SO Number - Ship From/To Addresses - Package details: tracking number, carrier, dimensions, weight, shipment method - Per-line: product ID, quantity, PO line number Plan: Enterprise. --- ## Invoices URL: https://psrestful.com/invoices-ui-explained/ Retrieve and review supplier invoices without logging into multiple supplier portals. ### Query Types - PO_NUMBER: Search by Purchase Order number - INVOICE_NUMBER: Search by Invoice number - DATE: Search by date - AVAILABLE_DATE_TIME: Search by availability date (pre-filled options: today to last 7 days) ### Results - Summary: Invoice #, Type, Date, PO Number, Bill To, Amount Due - Detail view: Financial Summary, Payment Info, Addresses, Tax Breakdown, Line Items, Comments, Document/Payment Links - Supports Production and Staging environments Plan: Enterprise. --- ## Pantone Detector URL: https://psrestful.com/pantone-detector-ui-explained/ Identify Pantone color matches from uploaded product images. ### How It Works 1. Upload an image 2. Specify number of top colors to detect 3. Click Detect Returns top N Pantone colors with HEX values, Pantone names, and color percentage in the image. ### Benefits - Ensures brand color accuracy across promotional materials - Reduces errors in printing and production - Quick identification of exact Pantone matches Plan: Enterprise. --- ## Remove Background URL: https://psrestful.com/remove-background-ui-explained/ Remove white backgrounds from product images to create clean transparent PNGs. ### How It Works 1. Upload a product image 2. Click "Remove it" 3. Download the transparent PNG result Accessible via both UI and API. Commonly used to clean up supplier product images that come with white backgrounds. Plan: Enterprise. --- ## Raster to SVG URL: https://psrestful.com/raster-to-svg-ui-explained/ Convert raster images (JPEG/PNG) to scalable vector graphics (SVG). ### How It Works 1. Upload a PNG or JPEG 2. System converts to vector automatically 3. Preview the result 4. Download the SVG ### Use Cases - Promotional merchandise logos for screen printing and embroidery - E-commerce product image customization - Artwork that needs to scale for web and print Plan: Enterprise. --- ## Decorate URL: https://psrestful.com/decorate-ui-explained/ Auto-generate product mockups by placing uploaded artwork onto product images. ### How It Works 1. Upload artwork (PNG/JPG) 2. Choose a product 3. Click "Decorate It" The system automatically generates mockups for each available product color variant, with artwork positioned and resized correctly. No manual Photoshop work required. Plan: Enterprise. --- ## PromoSync Shopify App URL: https://promosync-docs.psrestful.com/ PromoSync is a Shopify app for syncing PromoStandards product catalogs directly into your Shopify store. Full documentation is available at the PromoSync docs site. ### Key Features - Import products directly into Shopify from PSRESTful's Product Finder - Automated or manual pricing updates — automated mode syncs prices from supplier PromoStandards feeds - Variant management — colors, sizes, and options mapped to Shopify variants with correct SKUs - Product tracking — links Shopify product IDs to PromoStandards part IDs for accurate syncing ### How It Works 1. Connect your Shopify store from your PSRESTful dashboard 2. Browse supplier products using the Product Finder 3. Select products and import them to Shopify with one click 4. PromoSync keeps pricing and product data updated automatically Plan: Premium. --- ## E-Commerce Integration Pages PSRESTful provides dedicated landing pages for importing supplier and brand products into Shopify and Magento. ### Supplier + Shopify URL pattern: https://psrestful.com/integrated-suppliers/{supplier_code}/Shopify Explains how to import and sync a specific supplier's products into Shopify using PromoSync. Covers: - CSV Exporter vs PromoSync comparison (PromoSync recommended for Shopify) - Step-by-step PromoSync workflow - What gets synced: product data, variants, automated pricing, product tracking - Shows whether the supplier is Shopify-ready ### Supplier + Magento URL pattern: https://psrestful.com/integrated-suppliers/{supplier_code}/Magento Explains how to import a specific supplier's products into Magento using the CSV Exporter. Covers: - 4-step import workflow (sign up → CSV Exporter → configure → upload) - What's included in the export: product data, images, pricing tiers, variants - FAQ about Magento versions, subset exports, re-export frequency ### Brand + Shopify URL pattern: https://psrestful.com/extra/brands/{brand_slug}/Shopify Explains how to import and sync a brand's products (across multiple suppliers) into Shopify using PromoSync. Same structure as supplier Shopify pages but brand-focused, showing all suppliers carrying that brand. ### Brand + Magento URL pattern: https://psrestful.com/extra/brands/{brand_slug}/Magento Explains how to import a brand's products into Magento via CSV Exporter. Uses the generic brand CSV detail template with Magento-specific steps. --- ## Privacy Policy URL: https://psrestful.com/privacy-policy/ Last updated: March 2, 2026. Operated by Gallardo Solutions Corp. ### Data Collected - Account information (via Auth0) - Billing data (via Stripe) - API usage logs - Contact form submissions - Cookies ### Third-Party Providers Auth0, Stripe, AWS, SendGrid, Google Analytics/GTM, LogRocket, reCAPTCHA, Fly.io, Slack, OpenAI ### Data Storage US-based (AWS us-east-1) ### Retention - Account data: 90 days after closure - API logs: 12 months - Billing records: 7 years ### User Rights Access, correction, deletion, opt-out. GDPR rights for EEA/UK. CCPA rights for California residents. PSRESTful does not sell personal information. Contact: support@psrestful.com --- ## Terms of Use URL: https://psrestful.com/terms-of-use/ ### Key Terms - **Services & Access**: Limited license for API and platform use. No reselling, reverse engineering, or competitive product building. - **Payments**: Fees are non-cancelable and non-refundable. Late payment: 1.5%/month finance charge. - **Intellectual Property**: PSRESTful retains all platform IP. Users retain ownership of uploaded artwork. - **Warranties**: Service provided "AS IS". - **Liability**: No consequential damages. Maximum aggregate liability: fees paid in prior 6 months or $100. - **Governing Law**: State of New Jersey. Disputes via JAMS binding arbitration. Class action waiver. - **Confidentiality**: Mutual non-disclosure obligations. Contact: support@psrestful.com, +1 (786) 390-3345