Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/CodexaCP/DG_WEB/llms.txt

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

When Dragon Guard WMS posts a receipt or a shipment, the backend records an outbound acknowledgment and dispatches an HTTP callback to the ERP system connected to your tenant. These callbacks carry a structured payload describing the posted document so that the ERP can react — updating inventory records, closing purchase orders, or triggering downstream fulfillment flows. The Outbound Acknowledgments screen at /dashboard/admin/outbound-acknowledgments is the admin-facing log for all of these notifications. It lets you see which callbacks succeeded, which are pending, which failed, and which were intentionally skipped — and it gives you the tools to inspect payloads and retry failed deliveries without reprocessing the underlying warehouse document.
This screen is a monitoring and retry interface only. It does not affect posting behavior, trigger new postings, or reverse any warehouse transactions. The posted document status in Dragon Guard WMS is independent of ERP callback delivery.

Filtering the Acknowledgment List

The list view supports three independent filters that can be combined:
FilterValues / Description
StatusPENDING, SENT, FAILED, SKIPPED
Event typeRECEIPT_POSTED, SHIPMENT_POSTED
Search textFree-text match against source document number, posted document number, or event type

Status Values

StatusMeaning
PENDINGThe notification has been queued but not yet dispatched.
SENTThe callback was delivered and the ERP responded with a success code.
FAILEDOne or more delivery attempts were made but all returned an error or timed out.
SKIPPEDDragon Guard determined the callback should not be sent (e.g., no ERP URL configured for the tenant, or the event was suppressed by configuration).

Event Types

EventTriggered by
RECEIPT_POSTEDA warehouse receipt (inbound shipment) was posted in Dragon Guard WMS.
SHIPMENT_POSTEDAn outbound shipment was posted in Dragon Guard WMS.

Acknowledgment Detail Dialog

Click any row in the list to open the detail dialog. The dialog surfaces all available information about that specific notification:
FieldDescription
Event typeRECEIPT_POSTED or SHIPMENT_POSTED
StatusCurrent delivery status
Source documentThe originating warehouse document number (pre-posting reference)
Posted documentThe posted document number assigned by Dragon Guard after processing
Callback URLThe ERP endpoint that Dragon Guard attempted to call
Attempt countTotal number of delivery attempts made so far
Last HTTP response codeThe HTTP status code returned by the ERP on the most recent attempt
Last errorThe error message captured on the most recent failed attempt, if any

Retry Behavior

Admins can manually trigger a retry for acknowledgments that have not yet reached a SENT status.
1

Open the acknowledgment detail

Click the row for the acknowledgment you want to retry. The detail dialog will open.
2

Click Retry

If the acknowledgment is eligible for retry (status is PENDING, FAILED, or SKIPPED), the Retry button will be active. Click it to enqueue a new delivery attempt.
3

Backend processes the retry

Dragon Guard calls POST /api/outbound-acknowledgments/{id}/retry. The backend validates eligibility, increments the attempt counter, and dispatches the callback to the ERP URL.
4

Check updated status

Refresh the list or reopen the detail dialog to see the updated status, attempt count, and latest HTTP response code.

The SENT Restriction

Acknowledgments with status SENT cannot be retried. This restriction exists to prevent duplicate processing on the ERP side — sending the same posted-document notification twice could cause the ERP to create duplicate records or apply the same inventory change more than once. The backend enforces this rule independently; the UI mirrors it by disabling the Retry button for SENT records.
If you believe a SENT acknowledgment was received incorrectly by the ERP, investigate on the ERP side using the payload JSON and last response body visible in the detail dialog. Do not attempt to work around the retry restriction by any other means.

API Endpoints

MethodEndpointPurpose
GET/api/outbound-acknowledgmentsList all outbound acknowledgments (supports filter params)
GET/api/outbound-acknowledgments/{id}Retrieve full detail for a single acknowledgment
POST/api/outbound-acknowledgments/{id}/retryEnqueue a retry for an eligible acknowledgment
When troubleshooting a failed ERP integration, start by filtering the list to FAILED status and sorting by most recent. Open the detail dialog for the most recent failure and inspect the Last HTTP response code and Last response body — these will typically reveal whether the problem is a network issue, an authentication failure on the ERP side, or a data validation rejection.

Build docs developers (and LLMs) love