Troubleshooting
Troubleshooting
The issues we actually see, and the fast fix for each.
My XML won't upload or looks unreadable
Nine times out of ten it's one of two files: Design Flex's Envisioneer XML — a CAD output KitchenAPI can't read — or the .kit project file, which is Design Flex's save format, not an export. The correct file comes from Presentation → Reports → Application Integration → Simple export → Run.
Need the full menu path? See Exporting from Design Flex. Still unsure? Email us the file and we'll tell you exactly what it is.
Items show as unmapped
Expected for any SKU not in your mapping. The mapping report lists each one — add them to your SKU mapping, or let them post under the values in your file.
My run says 'awaiting review'
That pipeline has Review before posting turned on. Open the run from History, check the lines, and approve or cancel. Reviews expire after 48 hours, and nothing posts without your approval.
Duplicate document number flagged
That number already exists in your QuickBooks. Adjust or delete the original — or use a new number — and run again. KitchenAPI never overwrites existing documents.
Posts failing or QuickBooks disconnected
Reconnect in Settings → Connections. Your pipelines re-attach automatically.
Still stuck? Email support@kitchenapi.com — during trials and onboarding we typically respond within one business day.