Troubleshooting FAQ
Answers to the questions that come up across both apps. For symptom-specific fixes, see OrderBridge troubleshooting and Nudge troubleshooting.
Which docs do I need?
| You're integrating | Start here |
|---|---|
| Purchase order processing | OrderBridge overview |
| Invoicing and cash application | Nudge overview |
| A custom ERP via middleware (either app) | Quickstart |
Can I use REST for one app and native for the other?
Yes. Transports are configured per app, per company. OrderBridge can use a native ERP connector while Nudge uses REST middleware to a different GL system; any combination works. See Choose your integration path.
Does Alderstone call our ERP directly?
With native connectors, Alderstone calls the ERP vendor APIs. With REST, Alderstone calls your HTTPS middleware, and your middleware calls the ERP. ERP credentials stay in your infrastructure. See How integration works.
Are webhooks supported?
Not today. Alderstone initiates all integration traffic. Sync is pull-based; pushes run when Alderstone-side events fire. Expose POST endpoints for Alderstone to call. Alderstone does not accept inbound webhooks from middleware.
How are secrets stored?
- REST: Alderstone-generated API keys are hashed server-side; the plaintext is shown once at generation and never stored in retrievable form. See Authentication.
- Native OAuth: tokens are stored securely after the connect flow and refreshed automatically.
- Native API key: credentials are stored securely per company configuration.
Alderstone never exposes raw secrets in the UI after initial key generation.
What happens when the contract changes?
Optional fields may be added without a version bump; your middleware should ignore unknown fields. Breaking changes increment schemaVersion and are documented in Schema versioning before enforcement.
Still stuck? A general debugging path
- Reproduce with cURL against
/healthusing the base URL and token from Settings; this isolates configuration from code. - Compare payloads against the relevant API reference (OrderBridge / Nudge).
- Check connection status in the app's Settings. connected vs failed tells you whether the last test or sync succeeded.
- Read middleware logs for upstream ERP errors; many "empty result" symptoms are ERP failures being swallowed.