🥯
Everything
  • Best Practices and Guidelines
    • ChatGPT Prompts
    • Documentation Guideline
    • GitBook Spaces
    • GitHub Guideline
    • Internal Usage
  • Tools
    • End to End Order Flow
      • Order Creation
      • Order Import
      • Order Brokering
      • Order Fulfillment
      • Order Fulfillment Notification
    • Git
      • How to Create Issue on Git
    • Jira
      • Feature Request on Jira
    • Launchpad
      • Fulfillment
        • Stuck Orders in Fulfillment App
      • Job Manager
        • Check Job Frequencies
        • Job Runtime Error
        • Mismatch Time Zone
    • Napita
      • Glossary
      • Schedule Processors
      • View and Manage Processors
      • Flow Definitions
      • Verify Processor Properties
      • Bulletins
      • Data Provenance
      • Troubleshooting
        • Data Export Errors
        • Queue Errors
        • Fetch Put SFTP Retry
    • Netsuite
      • Managing Saved Searches
    • Ofbiz
      • Orders
        • Multicurrency Sales Orders
        • POS Order Refresh Failure
        • Pre-Order Catalog Sync
        • Reindex Order after Solr Down Time
      • Products
        • Product Duplication
      • Inventory
        • Add New Variance Reason
      • Data Manager Configuration
        • Create a Job Using Data Manager Configuration
        • SFTP Issue
    • Shopify
      • How to Access Shopify POS APP
      • How to Create Draft Order in Shopify
    • Tathya
      • Database Configuration
        • Additional Settings
      • Charts Creation
        • Selecting Database & Schema
        • View & Save Chart
        • Charts Access
        • Create Multiple Charts
        • LogInsight Charts
      • Understanding Dashboards
        • Configuring Dashboards
        • Dashboards Access
        • Dashboard Options
        • Dashboard Customizations
        • Link Configuration
        • Set Multi-Day Filters
      • Configuring Alerts & Reports
        • Creating Alerts
        • Creating Reports
        • Alternate Interfaces to Schedule Reports
      • Creating Roles
        • List & Modify Roles
      • Creating User
        • Creating LDAP Account
        • Tathya Authentication
        • Listing User in Tathya
        • User Permissions
      • Troubleshoting
        • Reporting Discrepancies
        • Tathya login Issue
      • How to
        • How to Create User on Tathya
        • How to Create Alpha Role on Tathya
        • How to Request for the Report
  • Client Communication
    • Templated Replies
    • Ticket and Release Mangemnet
  • Monitoring
    • Sanity Checklist
    • System Monitoring Guide
  • Hotwax Deployment & Versions
    • HotWax Commerce Deployment
    • Launch Machine
    • Update OMS Version
    • Rollback OMS Version
    • Optional Plugins
Powered by GitBook
On this page
  • Troubleshooting Steps
  • Step 1: Cancel the Order
  • Step 2: Remove the Order ID from Entities
  • Step 3: Re-import the Order by ID in OMS
Edit on GitHub
Export as PDF
  1. Tools
  2. Ofbiz
  3. Orders

POS Order Refresh Failure

This document provides steps to resolve the "POS Order Refresh Failure" issue in Hotwax Commerce OMS.

PreviousOrdersNextPre-Order Catalog Sync

Last updated 8 months ago

In HotWax Commerce, "POS orders" are downloaded as fulfilled from Shopify. Occasionally, an order is downloaded into the OMS before it is marked fulfilled in Shopify. Retailers must refresh these orders to update their status, ensuring the fulfilled version of the order is downloaded while cancelling the older version.

Orders may fail to refresh due to missing shipping addresses, triggering this error: Could not complete the createOrderContactMech process: The following required parameter is missing: [createOrderContactMech.contactMechId].

Follow these steps to resolve these errors:

Troubleshooting Steps

Step 1: Cancel the Order

  1. Log in to OMS: Use your username and password to log in to Hotwax Commerce OMS.

  2. Navigate to Sales Orders: Click the hamburger navbar icon if the left slider is not visible. Go to Sales Orders under Order Management in the left slider.

  3. Identify the Order: Find the order exhibiting the error. Open the order by clicking on its ID.

  4. Cancel the Order: On the order page, click the Cancel button at the top.

Step 2: Remove the Order ID from Entities

  1. Access Webtools’ Entity Engine: Use the link: https://{instance}.hotwax.io/webtools/control/entitymaint.

  2. Remove the Order from Entities:

    • Open the OrderItem entity and remove the order.

      • Open the OrderItem entity; a form will open.

      • Search for the order using the orderID (enter the orderID in the orderID field of the form).

      • Hit Enter or click on the search button below the form.

      • Click on the view option at the start of the orderID under the Search result.

      • Click on the Delete this value button at the top of the view under the view value.

      • Repeat the above steps for each order item.

  3. Remove from OrderHeader and OrderIdentification:

    • Open the OrderHeader entity and remove the same order.

    • Open OrderIdentification and remove the externalId value.

Step 3: Re-import the Order by ID in OMS

  1. Log in to OMS: Use your username and password to log in to Hotwax Commerce OMS.

  2. Navigate to Import Section:

    • Go to MDM > EXIM in the left slider.

    • Navigate to Shopify Jobs and select Import Shopify Order under the Order Management tab.

  3. Re-import the Order:

    • Enter the details of the order, including the Shopify Order ID.

    • Run the job by clicking the Run button.

  4. Verify Successful Import:

    • To verify the order's successful import, go to MDM > EXIM.

    • Navigate to Shopify Jobs and click on Shopify Order MDM under the MDM tab.

Following these steps will resolve the "POS Order Refresh Failure" issue by addressing the root cause—missing shipping details from unfulfilled Shopify orders. This guide provides a structured approach to diagnosing and rectifying the issue, ensuring minimal disruption to your order management process.