{"openapi":"3.1.0","info":{"title":"HANIX Business API","version":"1.0.0","description":"API para integradores con autenticación HMAC. Base URL: /api/v1. PSP con credenciales: GET /business/merchant-payment-settings/psp-methods (solo backend). Checkout UI: GET /business/checkout/psp-methods (sin credenciales)."},"servers":[{"url":"https://api.hanix.io/api/v1"}],"tags":[{"name":"Órdenes de pago"},{"name":"Checkout — Pago"},{"name":"PSP — Configuración (solo backend)"},{"name":"Catálogo — Gestión"},{"name":"Checkout — Carrito"},{"name":"Checkout — Pedidos"},{"name":"Referencia"},{"name":"Tienda"},{"name":"Webhooks"},{"name":"Envíos"},{"name":"Catálogo — Storefront"}],"components":{"securitySchemes":{"BusinessHmac":{"type":"apiKey","in":"header","name":"business-signature","description":"Firma HMAC-SHA256 con cabeceras business-merchant-id, business-timestamp y business-signature."}}},"paths":{"/business/payment-orders":{"post":{"operationId":"createPaymentOrder","summary":"Create Payment Order","description":"Crea una orden de pago. Con items[] opcional calcula montos desde el catálogo (sin sales_order).","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"get":{"operationId":"listPaymentOrders","summary":"List Payment Orders","description":"Lista órdenes del comercio.","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/payment-orders/{payment_order_id}":{"get":{"operationId":"getPaymentOrder","summary":"Get Payment Order","description":"Detalle de una orden por UUID.","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/payment-orders/{payment_order_id}/attempts":{"post":{"operationId":"createPaymentAttempt","summary":"Create Payment Attempt","description":"Crea un intento de pago y devuelve datos de checkout del PSP.","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"get":{"operationId":"listPaymentOrderAttempts","summary":"List Payment Order Attempts","description":"Intentos de pago de una orden.","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/payment-orders/{payment_order_id}/cancel":{"post":{"operationId":"cancelBusinessPaymentOrder","summary":"Cancel Payment Order","description":"Cancela una orden de pago del comercio.","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/payment-orders/{payment_order_id}/checkout":{"get":{"operationId":"getBusinessPaymentOrderCheckout","summary":"Get Payment Order Checkout","description":"Vista enriquecida para UI de checkout: métodos PSP, intentos, contexto legal Wompi.","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/payment-orders/by-public-token/{public_token}/checkout":{"get":{"operationId":"getBusinessPaymentOrderCheckoutByPublicToken","summary":"Get Payment Order Checkout By Public Token","description":"Vista enriquecida de checkout por public_token (solo órdenes del comercio autenticado).","tags":["Órdenes de pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/checkout/psp-methods":{"get":{"operationId":"listBusinessCheckoutPspMethods","summary":"List Checkout PSP Methods","description":"Métodos PSP con required_fields para formulario de pago (sin credenciales). Usar en checkout del comprador — no confundir con merchant-payment-settings/psp-methods.","tags":["Checkout — Pago"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-payment-settings/psp-methods":{"get":{"operationId":"listMerchantPspMethods","summary":"List Merchant PSP Methods (config)","description":"Configuración PSP del comercio (credenciales, webhooks). Solo backend — nunca en frontend del comprador.","tags":["PSP — Configuración (solo backend)"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/categories":{"get":{"operationId":"listCatalogCategories","summary":"List Categories","description":"Lista categorías del catálogo.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/categories/bulk":{"put":{"operationId":"upsertCatalogCategories","summary":"Upsert Categories Bulk","description":"Crea o actualiza categorías en lote.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"delete":{"operationId":"deleteCatalogCategories","summary":"Delete Categories Bulk","description":"Elimina categorías por id.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/categories/images/direct-uploads":{"post":{"operationId":"requestCatalogCategoryImageDirectUploads","summary":"Category Image Direct Uploads","description":"Solicita URLs de subida directa a Cloudflare.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/categories/images/bulk":{"put":{"operationId":"registerCatalogCategoryImages","summary":"Register Category Images Bulk","description":"Registra imágenes de categoría ya subidas.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"delete":{"operationId":"deleteCatalogCategoryImages","summary":"Delete Category Images Bulk","description":"Quita imágenes de categorías.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/currencies":{"get":{"operationId":"listCatalogCurrencies","summary":"List Catalog Currencies","description":"Monedas disponibles para productos del comercio.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/products":{"post":{"operationId":"createCatalogProduct","summary":"Create Product","description":"Crea un producto con al menos una variante obligatoria.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"get":{"operationId":"listCatalogProducts","summary":"List Products","description":"Lista productos con filtros y paginación.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/products/{product_id}":{"get":{"operationId":"getCatalogProduct","summary":"Get Product","description":"Detalle de producto con variantes e imágenes.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"patch":{"operationId":"updateCatalogProduct","summary":"Update Product","description":"Actualiza nombre, slug, categoría, estado, etc.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/products/bulk":{"delete":{"operationId":"deleteCatalogProducts","summary":"Delete Products Bulk","description":"Elimina productos por id.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/products/{product_id}/variants/{variant_id}":{"patch":{"operationId":"updateCatalogProductVariant","summary":"Update Product Variant","description":"Actualiza SKU, precio, stock, opciones, etc.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/products/{product_id}/variants/{variant_id}/warehouse-stock":{"patch":{"operationId":"setCatalogVariantWarehouseStock","summary":"Set Variant Warehouse Stock","description":"Stock físico en almacén (solo panel / integraciones).","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/variants/bulk":{"put":{"operationId":"upsertCatalogVariants","summary":"Upsert Variants Bulk","description":"Crea o actualiza variantes en lote.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"delete":{"operationId":"deleteCatalogVariants","summary":"Delete Variants Bulk","description":"Elimina variantes por id.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/images/direct-uploads":{"post":{"operationId":"requestCatalogImageDirectUploads","summary":"Product Image Direct Uploads","description":"Solicita URLs de subida directa para imágenes de producto.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/images/bulk":{"put":{"operationId":"registerCatalogImages","summary":"Register Product Images Bulk","description":"Registra imágenes de producto ya subidas.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"patch":{"operationId":"updateCatalogImages","summary":"Update Product Images Bulk","description":"Actualiza imágenes de producto (isPrimary = imagen de tarjeta, variantId, altText, sortOrder).","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"delete":{"operationId":"deleteCatalogImages","summary":"Delete Product Images Bulk","description":"Elimina imágenes de producto por id.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/merchant-catalog/inventory/adjustments/bulk":{"post":{"operationId":"adjustCatalogInventory","summary":"Adjust Inventory Bulk","description":"Ajusta inventario de variantes en lote.","tags":["Catálogo — Gestión"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/cart/quote":{"post":{"operationId":"quoteBusinessCart","summary":"Quote Cart","description":"Cotiza sin persistir y devuelve discount_in_cents, applied_coupon, tax_in_cents y taxes[] calculados por el servidor.","tags":["Checkout — Carrito"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders":{"post":{"operationId":"createBusinessSalesOrder","summary":"Create Sales Order","description":"Crea el pedido con cupón e impuestos del servidor; devuelve discount_in_cents y tax_in_cents (applied_coupon y taxes[] se consultan en quote).","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"get":{"operationId":"listBusinessSalesOrders","summary":"List Sales Orders","description":"Lista pedidos con discount_in_cents y tax_in_cents; applied_coupon y taxes[] pertenecen al quote previo.","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders/{sales_order_id}":{"get":{"operationId":"getBusinessSalesOrder","summary":"Get Sales Order","description":"Detalle con discount_in_cents y tax_in_cents; usa quote para el detalle applied_coupon y taxes[].","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders/{sales_order_id}/pay":{"post":{"operationId":"payBusinessSalesOrder","summary":"Pay Sales Order","description":"Crea o reutiliza una orden de pago y devuelve payment_url.","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders/{sales_order_id}/tracking":{"get":{"operationId":"getBusinessSalesOrderTracking","summary":"Get Sales Order Tracking","description":"Seguimiento de envío de un pedido de venta.","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders/{sales_order_id}/invoice":{"get":{"operationId":"getBusinessSalesOrderInvoice","summary":"Get Sales Order Invoice","description":"Factura o comprobante de un pedido de venta.","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders/{sales_order_id}/cancel":{"post":{"operationId":"cancelBusinessSalesOrder","summary":"Cancel Sales Order","description":"Cancela un pedido de venta si su estado lo permite.","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders/{sales_order_id}/fulfillment":{"patch":{"operationId":"changeBusinessSalesOrderFulfillment","summary":"Change Sales Order Fulfillment","description":"Actualiza estado de fulfillment, tracking y foto de envío del pedido.","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/sales-orders/{sales_order_id}/refund":{"post":{"operationId":"refundBusinessSalesOrder","summary":"Refund Sales Order","description":"Reembolsa un pedido de venta y repone inventario si aplica.","tags":["Checkout — Pedidos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/countries":{"get":{"operationId":"listBusinessCountries","summary":"List Countries","description":"Países activos del sistema (formularios de envío).","tags":["Referencia"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/currencies":{"get":{"operationId":"listBusinessCurrencies","summary":"List System Currencies","description":"Monedas del sistema.","tags":["Referencia"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/store/settings":{"get":{"operationId":"getBusinessStoreSettings","summary":"Get Store Settings","description":"Configuración de tienda: modo checkout, WhatsApp, logos, envío.","tags":["Tienda"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/webhooks/settings":{"get":{"operationId":"getBusinessWebhookSettings","summary":"Get Webhook Settings","description":"URL de webhook configurada para el comercio.","tags":["Webhooks"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"put":{"operationId":"updateBusinessWebhookSettings","summary":"Update Webhook Settings","description":"Actualiza la URL de webhook (HTTPS, anti-SSRF).","tags":["Webhooks"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/shipping/settings":{"get":{"operationId":"getBusinessShippingSettings","summary":"Get Shipping Settings","description":"Peso por defecto y divisor volumétrico para cotización de envío.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"put":{"operationId":"updateBusinessShippingSettings","summary":"Update Shipping Settings","description":"Actualiza configuración de envíos del comercio.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/shipping/zones":{"get":{"operationId":"listBusinessShippingZones","summary":"List Shipping Zones","description":"Zonas de envío con tarifas del comercio.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"post":{"operationId":"createBusinessShippingZone","summary":"Create Shipping Zone","description":"Crea una zona de envío por país.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/shipping/zones/{zone_id}":{"put":{"operationId":"updateBusinessShippingZone","summary":"Update Shipping Zone","description":"Actualiza una zona de envío.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"delete":{"operationId":"deleteBusinessShippingZone","summary":"Delete Shipping Zone","description":"Elimina una zona de envío.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/shipping/zones/{zone_id}/rates":{"post":{"operationId":"createBusinessShippingRate","summary":"Create Shipping Rate","description":"Crea una tarifa de envío en una zona.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/shipping/zones/{zone_id}/rates/{rate_id}":{"put":{"operationId":"updateBusinessShippingRate","summary":"Update Shipping Rate","description":"Actualiza una tarifa de envío.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"delete":{"operationId":"deleteBusinessShippingRate","summary":"Delete Shipping Rate","description":"Elimina una tarifa de envío.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/shipping/package-profiles":{"get":{"operationId":"listBusinessShippingPackageProfiles","summary":"List Package Profiles","description":"Perfiles de empaque del comercio.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"post":{"operationId":"createBusinessShippingPackageProfile","summary":"Create Package Profile","description":"Crea un perfil de empaque.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/shipping/package-profiles/{profile_id}":{"put":{"operationId":"updateBusinessShippingPackageProfile","summary":"Update Package Profile","description":"Actualiza un perfil de empaque.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}},"delete":{"operationId":"deleteBusinessShippingPackageProfile","summary":"Delete Package Profile","description":"Elimina un perfil de empaque.","tags":["Envíos"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/catalog/products/search":{"get":{"operationId":"searchBusinessCatalogProducts","summary":"Search Catalog Products","description":"Búsqueda de productos públicos del catálogo storefront.","tags":["Catálogo — Storefront"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/catalog/products/search/facets":{"get":{"operationId":"getBusinessCatalogProductSearchFacets","summary":"Get Catalog Product Search Facets","description":"Facetas de búsqueda de productos públicos.","tags":["Catálogo — Storefront"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/catalog/products/by-slug/{slug}":{"get":{"operationId":"getBusinessCatalogProductBySlug","summary":"Get Catalog Product By Slug","description":"Detalle de producto público por slug.","tags":["Catálogo — Storefront"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}},"/business/catalog/categories":{"get":{"operationId":"listBusinessCatalogCategories","summary":"List Catalog Categories","description":"Listado público de categorías del catálogo storefront.","tags":["Catálogo — Storefront"],"security":[{"BusinessHmac":[]}],"responses":{"200":{"description":"OK"},"201":{"description":"Creado"},"204":{"description":"Sin contenido"},"401":{"description":"HMAC inválido o ausente"},"404":{"description":"Recurso no encontrado"},"409":{"description":"Conflicto de estado o referencia"},"422":{"description":"Payload inválido"}}}}}}