Failure Reporting & Outbound Queue
Failure Reporting Endpoints
POST /api/v1/failures
Report a sync failure. Triggers webhook notifications to the opposite system.
{
"entity_type": "product",
"external_id": "PROD-001",
"middleware_id": 1,
"source": "webshop",
"error_message": "Validation failed: price is required",
"error_details": [{ "field": "price", "message": "Required" }],
"raw_data": { "..." : "..." }
}
GET /api/v1/failures
List failures with optional filters: entity_type, status (open/resolved), source (odoo/webshop).
GET /api/v1/failures/{id}
Full failure details including raw_data.
POST /api/v1/failures/{id}/resolve
Manually resolve a failure.
Outbound Queue Endpoints
GET /api/v1/outbound-queue/stats
Queue status counts (pending, processing, completed, failed).
GET /api/v1/outbound-queue
List queue items with optional status filter.
POST /api/v1/outbound-queue/{id}/retry
Retry a single failed item.
POST /api/v1/outbound-queue/retry-failed
Retry all failed items (optionally limited by maxAttempts).