Go-live checklist
What to check before your warehouse integration handles real orders.
Run these against a test company with test orders before switching production. Use a test company that is not a demo: on demo companies Nucleo sends no webhooks and writes nothing to the sales channels.
| # | Scenario | Expected |
|---|---|---|
| 1 | GET /ping without, then with the key | 401, then your company and locations |
| 2 | Read to_fulfill twice without accepting | The same orders both times, nothing changes in Nucleo |
| 3 | Accept an order, read the queue again | The order is accepted and no longer in to_fulfill |
| 4 | Reject an order with a reason code | rejected; the merchant sees the reason |
| 5 | Report a full picking with two parcels, then the shipment; send the shipment twice | processed, then shipped with tracking on the sales channel; 201, then 200 with the same shipment |
| 6 | Report a short picking | Missing pieces unfulfillable, merchant alerted |
| 7 | Report an item that is not on the order | 422 unknown_item, nothing recorded |
| 8 | Cancel an accepted order | cancelled, merchant alerted |
| 9 | Merchant cancels an accepted order; you call cancel | cancel_requested and the order.cancelled webhook; then cancelled |
| 10 | PUT /stock with a known and an unknown item, then the known one with an older counted_at | accepted: 1 and the unknown one in ignored (unknown_item); then accepted: 0 and the item in ignored (stale) |
| 11 | Confirm and receive a return, all sellable; then one damaged | compliant; then not_compliant |
| 12 | Report an unannounced return twice | One return, created once |
| 13 | Repeat a write with the same Idempotency-Key, then with another body | Same answer with Idempotent-Replayed: true; then 409 |
| 14 | Verify the signature of a webhook; reject one with a wrong secret | Accepted; rejected |
| 15 | Page through 300 orders with limit=100 | Every order exactly once |
Ready for production when every scenario passes and the production connection has its own key.