Skip to main content
Version: Current

Troubleshooting: Create Goods Receipt Action Failed or Receipt Incorrect

Problem​

When using the Create Goods Receipt action (Receive Goods Overview) from a Purchase Order (PO) or potentially an Invoice:

  1. The action fails with an error message.
  2. The action completes, but the new Goods Receipt (GR) document is missing data, has incorrect quantities/lines, or fails subsequent processing.

Common Causes​

  1. Permissions Missing: The user lacks the necessary permissions:
    • {SourceModule}:{SourceSubmodule}#RECEIVE (e.g., PURCHASING:ORDER#RECEIVE) to initiate the action from the source document.
    • INVENTORY:RECEIPT#CREATE to create the new GR document.
    • INVENTORY:RECEIPT#VIEW and #VISIBLE to access the created GR.
  2. Source Document Status: The source PO might not be in an appropriate status to allow receiving (e.g., still in Draft/Approval, already Closed/Completed). Typically requires a Placed or partially received status.
  3. No Lines to Receive: All lines on the source PO have already been fully received on previous GRs.
  4. Incorrect Quantities Entered: In the "Receive Items" modal, invalid quantities were entered (e.g., text instead of numbers, negative numbers, quantities exceeding the remaining amount on the PO line).
  5. Form Configuration Issues: The default Document Type (Form) for Inventory > Receipt might be misconfigured (e.g., missing mandatory fields that cannot be populated from the PO/Invoice data).
  6. Data Mapping Issues: Problems copying data (like item details, coding) from the source document lines to the new GR lines.
  7. Allocation/Linking Failure: The process to automatically link the new GR back to the source PO failed.
  8. Platform Issues (Rare): Temporary issues with the backend service handling document creation, data copying, or allocations.

Troubleshooting Steps​

  1. Verify Permissions (Admin Task): Confirm the user has the required #RECEIVE permission for the source document type and #CREATE/#VIEW/#VISIBLE permissions for Inventory Receipts.
  2. Check Source Document Status: Ensure the source PO is in an appropriate status (e.g., Placed, Partially Received) that allows receiving.
  3. Check Remaining Quantities on Source: Open the source PO. Expand the lines. Is there a remaining quantity greater than zero available to be received for the lines you are attempting to receive?
  4. Verify Quantities in Modal: When the "Receive Items" modal appears, double-check the quantities entered in the Receiving column. Ensure they are valid numbers and do not exceed the Remaining quantity for each line.
  5. Check GR Form Configuration (Admin Task): Review the default form for Inventory > Receipt (Settings > Document Types). Check for mandatory fields that might not be getting populated correctly during creation.
  6. Retry Action: Try the "Create Goods Receipt" action again, carefully entering quantities.
  7. Review Created GR: If the action completes but the GR is incorrect:
    • Open the newly created GR.
    • Review its data (header, lines, quantities). Compare against the source PO and the quantities entered during creation.
    • Check if it's correctly linked back to the source PO in the allocations section.
    • Check for any validation errors on the GR.
  8. Check PO Status Update: After the GR is created/processed, check if the source PO status updated correctly (e.g., to Partially Received or Received). If not, troubleshoot procurement status automations (Automation with Sentences).

Need Help?​

If the Create Goods Receipt action consistently fails or creates incorrect GRs, contact Zudello support. Provide:

  • The Document UUID of the source PO/Invoice.
  • Screenshots of the "Receive Items" modal with quantities entered (if applicable).
  • Any error messages received.
  • The Document UUID of the resulting GR (if created but incorrect).
  • Confirmation of user permissions.