{"openapi":"3.1.0","info":{"title":"NextCommerce API","description":"Plataforma e-commerce argentina para marcas de indumentaria y retail: tienda online propia sin comisiones por venta, integraciones ERP, pagos, envíos y marketing digital.\n\nMachine-readable NextCommerce developer API for agents and integrators.\nUse least-privilege OAuth scopes from the securitySchemes section.","version":"1.0.0","contact":{"name":"NextCommerce Developers","email":"info@nextcommerce.com.ar","url":"https://www.nextcommerce.com.ar/developers"}},"servers":[{"url":"https://www.nextcommerce.com.ar","description":"Production"},{"url":"https://www.nextcommerce.com.ar","description":"Sandbox (request key at /developers/sandbox)"}],"tags":[{"name":"Contact","description":"Public contact intake"},{"name":"Catalog","description":"Platform catalog (sandbox/production)"},{"name":"Orders","description":"Platform orders (sandbox/production)"},{"name":"Stock","description":"Inventory (sandbox/production)"},{"name":"Customers","description":"Customers (sandbox/production)"},{"name":"Webhooks","description":"Webhook management"}],"paths":{"/api/send-email":{"post":{"tags":["Contact"],"summary":"Submit a contact / demo request","operationId":"sendContactEmail","security":[{"oauth2":["contact:write"]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","email","company","phone","message"],"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"company":{"type":"string"},"phone":{"type":"string"},"socialMedia":{"type":"string"},"website":{"type":"string"},"message":{"type":"string"},"formStartedAt":{"type":"number","description":"Client timestamp ms; anti-bot"},"fax":{"type":"string","description":"Honeypot; leave empty"}}}}}},"responses":{"200":{"description":"Accepted"},"400":{"description":"Validation error"},"429":{"description":"Rate limited"}}}},"/api/v1/catalog/products":{"get":{"tags":["Catalog"],"summary":"List products (sandbox/platform)","operationId":"listProducts","security":[{"oauth2":["catalog:read"]}],"responses":{"200":{"description":"Product list"},"401":{"description":"Unauthorized"},"403":{"description":"Missing catalog:read scope"}}}},"/api/v1/orders":{"get":{"tags":["Orders"],"summary":"List orders","operationId":"listOrders","security":[{"oauth2":["orders:read"]}],"responses":{"200":{"description":"Order list"},"401":{"description":"Unauthorized"}}},"post":{"tags":["Orders"],"summary":"Create order","operationId":"createOrder","security":[{"oauth2":["orders:write"]}],"responses":{"201":{"description":"Created"},"401":{"description":"Unauthorized"}}}},"/api/v1/stock":{"get":{"tags":["Stock"],"summary":"Read stock levels","operationId":"getStock","security":[{"oauth2":["stock:read"]}],"responses":{"200":{"description":"Stock levels"}}},"patch":{"tags":["Stock"],"summary":"Update stock levels","operationId":"updateStock","security":[{"oauth2":["stock:write"]}],"responses":{"200":{"description":"Updated"}}}},"/api/v1/customers":{"get":{"tags":["Customers"],"summary":"List customers","operationId":"listCustomers","security":[{"oauth2":["customers:read"]}],"responses":{"200":{"description":"Customer list"}}}},"/api/v1/webhooks":{"post":{"tags":["Webhooks"],"summary":"Register webhook","operationId":"createWebhook","security":[{"oauth2":["webhooks:manage"]}],"responses":{"201":{"description":"Registered"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Sandbox or production API key. Request sandbox keys at /developers/sandbox."},"oauth2":{"type":"oauth2","description":"OAuth 2.0 with named scopes. Prefer least privilege. See /.well-known/oauth-protected-resource.","flows":{"clientCredentials":{"tokenUrl":"https://www.nextcommerce.com.ar/oauth/token","scopes":{"contact:write":"Submit contact and demo requests","catalog:read":"Read product catalog","orders:read":"Read orders","orders:write":"Create or update orders","stock:read":"Read inventory","stock:write":"Update inventory","customers:read":"Read customers","webhooks:manage":"Manage webhooks"}},"authorizationCode":{"authorizationUrl":"https://www.nextcommerce.com.ar/oauth/authorize","tokenUrl":"https://www.nextcommerce.com.ar/oauth/token","scopes":{"contact:write":"Submit contact and demo requests","catalog:read":"Read product catalog","orders:read":"Read orders","orders:write":"Create or update orders","stock:read":"Read inventory","stock:write":"Update inventory","customers:read":"Read customers","webhooks:manage":"Manage webhooks"}}}}}}}