Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Announcements

​
Migration of the AWS EU Sandbox (SB) Environment to Google Cloud Platform (GCP)

As part of KIBO’s ongoing commitment to providing a modernized cloud architecture that scales with your business, we are migrating our EU sandbox (SB) environment from AWS EU to Google Cloud Platform EU (GCP). Timing
The migration is scheduled for June 2, 2026, starting at 1pm US Central time. A 6-hour downtime window will be required for this migration. Impact
All AWS EU Sandbox (SB) tenants and services will be migrated to GCP.
During the migration window, the AWS EU sandbox environment (https://t100000.sb.euw1.kibocommerce.com/… )will be temporarily inaccessible. Tenant services will be intermittently available during this time.
KIBO will automatically redirect all existing environment endpoints to the GCP infrastructure following the maintenance window.

Legacy Order Performance Optimization: Orders >60 days old will become non-progressible. Client-side Actions Post-Migration
None; KIBO will automatically redirect traffic to the new infrastructure. However, if your organization uses IP whitelisting, you must add the new GCP NAT gateway addresses found in our Knowledge Base prior to the migration date to avoid service interruption.
Find more details about this migration in our Support Portal article: Action Required: AWS EU SB Migration to GCP (June 2026).
If you have questions, please contact KIBO Support.

​
Production Tenant Features

​
Catalog

  • German-Language Error Messages for Catalog Administration: The Catalog Administration API now returns error messages in German when requests are made with the Accept-Language: de header. Previously, the API returned all error messages in English regardless of the language header sent by the caller. Developers building German-language storefronts or integrations can now receive fully localized error responses — including not-found errors on products and categories, and validation errors on write operations — ensuring a consistent, language-appropriate experience for German-speaking users.

​
Fulfillment

  • Shipment Estimated Delivery Date Updated Event Enhancement: The Shipment.EstimatedDeliveryDateUpdated event is now available for subscription when a shipment’s estimated delivery date is updated.

​
Order Routing

  • New Order Routing UI Redesign- Enhancements:
    • Flexible Scenario Reordering: Reorder scenarios using drag-and-drop or by entering a rank directly. Changes are staged and applied on save, making it easier to manage large strategies.
    • Strategy Activation Guard: Strategies cannot be activated without at least one scenario. A confirmation dialog is now shown when changing Active/Inactive status.
    • Improved Filter Visibility: The Attribute column now includes entity type prefixes (e.g., Order.Total, Location.Zip Code) for better context.
    • Scenarios Pagination Control: Added an Items per page selector (10–30) with session persistence for easier navigation.

​
Production Bug Fixes

ServiceResolution
CatalogFixed an issue where a product catalog export job reported a successful completion, but the downloaded archive file was missing the products file, with no error or indication of why the file was absent. The export job now restarts in full when an interruption is detected, ensuring all resources are re-exported and the final output file is complete. A retry limit has also been introduced to prevent a stuck job from retrying indefinitely; if the job fails to complete after the configured number of attempts, it is marked as permanently failed.
CatalogFixed an issue where product detail page (PDP) entries in the XML sitemap index were significantly under-populated, with each product sub-sitemap containing only ~200 URLs instead of the expected ~2,000. This was caused by a page size cap being incorrectly applied to the internal sitemap generation process, reducing sitemap coverage to approximately 15% of the full product catalog. The sitemap generator now correctly retrieves up to 2,000 product URLs per batch, restoring full PDP coverage in the sitemap index.
CommerceFixed an issue where payment void operations failed for canceled split orders, resulting in an “Errored” payment status. The system now correctly processes these voids, ensuring payment records accurately reflect the canceled state of the order.
CommerceFixed an issue where exporting Purchase Order payment terms failed partway through, preventing the full file from being generated. The system now correctly handles individual record errors without interrupting the overall export process, ensuring the job completes successfully.
CommerceFixed an issue where processing a refund for a return resulted in the refunded item quantity being doubled. The system now ensures that the refunded quantity does not exceed the original quantity ordered.
CommerceFixed an issue where processing large volumes of customer data requests resulted in errors. The system now handles these requests reliably without interruption.
InventoryFixed an issue where using GetInventory with type=ALL_STORES and a limit parameter caused items at already-accepted locations to be dropped from the response. The system now correctly returns all items at any location that has already been accepted within the limit, regardless of when those items are encountered during processing.
Order RoutingFixed an issue where order routing was failing in scenarios where inventory was split across both distribution center and vendor locations, causing shipment creation to fail. Orders involving vendor location splits are now processed and fulfilled correctly.
Order RoutingFixed an issue where scenario filter conditions were silently cleared when navigating away from a routing rule using the breadcrumb or hamburger menu without saving.

​
Production Sandbox Features

​
Catalog

  • Shipment Rules with Attribute Support: Merchants and administrators can now create and update shipment rules that include custom attributes via the Product Admin API. The new attribute-based CRUD endpoints accept rule attribute definitions as part of the shipment rule payload, persist them correctly, and return actionable validation messages for unsupported or invalid attribute inputs. The rule evaluation and preview APIs have been updated accordingly to correctly interpret attributes when assessing rule outcomes.
  • Shorter Category Names Now Supported: The Admin UI and portal no longer enforce a minimum three-character length requirement when saving category names. Merchants working with languages such as Chinese, where semantically complete category names may be only one or two characters, can now create and save short category names without receiving a validation error. This change affects the category name input validation in the Admin portal; no backend API changes were required.
  • Improved Error Handling for Complex Search Queries: The product search service now returns an HTTP 409 Conflict response with a clear searchQueryTooComplex message key when a query exceeds the supported filter complexity threshold (for example, a filter containing more than 4,096 OR predicates). Previously, these overly complex queries produced an uninformative HTTP 500 Internal Server Error. The updated error response is consistently returned across regions and is structured to include the standard Kibo error envelope fields (errorCode, message, correlationId, MessageKey), making it easier for downstream callers to detect and handle this condition programmatically. Behavior for all other error types is unchanged.

​
Fulfillment

  • Incremental, Line-Item-Level Stock Validation: The fulfillment system now supports stock validation at the individual line-item level across multiple scanning steps. Each item is independently assigned a stock availability status (fully available, partially available, or unavailable) when finalization is triggered, and the shipment automatically advances to the next workflow step once all items are resolved — no manual trigger required. Items can also be reset and re-validated as needed. The new behavior applies consistently across all shipment types and supports substitution workflows for line item stock validation.

​
Sandbox Bug Fixes

ServiceResolution
CatalogFixed an issue where Admin users with their browser language set to Korean saw only the Home and Help menu options upon logging in — the full Admin navigation menu was missing. The root cause was a corrupted locale file (ko.json) produced by an automated translation package that incorrectly overwrote navigation-related keys. The locale files have been corrected, and the full Admin menu is now displayed correctly for Korean-locale users. Other affected language locales were also restored as part of this fix.
CatalogFixed an issue where a line item product discount configured with a MaxRedemptionsPerOrder limit was not applied at all when a second unlimited line item discount targeted the same items. For example, when a 30%-off discount (max 1 per order) and a 10%-off discount (no limit) were both active, items at quantities of 3 or more received only the 10% discount instead of the expected optimal combination (1 item at 30% + remaining items at 10%). The tiebreaker ordering logic has been corrected so that limited discounts are evaluated and applied alongside unlimited discounts as expected.
CatalogFixed an issue where the price list associated with a customer segment was not consistently applied for logged-in users. When a user closed and reopened their browser, the segment-based price list was intermittently ignored and the site default pricing was shown instead. The resolution ensures that price list resolution is correctly persisted and restored across browser sessions, so segment-based pricing is reliably applied on every request for authenticated users.
CommerceFixed an issue during cart takeover sessions where a customer’s assigned price list reverted to the default price list, causing price validation errors upon submission. The system now correctly retains the customer’s assigned price list throughout the agent session.
FulfillmentFixed an issue where enabling the http.commerce.fulfillment.getShipment.before Arc action caused the Fulfiller UI to fail when associates attempted to accept a shipment. Shipment acceptance and other fulfiller workflows now complete successfully when Arc actions are enabled on the getShipment endpoint.