Skip to content

Testing guide

Use mock locker providers to test parcel and locker status flows without a physical locker. For request contracts and field enums, open the Mock Service API.

Staging only

These test tools are available only in staging. You need Carrier Integration API staging access and test details that GLS/NXT supplies.

1. Setup

  • Base URL: https://api.staging.glsnxt.com/ooh-mock-service/v1, separate from the Carrier Integration API base URL.
  • Authentication: use your regular carrier staging X-API-Key, the same key you use for the Carrier Integration API. No separate mock-service key is needed.
  • Field names: mock service request bodies use snake_case (for example provider_locker_id), not the camelCase fields of the Carrier Integration API (for example lockerUid). The two are not interchangeable: the mock service works with provider-side identifiers, not platform identifiers.
  • Test values: provider, carrier, and locker values are test-specific. Use only the values GLS/NXT supplies for your account. Supported combinations vary by provider, carrier, shipment type, and event. Do not assume every combination works. Confirm your combination with GLS/NXT before testing.
  • Async by design: a successful 200 from any mock endpoint confirms only that the request was accepted. The actual status change arrives afterwards through your webhooks. The response body never contains the full simulated lifecycle.
  • Use a unique parcel ID for every test.