Configuración de edición de pedidos: documentación de CheckoutOS

Ajusta la edición de pedidos por el cliente con estas opciones. Controlan qué puede cambiar, cuándo y cómo.

Plazo para editar pedidos

Plazo basado en tiempo

Plazo temporal

{
  "edit_window": {
    "type": "time_based",
    "duration": 60,
    "unit": "minutes",
    "start_from": "order_placed",
    "display_countdown": true
  }
}

Plazo basado en estado

Plazo por estado

{
  "edit_window": {
    "type": "status_based",
    "allow_until": ["unfulfilled"],
    "close_on": ["in_progress", "fulfilled", "shipped"],
    "max_hours": 48
  }
}

Plazo híbrido

{
  "edit_window": {
    "type": "hybrid",
    "time_limit": {
      "hours": 24
    },
    "status_limit": {
      "close_on": ["in_progress"]
    },
    "rule": "first_reached"
  }
}

Acciones permitidas

Permisos de acciones

{
  "allowed_actions": {
    "add_items": {
      "enabled": true,
      "max_items": 5,
      "max_value": 200,
      "require_payment": true
    },
    "remove_items": {
      "enabled": true,
      "min_items_remaining": 1,
      "refund_method": "original_payment"
    },
    "change_quantity": {
      "enabled": true,
      "max_per_item": 10
    },
    "update_shipping_address": {
      "enabled": true,
      "same_country_only": false,
      "recalculate_shipping": true
    },
    "update_shipping_method": {
      "enabled": true,
      "allow_upgrades": true,
      "allow_downgrades": false
    },
    "apply_discount_code": {
      "enabled": false
    },
    "cancel_order": {
      "enabled": true,
      "full_refund": true
    }
  }
}

Restricciones de productos

Excluye ciertos productos de la edición:

Restricciones de productos

{
  "product_restrictions": {
    "non_editable_products": {
      "by_tag": ["final-sale", "custom-made", "perishable"],
      "by_type": ["Gift Card", "Subscription"],
      "by_collection": ["clearance"],
      "by_sku_prefix": ["CUSTOM-", "LTD-"]
    },
    "restrict_action": {
      "add": false,
      "remove": true,
      "quantity_change": true
    },
    "message": "This item cannot be modified"
  }
}

Restricciones de pedidos

{
  "order_restrictions": {
    "min_order_value": 0,
    "max_order_value": 1000,
    "exclude_orders_with": {
      "tags": ["wholesale", "custom"],
      "discount_codes": ["EMPLOYEE"],
      "shipping_methods": ["local_pickup"]
    },
    "exclude_payment_methods": ["cash_on_delivery"],
    "international_orders": {
      "allow_edits": true,
      "address_changes": false
    }
  }
}

Configuración de pagos

{
  "payment": {
    "additional_charges": {
      "enabled": true,
      "method": "original_payment_method",
      "fallback": "request_new_payment",
      "min_charge": 0.50
    },
    "refunds": {
      "enabled": true,
      "method": "original_payment_method",
      "timing": "immediate",
      "partial_allowed": true
    },
    "price_changes": {
      "use_original_price": true,
      "apply_original_discounts": true,
      "tax_recalculation": true
    }
  }
}

Compatibilidad de métodos de pago

Algunos métodos, como PayPal o compra ahora y paga después, pueden no admitir cobros adicionales. Configura una alternativa para esos casos.

Configuración de la interfaz

{
  "ui": {
    "theme": "match_store",
    "branding": {
      "logo": true,
      "colors": "inherit"
    },
    "edit_page": {
      "show_order_summary": true,
      "show_savings": true,
      "show_edit_history": false,
      "confirmation_step": true
    },
    "messages": {
      "success": "Your order has been updated!",
      "add_item_prompt": "Want to add anything else?",
      "window_closing": "Hurry! Edit window closes in {{time}}"
    }
  }
}

Configuración de notificaciones

Notificaciones

{
  "notifications": {
    "customer": {
      "channels": ["email"],
      "events": {
        "edit_confirmed": true,
        "edit_failed": true,
        "window_closing_soon": {
          "enabled": true,
          "minutes_before": 15
        }
      }
    },
    "merchant": {
      "channels": ["email", "slack"],
      "events": {
        "order_modified": true,
        "order_cancelled": true,
        "high_value_edit": {
          "enabled": true,
          "threshold": 100
        }
      },
      "email": "orders@yourstore.com",
      "slack_webhook": "https://hooks.slack.com/..."
    }
  }
}

Prevención del fraude

Configuración de fraude

{
  "fraud_prevention": {
    "require_email_verification": {
      "enabled": true,
      "for_actions": ["cancel", "address_change"]
    },
    "rate_limiting": {
      "max_edits_per_order": 3,
      "cooldown_minutes": 5
    },
    "suspicious_activity": {
      "flag_multiple_address_changes": true,
      "flag_high_value_additions": true,
      "threshold": 200
    },
    "audit_logging": {
      "enabled": true,
      "log_ip_address": true,
      "log_user_agent": true
    }
  }
}

Configuración de integraciones

Integraciones

{
  "integrations": {
    "fulfillment_service": {
      "notify_on_edit": true,
      "cancel_pick_on_edit": true
    },
    "inventory_management": {
      "realtime_stock_check": true,
      "reserve_added_items": true
    },
    "analytics": {
      "track_edit_events": true,
      "google_analytics": true,
      "segment": false
    }
  }
}

Buenas prácticas

Consejos de configuración

Empieza con restricciones — Activa las funciones gradualmente
Protege pedidos de alto valor — Fija umbrales de revisión
Supervisa señales de fraude — Activa todos los registros al principio
Coordina con preparación de pedidos — Ajusta el plazo a los horarios de recogida de artículos
Prueba casos especiales — Cambios parciales, cancelaciones, etc.

Temas relacionados

Activar la edición de pedidos

Guía de configuración

Más información

Panel de análisis

Sigue las métricas de edición

Más información